CBL CR Book Command Line
Uploaded by
Huy Nguyễn QuốcCBL CR Book Command Line
Uploaded by
Huy Nguyễn QuốcCisco IOS CMTS Cable Command
Reference
OL-15510-15
July 2012
Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL
STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT
WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT
SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE
OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public
domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH
ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF
DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING,
WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO
OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this
URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership
relationship between Cisco and any other company. (1110R)
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the
document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.
Cisco IOS CMTS Cable Command Reference
© 2007-2012 Cisco Systems, Inc. All rights reserved.
CONTENTS
Document Objectives CBL-1
Audience CBL-2
Document Organization CBL-2
Using the Command-Line Interface in Cisco IOS Software CBL-2
Initially Configuring a Device CBL-2
Using the CLI CBL-3
Understanding Command Modes CBL-3
Using the Interactive Help Feature CBL-6
Understanding Command Syntax CBL-7
Understanding Enable and Enable Secret Passwords CBL-8
Using the Command History Feature CBL-9
Abbreviating Commands CBL-10
Using Aliases for CLI Commands CBL-10
Using the no and default Forms of Commands CBL-10
Using the debug Command CBL-11
Filtering Output Using Output Modifiers CBL-11
Understanding CLI Error Messages CBL-12
Saving Changes to a Configuration CBL-12
Additional Information CBL-13
Related Documents CBL-13
Cisco CMTS Hardware Installation and Software Configuration Guides CBL-13
Obtaining Documentation and Submitting a Service Request CBL-14
Cable Commands: a through cable-modem CBL-15
access-denied CBL-16
activate-rule at-byte-count CBL-18
annex modulation CBL-21
application-id CBL-23
auto-sync CBL-24
cable-modem compliant bridge CBL-26
cable-modem dhcp-proxy CBL-28
cable-modem downstream saved channel CBL-32
cable-modem fast-search CBL-34
Cisco IOS CMTS Cable Command Reference
OL-15510-15 iii
Contents
cable-modem qos drop-ack CBL-36
cable-modem upstream preamble qpsk CBL-38
cable-modem voip best-effort CBL-39
cable-modem voip clock-internal CBL-41
Cable Commands: cable a through cable c CBL-43
cable acfe enable CBL-44
cable acfe max-bonus-bandwidth CBL-45
cable acfe max-eir-ratio CBL-46
cable admission-control CBL-47
cable admission-control ds-bandwidth CBL-49
cable admission-control event CBL-52
cable admission-control max-reserved-bandwidth CBL-54
cable admission-control preempt priority-voice CBL-56
cable admission-control us-bandwidth CBL-57
cable application-type include CBL-60
cable application-type name CBL-63
cable arp CBL-65
cable arp filter CBL-67
cable attribute-mask CBL-70
cable bgsync CBL-71
cable bgsync active CBL-72
cable bonding-group-id CBL-74
cable bonding-group-secondary CBL-77
cable bundle CBL-79
cable clock clear-counters CBL-82
cable clock dti CBL-84
cable clock dti clear-counters CBL-85
cable clock force CBL-86
cable clock source-midplane CBL-88
cable clock upgrade CBL-90
cable cmcpe-list valid-time CBL-91
cable cm-status CBL-93
cable cm-status enable CBL-95
cable config-file CBL-98
Cisco IOS CMTS Cable Command Reference
iv OL-15510-15
Contents
Cable Commands: cable d CBL-101
cable dci-response CBL-103
cable dci-upstream-disable CBL-105
cable default-phy-burst CBL-107
cable device CBL-109
cable dfo-retry-count CBL-111
cable dhcp-giaddr CBL-112
cable dhcp-insert CBL-115
cable dhcp-parse option CBL-117
cable divert-rate-limit CBL-118
cable docsis30-voice downstream req-attr-mask CBL-119
cable dot1q-vc-map CBL-121
cable downstream annex CBL-123
cable downstream attribute-mask CBL-125
cable downstream channel-id CBL-126
cable downstream-channel-id automatic CBL-128
cable downstream dsg chan-list CBL-129
cable downstream dsg dcd-enable CBL-131
cable downstream dsg disable CBL-133
cable downstream dsg rule CBL-134
cable downstream dsg tg CBL-136
cable downstream dsg tg channel CBL-138
cable downstream dsg timer CBL-140
cable downstream dsg vendor-param CBL-141
cable downstream frequency CBL-143
cable downstream if-output CBL-146
cable downstream interleave-depth CBL-148
cable downstream modulation CBL-150
cable downstream override CBL-151
cable downstream qos wfq weight CBL-152
cable downstream rate-limit CBL-153
cable downstream rf-power CBL-156
cable downstream rf-shutdown CBL-160
cable dsg CBL-162
cable dsg cfr CBL-166
Cisco IOS CMTS Cable Command Reference
OL-15510-15 v
Contents
cable dsg chan-list CBL-169
cable dsg client-list CBL-171
cable dsg keepalive CBL-173
cable dsg name-update-interval CBL-175
cable dsg tg CBL-176
cable dsg tg channel CBL-178
cable dsg tg channel ucid CBL-180
cable dsg tg channel vendor-param CBL-182
cable dsg tg default-priority CBL-184
cable dsg tg priority CBL-185
cable dsg timer CBL-186
cable dsg tunnel CBL-188
cable dsg tunnel srv-class CBL-190
cable dsg vendor param CBL-192
cable ds-max-burst CBL-194
cable ds-resiliency CBL-196
cable dynamic-bw-sharing CBL-197
cable dynamic-qos trace CBL-199
cable dynamic-secret CBL-200
cable dynamic-secret exclude CBL-207
cable dynamic-secret tftp insert-upgrade-server CBL-209
Cable Commands: cable e through cable i CBL-211
cable enable-trap CBL-212
cable event priority CBL-214
cable event syslog-server CBL-217
cable event throttle-adminStatus CBL-220
cable event throttle-interval CBL-222
cable event throttle-threshold CBL-224
cable fiber-node CBL-226
cable filter group CBL-229
cable flap-list aging CBL-234
cable flap-list insertion-time CBL-236
cable flap-list miss-threshold CBL-238
cable flap-list power-adjust threshold CBL-240
cable flap-list size CBL-242
Cisco IOS CMTS Cable Command Reference
vi OL-15510-15
Contents
cable freq-range CBL-244
cable helper-address CBL-248
cable host access-group CBL-251
cable high-priority-call-window CBL-253
cable igmp static-group CBL-255
cable init-channel-timeout CBL-257
cable insertion-interval CBL-258
cable intercept CBL-260
cable ip-init CBL-263
cable ip-broadcast-echo CBL-264
cable ip-multicast-echo CBL-266
cable ipc-stats CBL-268
cable ipv6 source-verify CBL-269
cable ipv6 source-verify leasequery-filter downstream CBL-272
CBL-274
Cable Commands: cable l CBL-275
cable l2vpn CBL-277
cable l2-vpn-service atm-vc CBL-278
cable l2-vpn-service default-nsi CBL-279
cable l2-vpn-service dot1q CBL-281
cable l2-vpn-service xconnect CBL-283
cable l2-vpn xconnect backup force-switchover CBL-284
cable linecard auto-rommon-downgrade CBL-285
cable linecard auto-rommon-upgrade CBL-286
cable linecard critical-event-poweroff CBL-287
cable load-balance d20-ggrp-default CBL-289
cable load-balance d30-ggrp-default CBL-290
cable load-balance docsis-enable CBL-291
cable load-balance docsis30-enable CBL-292
cable load-balance docsis-group CBL-294
cable load-balance docsis-policy CBL-297
cable load-balance group CBL-298
cable load-balance group (interface) CBL-303
cable load-balance group (Supporting Dynamic Channel Change) CBL-306
cable load-balance group interval CBL-308
Cisco IOS CMTS Cable Command Reference
OL-15510-15 vii
Contents
cable load-balance group policy CBL-310
cable load-balance group policy ugs CBL-312
cable load-balance group threshold CBL-314
cable load-balance group threshold (Supporting Dynamic Channel Change) CBL-319
cable load-balance modem max-failures CBL-321
cable load-balance restrict modem CBL-322
cable load-balance rule CBL-323
cable logging badipsource CBL-325
cable logging downstream-index CBL-328
cable logging layer2events CBL-330
Cable Commands: cable m CBL-333
cable map-advance CBL-335
cable match address CBL-337
cable max-hosts CBL-339
cable metering data-per-session CBL-341
cable metering destination CBL-342
cable metering filesystem CBL-346
cable metering ipdr CBL-349
cable metering ipdr-d3 CBL-351
cable metering source-interface CBL-353
cable modem access-group CBL-356
cable modem change-frequency CBL-357
cable modem max-cpe CBL-358
cable modem max-hosts CBL-360
cable modem qos profile CBL-362
cable modem remote-query CBL-364
cable modem service-class-name CBL-367
cable modem vendor CBL-369
cable modulation-profile CBL-371
cable modulation-profile global-scheme CBL-379
cable monitor CBL-381
cable mrc-mode CBL-385
cable mtc-mode CBL-386
cable multicast auth enable default-action CBL-388
cable multicast auth profile-name CBL-389
Cisco IOS CMTS Cable Command Reference
viii OL-15510-15
Contents
cable multicast group-encryption CBL-390
cable multicast group-qos CBL-391
cable multicast group-qos default CBL-393
cable multicast mdf-disable CBL-395
cable multicast qos group CBL-397
cable multicast source CBL-399
Cable Commands: cable p through cable r CBL-401
cable power CBL-403
cable pre-equalization exclude CBL-406
cable primary-sflow-qos11 keep CBL-409
cable privacy CBL-411
cable privacy bpi-plus-enforce CBL-414
cable privacy bpi-plus-exclude CBL-416
cable privacy bpi-plus-policy CBL-417
cable privacy clone-detect CBL-419
cable privacy eae-exclude CBL-420
cable privacy eae-policy CBL-421
cable privacy encrypt-alg-priority CBL-423
cable privacy hotlist CBL-425
cable privacy kek CBL-427
cable privacy revocation crl skip-sig-check CBL-429
cable privacy revocation enable CBL-430
cable privacy revocation ocsp skip-sig-check CBL-431
cable privacy revocation skip-cm-cert CBL-432
cable privacy tek CBL-433
cable privacy revocation timeout CBL-435
cable proxy-arp CBL-436
cable qos enforce-rule CBL-438
cable qos permission CBL-441
cable qos pre-registration CBL-443
cable qos pro max-ds-burst CBL-444
cable queue-limit CBL-447
cable rate-limit-algorithm min-plus-excess CBL-449
cable rcc-template CBL-451
cable rcp-control CBL-452
Cisco IOS CMTS Cable Command Reference
OL-15510-15 ix
Contents
cable redundancy hashfilter CBL-453
cable redundancy myid CBL-455
cable redundancy node CBL-456
cable redundancy node frequency CBL-457
cable redundancy target CBL-458
cable redundancy threshold CBL-460
cable registration-timeout CBL-461
cable relay-agent-option CBL-462
cable resiliency ds-bonding CBL-464
cable rf-adapt timer CBL-465
cable rf-bandwidth-percent CBL-467
cable rf-change-dampen-time CBL-469
cable rf-channel CBL-470
cable rsvp default-scn CBL-474
cable rf-change-trigger CBL-475
CBL-477
Cable Commands: cable s CBL-479
cable service attribute ds-bonded downstream-type bonding-enabled CBL-480
cable service attribute non-ds-bonded downstream-type bonding-disabled CBL-482
cable service attribute non-ds-bonded legacy-ranging downstream-type CBL-484
cable service attribute voice-enabled CBL-486
cable service attribute withhold-TLVs CBL-488
cable service class CBL-490
cable service flow activity-timeout CBL-495
cable service flow inactivity-threshold CBL-497
cable service-flow inactivity-timeout CBL-499
cable service type CBL-501
cable set mpls-experimental CBL-502
cable sflog CBL-503
cable shared-secondary-secret CBL-505
cable shared-secret CBL-508
cable sid-cluster-group CBL-511
cable sid-cluster-switching CBL-513
cable source-route CBL-515
cable source-verify CBL-516
Cisco IOS CMTS Cable Command Reference
x OL-15510-15
Contents
cable source-verify enable-sav-static CBL-521
cable source-verify group CBL-523
cable source-verify leasequery-filter downstream CBL-525
cable source-verify leasequery-filter upstream CBL-527
cable spectrum-group (global) CBL-529
cable spectrum-group (interface) CBL-533
cable spectrum-group hop period CBL-535
cable spectrum-group hop threshold CBL-537
cable spectrum-group shared CBL-540
cable submgmt default CBL-542
cable sync-interval CBL-547
Cable Commands: cable t CBL-549
cable tag CBL-550
cable telco-return enable CBL-552
cable telco-return interval CBL-554
cable telco-return registration-ip CBL-556
cable telco-return spd dhcp-authenticate CBL-558
cable telco-return spd dhcp-server CBL-560
cable telco-return spd dial-timer CBL-562
cable telco-return spd factory-default CBL-564
cable telco-return spd manual-dial CBL-566
cable telco-return spd password CBL-568
cable telco-return spd phonenum CBL-570
cable telco-return spd ppp-authenticate CBL-572
cable telco-return spd radius-realm CBL-574
cable telco-return spd service-provider CBL-576
cable telco-return spd threshold CBL-578
cable telco-return spd username CBL-580
cable tftp-enforce CBL-582
cable throttle-modem CBL-587
cable throttle-ranging CBL-589
cable time-server CBL-590
cable trust CBL-591
cable tx-power-headroom CBL-593
Cisco IOS CMTS Cable Command Reference
OL-15510-15 xi
Contents
Cable Commands: cable u through cable w CBL-595
cable upstream active-codes CBL-597
cable upstream admission-control CBL-598
cable upstream attribute-mask CBL-602
cable upstream bonding-group CBL-603
cable upstream channel-width CBL-604
cable upstream codes-per-minislot CBL-608
cable upstream concatenation CBL-609
cable upstream connector CBL-610
cable upstream data-backoff CBL-614
cable upstream description CBL-616
cable upstream differential-encoding CBL-617
cable upstream docsis-mode CBL-618
cable upstream dpon CBL-623
cable upstream equalization-coefficient CBL-625
cable upstream equalization-error-recovery CBL-629
cable upstream ext-power CBL-631
cable upstream fec CBL-632
cable upstream fec-strength CBL-633
cable upstream fragmentation CBL-634
cable upstream fragment-force CBL-636
cable upstream freq-adj averaging CBL-639
cable upstream frequency CBL-640
cable upstream hopping blind CBL-643
cable upstream hop-priority CBL-645
cable upstream ingress-noise-cancellation CBL-647
cable upstream load-balance group CBL-650
cable upstream maintain-psd CBL-652
cable upstream max-channel-power-off CBL-654
cable upstream max-codes-per-subframe CBL-655
cable upstream max-interleave-step CBL-656
cable upstream max-logical-chans CBL-658
cable upstream max-ports CBL-661
cable upstream minislot-size CBL-663
cable upstream modulation-profile CBL-666
Cisco IOS CMTS Cable Command Reference
xii OL-15510-15
Contents
cable upstream power-adjust CBL-672
cable upstream power-level CBL-676
cable upstream qos wfq CBL-678
cable upstream range-backoff CBL-679
cable upstream ranging-init-technique CBL-681
cable upstream ranging-poll CBL-682
cable upstream rate-adapt (global) CBL-684
cable upstream rate-adapt (interface) CBL-686
cable upstream rate-limit CBL-688
cable upstream rate-limit-bwreq exempted-priority CBL-690
cable upstream rate-limit-ccf CBL-691
cable upstream resiliency CBL-693
cable upstream rf-adapt CBL-695
cable upstream rf-adapt (logical channel) CBL-697
cable upstream scheduling type CBL-699
cable upstream scrambler CBL-701
cable upstream shutdown CBL-703
cable upstream snr-polling CBL-705
cable upstream spectrum-group CBL-707
cable upstream spreading-interval CBL-709
cable upstream threshold CBL-710
cable upstream threshold hysteresis CBL-715
cable upstream threshold rf-adapt CBL-717
cable upstream timing-adjust CBL-719
cable upstream unfrag-slot-jitter CBL-721
cable util-interval CBL-722
cable vc-map CBL-723
cable vrf-steering cable-modem CBL-725
cable wideband auto-reset CBL-726
Cable Commands: ca through cr CBL-729
channel-group CBL-731
channel-id (cable configuration file) CBL-733
clear cable admission control counters CBL-735
clear cable arp-filter CBL-736
clear cable bgsync counters CBL-738
Cisco IOS CMTS Cable Command Reference
OL-15510-15 xiii
Contents
clear cable dsg CBL-739
clear cable flap-list CBL-741
clear cable hop CBL-743
clear cable host CBL-745
clear cable ipc-stats CBL-747
clear cable load-balance CBL-748
clear cable logging CBL-750
clear cable modem attribute-masks CBL-752
clear cable modem cm-status CBL-754
clear cable modem counters CBL-756
clear cable modem delete CBL-758
clear cable modem flap-counters CBL-761
clear cable modem lock CBL-763
clear cable modem name CBL-766
clear cable modem rcs-counts CBL-768
clear cable modem reset CBL-770
clear cable modem rf-adapt CBL-773
clear cable modem service-type-id CBL-775
clear cable modem voice CBL-777
clear cable multicast statistics counter CBL-779
clear cable rf-status CBL-780
clear cable secondary-ip CBL-781
clear cable modem service-type-id CBL-783
clear facility-alarm CBL-785
clear hccp counters CBL-787
clear hccp linecard CBL-789
clear packetcable rks CBL-790
clear packetcable gate counter commit CBL-791
clear pxf CBL-793
clear pxf statistics drl cable-wan-ip CBL-795
clear pxf statistics drl wan-non-ip CBL-796
clear redundancy CBL-797
controller integrated-cable CBL-798
controller modular-cable CBL-800
cops ip dscp CBL-802
Cisco IOS CMTS Cable Command Reference
xiv OL-15510-15
Contents
cops listeners access-list CBL-806
cops tcp window-size CBL-808
cpd CBL-810
cpd cr-id CBL-811
cpe max CBL-812
Cable Commands: d through h CBL-815
depi cin-failover CBL-817
depi-class CBL-818
depi eqam-stats CBL-820
depi-tunnel CBL-821
description (bonding-group) CBL-823
description (cable fiber-node) CBL-825
dest-ip CBL-826
diagnostic load CBL-827
diagnostic ondemand action-on-failure CBL-830
diagnostic ondemand iterations CBL-832
diagnostic unload CBL-835
docsis cvc mfg CBL-837
docsis cvc mso CBL-839
docsis cvc test CBL-841
docsis-policy CBL-843
docsis-version CBL-844
download CBL-845
downstream CBL-847
downstream cable CBL-849
downstream integrated-cable rf-channel (interface) CBL-851
downstream local upstream CBL-853
downstream modular-cable rf-channel (interface) CBL-854
downstream modular-cable rf-channel CBL-856
duration CBL-858
enabled (enforce-rule) CBL-861
enforced qos-profile CBL-863
exception pxf CBL-866
facility-alarm (ubr10012) CBL-868
hccp authentication CBL-871
Cisco IOS CMTS Cable Command Reference
OL-15510-15 xv
Contents
hccp authentication key-chain CBL-873
hccp bypass version CBL-875
hccp channel-switch CBL-877
hccp check version CBL-880
hccp ds-switch CBL-882
hccp lockout CBL-884
hccp protect CBL-886
hccp resync CBL-888
hccp revertive CBL-890
hccp reverttime CBL-892
hccp switch CBL-894
hccp timers CBL-896
hccp track CBL-898
hccp unlockout CBL-901
hccp working CBL-903
hold-queue CBL-905
hw-module bay reload CBL-907
hw-module shutdown (ubr10012) CBL-908
hw-module slot pos CBL-911
hw-module slot srp CBL-913
Cable Commands: i through p CBL-915
init-tech-list CBL-918
init-tech-ovr CBL-919
interface cable CBL-921
interface cable-modem CBL-923
interface gigabitethernet CBL-925
interface integrated-cable CBL-926
interface modular-cable CBL-928
interface port-channel CBL-930
interface usb CBL-931
interface wideband-cable CBL-933
interval CBL-936
ip-address (controller) CBL-937
ip address docsis CBL-939
ip http cable-monitor CBL-941
Cisco IOS CMTS Cable Command Reference
xvi OL-15510-15
Contents
ip http ezvpn CBL-944
ip-address (controller) CBL-946
ipdr associate CBL-948
ipdr collector CBL-949
ipdr exporter ack-timeout CBL-950
ipdr exporter keepalive CBL-951
ipdr exporter max-unacked CBL-952
ipdr exporter start CBL-953
ipdr session CBL-954
ipdr session (global configuration) CBL-955
ipdr template CBL-956
ipdr type CBL-958
issu linecard abortversion CBL-960
issu linecard acceptversion CBL-962
issu linecard changeversion CBL-963
issu linecard loadversion CBL-965
issu linecard prepareversion CBL-966
issu linecard reloadversion CBL-968
issu linecard runversion CBL-970
license feature evaluation disable CBL-971
license feature evaluation enable CBL-973
logging cmts sea CBL-975
mac-address CBL-977
main-cpu CBL-979
maintenance-mode CBL-981
match rule CBL-983
member subslot CBL-985
method CBL-988
microcode (uBR10012) CBL-990
microcode reload (uBR10012) CBL-992
mode (redundancy) CBL-994
modular-host subslot CBL-996
monitoring-basics CBL-998
monitoring-duration CBL-1000
name CBL-1002
Cisco IOS CMTS Cable Command Reference
OL-15510-15 xvii
Contents
network CBL-1003
nls CBL-1004
nls ag-id auth-key CBL-1005
nls resp-timeout CBL-1006
oui CBL-1007
output-rate CBL-1008
override CBL-1009
option CBL-1010
packetcable CBL-1015
packetcable authorize vanilla-docsis-mta CBL-1017
packetcable element-id CBL-1019
packetcable gate maxcount CBL-1021
packetcable gate send-subscriberID CBL-1023
packetcable timer CBL-1024
peak-time1 CBL-1026
penalty-period CBL-1029
ping docsis CBL-1032
plim qos input map CBL-1037
policy CBL-1041
prefix CBL-1042
profile-description CBL-1044
protect-tunnel CBL-1046
privacy CBL-1047
Cable Commands: q through sg CBL-1049
qos-profile enforced CBL-1051
qos-profile registered CBL-1054
rcp-id CBL-1056
receive-channel CBL-1057
receive-module CBL-1059
redundancy force-failover main-cpu CBL-1061
redundancy linecard-group CBL-1063
redundancy reload CBL-1068
redundancy switch-activity CBL-1070
registered qos-profile CBL-1072
restricted CBL-1074
Cisco IOS CMTS Cable Command Reference
xviii OL-15510-15
Contents
revertive CBL-1075
rf-channel cable downstream channel-id CBL-1076
rf-channel depi-tunnel CBL-1078
rf-channel description CBL-1080
rf-channel frequency CBL-1082
rf-channel ip-address mac-address udp-port CBL-1085
rf-channel network-delay CBL-1088
rf-channel rf-power CBL-1090
rf-channel rf-shutdown CBL-1093
rf-channel stacking CBL-1095
secondary aux CBL-1096
service-class (cmts-tag) CBL-1097
service-class (enforce-rule) CBL-1098
service divert-rate-limit CBL-1100
service divert-rate-limit ip CBL-1102
service divert-rate-limit ipv6 CBL-1104
service divert-rate-limit ip trusted-site CBL-1106
service divert-rate-limit trusted-site-ipv6 CBL-1108
service divert-rate-limit non-ip CBL-1110
service divert-rate-limit trusted-site CBL-1112
service instance CBL-1114
service udp-small-servers max-servers no-limit CBL-1115
service-class CBL-1117
service-type-id CBL-1119
service-type-id (cmts-tag) CBL-1120
session-range CBL-1121
set clock CBL-1122
Cable Commands: show a through show cable l CBL-1125
show application-buckets CBL-1127
show bridge cable-modem CBL-1129
show cable acfe controller CBL-1131
show cable acfe interface CBL-1133
show cable acfe summary CBL-1135
show cable active-reman CBL-1137
show cable admission-control CBL-1140
Cisco IOS CMTS Cable Command Reference
OL-15510-15 xix
Contents
show cable arp-filter CBL-1148
show cable bgsync CBL-1153
show cable bundle CBL-1155
show cable bundle multicast CBL-1158
show cable burst-profile CBL-1160
show cable calls CBL-1162
show cable cgd-associations CBL-1164
show cable clock CBL-1166
show cable clock dti counters CBL-1172
show cable clock dti status CBL-1173
show cable device access-group CBL-1174
show cable dsg CBL-1177
show cable dsg cfr CBL-1181
show cable dsg host CBL-1186
show cable dsg static-group bundle CBL-1188
show cable dsg tg CBL-1190
show cable dsg tunnel CBL-1193
show cable dsg tg CBL-1199
show cable dsg tunnel CBL-1202
show cable dynamic-qos trace CBL-1209
show cable fiber-node CBL-1211
show cable filter CBL-1214
show cable flap-list CBL-1219
show cable flap-list wb-rf CBL-1226
show cable hop CBL-1228
show cable host access-group CBL-1232
show cable ib-ipc CBL-1234
show cable ipc-stats CBL-1235
show cable l2-vpn dot1q-vc-map CBL-1239
show cable l2-vpn vc-map CBL-1244
show cable l2-vpn xconnect CBL-1246
show cable leasequery-filter CBL-1250
show cable licenses all CBL-1253
show cable load-balance CBL-1255
show cable load-balance docsis-group CBL-1264
Cisco IOS CMTS Cable Command Reference
xx OL-15510-15
Contents
show cable logging CBL-1289
CBL-1292
Cable Commands: show cable m through show cable u CBL-1293
show cable mac-domain cable forwarding CBL-1297
show cable mac-domain cgd-associations CBL-1299
show cable mac-domain downstream-service-group CBL-1302
show cable mac-domain rcc CBL-1305
show cable mac-domain upstream-service-group CBL-1307
show cable metering-status CBL-1309
show cable modem CBL-1312
show cable modem access-group CBL-1344
show cable modem auth-profile CBL-1348
show cable modem calls CBL-1350
show cable modem classifiers CBL-1353
show cable modem cnr CBL-1356
show cable modem connectivity CBL-1364
show cable modem counters CBL-1368
show cable modem cpe CBL-1372
show cable modem docsis device-class CBL-1375
show cable modem docsis version CBL-1381
show cable modem domain-name CBL-1393
show cable modem errors CBL-1396
show cable modem extended-power CBL-1400
show cable modem flap CBL-1402
show cable modem ipv6 CBL-1407
show cable modem mac CBL-1415
show cable modem maintenance CBL-1425
show cable modem offline CBL-1430
show cable modem partial-mode CBL-1439
show cable modem partial-service CBL-1441
show cable modem phy CBL-1443
show cable modem primary-channel CBL-1450
show cable modem primary-channel summary total CBL-1452
show cable modem privacy CBL-1454
show cable modem qos CBL-1459
Cisco IOS CMTS Cable Command Reference
OL-15510-15 xxi
Contents
show cable modem registered CBL-1465
show cable modem remote-query CBL-1471
show cable modem resiliency CBL-1474
show cable modem rf-adapt CBL-1476
show cable modem rogue CBL-1479
show cable modem service-type-id CBL-1483
show cable modem service-flow CBL-1485
show cable modem summary CBL-1492
show cable modem summary wb-rf CBL-1498
show cable modem tcs summary CBL-1500
show cable modem type CBL-1502
show cable modem unregistered CBL-1505
show cable modem vendor CBL-1514
show cable modem voice CBL-1519
show cable modem wideband CBL-1520
show cable modem wideband phy CBL-1529
show cable modem wideband primary-channel CBL-1532
show cable modem wideband rcs-status CBL-1533
show cable modulation-profile CBL-1535
show cable multicast authorization CBL-1543
show cable multicast db CBL-1547
show cable multicast debug CBL-1554
show cable multicast dsid CBL-1557
show cable multicast qos CBL-1561
show cable multicast statistics failure CBL-1564
show cable noise CBL-1565
show cable privacy CBL-1566
show cable qos enforce-rule CBL-1568
show cable qos permission CBL-1573
show cable qos profile CBL-1575
show cable rate-adapt CBL-1578
show cable rate-limit-ccf CBL-1580
show cable redundancy CBL-1582
show cable resiliency CBL-1584
show cable rf-adapt CBL-1586
Cisco IOS CMTS Cable Command Reference
xxii OL-15510-15
Contents
show cable rf-status CBL-1589
show cable rsvp flow-db CBL-1591
show cable service-class CBL-1593
show cable service-voice downstream-type CBL-1597
show cable signal-quality CBL-1598
show cable spectrum-analysis CBL-1601
show cable spectrum-group CBL-1603
show cable subscriber-usage CBL-1606
show cable tech-support CBL-1610
show cable throttle-modem CBL-1614
show cable upstream service-flow summary CBL-1616
show cable urm CBL-1618
show cable us-sg CBL-1620
Cable Commands: show ch through show cr CBL-1623
show checkpoint CBL-1625
show cmts ipc-cable client base CBL-1628
show controller gigabitethernet CBL-1634
show controller integrated-cable CBL-1636
show controllers cable CBL-1664
show controllers cable jib CBL-1683
show controllers cable upstream spectrum CBL-1690
show controllers cable-modem CBL-1694
show controllers cable-modem bpkm CBL-1700
show controllers cable-modem classifiers CBL-1706
show controllers cable-modem cmcert CBL-1711
show controllers cable-modem crypto des CBL-1713
show controllers cable-modem filters CBL-1716
show controllers cable-modem lookup-table CBL-1719
show controllers cable-modem mac CBL-1723
show controllers cable-modem manuf-cert CBL-1739
show controllers cable-modem phs CBL-1741
show controllers cable-modem phy CBL-1745
show controllers cable-modem qos CBL-1748
show controllers cable-modem service-flows CBL-1755
show controllers cable-modem tuner CBL-1761
Cisco IOS CMTS Cable Command Reference
OL-15510-15 xxiii
Contents
show controllers clock-reference CBL-1763
show controllers jacket CBL-1769
show controllers modular-cable CBL-1771
show controllers usb CBL-1784
show cops servers CBL-1787
show cpd CBL-1789
show cr10k-rp cable CBL-1790
show cr10k-rp controller CBL-1794
show cr10k-rp queue CBL-1797
show cr10k-rp slots CBL-1801
show crypto ca certificates CBL-1804
show crypto ca trustpoints CBL-1805
Cable Commands: show d through show i CBL-1807
show debug CBL-1811
show depi CBL-1813
show depi session CBL-1815
show depi tunnel CBL-1823
show dhcp CBL-1826
show diagnostic bootup CBL-1829
show diagnostic content CBL-1830
show diagnostic ood-status CBL-1834
show diagnostic result CBL-1838
show diagnostic schedule CBL-1843
show facility-alarm status CBL-1846
show frame-clocks CBL-1849
show hccp CBL-1850
show hccp interface CBL-1861
show hccp group CBL-1863
show hccp linecard CBL-1866
show hw-module bay CBL-1868
show hw-module bay oir CBL-1874
show hw-module bay transceiver CBL-1878
show interface bundle CBL-1880
show interface cable CBL-1884
show interface cable admission-control reservation CBL-1890
Cisco IOS CMTS Cable Command Reference
xxiv OL-15510-15
Contents
show interface cable cable-monitor CBL-1893
show interface cable downstream CBL-1895
show interface cable dsg downstream CBL-1898
show interface cable dsg downstream tg CBL-1904
show interface cable dynamic-service statistics CBL-1907
show interface cable intercept CBL-1909
show interface cable mac-scheduler CBL-1911
show interface cable modem CBL-1920
show interface cable monitor CBL-1928
show interface cable multicast-sessions CBL-1930
show interface cable packetcable statistics CBL-1933
show interface cable privacy CBL-1935
show interface cable qos paramset CBL-1939
show interface cable service-flow CBL-1943
show interface cable sid CBL-1955
show interface cable sid CBL-1964
show interface cable signal-quality CBL-1973
show interface cable upstream CBL-1975
show interface cable upstream debug CBL-1986
show interface gigabitethernet CBL-1988
show interface integrated-cable CBL-1990
show interface integrated-cable queue CBL-1994
show interface modular-cable CBL-1999
show interface modular-cable accounting CBL-2001
show interface modular-cable description CBL-2003
show interface modular-cable dlm CBL-2005
show interface modular-cable downstream CBL-2007
show interface modular-cable intercept CBL-2009
show interface modular-cable multicast-sessions CBL-2011
show interface modular-cable stats CBL-2014
show interface modular-cable summary CBL-2016
show interface modular-cable switching CBL-2018
show interface multicast-gcr CBL-2020
show interface port-channel CBL-2022
show interface rf-status CBL-2025
Cisco IOS CMTS Cable Command Reference
OL-15510-15 xxv
Contents
show interface wideband-cable CBL-2027
show interface wideband-cable multicast-sessions CBL-2035
show interface wideband-cable queue CBL-2038
show interfaces cable-modem CBL-2043
show ip arp vrf CBL-2050
show ip interface brief CBL-2052
show ipdr collector CBL-2054
show ipdr exporter CBL-2055
show ipdr session CBL-2056
show ipdr session collector CBL-2058
show ipdr session template CBL-2059
Cable Commands: show m through show z CBL-2061
show nls CBL-2063
show nls ag-id CBL-2064
show nls flow CBL-2065
show packetcable cms CBL-2066
show packetcable event CBL-2069
show packetcable gate CBL-2071
show packetcable gate counter commit CBL-2074
show packetcable gate ipv6 CBL-2076
show packetcable gate multimedia CBL-2079
show packetcable global CBL-2081
show pxf cable CBL-2083
show pxf cable controller CBL-2088
show pxf cable feature CBL-2091
show pxf cable interface CBL-2093
show pxf cable multicast CBL-2096
show pxf cpu CBL-2097
show pxf cpu drl-trusted-sites CBL-2115
show pxf cpu queue CBL-2117
show pxf cpu queue wb-spa CBL-2122
show pxf cpu statistics CBL-2125
show pxf cpu statistics drl ipv4 CBL-2132
show pxf cpu statistics drl ipv6 CBL-2134
show pxf cpu statistics drl us-cable CBL-2136
Cisco IOS CMTS Cable Command Reference
xxvi OL-15510-15
Contents
show pxf dma CBL-2138
show pxf microcode CBL-2145
show pxf xcm CBL-2148
show redundancy (ubr10012) CBL-2152
show redundancy config-sync CBL-2157
show redundancy platform CBL-2159
show running-config interface cable CBL-2161
show tech-support CBL-2165
show voice port CBL-2169
Cable Commands: snmp through w CBL-2173
snmp manager CBL-2175
snmp-server enable traps cable CBL-2177
snmp-server enable traps docsis-cm CBL-2180
snmp-server enable traps docsis-cmts CBL-2182
switchover pxf restart CBL-2184
switchover timeout CBL-2186
tag CBL-2188
test cable dcc (Supporting Dynamic Channel Change) CBL-2189
test cable voice CBL-2192
test packetcable gate create CBL-2193
test packetcable gc client-accept CBL-2194
test packetcable gc gate-alloc CBL-2195
test packetcable gc gate-delete CBL-2196
test packetcable gc gate-info CBL-2197
test packetcable gc gate-set multimedia CBL-2198
test packetcable gc initiate CBL-2199
threshold CBL-2200
timestamp CBL-2201
tos CBL-2203
tos (multicast qos) CBL-2204
upgrade fpga auto-upgrade CBL-2205
upgrade fpga file CBL-2207
upstream CBL-2209
upstream (config-lb-group) CBL-2210
upstream cable connector CBL-2212
Cisco IOS CMTS Cable Command Reference
OL-15510-15 xxvii
Contents
upstream freq-range CBL-2214
voice-port CBL-2216
vrf (multicast qos) CBL-2217
weekend duration CBL-2218
weekend off CBL-2220
weekend peak-time1 CBL-2221
Appendix A: Cable Debug Commands CBL-2223
debug c10k-jacket CBL-2225
debug cable CBL-2227
debug cable acfe CBL-2229
debug cable acfe filter CBL-2233
debug cable admission-control CBL-2235
debug cable admission-control flow-categorization CBL-2237
debug cable arp CBL-2239
debug cable arp filter CBL-2240
debug cable bpiatp CBL-2242
debug cable bundle CBL-2244
debug cable cm-status CBL-2246
debug cable classifiers CBL-2247
debug cable cm-ctrl CBL-2249
debug cable config-file CBL-2251
debug cable dbs CBL-2254
debug cable dcc CBL-2256
debug cable dci CBL-2259
debug cable dhcp CBL-2260
debug cable dsg CBL-2262
debug cable dynamic-qos subscriber CBL-2263
debug cable dynamic-qos trace CBL-2274
debug cable dynamic-secret CBL-2281
debug cable dynsrv CBL-2285
debug cable encap CBL-2287
debug cable envm CBL-2289
debug cable error CBL-2291
debug cable flap CBL-2292
debug cable fn CBL-2294
Cisco IOS CMTS Cable Command Reference
xxviii OL-15510-15
Contents
debug cable freqhop CBL-2296
debug cable hw-spectrum CBL-2297
debug cable interface CBL-2298
debug cable ipv6 CBL-2300
debug cable keyman CBL-2301
debug cable l2-vpn CBL-2303
debug cable load-balance CBL-2306
debug cable mac-address CBL-2308
debug cable mac-protocol CBL-2310
debug cable mac-scheduler CBL-2312
debug cable map CBL-2314
debug cable metering CBL-2316
debug cable mdd CBL-2318
debug cable md-sg CBL-2320
debug cable multicast counter clear CBL-2322
debug cable multicast counter start CBL-2323
debug cable multicast counter stop CBL-2324
debug cable multicast forwarding CBL-2325
debug cable multicast latency CBL-2328
debug cable phs CBL-2330
debug cable phy CBL-2331
debug cable privacy CBL-2332
debug cable qos CBL-2334
debug cable range CBL-2335
debug cable receive CBL-2337
debug cable registration CBL-2338
debug cable remote-query CBL-2341
debug cable reset CBL-2343
debug cable rfmib CBL-2344
debug cable service-ds-selection CBL-2346
debug cable specmgmt CBL-2347
debug cable startalloc CBL-2348
debug cable subscriber-monitoring CBL-2349
debug cable telco-return CBL-2351
debug cable telco-return msg CBL-2352
Cisco IOS CMTS Cable Command Reference
OL-15510-15 xxix
Contents
debug cable tlvs CBL-2353
debug cable tod CBL-2357
debug cable transmit CBL-2358
debug cable ubg CBL-2359
debug cable ucc CBL-2361
debug cable ucd CBL-2362
debug cable upconverter CBL-2365
debug cable us-adm-ctrl CBL-2366
debug cable wbcmts CBL-2368
debug cable wbcmts admission-control CBL-2370
debug cable wbcmts resiliency CBL-2372
debug cable-modem bpkm CBL-2373
debug cable-modem bridge CBL-2375
debug cable-modem error CBL-2377
debug cable-modem interrupts CBL-2379
debug cable-modem mac log CBL-2381
debug cable-modem mac messages CBL-2384
debug cable-modem mac messages dynsrv CBL-2389
debug cable-modem map CBL-2392
debug cable-modem up-dis CBL-2394
debug checkpoint CBL-2396
debug cmts ipc-cable base CBL-2397
debug cmts ipc-cable client CBL-2401
debug cpd CBL-2406
debug cr10k-rp CBL-2407
debug cr10k-rp dbs-queue CBL-2413
debug docsis ssd CBL-2414
debug ehsa CBL-2416
debug hccp authentication CBL-2419
debug hccp channel-switch CBL-2421
debug hccp docsis-recovery CBL-2423
debug hccp events CBL-2425
debug hccp fast-failure-detection CBL-2427
debug hccp inter-db CBL-2429
debug hccp plane CBL-2431
Cisco IOS CMTS Cable Command Reference
xxx OL-15510-15
Contents
debug hccp sync CBL-2434
debug hccp timing CBL-2437
debug hw-module all upgrade CBL-2440
debug hw-module bay CBL-2442
debug nls CBL-2444
debug packetcable all CBL-2445
debug packetcable cops CBL-2449
debug packetcable gate CBL-2451
debug packetcable hccp CBL-2459
debug packetcable ipc CBL-2461
debug packetcable subscriber CBL-2463
debug pxf CBL-2465
debug pxf atom CBL-2470
debug redundancy CBL-2472
debug usb CBL-2475
Appendix B: CMTS Router ROM Monitor Commands CBL-2477
Entering the ROM Monitor CBL-2477
Using the BREAK Signal CBL-2478
Using the Configuration Register CBL-2479
Using the Configuration Register in Global Configuration Mode CBL-2479
Using the Configuration Register in ROM Monitor Mode CBL-2479
Command Conventions CBL-2480
ROM Monitor Commands CBL-2480
alias CBL-2482
boot CBL-2484
break CBL-2488
confreg CBL-2490
cont CBL-2493
context CBL-2495
cpu_card_type CBL-2497
dev CBL-2498
dir CBL-2500
dis CBL-2501
frame CBL-2503
help CBL-2505
Cisco IOS CMTS Cable Command Reference
OL-15510-15 xxxi
Contents
history CBL-2507
meminfo CBL-2509
repeat CBL-2510
reset CBL-2512
set CBL-2514
show_spd CBL-2516
stack CBL-2519
sync CBL-2521
sysreset CBL-2523
unalias CBL-2525
unset CBL-2527
Cisco IOS CMTS Cable Command Reference
xxxii OL-15510-15
Introduction
Revised: July 2012, OL-15510-15
This introduction explains the objectives, intended audience, and organization of the Cisco IOS CMTS
Cable Command Reference. It provides the following sections:
• Document Objectives, page 1
• Audience, page 2
• Document Organization, page 2
• Using the Command-Line Interface in Cisco IOS Software, page 2
• Related Documents, page 13
• Obtaining Documentation and Submitting a Service Request, page 14
Document Objectives
Note Some of these products have reached End of Sale (EOS) or End of Life (EOL). For more information,
refer to the Video, Cable, and Content Delivery End-of-Sale and End-of-Life Products site at:
http://www.cisco.com/en/US/products/hw/video/prod_category_end_of_life.html
This guide describes the commands necessary to configure, maintain, and troubleshoot the following
cable platforms:
• Cisco Cable Modem Termination Systems (CMTS)
– Cisco uBR7200 series universal broadband routers, which include the Cisco uBR7246, the
Cisco uBR7246 VXR, and the Cisco uBR7225VXR routers.
– Cisco uBR10012 universal broadband router.
• Cisco Cable Modems (CMs) and other Cable CPE Devices
– Cisco uBR904, Cisco uBR905, Cisco uBR924, and Cisco uBR925 cable access routers.
– Cisco CVA122 and Cisco CVA122E cable voice adapters.
Note This guide documents only cable-specific commands. For information about all Cisco IOS commands,
use the Command Lookup Tool or the Cisco IOS Master Command List, All Releases.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1
Introduction
Audience
This book is intended for system administrators and support engineers who configure and maintain the
cable CMTS and CM devices.
Document Organization
This book is organized alphabetically. The first page of each chapter provides a command summary of
all commands included in that chapter, as well as identification of any new, modified, obsolete, or
replaced commands.
Debug commands and ROM monitor commands are included in separate appendixes at the end of the
book.
Using the Command-Line Interface in Cisco IOS Software
This section provides basic information about the command-line interface (CLI) in Cisco IOS software
and how you can use some of the CLI features.
• Initially Configuring a Device, page 2
• Using the CLI, page 3
• Saving Changes to a Configuration, page 12
• Additional Information, page 13
For more information about using the CLI, see the “Using the Cisco IOS Command-Line Interface”
section of the Cisco IOS Configuration Fundamentals Configuration Guide.
For information about the software documentation set, see the “About Cisco IOS Software
Documentation” document.
Initially Configuring a Device
Initially configuring a device varies by platform. For information about performing an initial
configuration, see the hardware installation documentation that is provided with the original packaging
of the product or go to the Product/Technologies Support area of Cisco.com at
http://www.cisco.com/go/techdocs.
After you have performed the initial configuration and connected the device to your network, you can
configure the device by using the console port or a remote access method, such as Telnet or Secure Shell
(SSH), to access the CLI or by using the configuration method provided on the device, such as Security
Device Manager.
Cisco IOS CMTS Cable Command Reference
CBL-2 OL-15510-15
Introduction
Changing the Default Settings for a Console or AUX Port
There are only two changes that you can make to a console port and an AUX port:
• Change the port speed with the config-register 0x command. Changing the port speed is not
recommended. The well-known default speed is 9600.
• Change the behavior of the port; for example, by adding a password or changing the timeout value.
Note The AUX port on the Route Processor (RP) installed in a Cisco ASR 1000 series router does not serve
any useful customer purpose and should be accessed only under the advisement of a customer support
representative.
Using the CLI
This section describes the following topics:
• Understanding Command Modes, page 3
• Using the Interactive Help Feature, page 6
• Understanding Command Syntax, page 7
• Understanding Enable and Enable Secret Passwords, page 8
• Using the Command History Feature, page 9
• Abbreviating Commands, page 10
• Using Aliases for CLI Commands, page 10
• Using the no and default Forms of Commands, page 10
• Using the debug Command, page 11
• Filtering Output Using Output Modifiers, page 11
• Understanding CLI Error Messages, page 12
Understanding Command Modes
The CLI command mode structure is hierarchical, and each mode supports a set of specific commands.
This section describes the most common of the many modes that exist.
Table 1 lists common command modes with associated CLI prompts, access and exit methods, and a
brief description of how each mode is used.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-3
Introduction
Table 1 CLI Command Modes
Command Mode Access Method Prompt Exit Method Mode Usage
User EXEC Log in. Router> Issue the logout or exit • Change terminal
command. settings.
• Perform basic tests.
• Display device status.
Privileged EXEC From user EXEC Router# Issue the disable • Issue show and debug
mode, issue the enable command or the exit commands.
command. command to return to
• Copy images to the
user EXEC mode.
device.
• Reload the device.
• Manage device
configuration files.
• Manage device file
systems.
Global From privileged EXEC Router(config)# Issue the exit command Configure the device.
configuration mode, issue the or the end command to
configure terminal return to privileged
command. EXEC mode.
Interface From global Router(config-if)# Issue the exit command Configure individual
configuration configuration mode, to return to global interfaces.
issue the interface configuration mode or
command. the end command to
return to privileged
EXEC mode.
Line From global Router(config-line)# Issue the exit command Configure individual
configuration configuration mode, to return to global terminal lines.
issue the line vty or configuration mode or
line console the end command to
command. return to privileged
EXEC mode.
Cisco IOS CMTS Cable Command Reference
CBL-4 OL-15510-15
Introduction
Table 1 CLI Command Modes (continued)
Command Mode Access Method Prompt Exit Method Mode Usage
ROM monitor From privileged EXEC rommon # > Issue the continue • Run as the default
mode, issue the reload command. operating mode when a
command. Press the The # symbol valid image cannot be
Break key during the represents the line loaded.
first 60 seconds while number and increments
at each prompt. • Access the fall-back
the system is booting.
procedure for loading an
image when the device
lacks a valid image and
cannot be booted.
• Perform password
recovery when a
Ctrl-Break sequence is
issued within 60 seconds
of a power-on or reload
event.
Diagnostic The router boots or Router(diag)# If a Cisco IOS process • Inspect various states on
(available only enters diagnostic mode failure is the reason for the router, including the
on in the following entering diagnostic Cisco IOS state.
Cisco ASR 1000 scenarios. When a mode, the failure must
• Replace or roll back the
series routers) Cisco IOS process or be resolved and the
configuration.
processes fail, in most router must be rebooted
scenarios the router to exit diagnostic mode. • Provide methods of
will reload. restarting the Cisco IOS
If the router is in
software or other
• A user-configured diagnostic mode
processes.
access policy was because of a
configured using transport-map • Reboot hardware (such
the configuration, access as the entire router, an
transport-map the router through RP, an ESP, a SIP, a
command, which another port or use a SPA) or other hardware
directed the user method that is components.
into diagnostic configured to connect to • Transfer files into or off
mode. the Cisco IOS CLI. of the router using
• The router was If the RP auxiliary port remote access methods
accessed using an was used to access the such as FTP, TFTP, and
RP auxiliary port. router, use another port SCP.
for access. Accessing
• A break signal
the router through the
(Ctrl-C,
auxiliary port is not
Ctrl-Shift-6, or
useful for customer
the send break
purposes.
command) was
entered, and the
router was
configured to
enter diagnostic
mode when the
break signal was
received.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-5
Introduction
EXEC commands are not saved when the software reboots. Commands that you issue in a configuration
mode can be saved to the startup configuration. If you save the running configuration to the startup
configuration, these commands will execute when the software is rebooted. Global configuration mode
is the highest level of configuration mode. From global configuration mode, you can enter a variety of
other configuration modes, including protocol-specific modes.
ROM monitor mode is a separate mode that is used when the software cannot load properly. If a valid
software image is not found when the software boots or if the configuration file is corrupted at startup,
the software might enter ROM monitor mode. Use the question symbol (?) to view the commands that
you can use while the device is in ROM monitor mode.
rommon 1 > ?
alias set and display aliases command
boot boot up an external process
confreg configuration register utility
cont continue executing a downloaded image
context display the context of a loaded image
cookie display contents of cookie PROM in hex
.
.
.
rommon 2 >
The following example shows how the command prompt changes to indicate a different command mode:
Router> enable
Router# configure terminal
Router(config)# interface ethernet 1/1
Router(config-if)# ethernet
Router(config-line)# exit
Router(config)# end
Router#
Note A keyboard alternative to the end command is Ctrl-Z.
Using the Interactive Help Feature
The CLI includes an interactive Help feature. Table 2 describes the purpose of the CLI interactive Help
commands.
Table 2 CLI Interactive Help Commands
Command Purpose
help Provides a brief description of the Help feature in any command mode.
? Lists all commands available for a particular command mode.
partial command? Provides a list of commands that begin with the character string (no
space between the command and the question mark).
partial command<Tab> Completes a partial command name (no space between the command
and <Tab>).
command ? Lists the keywords, arguments, or both associated with the command
(space between the command and the question mark).
command keyword ? Lists the arguments that are associated with the keyword (space between
the keyword and the question mark).
Cisco IOS CMTS Cable Command Reference
CBL-6 OL-15510-15
Introduction
The following examples show how to use the help commands:
help
Router> help
Help may be requested at any point in a command by entering a question mark '?'. If nothing
matches, the help list will be empty and you must backup until entering a '?' shows the
available options.
Two styles of help are provided:
1. Full help is available when you are ready to enter a command argument (e.g. 'show ?')
and describes each possible argument.
2. Partial help is provided when an abbreviated argument is entered and you want to know
what arguments match the input (e.g. 'show pr?'.)
?
Router# ?
Exec commands:
access-enable Create a temporary access-List entry
access-profile Apply user-profile to interface
access-template Create a temporary access-List entry
alps ALPS exec commands
archive manage archive files
<snip>
partial command?
Router(config)# zo?
zone zone-pair
partial command<Tab>
Router(config)# we<Tab> webvpn
command ?
Router(config-if)# pppoe ?
enable Enable pppoe
max-sessions Maximum PPPOE sessions
command keyword ?
Router(config-if)# pppoe enable ?
group attach a BBA group
<cr>
Understanding Command Syntax
Command syntax is the format in which a command should be entered in the CLI. Commands include
the name of the command, keywords, and arguments. Keywords are alphanumeric strings that are used
literally. Arguments are placeholders for values that a user must supply. Keywords and arguments may
be required or optional.
Specific conventions convey information about syntax and command elements. Table 3 describes these
conventions.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-7
Introduction
Table 3 CLI Syntax Conventions
Symbol/Text Function Notes
< > (angle brackets) Indicate that the option is an Sometimes arguments are displayed
argument. without angle brackets.
A.B.C.D. Indicates that you must enter a Angle brackets (< >) are not always
dotted decimal IP address. used to indicate that an IP address is
an argument.
WORD (all capital letters) Indicates that you must enter Angle brackets (< >) are not always
one word. used to indicate that a WORD is an
argument.
LINE (all capital letters) Indicates that you must enter Angle brackets (< >) are not always
more than one word. used to indicate that a LINE is an
argument.
<cr> (carriage return) Indicates the end of the list of —
available keywords and
arguments, and also indicates
when keywords and arguments
are optional. When <cr> is the
only option, you have reached
the end of the branch or the
end of the command if the
command has only one branch.
The following examples show syntax conventions:
Router(config)# ethernet cfm domain ?
WORD domain name
Router(config)# ethernet cfm domain dname ?
level
Router(config)# ethernet cfm domain dname level ?
<0-7> maintenance level number
Router(config)# ethernet cfm domain dname level 7 ?
<cr>
Router(config)# snmp-server file-transfer access-group 10 ?
protocol protocol options
<cr>
Router(config)# logging host ?
Hostname or A.B.C.D IP address of the syslog server
ipv6 Configure IPv6 syslog server
Understanding Enable and Enable Secret Passwords
Some privileged EXEC commands are used for actions that impact the system, and it is recommended
that you set a password for these commands to prevent unauthorized use. Two types of passwords,
enable (not encrypted) and enable secret (encrypted), can be set. The following commands set these
passwords and are issued in global configuration mode:
• enable password
• enable secret password
Cisco IOS CMTS Cable Command Reference
CBL-8 OL-15510-15
Introduction
Using an enable secret password is recommended because it is encrypted and more secure than the
enable password. When you use an enable secret password, text is encrypted (unreadable) before it is
written to the config.text file. When you use an enable password, the text is written as entered (readable)
to the config.text file.
Each type of password is case sensitive, can contain from 1 to 25 uppercase and lowercase alphanumeric
characters, and can start with a numeral. Spaces are also valid password characters; for example,
“two words” is a valid password. Leading spaces are ignored, but trailing spaces are recognized.
Note Both password commands have numeric keywords that are single integer values. If you choose a numeral
for the first character of your password followed by a space, the system will read the number as if it were
the numeric keyword and not as part of your password.
When both passwords are set, the enable secret password takes precedence over the enable password.
To remove a password, use the no form of the commands: no enable password or
no enable secret password.
For more information about password recovery procedures for Cisco products, see the following:
http://www.cisco.com/en/US/products/sw/iosswrel/ps1831/
products_tech_note09186a00801746e6.shtml
Using the Command History Feature
The command history feature saves, in a command history buffer, the commands that you enter during
a session. The default number of saved commands is 10, but the number is configurable within the range
of 0 to 256. This command history feature is particularly useful for recalling long or complex commands.
To change the number of commands saved in the history buffer for a terminal session, issue the
terminal history size command:
Router# terminal history size num
A command history buffer is also available in line configuration mode with the same default and
configuration options. To set the command history buffer size for a terminal session in line configuration
mode, issue the history command:
Router(config-line)# history [size num]
To recall commands from the history buffer, use the following methods:
• Press Ctrl-P or the Up Arrow key—Recalls commands beginning with the most recent command.
Repeat the key sequence to recall successively older commands.
• Press Ctrl-N or the Down Arrow key—Recalls the most recent commands in the history buffer after
they have been recalled using Ctrl-P or the Up Arrow key. Repeat the key sequence to recall
successively more recent commands.
Note The arrow keys function only on ANSI-compatible terminals such as the VT100.
• Issue the show history command in user EXEC or privileged EXEC mode—Lists the most recent
commands that you entered. The number of commands that are displayed is determined by the
setting of the terminal history size and history commands.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-9
Introduction
The command history feature is enabled by default. To disable this feature for a terminal session,
issue the terminal no history command in user EXEC or privileged EXEC mode or the no history
command in line configuration mode.
Abbreviating Commands
Typing a complete command name is not always required for the command to execute. The CLI
recognizes an abbreviated command when the abbreviation contains enough characters to uniquely
identify the command. For example, the show version command can be abbreviated as sh ver. It cannot
be abbreviated as s ver because s could mean show, set, or systat. The sh v abbreviation also is not valid
because the show command has vrrp as a keyword in addition to version. (Command and keyword
examples are from Cisco IOS Release 12.4(13)T.)
Using Aliases for CLI Commands
To save time and the repetition of entering the same command multiple times, you can use a command
alias. An alias can be configured to do anything that can be done at the command line, but an alias cannot
move between modes, type in passwords, or perform any interactive functions.
Table 4 shows the default command aliases.
Table 4 Default Command Aliases
Command Alias Original Command
h help
lo logout
p ping
s show
u or un undebug
w where
To create a command alias, issue the alias command in global configuration mode. The syntax of the
command is alias mode command-alias original-command. Following are some examples:
• Router(config)# alias exec prt partition—privileged EXEC mode
• Router(config)# alias configure sb source-bridge—global configuration mode
• Router(config)# alias interface rl rate-limit—interface configuration mode
To view both default and user-created aliases, run the show alias command.
Using the no and default Forms of Commands
Most configuration commands have a no form that is used to reset a command to its default value or to
disable a feature or function. For example, the ip routing command is enabled by default. To disable
this command, you would issue the no ip routing command. To re-enable IP routing, you would issue
the ip routing command.
Configuration commands may also have a default form, which returns the command settings to their
default values. For commands that are disabled by default, using the default form has the same effect as
using the no form of the command. For commands that are enabled by default and have default settings,
Cisco IOS CMTS Cable Command Reference
CBL-10 OL-15510-15
Introduction
the default form enables the command and returns the settings to their default values. To see what
default commands are available on your system, enter default ? in the appropriate command mode of
the command-line interface.
The no form is documented in the command pages of Cisco IOS command references. The default form
is generally documented in the command pages only when the default form performs a function different
than that of the plain and no forms of the command.
Command pages often include a “Command Default” section as well. The “Command Default” section
documents the state of the configuration if the command is not used (for configuration commands) or
the outcome of using the command if none of the optional keywords or arguments is specified (for EXEC
commands).
Using the debug Command
A debug command produces extensive output that helps you troubleshoot problems in your network.
These commands are available for many features and functions within Cisco IOS software. Some debug
commands are debug all, debug aaa accounting, and debug mpls packets. To use debug commands
during a Telnet session with a device, you must first enter the terminal monitor command. To turn off
debugging completely, you must enter the undebug all command.
For more information about debug commands, see the Cisco IOS Debug Command Reference:
http://www.cisco.com/en/US/docs/ios/debug/command/reference/db_book.html
Caution Debugging is a high priority and high CPU utilization process that can render your device unusable. Use
debug commands only to troubleshoot specific problems. The best times to run debugging are during
periods of low network traffic and when few users are interacting with the network. Debugging during
these periods decreases the likelihood that the debug command processing overhead will affect network
performance or user access or response times.
Filtering Output Using Output Modifiers
Many commands produce lengthy output that may use several screens to display. Using output
modifiers, you can filter this output to show only the information that you want to see.
The following three output modifiers are available:
• begin regular-expression—Displays the first line in which a match of the regular expression is
found and all lines that follow.
• include regular-expression—Displays all lines in which a match of the regular expression is found.
• exclude regular-expression—Displays all lines except those in which a match of the regular
expression is found.
To use one of these output modifiers, type the command followed by the pipe symbol (|), the modifier,
and the regular expression that you want to search for or filter. A regular expression is a case-sensitive
alphanumeric pattern. It can be a single character or number, a phrase, or a more complex string.
The following example illustrates how to filter output of the show interface command to display only
lines that include the expression “protocol.”
Router# show interface | include protocol
FastEthernet0/0 is up, line protocol is up
Serial4/0 is up, line protocol is up
Serial4/1 is up, line protocol is up
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-11
Introduction
Serial4/2 is administratively down, line protocol is down
Serial4/3 is administratively down, line protocol is down
Understanding CLI Error Messages
You may encounter some error messages while using the CLI. Table 5 shows the common CLI error
messages.
Table 5 Common CLI Error Messages
Error Message Meaning How to Get Help
% Ambiguous command: You did not enter enough Reenter the command followed by a
“show con” characters for the command to space and a question mark (?). The
be recognized. keywords that you are allowed to
enter for the command appear.
% Incomplete command. You did not enter all the Reenter the command followed by a
keywords or values required space and a question mark (?). The
by the command. keywords that you are allowed to
enter for the command appear.
% Invalid input detected at “^” You entered the command in- Enter a question mark (?) to display
marker. correctly. The caret (^) marks all the commands that are available in
the point of the error. this command mode. The keywords
that you are allowed to enter for the
command appear.
For more system error messages, see the Cisco IOS Release 12.4T System Message Guide.
Saving Changes to a Configuration
To save changes that you made to the configuration of a device, you must issue the copy running-config
startup-config command or the copy system:running-config nvram:startup-config command. When
you issue these commands, the configuration changes that you made are saved to the startup
configuration and saved when the software reloads or power to the device is turned off or interrupted.
The following example shows the syntax of the copy running-config startup-config command:
Router# copy running-config startup-config
Destination filename [startup-config]?
You press Enter to accept the startup-config filename (the default), or type a new filename and then press
Enter to accept that name. The following output is displayed indicating that the configuration was saved.
Building configuration...
[OK]
Router#
On most platforms, the configuration is saved to NVRAM. On platforms with a Class A flash file system,
the configuration is saved to the location specified by the CONFIG_FILE environment variable. The
CONFIG_FILE variable defaults to NVRAM.
Cisco IOS CMTS Cable Command Reference
CBL-12 OL-15510-15
Introduction
Additional Information
• “Using the Cisco IOS Command-Line Interface” section of the Cisco IOS Configuration
Fundamentals Configuration Guide
http://www.cisco.com/en/US/docs/ios/fundamentals/configuration/guide/cf_cli-basics.html
• Cisco Product/Technology Support
http://www.cisco.com/go/techdocs
• Support area on Cisco.com (also search for documentation by task or product)
http://www.cisco.com/en/US/support/index.html
• Software Download Center (downloads; tools; licensing, registration, advisory, and general
information) (requires Cisco.com user ID and password)
http://www.cisco.com/kobayashi/sw-center/
• Error Message Decoder, a tool to help you research and resolve error messages for Cisco IOS
software
http://www.cisco.com/pcgi-bin/Support/Errordecoder/index.cgi
• Command Lookup Tool, a tool to help you find detailed descriptions of Cisco IOS commands
(requires Cisco.com user ID and password)
http://tools.cisco.com/Support/CLILookup
• Output Interpreter, a troubleshooting tool that analyzes command output of supported
show commands
https://www.cisco.com/pcgi-bin/Support/OutputInterpreter/home.pl
Related Documents
This section lists the other documents that provide more detailed hardware and software information
about the Cisco CMTS routers and Cisco Cable CPE devices documented in this guide. These
documents are available on Cisco.com and the customer documentation CD-ROM.
Cisco CMTS Hardware Installation and Software Configuration Guides
For detailed information about the Cisco CMTS platforms, see the following documents:
• Cisco uBR7200 Series Universal Broadband Router Hardware Installation Guide
• Cisco uBR7200 Series Software Configuration Guide
• Cisco uBR10012 Universal Broadband Router Hardware Installation Guide
• Cisco uBR10012 Universal Broadband Router Software Configuration Guide
• Cisco IOS CMTS Cable Software Configuration Guide
• Cisco Cable Modem Termination System Feature Guide
• Network Processing Engine and Network Services Engine Installation and Configuration
• Upgrading to the Cisco uBR7246 VXR Universal Broadband Router
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-13
Introduction
Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, submitting a service request, and gathering additional
information, see the monthly What’s New in Cisco Product Documentation, which also lists all new and
revised Cisco technical documentation, at:
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html
Subscribe to the What’s New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed
and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free
service and Cisco currently supports RSS version 2.0.
Cisco IOS CMTS Cable Command Reference
CBL-14 OL-15510-15
Cable Commands: a through cable-modem
Revised: July 2012, OL-15510-15
New Commands
Command Cisco IOS Software Release
application-id 12.2(33)SCA
Obsolete Commands
Command Effective Cisco IOS Release
activate-rule-at-byte-count 12.3(9a)BC
auto-sync 12.2(33)SCA
Replaced Commands
Command Replacement Command Effective Cisco IOS Release
annex modulation rf-channel frequency 12.3(23)BC
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-15
Cable Commands: a through cable-modem
access-denied
access-denied
To create a DOCSIS configuration file that disables network access to the customer premise equipment
(CPE) devices that are attached to the cable modem (CM) on a Cisco CMTS router, use the
access-denied command in cable config-file configuration mode. To enable access, use the no form of
this command.
access-denied
no access-denied
Syntax Description This command has no arguments or keywords.
Command Default Access to the cable network is permitted (no access-denied).
Command Modes Cable config-file configuration (config-file)
Command History Release Modification
12.1(2)EC1 This command was introduced.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
Usage Guidelines This command sets the Network Access Control object in the DOCSIS configuration file. If the object
is set to 1 (set by the default of no access-denied), the CPE devices behind the CM allow access to the
network. If the object is set to 0 (by configuration of the access-denied command) to disable network
access for the CPE devices, the CM does not forward traffic from its attached CPE devices.
For normal operation, the CM must be set to allow access (the default). However, to deny service for
reasons such as nonpayment or unauthorized use of services, the access-denied command can be used.
Examples The following example shows how to disable network access for the CPE devices that are connected to
the CM:
cable config-file disable.cm
access-denied
Related Commands Command Description
cable config-file Creates a DOCSIS configuration file and enters configuration file mode.
channel-id Specifies upstream channel ID.
cpe max Specifies customer premise equipment information.
download Specifies download information for the configuration file.
Cisco IOS CMTS Cable Command Reference
CBL-16 OL-15510-15
Cable Commands: a through cable-modem
access-denied
Command Description
frequency Specifies the downstream frequency.
option Specifies vendor-specific information fields in a DOCSIS configuration file.
privacy Specifies privacy options for baseline privacy images.
service-class Specifies service class definitions for the configuration file.
snmp manager Specifies Simple Network Management Protocol (SNMP) options.
timestamp Enables time-stamp generation.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-17
Cable Commands: a through cable-modem
activate-rule at-byte-count
activate-rule at-byte-count
Note Effective with Cisco IOS Release 12.3(9a)BC, the activate-rule at-byte-count command is not
available in Cisco IOS software.
To specify the number of bytes that a subscriber can transmit during the monitoring period on a Cisco
CMTS router, use the activate-rule at-byte-count command in enforce-rule configuration mode. To
reset the rule to its default values, use the no form of this command.
activate-rule at-byte-count kbytes {downstream | upstream} [enforce]
no activate-rule at-byte-count kbytes {downstream | upstream} [enforce]
Syntax Description kbytes Maximum number of kilobytes that the subscriber can transmit in the
specified direction during the monitoring period. The valid range is 1
to 4294967, with a default of 0 (no limit).
Note To reset the kilobyte count to 0, use the no form of this
command.
downstream Specifies that the kilobyte count applies to traffic in the downstream
direction.
upstream Specifies that the kilobyte count applies to traffic in the upstream di-
rection. The default value is upstream.
enforce (Optional) Specifies that the enforce-rule QoS profile should be
applied automatically if a user violates the registered QoS profile.
Note You must have previously configured a registered QoS profile,
using the qos-profile registered command, before being able
to use the enforce keyword.
Command Default The kbytes value defaults to 0 (no limit), upstream direction, and enforce-rule QoS profiles are not
automatically applied (no activate-rule at-byte-count enforce).
Command Modes Enforce-rule configuration (enforce-rule)
Command History Release Modification
12.2(15)BC1 This command was introduced.
12.3(9a)BC This command was removed.
Usage Guidelines The activate-rule at-byte-count command specifies the maximum number of bytes that a subscriber can
transmit during the monitor window period (see the monitoring-duration command). If a subscriber
transmits traffic beyond this maximum value, the CMTS router considers the subscriber to be
overconsuming.
Cisco IOS CMTS Cable Command Reference
CBL-18 OL-15510-15
Cable Commands: a through cable-modem
activate-rule at-byte-count
If the optional enforce keyword has been specified for an enforce-rule, the CMTS router automatically
switches overconsuming subscribers to the enforced QoS profile (see the qos-profile enforced
command). The enforced QoS profile remains in force during the penalty time period (see the
qos-profile registered command).
An enforce-rule can be created for only one direction, either upstream or downstream. To activate
subscriber traffic management for both the upstream and downstream directions, create two different
enforce-rules, with one rule’s activate-rule-at-byte-count command specifying the downstream
direction and the other rule specifying the upstream direction.
When you change the configuration of a currently active enforce-rule, that rule begins using the new
configuration immediately to manage the cable modems tracked by the enforce-rule.
Note You can create an enforce-rule that is a duplicate of an existing enforce-rule, but the duplicate rule is
not activated and applied to service flows until at least one of its parameters is changed so that it has a
unique configuration.
Examples The following example shows a typical activate-rule-at-byte-count command for the downstream
direction:
Router# configure terminal
Router(config)# cable qos enforce-rule residential
Router(enforce-rule)# activate-rule at-byte-count 20 downstream
The following example shows a typical activate-rule-at-byte-count command for the upstream
direction. The enforce option is also added so that the enforce-rule QoS profile is automatically applied
to users who exceed their registered profile:
Router# configure terminal
Router(config)# cable qos enforce-rule test
Router(enforce-rule)# activate-rule at-byte-count 5 upstream enforce
The following example shows the same command being given for a second enforce-rule. The system
rejects the command because it is a duplicate of an existing rule, using the same QoS profile and
direction. You must change at least one of the rule parameters to make it unique before it is mapped and
applied to service flows.
Router# configure terminal
Router(config)# cable qos enforce-rule test2
Router(enforce-rule)# activate-rule at-byte-count 5 upstream enforce
Enforce-rule test2 won't be mapped to service flows as it is duplicate of test1 with same
registered qos-profile 5 and same direction
Related Commands Command Description
cable qos enforce-rule Creates an enforce-rule to enforce a particular QoS profile for
subscriber traffic management and enters enforce-rule configuration
mode.
enabled (enforce-rule) Activates an enforce-rule and begins subscriber traffic management
on a Cisco CMTS router.
duration Specifies the time period and sample rate to be used for monitoring
subscribers.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-19
Cable Commands: a through cable-modem
activate-rule at-byte-count
Command Description
penalty-period Specifies the time period that an enforced QoS profile should be in
effect for subscribers that violate their registered QoS profiles.
qos-profile enforced Specifies a QoS profile that should be enforced when users violate
their registered QoS profiles.
qos-profile registered Specifies the registered QoS profile that should be used for this
enforce-rule.
show cable qos enforce-rule Displays the QoS enforce-rules that are currently defined.
show cable subscriber-usage Displays subscribers who are violating their registered QoS profiles.
Cisco IOS CMTS Cable Command Reference
CBL-20 OL-15510-15
Cable Commands: a through cable-modem
annex modulation
annex modulation
Note Effective with Cisco IOS Release 12.3(23)BC, the annex modulation command is obsolete and annex
and modulation are included as keyword options in the rf-channel frequency command.
To set the annex (MPEG framing format) and modulation for the Wideband SPA, use the
annex modulation command in controller configuration mode. To set the annex to B and the modulation
to 64 QAM, use the no form of this command.
annex {A | B} modulation {64qam | 256qam} [rf-start-index rf-end-index]
no annex {A | B} modulation {64qam | 256qam} [rf-start-index rf-end-index]
Syntax Description {A | B} Specifies the MPEG framing format:
• A–Annex A. The downstream is compatible with the European MPEG
framing format specified in ITU-TJ.83 Annex A.
• B–Annex B. The downstream is compatible with the North American
MPEG framing format specified in ITU-TJ.83 Annex B.
{64qam | 256qam} Specifies the modulation rate:
• 64qam–64-QAM modulation.
• 256qam–256-QAM modulation.
rf-start-index (Optional) Specifies the start and end indexes for RF channels. The following
values are allowed:
rf-end-index
• If the annex is A and the modulation is 256 QAM, rf-start-index must
be 0, and rf-end-index must be 17.
• For all other cases, rf-start-index must be 0, and rf-end-index must
be 23.
Command Default No annex or modulation is set for the Wideband SPA.
Command Modes Controller configuration
Command History Release Modification
12.3(21)BC This command was introduced for the Cisco uBR10012 router.
12.3(23)BC This command was made obsolete and annex and modulation were included
as keyword options in the rf-channel frequency command.
Usage Guidelines Use this command to set the following on a Wideband SPA:
• Annex (MPEG framing format)
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-21
Cable Commands: a through cable-modem
annex modulation
• Modulation
• Start and end indexes for RF channels
Each Wideband SPA supports up to 24 RF channels depending on how the SPA is configured with the
annex modulation command.
• For annex A and 256 QAM modulator, each Wideband SPA supports 18 RF channels.
• For all other cases, each Wideband SPA supports 24 RF channels.
The rf-start-index and rf-end-index arguments are intended for future use and are not currently needed.
If rf-start-index and rf-end-index are not specified, the default values are as follows:
• If the annex is A and the modulation is 256 QAM, rf-start-index is 0, and rf-end-index is 17.
• For all other cases, rf-start-index is 0, and rf-end-index is 23.
Examples The following example shows how to set the MPEG framing format and modulation for the Wideband
SPA located at slot 1, subslot 0, bay 0:
Router(config)# controller modular-cable 1/0/0
Router(config-controller)# annex B modulation 64qam
Related Commands Command Description
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.
ip-address (controller) Sets the IP address of the Wideband SPA FPGA.
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.
Cisco IOS CMTS Cable Command Reference
CBL-22 OL-15510-15
Cable Commands: a through cable-modem
application-id
application-id
To specify an application type to allow admission control to be applied to a group configuration, use the
application-id command in multicast QoS configuration mode. To disable admission control, use the
no form of this command.
application-id number
no application-id number
Syntax Description number Specifies the application identification number of the multicast QoS group.
The valid range is 1–65535.
Command Default Multicast QoS group application type is not identified.
Command Modes Multicast QoS configuration (config-mqos)
Command History Release Modification
12.2(33)SCA This command was introduced.
Usage Guidelines In order to enable intelligent multicast admission control, you must enable and configure an application
type using the application-id command.
Examples The following example identifies a multicast QoS group application ID using the applicaton-id
command:
Router(config)# cable multicast qos group 20 priority 55 global
Router(config-mqos)# application-id 44
Related Commands Command Description
cable multicast qos Specifies and configures a cable multicast QoS group.
group
show interface bundle Displays multicast session information for a specific virtual cable bundle.
multicast-sessions
show interface cable Displays multicast session information for a specific cable interface.
multicast-sessions
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-23
Cable Commands: a through cable-modem
auto-sync
auto-sync
To enable automatic synchronization of the configuration files in NVRAM, use the auto-sync command
in main-cpu redundancy configuration mode. To disable automatic synchronization, use the no form of
this command.
auto-sync {startup-config | config-register | bootvar | running-config | standard}
no auto-sync {startup-config | config-register | bootvar | standard}
Syntax Description startup-config Specifies synchronization of the startup configuration files.
config-register Specifies synchronization of the configuration register values.
bootvar Specifies synchronization of the following boot variables:
• BOOT—Set by the boot system device:filename command.
• CONFIG_FILE—Set by the boot config device:filename command.
• BOOTLDR—Set by the boot bootldr device:filename command.
running-config Specifies synchronization of the running configuration files.
standard Specifies synchronization of all of the system files (startup configuration, boot
variables, and config configuration registers).
Defaults For the Performance Routing Engines (PREs) on the Cisco uBR10012 universal broadband router, the
system defaults to synchronizing all system files on the (auto-sync standard).
For the Supervisor Engines on the Cisco 7600 series routers, the system defaults to synchronizing the
running configuration. (running-config).
Command Modes Redundancy configuration (config-r)
Command History Release Modification
12.2(4)XF1 This command was introduced on the Cisco uBR10012 universal broadband router.
12.2(14)SX This command was integrated into the Supervisor Engine 720.
12.2(17d)SXB Support was added for the Supervisor Engine 2.
12.2(18)SXD Support for this command on the Cisco 7600 series routers was removed.
12.3BC This command was integrated into Cisco IOS Release 12.3BC for the
Cisco uBR10012 router.
12.2(33)SCA This command is obsolete on the Cisco uBR10012 universal broadband router.
Usage Guidelines Cisco 7600 Series Routers
If you enter the no auto-sync standard command, no automatic synchronizations occur. If you want to
enable any of the keywords, you have to enter the appropriate command for each keyword.
The auto-sync command is not supported in RPR+ mode.
Cisco IOS CMTS Cable Command Reference
CBL-24 OL-15510-15
Cable Commands: a through cable-modem
auto-sync
Cisco uBR10012 Universal Broadband Router
By default, the system synchronizes all system files, which is the typical setting for most applications.
However, you might want exclude certain files from synchronization for specialized applications.
For example, if you have configured the active and standby PRE1 (or PRE2) modules to run different
versions of Cisco IOS software, you might want to use different configuration files as well. In this case,
you would not synchronize the startup configuration file.
Examples Cisco 7600 Series Routers
The following example shows how (from the default configuration) to enable automatic synchronization
of the configuration register in the main CPU:
Router# configure terminal
Router (config)# redundancy
Router (config-r)# main-cpu
Router (config-r-mc)# no auto-sync standard
Router (config-r-mc)# auto-sync config-register
Cisco uBR10012 Universal Broadband Router
The following example shows the system being configured to synchronize only the startup configuration
file:
router(config)# redundancy
router(config-r)# main-cpu
router(config-r-mc)# auto-sync startup-config
router(config-r-mc)# exit
router(config-r)# exit
The following example shows how to configure the system to synchronize all system files except for the
startup configuration file. This typically is done when the two PRE1 (or PRE2) modules are running
different software images.
router(config)# redundancy
router(config-r)# main-cpu
router(config-r-mc)# no auto-sync startup-config
router(config-r-mc)# auto-sync config-register
router(config-r-mc)# auto-sync bootvar
router(config-r-mc)# exit
router(config-r)# exit
Related
Commands Command Description
redundancy Enters redundancy configuration mode.
main-cpu Enters main CPU redundancy configuration mode.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-25
Cable Commands: a through cable-modem
cable-modem compliant bridge
cable-modem compliant bridge
To enable DOCSIS-compliant bridging for the cable interface at startup, use the cable-modem
compliant bridge command in cable interface configuration mode. To disable DOCSIS-compliant
bridging, which is required to enable routing mode, use the no form of this command.
Cisco uBR904, uBR905, uBR924, uBR925 cable access routers, Cisco CVA122 Cable Voice Adapter
cable-modem compliant bridge
no cable-modem compliant bridge
Syntax Description This command has no arguments or keywords.
Command Default DOCSIS-compliant bridging is enabled by default.
Command Modes Interface configuration (cable interface only)
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.
Usage Guidelines It is normally not necessary to enter this command in data-over-cable bridging applications because
DOCSIS-compliant bridging is enabled by default. However, to configure the router for full transparent
bridging or for routing mode, use the no form of the command and then configure the router as desired
using the appropriate CLI commands.
Examples The following example shows how to disable DOCSIS-compliant bridging on the cable interface:
Router# configure terminal
Router(config)# interface cable-modem 0
Router(config-if)# no cable-modem compliant bridge
Router(config-if)#
Cisco IOS CMTS Cable Command Reference
CBL-26 OL-15510-15
Cable Commands: a through cable-modem
cable-modem compliant bridge
Related Commands Command Description
cable-modem downstream saved Modifies the saved downstream channel setting and
channel upstream power value on the cable interface.
cable-modem fast-search Enables a faster downstream search algorithm 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 calls to be sent upstream over the cable
interface via best effort.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-27
Cable Commands: a through cable-modem
cable-modem dhcp-proxy
cable-modem dhcp-proxy
To specify that a Dynamic Host Configuration Protocol (DHCP) server should provide an IP address for
the router’s Ethernet interface, for the loopback interface, or for the router’s Network Address
Translation (NAT) address pool, use the cable-modem dhcp-proxy command in cable interface
configuration mode. To disable this feature so that you can then manually assign an IP address to the
Ethernet interface or NAT address pool, use the no form of this command.
Cisco uBR905, Cisco uBR924, Cisco uBR925 Cable Access Routers, and Cisco CVA122 Cable Voice Adapter
cable-modem dhcp-proxy {interface ethernet number | interface loopback number |
nat pool-name}
no cable-modem dhcp-proxy {interface ethernet number | interface loopback number |
nat pool-name}
Note This command is available only when the router is configured for routing mode and cannot be used when
the router is configured for DOCSIS-compliant bridging.
Syntax Description interface ethernet number Identifies the Ethernet interface to be assigned the static IP address from
the DHCP server (always 0).
interface loopback number Identifies the loopback interface to be assigned the static IP address from
the DHCP server (always 0).
nat pool-name Specifies the name of the NAT pool to be created using the IP address
and subnet mask supplied by the DHCP server. (This option is equivalent
to giving the ip nat pool pool-name start-ip end-ip netmask subnet
command, using the IP address and subnet mask supplied by the DHCP
server.)
Command Default No default behavior or values
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.1(1)T This command was introduced on 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.
12.2(8)YJ The loopback option was added to support automatic configuration of the IP
address on the cable modem tunnel interface for the Cisco uBR905 and
Cisco uBR925 cable access routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
Cisco IOS CMTS Cable Command Reference
CBL-28 OL-15510-15
Cable Commands: a through cable-modem
cable-modem dhcp-proxy
Usage Guidelines This command is useful in three situations:
• When the router is configured for routing mode, an IP address must be assigned to its Ethernet
interface. Without the cable-modem dhcp-proxy command, this IP address must be a static IP
address assigned either by using a Cisco IOS configuration file or by manually entering the
necessary interface configuration CLI commands. The cable-modem dhcp-proxy command allows
a DHCP server to assign an IP address to the Ethernet interface.
• When NAT is used, an inside global address pool must be created on the Ethernet interface. Without
the cable-modem dhcp-proxy command, this must be done by specifying a static IP address in the
ip nat pool pool-name start-ip end-ip netmask subnet command. The cable-modem dhcp-proxy
command allows a DHCP server to assign an IP address that automatically creates the NAT address
pool.
When using this option, you must also use the following NAT configuration commands:
– Use the ip nat inside command in interface configuration mode to configure the Ethernet
interface as the inside interface.
– Use the ip nat outside command in interface configuration mode to configure the cable
interface as the outside interface.
– Specify the overload option with the ip nat command in global configuration mode to
implement Port Address Translation (PAT) so that multiple PCs can use the single IP address
in the NAT pool created by the cable-modem dhcp-proxy command.
• When using the Cisco Easy VPN feature to create a VPN tunnel, the command allows a static
address to be used for the tunnel’s creation.
After configuring the router with the cable-modem dhcp-proxy command, reboot the router. During the
DOCSIS provisioning process, the router sends a DHCP client request to obtain an IP address for the
cable interface.
The router then sends a proxy DHCP request to the DHCP server using the Ethernet interface’s MAC
address. The DHCP server replies with a second IP address that the router assigns to either the Ethernet
or loopback interface, or to the NAT pool, depending on which option was used in the cable-modem
dhcp-proxy command.
Note When replying to the proxy request for the Ethernet interface, the DHCP server should assign an IP
address that is on the same network as the customer premises equipment (CPE) devices that are attached
to the router’s Ethernet interface.
Tip If you have configured a Cisco CM for routing mode and are also using the cable-modem dhcp-proxy
nat command on the CM, you must configure the corresponding cable interface on the Cisco CMTS with
the cable dhcp-giaddr policy command.
Using NAT and DHCP Proxy and Copying Configuration Files
Most service providers typically create a standard configuration file for their cable modems, verify it,
and then copy the working configuration as needed to other cable modems. This can cause problems
when using the cable-modem dhcp-proxy command to create a NAT address pool for NAT/PAT
translation.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-29
Cable Commands: a through cable-modem
cable-modem dhcp-proxy
The reason is that the default router configuration is for DOCSIS-compliant bridging, which includes
two bridge-group 59 commands for each interface. To use the cable-modem dhcp-proxy command,
you must put the router into routing mode, which means removing the bridge-group commands with
the equivalent no bridge-group commands.
However, because no bridge-group is the default for these CLI commands, they are not saved in the
running configuration. So when you save the Cisco IOS configuration file and copy it to other routers,
the router is only partially configured for routing mode and continually resets its interfaces.
In addition, whenever you use the cable-modem dhcp-proxy command to create a NAT pool, the router
automatically adds the appropriate ip nat pool commands to the configuration when it receives the
actual IP addresses from the DHCP server. The IP addresses specified in this command are particular to
each user and should not be copied to other routers.
To avoid this problem, use the following procedure to create a Cisco IOS configuration file that uses the
cable-modem dhcp-proxy command to create a NAT address pool for NAT/PAT address translation:
Step 1 Create and test a working configuration on a cable access router.
Step 2 After you have created a standardized configuration, save it to memory, and then copy the Cisco IOS
configuration file to the TFTP server that will be used to copy the file to the other routers.
Step 3 Open the Cisco IOS configuration file with a text editor and add the following lines underneath each
interface:
no bridge-group 59
no bridge-group 59 spanning-disabled
Step 4 Remove the ip nat pool command.
For example, the following are the relevant lines in a typical DHCP proxy NAT configuration for a cable
access router:
interface Ethernet0
ip address 192.168.1.1 255.255.255.0
ip nat inside
load-interval 30
!
interface cable-modem0
ip nat outside
load-interval 30
no cable-modem compliant bridge
cable-modem dhcp-proxy nat nat-pool
!
ip nat pool nat-pool 10.15.0.10 10.15.0.10 netmask 255.255.0.0
When you copy this configuration file to the TFTP server, modify this portion of the configuration file
to add the no bridge-group commands under each interface and to remove the ip nat pool command:
interface Ethernet0
ip address 192.168.1.1 255.255.255.0
ip nat inside
load-interval 30
no bridge-group 59
no bridge-group 59 spanning-disabled
!
interface cable-modem0
ip nat outside
load-interval 30
no cable-modem compliant bridge
Cisco IOS CMTS Cable Command Reference
CBL-30 OL-15510-15
Cable Commands: a through cable-modem
cable-modem dhcp-proxy
cable-modem dhcp-proxy nat nat-pool
no bridge-group 59
no bridge-group 59 spanning-disabled
!
Note Be sure to remove the ip nat pool command.
Examples The following example shows how to configure the router so that it makes a proxy DHCP request to
obtain an IP address for its Ethernet interface:
Router(config)# interface c0
Router(config-if)# cable-modem dhcp-proxy interface ethernet 0
The following example creates a NAT address pool with the IP address assigned by the DHCP server;
this IP address must be in the network attached to the Ethernet address (which in this case is
192.168.100.0).
Router(config)# ip nat inside source list 1 pool net-208 overload
Router(config)# interface cable0
Router(config-if)# ip nat outside
Router(config-if)# no cable compliant bridge
Router(config-if)# cable-modem dhcp-proxy nat net-208
Router(config-if)# exit
Router(config)# interface ethernet0
Router(config-if)# ip address 192.168.100.94 255.255.255.0
Router(config-if)# ip nat inside
Router(config-if)# exit
Router(config)# access-list 1 permit 192.168.100.0 0.0.0.255
Router(config)#
Related Commands Command Description
cable-modem compliant bridge Enables DOCSIS-compliant transparent bridging for the cable
interface at startup.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-31
Cable Commands: a through cable-modem
cable-modem downstream saved channel
cable-modem downstream saved channel
To modify the saved downstream channel setting and upstream power value on the cable interface, use
the cable-modem downstream saved channel command in cable interface configuration mode. To
remove the saved settings, which will be saved at the next initialization cycle, use the no form of this
command.
Cisco uBR904, uBR924 cable access routers
cable-modem downstream saved channel ds-frequency us-power
no cable-modem downstream saved channel ds-frequency us-power
Note Cisco IOS Release 12.1(2)T removed this command from the CLI for all platforms and reserved it for
exclusive use by the DOCSIS provisioning process.
Syntax Description ds-frequency Downstream channel frequency in Hz, which can be from 91,000,000 to
860,000,000.
us-power Upstream power level in decibels per millivolt (dBmV), which can be from 8 to
61.
Command Default Enabled
Command Modes Interface configuration (cable interface only)
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(2)T This command was removed from the CLI for all platforms and reserved for
exclusive use by the DOCSIS provisioning process.
Usage Guidelines This command is auto-generated by the operation of the cable MAC layer process. The DOCSIS RFI
specification requires that CMs remember the downstream frequency and upstream power of the last
successfully ranged session. These arguments are called up as the first downstream frequency and
upstream power to use the next time the CM is booted. This operation dramatically speeds up the channel
search.
Use the no cable-modem downstream saved channel ds-frequency us-power command to remove the
saved frequency and power setting from the running configuration, which will be saved at the next
initialization cycle.
Cisco IOS CMTS Cable Command Reference
CBL-32 OL-15510-15
Cable Commands: a through cable-modem
cable-modem downstream saved channel
To comply with DOCSIS requirements, Cisco IOS Release 12.1(2)T removed this command from the
CLI for all platforms and reserved it for exclusive use by the DOCSIS provisioning process. This
command exists in earlier Cisco IOS versions, but Cisco recommends that this command NOT be used
by end users of Cisco cable CPE devices.
Examples The following example shows how to remove the downstream frequency of 91,000,000 Hz and the
upstream power level of 33 dBmV from the running configuration of a cable-modem interface:
Router(config)# interface cable-modem 0
Router(config-if)# no cable-modem downstream saved channel 91000000 33
Router(config-if)#
Related Commands Command Description
cable-modem compliant bridge Enables DOCSIS-compliant transparent bridging for the
cable interface at startup.
cable-modem fast-search Enables a faster downstream search algorithm on the cable
interface.
cable-modem upstream preamble qpsk Enables the QPSK modulation scheme in the upstream
direction from the CM interface to the CMTS.
cable-modem voip best-effort Allows voice calls to be sent upstream over the cable
interface via best effort.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-33
Cable Commands: a through cable-modem
cable-modem fast-search
cable-modem fast-search
To enable a faster downstream search algorithm on the cable interface, use the cable-modem
fast-search command in cable interface configuration mode. To disable the downstream fast-search
feature, use the no form of this command.
Cisco uBR904, uBR924 cable access routers
cable-modem fast-search
no cable-modem fast-search
Note Cisco IOS Release 12.1(2)T removed this command from the CLI for all platforms and reserved it for
exclusive use by the DOCSIS provisioning process.
Syntax Description This command has no arguments or keywords.
Command Default Disabled
Command Modes Interface configuration (cable interface only)
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(2)T This command was removed from the CLI for all platforms and reserved for
exclusive use by the DOCSIS provisioning process.
Usage Guidelines This feature speeds up the frequency search performed by the cable access router. Normally it takes the
cable access router about 30 to 50 seconds to sample 30 to 50 frequencies. The cable-modem
fast-search command can reduce this search time. However, there might be some cases where this
fast-search algorithm might not perform as well as the default algorithm. Trial and error is the only way
to discover how well this feature works for your environment.
Examples The following example shows how to enable the faster downstream search algorithm on the router’s
cable interface:
Router(config)# interface cable-modem 0
Router(config-if)# cable-modem fast-search
Router(config-if)#
Cisco IOS CMTS Cable Command Reference
CBL-34 OL-15510-15
Cable Commands: a through cable-modem
cable-modem fast-search
Related Commands Command Description
cable-modem compliant bridge Enables DOCSIS-compliant transparent bridging for the
cable interface at startup.
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 calls to be sent upstream over the cable
interface via best effort.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-35
Cable Commands: a through cable-modem
cable-modem qos drop-ack
cable-modem qos drop-ack
To enable the automatic dropping of unnecessary TCP packet acknowledgements on the cable interface,
use the cable-modem qos drop-ack command in cable interface configuration mode. To disable this
feature, so that all TCP packet acknowledgements are sent, use the no form of this command.
Cisco uBR905, uBR924, uBR925 cable access routers, Cisco CVA122 Cable Voice Adapter
cable-modem qos drop-ack
no cable-modem qos drop-ack
Syntax Description This command has no arguments or keywords.
Command Default Enabled
Command Modes Interface configuration and subinterface configuration (cable interface only)
Command History Release Modification
12.2(2)XA4 This command was introduced for the Cisco uBR905 cable access router and
Cisco CVA122 Cable Voice Adapter.
12.2(7) Support was added for the Cisco uBR924 cable access router.
12.2(8)T Support was added for the Cisco uBR925 cable access router.
Usage Guidelines TCP traffic uses a packet-acknowledge algorithm, where a group of packets must be acknowledged
before additional traffic can be sent. When a large number of packets is transmitted on the downstream,
it can result in a large number of acknowledgements on the upstream. Because the downstream
bandwidth is typically many times greater than the upstream bandwidth, certain applications can
temporarily overrun the upstream with a large volume of acknowledgement packets.
If any of those acknowledgements are dropped or lost, traffic can be backed up, and data packets might
have to be resent, even if those packets had in fact been successfully received. This can significantly
impact real-time traffic, such as voice calls.
To optimize the TCP traffic on the upstream in these circumstances, the Cisco uBR905, Cisco uBR924,
and Cisco uBR925 cable access routers and the Cisco CVA122 Cable Voice Adapters automatically
analyze the upstream traffic and drop unnecessary packet acknowledgements when traffic begins
backing up. This feature has been automatically enabled by default on the routers, starting with
Cisco IOS Release 12.0(5)T.
In some situations, however, this feature can result in packets being dropped on the upstream, which
could impact the performance of certain applications such as FTP transfers. If packet drops do occur on
the upstream, this feature can be turned off with the no cable-modem qos drop-ack command.
Cisco IOS CMTS Cable Command Reference
CBL-36 OL-15510-15
Cable Commands: a through cable-modem
cable-modem qos drop-ack
Examples The following example shows how to disable the TCP packet optimization feature on the cable interface,
so that all TCP packet acknowledgements are sent:
Router(config)# interface cable-modem 0
Router(config-if)# no cable-modem qos drop-ack
Router(config-if)#
The following example shows how to enable the TCP packet optimization feature on the cable interface.
This is the default configuration, so it does not need to be done unless it has been previously disabled.
Router(config)# interface cable-modem 0
Router(config-if)# cable-modem qos drop-ack
Router(config-if)#
Related Commands Command Description
show controllers cable-modem qos Displays detailed information about the Quality of Service
(QoS) configuration.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-37
Cable Commands: a through cable-modem
cable-modem upstream preamble qpsk
cable-modem upstream preamble qpsk
To enable the QPSK modulation scheme in the upstream direction from the cable interface to the CMTS,
use the cable-modem upstream preamble qpsk command in cable interface configuration mode. To
disable upstream modulation for the interface, use the no form of this command.
Cisco uBR904, uBR905, uBR924, uBR925 cable access routers, Cisco CVA122 Cable Voice Adapter
cable-modem upstream preamble qpsk
no cable-modem upstream preamble qpsk
Syntax Description This command has no arguments or keywords.
Command Default Enabled
Command Modes Interface configuration (cable interface only)
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.
Examples The following example shows how to configure the cable interface for QPSK modulation on the
upstream:
Router(config)# interface cable-modem 0
Router(config-if)# cable-modem upstream preamble qpsk
Router(config-if)#
Related Commands Command Description
cable-modem compliant bridge Enables DOCSIS-compliant transparent bridging for the
cable interface at startup.
cable-modem downstream saved channel Modifies the saved downstream channel setting and
upstream power value on the cable interface.
cable-modem fast-search Enables a faster downstream search algorithm on the
cable interface.
cable-modem voip best-effort Allows voice calls to be sent upstream over the cable
interface via best effort.
Cisco IOS CMTS Cable Command Reference
CBL-38 OL-15510-15
Cable Commands: a through cable-modem
cable-modem voip best-effort
cable-modem voip best-effort
To allow voice calls to be sent upstream over the cable interface using best-effort quality of service
(QoS), use the cable-modem voip best-effort command in cable interface configuration mode. To
disable best-effort voice calls, use the no form of this command.
Cisco uBR924 cable access router
cable-modem voip best-effort
no cable-modem voip best-effort
Note Cisco IOS Release 12.1(2)T removed this command from the CLI for all platforms and reserved it for
exclusive use by the DOCSIS provisioning process.
Syntax Description This command has no arguments or keywords.
Command Default Enabled
Command Modes Interface configuration (cable interface only)
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(2)T This command was removed from the CLI for all platforms and reserved for
exclusive use by the DOCSIS provisioning process.
Usage Guidelines This command allows you to configure the voice traffic on a router to allow only calls having a
high-priority service identifier (SID) to be connected.
If the dynamic configuration of high-priority queues for voice traffic fails, or if the far end cannot
support the multiple SIDs and multiple classes of service required by high-priority traffic, the flag set
by this command will be checked. If enabled (the default setting), the call will be allowed to go through.
If disabled, the call will fail.
Examples The following example shows how to disable best-effort voice calls:
Router(config)# interface cable-modem 0
Router(config-if)# no cable-modem voip best-effort
Router(config-if)#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-39
Cable Commands: a through cable-modem
cable-modem voip best-effort
Related Commands Command Description
cable-modem compliant bridge Enables DOCSIS-compliant transparent bridging for the
cable interface at startup.
cable-modem downstream saved channel Modifies the saved downstream channel setting and
upstream power value on the cable interface.
cable-modem fast-search Enables a faster downstream search algorithm 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.
Cisco IOS CMTS Cable Command Reference
CBL-40 OL-15510-15
Cable Commands: a through cable-modem
cable-modem voip clock-internal
cable-modem voip clock-internal
To enable the router’s internal clock for Voice-over-IP (VoIP) calls, use the cable-modem voip
clock-internal command in cable interface configuration mode. To disable the internal clock, so that it
uses the clock from the cable interface for VoIP calls, use the no form of this command.
Cisco uBR924, uBR925 cable access routers, Cisco CVA122 Cable Voice Adapter
cable-modem voip clock-internal
no cable-modem voip clock-internal
Syntax Description This command has no arguments or keywords.
Command Default The default is to use the clock from the cable interface for VoIP calls.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.1(4)T This command was introduced for the Cisco uBR924 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.
Usage Guidelines This command enables the internal clock, allowing it to make VoIP calls over the Ethernet and USB
interfaces even when the cable interface is down or disconnected. If the CMTS is a Cisco uBR7200
series with a Cable Clock Card, this command disables the use of that clock.
This command can be used in both DOCSIS IP bridging and routing mode. However, when operating in
DOCSIS IP bridging mode, VoIP packets are transmitted out only on the cable interface, so the router
must be operating in routing mode to transmit voice packets out the Ethernet and USB interfaces.
Examples The following example shows how to enable the internal clock for VoIP calls:
Router(config)# interface cable0
Router(config-if)# cable-modem voip clock-internal
Router(config-if)#
Related Commands Command Description
cable-modem compliant bridge Enables DOCSIS-compliant transparent bridging for the
cable interface at startup.
cable-modem downstream saved channel Modifies the saved downstream channel setting and
upstream power value on the cable interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-41
Cable Commands: a through cable-modem
cable-modem voip clock-internal
Command Description
cable-modem fast-search Enables a faster downstream search algorithm 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.
Cisco IOS CMTS Cable Command Reference
CBL-42 OL-15510-15
Cable Commands: cable a through cable c
Revised: July 2012, OL-15510-15
New Commands
Command Cisco IOS Software Release
cable clock dti 12.3(23)BC
cable clock dti clear-counters 12.3(23)BC
cable bundle 12.2(33)SCA
cable attribute-mask 12.2(33)SCB
cable cm-status 12.2(33)SCB
cable cm-status enable 12.2(33)SCB
cable admission-control 12.2(33)SCC
max-reserved-bandwidth
cable clock upgrade 12.2(33)SCC
cable bonding-group-secondary 12.2(33)SCE
cable acfe enable 12.2(33)SCF
cable acfe max-bonus-bandwidth 12.2(33)SCF
cable acfe max-eir-ratio 12.2(33)SCF
cable bgsync 12.2(33)SCG
cable bgsync active 12.2(33)SCG
Modified Commands
Command Cisco IOS Software Release
cable application-type include 12.2(33)SCA
cable clock clear-counters 12.3(23)BC
cable admission-control ds-bandwidth 12.2(33)SCC
cable admission-control us-bandwidth 12.2(33)SCC
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-43
Cable Commands: cable a through cable c
cable acfe enable
cable acfe enable
To enable Fairness Across DOCSIS Interfaces feature on the integrated-cable (IC), modular-cable (MC),
or wideband-cable (WB) interfaces, use the cable acfe enable command in global configuration mode.
To disable Fairness Across DOCSIS Interfaces feature, use the no form of this command.
cable acfe enable
no cable acfe enable
Syntax Description This command has no arguments or keywords.
Command Default Fairness Across DOCSIS Interfaces feature is disabled.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCF This command was introduced.
Usage Guidelines Configure the Fairness Across DOCSIS Interfaces feature on the MC, IC, or WB interfaces.
It is recommended that you clear the CIR reservation above the legacy “reservable” bandwidth before
disabling Fairness Across DOCSIS Interfaces feature. This is to prevent any CIR over-subscription after
disabling Fairness Across DOCSIS Interfaces feature.
Examples The following example shows how to enable Fairness Across DOCSIS Interfaces feature in cable
interfaces.
Router(config)# cable acfe enable
Related Commands Command Description
cable acfe period Configures the interval for running the EIR rebalancing process.
show cable acfe Displays Fairness Across DOCSIS Interfaces feature status and statistics.
summary
debug cable acfe Displays the debug information related to algorithm or interaction with the
system.
Cisco IOS CMTS Cable Command Reference
CBL-44 OL-15510-15
Cable Commands: cable a through cable c
cable acfe max-bonus-bandwidth
cable acfe max-bonus-bandwidth
To configure the maximum usable bonus bandwidth for a bonding group (BG), use the cable acfe
max-bonus-bandwidth command in interface configuration mode. To revert to the default values, use
the no form of this command.
cable acfe max-bonus-bandwidth bonus-bandwidth
no cable acfe max-bonus-bandwidth
Syntax Description bonus-bandwidth Maximum usable bonus bandwidth for a BG. There is no valid range, and the
bonus bandwidth can use the entire bandwidth of an interface.
Command Default The bonus bandwidth can use the entire bandwidth of an interface.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCF This command was introduced.
Usage Guidelines The cable acfe max-bonus-bandwidth command configures the maximum usable bonus bandwidth.
After disabling Fairness Across DOCSIS Interfaces feature, this configuration is retained. However, it
will not be used.
Examples The following example shows how to configure the maximum usable bonus bandwidth for a BG:
Router(config-if)# cable acfe max-bonus-bandwidth 1000000
Related Commands Command Description
cable acfe enable Enables Fairness Across DOCSIS Interfaces feature on the CMTS routers.
debug cable acfe Displays the debug information related to algorithm or interaction with the
system.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-45
Cable Commands: cable a through cable c
cable acfe max-eir-ratio
cable acfe max-eir-ratio
To configure the maximum EIR ratio between the BE bandwidth among adjacent bonding groups (BGs),
use the cable acfe max-eir-ratio command in global configuration mode. To return to the default values,
use the no form of this command.
cable acfe max-eir-ratio eir-ratio
no cable acfe max-eir-ratio
Syntax Description eir-ratio EIR rebalance ratio between two adjacent BGs. The valid range is from 1 to
100 with a default value of 10.
Command Default The default value for EIR rebalance ratio is 10.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCF This command was introduced.
Usage Guidelines The cable acfe max-eir-ratio command configures the maximum EIR ratio between the BE bandwidth
among adjacent BGs.
The failure to maintain the maximum EIR ratio may reduce the guaranteed bandwidth rate for the BE
traffic to zero. This may lead to rejection of unicast CIR flows.
Examples The following example shows how to configure the EIR rebalance ratio between two adjacent BGs:
Router(config)# cable acfe max-eir-ratio 20
Related Commands Command Description
cable acfe enable Enables Fairness Across DOCSIS Interfaces feature on the CMTS router.
debug cable acfe Displays the debug information related to algorithm or interaction with the
system.
Cisco IOS CMTS Cable Command Reference
CBL-46 OL-15510-15
Cable Commands: cable a through cable c
cable admission-control
cable admission-control
To configure the CPU and memory thresholds for a Cisco CMTS router supporting broadband
processing engines (BPEs), use the cable admission-control command in global configuration mode.
This command sets the CPU averaging method and memory thresholds. To remove thresholds from a
Cisco CMTS router, use the no form of this command.
cable admission-control {cpu-5sec | cpu-avg } {[ io-mem] [proc-mem] [total-memory] } minor
num1 major num2 critical num3
no cable admission control {cpu-5sec | cpu-avg } {[ io-mem] [proc-mem] [total-memory] }
minor num1 major num2 critical num3
Syntax Description cpu-5sec This keyword sets Admission Control thresholds on the Cisco CMTS based on a
five-second average for the CPU. This setting must be combined with the additional
minor, major and critical threshold percentage values.
cpu-avg This keyword sets Admission Control thresholds on the Cisco CMTS based on a
one-minute average for the CPU. This setting must be combined with the additional
minor, major and critical threshold percentage values.
io-mem This keyword sets Admission Control thresholds for input/output (IO) memory on the
Cisco CMTS route processors and BPE processors.
proc-mem This keyword sets Admission Control thresholds according to CPU processor
memory on the Cisco CMTS.
total-memory This keyword sets Admission Control thresholds on the Cisco CMTS according to
total-memory allocation.
minor num1 Keyword sets the minor threshold level for the CPU or memory resource to be
configured. Num1 expresses a percentage and must be an integer between 1 and 100.
major num2 Keyword sets the major threshold level for the CPU or memory resource to be
configured. Num2 expresses a percentage and must be an integer between 1 and 100.
critical num3 Keyword sets the critical threshold level for the CPU or memory resource to be
configured. Num3 expresses a percentage and must be an integer between 1 and 100.
Command Default By default, admission control is disabled with no CPU or memory resource threshold settings on the
Cisco CMTS router.
Command Modes Global configuration mode
Command History Release Modification
12.3(13a)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)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-47
Cable Commands: cable a through cable c
cable admission-control
Usage Guidelines The threshold counters are set to zero when the resource is reconfigured.
An important concept for system resources that are set with this command (CPU and memory) is the
concept of dampening. Without dampening, and when admission control is configured for the first time,
the system resource check is unsuccessful if the current value exceeds the critical threshold. When this
happens, the system resource check subsequently succeeds only if the current value drops below the
major threshold.
Note When the minor threshold value set with Num1 or a major threshold value set with Num2 is crossed, the
Cisco CMTS router sends an alarm (SNMP trap, when supported). When the critical threshold value set
with Num3 is crossed, the Cisco CMTS router drops the call request.
This dampening approach helps prevent significant fluctuations in the outcome of resource checks. For
example, if the critical threshold were 80 percent and the current values fluctuated between 79 and 81
percent, this scenario would lead to an alternate success then failure event without dampening. The first
check would succeed, the second check would fail, and so forth.
For additional Admission Control feature information, refer to the Admission Control for the Cisco
Cable Modem Termination System document on Cisco.com.
Examples The following example configures the Cisco CMTS router with a Quality of Service (QoS) policy that
includes admission control dampening. This example illustrates the following conditions:
• When the cpu-avg exceeds 60%, a minor alarm (SNMP trap, when supported) is sent.
• When the cpu-avg exceeds 70%, a major alarm (SNMP trap, when supported) is sent.
• When the cpu-avg exceeds 80%, the incoming call request is rejected, and additional calls are not
accepted until after the cpu-avg returns to below 60% (the minor alarm level).
Router(config)# cable admission-control cpu-avg minor 60 major 70 critical 80
Related Commands Command Description
cable admission-control event Configures and enables admission control event types on the
Cisco CMTS router.
cable admission-control ds-bandwidth Configures admission control downstream bandwidth
thresholds on the Cisco CMTS router.
cable admission-control us-bandwidth Configures admission control upstream bandwidth
thresholds on the Cisco CMTS router.
clear cable admission control counters Clears all admission control resource counters on the Cisco
CMTS router.
debug cable admission-control Enables automatic admission control troubleshooting
processes on the Cisco CMTS router.
show cable admission-control Displays the current admission control configuration and
status on the Cisco CMTS router, or on a specified interface.
Cisco IOS CMTS Cable Command Reference
CBL-48 OL-15510-15
Cable Commands: cable a through cable c
cable admission-control ds-bandwidth
cable admission-control ds-bandwidth
To set the minor, major, and exclusive thresholds for downstream voice or data bandwidth for all
interfaces on a Cisco CMTS router, use the cable admission-control ds-bandwidth command in global
configuration mode or interface configuration mode. To remove this setting from a Cisco CMTS router
or from a specified interface, use the no form of this command.
cable admission-control ds-bandwidth traffic-type minor minor-threshold major
major-threshold exclusive exclusive-percentage non-exclusive non-exclusive-percentage
no cable admission-control ds-bandwidth traffic-type minor minor-threshold major
major-threshold exclusive exclusive-percentage non-exclusive non-exclusive-percentage
Syntax Description ds-bandwidth Sets downstream throughput thresholds.
traffic-type Either of the following keywords sets the traffic type for
which Admission Control applies. Both settings can be
applied to the Cisco CMTS.
• voice—Applies thresholds to downstream voice
traffic.
• data—Applies thresholds to downstream data
traffic.
minor minor-threshold Sets the minor alarm threshold. The minor-threshold
value is a percentage value from 1 to 100.
major major-threshold Sets the major alarm threshold. The major-threshold
value is a percentage value from 1 to 100.
exclusive exclusive-percentage Specifies the percentage of throughput reserved
exclusively for this class (voice or data). The
exclusive-percentage value is an integer between 1 and
100. No other class can use this throughput.
non-exclusive non-exclusive-percentage Specifies the percentage of throughput, over and above
the exclusive share, that can be used by this class. The
non-exclusive-percentage value is an integer between 1
and 100. Because this throughput is non-exclusive, it can
be used by other classes as specified.
Command Default Admission control is disabled by default on the Cisco CMTS router.
Command Modes Global configuration (config)
Interface configuration (config-if)
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-49
Cable Commands: cable a through cable c
cable admission-control ds-bandwidth
Command History Release Modification
12.3(13a)BC This command was introduced on the Cisco uBR10012 and the Cisco uBR7246VXR
router.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
12.2(33)SCC This command was modified to run on modular cable and integrated cable
interfaces.
Usage Guidelines Downstream bandwidth settings support all interfaces on the Cisco CMTS router through global
configuration.
Downstream bandwidth settings can be further refined per-interface or per-upstream, the latter of which
provides optimal downstream Admission Control granularity on the Cisco CMTS router.
When interface-level downstream configuration is used in combination with global configuration, then
the interface configuration supersedes global configuration.
Note The critical keyword is not present for the upstream throughput resource management with the Cisco
Service Flow Admission Control feature.
Note The minor threshold level cannot be greater than the major threshold level.
Examples The following example configures downstream bandwidth in the global configuration mode, with 30%
of downstream bandwidth reserved exclusively for voice traffic. Minor and major alarms for voice
traffic are also set to be generated at 15% and 25% respectively.
Router(config)# cable admission-control ds-bandwidth voice minor 15 major 25 exclusive 30
Related Commands Command Description
cable admission-control Configures the CPU and memory thresholds for the Cisco
CMTS router and supporting broadband processing engines
(BPEs).
cable admission-control event Configures and enables admission control event types on
the Cisco CMTS router.
cable admission-control Defines the maximum reserved bandwidth per bonding
max-reserved-bandwidth group for all service flows that are allowed by the Cisco
CMTS.
cable admission-control Configures admission control upstream bandwidth
us-bandwidth thresholds on the Cisco CMTS router.
clear cable admission control Clears all admission control resource counters on the Cisco
counters CMTS router.
Cisco IOS CMTS Cable Command Reference
CBL-50 OL-15510-15
Cable Commands: cable a through cable c
cable admission-control ds-bandwidth
Command Description
debug cable admission-control Enables automatic admission control troubleshooting
processes on the Cisco CMTS router.
show cable admission-control Displays the current admission control configuration and
status on the Cisco CMTS router or on a specified interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-51
Cable Commands: cable a through cable c
cable admission-control event
cable admission-control event
To configure admission control event types on a Cisco CMTS router, and to enable admission control
for all previously configured resources on a Cisco CMTS router, use the cable admission-control event
command in global configuration mode. To disable admission control event types on a Cisco CMTS
router, use the no form of this command.
cable admission-control event {cm-registration | dynamic-service}
no cable admission-control event event_type
Syntax Description cm-registration Performs admission control checks when a cable modem registers with the Cisco
CMTS router headend. This setting can be combined with the dynamic-service
setting, in which cable modems are allowed to register but remain subject to a
Quality of Service (QoS) policy on the Cisco CMTS.
dynamic-service Performs admission control checks each time a voice call is made, and rejects
voice calls if they would impede QoS policies on the Cisco CMTS router. This
setting can be combined with the cm-registration setting.
Command Default Admission control event types are not defined on the Cisco CMTS router.
Command Modes Global configuration
Command History Release Modification
12.3(13a)BC This command was introduced for the Cisco uBR10012 router and the
Cisco uBR7246VXR router.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines At least one event type must be configured in order to enable admission control on the Cisco CMTS
router.
For additional Admission Control feature information, refer to the Admission Control for the Cisco
Cable Modem Termination System document on Cisco.com.
Examples The following example configures each available option for the cable admission-control event
command on the Cisco CMTS router.
Router(config)# cable admission-control event cm-registration
Router(config)# cable admission-control dynamic-service
Cisco IOS CMTS Cable Command Reference
CBL-52 OL-15510-15
Cable Commands: cable a through cable c
cable admission-control event
Related Commands Command Description
cable admission-control Configures the CPU and memory thresholds for a Cisco
CMTS router and supporting broadband processing
engines (BPEs).
cable admission-control ds-bandwidth Configures admission control downstream bandwidth
thresholds on a Cisco CMTS router.
cable admission-control us-bandwidth Configures admission control upstream bandwidth
thresholds on a Cisco CMTS router.
clear cable admission control counters Clears all admission control resource counters on a Cisco
CMTS router.
debug cable admission-control Enables automatic admission control troubleshooting
processes on a Cisco CMTS router.
show cable admission-control Displays the current admission control configuration and
status on a Cisco CMTS router, or on a specified interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-53
Cable Commands: cable a through cable c
cable admission-control max-reserved-bandwidth
cable admission-control max-reserved-bandwidth
To define the maximum reserved bandwidth per bonding group for all service flows that are allowed by
the Cisco CMTS, use the cable admission-control max-reserved-bandwidth command in the interface
configuration mode. To reset or disable the maximum reserved bandwidth value, use the no form of this
command.
cable admission-control max-reserved-bandwidth bw-in-kbps
no cable admission-control max-reserved-bandwidth
Syntax Description bw-in-kbps Maximum admission control reserved bandwidth. The value is in kbps and
is based on the RF bandwidth percent defined for the bonding group. Valid
range is from 0 to 14762.
Command Default The max-reserved-bandwidth value is 80 percent of the aggregate bandwidth of the RF channels
configured in the US or DS bonding group.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines This command allows the user to define the maximum reserved bandwidth per bonding group. The
default maximum reserved bandwidth value is 80 percent. However the user can choose to configure a
higher (up to 96 percent) or lower reserved bandwidth so that there is bandwidth allocated for zero
committed information rate (CIR) best effort traffic.
Examples The following example shows a sample definition of the maximum reserved bandwidth value.
Router> enable
Router# configure terminal
Router(config)# interface c5/0/1
Router(config-if)# cable admission-control max-reserved-bandwidth 6344
Related Commands Command Description
cable admission-control Configures the CPU and memory thresholds for the Cisco CMTS router
and supporting broadband processing engines (BPEs).
cable admission-control Configures and enables admission control event types on the Cisco CMTS
event router.
Cisco IOS CMTS Cable Command Reference
CBL-54 OL-15510-15
Cable Commands: cable a through cable c
cable admission-control max-reserved-bandwidth
Command Description
cable admission-control Configures admission control downstream bandwidth thresholds on the
ds-bandwidth Cisco CMTS router.
cable admission-control Configures admission control upstream bandwidth thresholds on the Cisco
us-bandwidth CMTS router.
debug cable Enables automatic admission control troubleshooting processes on the
admission-control Cisco CMTS router.
show cable Displays the current admission control configuration and status on the
admission-control Cisco CMTS router or on a specified interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-55
Cable Commands: cable a through cable c
cable admission-control preempt priority-voice
cable admission-control preempt priority-voice
To change the default PacketCable emergency 911 call preemption functions on a Cisco CMTS router
to support throughput and bandwidth requirements for emergency 911 calls above all other buckets on
the Cisco CMTS router, use the cable admission-control preempt priority-voice command in global
configuration mode. To disable preemption and return the bucket that supports PacketCable emergency
911 calls to its default configuration, use the no form of this command.
cable admission-control preempt priority-voice
no cable admission-control preempt priority-voice
Defaults Emergency 911 call preemption and service flow admission control is enabled on the Cisco CMTS
router.
Command Modes Global configuration
Command History Release Modification
12.3(21)BC This command was introduced for the Cisco uBR10012 router and the
Cisco uBR7246VXR router.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines By default, PacketCable Emergency 911 calls are given priority on the Cisco CMTS. This priority may
be preempted or removed from the Cisco CMTS router with non-standard configuration of the Service
Flow Admission Control feature.
For additional information for Service Flow Admission Control beginning in Cisco IOS Release
12.3(21)BC, refer to the Service Flow Admission Control for the Cisco Cable Modem Termination
System document on Cisco.com.
Examples The following example disables and then restores emergency 911 call preemption on the Cisco CMTS
router.
Router(config)# no cable admission-control preempt priority-voice
Router(config)# cable admission-control preempt priority-voice
Cisco IOS CMTS Cable Command Reference
CBL-56 OL-15510-15
Cable Commands: cable a through cable c
cable admission-control us-bandwidth
cable admission-control us-bandwidth
To configure upstream bandwidth thresholds for admission control on a Cisco CMTS router, use the
cable upstream admission-control us-bandwidth command in global configuration or interface
configuration mode. To disable or to remove this configuration from a Cisco CMTS router or the
specified port, use the no form of this command.
cable admission-control us-bandwidth [sched scheduling-type | service service-class-name]
minor minor-threshold major major-threshold exclusive exclusive-percentage non-exclusive
non-exclusive-percentage
no cable admission-control us bandwidth [sched scheduling-type | service service-class-name]
minor minor-threshold major major-threshold exclusive exclusive-percentage non-exclusive
non-exclusive-percentage
Syntax Description n Upstream on the router interface.
us-bandwidth Configures the upstream throughput thresholds.
sched scheduling-type (Optional) Specifies the scheduling type for a traffic
class, where sched-type is one of the following values:
– BE—Selects best effort traffic.
– NRTPS—Selects non-real-time polling service.
– RTPS—Selects real time polling service.
– UGS-AD—Selects UGS-AD service.
– UGS—Selects UGS service.
service service-class-name (Optional) Displays a string representing a previously
defined service class. Instead of specifying a class by a
scheduling type, this keyword can be used to specify a
class using the service-class-name.
minor minor-threshold Sets the minor alarm threshold in a percentage value
between 1 and 100.
major major-threshold Sets the major alarm threshold in a percentage value
between 1 and 100.
exclusive exclusive-percentage Represents the critical threshold for the upstream
throughput resource in a percentage value between 1 and
100. Specifies the percentage of throughput reserved
exclusively for this class.
non-exclusive non-exclusive-percentage Specifies the percentage of throughput, over and above
the exclusive share, that can be used by this class. The
non-exclusive-percentage value is an integer between 1
and 100. Because this throughput is non-exclusive, it can
be used by other classes as specified.
Command Default Admission control is disabled by default on a Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-57
Cable Commands: cable a through cable c
cable admission-control us-bandwidth
Command Modes Global configuration (config)
Interface configuration (config-if)
Command History Release Modification
12.3(13a)BC This command was introduced on the Cisco uBR10012 and the Cisco uBR7246VXR
routers.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
12.2(33)SCC This command was modified to run on modular cable and integrated cable
interfaces.
Usage Guidelines Upstream bandwidth settings support all interfaces on a Cisco CMTS router through global
configuration.
Upstream bandwidth settings can be further refined on a per-interface or per-upstream basis using
interface configuration mode. Per-upstream settings provide the optimal upstream admission control
granularity on the Cisco CMTS router.
When interface or per-upstream configuration is used in combination with global configuration, then
interface or per-upstream configuration supersedes global configuration. Per-upstream configuration
also supersedes per-interface configuration.
Note The critical keyword is not present for the upstream throughput resource management with Cisco
Admission Control.
Note The minor threshold level cannot be greater than the major threshold level.
Examples For additional Admission Control feature information and examples, refer to the Admission Control for
the Cisco Cable Modem Termination System document on Cisco.com.
Related Commands Command Description
cable admission-control Configures the CPU and memory thresholds for the Cisco
CMTS router and supporting broadband processing
engines (BPEs).
cable admission-control event Configures and enables admission control event types on
the Cisco CMTS router.
cable admission-control ds-bandwidth Configures admission control downstream bandwidth
thresholds on the Cisco CMTS router.
cable admission-control Defines the maximum reserved bandwidth per bonding
max-reserved-bandwidth group for all service flows that are allowed by the Cisco
CMTS.
Cisco IOS CMTS Cable Command Reference
CBL-58 OL-15510-15
Cable Commands: cable a through cable c
cable admission-control us-bandwidth
Command Description
clear cable admission control counters Clears all admission control resource counters on the Cisco
CMTS router.
debug cable admission-control Enables automatic admission control troubleshooting
processes on the Cisco CMTS router.
show cable admission-control Displays the current admission control configuration and
status on the Cisco CMTS router or on a specified
interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-59
Cable Commands: cable a through cable c
cable application-type include
cable application-type include
To associate an application type with a specific and prioritized bucket on a Cisco CMTS router, use the
cable application-type include command in global configuration mode. To remove the application type
settings, use the no form of this command.
cable application-type bucket-number include {Best-effort | multicast application-id |
packetcable {normal | priority} | pcmm {app-id gate-app-id | priority gate-priority} |
sched-type type | service-class service-class-name}
no cable application-type bucket-number include {Best-effort | multicast application-id |
packetcable {normal | priority} | pcmm {app-id gate-app-id | priority gate-priority} |
sched-type type | service-class service-class-name}
Syntax Description bucket-number Bucket number to which an application type is associated. Range is from
1 to 8, with 1 as the first in the sequence.
Best-effort Applies best effort committed information rate (CIR) to the specified
bucket.
multicast application-id Specifies the application identification for the multicast service flow.
The valid range is 1 to 65535.
packetcable {normal | Specifies PacketCable service flows for the designated bucket, with the
priority} following priorities:
• normal—Selects PacketCable calls with normal priority.
• priority—Selects PacketCable calls with high priority.
pcmm {app-id gate-app-id Specifies PacketCable Multimedia (PCMM) service flows for the
| priority gate-priority} designated bucket, with the following options:
• app-id gate-app-id—Selects the gate application identifier from 0 to
65535. For each bucket, up to ten application type rules may be
defined.
• priority gate-priority—Selects the priority level from 0 to 7.
sched-type type Specifies upstream scheduling types, with one of the following
additional keywords used for the DOCSIS scheduling type:
• be—Best effort.
• nrtps—Non-real-time polling service.
• rtps—Real-time polling service.
• ugs—Unsolicited Grant Service.
• ugs-ad—UGS-AD (unsolicited grant service-activity detection)
service.
service-class Specifies the name of the service class being assigned to the designated
service-class-name bucket, where service-class-name is an alphanumeric string.
Command Default Service flow admission control is enabled without the application types.
Cisco IOS CMTS Cable Command Reference
CBL-60 OL-15510-15
Cable Commands: cable a through cable c
cable application-type include
Command Modes Global configuration (config)
Command History Release Modification
12.3(21)BC This command was introduced for the Cisco uBR10012 router and the
Cisco uBR7246VXR router.
12.2(33)SCA This command was introduced in Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added. The multicast keyword was
added to this command.
Usage Guidelines The details of this command vary according to the bucket number and application type being mapped to
a service flow on the Cisco CMTS router. This command overrides default service flow admission
control settings on the Cisco CMTS.
Best Effort
The best effort CIR service flow rule may be applicable to both upstream and downstream. However, in
the case of upstream service flows, in most cases, the same service flow may map both the rules.
For best effort, there is also the sched-type keyword option that applies to upstream service flows. This
best effort scheduling type rule is applicable only for upstream service flows.
Service Classes
DOCSIS 1.1 introduced the concept of service classes. A service class is identified by a service class
name. A service class name is a string the CMTS router associates with a QoS parameter set. One of the
objectives of using a service class is to allow the high-level protocols to create the service flows with
the desired QoS parameter set. Using a service class is a convenient way to bind the application with the
service flows. The rules provide a mechanism to implement such binding.
Note the following factors when using the service-class keyword:
• Service classes are separately configured using the cable match command to provide the QoS for
multicast traffic. This step maps a bucket using a rule to allocate bandwidth for multicast traffic.
• A named service class may be classified into any application type.
• Up to ten service class names may be configured per application type. Attempting to configure more
than ten service classes results in an error message.
For additional information, refer to the Service Flow Admission Control feature documentation on
Cisco.com.
Examples The following example maps high-priority PacketCable service flows into application bucket 5:
Router(config)# cable application-type 5 include packetcable priority
The following example maps normal PacketCable service flows into application bucket 1:
Router(config)# cable application-type 1 include packetcable normal
The following example maps the specified bucket number with PCMM service flow with a priority of 7,
then maps an application identifier of 152 for the same bucket number:
Router(config)# cable application-type 2 include pcmm priority 7
Router(config)# cable application-type 2 include pcmm app-id 152
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-61
Cable Commands: cable a through cable c
cable application-type include
The following example maps both UGS and UGS-AD into bucket number 1:
Router(config)# cable application-type 1 include sched-type ugs
Router(config)# cable application-type 1 include sched-type ugs-ad
The following example maps the best effort CIR flows to bucket 3:
Router(config)# cable application-type 3 include Best-effort
The following example maps the service class name with a value of service-name1 into application
bucket 3:
Router(config)# cable application-type 3 include service-class service-name1
The following example maps the multicast application type with a value of 18 into application bucket 3:
Router(config)# cable application-type 3 include multicast 18
Related Commands Command Description
cable admission-control Sets the minor, major, and exclusive thresholds for
ds-bandwidth downstream voice or data bandwidth for all interfaces on the
Cisco CMTS router.
cable admission-control preempt Changes the default PacketCable emergency 911 call
priority-voice preemption functions on the Cisco CMTS router to support
throughput and bandwidth requirements for emergency 911
calls above all other buckets on the Cisco CMTS router.
cable admission-control Configures upstream bandwidth thresholds for admission
us-bandwidth control on the Cisco CMTS router.
cable application-type name Assigns an alphanumeric name for the specified bucket.
cable upstream admission-control Configures per-upstream bandwidth thresholds and exclusive
or non-exclusive resources on the Cisco CMTS router.
debug cable admission-control Displays service flow categorization results, enabled when a
flow-categorization service flow is classified.
show application-buckets Displays rules for any or all buckets supporting service flow
admission control on the Cisco CMTS router.
show interface cable Displays service flows, categorizations, and bandwidth
admission-control reservation consumption on the Cisco CMTS router, for the specified
interface, and the specified service flow direction.
Cisco IOS CMTS Cable Command Reference
CBL-62 OL-15510-15
Cable Commands: cable a through cable c
cable application-type name
cable application-type name
To assign an alphanumeric name for the specified bucket, use the cable application-type name
command in global configuration mode. To remove this configuration, use the no form of this command.
cable application-type bucket-number name bucket-name
no cable application-type bucket-number name bucket-name
Syntax Description bucket-number Bucket number to which the name is applied. The priority sequence of the
buckets, according to their original numeration of 1 to 8, still applies, whether
the default bucket numbers or customized alphanumeric names are used.
bucket-name Alphanumeric bucket name.
Command Default Service flow admission control and the default configuration of this command is enabled.
Command Modes Global configuration
Command History Release Modification
12.3(21)BC This command was introduced for the Cisco uBR10012 router and the
Cisco uBR7246VXR router.
12.2(33)SCA This command was introduced in Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines This bucket name appears in supporting show and debug commands along with the default bucket
number.
For additional information, refer to the Service Flow Admission Control feature documentation on
Cisco.com.
Examples The following example illustrates the use of descriptive names for the associated buckets:
Router(config)# cable application-type 2 name video
Router(config)# cable application-type 3 name gaming
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-63
Cable Commands: cable a through cable c
cable application-type name
Related Commands Command Description
cable admission-control Sets minor, major and exclusive thresholds for downstream
ds-bandwidth voice or data bandwidth for each or all interfaces on the Cisco
CMTS
cable admission-control preempt Changes the default PacketCable Emergency 911 call
priority-voice preemption functions on the Cisco CMTS, supporting
throughput and bandwidth requirements for Emergency 911
calls above all other buckets on the Cisco CMTS.
cable admission-control Configures global or interface-level upstream bandwidth
us-bandwidth thresholds and exclusive or non-exclusive resources on the
Cisco CMTS.
cable application-type include Associates an application type with a specific and prioritized
bucket on the Cisco CMTS.
cable upstream admission-control Configures per-upstream bandwidth thresholds and exclusive
or non-exclusive resources on the Cisco CMTS.
debug cable admission-control Displays service flow categorization results, enabled when a
flow-categorization service flow is classified.
show application-buckets Displays rules for any or all buckets supporting Service Flow
Admission Control on the Cisco CMTS.
show interface cable Displays service flows, categorizations, and bandwidth
admission-control reservation consumption on the Cisco CMTS, for the specified interface,
and the specified service flow direction.
Cisco IOS CMTS Cable Command Reference
CBL-64 OL-15510-15
Cable Commands: cable a through cable c
cable arp
cable arp
To activate cable Address Resolution Protocol (ARP), use the cable arp command in cable interface or
subinterface configuration mode. To block ARP requests for cable modems (CMs), use the no form of
this command.
cable arp
no cable arp
Syntax Description This command has no arguments or keywords.
Command Default ARP is enabled.
Command Modes Cable interface and subinterface configuration
Command History Release Modification
12.1T This command was introduced.
12.0(6)SC This command was supported.
12.1(2) EC1 This command was supported.
12.1(3a)EC Subinterface support was added.
12.2(8)BC1 Interaction with the clear arp-cache command was changed. Previously,
the clear arp-cache command sent an ARP request to a CM before clearing
its ARP entry. Now, the clear arp-cache command clears the ARP entry
without communicating with the CM. The CM (or its CPE devices) must
send one or more IP packets to the CMTS before IP communications can be
restored (assuming the CM or CPE devices are authorized to connect to the
network).
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
Support for the Cisco uBR7225VXR router was added.
Usage Guidelines ARP is an Internet protocol used to map IP addresses to MAC addresses on computers and other
equipment installed in a network. You must activate ARP requests so that the Cisco CMTS router can
perform IP address resolution on the downstream path.
Occasionally, you might want to use the no cable arp and clear arp-cache commands to block out new
ARP requests and clear the existing ARP table. In this situation, the Cisco CMTS router will retain the
ARP addresses of currently online CMs (CMs with a known IP address) and will continue to send ARP
requests for those CMs when those ARP entries time out or are cleared, so that those CMs can continue
to remain online. ARP requests for CMs that are currently offline and for any other unknown IP
addresses, however, will remain blocked until ARP requests are reenabled on the downstream using the
cable arp command.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-65
Cable Commands: cable a through cable c
cable arp
Note Using the no cable arp and no cable proxy-arp commands shifts all responsibility for the management
of the IP addresses used by CMs and CPE devices to the DHCP server and provisioning system.
Tip You can expect to see a temporary spike in CPU usage after initially giving the no cable arp command,
because of the need to verify CPE IP addresses. CPU usage drops after the router has verified and learned
all of the CPE IP addresses that are currently online. (This same situation occurs after initially enabling
the cable source-verify dhcp command, because the router must send a DHCP LEASEQUERY request
for every unknown CPE IP address.)
Examples The following example shows how to activate cable ARP requests for port 0 on the cable interface line
card installed in slot 6 of a Cisco CMTS router:
router(config)# interface cable 6/0
router(config-if)# cable arp
The following example shows how to activate cable ARP requests for port 0 on the cable interface line
card installed in slot 6, subinterface 1, of a Cisco CMTS router:
router(config)# interface cable 6/0.1
router(config-subif)# cable arp
Related Commands Command Description
clear arp-cache Clears the ARP table on the router.
cable proxy-arp Activates cable proxy ARP on the cable interface.
Cisco IOS CMTS Cable Command Reference
CBL-66 OL-15510-15
Cable Commands: cable a through cable c
cable arp filter
cable arp filter
To control the number of Address Resolution Protocol (ARP) packets that are allowable for each Service
ID (SID) on a cable interface, use the cable arp filter command in cable interface configuration mode.
To stop the filtering of ARP broadcasts for CMs, use the no form of this command.
cable arp filter {reply-accept | request-send} number window-size
no cable arp filter {reply-accept | request-send}
default cable arp filter {reply-accept | request-send}
Syntax Description reply-accept Configures the cable interface to accept only the specified
number of ARP reply packets every window-size seconds for
each active Service ID (SID) on that interface. The cable
interface drops ARP reply packets for a SID that would exceed
this number.
request-send Configures the cable interface to send only the specified number
of ARP request packets every window-size seconds for each
active SID on that interface. The cable interface drops ARP
requests for a SID that would exceed this number.
number Number of ARP reply packets that is allowed for each SID within
the window time period. The allowable range is 0 to 20 packets,
with a default of 4 packets. If number is 0, the cable interface
drops all ARP reply packets.
window-size Size of the window time period, in seconds, in which to monitor
ARP requests. The valid range is 1 to 5 seconds, with a default of
2 seconds.
Command Default ARP packets are not filtered, which means the Cisco CMTS router accepts all ARP reply packets and
sends all ARP request packets.
Command Modes Cable interface configuration (config-if)
Command History Release Modification
12.2(15)BC2 This command was introduced for the Cisco uBR7246VXR and Cisco uBR10012
universal broadband routers.
12.3(9a)BC The values of number and window-size are optional for the the respective reply-accept
and request-send settings.
In this release and for earlier supporting releases, when ARP filtering is enabled, the
default values for number and window-size are 4 and 2 respectively.
12.3(17a)BC In this release and for later releases, when ARP filtering is enabled, the default values
for number and window-size are 3 and 2 respectively.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-67
Cable Commands: cable a through cable c
cable arp filter
Usage Guidelines Viruses, worms, and theft-of-service attacks can generate a large volume of ARP requests on a cable
interface. In some situations, the volume of ARP traffic can become so large that it throttles all other
traffic.
To control the number of ARP replies and ARP requests that are allowed for each SID on a cable
interface, use the cable arp filter command. This command configures the interface so that it accepts
only a certain number of ARP reply or request packets per a specified time period. If a SID generates
more ARP packets than what is allowed, the cable interface drops the excessive traffic.
By default, no ARP filtering is done. ARP filtering is enabled on individual cable interfaces, and you
can choose to filter ARP packets only on the specific cable interfaces that require it. You can further
choose to filter only ARP request packets, only ARP reply packets, or both. You can configure different
threshold values on each interface, allowing you to customize the feature for each interface’s traffic
patterns.
If using bundled cable interfaces, the Cable ARP Filtering feature is configured separately on the master
and slave interfaces. This allows you to configure the feature only on the particular interfaces that
require it.
Note Cisco IOS Release 12.3(9a)BC introduces enhanced command option syntax for the cable arp filter
command, where number and window-size values are optional for reply-accept and request-send
settings.
Note Disabling the cable ARP filtering feature, using the no cable arp filter command, does not reset the
ARP packet counters. The ARP packet counters do not increment when cable ARP filtering is disabled,
but the counters retain their current values until the interface counters are specifically cleared, using the
clear counters command.
Linksys Wireless-B BEFW11S4 Router
The Linksys Wireless-B Broadband Router BEFW11S4 version 4 with 1.44.2 firmware incorrectly
sends its own ARP reply packet for every ARP request packet it receives, instead of replying only to the
ARP requests that are specifically for itself. Customers with these routers should upgrade the firmware
to the latest revision to fix this bug. To upgrade the firmware, go to the download section on the Linksys
web site.
The following example shows how to filter cable ARP reply packets, so that the cable interface accepts
a maximum of 15 ARP replies every three seconds per SID:
Router(config)# interface cable 5/1/0
Router(config-if)# cable arp filter reply-accept 15 3
The following example shows how to filter cable ARP request packets, so that the cable interface sends
a maximum of 10 requests per second per SID:
Router(config)# interface cable 6/0
Router(config-if)# cable arp filter request-send 10 1
The following example shows how to enable the filtering of cable ARP request and reply packets on a
cable interface, using the default values of 4 packets per CPE per every 2 seconds:
Router(config)# interface cable 3/0
Router(config-if)# default cable arp filter reply-accept
Router(config-if)# default cable arp filter request-send
Router(config-if)# end
Router# show running-config | include filter
Cisco IOS CMTS Cable Command Reference
CBL-68 OL-15510-15
Cable Commands: cable a through cable c
cable arp filter
cable arp filter reply-accept 4 2
cable arp filter request-send 4 2
The following example shows how to disable the filtering of cable ARP request and reply packets on a
cable interface:
Router(config)# interface cable 1/0
Router(config-if)# no cable arp filter reply-accept
Router(config-if)# no cable arp filter request-send
Related Commands Command Description
cable arp Activates cable ARP.
cable proxy-arp Activates cable proxy ARP on the cable interface.
clear arp-cache Refreshes dynamically created entries from the ARP cache.
clear counters Clears the packet counters on all interfaces or on a specific interface.
debug cable arp filter Displays debugging messages about the filtering of ARP broadcasts.
show cable arp-filter Displays the total number of ARP replies and requests that have been sent and
received, including the number of requests that have been filtered.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-69
Cable Commands: cable a through cable c
cable attribute-mask
cable attribute-mask
To configure an attribute for a modular cable interface, use the cable attribute-mask command in
interface configuration mode. To disable this configuration, use the no form of this command.
cable attribute-mask mask
no cable attribute-mask mask
Syntax Description mask Specifies the mask value for the interface.
Command Default If this command is not used, the default attribute will be used for the modular cable interface. The default
attribute for a modular cable interface is zero.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines The attribute mask comprises 32 attributes and each attribute represents a single bit in the mask. You
can configure a provisioned attribute mask for each channel and provisioned bonding group to assign
values to the operator-defined binary attributes, or to override the default values of the
specification-defined attributes. The operator may configure, in the CM configuration file, a required
attribute mask and a forbidden attribute mask for a service flow. Additionally, in a CM-initiated dynamic
service request, the CM can include a required attribute mask and a forbidden attribute mask for a service
flow.
Examples The following example shows how to configure an attribute for a modular cable interface:
Router# configure terminal
Router(config)# interface modular-cable 1/0/0:0
Router(config-if)# cable attribute-mask 2000ff00
Related Commands Command Description
interface Specifies a modular cable interface.
modular-cable
cable downstream Specifies an attribute mask value for a wideband cable interface.
attribute-mask
interface Specifies a wideband cable interface.
wideband-cable
interface cable Specifies a cable interface.
Cisco IOS CMTS Cable Command Reference
CBL-70 OL-15510-15
Cable Commands: cable a through cable c
cable bgsync
cable bgsync
To set the data intervals for the background synchronization of SNMP MIB data on the Cisco CMTS,
use the cable bgsync command in global configuration mode. To disable background synchronization,
use the no form of this command.
cable bgsync {itime i-interval | ptime p-interval}
no cable bgsync
Syntax Description itime Indicates the data interval time between two interval synchronizations.
ptime Indicates the incremental data interval time between two synchronizations.
i-interval Length of the data interval in seconds. The valid range is from 5 to
31536000. The default value is 86400.
p-interval Length of the incremental data interval in seconds. The valid range is from
5 to 86400. The default value is 5.
Command Default This command is enabled by default.
Command Modes Global configuration mode (config)
Command History Release Modification
12.2(33)SCG This command was introduced.
Usage Guidelines Use the cable bgsyc command to set the data intervals for background synchronization.
For more information about MIB objects that are synchronized during background synchronization, see
the Cisco CMTS Universal Broadband Router Series MIB Specifications Guide 12.2SC.
Examples The following example shows how to set the data intervals for background synchronization on the
Cisco uBR10012 router:
Router# configure terminal
Router(config)# cable bgsync itime 3600
Router(config)# cable bgsync ptime 6
Router(config)#
Related Commands Command Description
cable bgsync active Activates background synchronization process on the Cisco CMTS.
clear bgsync counters Clears the background synchronization counters on the Cisco CMTS.
show cable bgsync Displays the information on the background synchronization process on the
Cisco CMTS.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-71
Cable Commands: cable a through cable c
cable bgsync active
cable bgsync active
To activate the background synchronization process on the Cisco CMTS, use the cable bgsync active
command in global configuration mode. To deactivate the background synchronization process, use the
no form of this command.
cable bgsync active
no cable bgsync active
Syntax Description This command has no arguments or keywords.
Command Default This command is enabled by default.
Command Modes Global configuration mode (config)
Command History Release Modification
12.2(33)SCG This command was introduced.
Usage Guidelines Use the cable bgsync active command to activate the background synchronization process.
SNMP objects use interprocess communication (IPC) to access data between the line card and the route
processor (RP). When SNMP queries are sent to a Cisco CMTS with large number of modems
configured, IPC takes a long time to retrieve the information from the line card and pass it on to the RP.
This resulted in an increase in the SNMP response time.
The background synchronization process slowly synchronizes the data between the line card and the RP.
Therefore, when SNMP queries are sent to the Cisco CMTS, the Cisco CMTS returns the SNMP data
from the RP. IPC requests are not sent to retrieve the data, thereby improving the SNMP performance.
The background synchronization process is enabled by default on the Cisco uBR10012, and Cisco
7200 Series routers.
For more information about the MIB objects that are synchronized during background synchronization,
see the Cisco CMTS Universal Broadband Router Series MIB Specifications Guide 12.2SC.
Examples The following example shows how to deactivate the background synchronization process on the
Cisco uBR10012 router:
Router# configure terminal
Router(config)# no cable bgsync active
Router(config)#
Related Commands
Cisco IOS CMTS Cable Command Reference
CBL-72 OL-15510-15
Cable Commands: cable a through cable c
cable bgsync active
Command Description
cable bgsync Sets the data intervals for background synchronization on the Cisco CMTS.
show cable bgsync Displays the information on the background synchronization process, on the
Cisco CMTS.
clear bgsync counters Clears the background synchronization counters on the Cisco CMTS.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-73
Cable Commands: cable a through cable c
cable bonding-group-id
cable bonding-group-id
Note Effective with Cisco IOS Release 12.2(33)SCE, the cable bonding-group-id command is replaced by
the cable bonding-group-secondary command. See the cable bonding-group-secondary command
for more information.
To specify a Bonding Group ID and indicate whether the bonding group is a primary or secondary
bonded channel, use the cable bonding-group-id command in wideband-cable interface configuration
mode. To remove a bonding group configuration and revert to the default bonding group (a primary
bonding group), use the no form of this command.
cable bonding-group-id id_num [secondary]
no cable bonding-group-id id_num [secondary]
Syntax Description id_num A unique Bonding Group ID. Valid values are 1 to 255. The bonding group
ID must be unique for each wideband channel on the CMTS.
secondary Specifies that the bonding group is a secondary bonding group. If the
secondary keyword is not used, the bonding group is a primary bonding
group.
Command Default If the cable bonding-group-id command is not issued, Cisco IOS software assigns a default ID to the
bonding group and configures the wideband-channel cable interface as a primary bonding group.
Command Modes Interface configuration mode for a wideband-cable interface (config-if)
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. Support
for the Cisco uBR7225VXR router was added.
12.2(33)SCE This command was replaced with the cable bonding-group-secondary
command.
Usage Guidelines The cable bonding-group-id command is not needed for the wideband channels that will be received
by the Scientific Atlanta DPC2505 or EPC2505 wideband cable modems.
The cable bonding-group-id command is used only for wideband channels that will be received by the
Linksys WCM300-NA, WCM300-EURO, or WCM300-JP wideband cable modems.
Cisco IOS CMTS Cable Command Reference
CBL-74 OL-15510-15
Cable Commands: cable a through cable c
cable bonding-group-id
Linksys WCM300 Cable Modem
For wideband channels that will be received by the Linksys WCM300-NA, WCM300-EURO, and
WCM300-JP cable modems, the cable bonding-group-id command assigns a Bonding Group ID to a
wideband-channel cable interface and configures the bonding group as a primary bonding group if the
secondary keyword is not specified, or as a secondary bonding group if the secondary keyword is
specified.
• A primary bonding group is a primary bonded channel.
• A secondary bonding group is a secondary bonded channel.
The primary bonded channel is the wideband channel on which the Linksys WCM300 modem receives
all of its unicast traffic and some of its multicast traffic. The cable modem may identify the primary
bonded channel and any secondary bonded channels to the CMTS at cable modem registration time. The
DOCSIS configuration file may define the primary bonded channel for the CMTS to assign to the cable
modem.
In addition to joining one primary bonded channel, the Linksys WCM300 may join up to two secondary
bonded channels simultaneously in order to receive additional data streams. The DOCSIS configuration
file may define the secondary bonded channels for the modem to pass to the CMTS. Secondary bonded
channels are intended to receive multicast traffic such as broadcast video that is not available on the
primary bonded channel.
For information on the TLV encodings that can be used in the DOCSIS configuration file to identify
primary and secondary bonded channels, see the Cisco Cable Wideband Solution Design and
Implementation Guide, Release 1.0.
Note If a wideband channel is specified as a primary or secondary bonded channel in the DOCSIS
configuration file, it must be identically defined as a primary or secondary bonded channel in the CMTS
active, running configuration file.
• If a wideband channel is configured with the cable bonding-group-id command or by default to be
a primary bonded channel, the Linksys WCM300 modem will not register using it as one of its
secondary bonded channels.
• If a wideband channel is configured with the cable bonding-group-id command to be a secondary
bonded channel, the Linksys WCM300 modem will not register using it as its primary bonded
channel.
Note When a wideband channel is defined on a Wideband SPA, Cisco IOS software configures the wideband
channel as a primary bonding group (primary bonded channel) and assigns a default ID to the bonding
group. If a wideband channel is to be used as a secondary bonded channel, use the cable
bonding-group-id command with the secondary keyword to specify that the channel is a secondary
bonded channel.
If you specify a non-unique Bonding Group ID for the id_num argument, cable bonding-group-id
displays an error message and does not modify the ID.
Scientific Atlanta DPC2505 Cable Modem
The cable bonding-group-id command is not needed for the wideband channels that will be received
by the Scientific Atlanta DPC2505 or EPC2505 cable modems.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-75
Cable Commands: cable a through cable c
cable bonding-group-id
Examples The following examples show how to use the cable bonding-group-id command for a variety of
purposes. The following cable bonding-group-id command specifies that wideband channel 10 on the
Wideband SPA in slot/subslot/bay 1/0/1 will be a secondary bonding group (secondary bonded channel)
having the bonding group ID 20.
Router# configure terminal
Router(config)# interface wideband-cable 1/0/1:10
Router(config-if)# cable bonding-group-id 20 secondary
The following example shows how to change a bonding group with an ID of 20 from a secondary to a
primary bonding group by omitting the secondary keyword:
Router(config-if)# cable bonding-group-id 20
The no form of the cable bonding-group-id removes the configured bonding group and reverts the
configuration to the default bonding group. For a secondary bonding group with the ID of 20, the
following no forms of the command are equivalent:
Router(config-if)# no cable bonding-group-id 20
or
Router(config-if)# no cable bonding-group-id 20 secondary
When either of the preceding commands are issued, the wideband-channel cable interface is
configured to use a default bonding group, which has a default bonding group ID assigned by Cisco
IOS software and is a primary bonding group.
Related Commands Command Description
interface Enters interface configuration mode.
Cisco IOS CMTS Cable Command Reference
CBL-76 OL-15510-15
Cable Commands: cable a through cable c
cable bonding-group-secondary
cable bonding-group-secondary
To specify a bonding group as a secondary bonded channel, use the cable bonding-group-secondary
command in wideband-cable interface configuration mode. To remove the bonding group configuration
and revert to the default bonding group (a primary bonding group), use the no form of this command.
cable bonding-group-secondary
no cable bonding-group-secondary
Command Default If the cable bonding-group-secondary command is not issued, Cisco IOS software configures the
wideband-channel cable interface as the primary bonding group.
Command Modes Interface configuration mode (config-if) for a wideband-cable interface
Command History Release Modification
12.2(33)SCE This command was introduced for the Cisco uBR-MC3GX60V cable
interface line card.
Usage Guidelines Starting with Cisco IOS Release 12.2(33)SCE, the cable bonding-group-secondary command replaces
the cable bonding-group-id command. If you upgrade from an earlier Cisco IOS Release to
Cisco IOS Release 12.2(33)SCE and later, the cable bonding-group-id command will no longer change
the bonding-group ID.
The cable bonding-group-secondary command is used only for wideband channels that are received
by the Linksys WCM300-NA, WCM300-EURO, or WCM300-JP wideband cable modems.
Linksys WCM300 Cable Modem
For wideband channels that are received by the Linksys WCM300-NA, WCM300-EURO, and
WCM300-JP cable modems, the show controllers Modular-Cable slot/subslot/controller wideband
command displays the bonding group ID of a wideband-channel cable interface and the
cable bonding-group-secondary command configures the bonding group as a secondary bonding
group.
The primary bonded channel is the wideband channel on which the Linksys WCM300 modem receives
all of its unicast traffic and some of its multicast traffic. The cable modem identifies the primary bonded
channel and any secondary bonded channels to the CMTS at cable modem registration time. The
DOCSIS configuration file defines the primary bonded channel for the CMTS to assign to the cable
modem.
In addition to joining one primary bonded channel, the Linksys WCM300 joins up to two secondary
bonded channels simultaneously in order to receive additional data streams. The DOCSIS configuration
file defines the secondary bonded channels for the modem to pass to the CMTS. Secondary bonded
channels are intended to receive multicast traffic such as broadcast video that is not available on the
primary bonded channel.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-77
Cable Commands: cable a through cable c
cable bonding-group-secondary
For information on the TLV encodings that can be used in the DOCSIS configuration file to identify
primary and secondary bonded channels, see Cisco Cable Wideband Solution Design and
Implementation Guide, Release 1.0.
Note If a wideband channel is specified as a primary or secondary bonded channel in the DOCSIS
configuration file, it must be identically defined as a primary or secondary bonded channel in the CMTS
active, running configuration file.
The following points list the restrictions for configuring the wideband channel with the
cable bonding-group-secondary command:
• If a wideband channel is not configured with the cable bonding-group-secondary command, the
Linksys WCM300 modem may not use it as a secondary bonding group.
• If a wideband channel is configured with the cable bonding-group-secondary command to be a
secondary bonded channel, the Linksys WCM300 modem may not use it as a primary bonded group.
Note When a wideband channel is defined, the Cisco IOS software configures the wideband channel as a
primary bonding group (primary bonded channel) and assigns a default ID to the bonding group. If a
wideband channel is to be used as a secondary bonded channel, use the
cable bonding-group-secondary command to specify that the channel is a secondary bonded channel.
Examples The following example shows how to use the cable bonding-group-secondary command:
Router# configure terminal
Router(config)# interface wideband-cable 1/0/1:10
Router(config-if)# cable bonding-group-secondary
Related Commands Command Description
interface Enters interface configuration mode.
Cisco IOS CMTS Cable Command Reference
CBL-78 OL-15510-15
Cable Commands: cable a through cable c
cable bundle
cable bundle
To configure a cable interface to belong to an interface bundle, use the cable bundle command in cable
interface configuration mode. To delete a cable interface bundle definition, use the no form of this
command.
cable bundle n [master]
no cable bundle n [master]
Syntax Description n Specifies the bundle identifier. Valid range is from 1 to 255.
master (Optional) Defines the specified interface as the master.
Defaults No default behavior or values
Command Modes Interface configuration—cable interface only (config-if)
Command History Release Modification
12.1(1a)T1 This command was introduced.
12.0(8)SC This command was supported.
12.1(2)EC1 This command was supported.
12.2(15)BC2 This command was enhanced, so that adding an interface as a slave
interface automatically removes the following Layer 3 parameters, if
they are configured on that interface: IP address, IP helper address,
IP access group, PIM configuration, and IP policy-based routing.
Also, creating subinterfaces on slave interfaces has been specifically
prohibited. Previously, subinterfaces could be created on slave
interfaces, although a warning message appeared advising users to
remove the subinterface.
12.3(13)BC The master keyword was removed.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
Support for the Cisco uBR7225VXR router was added.
Usage Guidelines You can configure a maximum of four interface bundles. In each bundle, specify one interface as the
master interface by using the optional master keyword. The cable interface that is designated as master
is configured with Layer 3 configuration such as primary and secondary IP addresses and other Layer 3
specific configuration commands such as the cable arp command.
The following guidelines are required when using bundled cable interfaces:
• Configure an IP address only on the master interface. Any attempt to add an interface to a bundle is
rejected, if an IP address is configured and the interface is not specified as master interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-79
Cable Commands: cable a through cable c
cable bundle
• You must specify all generic IP networking information (IP address, routing protocols, switching
modes, and so on) on the bundle master interface. Do not specify generic IP networking information
on bundle slave interfaces.
• If you attempt to add an interface to a bundle as slave interface and an IP address is assigned to this
interface, the command fails. You must remove the IP address configuration before you can add the
interface to a bundle.
• If you have configured an IP address on a bundled interface and the interface is not the master
interface, a warning message appears.
• Do not create subinterfaces on a slave interface. In Cisco IOS Release 12.2(15)BC2 and later
releases, this is specifically prohibited. In prior releases, a warning message appeared when trying
to create a subinterface on a slave interface, but the subinterface was still created.
Specify generic (that is, not downstream or upstream) cable interface configurations, such as
source-verify or Address Resolution Protocol (ARP) handling, on the master interface. Do not specify
generic configuration on nonmaster interfaces.
If you configure an interface as part of a bundle and it is not the master interface, all generic cable
configuration for this interface is removed. This includes the IP address, access groups, PIM
configuration, and any other IP Layer 3 configurations. The master interface configuration then applies
to all interfaces in the bundle.
Tip We recommend configuring the no ip address command on all slave interfaces. This command is
optional but recommended, because the show ip interface brief command reports an interface as being
not OK if its configuration does not include some form of the ip address command. Specifying no ip
address corrects this.
When creating subinterfaces over the bundle master, the bundle master is not assigned any IP address
and only the subinterfaces are assigned IP addresses, helper addresses, and other Layer 3 configurations.
The reason the bundle master is not assigned an IP address is because CMs are associated with
subinterfaces rather than with a bundle master.
Note Cable interface bundling is applicable only in two-way cable configurations. It is not supported in
telco-return configurations.
If you shut down or remove the master interface in a bundle, no data packets is sent to any of the
interfaces in this bundle. Packets are still physically received from nonmaster interfaces that have not
been shut down, but those packets are discarded. This means that CMs connected to those interfaces are
not disconnected immediately, but CMs coming online are not able to obtain an IP address, download
their configuration file, or renew their IP address assignment if the DHCP lease expires.
If you shut down a slave interface, only this shutdown interface is affected.
Note When using bundled interfaces, the show interface cable command divides the interface counters
between the master and slave interfaces. The output for the master interface shows the upstream packets
per second count, while the output for the slave interfaces shows the downstream packets per second
count.
Cisco IOS CMTS Cable Command Reference
CBL-80 OL-15510-15
Cable Commands: cable a through cable c
cable bundle
Examples See the following example to configure interface 25 to be the master interface:
Router(config)# interface cable 3/0
Router(config-if)# cable bundle 25 master
Router(config-if)#
07:28:17: %UBR7200-5-UPDOWN: Interface Cable3/0 Port U0, changed state to down
07:28:18: %UBR7200-5-UPDOWN: Interface Cable3/0 Port U0, changed state to up
The following example shows the error message you get if you try to configure an interface with an
IP address that is not the master interface:
Router(config)# interface cable 3/0
Router(config-if)# cable bundle 5
Please remove ip address config first then reenter this command
Router(config-if)#
The following example shows how to remove a cable interface from a bundle:
Router(config)# interface cable 5/1/0
Router(config-if)# no cable bundle 5
Router(config-if)#
Note When you remove a slave cable interface from a bundle (using the no cable bundle command), you must
manually reconfigure all of the Layer 3 IP information on the interface, before cable modems can resume
communicating on that interface.
Related Commands Command Description
show cable bundle Displays the forwarding table for the specified interface bundle.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-81
Cable Commands: cable a through cable c
cable clock clear-counters
cable clock clear-counters
To reset the counters that are displayed with the show controllers clock-reference command, use the
cable clock clear-counters command in privileged EXEC mode.
cable clock clear-counters
Syntax Description This command has no keywords or arguments.
Command Default No default behavior or values
Command Modes Privileged EXEC (#)
Command History Release Modification
12.1(1a)T1 This command was introduced.
12.1(2)EC1 This command was supported on the EC train for the Cisco uBR7246VXR
router.
12.2(2)XF This command was supported for the TCC+ card on Cisco uBR10012
routers.
12.2(4)BC1 Support for this command was added to the Release 12.2 BC train for the
Cisco uBR7246VXR and Cisco uBR10012 routers.
12.3(23)BC This command is supported only for standalone (freerun) mode.
Usage Guidelines This command resets any counters that were displayed from the last time the show controllers
clock-reference command was used.
Note This command is not supported on the SC train.
This command supports the Cisco CMTS clock feature set, which provides a synchronized clock for
improved Voice-over-IP (VoIP) operations. The clock feature set requires one of the following
configurations:
• A Cisco uBR10012 router with one or two TCC+ cards that are connected to an external national
clock source.
Note Beginning in Cisco IOS Release 12.3(23)BC, TCC+ is replaced with the DOCSIS Timing
and Control Card (DTCC) and does not require to be connected to an extenal national clock
source.
Cisco IOS CMTS Cable Command Reference
CBL-82 OL-15510-15
Cable Commands: cable a through cable c
cable clock clear-counters
• A Cisco uBR7246 VXR router using a Cisco uBR-MC16S, Cisco uBR-MC16E,
Cisco uBR-MC28C, or Cisco uBR-MC28C-BNC cable interface line card. The router must also be
equipped with a Cisco cable clock card and be running Cisco IOS Release 12.1(1a)T1, Cisco IOS
Release 12.1(2)EC1, or a later release. The Cisco cable clock card should be connected to an
external national clock source.
Only these cable interface cards support the external clock card reference from a clock card to distribute
that signal to CMs or set-top boxes (STBs) attached to the specific network segments. You can use other
cable interface cards, such as the Cisco uBR-MC16C, with the clock card, but these other cable
interfaces will not synchronize their downstream SYNC messages with the external clock source.
Each CM or STB must also support VoIP applications and the clock feature set. For example, the
Cisco uBR924, running Cisco IOS Release 12.0(7)T or later releases, supports the clock card feature
automatically.
Note The show controllers clock-reference command might display compare errors on the Cisco uBR10012
router because there could be a slight delay at system startup before the clock cards synchronize with
each other. These initial compare errors can be ignored and cleared with the cable clock clear-counters
command.
Examples The following example shows how to reset all counters that are displayed for the clock card:
Router# cable clock clear-counters
Related Commands Command Description
show controllers clock-reference Displays the cable clock card’s hardware information.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-83
Cable Commands: cable a through cable c
cable clock dti
cable clock dti
To configure the DOCSIS Timing Interface (DTI) clock reference mode, use the cable clock dti
command in global configuration mode. To terminate the DTI clock referemce mode and restart the
standalone mode, use the no form of the command.
cable clock dti
no cable clock dti
Syntax Description This command has no keywords or arguments.
Command Default Standalone mode
Command Modes Global configuration
Command History Release Modification
12.3(23)BC This command was introduced for the Cisco uBR10012 router.
Usage Guidelines Use this command to configure DTI clocking mode. This command may be stored in NVRAM as part
of the DOCSIS Timing and Control Card (DTCC) configuration.
Examples Router# config terminal
Router(config)# cable clock dti
Related Commands Command Description
show cable clock dti Displays DTI information.
Cisco IOS CMTS Cable Command Reference
CBL-84 OL-15510-15
Cable Commands: cable a through cable c
cable clock dti clear-counters
cable clock dti clear-counters
To reset the counters that are displayed with the show cable clock dti counters command in DOCSIS
Timing Interface (DTI) mode, use the cable clock dti clear-counters command in privileged EXEC
mode.
cable clock dti clear-counters slot/subslot
Syntax Description slot/subslot Specifies the slot and subslot location of the DTCC ports. Valid values are
1/1 or 2/1.
Command Default No default behavior or values
Command Modes Privileged EXEC
Command History Release Modification
12.3(23)BC This command was introduced on the Cisco uBR10012 router .
Usage Guidelines This command resets any counters that were displayed from the last time the show cable clock dti client
command was used in DTI mode.
This command supports the Cisco CMTS clock feature set, which provides a synchronized clock for
improved Voice-over-IP (VoIP) operations.
Examples The following example shows how to reset all counters that are displayed for the clock card:
Router# cable clock dti clear-counters
Related Commands Command Description
show cable clock dti counters Displays the cable clock card’s hardware information.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-85
Cable Commands: cable a through cable c
cable clock force
cable clock force
To select the external timing source when the clock card is in holdover mode, use the cable clock force
command in global configuration mode. To disable the selection and return to the default, use the no
form of this command.
cable clock force {primary | secondary}
no cable clock force
Syntax Description primary Forces the primary source to act as the clock reference.
secondary Forces the secondary source to act as the clock reference.
Command Default The clock card automatically uses the primary external source, if available. If the primary source fails,
the clock card enters holdover mode and, after a few seconds, switches to the secondary external source.
The clock card switches back to the primary source when it becomes available.
Command Modes Global configuration (config)
Command History Release Modification
12.1(1a)T1 This command was introduced.
12.1(2)EC1 This command was integrated into Cisco IOS Release 12.1(2)EC1.
Usage Guidelines This command overrides the default behavior of the clock card when the clock card is in holdover mode.
If the clock card is not in holdover mode, this command is ignored. You cannot force the reference to a
port if the clock card is in free-running mode.
Note This command is not applicable on the SC train.
Note The clock card enters holdover mode if the forced reference is lost, even if the other external reference
is available.
To support the clock feature set in VoIP configurations, a Cisco uBR7246 VXR chassis, equipped with
a clock card; and a Cisco uBR-MC16S, a Cisco uBR-MC16E, or a Cisco uBR-MC28C cable interface
line card must be used running Cisco IOS Release 12.1(1a)T1 or later releases. Only these cable
interface line cards support the external clock card reference from a clock card to distribute that signal
to CMs or set-top boxes (STBs) attached to the specific network segments. You can use other cable
interface cards, such as the Cisco uBR-MC16C, with the clock card, but these other cable interfaces will
not synchronize their downstream SYNC messages with the external clock source.
Cisco IOS CMTS Cable Command Reference
CBL-86 OL-15510-15
Cable Commands: cable a through cable c
cable clock force
Each CM or STB must also support VoIP applications and the clock feature set. For example, the
Cisco uBR924, running Cisco IOS Release 12.0(7)T or later releases, supports the clock card feature
automatically.
Examples The following example shows how to force the timing reference for the cable clock card to come from
the secondary external source, when the clock card is in holdover mode:
Router(config)# cable clock force secondary
Related Commands Command Description
show cable clock Displays status information for the cable clock card.
show controllers clock-reference Displays hardware information, register values, and current
counters for the cable clock card.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-87
Cable Commands: cable a through cable c
cable clock source-midplane
cable clock source-midplane
To make the midplane time-division multiplexing (TDM) clock the primary timing reference for the
clock card, use the cable clock source-midplane command in global configuration mode. To disable the
selection and return to the default, use the no form of this command.
cable clock source-midplane
no cable clock source-midplane
Syntax Description This command has no keywords or arguments.
Command Default The clock card does not get its timing reference from the midplane TDM clock.
Command Modes Global configuration (config)
Command History Release Modification
12.1(1a)T1 This command was introduced.
12.1(2)EC1 This command was integrated into Cisco IOS Release 12.1(2)EC1.
12.3BC This command was integrated into Cisco OS Release 12.3BC.
Usage Guidelines Because the clock card automatically provides the timing reference to the midplane TDM clock, the
midplane cannot in turn act as the reference for the clock card. This means that the cable clock
source-midplane command does not take effect unless a port adapter is configured as the primary clock
reference source for the midplane.
Note This command is not applicable on the SC train.
To support the clock feature set in VoIP configurations, a Cisco uBR7246 VXR chassis, equipped with
a clock card; and a Cisco uBR-MC16S, a Cisco uBR-MC16E, or a Cisco uBR-MC28C cable interface
line card must be used running Cisco IOS Release 12.1(1a)T1 or higher releases. Only these cable
interface line cards support the external clock card reference from a clock card to distribute that signal
to CMs or set-top boxes (STBs) attached to the specific network segments. You can use other cable
interface cards, such as the Cisco uBR-MC16C, with the clock card, but these other cable interfaces will
not synchronize their downstream SYNC messages with the external clock source.
Each CM or STB must also support VoIP applications and the clock feature set. The Cisco uBR924,
running Cisco IOS Release 12.0(7)T or later releases, supports the clock card feature automatically.
Examples The following example shows how to set the primary clock reference to the midplane TDM clock:
Router(config)# cable clock source-midplane
Cisco IOS CMTS Cable Command Reference
CBL-88 OL-15510-15
Cable Commands: cable a through cable c
cable clock source-midplane
Related Commands Command Description
show cable clock Displays status information for the cable clock card.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-89
Cable Commands: cable a through cable c
cable clock upgrade
cable clock upgrade
To upgrade the Field-Programmable Gate Array (FPGA) image manually on the DOCSIS Timing &
Control Card (DTCC), use the cable clock upgrade command in privileged EXEC mode.
cable clock upgrade slot/subslot
Syntax Description slot Chassis slot number of the DTCC card. The valid slot is 1.
subslot Secondary slot number of the DTCC card. Valid subslots are 1 or 2.
Command Default None
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines In Cisco IOS Release 12.2(33) SCC and later, you can manually upgrade the FPGA image only if a
single DTCC card is installed on the Cisco uBR 10012 router. If the manual upgrade fails or is
interrupted, the DTCC card may become unusable. Do not reset or unplug the DTCC card during the
manual upgrade. We recommend that you take precaution against extended downtime if the FPGA
upgrade fails unexpectedly by having a standby DTCC card installed on the Cisco uBR10012 router.
Note You will have to enter y (yes) when the system prompts you to continue the manual upgrade.
Examples The following example shows how to start the manual FPGA upgrade process on the DTCC card:
Router# cable clock upgrade 1/1
Related Commands Command Description
cable clock dti Configures the DOCSIS Timing Interface (DTI) clock reference mode.
Cisco IOS CMTS Cable Command Reference
CBL-90 OL-15510-15
Cable Commands: cable a through cable c
cable cmcpe-list valid-time
cable cmcpe-list valid-time
To set the length of time that a CMTS router will consider the current list of CM and CPE devices to be
valid, use the cable cmcpe-list valid-time command in global configuration mode. To reset the time
period to its default value of 3 minutes, use the no form of this command.
cable cmcpe-list valid-time time
no cable cmcpe-list valid-time
Syntax Description time Specifies the time period, in seconds, that the Cisco CMTS router should consider the current
CM/CPE list to be valid. In Cisco IOS Release 12.2(15)BC1 and earlier releases, the valid
range is 0 to 3600 seconds, with a default value of 180 seconds (3 minutes). In Cisco IOS
Release 12.2(15)BC2 and later releases, the valid range is 0 to 86400 seconds, with a default
value of 900 seconds (15 minutes).
Command Default 180 seconds (3 minutes)—Cisco IOS Release 12.2(15)BC1 and earlier releases
900 seconds (15 minutes)—Cisco IOS Release 12.2(15)BC2 and later releases
Command Modes Global configuration (config)
Command History Release Modification
12.0(15)SC1, This command was introduced for the Cisco uBR7100 series and Cisco uBR7200
12.1(8)EC1, series routers.
12.2(4)BC1 This command was supported on the 12.2 BC train for the Cisco uBR10012 router.
12.2(15)BC2 The maximum range for time was expanded from 3600 to 86400 seconds, and the
default was changed from 180 to 900 seconds.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
Usage Guidelines The Cisco CMTS router maintains an internal list of cable modems and CPE devices that were connected
on its cable interfaces in the last 24 hours. This list does not capture cable modems and CPE devices that
were connected before the last 24 hours.
The CMTS router uses this list to provide the data for various show commands and to respond to SNMP
requests that query the entries in the cdxCmCpeTable table in the CISCO-DOCS-EXT-MIB MIB.
By default, the Cisco CMTS router uses the current list if it is less than 3 minutes old. If the current list
is older than 3 minutes, the Cisco CMTS router considers it invalid and rebuilds a new list. This prevents
the CMTS router from having to build a new list for every query, which could impact system
performance.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-91
Cable Commands: cable a through cable c
cable cmcpe-list valid-time
You can use the cable cmcpe-list valid-time command to change the length of time that the CMTS
router considers the current CM and CPE device list to be valid. This allows you to find the optimum
time value that provides the most current information without affecting the number of CPU cycles that
are available for network processing.
A smaller time period ensures that the CM and CPE device list is more current but it requires more
processing time to maintain the list. A longer time period reduces the load on the processor but the
CM/CPE list might not be current.
If CPU usage dramatically increases when performing SNMP queries of the cdxCmCpeTable table, use
this command to increase the valid list time so that the Cisco CMTS router does not have to rebuild the
CM/CPE list more often than needed to respond to the queries.
Note To find the current valid list time, use the show running-config command and look for the cable
cmcpe-list valid-time command in the output. If the command does not appear, the valid list time is set
for its default value.
Examples The following example shows how to set the valid list time to 60 seconds (1 minute):
Router(config)# cable cmcpe-list valid-time 60
The following example shows how to find the current valid list time setting:
Router# show running-config | include cmcpe-list
cable cmcpe-list valid-time 60
Related Commands Command Description
show cable modem Displays information for the registered and unregistered CMs.
Cisco IOS CMTS Cable Command Reference
CBL-92 OL-15510-15
Cable Commands: cable a through cable c
cable cm-status
cable cm-status
To configure the values of the “Event Holdoff Timer” and “Number of Reports per Event” parameters
for the cable modem (CM) status events, use the cable cm-status command in global configuration
mode. To revert to the default values, use the no form of this command.
cable cm-status {all | event} [holdoff {timer | default} | reports {reportvalue | default}]
no cable cm-status
Syntax Description all Specifies all CM status events.
event Type of CM status event.
holdoff (Optional) Sets the CM status event holdoff timer. The holdoff units are
defined in milliseconds. The timer value increments by 20 milliseconds.
• timer—Holdoff timer value. The valid range is from 1 to 65535
milliseconds. The default value is 50 milliseconds.
• default—Specifies the default value of 50 milliseconds.
reports (Optional) Sets the value for the number of reports per event.
• reportvalue—Report value. The valid range is from 0 to 255. The
default value is 2.
• default—Specifies the default value of 2.
Command Default Default values are used for the “Event Holdoff Timer” and “Number of Reports per Event” parameters.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines The cable cm-status command updates the event table for the MAC Domain Descriptor (MDD)
belonging to a primary channel. The help text of the command provides a mapping of an event type to
the corresponding integer.
The ten CM status events are:
1. Secondary channel MDD time-out
2. QAM/FEC lock failure
3. Sequence out-of-range
4. MDD recovery
5. QAM/FEC lock recovery
6. T4 time-out
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-93
Cable Commands: cable a through cable c
cable cm-status
7. T3 re-tries exceeded
8. Successful ranging after T3 re-tries exceeded
9. CM operating on battery backup
10. CM returned to A/C power
Note The CM-STATUS message event ‘sequence out of range’ is enabled and supported on the
Cisco Wideband SPA from Cisco IOS Release 12.2(33)SCE5 onwards. When the Cisco CMTS receives
the ‘sequence out of range’ event, it toggles the sequence-change-count (SCC) bit for each of the
indicated downstream service identifiers (DSIDs).
Examples The following example shows how to configure an event holdoff timer of 100 milliseconds and four
reports per event for all CM-STATUS events:
Router# configure terminal
Router(config)# cable cm-status all holdoff 100 reports 4
The following example shows how to configure the CM status event “MDD recovery” with an event
holdoff timer of 150 milliseconds and three reports for the event:
Router# configure terminal
Router(config)# cable cm-status 4 holdoff 150 reports 3
Associated Features The cable cm-status command is used to configure the following feature:
• Wideband Modem Resiliency
Related Commands Command Description
cable cm-status enable Enables a CM status event or a group of CM status events on a primary cable
interface.
Cisco IOS CMTS Cable Command Reference
CBL-94 OL-15510-15
Cable Commands: cable a through cable c
cable cm-status enable
cable cm-status enable
To enable a CM status event or a group of CM status events on a primary cable interface, use the cable
cm-status enable command in interface configuration mode. To disable a particular event on a primary
cable interface, use the no form of this command.
cable cm-status enable range
no cable cm-status
Syntax Description range Specifies the CM status events you want to enable on a primary cable
interface. The valid range is 1 to 10. You can enable a single event by
specifying the event number or a group of events by specifying a range (for
example, 1-9).
The following events are enabled by default on a cable or modular cable
interface:
• Secondary channel MDD time-out
• QAM/FEC lock failure
• Sequence out of range
• MDD recovery
• QAM/FEC lock recovery
Note The default events are not displayed in the output of the show
running-config interface cable command.
Command Default The downstream related events such as secondary channel MDD time-out, QAM/FEC lock failure,
Sequence out of range, MDD recovery, and QAM/FEC lock recovery are enabled.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines This command applies to all non-primary RF channels on a CMTS.
The ten CM status events per interface are:
1. Secondary channel MDD time-out
2. QAM/FEC lock failure
3. Sequence out of range
4. MDD recovery
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-95
Cable Commands: cable a through cable c
cable cm-status enable
5. QAM/FEC lock recovery
6. T4 time-out
7. T3 re-tries exceeded
8. Successful ranging after T3 re-tries exceeded
9. CM operating on battery backup
10. CM returned to A/C power
Note If the no version of the command is executed on the interface for specific events, then the show
running-config interface command lists the events only that are enabled. If no events are enabled then,
the show running interface cable command displays no cable cm-stauts enable with the events.
Examples The following example shows how to enable all CM status events on a primary cable interface:
Router# configure terminal
Router(config)# interface cable 8/0/0
Router(config-if)# cable cm-status enable 1-10
The following example shows the no cable cm-status enable command being configured and the
corresponding example shows show running-config interface command output:
Router(config)# interface cable 8/0/0
Router(config-if)# cable cm-status enable 1-10
Router(config-if)# no cable cm-status enable 1-2 4-5
Router(config-if) exit
Router# show running-config interface cable 8/0/0
Building configuration...
Current configuration : 1557 bytes
!
interface Cable8/0/0
shutdown
cable cm-status enable 3 6-10
no cable packet-cache
cable default-phy-burst 0
cable map-advance dynamic 300 500
cable bundle 1
cable downstream channel-id 145
The following example shows the show running-config interface cable command output when no
events are enabled on the CMTS:
Router#show running-config interface cable 8/0/0
Building configuration...
Current configuration : 1558 bytes
!
interface Cable8/0/0
shutdown
no cable cm-status enable 1-10
no cable packet-cache
cable default-phy-burst 0
cable map-advance dynamic 300 500
cable bundle 1
cable downstream channel-id 145
cable downstream annex B
Cisco IOS CMTS Cable Command Reference
CBL-96 OL-15510-15
Cable Commands: cable a through cable c
cable cm-status enable
cable downstream modulation 256qam
cable downstream interleave-depth 32
cable downstream frequency 555000000
cable downstream rf-shutdown
cable upstream max-ports 4
no cable upstream 0 connector
cable upstream 0 frequency 40000000
cable upstream 0 channel-width 3200000 3200000
cable upstream 0 power-level 26
cable upstream 0 docsis-mode tdma-atdma
cable upstream 0 minislot-size 4
--More--
Related Commands Command Description
show cable modem Displays information for the registered and unregistered CMs.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-97
Cable Commands: cable a through cable c
cable config-file
cable config-file
To create a configuration filename for a Cisco CMTS router internal CM configuration file, use the
cable config-file command in global configuration mode. To delete the configuration filename, use the
no form of this command.
cable config-file filename
no cable config-file filename
Syntax Description filename Specifies the configuration filename to create and edit.
Command Default No default behaviors or values
Command Modes Global configuration (config)
Command History Release Modification
12.1(2)EC1 This command was introduced.
12.2(4)BC1 This command was integrated into Cisco IOS Release 12.2(4)BC1.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
Usage Guidelines A DOCSIS CMTS router automatically downloads a DOCSIS configuration file to a CM during its
initial registration procedure. The DOCSIS configuration file configures the CM for its network
operations and includes information such as the maximum number of CPE devices that are supported,
the quality of service (QoS) options provided for the CM, and whether the CM should upgrade to a new
software image.
The DOCSIS specification defines the format of the DOCSIS configuration files, which can be created
by any number of tools. In addition to the other tools that Cisco provides for this purpose, the cable
config-file command can be used to create the DOCSIS configuration files needed for your network.
These configuration files are stored in the Flash memory on the Cisco CMTS router and can be
automatically downloaded to the CM as needed.
The cable config-file command creates the DOCSIS configuration file if it does not already exist and
then enters config-file configuration mode. You can then give one of the following subcommands to
create the configuration file:
• access-denied
• channel-id
• cpe max
• download
• frequency
Cisco IOS CMTS Cable Command Reference
CBL-98 OL-15510-15
Cable Commands: cable a through cable c
cable config-file
• option
• privacy
• service-class
• snmp manager
• timestamp
Note When a DOCSIS shared secret is configured on the downstream interface (see the cable shared-secret
command), the cable config-file command automatically inserts the appropriate MD5 Message Integrity
Check (MIC) value at the end of the dynamically generated DOCSIS configuration file. You do not need
to specify the DOCSIS shared secret string with the cable config-file command.
After using the cable config-file subcommands, enter the exit command to leave config-file mode and
to save the configuration file in the Flash memory. After a configuration file is created, it also appears
in the running-configuration file. To delete a configuration file and remove it from Flash memory, use
the no cable config-file command.
To allow CMs to download the configuration files, you must also enable the router’s onboard TFTP
server, using the tftp-server configuration command. Unless you are running on a small lab network,
you should also remove the default limit of 10 TFTP sessions by using the service udp-small-serves
max-servers no limit command.
In addition, the following commands are also recommended:
• cable time-server—Enables the Cisco CMTS router to function as a time-of-day (ToD) server.
• ip dhcp pool—Configures the Cisco CMTS router as a DHCP server. Otherwise, you need an
external DHCP server.
• ip dhcp ping packets 0—Improves the scalability of the Cisco CMTS router DHCP server.
Note For complete information on DOCSIS configuration files, see Appendix C in the DOCSIS 1.1 Radio
Frequency (RF) Interface Specification, available on the DOCSIS Cable Labs official web site at
http://www.cablemodem.com
Examples The following example shows two DOCSIS configuration files being configured. The first configuration
file allows each CM to have up to four CPE devices and configures the QoS parameters for its traffic.
The second configuration file denies network access to the CM and its CPE devices.
Router# configure terminal
Router(config)# cable config-file test.cm
Router(config-file)# cpe max 4
Router(config-file)# service-class 1 priority 2
Router(config-file)# service-class 1 max-upstream 128
Router(config-file)# service-class 1 max-downstream 1000
Router(config-file)# timestamp
Router(config-file)# exit
Router(config)# cable config-file denied.cm
Router(config-file)# access-denied
Router(config-file)# exit
Router(config)#
The following is a portion of a typical Cisco IOS configuration file that shows the above two DOCSIS
configuration files, as well as a typical DHCP server configuration:
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-99
Cable Commands: cable a through cable c
cable config-file
Router# show running-config
...
service udp-small-servers max-servers no-limit
!
cable time-server
!
cable config-file test.cm
cpe max 4
service-class 1 priority 2
service-class 1 max-upstream 128
service-class 1 max-downstream 1000
timestamp
cable config-file disable.cm
access-denied
!
ip dhcp pool modems-c3
network 10.30.128.0 255.255.240.0
bootfile test.cm
next-server 10.30.128.1
default-router 10.30.128.1
option 7 ip 10.30.128.1
option 4 ip 10.30.128.1
option 2 hex 0000.0000
!
...
Related Commands Command Description
cable config-file Creates a DOCSIS configuration file and enters configuration file mode.
access-denied Disables access to the network.
channel-id Specifies upstream channel ID.
cpe max Specifies the maximum number of CPE devices allowed access.
debug cable config-file Displays information about the DOCSIS configuration files that are
generated by the internal DOCSIS configuration file editor.
download Specifies the filename and server IP address for downloading a new software
image.
frequency Specifies the downstream frequency.
option Specifies options for the configuration file that are not provided for by the
other commands.
privacy Specifies privacy options for baseline privacy images.
service-class Specifies service class definitions for the configuration file.
snmp manager Specifies Simple Network Management Protocol (SNMP) options.
timestamp Enables time-stamp generation.
show running-config Displays the current run-time configuration, which includes any
configuration files that have been defined.
show startup-config Displays the current saved configuration, which includes any configuration
files that have been defined and saved.
Cisco IOS CMTS Cable Command Reference
CBL-100 OL-15510-15
Cable Commands: cable d
Revised: July 2012, OL-15510-15
New Commands
Command Cisco IOS Software Release
cable dynamic-bw-sharing 12.3(23)BC1
cable divert-rate-limit 12.2(33)SCB
cable docsis30-voice downstream 12.2(33)SCB
req-attr-mask
cable downstream attribute mask 12.2(33)SCB
cable dsg tg 12.2(33)SCB4
cable downstream qos wfq weight 12.2(33)SCC
cable dynamic-secret tftp 12.2(33)SCD2
insert-upgrade-server
cable downstream channel-id automatic 12.2(33)SCE
cable dfo-retry-count 12.2(33)SCD7
cable dynamic-qos trace 12.2(33)SCF
cable downstream dsg disable 12.2(33)SCG
cable downstream dsg tg 12.2(33)SCG
cable dsg name-update-interval 12.2(33)SCG
cable dsg tg default-priority 12.2(33)SCG
cable dsg tg priority 12.2(33)SCG
cable ds-resiliency 12.2(33)SCG
Modified Commands
Modified Command Effective Cisco IOS Release
cable ds-max-burst 12.2(33)SCB
cable dynamic-bw-sharing 12.2(33)SCB
cable dsg tunnel srv-class 12.2(33)SCC1
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-101
Cable Commands: cable d
Modified Command Effective Cisco IOS Release
cable downstream rf-power 12.2(33)SCC4
cable dhcp-giaddr 12.2(33)SCD5
cable dsg cfr 12.2(33)SCD5
cable dsg cfr 12.2(33)SCG
cable dsg tg 12.2(33)SCG
Obsolete Commands
The following commands have been removed from certain Cisco IOS software releases:
Obsolete Command Effective Cisco IOS Release
cable downstream dsg rule 12.3(17a)BC2
cable dsg 12.3(13a)BC
cable dsg keepalive 12.3(13a)BC
Cisco IOS CMTS Cable Command Reference
CBL-102 OL-15510-15
Cable Commands: cable d
cable dci-response
cable dci-response
To configure how a cable interface responds to DCI-REQ messages for CMs on that interface, use the
cable dci-response command in cable interface configuration mode.
cable dci-response [success | ignore | reject permanent | reject temporary]
Syntax Description success (Optional) Configures the interface so that the Cisco CMTS responds to DCI-REQ
messages from CMs on the interface by sending a DCI-RSP response with the
confirmation code of Success (0).
ignore (Optional) Configures the interface so that the Cisco CMTS ignores DCI-REQ
messages from CMs on the interface. It does not send any DCI-RSP responses.
reject permanent (Optional) Configures the interface so that the Cisco CMTS responds to DCI-REQ
messages from CMs on the interface by sending a DCI-RSP response with the
confirmation code of Reject Permanent (4).
reject temporary (Optional) Configures the interface so that the Cisco CMTS ignores the first four
DCI-REQ messages from a CM on the interface, but on the fifth DCI-REQ
message, the CMTS responds with a DCI-RSP response with the confirmation
code of Reject Temporary (3). The CMTS then continues to ignore the next seven
DCI-REQ messages and then restarts this process when it receives the twelfth
DCI-REQ message.
Command Default The Cisco CMTS router responds to DCI-REQ messages from all CMs by sending a DCI-RSP response
with the confirmation code of Success (0).
Command Modes Interface configuration—cable interface only (config-if)
Command History Release Description
12.1(4)CX This command was introduced for DOCSIS 1.1 operation.
12.2(4)BC1 This command was integrated into Cisco IOS Release 12.2(4)BC1.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines The Device Class Identification (DCI) messages are part of the Media Access Control Specification
section of the DOCSIS 1.1 specification (revision SP-RFIv1.1-I05-000714 and above). A CM can
optionally use the DCI-REQ message to inform the CMTS router of certain capabilities, such as whether
it is a CPE-controlled cable modem (CCCM).
The CMTS router then responds with one of the following confirmation codes:
• Success—Allows the CM to continue with the registration process.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-103
Cable Commands: cable d
cable dci-response
• Reject Permanent—Instructs the CM to abort its registration process on this downstream channel.
The CM must try all other available downstream channels before attempting to register on this
downstream channel again.
• Reject Temporary—Instructs the CM to reset its DCI-REQ counter, to send another DCI-REQ
message, and to wait for the DCI-RSP before proceeding with the registration process.
Note The CMTS router also can respond with an Upstream Transmitter Disable (UP-DIS) message. See the
description of the cable dci-upstream-disable command for details.
Examples The following example shows how to configure the CMTS router so that it ignores all DCI-REQ
messages from CMs on the cable interface at slot 6:
Router# configure terminal
Router(config)# interface c6/0
Router(config-if)# cable dci-response ignore
The following example shows how to configure the CMTS router so that it returns to its default behavior
for the cable interface on slot 6, which is to respond to all DCI-REQ messages from CMs by sending a
DCI-RSP with a Success confirmation code:
Router# configure terminal
Router(config)# interface c6/0
Router(config-if)# cable dci-response success
Note The cable dci-response success command does not appear in a startup or running configuration file,
because it is the default configuration for a cable interface.
Related Commands Command Description
cable dci-upstream-disable Configures the cable interface so that it transmits an Upstream
Transmitter Disable (UP-DIS) message instead of a DCI-RSP
message to a particular CM.
debug cable dci Enables debugging of DCI-REQ, DCI-RSP, and UP-DIS
messages.
Cisco IOS CMTS Cable Command Reference
CBL-104 OL-15510-15
Cable Commands: cable d
cable dci-upstream-disable
cable dci-upstream-disable
To configure a cable interface so that it transmits a DOCSIS 1.1 Upstream Transmitter Disable (UP-DIS)
message to a particular CM, use the cable dci-upstream-disable command in cable interface
configuration mode. To remove that configuration and return to the default configuration, use the no
form of this command.
cable dci-upstream-disable mac-address [enable | disable]
no cable dci-upstream-disable mac-address [enable | disable]
Syntax Description mac-address Specifies the MAC physical layer address for a particular CM.
enable (Optional) Enables the UP-DIS message for the particular CM, so that when the CM
sends a DCI-REQ message, the CMTS router responds by sending an UP-DIS response.
disable (Optional) Disables the sending of UP-DIS messages to a particular CM.
Command Default The Cisco CMTS router does not transmit UP-DIS messages to any CMs.
Command Modes Interface configuration—cable interface only (config-if)
Command History Release Description
12.1(4)CX This command was introduced for DOCSIS 1.1 operation.
12.2(4)BC1 This command was integrated into Cisco IOS Release 12.2(4)BC1.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
Usage Guidelines The DOCSIS 1.1 specification (revision SP-RFIv1.1-I05-000714 and above) allows a CMTS router to
transmit an Upstream Transmitter Disable (UP-DIS) message to a CM. If the CM supports the UP-DIS
message, it responds by immediately disabling its upstream transmitter circuitry. The CM must be
power-cycled before it can begin transmitting on the upstream again.
Examples The following example shows the cable dci-upstream-disable command being used to enable the
UP-DIS message for the CM with the MAC address of 0123.4567.89ab.
Router# configure terminal
Router(config)# interface c6/0
Router(config-if)# cable dci-upstream-disable 0123.4567.89ab enable
Router(config-if)# exit
Router(config)# exit
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-105
Cable Commands: cable d
cable dci-upstream-disable
Related Commands Command Description
cable dci-response Configures how the cable interface responds to DCI-REQ messages from CMs
on that interface.
debug cable dci Enables debugging of DCI-REQ, DCI-RSP, and UP-DIS messages.
Cisco IOS CMTS Cable Command Reference
CBL-106 OL-15510-15
Cable Commands: cable d
cable default-phy-burst
cable default-phy-burst
To specify a value for the upstream Maximum Traffic Burst parameter for CMs that do not specify their
own value, use the cable default-phy-burst command in cable interface configuration mode. To reset
the maximum burst size to its default, use the no form of this command.
cable default-phy-burst burst-size
no cable default-phy-burst
Syntax Description burst-size Specifies the maximum number of bytes that are allowed in a burst. The valid range is 0 to
4096 bytes, with a default of 2000 bytes. A value of 0 specifies that CMs cannot register
unless they specify a valid burst size.
Command Default 2000 bytes
Command Modes Interface configuration—cable interface only (config-if)
Command History Release Modification
12.2(8)BC1 This command was introduced for the Cisco uBR7100 series, Cisco uBR7200 series,
and Cisco uBR10012 routers.
12.2(15)BC2 The cable upstream fragment-force command is introduced, with considerations to
the cable defaut-phy-burst command.
The maximum upstream traffic burst may also be influenced by the new cable
upstream fragment-force command for cable modems that are able to perform
fragmentation.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
Usage Guidelines
Note The cable default-phy-burst command applies to cable modems that cannot perform fragmentation.
The value specified by the cable default-phy-burst command is used to determine the maximum total
frame burst size supported for a cable modem request. In contrast, the cable upstream fragment-force
command may be used to determine the largest single physical burst a cable modem can transmit, when
the cable modem supports fragmentation.
The DOCSIS 1.0 specification allows CMs to register without specifying a maximum upstream burst
size, or to register with a value of 0, which means an unlimited burst size. This behavior can interfere
with DOCSIS 1.1 networks because excessively large bursts on an upstream will generate unpredictable
jitter and delay in voice calls. DOCSIS 1.1 CMs can also cause this problem if they register without
enabling fragmentation of packets at the DOCSIS MAC layer.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-107
Cable Commands: cable d
cable default-phy-burst
This command allows you to specify a default burst size for CMs that register without specifying a burst
size or that register with a burst size of 0. It also specifies the maximum size of long data grants if a CM
specifies a size of 0 (unlimited) in the Upstream Channel Descriptor (UCD) packet. If a CM specifies a
long data grant that would exceed the maximum burst size, and the CM is not using DOCSIS
concatenation, the DOCSIS scheduler drops the bandwidth request.
To prevent CMs from registering without defining a burst profile, use this command with a burst-size of
zero. CMs that do not define a burst profile will not be allowed to register and come online.
Note Typically, DOCSIS 1.1 CMs set the maximum upstream transmit burst size to the larger value of 1522
bytes and maximum concatenated burst size (which can be a maximum of 4096 bytes).
The default PHY burst parameter interacts with two other parameters that are configured in the DOCSIS
configuration file:
• DOCSIS 1.1 configuration files can also specify a value for the maximum concatenation burst,
which has a default of 1522 bytes. If this parameter is greater than the default PHY burst size, the
CM can override the default PHY burst when it is using concatenation.
• DOCSIS 1.0 and 1.1 configuration files can also specify a maximum transmit burst size. In DOCSIS
1.1 configurations, this parameter defaults to 3044 bytes, with a minimum of 1522 bytes. DOCSIS
1.0 configuration files could set this parameter to a value lower than 1522 bytes, depending on what
version of the DOCSIS 1.0 specification they support. The CMTS router will enforce the lower limit
between the default phy burst and the maximum transmit burst, so you should ensure that all
configuration files in your network specify a minimum of 1522 bytes for the maximum transmit
burst size.
Examples The following example shows the default maximum burst size to 1522 bytes, which is the minimum size
required by the DOCSIS 1.1 specification:
Router(config)# interface cable 5/1
Router(config-if)# cable default-phy-burst 1522
The following example shows the default maximum burst size to 0, which means that a CM must specify
a valid burst profile before the Cisco CMTS allows it to register and come online:
Router(config)# interface cable 5/1
Router(config-if)# cable default-phy-burst 0
The following example shows the default maximum burst size being reset to its default of 2000 bytes:
Router(config)# interface cable 5/1
Router(config-if)# no cable default-phy-burst
Related Commands Command Description
cable upstream fragmentation Enables fragmentation of DOCSIS frames on a particular upstream.
cable upstream fragment-force Specifies that a cable interface line card should fragment DOCSIS
frames on an upstream when the frame exceeds a particular size.
show cable modem Displays information for the registered and unregistered CMs,
including the QoS configuration for individual CMs.
show controllers cable Displays the downstream MPEG framing format (Annex A or
Annex B) setting.
Cisco IOS CMTS Cable Command Reference
CBL-108 OL-15510-15
Cable Commands: cable d
cable device
cable device
To configure access list for a CM device or host, use the cable device command in privileged EXEC
mode. To remove an access group, use the no access-group option of this command.
cable device {ip-address | mac-address} [no] access-group {access-list | access-name} |
{[vrf vrf-name] ip-address [no] access-group [access-list | access-name]}
Syntax Description ip-address IP address for the device.
mac-address MAC address for the device.
access-group Enables access-group options. The no form removes access-group
specifications.
access-list | access-name Specifies the IP access list (standard or extended), either by access-list
number (1 to 199) or by access-list name.
vrf vrf-name Specifies a virtual routing and forwarding instance that is populated with
Virtual Private Network (VPN) routes. The vrf-name argument specifies the
name for the virtual route forwarding instance.
Command Default No default behaviors or values
Command Modes Privileged EXEC (#)
Command History Release Description
12.1 Ported from earlier releases.
12.1(1a)T1 The vrf keyword was added for Multiprotocol Label Switching (MPLS) VPN support.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
Usage Guidelines For the VRF syntax portion of this command, only the IP address option is supported.
Note The cable device command is not supported on the Cisco uBR10012 universal broadband router.
Note The vrf keyword is not supported on the 12.0 SC, 12.1 EC and 12.2 BC releases.
Examples The following example shows how to assign an access list to the MAC address of a cable device:
Router# configure terminal
Router(config)# cable device 0010.7b6b.77ed acc 1
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-109
Cable Commands: cable d
cable device
Router(config)# exit
Related Commands Command Description
cable host access-group Configures the access list for the specified hosts.
clear cable host Clears the host from the table.
show cable device access-group Display the CMs and the hosts behind the CMs on the network.
show cable host access-group Displays the hosts behind the CMs on the network.
Cisco IOS CMTS Cable Command Reference
CBL-110 OL-15510-15
Cable Commands: cable d
cable dfo-retry-count
cable dfo-retry-count
To configure the Downstream Frequency Override (DFO) retry count, use the cable dfo-retry-count
command in global configuration mode. To reset the DFO retry count to its default value, use the no
form of this command.
cable dfo-retry-count n
no cable dfo-retry-count n
Syntax Description n Downstream frequency override retry count. The valid range is from 1 to
100.
Command Default The cable dfo-retry-count command is configured with a default value of 20.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCD7 This command was introduced.
Usage Guidelines The Downstream Frequency Override (DFO) feature enables cable modems to register on a specific
primary RF channel. Because of RF failure conditions and some cable modem types, the cable modem
takes more time to register on a specific primary RF channel. You can configure the DFO retry count to
reduce the cable modem registration time using the cable dfo-retry-count command.
Examples The following example shows how to configure the DFO retry count as 10:
Router# configure terminal
Router(config)# cable dfo-retry-count 10
Related Commands Command Description
cable service attribute Forces a downstream bonding-capable modem to initialize on a bonded
ds-bonded primary-capable downstream channel.
downstream-type
bonding-enabled
cable service attribute Forces the non-bonding-capable modems to register only on non-bonded RF
non-ds-bonded channels on the CMTS.
downstream-type
bonding-disabled
cable service type Redirects matching service types to the downstream frequency.
ds-frequency
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-111
Cable Commands: cable d
cable dhcp-giaddr
cable dhcp-giaddr
To modify the GIADDR field for the DHCPDISCOVER and DHCPREQUEST packets with a relay IP
address before they are forwarded to the DHCP server, use the cable dhcp-giaddr command in cable
interface or subinterface configuration mode. To set the GIADDR field to its default, use the no form of
this command.
cable dhcp-giaddr {policy [strict | host | mta | ps | stb] giaddr | primary}
no cable dhcp-giaddr
Syntax Description policy Selects the control policy, so that the primary address is used for cable modems and the
secondary addresses are used for hosts and other customer premises equipment (CPE)
devices. This setting is typically used when the CMs on the interface are configured for
routing, so that the CMs and hosts can use IP addresses on different subnets.
strict (Optional, only when the policy keyword is specified) Selects the GIADDR IP address as
the source IP address in the forwarded DHCPOFFER packet.
By default when using the policy option, the Cisco CMTS changes the source IP address in
the DHCPOFFER packet to match that of the primary address on the cable interface. Enable
the strict option to prevent this behavior, which could interfere with any access lists applied
to the CM when the CM is using a different subnet from the primary address space of the
cable interface.
host Specifies the GIADDR for hosts.
mta Specifies the GIADDR for media terminal adapters (MTA).
ps Specifies the GIADDR for portal servers (PS).
stb Specifies the GIADDR for set-top boxes (STB).
giaddr IP addresses of the secondary interface of the bundle interface.
primary Selects the primary address always to be used for the GIADDR field for both CMs and CPE
devices. This option is typically used for the Cisco uBR-MC16E card and Cisco uBR7100E
series routers to support EuroDOCSIS operations.
Command Default None
Command Modes Interface configuration (config-if)
Subinterface configuration (config-subif)
Command History Release Modification
12.0(4)T This command was introduced.
12.0(6)SC This command was integrated into Cisco IOS Release 12.0(6)SC.
12.1(2)EC1 This command was integrated into Cisco IOS Release 12.1(2)EC1.
12.1(3a)EC This command was modified to support subinterfacess.
12.2(15)BC2 This command was modified to include the strict option.
Cisco IOS CMTS Cable Command Reference
CBL-112 OL-15510-15
Cable Commands: cable d
cable dhcp-giaddr
Release Modification
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. This command
was modified to support the Cisco uBR7225VXR router.
12.2(33)SCD5 This command was modified to support the host, mta, ps, and stb keywords.
Usage Guidelines You can use this command to modify the GIADDR field of DHCPDISCOVER and DHCPREQUEST
packets to provide a relay IP address before packets are forwarded to the DHCP servers. Use this
command to set a policy option such that primary addresses are used for CMs and secondary addresses
are used for hosts (such as PCs) behind the CMs.
When using multiple secondary subnets, the Cisco CMTS router uses the first secondary IP address as
the GIADDR field when forwarding a DHCPDISCOVER request to the DHCP server. If no DHCP
server responds with a DHCPOFFER message after three attempts, the Cisco CMTS router uses the next
secondary IP address, up to a maximum of 16 secondary addresses.
Note If you have configured a Cisco CM for routing mode and are also using the cable-modem dhcp-proxy
nat command on the CM, you must configure the corresponding cable interface on the Cisco CMTS with
the cable dhcp-giaddr policy [strict] command.
Caution You cannot use the strict option with the internal DHCP server that is onboard the Cisco CMTS router,
because the strict option requires the use of DHCP relay operation, which is not performed by DHCP
termination points such as the internal DHCP server.
Examples The following example shows how to set the primary address to be used always for GIADDR:
Router# configure terminal
Router(config)# interface cable 3/0
Router(config-if)# cable dhcp-giaddr primary
The following example shows how to set the primary address to be used always for GIADDR in the cable
subinterface mode:
Router# configure terminal
Router(config)# interface cable 6/0.1
Router(config-subif)# cable dhcp-giaddr primary
The following example shows how to configure the router so that the primary address is used for CMs
and the secondary addresses are used for hosts. In addition, the GIADDR is used as the source IP address
in forwarded DHCPOFFER packets.
Router# configure terminal
Router(config)# interface cable 5/1/0
Router(config-if)# cable dhcp-giaddr policy strict
The following example shows how to configure the router so that the CPE device (in this case, the MTA)
uses a specific secondary interface:
Router# configure terminal
Router(config)# interface bundle 25
Router(config-if)# cable dhcp-giaddr mta 172.10.10.1
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-113
Cable Commands: cable d
cable dhcp-giaddr
Related Commands Command Description
cable helper-address Specifies a destination IP address for the User Datagram
Protocol (UDP) broadcast (DHCP) packets.
cable relay-agent-option Enables the system to insert the CM MAC address into a
DHCP packet received from a CM or host, and forward
the packet to a DHCP server.
cable source-verify Enables CM upstream verification.
cable telco-return spd dhcp-authenticate Enforces the telco-return CM to use a specific DHCP
server.
cable telco-return spd dhcp-server Identifies the IP address of the Dynamic Host
Configuration Protocol (DHCP) server that the
telco-return CM must access.
debug cable dhcp Enables debugging of the DHCP when it is used on the
cable interface.
debug cable mac-address Enables debugging of the MAC address on the cable
interface.
ip dhcp relay information option Enables the system to insert the CM MAC address into a
DHCP packet received from a CM or host and forward the
packet to a DHCP server.
ip dhcp smart-relay Monitors client retransmissions when address pool
depletion occurs.
Cisco IOS CMTS Cable Command Reference
CBL-114 OL-15510-15
Cable Commands: cable d
cable dhcp-insert
cable dhcp-insert
To configure the Cisco CMTS router to insert descriptors into DHCP packets using option 82, use the
cable dhcp-insert command in global configuration mode. To remove this configuration, use the no
form of this command.
cable dhcp-insert {downstream-description | hostname | service-class | upstream-description}
Syntax Description downstream-description Appends received DHCP packets with downstream port descriptors.
hostname Appends received DHCP packets with router host names.
service-class Appends received DHCP packets with router service class.
upstream-description Appends received DHCP packets with upstream port descriptors.
Defaults This configuration is disabled by default.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.3(21)BC This command was introduced.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
12.2(33)SCF2 This command was modified. The service-class keyword was added.
Usage Guidelines This feature enhances the DHCP security potential and the Cable Duplicate MAC Address Feature on
the Cisco CMTS router.
The cable dhcp-insert command command specifies which descriptors to append to DHCP packets. The
DHCP servers can then detect cable modem clones and extract geographical information.
Note Multiple types of descriptor strings can be configured as long as the maximum relay information option
size is not exceeded.
The Cisco CMTS router can use the DHCP Relay Agent Information option (DHCP option 82) to send
particular information about a cable modem, such as its MAC address and the cable interface to which
it is connected. If the DHCP server cannot match the information with that belonging to a cable modem
in its database, the Cisco CMTS router identifies that the device is a CPE device. This allows the
Cisco CMTS router and DHCP server to retain accurate information about which CPE devices are using
which cable modems and whether the devices should be allowed network access.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-115
Cable Commands: cable d
cable dhcp-insert
The DHCP Relay Agent can also be used to identify cloned modems or gather geographical information
for E911 and other applications. Using the cable dhcp-insert command, configure the Cisco CMTS
router to insert downstream, upstream, hostname, or service class descriptors into DHCP packets. A
DHCP server can utilize such information to determine service levels available to the host specific to
the provisioned subscriber.
Note To use the service-class option, the service class name specified in the CM configuration file must be
configured on the Cisco CMTS. The ip dhcp relay information option-insert command should be
configured on the bundle interface to insert the service-class option into the DHCP DISCOVER
messages.
Examples The following example shows how to insert descriptors into DHCP packets. The DHCP server can then
use these descriptors to identify cable modem clones and extract geographical information.
Router(dhcp-config)# cable dhcp-insert service-class
Associated Features The cable dhcp-insert command is used to configure the following feature:
DHCP, ToD, and TFTP Services for the CMTS Routers
Related Commands Command Description
ip dhcp relay information Enables the system to insert a DHCP Relay Agent option in
option-insert forwarded BOOTREQUEST messages to a DHCP server.
Cisco IOS CMTS Cable Command Reference
CBL-116 OL-15510-15
Cable Commands: cable d
cable dhcp-parse option
cable dhcp-parse option
To enable parsing of Dynamic Host Configuration Protocol (DHCP) options, use the cable dhcp-parse
option command in cable interface configuration mode. To disable parsing, use the no form of this
command.
cable dhcp-parse option-optnum
no cable dhcp-parse option-optnum
Syntax Description -optnum Specifies the DHCP option. Valid values are 43 and 60.
Command Default The CMTS does not parse the specified DHCP options.‘
Command Modes Cable interface configuration (config-if)
Command History Release Modification
12.3(21)BC This command was introduced.
Usage Guidelines To determine specific device and system information, configure cable dhcp-parse option-43 command
on the CMTS. The CMTS parses option-43 of the CPE DHCP message to determine the device and
system information of the CPE.
To determine the CPE device type, configure cable dhcp-parse option-60 command on the CMTS. The
CMTS parses option-60 of the CPE DHCP message to determine the device type of the CPE.
Examples The following example shows DHCP option 43 enabled on the CMTS:
Router(config-if)# cable dhcp-parse option-43
Router(config-if)#
Related Commands Command Description
cable helper address Specifies a destination IP address for User Datagram Protocol (UDP)
broadcast Dynamic Host Configuration Protocol (DHCP) packets.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-117
Cable Commands: cable d
cable divert-rate-limit
cable divert-rate-limit
To set Cable-side DRL rate and limit, use the cable divert-rate-limit command in interface
configuration mode. To reset the rate and limit to the default values, use the no form of this command.
cable divert-rate-limit rate rate limit limit
no cable divert-rate-limit
Syntax Description rate Specifies the divert rate in packets per second. Minimum rate is 1 packet per
second. Maximum rate is 65535 packets per second. The default rate is 2000
packets per second.
limit Specifies the number of packets to be diverted in an initial burst of packets.
Minimum limit is 4 packets. Maximum limit is 4194 packets. The default
limit is 2000 packets.
Command Default The default DRL configuration for every physical cable interface is 2000 packets per second and the
default limit is 2000 packets
Command Modes Interface configuration—cable interface only (config-if)
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines Cable-side DRL is configured on the physical cable interface. It cannot be configured on a cable bundle
interface.
Examples The following example shows how to configure the rate and limit values for a cable interface.:
Router(config-if)# cable divert-rate-limit rate 1 limit 4
Related Commands Command Description
service This command configures DRL rate and limit for WAN-side IP packet
divert-rate-limit ip streams.
service This command configures DRL for WAN-side non-IP packet streams.
divert-rate-limit
non-ip
Cisco IOS CMTS Cable Command Reference
CBL-118 OL-15510-15
Cable Commands: cable d
cable docsis30-voice downstream req-attr-mask
cable docsis30-voice downstream req-attr-mask
To configure downstream DOCSIS 3.0 QoS parameters of the required attribute-mask and forbidden
attribute-mask number for all DS voice flows, use the cable docsis30-voice downstream req-attr-mask
command in global configuration mode. To disable the required attribute-mask and forbidden
attribute-mask number, use the no form of this command.
cable docsis30-voice downstream req-attr-mask req-attr-mask forb-attr-mask forb-attr-mask
no cable docsis30-voice
Syntax Description req-attr-mask Specifies the required attribute-mask value.
Example: 0
It can also include HEX format.
Example:
cable docsis30-voice downstream req-attr-mask FF for-attr-mask
8000AAbb
forb-attr-mask Specifies the forbidden attribute-mask value.
Example: 80000000
Command Default The default config is req-attr-mask 0 forb-attr-mask 0. Use the no form of this command to return to
default. It will set the values for docsis30 voice downstream req-attr-mask and forb-attr-mask to 0.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines This command is used to configure docsis 3.0 voice related downstream service-flow attribute-mask
number.
Examples The following example shows how to configure the downstream attribute mask for the interface cable:
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# cable docsis30-voice downstream req-attr-mask ?
<0-FFFFFFFF> The attribute bitmap in hex
Router(config)# cable docsis30-voice downstream req-attr-mask aa00 ?
forb-attr-mask SF Forbidden Attribute Mask
Router(config)# cable docsis30-voice downstream req-attr-mask aa00 forb-attr-mask ?
<0-FFFFFFFF> The attribute bitmap in hex
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-119
Cable Commands: cable d
cable docsis30-voice downstream req-attr-mask
Router(config)# cable docsis30-voice downstream req-attr-mask aa00 forb-attr-mask bbcc
Router(config)# do show run | include docsis30
cable docsis30-voice downstream req-attr-mask AA00 forb-attr-mask BBCC
Router(config)# no cable docsis30-voice down
Router(config)# no cable docsis30-voice
Router(config)# do show run | include docsis30
Related Commands Command Description
cable downstream This command enables attribute-based forwarding which allows CMTS to
attribute-mask choose bonding group or individual channel for unicast and multicast
forwarding.
Cisco IOS CMTS Cable Command Reference
CBL-120 OL-15510-15
Cable Commands: cable d
cable dot1q-vc-map
cable dot1q-vc-map
To map a cable modem to a particular Virtual Local Area Network (VLAN) on a local outbound Ethernet
interface, use the cable dot1q-vc-map command in global configuration mode. To remove this mapping,
or to remove a particular customer’s name from the internal tables, use the no form of this command.
cable dot1q-vc-map mac-address ethernet-interface vlan-id [cust-name]
no cable dot1q-vc-map mac-address
no cable dot1q-vc-map customer cust-name
Syntax Description mac-address Specifies the hardware (MAC) address for the cable modem whose traffic
is to be mapped.
ethernet-interface Specifies the outbound interface to which this cable modem should be
mapped. On the Cisco uBR7100 series and Cisco uBR7246VXR routers,
you can specify an Ethernet, Fast Ethernet, or Gigabit Ethernet interface,
depending on what interfaces are actually installed in the chassis.
vlan-id Specifies the ID for the IEEE 802.1Q Virtual Local Area Network (VLAN)
that should be used to tag the frames for this cable modem. The valid range
is 1 to 4095, with no default.
Note The switches acting as the bridge aggregators might support a lower
number of VLAN IDs. If so, the Cisco CMTS router should be
configured within the limits of the switches’ maximum number of
VLANs.
cust-name (Optional) Identifies the customer using this VLAN. The cust-name can be
any arbitrary alphanumeric string, up to 127 characters long.
customer cust-name (Optional) Deletes all VCs belong to this customer. The cust-name can be
any arbitrary alphanumeric string, up to 127 characters long.
Defaults No default behavior or values
Command Modes Global configuration (config)
Command History Release Modification
12.2(15)BC2 This command was introduced for Cisco uBR7246VXR universal
broadband routers.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
Support for the Cisco uBR7225VXR router was added.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-121
Cable Commands: cable d
cable dot1q-vc-map
Usage Guidelines This command maps a cable modem, on the basis of its hardware (MAC) address, to a particular
IEEE 802.1Q VLAN on a particular outbound Ethernet interface. This enables the cable modem’s traffic
to be part of a virtual LAN at the Layer-2 level.
Note To use this command, you must first enable the use of IEEE 802.1Q Layer 2 tunnels, using the cable
l2-vpn-service dot1q command. Then use this command to map individual cable modems to specific
VLANs.
Examples The following example shows how to enable the use of Layer 2 tunnels and then map specific CMs to
VLANs on a specific interface:
Router# config terminal
Router(config)# cable l2-vpn-service dot1q
Router(config)# cable dot1q-vc-map 000C.0e03.69f9 GigabitEthernet 1/0 4
Router(config)# cable dot1q-vc-map 0010.7bed.9c95 GigabitEthernet 1/0 5
Router(config)# exit
The following example shows the same command as above, but this time each VLAN is identified by
the customer that is using it:
Router# config terminal
Router(config)# cable l2-vpn-service dot1q
Router(config)# cable dot1q-vc-map 000C.0e03.69f9 GigabitEthernet 1/0 4 ENTERPRISE-CO1
Router(config)# cable dot1q-vc-map 0010.7bed.9c95 GigabitEthernet 1/0 5 ENTERPRISE-CO2
Router(config)# exit
The following example shows how to remove the Layer 2 mapping for a specific cable modem. This
particular cable modem’s traffic is then routed using the normal Layer 3 routing processes.
Router# config terminal
Router(config)# no cable dot1q-vc-map 000C.0e03.69f9 GigabitEthernet 1/0 4
Router(config)# exit
Related Commands Command Description
cable l2-vpn-service Enables the use of Layer 2 tunnels so that traffic for individual cable
dot1q modems can be routed over a particular Virtual Local Area Network
(VLAN) on an Ethernet interface.
debug cable l2-vpn Displays debugging messages for the Layer 2 mapping of cable modems to
particular PVCs or VLANs.
show cable l2-vpn Displays the mapping of one or all cable modems to VLANs on the router’s
dot1q-vc-map Ethernet interfaces.
Cisco IOS CMTS Cable Command Reference
CBL-122 OL-15510-15
Cable Commands: cable d
cable downstream annex
cable downstream annex
To set the Motion Picture Experts Group (MPEG) framing format for a downstream port on a cable
interface line card to either Annex A (Europe) or Annex B (North America), use the cable downstream
annex command in cable interface configuration mode.
cable downstream annex {A | B}
Syntax Description A Annex A. The downstream uses the EuroDOCSIS J.112 standard.
B Annex B. The DOCSIS-compliant cable plants that support North American channel plans use ITU
J.83 Annex B downstream radio frequency.
Command Default Annex B for all Cisco cable interface cards other than the Cisco uBR-MC16E. Annex A, if using the
Cisco uBR-MC16E cable interface line card and the Cisco uBR7111E and Cisco uBR7114E universal
broadband routers.
Command Modes Interface configuration—cable interface only (config-if)
Command History Release Modification
12.1(1a)T1 This command was introduced.
12.0(7)T, 12.1(1a)T1, 12.1 Support for Annex A was introduced for the Cisco uBR-MC16E
mainline, 12.0(8)SC, 12.1(2)EC1 cable interface line card.
12.1(7)EC Support for Annex A was added for the Cisco uBR7111E and
Cisco uBR7114E universal broadband routers.
12.2(15)CX Support was added for both Annex A and Annex B on the
Cisco uBR-MC16U/X and Cisco uBR-MC28U/X cable
interface line cards.
12.2(15)BC2 Support was added for both Annex A and Annex B on the
Cisco uBR-MC5X20U/S cable interface line cards.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release
12.2(33)SCA. Support for the Cisco uBR7225VXR router was
added.
Usage Guidelines The MPEG framing format must be compatible with the downstream symbol rate you set. Annex B is
the North America (DOCSIS) standard and Annex A is the European (EuroDOCSIS) standard. You
should review your local standards and specifications for downstream MPEG framing to determine
which format you should use.
The Cisco uBR-MC16U/X, Cisco uBR-MC28U/X, and Cisco uBR-MC5X20U cable interface line cards
support both Annex A and Annex B operation. However, on the Cisco uBR-MC28U/X, both
downstreams must be configured for the same mode (either both Annex A or both Annex B).
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-123
Cable Commands: cable d
cable downstream annex
On the Cisco uBR-MC16U and Cisco uBR-MC28U (with integrated upconverter), the IF frequency is
fixed at 44 MHz for both Annex A and Annex B modes of operation. On the Cisco uBR-MC16X and
Cisco uBR-MC28X (without integrated upconverter), the IF frequency is set to 36.125 MHz in Annex
A mode and 44 MHz in Annex B mode.
Note This command can be used to change the symbol rate, alpha, and other parameters for compliance with
EuroDOCSIS (annex A), or DOCSIS (annex B). Annex A is not supported on the Cisco uBR-MC1xC,
Cisco uBR-MC16B, Cisco uBR-MC16S, and Cisco uBR-MC28C cable interface line cards. Annex B is
not supported on the Cisco uBR-MC16E card and on the Cisco uBR7111E and Cisco uBR7114E
universal broadband routers.
Note The cable interface line card downstream ports and the CMs on the HFC network connected through
these ports must be set to the same MPEG framing format.
Caution In Cisco IOS Release 12.1, only Annex B MPEG framing format is supported.
Tip Changing the MPEG framing format affects the PHY layer on the downstream and disconnects all online
CMs. For this reason, if you are using N+1 HCCP redundancy, you should configure this command on
both the Protect and Working interfaces, so that the PHY layer is properly configured before a
switchover occurs. Otherwise, online CMs could be disconnected when a switchover occurs. (This also
applies to the cable downstream modulation and cable downstream interleave-depth commands.)
Examples The following example shows how to set the MPEG framing format to Annex A:
Router# configure terminal
Router(config)# interface cable 1/0
Router(config-if)# cable downstream annex A
The following example shows how to set the MPEG framing format to Annex B:
Router# configure terminal
Router(config)# interface cable 4/0
Router(config-if)# cable downstream annex B
Related Commands Command Description
show controllers cable Displays the downstream MPEG framing format (Annex A or Annex B)
setting.
Cisco IOS CMTS Cable Command Reference
CBL-124 OL-15510-15
Cable Commands: cable d
cable downstream attribute-mask
cable downstream attribute-mask
To configure an attribute for a cable interface or a wideband cable interface, use the cable downstream
attribute-mask command in interface configuration mode. To disable this configuration, use the no
form of this command.
cable downstream attribute-mask mask
no cable downstream attribute-mask mask
Syntax Description mask Specifies the mask value for the interface.
Command Default If this command is not used, the default attribute will be used for the cable interface and the wideband
cable interface. The default attribute for the wideband cable interface is 0x80000000 (31-bit) and for the
cable interface is zero. For a wideband cable interface, 31-bit mask is always set to 1.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines The attribute-mask comprises 32 attributes and each attribute represents a single bit in the mask. You
can configure a provisioned attribute mask for each channel and provisioned bonding group to assign
values to the operator-defined binary attributes, or to override the default values of the
specification-defined attributes. The operator may configure, in the CM configuration file, a required
attribute mask and a forbidden attribute mask for a service flow. Additionally, in a CM-initiated dynamic
service request, the CM can include a required attribute mask and a forbidden attribute mask for a service
flow.
Examples The following example shows how to configure an attribute for a wideband cable interface:
Router# configure terminal
Router(config)# interface wideband-cable 1/0/0:0
Router(config-if)# cable downstream attribute-mask 800000ff
Related Commands Command Description
interface Specifies a wideband cable interface.
wideband-cable
interface cable Specifies a cable interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-125
Cable Commands: cable d
cable downstream channel-id
cable downstream channel-id
To configure the downstream channel ID, use the cable downstream channel-id command in cable
interface configuration mode. To set the downstream channel ID to its default value, use the no form of
this command.
cable downstream channel-id id
no cable downstream channel-id
Syntax Description id Specifies a downstream channel ID. Valid values for releases prior to Cisco IOS Release
12.2(33)SCB are from 0 to 255 and the valid values for Cisco IOS Release 12.2(33)SCB and later
are from 1 to 255 as 0 is reserved for network management.
Command Default The unit number of the downstream device, starting with a value of 1.
Command Modes Interface configuration—cable interface only (config-if)
Command History Release Modification
12.0(5)T This command was introduced.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
12.2(33)SCB1 The downstream channel ID scheme was changed.
Usage Guidelines Use this command to make sure that each downstream channel has a unique ID when there are multiple
Cisco CMTS routers at a headend facility.
Cisco IOS assigns the default ID number of each downstream channel in the order in which devices
connected to the downstream channels appear to the CMTS router. The downstream channel connected
to the first device that appears to the CMTS router is configured with a default ID of 1, the downstream
channel connected to the second device that appears is configured with an ID of 2, and so on.
The local downstream channel channel ID is unique across all SPA channels. When you add a channel
to the MAC domain using the downstream modular-cable rf-channel command, the channel IDs in the
MAC domain are unique. This also facilitates channel ID uniqueness when the channels are added to a
fiber node.
Table 6 shows the 12.2(33)SCB1 downstream channel ID scheme and Table 7 shows the 12.3(23)BCx
scheme. This applies to rf-channel rf-port cable downstream channel-id channel-id command also.
Cisco IOS CMTS Cable Command Reference
CBL-126 OL-15510-15
Cable Commands: cable d
cable downstream channel-id
Table 6 Downstream Channel ID Scheme for 12.2(33)SCB1
8/1 8/0 7/1 7/0 6/1 6/0 5/1 5/0 slot 3 slot 1
SPA Bay 0 217-2 193-2
40 16
SPA Bay 1 217-2 193-2
40 16
SPA Bay 2 217-2 193-2
40 16
SPA Bay 3 217-2 193-2
40 16
5x20 DS /0 169 145 121 97 73 49 25 1
5x20 DS /1 173 149 125 101 77 53 29 5
5x20 DS /2 177 153 129 105 81 57 33 9
5x20 DS /3 181 157 133 109 85 61 37 13
5x20 DS /4 185 161 137 113 89 65 41 17
Table 7 Downstream Channel ID Scheme for 12.3(23)BCx
8/1 8/0 7/1 7/0 6/1 6/0 5/1 5/0 slot 3 slot 1
SPA Bay 0 24-47 24-47
SPA Bay 1 48-71 48-71
5x20 188-1 180-1 168-1 160-1 148-1 140-1 128-1 120-1
92 84 72 64 52 44 32 24
Caution Changing the downstream channel ID of an active channel automatically disconnects all connected CMs
and forces them to go offline and reregister with the CMTS router, as required by the DOCSIS
specifications.
Examples The following example shows how to configure the downstream channel on the cable interface line card
in slot 6 of a Cisco CMTS router with a channel ID of 44:
Router(config-if)# cable downstream channel-id 44
The following example shows how to restore the downstream channel ID configuration to the default
configuration:
Router(config-if)# cable downstream channel-id
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-127
Cable Commands: cable d
cable downstream-channel-id automatic
cable downstream-channel-id automatic
To automatically configure the downstream channel IDs, use the
cable downstream-channel-id automatic command in global configuration mode. To set the
downstream channel ID (DCID) to its default value, use the no form of this command.
cable downstream-channel-id automatic
no cable downstream-channel-id automatic
Syntax Description automatic Specifies an automatic assignment of the DCIDs by the Cisco CMTS.
Command Default No default behavior or values
Command Modes Global configuration mode—(config)
Command History Release Modification
12.2(33)SCE This command was introduced.
Usage Guidelines Use this command to automatically assign unique channel IDs for all downstream channels in a fiber
node. Automatic DCIDs are not assigned to downstreams that are not in any fiber node.
Examples This example shows how to automatically configure the downstream channel IDs:
Router(config)# cable downstream-channel-id automatic
Related Commands Command Description
show cable fibernode Displays channel ID information for downstreams in a fiber node.
Cisco IOS CMTS Cable Command Reference
CBL-128 OL-15510-15
Cable Commands: cable d
cable downstream dsg chan-list
cable downstream dsg chan-list
To associate an Advanced-mode DOCSIS Set-Top Gateway (A-DSG) channel list entry to a downstream
channel and include it in the Downstream Channel Descriptor (DCD) message on a Cisco CMTS router,
use the cable downstream dsg chan-list command in interface configuration mode. To remove the
configuration, use the no form of this command.
cable downstream dsg chan-list list-index
no cable downstream dsg chan-list list-index
Syntax Description list-index Alphanumeric list index identifier.
Command Default Channel lists are not defined by default.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.3(13a)BC This command was introduced to support A-DSG 1.1 on the Cisco uBR10012
and Cisco uBR7200 series routers.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for
the Cisco uBR7225VXR router was added.
Usage Guidelines Global configuration for A-DSG must be complete before configuring interface definitions.
Examples The following example shows configuration of inclusion of DSG channel list entries in DCD messages
on a downstream cable interface on a Cisco CMTS router:
interface Cable6/0
cable downstream dsg chan-list 2
Related Commands Command Description
cable downstream dsg Enables DCD messages to be sent on a downstream channel on a
dcd-enable Cisco CMTS router.
cable downstream dsg rule Defines and associates an A-DSG rule to a downstream channel
on a Cisco CMTS router.
cable downstream dsg timer Associates an A-DSG timer entry to a downstream channel and
includes the DCD message on a Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-129
Cable Commands: cable d
cable downstream dsg chan-list
Command Description
cable downstream dsg Associates A-DSG vendor parameters to a downstream and
vendor-param includes them in the DCD message on a Cisco CMTS router.
cable dsg chan-list Configures the A-DSG downstream channel list on a CMTS
router.
Cisco IOS CMTS Cable Command Reference
CBL-130 OL-15510-15
Cable Commands: cable d
cable downstream dsg dcd-enable
cable downstream dsg dcd-enable
To enable Downstream Channel Descriptor (DCD) messages to be sent on a downstream channel on a
Cisco CMTS router, use the cable downstream dsg dcd-enable command in interface configuration
mode. To disable DCD messages, use the no form of this command.
cable downstream dsg dcd-enable
no cable downstream dsg dcd-enable
Syntax Description This command has no arguments or keywords.
Command Default DCD messages are disabled.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.3(13a)BC This command was introduced to support A-DSG 1.1 on the Cisc uBR10012
router and Cisco uBR7200 series routers.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines Global configuration for Advanced-mode DOCSIS Set-top Gateway (A-DSG) must be complete before
configuring interface definitions. This command is used when there are no enabled rules or tunnels for
A-DSG on a Cisco CMTS router.
Examples The following example shows how to enable DCD messages on a downstream interface on a Cisco
CMTS router along with several other A-DSG interface configuration commands:
interface Cable6/0
cable downstream dsg dcd-enable
cable downstream dsg chan-list 2
cable downstream dsg timer 3
cable downstream dsg vendor-param 2
cable downstream dsg rule 1 priority 1 clients 1 tunnel 1
cable downstream dsg rule 1 vendor-param 1
cable downstream dsg rule 1 classifiers 1 5
cable downstream dsg rule 2 priority 1 clients 2 tunnel 2
Related Commands
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-131
Cable Commands: cable d
cable downstream dsg dcd-enable
Command Description
cable downstream dsg chan-list Associates the A-DSG channel list entry to a downstream
channel, to be included in the DCD message on a Cisco CMTS
router.
cable downstream dsg rule Defines and associates an A-DSG rule to a downstream channel
on a Cisco CMTS router.
cable downstream dsg timer Associates an A-DSG timer entry to a downstream channel and
includes the DCD message on a Cisco CMTS router.
cable downstream dsg Associates A-DSG vendor parameters to a downstream and
vendor-param includes them in the DCD message on a Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
CBL-132 OL-15510-15
Cable Commands: cable d
cable downstream dsg disable
cable downstream dsg disable
To exclude the primary capable interface from DOCSIS Set-Top Gateway DSG forwarding, use the
cable downstream dsg disable command in cable interface configuration mode. To remove the
configuration, use the no form of this command.
cable downstream dsg disable
no cable downstream dsg disable
Syntax Description This command has no arguments or keywords.
Command Default None
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCG This command was introduced.
Usage Guidelines When DSG is enabled on the MAC domain interface and DSG forwarding is disabled on the primary
capable interface, the Cisco CMTS router does not create multicast service flows on the primary capable
interface.
If DSG forwarding is already enabled on the primary capable interface, the Cisco CMTS router removes
multicast service flows from the interface.
Examples The following example shows how to disable A-DSG forwarding on a primary capable modular interface
on the Cisco CMTS router:
Router# configure terminal
Router(config)# interface modular-cable 1/0/0:0
Router(config-if)# cable downstream dsg disable
Router(config-if)# end
Associated Features The cable downstream dsg disable command is associated with the Advanced Mode DOCSIS Set-Top
Gateway 1.2 for the Cisco CMTS Routers feature.
Related Commands Command Description
cable dsg cfr Defines and enables A-DSG classifiers on the Cisco CMTS router.
show cable dsg cfr Displays DSG classifier details.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-133
Cable Commands: cable d
cable downstream dsg rule
cable downstream dsg rule
Note Effective with Cisco IOS Release 12.3(17a)BC2, the cable downstream dsg rule command is removed
from Cisco IOS software.
To define and associate an Advanced-mode DOCSIS Set-top Gateway (A-DSG) rule to the downstream
channel on a Cisco CMTS router, use the cable downstream dsg rule command in interface
configuration mode. To remove the DSG rule configuration, use the no form of this command.
cable downstream dsg rule rule-id [clients clnt-list-id tunnel tun-id | priority priority |
vendor-param vsif-grp-id | ucid ucid1 | [ucid1 ucid2...ucidn] | cfr cfr-index [cfr-index...] |
disable]
no cable downstream dsg rule rule-id [clients clnt-list-id tunnel tun-id | priority priority |
vendor-param vsif-grp-id | ucid ucid1 | [ucid1 ucid2...ucidn] | cfr cfr-index [cfr-index...] |
disable]
Syntax Description rule-id Defines the DSG rule identifier.
clients clnt-list-id Sets the DSG clients and associates the clients with the channel
list identifier for this DSG rule.
tunnel tun-id Sets the DSG tunnel to be associated with this rule, and defines
the DSG tunnel identifier.
priority priority Sets the priority of the DSG rule.
vendor-param vsif-grp-id Associates DSG vendor-specific parameters with the specified
DSG rule.
ucid ucid1 | [ucid1 ucid2...ucidn] Sets the upstream channel identifider for the DSG rule.
cfr cfr-index [cfr-index...] Sets the index for the classifier value associated with the DSG
rule.
disable Disables a DSG rule.
Command Default DSG rules are disabled by default when they are created.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.3(13a)BC This command was introduced to support A-DSG 1.1 on the
Cisco uBR10012 router and Cisco uBR7200 series routers.
12.3(17a)BC2 This command was removed.
Usage Guidelines Global configuration for A-DSG must be complete before configuring interface definitions.
Cisco IOS CMTS Cable Command Reference
CBL-134 OL-15510-15
Cable Commands: cable d
cable downstream dsg rule
Because rules are disabled when they are created, you must enable the configuration using the no cable
downstream dsg rule disable form of the command. To disable a DSG rule configuration, use the cable
downstream dsg rule disable form of this command.
You can associate DSG clients, vendor specific parameters, classifiers, DSG tunnel address, upstream
channel identifier range, and rule priority to a downstream channel. You can apply more than one rule
to a downstream channel. All configured rules that are enabled are included in the Downstream Channel
Descriptor (DCD) message.
Examples The following example shows configuration and association of DSG rules on a downstream cable
interface on a Cisco CMTS router, followed by an example of enabling the configured DSG rules:
interface Cable6/0
cable downstream dsg rule 1 clients 1 tunnel 1
cable downstream dsg rule 1 priority 1
cable downstream dsg rule 1 vendor-param 1
cable downstream dsg rule 1 classifiers 1 5
cable downstream dsg rule 2 clients 2 tunnel 2
cable downstream dsg rule 2 priority 1
!
! Enable the DSG rule configuration
!
no cable downstream dsg rule 1 disable
no cable downstream dsg rule 2 disable
The following example shows how to disable DSG rules that were previously enabled:
interface cable6/0
cable downstream dsg rule 1 disable
cable downstream dsg rule 2 disable
Related Commands Command Description
cable downstream dsg chan-list Associates an A-DSG channel list to a downstream channel on a
Cisco CMTS router.
cable downstream dsg Enables DCD messages to be sent on a downstream channel on a
dcd-enable Cisco CMTS router.
cable downstream dsg timer Associates an A-DSG timer entry to a downstream channel and
includes the DCD message on a Cisco CMTS router.
cable downstream dsg Associates A-DSG vendor parameters to a downstream and
vendor-param includes them in the DCD message on a Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-135
Cable Commands: cable d
cable downstream dsg tg
cable downstream dsg tg
To associate an Advanced-Mode DOCSIS Set-Top Gateway (A-DSG) tunnel group to a MAC domain
interface on a Cisco CMTS router, use the cable downstream dsg tg command in cable interface
configuration mode. To remove this association, use the no form of this command.
cable downstream dsg tg tgid [channel channel_ID | priority DSG-rule-priority [enable | disable]
| ucid ID1 [ID2 ID3 ID4] | vendor-param vendor-group-ID]
no cable downstream dsg tg tgid
Syntax Description dsg tg tgid Specifies the tunnel group ID. The valid range is from 1 to 65535.
channel channel_ID (Optional) Specifies the downstream channel ID. The valid range is from 1
to 65535.
priority (Optional) Specifies the DSG rule priority for the cable interface. The valid
DSG-rule-priority range is from 0 to 255.
enable (Optional) Enables the DSG rule priority on a DSG tunnel group.
disable (Optional) Disables the DSG rule priority on a DSG tunnel group.
ucid (Optional) Specifies the upstream channel ID (UCID). You can specify a
upstream-channel-ID maximum of four upstream channel IDs.
vendor-param (Optional) Specifies the vendor specific parameters group ID. The valid
vendor-group-ID range is from 1 to 65535.
Command Default The DSG traffic is not forwarded to the MAC domain.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCG This command was introduced.
Usage Guidelines If you do not specify a downstream channel ID using the channel keyword, the Cisco CMTS router
automatically assigns a free channel to associate the MAC domain interface with the DSG tunnel group.
This channel is created with default parameters.
If you specify the channel keyword in the no form of the command, only the MAC domain to DSG
tunnel group association is removed from the configuration. If the no form of the command is used
without the channel keyword, both the tunnel group association and the channel are removed.
Cisco IOS CMTS Cable Command Reference
CBL-136 OL-15510-15
Cable Commands: cable d
cable downstream dsg tg
Examples The following example shows how to associate an A-DSG tunnel group to a MAC domain interface on
a Cisco CMTS router:
Router(config)# interface cable 5/1/0
Router(config-if)# cable downstream dsg tg 1
Router(config-if)# cable downstream dsg tg 1 channel 22
Router(config-if)# cable downstream dsg tg 1 priority 2 enable
Router(config-if)# cable downstream dsg tg 1 ucid 1 2 3 4
Router(config-if)# cable downstream dsg tg 1 vendor-param 20
Associated Features The cable downstream dsg tg command is used to configure the Advanced Mode DOCSIS Set-Top
Gateway 1.2 for the Cisco CMTS Routers feature.
Related Commands Command Description
cable downstream dsg Excludes the primary capable interface from A-DSG forwarding.
disable
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-137
Cable Commands: cable d
cable downstream dsg tg channel
cable downstream dsg tg channel
To associate an Advanced-mode DOCSIS Set-Top Gateway (A-DSG) tunnel group to a downstream
interface on a Cisco CMTS router, use the cable downstream dsg tg channel command in interface
configuration mode. To remove this configuration, use the no form of this command.
cable downstream dsg tg group-id channel channel-id
no cable downstream dsg tg group-id channel channel-id
Syntax Description group-id Specifies the A-DSG tunnel group identifier as a number from 1 to
65535.
channel-id Specifies the downstream channel identifier as a number from 1 to
65535.
Command Default The A-DSG tunnel group is not associated to a downstream interface.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.3(17a)BC2 This command was introduced to support A-DSG 1.2 on the
Cisco uBR10012 router and Cisco uBR7200 series routers.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines The cable dsg tg channel global configuration command establishes the configuration of tunnels in a
tunnel group. Tunnel groups are enabled by default.
Then, you can associate the tunnel group to a downstream cable interface using the cable downstream
dsg tg channel interface configuration command.
Examples The following example shows the configuration and activation of a tunnel group with ID of 1 and
channel ID of 2 in global configuration, followed by association of the tunnel group to a downstream
interface on a Cisco CMTS router:
cable dsg tg 1 channel 2
interface cable 8/1/2
cable downstream dsg tg 1 channel 2
Related Commands
Cisco IOS CMTS Cable Command Reference
CBL-138 OL-15510-15
Cable Commands: cable d
cable downstream dsg tg channel
Command Description
cable downstream dsg chan-list Associates an A-DSG channel list entry to a downstream channel
and includes it in the DCD message on a Cisco CMTS router.
cable downstream dsg Enables DCD messages to be sent on a downstream channel on a
dcd-enable Cisco CMTS router.
cable downstream dsg timer Associates an A-DSG timer entry to a downstream channel and
includes the DCD message on a Cisco CMTS router.
cable downstream dsg Associates A-DSG vendor parameters to a downstream and
vendor-param includes them in the DCD message on a Cisco CMTS router.
cable dsg tunnel Associates a group of A-DSG tunnels to one or more downstream
interfaces on a Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-139
Cable Commands: cable d
cable downstream dsg timer
cable downstream dsg timer
To associate an Advanced-mode DOCSIS Set-Top Gateway (A-DSG) timer entry to a downstream
channel and include it in the Downstream Channel Descriptor (DCD) message on a Cisco CMTS router,
use the cable downstream dsg timer command in interface configuration mode. To remove this setting,
use the no form of this command.
cable downstream dsg timer timer-index
no cable downstream dsg timer timer-index
Syntax Description timer-index Identifier for the DSG timer setting in the index.
Command Default The downstream DSG timer is not configured by default.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.3(13a)BC This command was introduced to support A-DSG 1.1 on the
Cisco uBR10012 router and Cisco uBR7200 series routers.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines Global configuration for A-DSG must be complete before configuring interface definitions.
Examples The following example shows the configuration DSG timers for inclusion in DCD messages on a
downstream cable interface on a Cisco CMTS router:
interface Cable6/0
cable downstream dsg timer 3
Related Commands Command Description
cable downstream dsg chan-list Associates an A-DSG channel list entry to a downstream channel
and include it in the DCD message on a Cisco CMTS router.
cable downstream dsg Enables DCD messages to be sent on a downstream channel on a
dcd-enable Cisco CMTS router.
cable downstream dsg rule Defines and associates an A-DSG rule to a downstream channel
on a Cisco CMTS router.
cable downstream dsg Associates A-DSG vendor parameters to a downstream and
vendor-param includes them in the DCD message on a Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
CBL-140 OL-15510-15
Cable Commands: cable d
cable downstream dsg vendor-param
cable downstream dsg vendor-param
To associate Advanced-mode DOCSIS Set-Top Gateway (A-DSG) vendor parameters to a downstream,
to be included in the Downstream Channel Descriptor (DCD) message on a Cisco CMTS router, use the
cable downstream dsg vendor-param command in interface configuration mode. To remove this
configuration from a Cisco CMTS router, use the no form of this command.
cable downstream dsg vendor-param vsif-grp-id
no cable downstream dsg vendor-param vsif-grp-id
Syntax Description vsif-grp-id Associates a vendor parameter with a group identifier.
Command Default This command is not configured by default.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.3(13a)BC This command was introduced to support A-DSG 1.1 on the
Cisco uBR10012 router and Cisco uBR7200 series routers.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines Global configuration for A-DSG must be complete before configuring interface definitions.
Examples The following example shows configuration of A-DSG vendor parameters on a downstream interfac,
along with several other downstream interface commands on a Cisco CMTS router:
interface Cable6/0
cable downstream dsg dcd-enable
cable downstream dsg chan-list 2
cable downstream dsg timer 3
cable downstream dsg vendor-param 2
cable downstream dsg rule 1 priority 1 clients 1 tunnel 1
cable downstream dsg rule 1 vendor-param 1
cable downstream dsg rule 1 classifiers 1 5
cable downstream dsg rule 2 priority 1 clients 2 tunnel 2
Related Commands Command Description
cable downstream dsg chan-list Associates an A-DSG channel list entry to a downstream channel
and include it in the DCD message on a Cisco CMTS router.
cable downstream dsg Enables DCD messages to be sent on a downstream channel on a
dcd-enable Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-141
Cable Commands: cable d
cable downstream dsg vendor-param
Command Description
cable downstream dsg rule Defines and associates an A-DSG rule to a downstream channel
on a Cisco CMTS router.
cable downstream dsg timer Associates an A-DSG timer entry to a downstream channel and
includes the DCD message on a Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
CBL-142 OL-15510-15
Cable Commands: cable d
cable downstream frequency
cable downstream frequency
To note the downstream center frequency for the cable interface line card to reflect the digital carrier
frequency of the downstream radio frequency carrier (the channel) for that downstream port, use the
cable downstream frequency command in cable interface configuration mode. On cable interfaces with
an integrated upconverter, to unset the downstream frequency and to disable the RF output from the
integrated upconverter, use the no form of this command.
cable downstream frequency down-freq-hz
no cable downstream frequency
Syntax Description down-freq-hz The known center frequency of the downstream carrier in Hz (the valid range is
55,000,000 to 858,000,000). The usable range depends on whether the downstream is
configured for DOCSIS or EuroDOCSIS operations:
• DOCSIS = 88,000,000 to 855,000,000 MHz
• Extended frequency range = 70,000,000 to 855,000,000 MHz
• EuroDOCIS = 112,000,000 to 858,000,000 MHz
The Cisco IOS supports a superset of these standards, and setting a center frequency to
a value outside these limits violates the DOCSIS or EuroDOCSIS standards. Cisco does
not guarantee the conformance of the downstream and upconverter outputs when using
frequencies outside the DOCSIS or EuroDOCSIS standards.
Command Default Disabled. On the Cisco uBR7100 series routers, the default downstream center frequency for the
integrated upconverter is 500 MHz.
Command Modes Interface configuration—cable interface only (config-if)
Command History Release Modification
11.3 XA This command was introduced to support NTSC/DOCSIS Annex B RF
operation.
12.0(7)XR2, 12.0(8)SC Modified to support PAL/SECAM EuroDOCSIS RF operation.
12.1(2)EC1 Supports both Annex A and Annex B.
12.1(5)EC1 Modified to support the integrated upconverter on the Cisco uBR7100 series
universal broadband router.
12.2(11)CY, Support was added for the Cisco uBR-MC5X20S cable interface line card.
12.2(11)BC3
12.2(15)CX Support was added for the Cisco uBR-MC16U/X and Cisco uBR-MC28U/X
cable interface line cards.
12.2(15)BC2 Support was added for the extended frequency range and for the
Cisco uBR-MC5X20U cable interface line card. In addition, the command
was changed to accept only center frequencies in 250 KHz increments
(previously, the command allowed 125 KHz increments).
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-143
Cable Commands: cable d
cable downstream frequency
Release Modification
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines This command is either optional or required, depending on the cable interface line card being used.
• On the Cisco uBR7100 series routers using the integrated upconverter (the DS0 RF output), and on
cable interfaces that support integrated upconverters (such as the Cisco uBR-MC16U,
Cisco uBR-MC28U, and Cisco uBR-MC5X20U), this command configures the frequency for the
integrated upconverter. The no form of this command unsets the frequency and disables the output
from the integrated upconverter.
• For cable interfaces that use an external upconverter (such as the Cisco uBR-MC16S and the DS0
(IF) output on Cisco uBR7100 series routers), this command is informational-only, because it does
not affect the external upconverter. The external upconverter must be programmed separately with
the appropriate center frequency.
Note The no form of this command is supported only on the Cisco uBR-MC16U/X, Cisco uBR-MC28U/X,
and Cisco uBR-MC5X20S/U cable interface line cards, and on the Cisco uBR7100 series universal
broadband router.
Note We recommend configuring this command on all cable interfaces, even those that are using external
upconverters. This is because this command is required to enable the downstream frequency override
feature and for N+1 line card redundant operation when using SNMP-capable external upconverters.
The downstream frequency of your RF output must be set to match the expected input frequency of your
upconverter. To do this, you enter the fixed center frequency of the downstream channel for the
downstream port. (You can also select a default that does not set a specific fixed value.) The valid range
for a fixed center frequency is 54,000,000 to 858,000,000 Hz. The center frequency is also used to
configure an IF-to-RF upconverter that must be installed in your downstream path.
The digital carrier frequency is specified to be the center of a 6.0 MHz channel. For example, EIA
channel 95 spans 90.000 to 96.000 MHz. The center frequency is 93.000 MHz, which is the digital
carrier frequency that should be configured as the downstream frequency. The typical range for current
CATV headends is 88,000,000 to 860,000,000 Hz.
In Cisco IOS software releases before Cisco IOS Release 12.2(15)BC2, the cable downstream
frequency command allowed the center frequency to be specified in 125 KHz increments. In Cisco IOS
Release 12.2(15)BC2 and later releases, this was changed to allow only 250 KHz increments, because
of the requirements of the Broadband Processing Engine cable interface line cards that use an internal
upconverter (Cisco uBR-MC16U, Cisco uBR-MC28U, and Cisco uBR-MC5X20S/U).
Note DOCSIS allows downstreams to use any center frequency within 88,000,000 to 855,000,000 MHz.
However, when most cable modems first come online, they initially start scanning the downstream for
the frequencies that are in the NTSC channel plan. If a valid downstream is not found among those
frequencies, the cable modems then beginning scanning the remaining frequencies. For the fastest and
most efficient registration times, we recommend configuring downstreams for the frequencies that are
specified in the NTSC channel plan.
Cisco IOS CMTS Cable Command Reference
CBL-144 OL-15510-15
Cable Commands: cable d
cable downstream frequency
Examples The following example shows how to set the downstream center frequency display value:
Router(config)# interface c6/0
Router(config-if)# cable downstream frequency 96000000
Related Commands Command Description
cable downstream annex Sets the MPEG framing format for a downstream port on a cable
interface line card to either Annex A (Europe) or Annex B (North
America).
cable downstream rf-power Configures the desired RF output power on the integrated
upconverter.
cable downstream rf-shutdown Enables or disables the RF output from the integrated upconverter.
show controllers cable Displays status and configuration information for the cable
interface. On supported cable interfaces, this includes information
about the integrated upconverter.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-145
Cable Commands: cable d
cable downstream if-output
cable downstream if-output
To activate a downstream port on a cable interface and to generate either a standard modulated signal or
a test signal, use the cable downstream if-output command in cable interface configuration mode. To
disable all signal output on the intermediate frequency (IF) carrier and to shut down the interface, use
the no form of this command.
cable downstream if-output [continuous-wave | prbs]
no cable downstream if-output
Syntax Description continuous-wave Outputs an unmodulated carrier signal on the downstream, shutting down normal
data network operations.
prbs Outputs a Pseudo Random Bit Stream (PRBS) test signal on the downstream,
shutting down normal data network operations.
Command Default The downstream interface is enabled for normal data use (cable downstream if-output).
Command Modes Interface configuration—cable interface only (config-if)
Command History Release Modification
11.3 XA This command was introduced.
12.0(7)XR2, This command was modified to support Annex A (EuroDOCSIS) downstreams,
12.0(7)T, and the continuous-wave and prbs options were added.
12.(0)SC,12.1(2)EC1
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines Typically, a downstream is configured to output a modulated signal, using the cable downstream
if-output command, allowing data transmissions to be sent over the HFC cable network. However, this
command can also be used to test the cable plant or to shut down the interface completely:
• cable downstream if-output continuous-wave—Generates an unmodulated, continuous sine wave
on the downstream interface. You can use a spectrum analyzer to verify the frequency, amplitude,
and power of the wave. The test signal continues on the downstream until you resume normal
modulated operations using the cable downstream if-output command.
• cable downstream if-output prbs—Generates a PRBS test signal on the downstream interface.
You can use a spectrum analyzer to verify the frequency, amplitude, and power of the wave. The
test signal continues on the downstream until you resume normal modulated operations using the
cable downstream if-output command.
Cisco IOS CMTS Cable Command Reference
CBL-146 OL-15510-15
Cable Commands: cable d
cable downstream if-output
• no cable downstream if-output—Terminates all signal output and shuts down the downstream
interface. The interface remains shut down until you reactive the downstream using the cable
downstream if-output command.
Note Generating a PRBS or continuous-wave test signal or shutting down the interface automatically stops
the modulated carrier data signal and disconnects all CMs on that downstream. These commands should
not be used on a live network except as part of troubleshooting major network problems.
Examples The following example shows how to enable downstream port 0 on a cable interface:
Router# configure terminal
Router# interface c6/0
Router(config-if)# cable downstream if-output
The following example shows a PRBS test signal being generated on a downstream for a period of time.
The downstream is then shut down so that the test engineer can verify that no signal is being sent on the
downstream. After the tests have been run, the downstream is reactivated for normal modulated data use:
Router# configure terminal
Router# interface c6/0
Router(config-if)# cable downstream if-output prbs
(the signals are verified by a spectrum analyzer...)
Router#(config-if)# no cable downstream if-output
(the downstream is checked to verify no signals are being sent on it...)
Router#(config-if)# cable downstream if-output
Router#(config-if)# exit
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-147
Cable Commands: cable d
cable downstream interleave-depth
cable downstream interleave-depth
To set the downstream interleave depth, use the cable downstream interleave-depth command in cable
interface configuration mode. To restore the default setting, use the no form of this command.
cable downstream interleave-depth {8 | 16 | 32 | 64 | 128}
no cable downstream interleave-depth
Syntax Description 8 | 16 | 32 | 64 | 128 Indicates the downstream interleave depth in number of rows of codewords.
Command Default 32
Command Modes Interface configuration—cable interface only (config-if)
Command History Release Modification
11.3 XA This command was introduced.
12.0(7)XR2, This command was modified to support Annex A operation (which uses a fixed
12.(0)SC,12.1(2)EC1 interleave).
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines
Note This command is not supported on the Cisco uBR-MC16E cable interface line card or on the
Cisco uBR7111E and Cisco uBR7114E universal broadband routers, because the interleave on the
EuroDOCSIS downstream is fixed.
This command sets the minimum latency of the system. A higher interleave depth provides more
protection from bursts of noise on the HFC network by spreading out the bits for each codeword over a
greater transmission time.
Interleave transmissions do not transmit each codeword by itself, but instead send bits from multiple
codewords at the same time, so that a noise burst affects the minimum number of bits per codeword,
which allows the Forward Error Correction (FEC) algorithm a greater chance of detecting and correcting
any transmission errors.
A higher interleave depth transmits bits from a greater number of codewords, increasing the efficacy of
the FEC algorithm. However, a higher depth also increases downstream latency, which might slow
TCP/IP throughput for some configurations, so you need to choose an interleave depth that is appropriate
both for your plant’s noise levels and application needs.
Cisco IOS CMTS Cable Command Reference
CBL-148 OL-15510-15
Cable Commands: cable d
cable downstream interleave-depth
If your cable plant is experiencing high noise levels, consider increasing the interleave from the default
of 32 to 64. For plants with exceptionally high noise levels, increase the interleave to 128 to provide the
maximum protection from noise bursts.
Low interleave depth values typically cause some packet loss on typical HFC networks, because burst noise
lasts beyond the error correction block correctable length. However, on cable plants with exceptionally low
noise levels, Cisco recommends initially using the default value of 32, and then trying an interleave of either
16 or 8 to see if this increases performance without increasing the number of errors that result from noise.
Table 8 shows interleave characteristics and their relation to each other.
Table 8 DOCSIS Downstream Cable Interleave Descriptions
Burst Protection Latency
I (Number of Taps) J (Increment) 64-QAM/256 QAM 64-QAM/256 QAM
8 16 5.9 microseconds/4.1 milliseconds 0.22 ms/0.15 ms
16 8 12 microseconds/8.2 milliseconds 0.48 ms/0.33 ms
32 4 24 microseconds/16 milliseconds 0.98 ms/0.68 ms
64 2 47 microseconds/33 milliseconds 2.0 ms/1.4 ms
128 1 95 microseconds/66 milliseconds 4.0 ms/2.8 ms
Note Table 8 does not apply to EuroDOCSIS cable plants because the interleave depth for EuroDOCSIS cable
interfaces is fixed.
Tip Changing the interleave depth affects the PHY layer on the downstream and disconnects all online CMs.
For this reason, if you are using N+1 HCCP redundancy, you should configure this command on both
the Protect and Working interfaces, so that the PHY layer is properly configured before a switchover
occurs. Otherwise, online CMs could be disconnected when a switchover occurs. (This also applies to
the cable downstream annex and cable downstream modulation commands.)
Examples The following example shows how to configure the downstream interleave depth to 128 microseconds:
Router# configure terminal
Router(config)# interface cable 3/0
Router(config-if)# cable downstream interleave-depth 128
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-149
Cable Commands: cable d
cable downstream modulation
cable downstream modulation
To set the modulation format for a downstream port on a cable interface line card, use the cable
downstream modulation command in cable interface configuration mode.
cable downstream modulation {64qam | 256qam}
Syntax Description 64qam Modulation rate is 6 bits per downstream symbol.
256qam Modulation rate is 8 bits per downstream symbol.
Command Default 64qam
Command Modes Interface configuration—cable interface only (config-if)
Command History Release Modification
11.3 XA This command was introduced.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
Usage Guidelines Downstream modulation defines the speed in bits per second at which data travels downstream to the
subscriber’s CM. A symbol is the basic unit of modulation. QPSK encodes 2 bits per symbol, 16-QAM
encodes 4 bits per symbol, 64-QAM encodes 6 bits per symbol, and 256-QAM encodes 8 bits per
symbol.
Note Setting a downstream modulation format of 256-QAM requires approximately a 6-dB higher
signal-to-noise ratio (SNR) than 64-QAM at the subscriber’s cable modem. If your network is marginal
or unreliable at 256-QAM, use the 64-QAM format instead.
Tip Changing the modulation format affects the PHY layer on the downstream and disconnects all online
CMs. For this reason, if you are using N+1 HCCP redundancy, you should configure this command on
both the Protect and Working interfaces, so that the PHY layer is properly configured before a
switchover occurs. Otherwise, online CMs could be disconnected when a switchover occurs. (This also
applies to the cable downstream annex and cable downstream interleave-depth commands.)
Examples The following example shows how to set the downstream modulation to 256-QAM:
Router# configure terminal
Router(config)# interface cable 3/0
Router(config-if)# cable downstream modulation 256qam
Cisco IOS CMTS Cable Command Reference
CBL-150 OL-15510-15
Cable Commands: cable d
cable downstream override
cable downstream override
To enable cable downstream frequency override, use the cable downstream override command in cable
interface configuration mode. To disable the override feature, use the no form of this command.
cable downstream override
no cable downstream override
Syntax Description This command has no keywords or arguments.
Command Default Cable downstream frequency override is enabled by default.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.0(13)SC This command was introduced.
12.1(5)EC1 This command was integrated into Cisco IOS Release 12.1(5)EC1.
12.1(6) and 12.1(6)T This command was integrated into Cisco IOS Release 12.1(6) and Cisco IOS
Release 12.1(6)T.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for
the Cisco uBR7225VXR router was added.
Usage Guidelines This command is never needed for normal operations, because downstream frequency override is
enabled by default for DOCSIS operations. However, this command can be used to disable the frequency
override feature for test and lab use, so as to force the CMs on that interface to use a particular
downstream frequency, regardless of the signal quality.
Note Because frequency override is enabled by default, this command does not appear as part of a cable
interface’s configuration section in the Cisco CMTS router configuration file unless the no cable
downstream override command has been given.
Examples The following example shows how to disable the downstream frequency override feature on a particular
cable interface:
Router# configure terminal
Router(config)# interface cable 6/0
Router(config-if)# no cable downstream override
Router(config-if)# exit
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-151
Cable Commands: cable d
cable downstream qos wfq weight
cable downstream qos wfq weight
To specify custom DOCSIS priority to excess ratio mappings for downstream service flows, use the
cable downstream qos wfq weight command in cable interface configuration mode. Use the no form
of this command to revert to the default mappings.
cable downstream qos wfq weights weight1...weight8
no cable downstream qos wfq weights
Syntax Description weights weight Specifies the custom excess ratios for 8 priorites.
• weight1...weight8—Custom weight. Valid values range from 1 to 100.
Command Default DOCSIS priority to excess ratio mapping is used.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines This command configures custom DOCSIS priority to excess ratio mappings for downstream service
flows.
Examples The following example shows how to configure custom DOCSIS priority to excess ratio mappings for
downstream service flows:
Router# configure terminal
Router(config)# interface cable 8/0/0
Router(config-if)# cable downstream qos wfq weights 10 20 30 40 50 60 70 80
Related Commands Command Description
show cr10k-rp queue Displays the queue parameters associated with downstream service flow
queues (including the excess ratio).
show running-config Displays the configuration for the specified cable interface.
interface cable
Cisco IOS CMTS Cable Command Reference
CBL-152 OL-15510-15
Cable Commands: cable d
cable downstream rate-limit
cable downstream rate-limit
To enable DOCSIS rate limiting on downstream traffic, use the cable downstream rate-limit command
in cable interface configuration mode. To disable DOCSIS rate limiting on downstream traffic, use the
no form of this command.
cable downstream rate-limit [token-bucket [[shaping [granularity msec | max-delay msec]] |
weighted-discard] [exp-weight]
no cable downstream rate-limit
Syntax Description token-bucket (Optional) Specifies the token-bucket filter algorithm, which enforces an average
long-term transmission rate while permitting occasional bursts.
shaping (Optional in Release 12.1 EC, Required in Release 12.2 BC) Enables rate limiting
on the downstream port using the token-bucket policing algorithm with default
traffic shaping parameters.
granularity msec (Optional) Specifies traffic shaping granularity in milliseconds. Valid values are
1, 2, 4, 8, or 16 milliseconds.
max-delay msec (Optional) Specifies the maximum traffic-shaping buffering delay in milliseconds.
Valid values are 128, 256, 512, or 1028 milliseconds. As a general guideline, the
lower the downstream rates, the higher the delay should be to ensure full use of the
bandwidth.
weighted-discard (Optional) Specifies the weighted discard algorithm.
exp-weight (Optional) Specifies the weight for the exponential moving average of loss rate.
Valid values are from 1 to 4.
Command Default In Cisco IOS Release 12.1 EC and earlier releases, the system defaults to monitoring the traffic to and
from each CM over each 1-second period, and if the CM exceeds its bandwidth quota for that second,
the CMTS router drops packets for the rest of the second (no cable downstream rate-limit).
In Cisco IOS Release 12.2 BC and later releases, the token-bucket and shaping keywords are on by
default, and the max-delay option is set to 128 milliseconds (cable downstream rate-limit
token-bucket shaping max-delay 128).
Note In Cisco IOS Release 12.2 BC, do not use the cable downstream rate-limit token command without
specifying the shaping option, because this results in packet drops.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
11.3(6) NA This command was introduced.
12.0(4)XI, The shaping keyword was added.
12.0(5)T1,
12.1(1)EC1
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-153
Cable Commands: cable d
cable downstream rate-limit
Release Modification
12.2(4)BC1 Support was added to the 12.2 BC train, and the defaults were changed so that
the shaping keyword is on by default, to accommodate DOCSIS 1.1
requirements.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for
the Cisco uBR7225VXR router was added.
Usage Guidelines The cable downstream rate-limit command specifies the type of DOCSIS rate limiting that the CMTS
router imposes on downstream traffic that is sent to the CMs. When rate-limiting is enabled, traffic to
the CM is examined to ensure it will not exceed the limit set for the CM.
For DOCSIS networks, the best rate limiting algorithm combines the token-bucket and shaping to use
keywords, which is optimized for relatively steady data rates, such as are used for web browser, without
allowing the user to exceed the maximum allowable download rate that is specified in the DOCSIS
configuration file.
Note The token-bucket and shaping options are the default in Cisco IOS Release 12.2 BC and should not be
changed. If using a 64 kbps downstream rate, you can avoid a performance impact by turning off the
shaping option, but this is not recommended for DOCSIS 1.1 operation because it can result in erratic
traffic patterns and packet drops on the downstream.
If a packet would exceed the traffic limits for a CM, the CMTS router will buffer the packet, up to the
maximum delay time given by the max-delay option, so that the traffic can be sent at a later time when
it would not violate the maximum downstream traffic limits. If the packet is still too large, or if the
volume of traffic consistently exceeds the traffic limits, even after the delay, the CMTS router begins
dropping packets.
The default behavior of the cable downstream rate-limit command was changed in Cisco IOS
Release 12.2 BC to accommodate the different requirements of DOCSIS 1.1 operation (which requires
the use of the token-bucket rate-limiting algorithm). This default is optimized for downstream traffic
rates that are higher than 84 kbps.
If you are using a 64 kbps downstream traffic rate on a Cisco CMTS router that is running Cisco IOS
Release 12.2 BC, you should set the max-delay option to 256 milliseconds to avoid a performance
impact on TCP/IP traffic that uses packets larger than 1024 bytes (such as FTP or HTTP web traffic).
Alternatively, you can set the max-burst option on the cable service class command to 3044, which is
two packets of the minimum size for DOCSIS 1.1 networks.
Understanding the max-delay and granularity Options
The Cisco CMTS router uses a calendar-queuing system to process the packets being shaped. The
calendar queue is a time wheel that is as big as the value specified by the max-delay option (128, 256,
512, or 1028 milliseconds), and is divided into “buckets” of the size specified by the granularity option
(1, 2, 4, 8, or 16 milliseconds).
The number of buckets depends on both the max-delay and granularity options. For example, if the
max-delay option is set to 256 milliseconds, and the granularity option is set to 4 milliseconds, the
calendar queue contains 256/4, or 64, buckets, where a new bucket is processed every 4 milliseconds.
When the Cisco CMTS router adds a shaped packet to the queue, it adds the packet into the bucket that
corresponds to the deadline by which the packet must be processed. At the end of every granularity time
period, the Cisco CMTS router processes the packets that are in the corresponding bucket.
Cisco IOS CMTS Cable Command Reference
CBL-154 OL-15510-15
Cable Commands: cable d
cable downstream rate-limit
Decreasing the max-delay value increases how often the packets in the entire queue are processed, while
decreasing the granularity value increases the accuracy of the shaping mechanism. Decreasing these
values, however, could result in a possible increase in CPU processor usage. In most circumstances, this
increase in processor usage is negligible, but it should be monitored whenever fine-tuning the
max-delay or granularity values.
Tip For more information about the DOCSIS 1.1 rate-limiting specifications, see section C.2.2.5.2,
Maximum Sustained Traffic Rate, in the DOCSIS 1.1 specification.
Examples The following example shows how to apply the token-bucket filter algorithm on a Cisco uBR7200 series
router running Cisco IOS Release 12.1 EC:
Router(config)# interface cable 6/0
Router(config-if)# cable downstream rate-limit token-bucket
The following example shows how to apply the token-bucket filter algorithm on a Cisco uBR10012
router running Cisco IOS Release 12.2 BC:
Router(config)# interface cable 5/1/0
Router(config-if)# cable downstream rate-limit token-bucket shaping
The following example shows how to use token-bucket shaping with a max-delay of 256 milliseconds
on a Cisco uBR7100 series router:
Router(config)# interface cable 1/0
Router(config-if)# cable downstream rate-limit token-bucket shaping max-delay 256
Related Commands Command Description
cable service class Sets the parameters for a DOCSIS 1.1 cable service class.
cable upstream rate-limit Sets DOCSIS rate limiting for an upstream port on a cable interface line
card.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-155
Cable Commands: cable d
cable downstream rf-power
cable downstream rf-power
To set the RF power output level on an integrated upconverter on the Cisco uBR7100 series router,
Cisco uBR-MC16U, Cisco uBR-MC28U, or Cisco uBR10-MC5X20S/U cable interface line card, or
Cisco RF Gateway 10, use the cable downstream rf-power command in cable interface configuration
mode. To reset the RF output power level to its default value, use the no form of this command.
cable downstream rf-power {power-level | hccp-delta diff-pwr | hccp-override override-pwr}
no cable downstream rf-power {power-level | hccp-delta diff-pwr | hccp-override override-pwr}
Syntax Description power-level RF output power level in dBmV. The valid range is from 45 to
63 dBmV.
Note The official range for acceptable power levels in the DOCSIS
specification is 50 to 61 dBmV. Cisco cable interfaces exceed
the DOCSIS standard, but power levels outside the DOCSIS
standards should be used only in lab and test environments.
hccp-delta diff-pwr (Protect interfaces only) When using N+1 Hotstandby
Connection-to-Connection Protocol (HCCP) redundancy, the protect
interface adds the diff-pwr value to the current power value of the
working interface when a switchover occurs. This allows the router to
accommodate relative differences between the RF power levels in
working and protect interfaces. The valid value for diff-pwr ranges from
–12 to +12 dBmV.
hccp-override override-pwr (Protect interfaces only) When using N+1 HCCP redundancy, the
protect interface uses the override power value instead of the power
value of the working interface when a switchover occurs. This allows
the router to accommodate absolute differences between the RF power
levels in working and protect interfaces. The valid value for
override-pwr ranges from 45 to 63 dBmV.
Note The official range for acceptable power levels in the DOCSIS
specification is 50 to 61 dBmV. Cisco cable interfaces exceed
the DOCSIS standard, but power levels outside the DOCSIS
standards should be used only in lab and test environments.
Command Default 50 dBmV for the Cisco uBR7100 series router
55 dBmV for the Cisco uBR-MC5X20S cable interface line card on the Cisco uBR10012 router
55 dBmV for the Cisco uBR-MC16U and Cisco uBR-MC28U cable interface line cards
55 dBmV for the Cisco uBR10-MC5X20U-D cable interface line card on the Cisco uBR10012 router
Cisco RF Gateway10
The default values set are as follows for the different stacking levels:
1:1 stacking—44 dBmV
2:1 stacking—47 dBmV
4:1 stacking—40 dBmV
Cisco IOS CMTS Cable Command Reference
CBL-156 OL-15510-15
Cable Commands: cable d
cable downstream rf-power
Command Modes Interface configuration (config-if).
QAM interface and subinterface configuration (config-if and config-subif)
Command History Release Modification
12.1(5)EC1 This command was introduced to provide support on the integrated upconverter on the
Cisco uBR7100 series router.
12.2(11)CY, Support was added for the Cisco uBR10-MC5X20S cable interface line card on the
12.2(11)BC3 Cisco uBR10012 router.
12.2(15)CX Support was added for the Cisco uBR-MC16U and Cisco uBR-MC28U cable interface
line cards.
12.2(15)BC2 Support was added for the Cisco uBR-MC5X20U cable interface line card. Support was
also added for the hccp-delta and hccp-override options.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
12.2(44)SQ This command was integrated into Cisco IOS Release 12.2(44)SQ. Support for the
Cisco RF Gateway 10 was added. hccp-delta and hccp-override options are not
supported.
12.2(33)SCC4 Support for the following keywords was moved to the global redundancy configuration
mode:
• hccp-delta
• hccp-override
Usage Guidelines
Note In Cisco IOS Release 12.2(33)SCC4, the support for the hccp-delta and hccp-override keywords is
moved from the interface configuration mode to the global redundancy configuration mode. You can
now configure these keyword options using the member subslot command.
The hccp-delta and hccp-override options can be configured only on a protect interface (an interface
that has been configured with the hccp protect command). However, it is possible to manually edit a
configuration file on a TFTP server to include these options on a working interface configuration, and
then download that configuration to the router from the TFTP server.
If you manually edit the Cisco IOS configuration files, ensure that you specify these options only on
protect interfaces. If you specify the hccp-delta or hccp-override option on a working interface, the
router will modify the configured downstream power with the given power delta or override value.
Cisco RF Gateway 10
The stacking level on Cisco RFGW-10 are as follows:
1:1 stacking—30 dBmV ~ 61 dBmV, default is 44 dBmV
2:1 stacking—30 dBmV ~ 57 dBmV, default is 47 dBmV
4:1 stacking—30 dBmV ~ 53 dBmV, default is 40 dBmV
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-157
Cable Commands: cable d
cable downstream rf-power
The official range for acceptable power levels in the DOCSIS standard depends on the stacking level.
The DOCSIS levels are as follows:
1:1 stacking—52 dBmV ~ 60 dBmV
2:1 stacking—48 dBmV ~ 56 dBmV
4:1 stacking—44 dBmV ~ 52 dBmV
Note Cisco cable interfaces exceed the DOCSIS standard, but power levels outside the DOCSIS standards
should be used only in lab and test environments.
Executing port level commands such as cable downstream annex, cable downstream modulation,
cable downstream stacking, cable downstream frequency, and cable downstream rf-power at the
QAM channel level modifies all the QAM channels on that port.
Examples The following example shows how to configure the integrated upconverter on a Cisco uBR7100 series
router for an RF output power level of 45 dBmV:
Router(config)# cable interface 1/0
Router(config-if)# cable downstream rf-power 45
The following example shows how to configure the first integrated upconverter on a Cisco uBR10012
router for an RF output power level of 53 dBmV:
Router(config)# cable interface 5/1/0
Router(config-if)# cable downstream rf-power 53
The following commands shows how to configure the first integrated upconverter to the default power
level of 55 dBmV on the Cisco uBR10012 router:
Router(config)# cable interface 5/1/0
Router(config-if)# no cable downstream rf-power
Router(config-if)# exit
The following example shows how to configure a protect interface to add 3 dBmV to the current working
RF power level when a switchover occurs:
Router(config)# cable interface 6/0/0
Router(config-if)# cable downstream rf-power hccp-delta 3
Router(config-if)# exit
The following example shows how to configure a protect interface to use an RF power level of 48 dBmV
instead of the current working RF power level when a switchover occurs:
Router(config)# cable interface 6/0/0
Router(config-if)# cable downstream rf-power hccp-override 48
Router(config-if)# exit
Note The hccp-delta and hccp-override commands configure the power of the protect interface at the time
of the switchover. To display the RF power currently being used on a cable interface, use the show
controller cable command.
Cisco IOS CMTS Cable Command Reference
CBL-158 OL-15510-15
Cable Commands: cable d
cable downstream rf-power
Cisco RF Gateway 10
The following example shows how to configure the integrated upconverter on a Cisco RFGW-10 for an
RF output power level of 50 dBmV:
Router(config)# interface qam 3/1.1
Router(config-subif)# cable downstream rf-power 50
Related Commands Command Description
cable downstream frequency Configures the cable downstream center frequency on the integrated
upconverter.
cable downstream Enables or disables the RF output from the integrated upconverter.
rf-shutdown
debug cable upconverter Enables debugging of the internal upconverter operation.
show controllers cable Displays status and configuration information for the cable
interface, including the integrated upconverter, if present.
show controllers qam Displays cable downstream information configured on the QAM
channel and port.
show running-config interface Displays the running configuration of the QAM interface.
qam
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-159
Cable Commands: cable d
cable downstream rf-shutdown
cable downstream rf-shutdown
To disable the RF output from an integrated upconverter on the Cisco uBR7100 series router,
Cisco uBR-MC16U, Cisco uBR-MC28U or the Cisco uBR10-MC5X20S/U cable interface line card, use
the cable downstream rf-shutdown command in cable interface configuration mode. To enable the RF
output on the integrated upconverter, use the no form of this command.
cable downstream rf-shutdown
no cable downstream rf-shutdown
Syntax Description This command has no arguments or keywords.
Command Default RF output is disabled.
Command Modes Interface configuration—cable interface only (config-if)
Command History Release Modification
12.1(5)EC1 This command was introduced to provide support on the integrated
upconverter on the Cisco uBR7100 series router.
12.2(11)CY, Support was added for the Cisco uBR10-MC5X20S cable interface line card
12.2(11)BC3 on the Cisco uBR10012 router.
12.2(15)CX Support was added for the Cisco uBR-MC16U and Cisco uBR-MC28U cable
interface line cards.
12.2(15)BC2 Support was added for the Cisco uBR-MC5X20U cable interface line card.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines By default, the integrated upconverter on the Cisco uBR7100 series router, Cisco uBR-MC16U,
Cisco uBR-MC28U, and the Cisco uBR10-MC5X20S/U cable interface line cards is disabled, and the
downstream port does not output any signal. The no form of this command enables the integrated
upconverter, allowing it to output an RF signal through the downstream port.
However, before a valid DOCSIS downstream signal can be output, the following must also be done:
• A valid downstream RF frequency must be configured using the cable downstream frequency
cable interface command.
• The cable interface must be enabled using the no shutdown command on the cable interface.
Note This command does not affect the IF output from the DS0 downstream port on the Cisco uBR7100 series
router. The Cisco uBR10-MC5X20S/U, Cisco uBR-MC16U, and Cisco uBR-MC28U cable interface
line cards do not provide IF output for their downstream ports.
Cisco IOS CMTS Cable Command Reference
CBL-160 OL-15510-15
Cable Commands: cable d
cable downstream rf-shutdown
Examples The following example enables the integrated upconverter on the Cisco uBR7100 series router:
Router(config)# cable interface 1/0
Router(config-if)# no cable downstream rf-shutdown
The following example enables the second integrated upconverter on a Cisco uBR-MC5X20S cable
interface line card in the Cisco uBR10012 router:
Router(config)# cable interface 7/0/1
Router(config-if)# no cable downstream rf-shutdown
The following commands must also be given before the DS0 RF port can transmit a valid RF signal:
Router(config-if)# cable downstream frequency center-frequency
Router(config-if)# no shutdown
Router(config-if)# exit
router(config)#
Related Commands Command Description
cable downstream frequency Configures the downstream center frequency on the integrated
upconverter.
cable downstream rf-power Configures the desired RF output power on the integrated
upconverter.
debug cable upconverter Enables debugging of the internal upconverter operation.
show controllers cable Displays status and configuration information for the cable interface,
including information about the integrated upconverter, if present.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-161
Cable Commands: cable d
cable dsg
cable dsg
Note Effective with Cisco IOS Release 12.3(13a)BC, the cable dsg command is not available in Cisco IOS
software.
To enable the DOCSIS Set-Top Gateway (DSG) on a cable interface on a Cisco CMTS router, and to
configure its tunnel-mapping parameters, use the cable dsg command in interface or subinterface
configuration mode. To remove the DSG tunnel from the interface, use the no form of this command.
cable dsg tunnel-MAC-address group-ip-address CA-vendor-name
no cable dsg tunnel-MAC-address group-ip-address CA-vendor-name
Syntax Description tunnel-MAC-address Well-known MAC address for the DSG tunnel.
group-ip-address Multicast group IP address for the DSG stream.
CA-vendor-name Name for the Conditional Access (CA) vendor that owns the DSG
tunnel. This parameter is a string up to 7 characters in length and
should match the vendor of the CA server. A maximum of four vendors
per router are supported.
Command Default No DSG tunnels are defined.
Command Modes Interface (config-if) and subinterface configuration (config-subif) for cable interfaces only
Command History Release Modification
12.2(15)BC2 This command was introduced for the Cisco uBR7100 series and
Cisco uBR7246VXR routers.
12.3(9a)BC This command was introduced for the Cisco uBR10012 router.
12.3(13a)BC This command was removed.
Usage Guidelines This command enables DSG operations on the cable interface, creating a DSG tunnel that uses the
specified IGMP multicast address and well-known MAC address.
The tunnel-MAC-address could optionally be an Internet Group Management Protocol (IGMP) multicast
address, using the algorithm for converting host group IP address to an Ethernet MAC address that is
given in RFC 1112. If the MAC address is 0000.0000.0000, the DSG tunnel uses the algorithm given in
RFC 1112 to derive the multicast address for the tunnel as follows:
An IP host group address is mapped to an Ethernet multicast address by placing the low-order 23-bits of
the IP address into the low-order 23 bits of the Ethernet multicast address 01-00-5E-xx-xx-xx (hex).
Because there are 28 significant bits in an IP host group address, more than one host group address may
map to the same Ethernet multicast address.
Cisco IOS CMTS Cable Command Reference
CBL-162 OL-15510-15
Cable Commands: cable d
cable dsg
For example, if you specify the command cable dsg 0.0.0 228.9.9.9 AAA, the command uses the IGMP
IP address of 228.9.9.9 to generate the MAC address of 0100.5E09.0909 for the DSG tunnel. If the
IGMP address were 228.129.9.9, the resulting MAC address would be 0100.5E01.0909.
You can specify only Global Scope (224.0.1.0 through 238.255.255.255) and Administratively Scoped
(239.0.0.0 through 239.255.255.255) addresses. You cannot use Local Scope addresses (224.0.0.0
through 224.0.0.255).
Entering the cable dsg command also automatically configures the interface for the appropriate IGMP
static group, using the ip igmp static-group command. Do not manually enter another ip igmp
static-group command for this interface, because the system assumes that this IGMP configuration is
for a separate configuration that cannot be used by the DSG subsystem.
Note If any previously configured static groups exist on this interface, you should remove those other ip igmp
static-group commands on a cable interface before you can enter the cable dsg command. If you do not
remove those other groups, the cable dsg command displays a warning notifying you that you should
remove them.
The no cable dsg command automatically removes the IGMP static group from the interface by issuing
the no ip igmp static-group command. Do not manually remove this static group yourself.
In addition, you must have enabled Protocol Independent Multicast (PIM) on the cable interface, using
the ip pim interface configuration command, before enabling and configuring DSG operations. The
DOCSIS Set-Top Gateway feature supports the following PIM modes:
• ip pim sparse-mode command—Configures sparse mode of operation.
• ip pim sparse-dense-mode command—Configures the interface for either sparse mode or dense
mode of operation, depending on the mode in which the multicast group is operating.
• ip pim dense-mode command—Configures dense mode of operation.
Limitations and Restrictions
The DOCSIS Set-Top Gateway feature also has the following limitations:
• If using bundled interfaces, configure the DSG configurations only on the master interface, not on
the slave interfaces. However, when DSG has been properly configured on the master interface,
DSG traffic can flow across both the master and slave interfaces.
• If using subinterfaces, you must configure the DSG tunnels only on subinterfaces. When DSG
tunnels are configured on a subinterface, you cannot also configure the tunnels on the main
interface. If you configure DSG tunnels on both the main interface and subinterfaces, the main
interface can drop packets.
We also recommend putting all DSG configurations on the same, single subinterface. Although you
can configure DSG tunnels on multiple subinterfaces, this is not guaranteed to be supported in future
software releases.
• You can configure up to four separate Conditional Access (CA) vendors per router.
• You can configure a maximum of eight DSG tunnels (as identified by the well-known MAC address)
per CA vendor, for a maximum possible total of 32 DSG tunnels per router.
• Each CA vendor can have one or more DSG tunnels on each cable interface, but each DSG tunnel
must be using a separate IP multicast address.
• IP multicast routing should be enabled on the router, using the ip multicast-routing command.
• Multicast rate-limiting can be enabled optionally on a cable interface that is configured for DSG
operations, using the ip multicast rate-limit out group-list command.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-163
Cable Commands: cable d
cable dsg
• For best performance, fast switching of IP multicast should be enabled on incoming and outgoing
interfaces, using the ip mroute-cache command.
• You cannot use the same IP multicast groups for both DSG traffic and for other IP multicast traffic.
If an IP multicast group is being used for DSG traffic, do not use the ip igmp static-group command
to manually configure that same IP multicast group for other, non-DSG traffic.
• Different CA vendors cannot share IP multicast addresses. Each vendor must use a unique set of IP
multicast addresses, and after an IP multicast address is assigned to a DSG tunnel, that same address
cannot be used for any other purpose. However, all other multicast addresses and groups can still be
used on the interface for other multicast applications.
• DSG-related IP unicast traffic is not supported. The CMTS receives the unicast traffic from the DSG
network controllers, but it does not forward that traffic to the set-top boxes.
• DSG traffic should be less than 2.048 Mbps per vendor, so as to conform to the DSG specifications.
• DSG does not support Baseline Privacy Interface (BPI)-encrypted IP multicast streams.
Note In Cisco IOS Release 12.2(15)BC2, N+1 HCCP high availability redundancy does not preserve the DSG
traffic and configuration after a switchover. If you configure a cable interface for both N+1 HCCP
redundancy and for DSG operations, DSG traffic does not continue after a switchover.
Examples The following example shows how to configure a cable interface on a Cisco uBR7246VXR router to
enable the DSG feature on cable interface 3/0, using a well-known MAC address of 0001.0002.0003 and
a destination IP address of 225.2.3.4:
interface cable 3/0
ip pim dense-mode
ip multicast rate-limit out group-list 123 1024
cable dsg 1.2.3 225.2.3.4 CCC
Note The above configuration also automatically configures the interface with the appropriate ip igmp
static-group command (ip igmp static-group 225.3.4.5). This command will appear in the interface
configuration and should not be removed manually.
The following example shows the error message that appears if you specify a broadcast IP address that
has already been added to the router’s IGMP database. This entry typically would have been created
manually on the router or dynamically by a customer premise equipment (CPE) device that is attached
to a cable modem on the cable network.
interface cable 3/0
cable dsg 1.1.1 224.3.3.10 cisco
Multicast group 224.3.3.10 is already in use on the interface Cable3/0, please retry.
The following example shows how to delete a DSG tunnel on a cable interface:
interface cable 4/0
no cable dsg 0020.0020.0020 230.8.8.8 abc
4d17h: DSG: interface Cable5/0 left the igmp static group 230.8.8.8.
4d17h: DSG: tunnel 0020.0020.0020 is removed
4d17h: DSG: the specified DSG entry has been removed.
The following example shows the error message that appears when a unicast IP address is specified
instead of a multicast IP address:
Cisco IOS CMTS Cable Command Reference
CBL-164 OL-15510-15
Cable Commands: cable d
cable dsg
interface cable 4/0
cable dsg 1.1.1 192.168.13.10 cisco
Only multicast is supported for current version.
Related Commands Command Description
cable dsg keepalive Enables keepalive messages over DSG tunnels on all cable interfaces.
debug cable dsg Enables general, DCD, or packet-related debugging for DSG on a Cisco
CMTS router.
show cable dsg Displays the current DSG tunneling parameters.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-165
Cable Commands: cable d
cable dsg cfr
cable dsg cfr
To define and enable Advanced-Mode DOCSIS Set-Top Gateway (A-DSG) classifiers on a Cisco CMTS
router, use the cable dsg cfr command in global configuration mode. To remove one or more specified
A-DSG classifiers from a Cisco CMTS router, use the no form of this command. To disable one or more
specified A-DSG classifiers but retain their configuration, use the disable form of this command.
cable dsg cfr index [dest-ip {ipaddr | hostname}] [tunnel index] [dest-ports start end] [priority
priority] [src-ip {ipaddr | hostname} [src-prefix-len length]] [disable | enable] [in-dcd {yes |
no | ignore}]
no cable dsg cfr index
Syntax Description index DSG index. The valid range is from 1 to 65535.
ipaddr (Optional) Destination multicast group IP address. This
argument is required for a new classifier, but optional for an
existing classifier.
hostname (Optional) Fully-qualified domain name (FQDN). This
argument is required for a new classifier, but optional for an
existing classifier.
tunnel index (Optional) Defines a tunnel index identified by a number from
1 to 65535.
dest-ports start end (Optional) Defines the destination TCP/UDP with the starting
and ending port ranging from 0 to 65535.
priority priority (Optional) Defines the classifier priority.
src-ip ipaddr (Optional) Defines the source IP address and prefix length, if
desired.
src-prefix-len length (Optional) Defines the source prefix length.
disable (Optional) Disables the classifier. This is the default.
enable (Optional) Enables the classifier.
in-dcd {yes | no | ignore} (Optional) Defines whether to include, exclude, or ignore the
DSG rules of the Downstream Channel Descriptor (DCD)
message.
• yes—Includes the classifier.
• no—Excludes the classifier.
• ignore—Excludes the classifier from the DCD message
and enables the DSG rule regardless of the tunnel MAC
address.
Command Default The A-DSG classifiers are undefined by default on a Cisco CMTS router. When configured, A-DSG
classifiers are enabled by default.
Command Modes Global configuration (config)
Cisco IOS CMTS Cable Command Reference
CBL-166 OL-15510-15
Cable Commands: cable d
cable dsg cfr
Command History Release Modification
12.3(13a)BC This command was introduced to support A-DSG 1.1 on the
Cisco uBR10012 router and Cisco uBR7200 series routers.
12.3(17a)BC The in-dcd keyword option was added.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
12.2(33)SCD5 This command was modified. The ignore option was added to the in-dcd
keyword.
12.2(33)SCG This command was modified. The hostname argument was added to specify
the FQDN for the destination or source IP address.
Usage Guidelines The cable dsg cfr command creates an index to which one or several A-DSG classifiers apply. The
A-DSG classifiers can only be mapped to one DSG tunnel. The Cisco CMTS router applies the classifier
parameters to the packets received from the DSG server in order to assign the packet to the appropriate
DSG tunnel.
When you use the in-dcd yes option, the classifiers are also included in the DSG rules as part of the DCD
message.
When you use the in-dcd ignore option, the DSG rule is enabled after bypassing the RFC-1112 MAC
address check, and the DSG classifier is not included in the DCD message.
The no form of the cable dsg cfr command disables the DSG rule if the tunnel MAC address is derived
from the RFC-1112.
During the software downgrade process, if the software does not support the in-dcd ignore option then
the in-dcd yes option is used.
Examples The following example shows how to configure an A-DSG classifier on a Cisco CMTS router:
Router(config)# cable dsg cfr 1
Router(config)# cable dsg cfr 2 dest-ip 224.10.10.101 tunnel 1 dest-port 0 65535 priority
1
Router(config)# cable dsg cfr 2 dest-ip 224.10.10.102 dest-ports 22 777 enable in-dcd yes
Router(config)# cable dsg cfr 3 dest-ip 224.10.10.103 dest-ports 22 777 src-ip
ciscovideo.com
Associated Features The cable dsg cfr command is used to configure the Advanced Mode DOCSIS Set-Top Gateway 1.2 for
the Cisco CMTS Routers feature.
Related Commands Command Description
cable dsg chan-list Configures the A-DSG downstream channel list on a Cisco CMTS router.
cable dsg client-list Configures the A-DSG client parameters and the associated DSG rule on a
Cisco CMTS router.
cable dsg tg channel Associates a group of A-DSG tunnels to one or more downstream interfaces
on a Cisco CMTS router.
cable dsg tg channel Configures the upstream channel IDs for an A-DSG tunnel group on a
ucid Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-167
Cable Commands: cable d
cable dsg cfr
Command Description
cable dsg tg channel Specifies a vendor-specific group for an A-DSG tunnel group on a
vendor-param Cisco CMTS router.
cable dsg timer Configures the A-DSG timer on a Cisco CMTS router.
cable dsg tunnel Creates A-DSG tunnels on a Cisco CMTS router.
cable dsg tunnel Associates a cable service class with an A-DSG tunnel on a Cisco CMTS
srv-class router.
cable dsg vendor Configures vendor-specific parameters for an A-DSG on a Cisco CMTS
param router.
Cisco IOS CMTS Cable Command Reference
CBL-168 OL-15510-15
Cable Commands: cable d
cable dsg chan-list
cable dsg chan-list
To configure the Advanced-mode DOCSIS Set-Top Gateway (A-DSG) downstream channel list on a
CMTS router, use the cable dsg chan-list command in global configuration mode. To remove the
A-DSG channel list, use the no form of this command.
cable dsg chan-list list-index index entry-index freq freq
no cable dsg chan-list list-index index entry-index freq freq
Syntax Description list-index Defines the DSG channel list and index identifier as a number in the range 1
to 65535.
index entry-index Defines the DSG channel frequency entry index as a number in the range 1
to 65535.
freq freq Defines the center frequency of the downstream channel in the range
47000000 to 862000000 Hz.
Command Default A-DSG channel lists are disabled and undefined by default.
Command Modes Global configuration (config)
Command History Release Modification
12.3(13a)BC This command was introduced on the Cisco uBR10012 router and Cisco
uBR7200 series routers.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines The channel list entry created with this command can be associated to a downstream interface and be
included in the Downstream Channel Descriptor (DCD) message by using the cable downstream dsg
chan-list command.
Examples The following example shows A-DSG channel list global configurations on a Cisco CMTS router:
cable dsg chan-list 1 index 1 freq 47000000
cable dsg chan-list 1 index 2 freq 125000000
cable dsg chan-list 1 index 3 freq 55500000
cable dsg chan-list 2 index 1 freq 47000000
cable dsg chan-list 2 index 2 freq 125000000
cable dsg chan-list 2 index 3 freq 55500000
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-169
Cable Commands: cable d
cable dsg chan-list
Related Commands Command Description
cable dsg cfr Defines and enables A-DSG classifiers on a Cisco CMTS router.
cable dsg client-list Configures the A-DSG client parameters and the associated DSG rule on a
Cisco CMTS router.
cable dsg tg channel Associates a group of A-DSG tunnels to one or more downstream interfaces on
a Cisco CMTS router.
cable dsg tg channel Configures the upstream channel IDs for an A-DSG tunnel group on a Cisco
ucid CMTS router.
cable dsg tg channel Specifies a vendor-specific group for an A-DSG tunnel group on a Cisco
vendor-param CMTS router.
cable dsg timer Configures the A-DSG timer on a Cisco CMTS router.
cable dsg tunnel Creates A-DSG tunnels on a Cisco CMTS router.
cable dsg tunnel Associates a cable service class with an A-DSG tunnel on a Cisco CMTS
srv-class router.
cable dsg vendor Configures vendor-specific parameters for A-DSG on a Cisco CMTS router.
param
Cisco IOS CMTS Cable Command Reference
CBL-170 OL-15510-15
Cable Commands: cable d
cable dsg client-list
cable dsg client-list
To configure client parameters for Advanced-mode DOCSIS Set-Top Gateway (A-DSG) on a Cisco
CMTS router, use the cable dsg client-list command in global configuration mode. This command
configures the client parameters and the associated DSG rule. To remove this configuration, use the no
form of the command.
cable dsg client-list client-list-id id-index id {application-id app-id | broadcast [broadcast-id] |
ca-system-id sys-id | mac-addr mac-addr}
no cable dsg client-list client-list-id id-index id {application-id app-id | broadcast [broadcast-id]
| ca-system-id sys-id | mac-addr mac-addr}
Syntax Description client-list-id Defines an identifier for the DSG client list as a number from 1 to
65535.
id-index id Defines the DSG client index identifier as a number from 1 to 65535.
application-id app-id Defines the DSG client type application identifier as a hexadecimal
value from 1 to FFFF.
broadcast [broadcast-id] Defines an optional DSG client type broadcast value:
• 1—Contains Society of Cable Telecommunications Engineers
(SCTE) 65.
• 2—Contains SCTE 18.
• 3—Contains OpenCable Application Platform (OCAP) Object
Carousel (OCAP 1.0)
• 4—Contains OpenCable Common Download Carousel
(OC-CD).
• 5 to 55534—Reserved for future use.
• 55535 to 65535—Reserved for Multipler Service Operator
(MSO)-specific use.
ca-system-id sys-id Defines the DSG client type CA system identifier as a hexadecimal
value from 1 to FFFF.
mac-addr mac-addr Defines the DSG client type hexadecimal MAC address.
Command Default Client lists for A-DSG are not configured by default.
Command Modes Global configuration (config)
Command History Release Modification
12.3(13a)BC This command was introduced to support A-DSG on the Cisc uBR10012
router and Cisco uBR7200 series routers.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-171
Cable Commands: cable d
cable dsg client-list
Release Modification
12.3(17a)BC2 The broadcast-id argument was added. Support for the same DSG client
identifier to be associated with multiple DSG tunnels was added.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines Beginning in Cisco IOS Release 12.3(17a)BC2, the same DSG client identifer can be associated with
multiple DSG tunnels.
Examples The following example shows global configuration for four A-DSG client lists:
cable dsg client-list 1 id-index 1 broadcast
cable dsg client-list 2 id-index 2 application-id FFFF
cable dsg client-list 3 id-index 3 ca-system-id EEEE
cable dsg client-list 4 id-index 4 mac-addr 0100.5e0a.0a04
Related Commands Command Description
cable dsg cfr Defines and enables A-DSG classifiers on a Cisco CMTS router.
cable dsg chan-list Configures the A-DSG downstream channel list on a Cisco CMTS
router.
cable dsg tg channel Associates a group of A-DSG tunnels to one or more downstream
interfaces on a Cisco CMTS router.
cable dsg tg channel ucid Configures the upstream channel IDs for an A-DSG tunnel group on a
Cisco CMTS router.
cable dsg tg channel Specifies a vendor-specific group for an A-DSG tunnel group on a Cisco
vendor-param CMTS router.
cable dsg timer Configures the A-DSG timer on a Cisco CMTS router.
cable dsg tunnel Creates A-DSG tunnels on a Cisco CMTS router.
cable dsg tunnel srv-class Associates a cable service class with an A-DSG tunnel on a Cisco CMTS
router.
cable dsg vendor param Configures vendor-specific parameters for A-DSG on a Cisco CMTS
router.
Cisco IOS CMTS Cable Command Reference
CBL-172 OL-15510-15
Cable Commands: cable d
cable dsg keepalive
cable dsg keepalive
Note Effective with Cisco IOS Release 12.3(13a)BC, the cable dsg keepalive command is not available in
Cisco IOS software.
To enable keepalive messages over DOCSIS Set-Top Gateway (DSG) tunnels on all cable interfaces, use
the cable dsg keepalive command in global configuration mode. To disable DSG keepalives, use the no
form of this command.
cable dsg keepalive
no cable dsg keepalive
Syntax Description This command has no arguments or keywords.
Command Default Keepalive messages are disabled (no cable dsg keepalive).
Command Modes Global configuration (config)
Command History Release Modification
12.2(15)BC2 This command was introduced for the Cisco uBR7100 series and
Cisco uBR7246VXR routers.
12.3(9a)BC This command was introduced for the Cisco uBR10012 router.
12.3(13a)BC This command was removed.
Usage Guidelines By default, a Cisco CMTS router does not send keepalive messages on any DSG tunnels. When
keepalives are enabled using the cable dsg keepalive command, the Cisco CMTS router sends one
keepalive message each second on each DSG tunnel on each downstream. In Cisco IOS Release
12.2(15)BC2, the keepalive packet is a null packet.
Note Do not enable DSG keepalive messages unless your application and DSG set-top boxes require them.
Tip Use the show cable dsg command to display whether keepalive messages are enabled.
Examples The following example shows how to enable DSG keepalives on all cable interfaces on the router:
cable dsg keepalive
The following example shows how to disable DSG keepalives on all cable interfaces, which is the default
configuration:
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-173
Cable Commands: cable d
cable dsg keepalive
no cable dsg keepalive
Related Commands Command Description
cable dsg Enables DSG on a cable interface, and configures its tunnel-mapping
parameters.
debug cable dsg Enables the display of debugging messages for the operation of the DSG
feature.
show cable dsg Displays the current DSG tunneling parameters.
Cisco IOS CMTS Cable Command Reference
CBL-174 OL-15510-15
Cable Commands: cable d
cable dsg name-update-interval
cable dsg name-update-interval
To update fully-qualified domain name (FQDN) classifiers on a Cisco CMTS router based on the DNS
server record, use the cable dsg name-update-interval command in global configuration mode. To
remove this configuration, use the no form of this command.
cable dsg name-update-interval minutes
no cable dsg name-update-interval minutes
Syntax Description minutes Interval in minutes to check the DNS server for any FQDN classifier
changes. The valid range is from 1 to 60. The default value is 5.
Command Default The default value of 5 minutes is configured.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCG This command was introduced.
Usage Guidelines Use the cable dsg name-update-interval command to configure the DSG name process feature. This
feature supersedes the Time to Live (TTL) value associated with the DNS server while obtaining the
latest DNS server record.
Examples The following example shows how to specify the DSG name interval on the Cisco CMTS router:
Router(config)# cable dsg name-update-interval 3
Associated Features The cable dsg-name-update-interval command is used to configure the Advanced Mode DOCSIS
Set-Top Gateway 1.2 for the Cisco CMTS Routers feature.
Related Commands Command Description
cable dsg cfr Defines and enables A-DSG classifiers on a Cisco CMTS router.
show cable dsg cfr Displays DSG classifier details.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-175
Cable Commands: cable d
cable dsg tg
cable dsg tg
To associate a group of Advanced-Mode DOCSIS Set-Top Gateway (A-DSG) tunnels to one or more
downstream interfaces on a Cisco CMTS router, use the cable dsg tg command in global configuration
mode. To remove this configuration, use the no form of this command.
cable dsg tg group-id [channel channel_ID | priority DSG-rule-priority [enable | disable] | ucid
ID1 [ID2 ID3 ID4] | vendor-param vendor-group-ID]
no cable dsg tg group-id
Syntax Description group-id A-DSG tunnel group identifier. The valid range is from 1 to 65535.
channel-id (Optional) The downstream channel identifier. The valid range is from
1 to 65535.
priority DSG-rule-priority (Optional) Specifies the A-DSG rule priority. The valid range is from
0 to 255.
enable (Optional) Enables the specified A-DSG tunnel group.
disable (Optional) Disables the specified A-DSG tunnel group. This is the
default.
ucid upstream-channel-ID (Optional) Specifies the upstream channel ID. You can specify a
maximum of four upstream channel IDs.
vendor-param (Optional) Specifies the vendor specific parameters group ID. The valid
vendor-group-ID range is from 1 to 65535.
Defaults The A-DSG tunnel group configuration is enabled by default.
Command Modes Global configuration (config)
Command History Release Modification
12.3(17a)BC2 This command was introduced to support A-DSG version 1.2 on the
Cisco uBR10012 router and Cisco uBR7200 series routers.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
12.2(33)SCG The channel keyword was made optional, and the following new keywords
were added:
• ucid
• vendor-param
Usage Guidelines The cable dsg tg command establishes the configuration of the tunnel group. You can use the disable
and enable keyword forms of the command to deactivate and activate the tunnel group configuration.
Cisco IOS CMTS Cable Command Reference
CBL-176 OL-15510-15
Cable Commands: cable d
cable dsg tg
Examples The following example shows configuration and activation of a DSG tunnel group with channel ID,
A-DSG rule priority, upstream channel ID, and vendor parameter group ID:
Router(config)# cable dsg tg 1
Router(config)# cable dsg tg 1 channel 2
Router(config)# cable dsg tg 1 channel 2 enable
Router(config)# cable dsg tg 1 channel 2 priority 3
Router(config)# cable dsg tg 1 channel 2 priority 3 enable
Router(config)# cable dsg tg 1 channel 2 ucid 1
Router(config)# cable dsg tg 1 channel 2 vendor-param 30
Related Commands Command Description
cable dsg cfr Defines and enables A-DSG classifiers on a Cisco CMTS router.
cable dsg chan-list Configures the A-DSG downstream channel list on a Cisco CMTS router.
cable dsg client-list Configures the A-DSG client parameters and the associated DSG rule on a
Cisco CMTS router.
cable dsg tg channel Configures the upstream channel IDs for an A-DSG tunnel group on a Cisco
ucid CMTS router.
cable dsg tg channel Specifies a vendor-specific group for an A-DSG tunnel group on a Cisco
vendor-param CMTS router.
cable dsg timer Configures the A-DSG timer on a Cisco CMTS router.
cable dsg tunnel Creates A-DSG tunnels on a Cisco CMTS router.
cable dsg tunnel Associates a cable service class with an A-DSG tunnel on a Cisco CMTS
srv-class router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-177
Cable Commands: cable d
cable dsg tg channel
cable dsg tg channel
To associate a group of Advanced-mode DOCSIS Set-top Gateway (A-DSG) tunnels to one or more
downstream interfaces on a Cisco CMTS router, use the cable dsg tg channel command in global
configuration mode. To remove this configuration, use the no form of this command.
cable dsg tg group-id channel channel-id [priority rule-priority] [enable | disable]
no cable dsg tg group-id channel channel-id [priority rule-priority]
Syntax Description group-id Specifies the A-DSG tunnel group identifier as a number from 1–65535.
channel-id Specifies the downstream channel identifier as a number from 1–65535.
priority rule-priority Specifies the A-DSG rule priority as a number from 0–255.
enable Enables the specified A-DSG tunnel group.
disable Disables the specified A-DSG tunnel group. This is the default.
Defaults The A-DSG tunnel group configuration is enabled by default.
Command Modes Global configuration (config)
Command History Release Modification
12.3(17a)BC2 This command was introduced to support A-DSG version 1.2 on the
Cisco uBR10012 router and Cisco uBR7200 series routers.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines The cable dsg tg channel command establishes the configuration of the tunnel group. You can use the
disable and enable keyword forms of the command to deactivate and activate the tunnel group
configuration. To remove the configuration, use the no form of the command.
Examples The following example shows configuration and activation of a tunnel group with ID of 1 and channel
ID of 2:
Router(config)# cable dsg tg 1 channel 2
Related Commands Command Description
cable dsg cfr Defines and enables A-DSG classifiers on a Cisco CMTS router.
cable dsg chan-list Configures the A-DSG downstream channel list on a Cisco CMTS router.
cable dsg client-list Configures the A-DSG client parameters and the associated DSG rule on a
Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
CBL-178 OL-15510-15
Cable Commands: cable d
cable dsg tg channel
Command Description
cable dsg tg channel Associates a group of A-DSG tunnels to one or more downstream interfaces on
a Cisco CMTS router.
cable dsg tg channel Configures the upstream channel IDs for an A-DSG tunnel group on a Cisco
ucid CMTS router.
cable dsg tg channel Specifies a vendor-specific group for an A-DSG tunnel group on a Cisco
vendor-param CMTS router.
cable dsg timer Configures the A-DSG timer on a Cisco CMTS router.
cable dsg tunnel Creates A-DSG tunnels on a Cisco CMTS router.
cable dsg tunnel Associates a cable service class with an A-DSG tunnel on a Cisco CMTS
srv-class router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-179
Cable Commands: cable d
cable dsg tg channel ucid
cable dsg tg channel ucid
To configure the upstream channel IDs for an Advanced-mode DOCSIS Set-top Gateway (A-DSG)
tunnel group on a Cisco CMTS router, use the cable dsg tg channel ucid command in global
configuration mode. To remove this configuration, use the no form of this command.
cable dsg tg group-id channel channel-id ucid upstream-id [upstream-id. . .]
no cable dsg tg group-id channel channel-id ucid upstream-id [upstream-id. . .]
Syntax Description group-id Specifies the A-DSG tunnel group identifier as a number from 1–65535.
channel-id Specifies the downstream channel identifier as a number from 1–65535.
upstream-id Specifies one or more upstream channel IDs as a number from 1–8.
Defaults Upstream channel IDs are not defined by default.
Command Modes Global configuration (config)
Command History Release Modification
12.3(17a)BC2 This command was introduced to support A-DSG version 1.2 on the
Cisco uBR10012 router and Cisco uBR7200 series routers.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines The cable dsg tg channel command must be configured before this command is made available.
Examples The following example shows configuration of a tunnel group with ID of 1 and channel ID of 2, followed
by configuration of the upstream channel IDs associated with the tunnel group:
Router(config)# cable dsg tg 1 channel 2
Router(config)# cable dsg tg 1 channel 2 ucid 1 2 3 4 5 6 7 8
Related Commands Command Description
cable dsg cfr Defines and enables A-DSG classifiers on a Cisco CMTS router.
cable dsg chan-list Configures the A-DSG downstream channel list on a Cisco CMTS router.
cable dsg client-list Configures the A-DSG client parameters and the associated DSG rule on a
Cisco CMTS router.
cable dsg tg channel Associates a group of A-DSG tunnels to one or more downstream interfaces on
a Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
CBL-180 OL-15510-15
Cable Commands: cable d
cable dsg tg channel ucid
Command Description
cable dsg tg channel Specifies a vendor-specific group for an A-DSG tunnel group on a Cisco
vendor-param CMTS router.
cable dsg timer Configures the A-DSG timer on a Cisco CMTS router.
cable dsg tunnel Creates A-DSG tunnels on a Cisco CMTS router.
cable dsg tunnel Associates a cable service class with an A-DSG tunnel on a Cisco CMTS
srv-class router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-181
Cable Commands: cable d
cable dsg tg channel vendor-param
cable dsg tg channel vendor-param
To associate a vendor-specific group with an Advanced-mode DOCSIS Set-top Gateway (A-DSG)
tunnel group on a Cisco CMTS router, use the cable dsg tg channel vendor-param command in global
configuration mode. To remove this configuration, use the no form of this command.
cable dsg tg group-id channel channel-id vendor-param vendor-group
no cable dsg tg group-id channel channel-id vendor-param vendor-group
Syntax Description group-id Specifies the A-DSG tunnel group identifier as a number from 1–65535.
channel-id Specifies the downstream channel identifier as a number from 1–65535.
vendor-group Specifies the A-DSG vendor-specific group ID as a number from
1–65535.
Defaults The A-DSG vendor-specific group is not associated by default.
Command Modes Global configuration (config)
Command History Release Modification
12.3(17a)BC2 This command was introduced to support A-DSG version 1.2 on the
Cisco uBR10012 router and Cisco uBR7200 series routers.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines The cable dsg tg channel command must be configured before this command is made available. You
also need to configure the vendor-specific parameter list using the cable dsg vendor-param command
before you can associate it with the tunnel group.
Examples The following example shows configuration of the vendor-specific parameter list, followed by
configuration of a tunnel group and ssociation with the defined vendor group 3:
! Configure the vendor-specific parameter list
cable dsg vendor-param 3 vendor 1 oui ABCDEC value 0101AB
!
! Configure the tunnel group and associate the vendor group to the tunnel
!
cable dsg tg 1 channel 2
cable dsg tg 1 channel 2 vendor-param 3
Cisco IOS CMTS Cable Command Reference
CBL-182 OL-15510-15
Cable Commands: cable d
cable dsg tg channel vendor-param
Related Commands Command Description
cable dsg cfr Defines and enables A-DSG classifiers on a Cisco CMTS router.
cable dsg chan-list Configures the A-DSG downstream channel list on a Cisco CMTS router.
cable dsg client-list Configures the A-DSG client parameters and the associated DSG rule on a
Cisco CMTS router.
cable dsg tg channel Associates a group of A-DSG tunnels to one or more downstream interfaces on
a Cisco CMTS router.
cable dsg tg channel Configures the upstream channel IDs for an A-DSG tunnel group on a Cisco
ucid CMTS router.
cable dsg timer Configures the A-DSG timer on a Cisco CMTS router.
cable dsg tunnel Creates A-DSG tunnels on a Cisco CMTS router.
cable dsg tunnel Associates a cable service class with an A-DSG tunnel on a Cisco CMTS
srv-class router.
cable dsg Configures A-DSG vendor-specific parameters on a Cisco CMTS router.
vendor-param
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-183
Cable Commands: cable d
cable dsg tg default-priority
cable dsg tg default-priority
To change the default channel priority for a tunnel group on the Cisco CMTS router, use the
cable dsg tg default-priority command in global configuration mode. To set the channel priority back
to the default value of zero, use the no form this command.
cable dsg tg group-id default-priority DSG-rule-priority
no cable dsg tg group-id priority DSG-rule-priority
Syntax Description group-id Advanced-Mode DOCSIS Set-Top Gateway (A-DSG) tunnel group
identifier. The valid range is from 1 to 65535.
default-priority Specifies the DSG rule priority of the downstream channels. The valid
DSG-rule-priority range is from 0 to 255. The default value is 0.
Command Default The default value of 0 is used as the channel priority for a tunnel group.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCG This command was introduced.
Usage Guidelines All channels that are configured after setting the default priority use the same priority value.
Examples The following example shows how to specify the default channel priority for a tunnel group on the
Cisco CMTS router:
Router(config)# cable dsg tg 1 default-priority 20
Associated Features The cable dsg tg default-priority command is associated with the Advanced Mode DOCSIS Set-Top
Gateway 1.2 for the Cisco CMTS Routers feature.
Related Commands Command Description
cable dsg cfr Defines and enables A-DSG classifiers on a Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
CBL-184 OL-15510-15
Cable Commands: cable d
cable dsg tg priority
cable dsg tg priority
To change the priority of existing Advanced-Mode DOCSIS Set-Top Gateway (A-DSG) channels in a
tunnel group on a Cisco CMTS router, use the cable dsg tg priority command in global configuration
mode. To set the DSG rule priority of all existing channels in a tunnel group to the default value of zero,
use the no form of this command.
cable dsg tg group-id priority DSG-rule-priority
no cable dsg tg group-id priority DSG-rule-priority
Syntax Description group-id A-DSG tunnel group identifier. The valid range is from 1 to 65535.
priority DSG-rule-priority Specifies the DSG rule priority of the downstream channels. The valid
range is from 0 to 255. The default value is 0.
Command Default None
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCG This command was introduced.
Usage Guidelines This command does not impact the downstream channels configured after setting the priority. The no
form of the cable dsg tg priority command sets the DSG rule priority of all existing channels in a tunnel
group to the default value of 0.
Examples The following example shows how to specify the DSG rule priority for all existing A-DSG channels in
a tunnel group on a Cisco CMTS router:
Router(config)# cable dsg tg 1 priority 20
Associated Features The cable dsg tg priority command is used to configure the Advanced Mode DOCSIS Set-Top Gateway
1.2 for the Cisco CMTS Routers feature.
Related Commands Command Description
cable dsg cfr Defines and enables A-DSG classifiers on a Cisco CMTS router.
show cable dsg cfr Displays DSG classifier details.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-185
Cable Commands: cable d
cable dsg timer
cable dsg timer
To configure the Advanced-mode DOCSIS Set-Top Gateway (A-DSG) timer entry to be associated to
the downstream channel, and encoded into the downstream channel descriptor (DCD) message on a
Cisco CMTS router, use the cable dsg timer command in global configuration mode. To remove the
cable A-DSG timer, use the no form of this command.
cable dsg timer index [Tdsg1 Tdsg1] [Tdsg2 Tdsg2] [Tdsg3 Tdsg3] [Tdsg4 Tdsg4]
no cable dsg timer index [Tdsg1 Tdsg1] [Tdsg2 Tdsg2] [Tdsg3 Tdsg3] [Tdsg4 Tdsg4]
Syntax Description index Defines the DSG timer and associates to an index for the downstream
channel as a number from 1 to 65535.
Tdsg1 Tdsg1 (Optional) DSG Initialization Timeout (Tdsg1) setting from 1 to 65535.
Tdsg2 Tdsg2 (Optional) DSG Operational Timeout (Tdsg2) setting from 1 to 65535.
Tdsg3 Tdsg3 (Optional) DSG Two-Way Retry Timer (Tdsg3) setting from 0 to 65535.
Tdsg4 Tdsg4 (Optional) DSG One-Way Retry Timer (Tdsg4) setting from 0 to 65535.
Defaults The A-DSG timer is not defined by default.
Command Modes Global configuration (config)
Command History Release Modification
12.3(13a)BC This command was introduced to support A-DSG 1.1 on the
Cisco uBR10012 router and Cisco uBR7200 series routers.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines The A-DSG timer entry can associated to the downstream to encode into the DCD message.
Examples The following example shows global configuration of three A-DSG timers:
cable dsg timer 1 Tdsg1 1 Tdsg2 2 Tdsg3 3 Tdsg4 4
cable dsg timer 2 Tdsg1 2 Tdsg2 22 Tdsg3 33 Tdsg4 44
cable dsg timer 3 Tdsg1 2 Tdsg2 600 Tdsg3 300 Tdsg4 1800
Related Commands Command Description
cable dsg cfr Defines and enables A-DSG classifiers on a Cisco CMTS router.
cable dsg chan-list Configures the A-DSG downstream channel list on a Cisco CMTS
router.
Cisco IOS CMTS Cable Command Reference
CBL-186 OL-15510-15
Cable Commands: cable d
cable dsg timer
Command Description
cable dsg client-list Configures the A-DSG client parameters and the associated DSG rule
on a Cisco CMTS router.
cable dsg tg channel Associates a group of A-DSG tunnels to one or more downstream
interfaces on a Cisco CMTS router.
cable dsg tg channel ucid Configures the upstream channel IDs for an A-DSG tunnel group on a
Cisco CMTS router.
cable dsg tg channel Specifies a vendor-specific group for an A-DSG tunnel group on a
vendor-param Cisco CMTS router.
cable dsg tunnel Creates A-DSG tunnels on a Cisco CMTS router.
cable dsg tunnel srv-class Associates a cable service class with an A-DSG tunnel on a Cisco
CMTS router.
cable dsg vendor param Configures vendor-specific parameters for A-DSG on a Cisco CMTS
router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-187
Cable Commands: cable d
cable dsg tunnel
cable dsg tunnel
To create Advanced-mode DOCSIS Set-top Gateway (A-DSG) tunnels on a Cisco CMTS router, use the
cable dsg tunnel command in global configuration mode. To remove this configuration, use the no form
of this command. To disable A-DSG tunnels, use the disable form of this command.
cable dsg tunnel tunnel-id mac-addr mac-addr tg tunnel-group-id clients number [disable |
enable]
no cable dsg tunnel tunnel-id mac-addr mac-addr tg tunnel-group-id clients number
Syntax Description tunnel-id Defines the DSG tunnel with an identifier as a number from 1–65535.
mac-addr mac-addr Specifies the multicast group MAC address in hexadecimal format.
tg tunnel-group-id Associates a tunnel group ID as a number from 1–65535.
clients number Specifies the client to which the configuration applies as a number
from 1–65535.
disable (Optional) Disables the specified A-DSG tunnel.
enable (Optional) Enables the specified A-DSG tunnel.
Defaults A-DSG tunnels are not configured by default, but are enabled by default once configured.
Command Modes Global configuration (config)
Command History Release Modification
12.3(13a)BC This command was introduced to support A-DSG version 1.1 on the
Cisco uBR10012 router and Cisco uBR7200 series routers.
12.3(17a)BC The tg and clients keywords were added in support of A-DSG version 1.2.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines The cable dsg tunnel command establishes the configuration of the tunnel. You can use the disable and
enable keyword forms of the command to deactivate and activate the tunnel configuration. To remove
the configuration, use the no form of the command.
Each tunnel is mapped to the destination MAC address and once defined, can be associated with a
configured QoS service class name using the cable dsg tunnel srv-class command.
Examples The following example shows configuration of four A-DSG tunnels on a Cisco CMTS router:
cable dsg tunnel 1 mac-addr 0100.5e0a.0a01
cable dsg tunnel 2 mac-addr 0100.5e0a.0a02
cable dsg tunnel 3 mac-addr 0100.5e0a.0a03
cable dsg tunnel 4 mac-addr 0100.5e0a.0a04
Cisco IOS CMTS Cable Command Reference
CBL-188 OL-15510-15
Cable Commands: cable d
cable dsg tunnel
Related Commands Command Description
cable dsg cfr Defines and enables A-DSG classifiers on a Cisco CMTS router.
cable dsg chan-list Configures the A-DSG downstream channel list on a Cisco CMTS
router.
cable dsg client-list Configures the A-DSG client parameters and the associated DSG rule
on a Cisco CMTS router.
cable dsg tg channel Associates a group of A-DSG tunnels to one or more downstream
interfaces on a Cisco CMTS router.
cable dsg tg channel ucid Configures the upstream channel IDs for an A-DSG tunnel group on a
Cisco CMTS router.
cable dsg tg channel Specifies a vendor-specific group for an A-DSG tunnel group on a
vendor-param Cisco CMTS router.
cable dsg timer Configures the A-DSG timer on a Cisco CMTS router.
cable dsg tunnel srv-class Associates a cable service class with an A-DSG tunnel on a Cisco
CMTS router.
cable dsg vendor param Configures vendor-specific parameters for A-DSG on a Cisco CMTS
router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-189
Cable Commands: cable d
cable dsg tunnel srv-class
cable dsg tunnel srv-class
To associate a cable service class with an Advanced-mode DOCSIS Set-top Gateway (A-DSG) tunnel
on a Cisco CMTS router, use the cable dsg tunnel srv-class command in global configuration mode. To
remove this configuration, use the no form of this command.
cable dsg tunnel tunnel-id srv-class class-name
no cable dsg tunnel tunnel-id srv-class class-name
Syntax Description tunnel-id Identifies the DSG tunnel with an identifier as a number from
1–65535.
class-name Specifies the name of a configured cable service class.
Defaults Cable service classes are not configured by default or associated with a DSG tunnel.
Command Modes Global configuration (config)
Command History Release Modification
12.3(13a)BC This command was introduced on the Cisco uBR10012 router and Cisco
uBR7200 series routers.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
12.2(33)SCC1 This command was modified to reflect the change in behavior of the
command when the default MQoS is configured.
Usage Guidelines The A-DSG tunnel and tunnel group must be created first before the cable dsg tunnel srv-class
command becomes available to associate the tunnel with a configured QoS service class.
Examples The following example shows the configuration of a cable service class named “test” on a Cisco CMTS
router, followed by the association of that test cable service class with a DSG tunnel:
Router(config)# cable service class 1 name test
Router(config)# cable service class 1 downstream
Router(config)# cable service class 1 max-rate 20000
Router(config)# cable service class 1 min-rate 3000
Router(config)# cable dsg client-list 1 id-index 1 mac-addr 0050.4d00.0007
Router(config)# cable dsg tg 1 channel 1
Router(config)# cable dsg tunnel 1 mac-addr 0050.4d00.0007 tg 1 clients 1
Router(config)# cable dsg tunnel 1 srv-class test
When the service class name is configured without the default MQoS configuration, the following error
message is displayed and the configuration is rejected prompting the user to configure the default MQoS.
Router(config)# cable dsg tunnel 1 srv-class test
Cisco IOS CMTS Cable Command Reference
CBL-190 OL-15510-15
Cable Commands: cable d
cable dsg tunnel srv-class
The default mqos doesn't exist, please, create one and then reconfigure service class name
to tunnel 1
Router(config)#
When the last service class name is not configured, the following error message is displayed prompting
the user to remove the default MQoS (if not needed.)
Router(config)# no cable dsg tunnel 1 srv-class test
There is no DSG tunnel associated with a service class name, so, remove the default mqos
if not needed
Router(config)#
Related Commands Command Description
cable service class Configures parameters for a DOCSIS service class on a Cisco CMTS router.
cable dsg client-list Configures the A-DSG client parameters and the associated DSG rule on a
Cisco CMTS router.
cable dsg tg channel Associates a group of A-DSG tunnels to one or more downstream interfaces on
a Cisco CMTS router.
cable dsg tg channel Configures the upstream channel IDs for an A-DSG tunnel group on a Cisco
ucid CMTS router.
cable dsg tg channel Specifies a vendor-specific group for an A-DSG tunnel group on a Cisco
vendor-param CMTS router.
cable dsg timer Configures the A-DSG timer on a Cisco CMTS router.
cable dsg tunnel Creates A-DSG tunnels on a Cisco CMTS router.
cable dsg tunnel Associates a cable service class with an A-DSG tunnel on a Cisco CMTS
srv-class router.
cable dsg vendor Configures vendor-specific parameters for A-DSG on a Cisco CMTS router.
param
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-191
Cable Commands: cable d
cable dsg vendor param
cable dsg vendor param
To configure Advanced-mode DOCSIS Set-top Gateway (A-DSG) vendor-specific parameters on a
Cisco CMTS router, use the cable dsg vendor-param command in global configuration mode. To
remove this configuration, use the no form of this command.
cable dsg vendor-param group-id vendor vendor-index oui oui value value-in-TLV
no cable dsg vendor-param group-id vendor vendor-index oui oui value value-in-TLV
Syntax Description group-id Defines the DSG vendor parameter and associates with a DSG group.
vendor vendor-index Selects the DSG vendor and associated DSG index.
oui oui Selects the DSG Organizationally Unique Identifier (OUI) setting.
value value-in-TLV Sets the type/length value for the defined DSG vendor.
Defaults The A-DSG vendor-specific parameters are not defined by default.
Command Modes Global configuration (config)
Command History Release Modification
12.3(13a)BC This command was introduced to support A-DSG on the Cisco uBR10012
router and Cisco uBR7200 series routers.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines The vendor-specific parameters can be associated to the downstream to encode into the Downstream
Channel Descriptor (DCD) message.
To associate a vendor parameter list with a tunnel group, use the cable dsg tg channel vendor-param
command. The same vendor parameter list can be associated with multiple tunnel groups.
Examples The following sample configuration illustrates global vendor parameters for A-DSG:
cable dsg vendor-param 1 vendor 1 oui ABCDEA value 0101AB
cable dsg vendor-param 2 vendor 1 oui ABCDEB value 0101AB
cable dsg vendor-param 3 vendor 1 oui ABCDEC value 0101AB
Related Commands Command Description
cable dsg cfr Defines and enables A-DSG classifiers on a Cisco CMTS router.
cable dsg chan-list Configures the A-DSG downstream channel list on a Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
CBL-192 OL-15510-15
Cable Commands: cable d
cable dsg vendor param
Command Description
cable dsg client-list Configures the A-DSG client parameters and the associated DSG rule on a
Cisco CMTS router.
cable dsg tg channel Associates a vendor-specific group with an A-DSG tunnel group on a Cisco
vendor-param CMTS router.
cable dsg timer Configures the A-DSG timer on a Cisco CMTS router.
cable dsg tunnel Creates A-DSG tunnels on a Cisco CMTS router.
cable dsg tunnel Associates a cable service class with an A-DSG tunnel on a Cisco CMTS
srv-class router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-193
Cable Commands: cable d
cable ds-max-burst
cable ds-max-burst
To enable a specialized Enhanced-Rate Bandwidth Allocation (ERBA) feature on the Cisco uBR10012
router with Performance Routing Engine 2 (PRE2) or Performance Routing Engine 4 (PRE4) modules,
use the cable ds-max-burst command in global configuration mode. To remove this configuration, use
the no form of this command.
cable ds-max-burst [burst-threshold threshold peak-rate peak-rate]
no cable ds-max-burst
Syntax Description burst-threshold Optional keyword and value defines the burst threshold in Kbytes, with a
threshold valid range from 64 Kbyte to 2 GB. By default, this setting is 1MB. This
value is used to compare with the per-service flow maximum traffic burst
value as defined in DOCSIS 2.0.
peak-rate peak-rate Peak Rate in Kbps. The default value of peak-rate is zero, which represents
the line rate.
The peak-rate value is a global value and is applied to all the service flows
created after the configuration of cable ds-max-burst command.
Defaults This configuration is disabled by default on the Cisco uBR10012 router. This command is not required
nor supported on the Cisco uBR7100 Series, Cisco uBR7225VXR and Cisco uBR7246VXR router.
Command Modes Global configuration (config)
Command History Release Modification
12.3(21)BC This command was introduced in support of ERBA on the Cisco uBR10012
router with PRE2 modules.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
12.2(33)SCB The peak-rate option was introduced and support for Performance Routing
Engine 4 (PRE4) was added in Cisco IOS Release 12.2(33)SCB.
Usage Guidelines Cisco IOS Release 12.3(21)BC introduces the ERBA feature on the Cisco uBR10012 CMTS with
Performance Routing Engine 2 (PRE2) modules. The ERBA feature in Cisco IOS release 12.3(21)BC is
characterized by the following enhancements:
• Enables support for the DOCSIS1.1 Downstream Maximum Transmit Burst parameter on the Cisco
CMTS by using cable ds-max-burst configuration command. This command is not supported on
the Cisco uBR7225VXR, Cisco uBR7246VXR and the Cisco uBR7100 Series routers, as this
parameter is supported by default.
• Allows DOCSIS1.0 modems to support the DOCSIS1.1 Downstream Maximum Transmit Burst
parameter by using DOCSIS QoS profile. This feature uses the cable qos pro max-ds-burst
configuration command.
Cisco IOS CMTS Cable Command Reference
CBL-194 OL-15510-15
Cable Commands: cable d
cable ds-max-burst
Note The cable ds-max-burst and related commands are supported strictly on the Cisco uBR10012 router
with PRE2 or PRE4 modules on Cisco IOS Release 12.3(21)BC or later releases.
To displays service flows on the Cisco uBR10012 router with PRE2 or PRE4, and identifies which
service flows have maximum burst enabled, use the following command in privileged EXEC mode:
show cr10k-rp cable slot/subslot/port sid service-flow ds
– slot = 5 to 8
– subslot = 0 or 1
– port = 0 to 4 (depending on the cable interface)
For additional information about the cable qos profile command and configuring QoS profiles, refer to
the following documents on Cisco.com:
• DOCSIS 1.1 for the Cisco CMTS
http://www.cisco.com/en/US/docs/cable/cmts/feature/guide/ufg_docs.html
Examples The following example illustrates typical command sequence when using this command to configure
ERBA on the Cisco uBR10012 router, with a sample burst threshold setting:
Router> enable
Router# configure terminal
Router(config)# cable ds-max-burst burst-threshold 2048 peak-rate 1000
Router(config)# Ctrl^Z
Router# show cr10k-rp cable 7/0/0 sid service-flow ds
When this feature is enabled, new service flows with burst size larger than the burst threshold are
supported. However, the existing service flows are not affected.
When this feature is disabled, no new service flows are configured with the Downstream Maximum
Transmit Burst parameter—the cable ds-max-burst command settings. However, the existing service
flows are not affected.
The following example illustrates configuration of the ERBA maximum burst for the specified service flow:
Router# sh cr10k-rp c7/0/0 1 service-flow ds
RP SFID LC SFID Conform Exceed Conform Exceed Total QID
Xmit Pkts Xmit Pkts Drop Pkts Drop Pkts Pkts
32930 10 41 0 0 0 41 131349
Forwarding interface: Modular-Cable1/0/0:0
32931 13 0 0 0 0 0 131350
Forwarding interface: Modular-Cable1/0/0:0
Related Commands Command Description
cable qos profile Configures a QoS profile.
show cable qos Displays the status of permissions for changing QoS tables for a cable router.
permission
show cable qos profile Displays the QoS profiles that have been defined.
show cr10k-rp cable Displays service flows on the Cisco uBR10012 router with PRE2, and
sid service-flow ds identifies which service flows have maximum burst enabled.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-195
Cable Commands: cable d
cable ds-resiliency
cable ds-resiliency
To reserve a resiliency bonding group or wideband (WB) interface for a line card on the Cisco CMTS,
use the cable ds-resiliency command in interface configuration mode. To remove this setting, use the
no form of this command.
cable ds-resiliency
no cable ds-resiliency
Command Default None
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCG This command was introduced.
Usage Guidelines Remove all existing configuration commands from the WB interface when setting aside that interface as
a WB resiliency bonding group.
The cable ds-resiliency command is used in conjunction with the cable resiliency ds-bonding
command to configure the Downstream Resiliency Bonding Group feature.
Examples The following example shows how to reserve a wideband cable interface in slot 5, subslot 1, and port 2
for a resiliency bonding group:
Router(config) interface wideband-cable 5/1/2:0
Router(config-if)# cable ds-resiliency
Associated Features The cable ds-resiliency command is used to configure the following feature:
Downstream Resiliency Bonding Group
Related Commands Command Description
cable resiliency Enables the Downstream Resiliency Bonding Group feature on the
ds-bonding Cisco CMTS router.
show cable modem Displays resiliency status of the cable modem in resiliency mode on the
resiliency Cisco CMTS router.
show cable resiliency Displays all information about the resiliency bonding groups on the
Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
CBL-196 OL-15510-15
Cable Commands: cable d
cable dynamic-bw-sharing
cable dynamic-bw-sharing
To enable dynamic bandwidth sharing (DBS) on a specific modular cable or wideband cable interface,
use the cable dynamic-bw-sharing command in interface configuration mode. To disable DBS on the
interface and revert to static bandwidth sharing, use the no form of this command.
cable dynamic-bw-sharing
no cable dynamic-bw-sharing
Syntax Description This command has no arguments or keywords.
Command Default Dynamic bandwidth sharing is disabled and static bandwidth sharing is enabled.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.3(23)BC1 This command was introduced.
12.2(33)SCB This command was integrated into Cisco IOS release 12.2(33)SCB.
12.2(33)SCE The command default was changed. The DBS mode is now enabled by
default.
Usage Guidelines DBS may be configured on a modular cable or wideband cable interface only when the interface is
administratively down. Additionally, the interface must be administrative down when using the no form
of this command to disable dynamic bandwidth sharing.
Note Starting with Cisco IOS Release 12.2(33)SCE, the DBS mode is enabled by default, on the WB/MC/IC
interfaces. To disable the DBS mode, configure the no cable dynamic-bw-sharing command.
Examples The following example enables dynamic bandwidth sharing on a modular cable interface using the
cable dynamic-bw-sharing command:
Router(config)# interface modular-cable 1/0/0:1
Router(config-if)# shutdown
Router(config-if)# cable dynamic-bw-sharing
Router(config-if)# no shutdown
The following example enables dynamic bandwidth sharing on a wideband cable interface using the
cable dynamic-bw-sharing command:
Router(config)# interface wideband-cable 1/0/0:0
Router(config-if)# shutdown
Router(config-if)# cable dynamic-bw-sharing
Router(config-if)# no shutdown
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-197
Cable Commands: cable d
cable dynamic-bw-sharing
Related Commands Command Description
cable Enables either static or dynamic bandwidth sharing for a modular cable
rf-bandwidth-percent (MC) interface.
cable rf-channel Associates an RF channel on a Wideband SPA with a wideband channel and
allocates bandwidth.
debug cr10k-rp Displays debug information for dynamic bandwidth sharing (DBS) on the
dbs-queue Cisco uBr10012 universal broadband router.
show pxf cable Displays information about the RF channel Versatile Traffic Management
controller System (VTMS) links and link queues.
show pxf cpu queue Displays parallel express forwarding (PXF) queueing and link queue
statistics.
Cisco IOS CMTS Cable Command Reference
CBL-198 OL-15510-15
Cable Commands: cable d
cable dynamic-qos trace
cable dynamic-qos trace
To enable the call trace functionality on the Cisco CMTS router for the PacketCable or PacketCable
Multimedia (PCMM) service subscribers, use the cable dynamic-qos trace command in global
configuration mode. To disable this configuration, use the no form of this command.
cable dynamic-qos trace subscriber-number
no cable dynamic-qos trace
Syntax Description subscriber-number Number of subscribers for a PacketCable or PCMM service. The valid range
is from 1 to 20.
Command Default None
Command Modes Global configuration (config)
Command History Release Modification
Cisco IOS Release 12.2(33)SCF This command was introduced.
Examples The following example shows how to configure the call trace functionality on the
Cisco uBR10012 router for the PacketCable or PCMM service subscribers:
Router# configure terminal
Router(config)# cable dynamic-qos trace 12
Related Commands Command Description
debug cable dynamic-qos subscriber Enables debugging of the call trace functionality on the
Cisco CMTS router for a particular subscriber.
debug cable dynamic-qos trace Enables call trace debugging on the Cisco CMTS router for
all the subscribers for whom call trace is configured.
show cable dynamic-qos trace Displays the number of subscribers for whom call trace is
enabled on the Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-199
Cable Commands: cable d
cable dynamic-secret
cable dynamic-secret
To enable the Dynamic Shared Secret feature, so that Data-over-Cable Service Interface Specifications
(DOCSIS) configuration files are verified with a Message Integrity Check (MIC) that has been created
with a dynamically generated shared secret, use the cable dynamic-secret command in cable interface
configuration mode. To disable this feature, use the no form of this command.
cable dynamic-secret {lock [lock-qos] | mark | reject} [nocrypt]
no cable dynamic-secret
Syntax Description lock Allows CMs that do not pass MIC verification to come online, but with
a restrictive quality of service (QoS) configuration that limits access to
the network. The CMTS also locks those CMs so that they must be
offline for 24 hours before being allowed to reregister with a valid
DOCSIS configuration file. (You can also manually unlock a cable
modem using the clear cable modem lock command.)
lock-qos (Optional) Specifies the QoS profile to be assigned to the CM while it
is locked. The valid range is 1 to 256. If not specified, the CM is locked
into a CMTS-created profile that limits both the upstream and
downstream to 10 Kbps.
Note The QoS profile must have already been created before it can
assigned using the lock lock-qos option.
mark Allows CMs to come online even if they do not present a DOCSIS
configuration file with a valid CMTS MIC, but the CMTS prints a
warning message and marks those CMs with an exclamation point (!)
in the show cable modem command.
reject Rejects registration for CMs with DOCSIS configuration files that
contain an invalid CMTS MIC.
nocrypt (Optional) Specifies that the filename for DOCSIS configuration files
should not be encrypted when the Cisco CMTS sends the files to CMs.
The CMTS instead transmits the files using their original filenames.
The nocrypt option slightly decreases the security provided by the
dynamic shared secret feature, but it allows the operator to poll the
DOCSIS config file name listed by the cable modem for more
convenient network management.
Note A cable modem that is running unauthorized or hacked
software can return whatever SNMP values the user desires.
This information should therefore not be trusted by the billing
and provisioning systems.
Defaults The Dynamic Shared Secret feature is disabled. When enabled, the filenames for DOCSIS configuration
files are encrypted.
Command Modes Interface configuration—cable interface only (config-if)
Cisco IOS CMTS Cable Command Reference
CBL-200 OL-15510-15
Cable Commands: cable d
cable dynamic-secret
Note Configuring the Dynamic Shared Secret feature on the master interface in a bundle also automatically
configures it for all interfaces in the bundle.
Command History Release Modification
12.2(15)BC1 This command was introduced.
12.2(15)BC1b Support for the nocrypt option was added.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines The cable dynamic-secret configuration command automatically creates a unique DOCSIS shared
secret on a per-modem basis, creating a one-time-use DOCSIS configuration file that is valid only for
the current session. This ensures that a DOCSIS configuration file that has been downloaded for one
cable modem can never be used by any other modem, nor can the same modem reuse this configuration
file at a later time. This patent-pending feature is designed to guarantee that all registered modems are
using only the QOS parameters that have been specified by the DOCSIS provisioning system for that
particular modem at the time of its registration.
The cable dynamic-secret configuration command enhances the existing shared secret support on the
Cisco CMTS by using a one-time, dynamically generated shared secret each time a cable modem
registers. This prevents theft-of-service attacks in which users are able to substitute a DOCSIS
configuration file that provides a higher-level of service during the registration phase.
The DOCSIS specification allows cable service providers to use a shared secret to create the CMTS MIC
value that is stored in a DOCSIS configuration file. If a user attempts to register with the CMTS using
a different or modified DOCSIS configuration file, the CMTS can compare the CMTS MIC value sent
by the cable modem with the CMTS MIC it has calculated. If the two MIC values are different, the file
has been modified.
The cable dynamic-secret command allows the CMTS to dynamically create the shared secret at the
time that the cable modem is registering, and that shared secret is valid only for that particular session
with that particular cable modem. A new dynamically generated shared secret is used each time each
cable modem registers, which prevents users from guessing the shared secret and using it again to
register with a modified DOCSIS configuration file.
If the cable modem’s DOCSIS configuration file fails the CMTS MIC verification check, one of the
following messages is displayed on the console:
%UBR7200-4-BADCFGFILE: Modem config file platinum.cm at C3/0: CMTS MIC Invalid
%UBR7200-4-BADCFGFILE: Modem config file platinum.cm at C3/0: No CMTS MIC
If the error message specifies that the reason for the failure is “CMTS MIC Invalid,” the CMTS MIC
was not encoded with the proper dynamically generated shared secret. If the reason is “No CMTS MIC,”
the DOCSIS configuration file did not contain any value for the CMTS MIC, which could indicate that
the customer has attempted to bypass the DOCSIS security checks by creating the user’s own DOCSIS
configuration file without any MIC values.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-201
Cable Commands: cable d
cable dynamic-secret
Note The Dynamic Shared Secret feature does not affect the use of the original shared secret or secondary
shared secrets that are configured using the cable shared-secondary-secret and cable shared-secret
commands. If these shared secrets are configured, the Cisco CMTS continues to use them to validate the
original DOCSIS configuration file that is downloaded from the TFTP server. If the DOCSIS
configuration file fails to pass the original or secondary shared secret verification checks, the cable
modem is not allowed to register, and the Dynamic Shared Secret feature is not invoked for that
particular cable modem.
Note The Cisco uBR7100 series router does not support the Dynamic Shared Secret feature when running in
MxU bridging mode.
The original filename for the DOCSIS configuration file is automatically encrypted by default to prevent
unauthorized parties from obtaining any useful information from the filename, or from attempting to
replace the original file with their own. This encryption can be disabled, using the nocrypt option, so
that DOCSIS configuration files are sent using their original filenames.
Note Do not use the cable dynamic-secret command along with the ip tftp-source command in Cisco IOS
Release 12.2(15)BC1, because this could result in certain models of CMs not being able to come online
but instead be stuck in the init(o) state. This restriction is removed in Cisco IOS Release 12.2(15)BC2
and later releases.
Modes of Operation
The cable dynamic-secret command offers three different possible responses to cable modems that fail
the CMTS MIC verification check:
• When the mark option is used, the CMTS allows CMs to come online even if they fail the CMTS
MIC validity check. However, the CMTS also prints a warning message on the console and marks
the cable modem in the show cable modem command with an exclamation point (!), so that this
situation can be investigated. The following message is displayed on the console when such a CM
registers with the Cisco CMTS:
06:53:57: %UBR7200-4-CMMARKED: Cable Modem 00ff.ffee.ddcc in C3/0 attempted theft of
service
• When the lock option is used, the CMTS assigns a restrictive QoS configuration to CMs that fail the
CMTS MIC validity check. If an optional lock-qos profile is specified, the CMTS assigns this profile
to the CM while it is locked.
If the lock-qos profile is not specified, the CMTS uses a special QoS configuration that limits the
network access for these CMs by restricting their downstream and upstream service flows to a
maximum rate of 10 kbps. (If you do not specify the lock-qos profile, you must also allow cable
modems to create QoS profiles, using the cable qos permission command. If you do not do this and
use the lock option without specifying a particular QoS profile, locked cable modems will not be
allowed to register until the lock clears or expires.)
If a customer resets their CM, the CM will reregister but still uses the restricted QoS profile. A
locked CM continues with the restricted QoS profile until it goes offline and remains offline for at
least 24 hours, at which point it is allowed to reregister with a valid DOCSIS configuration file. This
option frustrates users who are repeatedly registering with the CMTS in an attempt to guess the
shared secret, or to determine the details of the Dynamic Shared Secret security system.
In addition, the following message is displayed on the console when a CM is locked.
Cisco IOS CMTS Cable Command Reference
CBL-202 OL-15510-15
Cable Commands: cable d
cable dynamic-secret
06:53:57: %UBR7200-4-CMLOCKED: Cable Modem 00ff.ffee.ddcc in C3/0 attempted theft of
service
Locked cable modems are shown with an exclamation point (!) in the show cable modem displays:
Router# show cable modem
MAC Address IP Address I/F MAC Prim RxPwr Timing Num BPI
State Sid (db) Offset CPE Enb
0010.9507.01db 144.205.151.130 C5/1/0/U5 online(pt) 1 0.25 938 1 N
0080.37b8.e99b 144.205.151.131 C5/1/0/U5 online 2 -0.25 1268 0 N
0002.fdfa.12ef 144.205.151.232 C6/1/0/U0 online(pt) 13 -0.25 1920 1 N
0002.fdfa.137d 144.205.151.160 C6/1/0/U0 !online 16 -0.50 1920 1 N
0003.e38f.e9ab 144.205.151.237 C6/1/0/U0 !online 3 -0.50 1926 1 N
Router#
Tip You can also manually clear the lock on a CM by using the clear cable modem lock command.
• When the reject option is used, the CMTS refuses to allow CMs to come online if they fail the
CMTS MIC validity check. These cable modems appear with a MAC state of “reject(m)” in the
displays generated by the show cable modem command. After a short timeout period, the CM
attempts to reregister with the CMTS. The CM must register with a valid DOCSIS configuration file
before being allowed to come online. When the CM does come online, the CMTS prints a warning
message on the console and marks the cable modem in the show cable modem command with an
exclamation point (!), so that this situation can be investigated.
Tip Cisco recommends that you initially use the mark option, so that potential problems are identified
without immediately interfering with users’ ability to come online. After you identify and resolve these
initial problems, reconfigure the cable interfaces with the reject or lock option to block problem cable
modems that attempt to come online without a valid shared secret.
Note To account for possible network problems, such as loss of packets and congestion, the Cisco CMTS will
allow a cable modem to attempt to register twice before marking it as having failed the Dynamic Shared
Secret authentication checks.
Filename Encryption
By default, the cable dynamic-secret command encrypts the original filename for a DOCSIS
configuration file when the Cisco CMTS transmits the file to the CM. This filename changes in a
semi-random manner, making it difficult for users to predict the filename for the file that should be
downloaded to the CM.
This does mean, however, that the filenames specified in the DHCP HELLO and ACK messages are
different, and that the filenames on the CM and on the TFTP server are different. This could interfere
with custom network management applications and scripts. If this is the case, you can disable the
automatic filename encryption by adding the nocrypt option to the command.
The nocrypt option does slightly decrease the security provided by this feature, so this possibility should
be weighed against the ability to more conveniently manage the network.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-203
Cable Commands: cable d
cable dynamic-secret
Interaction with the TFTP Enforce Feature
The cable tftp-enforce command provides another layer of protection against theft-of-service attacks
by requiring cable modems to download a DOCSIS configuration file through the CMTS cable interface
before being allowed to register. When the cable tftp-enforce command is used with the cable
dynamic-secret command, the TFTP enforce checks are done before the dynamic shared-secret checks.
If a cable modem fails to download a DOCSIS configuration file through the CMTS, it is not allowed to
register, regardless of the dynamic shared-secret checks.
Displaying Rogue Cable Modems
Use the show cable modem rogue command to display the cable modems that have failed the dynamic
shared-secret authentication checks:
Router# show cable modem rogue
Spoof TFTP
MAC Address Vendor Interface Count Dnld Dynamic Secret
AAAA.7b43.aa7f Vendor1 C4/0/U5 2 Yes 45494DC933F8F47A398F69EE6361B017
AAAA.7b43.aa7f Vendor1 C4/0/U5 2 Yes D47BCBB5494E9936D51CB0EB66EF0B0A
BBBB.7b43.aa7f Vendor2 C4/0/U5 2 No 8EB196423170B26684BF6730C099D271
AAAA.7b43.aa7f Vendor1 C4/0/U5 2 No DF8FE30203010001A326302430120603
BBBB.7b43.aa7f Vendor2 C4/0/U5 2 No 300E0603551D0F0101FF040403020106
AAAA.7b43.aa7f Vendor1 C4/0/U5 2 Yes 820101002D1A264CE212A1BB6C1728B3
DDDD.7b43.aa7f Vendor4 C4/0/U5 2 Yes 7935B694DCA90BC624AC92A519C214B9
AAAA.7b43.aa7f Vendor1 C4/0/U5 2 No 3AB096D00D56ECD07D9B7AB662451CFF
Router#
If the CMTS cannot obtain the DOCSIS configuration file from the TFTP server, a message similar to
the following is displayed on the console:
%UBR7200-4-NOCFGFILE: Cannot read modem config file platinum.cm from C3/0: <reason>
where the reason can be one of the following, depending on the error that the TFTP server reported:
• Compression Failed
• File too big
• Invalid Checksum
• Invalid IP address or hostname
• Uncompression Failed
• User Abort
Examples The following example shows how to configure a cable interface on a Cisco uBR7200 series router with
the mark option, so that CMs that fail the MIC verification are allowed to register but are marked in the
show cable modem displays so that their situation can be further investigated:
Router# configure terminal
Router(config)# interface cable 4/0
Router(config-if)# cable dynamic-secret mark
Router(config-if)# exit
Router(config)# exit
Router#
Cisco IOS CMTS Cable Command Reference
CBL-204 OL-15510-15
Cable Commands: cable d
cable dynamic-secret
The following example shows how to configure the cable interface on a Cisco uBR7100 series router,
so that CMs that fail the MIC verification are locked with a QoS profile that limits upstream and
downstream service flows to 10 kbps:
Router# configure terminal
Router(config)# cable qos permission create
Router(config)# cable qos permission update
Router(config)# interface cable 1/0
Router(config-if)# cable dynamic-secret lock
Router(config-if)# exit
Router(config)# exit
Router#
Note If you do not use the cable qos permission global configuration command to allow cable modems to
create their own QoS profiles, the CMTS rejects this command and displays the following error message:
%Need permission for modems to create QoS profile
The following example shows how to configure a cable interface so that CMs that fail the MIC
verification are locked with a specific QoS profile:
Router# configure terminal
Router(config)# interface cable 1/0
Router(config-if)# cable dynamic-secret lock 31
Router(config-if)# exit
Router(config)# exit
Router#
Note If the specified QoS profile does not exist, the CMTS rejects this command and displays the following
error message:
%Profile qos-id to lock modem does not exist
The following example shows how to configure a cable interface on a Cisco uBR7200 series router, so
that CMs that fail the MIC verification are not allowed to register and must reregister with a valid
DOCSIS configuration file before being allowed to come online:
Router# configure terminal
Router(config)# interface cable 3/0
Router(config-if)# cable dynamic-secret reject
Router(config-if)# exit
Router(config)# exit
Router#
The following example shows how to disable the Dynamic Shared Secret feature on a cable interface on
the Cisco uBR10012 router:
Router# configure terminal
Router(config)# interface cable 6/1/0
Router(config-if)# no cable dynamic-secret
Router(config-if)# exit
Router(config)# exit
Router#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-205
Cable Commands: cable d
cable dynamic-secret
Related Commands Command Description
cable dynamic-secret Excludes one or more specific cable modems from being processed by the
exclude Dynamic Shared Secret feature.
cable Configures one or more secondary shared secret keys that CMs can use to
shared-secondary-secre successfully process the DOCSIS configuration file and register with the
t CMTS.
cable shared-secret Configures an authentication shared secret key that CMs must use to
successfully process the DOCSIS configuration file and register with the
CMTS.
cable tftp-enforce Requires that all CMs on a cable interface attempt to download a DOCSIS
configuration file using Trivial File Transfer Protocol (TFTP) through the
cable interface before being allowed to register and come online.
clear cable modem lock Resets the lock on one or more CMs, and reinitializes them, so that they
can reregister with a valid DOCSIS configuration file.
show cable modem Displays a list of cable modems that have been marked, locked, or rejected
rogue because they failed the dynamic shared-secret authentication checks.
Cisco IOS CMTS Cable Command Reference
CBL-206 OL-15510-15
Cable Commands: cable d
cable dynamic-secret exclude
cable dynamic-secret exclude
To exclude one or more specific cable modems from being processed by the Dynamic Shared Secret
feature, use the cable dynamic-secret exclude command in global configuration mode. To disable this
feature, use the no form of this command.
cable dynamic-secret exclude {modem mac-address | oui oui-id}
no cable dynamic-secret {modem mac-address | oui oui-id}
Syntax Description modem mac-address Specifies the hardware (MAC) address of a specific individual cable
modem to be excluded from the Dynamic Shared Secret feature. (You
cannot specify a multicast MAC address.)
oui oui-id Specifies the organization unique identifier (OUI) of a vendor, so that
cable modems from this vendor are excluded from the Dynamic Shared
Secret feature. The OUI should be specified as three hexadecimal bytes
separated by either periods or colons.
Command Default All modems are processed by the Dynamic Shared Secret feature when the feature is enabled.
Command Modes Global configuration (config)
Command History Release Modification
12.3(9a)BC This command was introduced.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines When the cable dynamic-secret configuration command is configured on a cable interface, it
automatically includes all cable modems that register on that interface. To exclude one or more cable
modems from being processed by the Dynamic Shared Secret security checks, use the cable
dynamic-secret exclude command in global configuration mode.
You might want to exclude cable modems from the Dynamic Shared Secret security checks if they need
to download additional files from the TFTP server at registration time. For example, Cisco cable CPE
devices, such as the Cisco uBR925 cable access router, can be instructed to download a Cisco IOS
configuration file after downloading the DOCSIS configuration file.
However, when Dynamic Shared Secret checks are being used, the Cisco CMTS refuses to allow the
cable modem to download any other files after the first successful download of the DOCSIS
configuration file. To allow these cable modems to download their Cisco IOS configuration files, use
the cable dynamic-secret-exclude command to exclude them from the Dynamic Shared Secret checks.
You can exclude either a specific cable modem by its MAC address, or all of a vendor’s cable modems
by their OUI value. Excluded cable modems must still register according to the normal DOCSIS
provisioning procedures, but their DOCSIS configuration files are no longer verified by the Dynamic
Shared Secret security checks.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-207
Cable Commands: cable d
cable dynamic-secret exclude
Tip When a cable modem is excluded from the Dynamic Shared Secret feature, the Dynamic Secret field in
its show cable modem verbose display shows “Excluded”.
Examples The following example shows how to exclude a specific cable modem, with the MAC address of
00d0.45ba.b34b, from being processed by the Dynamic Shared Secret feature:
Router# configure terminal
Router(config)# cable dynamic-secret exclude modem 00d0.45ba.b34b
Router(config)# exit
Router#
The following example shows how to exclude all cable modems with a vendor OUI value 00.01.B4 from
being processed by the Dynamic Shared Secret feature:
Router# configure terminal
Router(config)# cable dynamic-secret exclude oui 00.01.B4
Router(config)# exit
Related Commands Command Description
cable dynamic-secret Enables the Dynamic Shared Secret feature, so that DOCSIS configuration
files are verified with a MIC that has been created with a dynamically
generated shared secret.
cable Configures one or more secondary shared secret keys that CMs can use to
shared-secondary-secre successfully process the DOCSIS configuration file and register with the
t CMTS.
cable shared-secret Configures an authentication shared secret key that CMs must use to
successfully process the DOCSIS configuration file and register with the
CMTS.
cable tftp-enforce Requires that all CMs on a cable interface attempt to download a DOCSIS
configuration file using TFTP through the cable interface before being
allowed to register and come online.
clear cable modem lock Resets the lock on one or more CMs, and reinitializes them, so that they
can reregister with a valid DOCSIS configuration file.
show cable modem Displays a list of cable modems that have been marked, locked, or rejected
rogue because they failed the dynamic shared-secret authentication checks.
Cisco IOS CMTS Cable Command Reference
CBL-208 OL-15510-15
Cable Commands: cable d
cable dynamic-secret tftp insert-upgrade-server
cable dynamic-secret tftp insert-upgrade-server
To dynamically insert the IPv4 or IPv6 TLV values in the Data-over-Cable Service Interface
Specifications (DOCSIS) configuration file to complete firmware upgrade on cable modems, use the
cable dynamic-secret tftp insert-upgrade-server command in the global configuration mode.
cable dynamic-secret tftp insert-upgrade-server
no cable dynamic-secret tftp insert-upgrade-server
Syntax Description This command has no arguments or keywords.
Command Default Disabled
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCD2 This command was introduced.
Usage Guidelines The Dynamic Shared Secret feature must be configured first before you can upgrade the firmware on
cable modems. To enable this feature, execute the cable dynamic-secret command in the cable interface
configuration mode.
Examples The following example dynamically inserts the correct IPv4 or IPv6 TLV values from the DOCSIS
configuration file to upgrade firmware on the cable modems.
Router(config)# cable dynamic-secret tftp insert-upgrade-server
Router(config)# end
Related Commands Command Description
cable dynamic-secret Enables the Dynamic Shared Secret feature so that DOCSIS configuration
files are verified with a Message Integrity Check (MIC) that has been created
with a dynamically generated shared secret.
cable dynamic-secret Excludes one or more specific cable modems from being processed by the
exclude Dynamic Shared Secret feature.
clear cable modem Resets the lock on one or more CMs, and re-initializes them, so that they can
lock reregister with a valid DOCSIS configuration file.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-209
Cable Commands: cable d
cable dynamic-secret tftp insert-upgrade-server
Cisco IOS CMTS Cable Command Reference
CBL-210 OL-15510-15
Cable Commands: cable e through cable i
Revised: July 2012, OL-15510-15
New Commands
Command Cisco IOS Software Release
cable ip-init 12.2(33)SCA
cable ipv6 source-verify 12.2(33)SCA
cable init-channel-timeout 12.2(33)SCC
cable ipc-stats 12.2(33)SCC
cable ipv6 source-verify leasequery-filter 12.2(33)SCF1
downstream
Modified Commands
Command Cisco IOS Software Release
cable event syslog-server 12.2(33)SCA
cable fiber-node 12.3(23)BC
cable filter group 12.2(33)SCA
cable helper-address 12.2(33)SCB
cable helper-address 12.2(33)SCC
cable freq-range 12.2(33)SCE
cable ipv6 source-verify 12.2(33)SCF1
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-211
Cable Commands: cable e through cable i
cable enable-trap
cable enable-trap
To permanently set four CISCO-DOCS-EXT-MIB MIB attributes that enable the sending of a trap when
a CM changes between the online and offline states, use the cable enable-trap command in cable
interface configuration mode. To return to the default settings found in the MIB, which disable the
sending of these traps, use the no form of this command.
cable enable-trap [cmonoff-notification | cmonoff-interval time-in-secs]
no cable enable-trap [cmonoff-notification | cmonoff-interval]
Syntax Description cmonoff-notification Enables or disables the sending of the notification traps.
cmonoff-interval Specifies the minimum interval that must pass before sending out a
new trap for the same CM.
time-in-secs Specifies the number of seconds (0 to 86400 seconds). The default
value is 600 seconds.
Command Default The default is to use the MIB defaults, which specify that traps are not to be sent, with an interval value
of 600 seconds (10 minutes).
Command Modes Interface configuration (cable interface only) (config-if)
Command History Release Modification
12.0(13)SC This command was introduced.
12.1(5)EC1 This command was added to the 12.1 EC train and support was added for the
Cisco uBR7100 series routers.
12.2(4)BC1 This command was added to the 12.2 BC train and support was added for the
Cisco uBR10012 router.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines This command sets four attributes in the CISCO-DOCS-EXT-MIB MIB, so that the new values can be
automatically loaded whenever the CMTS router powers on or reloads. To do so, put the appropriate
commands in the configuration file and save it to the CMTS router’s Flash memory. The CMTS router
automatically sets the appropriate MIB values when it processes the configuration file at startup.
These commands affect whether the CM online/offline notification trap
(cdxCmtsCmOnOffNotification) is sent, and if so, the minimum interval that must exist between traps
that are sent for the same CM undergoing the same state changes. The following describes the
relationship between these commands and the attributes in the CISCO-DOCS-EXT-MIB MIB:
• The cable enable-trap cmonoff-notification command sets the cdxCmtsCmOnOffTrapEnable
attribute to 1 (true), which enables the sending of the CM online and offline traps.
Cisco IOS CMTS Cable Command Reference
CBL-212 OL-15510-15
Cable Commands: cable e through cable i
cable enable-trap
• The no cable enable-trap cmonoff-notification command sets the cdxCmtsCmOnOffTrapEnable
attribute to 2 (false), which disables the sending of the CM online and offline traps.
• The cable enable-trap cmonoff-interval command sets the cdxCmtsCmOnOffTrapInterval
attribute to the specified time period (0 to 86400 seconds), which sets the minimum interval that
must exist before the CMTS sends out the same trap for the same CM. For example, if the interval
is set to the default of 600 seconds, and the same CM goes offline three times and online twice in
that time period, only one online trap and one offline trap is sent to the SNMP manager.
• The no cable enable-trap cmonoff-interval command sets the cdxCmtsCmOnOffTrapInterval
attribute to 0, which means a trap will be sent for every CM online/offline transition.
Note Setting the cmonoff-interval option and the cdxCmtsCmOnOffTrapInterval attribute has meaning only
if cdxCmtsCmOnOffNotification traps have been previously enabled.
Examples The following commands enable the sending of CM on or off traps, with a minimum interval of 1200
seconds between traps being sent for the same CM:
router(config)# interface c6/0
router(config-if)# cable enable-trap cmonoff-notification
router(config-if)# cable enable-trap cmonoff-interval 1200
router(config-if)# exit
router(config)#
The following commands disable the sending of CM on or off traps.
router(config)# interface c6/0
router(config-if)# no cable enable-trap cmonoff-notification
router(config-if)# exit
router(config)#
Related Commands Command Description
snmp-server enable traps Enables traps for cable-related events.
cable
snmp-server enable traps Enables traps for DOCSIS-related MAC-layer events.
docsis-cmts
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-213
Cable Commands: cable e through cable i
cable event priority
cable event priority
To configure the event reporting flags for DOCSIS event messages, which determines how the
Cisco CMTS reports these events, use the cable event priority command in global configuration mode.
To return to the default settings found in the MIB, use the no form of this command.
cable event priority {alert | critical | debug | emergency | error | informational | notice |
warning} flags
Syntax Description alert Sets the event reporting flag for alert system error messages. (Alert messages
indicate that some type of system or connection failure has occurred and
requires immediate attention.)
critical Sets the event reporting flag for critical system error messages. (Critical
messages indicate that an error occurred which requires immediate attention
to avoid system or connection failure.)
debug Sets the event reporting flag for debug system error messages. (Debug
messages appear only when debugging has been enabled.)
emergency Sets the event reporting flag for emergency system error messages.
(Emergency messages indicate that the system has become unusable and
requires immediate attention. This problem might also be affecting other
parts of the network.)
error Sets the event reporting flag for error system error messages. (Error
messages indicate that an error condition occurred that requires attention to
resolve. Failure to address this problem will result in some type of system or
connection failure in the near future.)
informational Sets the event reporting flag for informational system error messages.
(Informational messages might or might not be significant to the system
administrators.)
notice Sets the event reporting flag for notice system error messages. (Notice
messages indicate that a situation occurred that is normal but is significant
enough that system administrators might want to notice.)
warning Sets the event reporting flag for warning system error messages. (Warning
messages indicate that a condition occurred that indicates attention is needed
in near future to avoid potential problems. Failure to address this problem
could result in some type of system or connection failure later on.)
flags Sets the event reporting flags value, in hex, which specifies how this
particular type of event message should be reported. The valid range is 0x0
through 0xF0, which is a bitmask specifying the types of reporting that
should be done. See the Usage Guidelines for details.
Command Default The defaults are configured as per the DOCSIS 1.1 Operations Support System Interface (OSSI)
Specification:
• Emergency and alert messages = (0x10) (reported to the local volatile log)
• Critical, error, warning, and notice = (0x70) (reported to the local volatile log, and forwarded as
traps and to the SYSLOG server)
• Information and debug = 0x0 (not reported)
Cisco IOS CMTS Cable Command Reference
CBL-214 OL-15510-15
Cable Commands: cable e through cable i
cable event priority
Command Modes Global configuration (config)
Command History Release Modification
12.2(8)BC1 This command was introduced.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
Usage Guidelines The DOCSIS 1.1 specifications require the CMTS to generate a set of messages for DOCSIS-specific
events. These messages can be assigned one of eight priority levels, ranging from emergency (the
highest level) to debug (the lowest level), and the CMTS can be configured to log each level of messages
differently.
The Cisco CMTS supports the following types of logging, as defined by the
DOCS-CABLE-DEVICE-MIB MIB (RFC 2669):
• none (0x0) = DOCSIS messages are not reported. (The corresponding Cisco IOS event messages,
however, continue to be logged.)
• local-volatile (0x10) = DOCSIS messages are saved in a local log on the CMTS. This log can be
limited in size and can automatically discard previous messages to make room for incoming
messages.
• syslog (0x20) = DOCSIS messages are sent to a SYSLOG server (if one has been configured, using
the cable event syslog-server command).
• traps (0x40) = DOCSIS messages are sent as SNMP traps to one or more SNMP managers.
These values can be added together to specify that the CMTS should report an event in more than one
way. For example, a value of 0x70 specifies that the CMTS should record the event in its local volatile
log, and also send it both as a trap and as a SYSLOG message.
Note If event messages are configured for traps or syslog reporting, they must also be configured for either
local volatile or local non-volatile reporting. This means that values 0x20 (syslog-only), 0x40
(trap-only), and 0x60 (syslog and trap only) are not supported.
Use the cable event priority command to set the reporting flags for each type of event. This also
configures the appropriate instance of the docsDevEvReporting attribute DOCS-CABLE-DEVICE-MIB
MIB (RFC 2669) with the same value.
Note This command affects only the DOCSIS event messages, and does not affect how the Cisco IOS software
handles event messages. If SYSLOG traps are enabled on the Cisco CMTS (using the snmp-server
enable traps syslog command), they continue to be sent, regardless of the cable event priority
configuration.
Examples The following commands configure the Cisco CMTS so that it reports all emergency, alert, and critical
messages as SNMP traps and SYSLOG messages, as well as logging it in the local volatile log:
Router# configure terminal
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-215
Cable Commands: cable e through cable i
cable event priority
Router(config)# cable event priority alert 0x70
Router(config)# cable event priority critical 0x70
Router(config)# cable event priority emergency 0x70
The following commands configure the Cisco CMTS so that it reports the lowest priority messages only
to the local volatile log and SYSLOG server:
Router# configure terminal
Router(config)# cable event priority debug 0x30
Router(config)# cable event priority informational 0x30
Router(config)# cable event priority notice 0x30
Related Commands Command Description
cable event syslog-server Enables logging of DOCSIS event messages to a SYSLOG
server.
cable event throttle-adminStatus Configures how the Cisco CMTS throttles the SNMP traps
and SYSLOG messages it generates for DOCSIS event
messages.
cable event throttle-interval Specifies the throttle interval, which helps control how often
the Cisco CMTS generates SNMP traps and SYSLOG
messages for DOCSIS event messages.
cable event throttle-threshold Sets the maximum number of SNMP traps and SYSLOG
messages that the Cisco CMTS can generate for DOCSIS
event messages during the throttle interval.
snmp-server enable traps cable Enables traps for cable-related events.
snmp-server enable traps docsis-cmts Enables traps for DOCSIS-related MAC-layer events.
Cisco IOS CMTS Cable Command Reference
CBL-216 OL-15510-15
Cable Commands: cable e through cable i
cable event syslog-server
cable event syslog-server
To enabling logging of DOCSIS event messages to a SYSLOG server, use the cable event syslog-server
command in global configuration mode. To disable the logging of a DOCSIS syslog server, use the no
form of this command.
cable event syslog-server ip-address
no cable event syslog-server
Syntax Description ip-address Specifies the IPv4 or IPv6 address for the DOCSIS SYSLOG server, which is the
docsDevEvSyslog attribute in the DOCS-CABLE-DEVICE-MIB (RFC 2669). If the IP
address is 0.0.0.0 or 0:0:0:0::0, SYSLOG service is disabled for DOCSIS events.
Command Default 0.0.0.0 or 0:0:0:0::0 (No DOCSIS SYSLOG server is defined.)
Command Modes Global configuration (config)
Command History Release Modification
12.2(8)BC1 This command was introduced.
12.2(33)SCA This command was modified in Cisco IOS Release 12.2(33)SCA to support IPv6
addresses. Support for the Cisco uBR7225VXR router was added.
Usage Guidelines The DOCSIS 1.1 specifications require the CMTS router to generate a set of messages for
DOCSIS-specific events. Use the cable event syslog-server command to enable DOCSIS SYSLOG
services and to set the IP address for the DOCSIS SYSLOG server (which is the docsDevEvSyslog
attribute in the DOCS-CABLE-DEVICE-MIB).
You can also configure the server’s IP address by using SNMP commands to set the docsDevEvSyslog
attribute directly. Setting the docsDevEvSyslog attribute also creates a matching cable event
syslog-server command in the router’s configuration.
When you specify the IP address for a DOCSIS SYSLOG server, either by using the cable event
syslog-server command or by setting the docsDevEvSyslog attribute, the Cisco CMTS router begins
generating event messages that conform to the DOCSIS 1.1 specifications. This format is similar to but
not identical to the format that is used by the Cisco IOS software. For example, the following message
is in the typical Cisco IOS software format:
%UBR7200-4-DCC_ACK_REJ_MSG_SYNTAX_ERROR: DCC-ACK rejected message syntax error
The same error message appears as follows when using the DOCSIS 1.1 format:
<133>CMTS[DOCSIS]:<67040500> DCC-ACK rejected message syntax error
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-217
Cable Commands: cable e through cable i
cable event syslog-server
To disable the sending of events to the DOCSIS SYSLOG server, you can use the no cable event
syslog-server command, or you can specify an IP address of 0.0.0.0 (cable event syslog-server 0.0.0.0).
Both commands set the docsDevEvSyslog attribute to 0.0.0.0 and disable DOCSIS SYSLOG service.
This does not, however, disable the Cisco IOS SYSLOG server (if one has been configured using the
logging ip-address command).
Note You can use the same SYSLOG server for both Cisco IOS event messages and for DOCSIS-style event
messages, but it might be more convenient to use separate servers for the two different message formats.
Use the logging ip-address command in global configuration mode to set the IP address for the
Cisco IOS SYSLOG server. The DOCSIS SYSLOG server collects only event messages for DOCSIS
events, using the DOCSIS format, while the Cisco IOS server collects all event messages (including
DOCSIS events), but using the standard Cisco IOS message format.
Tip For more information about DOCSIS SYSLOG services and event messages, see Section 4.4.2.2.2,
SYSLOG Message Format, in the DOCSIS 1.1 Operations Support System Interface (OSSI)
Specification (SP-OSSIv1.1-I06-020830). For more information about all cable-related event messages
that can be generated on a Cisco CMTS router, see the Cisco CMTS System Messages guide.
Examples The following command sets the docsDevEvSyslog attribute with an IPv4 address of 192.168.100.137:
cable event syslog-server 192.168.100.137
The following commands specifies different SYSLOG servers. The server at IPv4 address
192.168.100.137 receives the DOCSIS-style event messages, and the server at IPv4 address
192.168.100.138 receives the Cisco IOS style messages.
cable event syslog-server 192.168.100.137
logging 192.168.100.138
The following command sets the docsDevEvSyslog attribute to IPv4 address 0.0.0.0, which disables
DOCSIS SYSLOG services:
no cable event syslog-server
Note You can also disable DOCSIS SYSLOG services with the cable event syslog-server 0.0.0.0 command.
The following command specifies a DOCSIS SYSLOG server with an IPv6 address:
cable event syslog-server 2001:0DB8:0:ABCD::1
Related Commands Command Description
cable event priority Configures the event reporting flags for DOCSIS event
messages, which determines how the Cisco CMTS router
reports these events.
cable event throttle-adminStatus Configures how the Cisco CMTS router throttles the SNMP
traps and SYSLOG messages it generates for DOCSIS event
messages.
Cisco IOS CMTS Cable Command Reference
CBL-218 OL-15510-15
Cable Commands: cable e through cable i
cable event syslog-server
Command Description
cable event throttle-interval Specifies the throttle interval, which helps control how often
the Cisco CMTS router generates SNMP traps and SYSLOG
messages for DOCSIS event messages.
cable event throttle-threshold Sets the maximum number of SNMP traps and SYSLOG
messages that the Cisco CMTS router can generate for
DOCSIS event messages during the throttle interval.
snmp-server enable traps cable Enables traps for cable-related events.
snmp-server enable traps docsis-cmts Enables traps for DOCSIS-related MAC-layer events.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-219
Cable Commands: cable e through cable i
cable event throttle-adminStatus
cable event throttle-adminStatus
To configure how the Cisco CMTS router throttles the SNMP traps and syslog messages it generates for
DOCSIS event messages, use the cable event throttle-adminStatus command in global configuration
mode. To restore the default behavior, use the no form of this command.
cable event throttle-adminStatus {inhibited | maintainBelowThreshold | stopAtThreshold |
unconstrained}
no cable event throttle-adminStatus
Syntax Description inhibited All SNMP traps and syslog messages for DOCSIS event messages are
suppressed.
maintainBelowThreshold Throttling is performed, so that SNMP traps and syslog messages are
suppressed if they would otherwise exceed the throttle threshold. The
Cisco CMTS resumes generating traps and messages at the start of the
next throttle interval.
stopAtThreshold Throttling is performed, so that the Cisco CMTS stops generating all
SNMP traps and syslog messages if they would exceed the throttle
threshold. The Cisco CMTS does not resume generating traps and
messages until directed to do so by repeating this command.
unconstrained SNMP traps and syslog messages for DOCSIS event messages are not
throttled.
Command Default unconstrained (no throttling of traps and messages is done)
Command Modes Global configuration (config)
Command History Release Modification
12.2(8)BC1 This command was introduced.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines This command sets the value of the docsDevEvThrottleAdminStatus attribute in the
DOCS-CABLE-DEVICE-MIB MIB (RFC 2669), which controls whether the Cisco CMTS should
throttle SNMP traps and syslog messages that are generated for DOCSIS event messages.
The DOCS-CABLE-DEVICE-MIB MIB supports the following threshold configurations:
• inhibited—The Cisco CMTS does not generate any SNMP traps or syslog messages for DOCSIS
events.
Cisco IOS CMTS Cable Command Reference
CBL-220 OL-15510-15
Cable Commands: cable e through cable i
cable event throttle-adminStatus
• maintainBelowThreshold—Throttling is performed, and SNMP traps and syslog messages are
suppressed if they would exceed the throttle threshold (as set by the cable event throttle-interval
and cable event throttle-threshold commands). The Cisco CMTS resumes generating traps and
messages at the start of the next throttle interval.
• stopAtThreshold—Throttling is performed, and the Cisco CMTS stops generating all SNMP traps
and syslog messages when they exceed the throttle threshold. The Cisco CMTS does not resume
generating traps and messages until the threshold state is reset. This can be done by repeating the
cable event throttle-adminStatus command, or by setting the docsDevEvThrottleAdminStatus
attribute in the DOCS-CABLE-DEVICE-MIB MIB.
• unconstrained—All SNMP traps and syslog messages are transmitted without any throttling.
Tip For more information about DOCSIS syslog services and event messages, see Section 4.4.2.2.2, syslog
Message Format, in the DOCSIS 1.1 Operations Support System Interface (OSSI) Specification
(SP-OSSIv1.1-I06-020830). For more information about all cable-related event messages that can be
generated on the Cisco CMTS router, see the Cisco CMTS Error Message manual.
Examples The following commands configure the Cisco CMTS router to throttle SNMP traps and syslog messages
according to the specified throttle interval and threshold:
Router# configure terminal
Router(config)# cable event throttle-interval 90
Router(config)# cable event throttle-threshold 30
Router(config)# cable event throttle adminStatus maintainBelowThreshold
The following commands configure the Cisco CMTS router for the default behavior, so that it does not
throttle SNMP traps and syslog messages. The configured throttle interval and threshold are ignored.
Router# configure terminal
Router(config)# cable event throttle adminStatus unconstrained
Related Commands Command Description
cable event priority Configures the event reporting flags for DOCSIS event messages,
which determines how the Cisco CMTS reports these events.
cable event syslog-server Enables logging of DOCSIS event messages to a syslog server.
cable event throttle-interval Specifies the throttle interval, which helps control how often the
Cisco CMTS generates SNMP traps and syslog messages for DOCSIS
event messages.
cable event Sets the maximum number of SNMP traps and syslog messages that
throttle-threshold the Cisco CMTS can generate for DOCSIS event messages during the
throttle interval.
snmp-server enable traps Enables traps for cable-related events.
cable
snmp-server enable traps Enables traps for DOCSIS-related MAC-layer events.
docsis-cmts
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-221
Cable Commands: cable e through cable i
cable event throttle-interval
cable event throttle-interval
To specify the throttle interval, which controls how often the Cisco CMTS router generates SNMP traps
and syslog messages for DOCSIS event messages, use the cable event throttle-interval command in
global configuration mode. To restore the default behavior, use the no form of this command.
cable event throttle-interval seconds
no cable event throttle-interval
Syntax Description seconds Length of the throttle interval, in seconds. The valid range is 0 to 2147483647 seconds, with
a default of 60 seconds.
Command Default 60 seconds (1 minute)
Command Modes Global configuration (config)
Command History Release Modification
12.2(8)BC1 This command was introduced.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
Usage Guidelines The DOCSIS 1.1 specifications require the CMTS to generate a set of messages for DOCSIS-specific
events. In certain situations, such as a power outage that causes a mass reregistration of cable modems,
this can generate such a large volume of event messages that it can impact system performance.
To avoid this possibility, use the cable event throttle-interval command, together with the cable event
throttle-threshold command, to specify the maximum number of SNMP traps or syslog events that the
Cisco CMTS can generate for DOCSIS events over a specific interval:
• cable event throttle-interval—Specifies the length of the throttle interval.
• cable event throttle-threshold—Specifies the maximum number of SNMP traps and syslog events
that the Cisco CMTS can generate during that period.
The threshold value counts DOCSIS events, not SNMP traps or syslog messages. If a DOCSIS event
generates both an SNMP trap and a syslog message, the Cisco CMTS counts it as only one event.
Note The cable event throttle-interval and cable event throttle-threshold commands do not have any effect
unless the cable event throttle-adminStatus has been configured to allow the throttling of DOCSIS
event messages.
Cisco IOS CMTS Cable Command Reference
CBL-222 OL-15510-15
Cable Commands: cable e through cable i
cable event throttle-interval
Tip For more information about DOCSIS syslog services and event messages, see Section 4.4.2.2.2, syslog
Message Format, in the DOCSIS 1.1 Operations Support System Interface (OSSI) Specification
(SP-OSSIv1.1-I06-020830). For more information about all cable-related event messages that can be
generated on the Cisco CMTS router, see the Cisco CMTS Error Message manual.
Examples The following commands configure the Cisco CMTS router so that it can generate a maximum number
of 30 SNMP traps and syslog messages for DOCSIS events over a 90-second period:
Router# configure terminal
Router(config)# cable event throttle-interval 90
Router(config)# cable event throttle-threshold 30
Related Commands Command Description
cable event priority Configures the event reporting flags for DOCSIS event
messages, which determines how the Cisco CMTS reports
these events.
cable event syslog-server Enables logging of DOCSIS event messages to a syslog
server.
cable event throttle-adminStatus Configures how the Cisco CMTS throttles the SNMP traps
and syslog messages it generates for DOCSIS event
messages.
cable event throttle-threshold Sets the maximum number of SNMP traps and syslog
messages that the Cisco CMTS can generate for DOCSIS
event messages during the throttle interval.
snmp-server enable traps cable Enables traps for cable-related events.
snmp-server enable traps docsis-cmts Enables traps for DOCSIS-related MAC-layer events.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-223
Cable Commands: cable e through cable i
cable event throttle-threshold
cable event throttle-threshold
To set the maximum number of SNMP traps and syslog messages that the Cisco CMTS router can
generate for DOCSIS event messages during the throttle interval, use the cable event throttle-threshold
command in global configuration mode. To restore the default number, use the no form of this command.
cable event throttle-threshold number
no cable event throttle-threshold
Syntax Description number Maximum allowable number of DOCSIS events for which the Cisco CMTS can generate
SNMP traps and syslog messages during the throttle period. The valid range is 0 to
2147483647, with a default of 10.
Command Default The default maximum is 10.
Command Modes Global configuration (config)
Command History Release Modification
12.2(8)BC1 This command was introduced.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
Usage Guidelines The DOCSIS 1.1 specifications require the CMTS to generate a set of messages for DOCSIS-specific
events. In certain situations, such as a power outage that causes a mass reregistration of cable modems,
this can generate such a large volume of event messages that it can impact system performance.
To avoid this possibility, use the cable event throttle-threshold command, together with the cable
event throttle-interval command, to specify the maximum number of SNMP traps or syslog events that
the Cisco CMTS can generate for DOCSIS events over a specific interval:
• cable event throttle-interval—Specifies the length of the throttle interval.
• cable event throttle-threshold—Specifies the maximum number of SNMP traps and syslog events
that the Cisco CMTS can generate during that period.
The threshold value counts DOCSIS events, not SNMP traps or syslog messages. If a DOCSIS event
generates both an SNMP trap and a syslog message, the Cisco CMTS counts it as only one event.
Note The cable event throttle-interval and cable event throttle-threshold commands do not have any effect
unless the cable event throttle-adminStatus has been configured to allow the throttling of DOCSIS
event messages.
Cisco IOS CMTS Cable Command Reference
CBL-224 OL-15510-15
Cable Commands: cable e through cable i
cable event throttle-threshold
Tip For more information about DOCSIS syslog services and event messages, see Section 4.4.2.2.2, syslog
Message Format, in the DOCSIS 1.1 Operations Support System Interface (OSSI) Specification
(SP-OSSIv1.1-I06-020830). For more information about all cable-related event messages that can be
generated on the Cisco CMTS router, see the Cisco CMTS Error Message manual.
Examples The following commands configure the Cisco CMTS router so that it can generate a maximum number
of 25 SNMP traps and syslog messages for DOCSIS events over a two-minute period:
Router# configure terminal
Router(config)# cable event throttle-interval 120
Router(config)# cable event throttle-threshold 25
Related Commands Command Description
cable event priority Configures the event reporting flags for DOCSIS event
messages, which determines how the Cisco CMTS reports
these events.
cable event syslog-server Enables logging of DOCSIS event messages to a syslog
server.
cable event throttle-adminStatus Configures how the Cisco CMTS throttles the SNMP traps
and syslog messages it generates for DOCSIS event
messages.
cable event throttle-interval Specifies the throttle interval, which helps control how often
the Cisco CMTS generates SNMP traps and syslog messages
for DOCSIS event messages.
snmp-server enable traps cable Enables traps for cable-related events.
snmp-server enable traps docsis-cmts Enables traps for DOCSIS-related MAC-layer events.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-225
Cable Commands: cable e through cable i
cable fiber-node
cable fiber-node
To enter cable fiber-node configuration mode to configure a fiber node, use the cable fiber-node
command in global configuration mode. To remove a fiber node configuration, use the no form of this
command.
cable fiber-node fiber-node-id
no cable fiber-node fiber-node-id
Syntax Description fiber-node-id Specifies a unique numerical ID for the fiber node. Valid values are 1 to 256.
Command Default The command mode is unchanged.
Command Modes Global configuration (config)
Command History Release Modification
12.3(21)BC This command was introduced for the Cisco uBR10012 router.
12.3(23)BC This command was updated to allow an RF channel from the SPA or a Cisco
uBR10-MC5X20 downstream channel can serve as a primary channel in a
fiber node.
Usage Guidelines The cable fiber-node command allows the multiple service operator (MSO) or service provider to
configure the CMTS to be more intelligent by making Cisco IOS aware of how the cable plant is wired.
The downstream channels of the cable plant must be accurately configured in the CMTS fiber nodes.
This allows the CMTS to accurately signal the wideband modems on which wideband channels are
available to the modem.
In a cable network, a cable modem is physically connected to only one fiber node. Fiber node software
configuration mirrors the physical topology of the cable network. When configuring fiber nodes with
Cisco IOS CLI commands, a fiber node is a software mechanism to define the following:
• The set of downstream RF channels that will flow into the fiber node
• At least one primary downstream channel
Note In Cisco IOS Releases 12.3(21)BC and 12.3(21a)BC3, this is a traditional DOCSIS
downstream channel for the fiber node. Beginning in Cisco IOS Release 12.3(23)BC, either
an RF channel from the SPA or a Cisco uBR10-MC5X20 downstream channel can serve as
a primary channel in a fiber node.
• The set of upstream channel ports on the cable interface line card that are connected to the fiber node
and available as upstream channels
Use the cable fiber-node command to enter cable fiber-node configuration mode so that you can
configure a fiber node.
Cisco IOS CMTS Cable Command Reference
CBL-226 OL-15510-15
Cable Commands: cable e through cable i
cable fiber-node
For a wideband channel to work correctly, each fiber node must be configured as follows:
1. Use the cable fiber-node command to create the fiber node and to enter cable fiber-node
configuration mode.
2. Use the downstream command to associate the fiber node with one or more primary downstream
channels (traditional DOCSIS downstream channels).
Note Beginning in Cisco IOS Release 12.3(23)BC, if the primary downstream channel for this
fiber node is assigned from a SPA RF downstream channel, then this command is not
required.
3. Use the upstream command to specify the upstream channel ports for a fiber node.
4. Use the downstream modular-cable rf-channel command to make one or more SPA RF channels
available for the fiber node.
5. Optionally, use the description (cable fiber-node) command to specify a description for the fiber
node.
For each fiber node, a traditional DOCSIS downstream channel on the Cisco uBR10-MC5X20 cable
interface line card is used to carry MAC management and signaling messages, and the associated
traditional DOCSIS upstream channel is used for return data traffic and signaling. The traditional
DOCSIS downstream channel used in this way is called the primary downstream channel. Beginning in
Cisco IOS Release 12.3(23)BC, either an RF channel from the SPA or a Cisco uBR10-MC5X20
downstream channel can serve as a primary channel in a fiber node. If the fiber node does not have a
Cisco uBR10-MC5X20 downstream channel, then make sure that at least one of the SPA RF channels
specified in the downstream modular-cable rf-channel command is a primary-capable downstream
channel.
Each wideband channel must be associated with at least one primary downstream channel and can be
associated with multiple primary downstream channels. A wideband channel and its associated primary
downstream channels must be belong to the same virtual bundle interface.
The maximum number of cable fiber nodes that can be configured is limited to 256 for each CMTS.
Examples The following example shows how to enter configuration mode for fiber node 5.
Cisco IOS Release 12.3(21)BC
Router# configure terminal
Router(config)# cable fiber-node 5
Router(config-fiber-node)#
downstream Cable 6/0/0
downstream Modular-Cable 1/0/0 rf-channel 0-1
upstream cable 5/0 connector 0
Cisco IOS Release 12.3(23)BC
Router# configure terminal
Router# cable fiber-node 5
Router(config-fiber-node)#
downstream Modular-Cable 1/0/0 rf-channel 0-3
upstream cable 5/0 connector 0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-227
Cable Commands: cable e through cable i
cable fiber-node
Related Commands Command Description
description (cable fiber-node) Specifies a description for a fiber node.
downstream cable Assigns a primary downstream channel for a fiber node.
downstream modular-cable Specifies the RF channels that are available for wideband channels
rf-channel on a fiber node.
upstream cable connector Specifies the upstream channel ports for a fiber node.
Cisco IOS CMTS Cable Command Reference
CBL-228 OL-15510-15
Cable Commands: cable e through cable i
cable filter group
cable filter group
To create, configure, and activate a DOCSIS 1.1 filter group that filters packets on the basis of the
TCP/IP and UDP/IP headers, use the cable filter group command in global configuration mode. To
delete a filter group or to reset a particular option to its default value, use the no form of this command.
cable filter group group-id index index-num [option option-value]
no cable filter group group-id index index-num [option option-value]
Syntax Description group-id Specifies a unique group ID for this filter group. The valid range is
1 to 254. 255 is reserved for use by the CMTS router.
index-num Specifies a unique index for this particular filter. The valid range is
1 to 128 on a uBR7200 series router and 1 to 255 on a uBR10012
router.
Specify one of the following options and option-values:
dest-ip ip-address (Optional) Specifies the destination IP address that should be
matched. The default IP address is 0.0.0.0. (IPv4 filters only)
dest-mac-addr mac-address (Optional) Specifies the destination MAC address that should be
matched.
dest-mac-mask mask (Optional) Specifies the mask for the destination MAC address that
should be matched.
dest-mask mask (Optional) Specifies the mask for the destination address that should
be matched. The mask is ANDed with the IP address specified by the
dest-ip option and compared to the result of ANding the mask with
the packet’s destination IP address. The filter considers it a match if
the two values are the same. (IPv4 filters only)
Note The default mask of 0.0.0.0 matches all IP addresses.
dest-port port-number (Optional) Specifies the TCP/UDP destination port number that
should be matched. The valid range is 0 to 65535. The default value
matches all TCP/UDP port numbers. (IPv4 and IPv6 filters)
eth-proto-type ethernet (Optional) Specifies the Ethernet protocol type number that should
protocol type be matched. The valid range is 0 to 65536.
eth-protocol ethernet protocol (Optional) Specifies the Ethernet protocol that should be matched.
number The valid range is 0 to 65536.
ip-proto proto-type (Optional) Specifies the IP protocol type number that should be
matched. The valid range is 0 to 256, with a default value of 256 that
matches all protocols. (IPv4 and IPv6 filters)
Some commonly-used values are:
• 1—ICMP, Internet Control Message Protocol.
• 2—IGMP, Internet Group Management Protocol.
• 4—IP in IP encapsulation.
• 6—TCP, Transmission Control Protocol.
• 17—UDP, User Datagram Protocol.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-229
Cable Commands: cable e through cable i
cable filter group
ip-tos tos-mask tos-value (Optional) Specifies a type of service (TOS) mask and value to be
matched (IPv4 and IPv6 filters):
• tos-mask—8-bit value expressed in hexadecimal notation. The
valid range is 0x00 through 0xFF.
• tos-value—8-bit value expressed in hexadecimal notation. The
valid range is 0x00 through 0xFF.
The tos-mask is logically ANDed with the tos-value and compared
to the result of ANDing the tos-mask with the packet’s actual TOS
value. The filter considers it a match if the two values are the same.
Note The default values for both parameters matches all ToS
values.
ip-version (Optional) Specifies the IP version of the filter:
• ipv4—Filter is an IP version 4 filter group (default).
• ipv6—Filter is an IP version 6 filter group.
match-action {accept | drop} (Optional) Specifies the action that should be taken for packets that
match this filter (IPv4 and IPv6 filters):
• accept—Packets that match the filter are accepted (default).
• drop—Packets that match the filter are dropped.
range-dest-port start-port (Optional) Specifies the TCP/UDP destination port start range. The
number end-port number valid range is 0 to 65535.
range-ip-tos mask against TOS (Optional) Specifies IP TOS byte range settings expressed in
start value and end value hexadecimal notation. The valid range is 0x00 through 0xFF.
range-src-port start-port (Optional) Specifies TCP/UDP source port start range. The valid
number end-port number range is 0 to 65535.
range-user-pri low-priority (Optional) Specifies the user priority.The valid range for priority is
value high-priority value 0 to 8. The Priority field indicates the frame priority level from 0
(lowest) to 8 (highest), which prioritizes different classes of traffic
(such as voice, video and data).
src-ip ip-address (Optional) Specifies the source IP address that should be matched.
The default IP address is 0.0.0.0. (IPv4 filters only)
src-mac-addr mac address (Optional) Specifies the source MAC address to be matched.
src-mask mask (Optional) Specifies the mask for the source address that should be
matched. The mask is ANDed with the IP address specified by the
src-ip option and compared to the result of ANding the mask with
the packet’s source IP address. The filter considers it a match if the
two values are the same. (IPv4 filters only)
Note The default mask of 0.0.0.0 matches all IP addresses.
src-port port-number (Optional) Specifies the TCP/UDP source port number that should
be matched. The valid range is 0 to 65535. The default value
matches all TCP/UDP port numbers. (IPv4 and IPv6 filters)
Cisco IOS CMTS Cable Command Reference
CBL-230 OL-15510-15
Cable Commands: cable e through cable i
cable filter group
status {active | inactive} (Optional) Enables or disables the filter (IPv4 and IPv6 filters):
• active—Enables the filter immediately (default).
• inactive —Disables the filter immediately.
Note You must create a filter group using at least one of the other
options before you can use this command to enable or
disable the filter.
tcp-flags flags-mask flags-value (Optional) Specifies the TCP flag mask and value to be matched
(IPv4 and IPv6 filters):
• flags-mask—8-bit value expressed in hexadecimal notation. The
valid range is 0x0 through 0x3F.
• flags-value—8-bit value expressed in hexadecimal notation.
The valid range is 0x0 through 0x3F.
v6-dest-address ipv6-address (Optional) Specifies the IPv6 destination address that should be
matched using the format X:X:X:X::X. (IPv6 filters only)
v6-dest-pfxlen prefix-length (Optional) Specifies the length of the network portion of the IPv6
destination address. The valid range is 0 to 128. (IPv6 filters only)
v6-flow-label flow-label value (Optional) Specifies the IPv6 flow label to be used by the source to
label packets of a flow. The range is 0 to 1048575. A flow label of
zero is used to indicate packets not part of any flow.
v6-src-address ipv6-address (Optional) Specifies the IPv6 source address that should be matched
using the format X:X:X:X::X. (IPv6 filters only)
v6-src-pfxlen prefix-length (Optional) Specifies the length of the network portion of the IPv6
source address. The valid range is 0 to 128. (IPv6 filters only)
vlan-id vlan-id (Optional) Specifies the VLAN Identifier to be matched, which is a
12-bit field specfying the VLAN to which the packet belongs.The
valid range is 0 to 4094.
Command Default No filter groups are defined. When a filter group is created, it defaults to accepting all source and
destination IP addresses and TCP/UDP ports, all protocol types, and all ToS and TCP flag values.
Command Modes Global configuration (config)
Command History Release Modification
12.1(6)EC1 This command was introduced on the Cisco uBR7100 series and
Cisco uBR7200 series routers.
12.2(2)XF, This command was supported on the Cisco uBR10012 routers.
12.2(4)BC1
12.2(8)BC2 The status option was added to allow filter groups to be activated and
deactivated without removing the filter group’s configuration.
12.2(33)SCA The v6-src-address, v6-dest-address, v6-src-pfxlen, v6-dest-pfxlen, and
ip-version keyword options were added for support of IPv6 filter groups.
Support for the Cisco uBR7225VXR router was added.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-231
Cable Commands: cable e through cable i
cable filter group
Usage Guidelines This command implements DOCSIS 1.1 packet filtering, as defined in the DOCS-SUBMGT-MIB. Each
filter group can contain multiple filters, as defined by the different index numbers.
Note The DOCS-SUBMGT-MIB MIB is supported only on Cisco IOS Release 12.2(8)BC2 and later 12.2 BC
releases. See the description of the docsSubMgtPktFilterTable table in this MIB for further information.
When matching the source or destination addresses, the filter ANDs the mask value with the filter’s
corresponding IP address. The filter then ANDs the mask with the packet’s actual IP address and
compares the two values. If they are the same, the filter matches the packet.
For example, if you specify a src-ip of 192.168.100.0 and a src-mask of 255.255.255.0, the filter
matches all packets that have a source IP address in the range of 192.168.100.0 through
192.168.100.255. Use a mask value of 0.0.0.0 (default) to match all IP addresses. Use a mask value of
255.255.255.255 to match one specific IP address.
Similarly, when comparing TOS values, the filter ANDs the tos-mask parameter with the tos-value
parameter and compares it to the result of ANDing the tos-mask parameter with the packet’s actual TOS
value. If the two values are the same, the filter matches the packet.
Note For the filter group to work for CMs, a CM must re-register after the CMTS router is configured.
Cable Subscriber Management Guidelines
Cable subscriber management is a DOCSIS 1.1 specification, whose functionality can be established
using the following configuration methods:
• CMTS router configuration (via CLI)
• SNMP configuration
• DOCSIS 1.1 configuration file (TLVs 35, 36, and 37)
There are certain CMTS configuration requirements if the CM DOCSIS 1.1 configuration file is not used
to activate cable subscriber management for the CPE. Specifically, if the docsSubMgtCpeActive object
is not provisioned using TLVs 35, 36, and 37 in the DOCSIS 1.1 CM configuration file, then the object
uses the docsSubMgtCpeActiveDefault object setting, which is false. This means that cable subscriber
management functionality is disabled.
Therefore, if you do not provision TLVs 35, 36, and 37, then you must activate the functionality by
specifying the cable submgmt default active global configuration command on the CMTS router.
Note Since TLVs 35, 36, and 37 do not apply to DOCSIS 1.0 CM configuration files, the only way to enable
cable subscriber management for a DOCSIS 1.0 CM is to configure it explicitly on the CMTS router and
activate it by using the cable submgmt default active global configuration command.
IPv6 Cable Filter Group Guidelines
Note When parallel eXpress forwarding (PXF) is configured on the Cisco ubR10012 router, either the
interface ACL (ip access-list command) or the cable filter group commands can be used to filter the
packets.
Consider the following restrictions and guidelines when configuring IPv6 cable filter groups:
• Chained IPv6 headers are not supported.
Cisco IOS CMTS Cable Command Reference
CBL-232 OL-15510-15
Cable Commands: cable e through cable i
cable filter group
• If you need to support IPv4 and IPv6 filters for the same filter group, then you must use a separate
index number with the same filter group ID, and configure one index as ip-version ipv4, and the
other index as ip-version ipv6.
Examples The following example shows configuration of an IPv4 filter group that drops packets with a source IP
address of 10.7.7.7 and a destination IP address of 10.8.8.8, and a source port number of 2000 and a
destination port number of 3000. All protocol types and ToS and TCP flag values are matched:
configure terminal
cable filter group 10 index 10 src-ip 10.7.7.7
cable filter group 10 index 10 src-mask 255.255.0.0
cable filter group 10 index 10 dest-ip 10.8.8.8
cable filter group 10 index 10 dest-mask 255.255.0.0
cable filter group 10 index 10 ip-proto 256
cable filter group 10 index 10 src-port 2000
cable filter group 10 index 10 dest-port 3000
cable filter group 10 index 10 tcp-flags 0 0
cable filter group 10 index 10 match-action drop
IPv6 Example
The following example shows the configuration of an IPv6 filter group that drops traffic from a specific
IPv6 host (with source address 2001:33::20B:BFFF:FEA9:741F/128) behind a cable router to an IPv6
host on the network (with destination address 2001:1::224/128):
configure terminal
!
! Specify the filter group criteria using ID 254
!
cable filter group 254 index 128 v6-src-address 2001:33::20B:BFFF:FEA9:741F
cable filter group 254 index 128 v6-src-pfxlen 128
cable filter group 254 index 128 v6-dest-address 2001:1::224
cable filter group 254 index 128 v6-dest-pfxlen 128
!
! Specify that the filter group is IPv6
!
cable filter group 254 index 128 ip-version IPv6
!
! Specify the drop action for matching packets
!
cable filter group 254 index 128 match-action drop
!
! Apply the filter group with ID 254 to all CM upstream traffic
!
cable submgmt default filter-group cm upstream 254
Related Commands Command Description
show cable filter Displays the DOCSIS 1.1 filter groups that are currently defined.
cable submgmt default Sets the default values for attributes in the Subscriber Management MIB
(DOCS-SUBMGT-MIB), and enables the Cisco Static CPE Override
feature on the Cisco CMTS.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-233
Cable Commands: cable e through cable i
cable flap-list aging
cable flap-list aging
To specify the number of days to keep a CM in the flap-list table before aging it out of the table, use the
cable flap-list aging command in global configuration mode. To disable this feature, use the no form of
this command.
cable flap-list aging minutes
no cable flap-list aging
Syntax Description minutes Specifies how long, in minutes, that a CM remains in the flap list. The valid range is 1 to
86400, with a default of 10080 minutes.
Command Default The default length of time that a CM is kept in the flap-list table is 10080 minutes (1 week).
Command Modes Global configuration (config)
Command History Release Modification
11.3 NA This command was introduced.
12.0(4)XA, 12.1 T, 12.1 EC The days parameter was removed.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
Support for the Cisco uBR7225VXR router was added.
Usage Guidelines Flapping refers to the rapid disconnecting and reconnecting of a CM that is having problems holding its
connection to the CMTS. A flap list is a table maintained by the Cisco CMTS for every modem (active
or not) that is having communication difficulties. The flap list contains modem MAC addresses and logs
the time of the most recent activity. You can configure the size and entry thresholds for the flap list.
Examples The following example shows how to specify that the flap-list table retain 2400 minutes (40 hours) of
performance for this CM:
Router(config)# cable flap-list aging 2400
Related Commands Command Description
cable flap-list insertion-time Sets the insertion time interval that determines whether a
CM is placed in the flap list.
cable flap-list miss-threshold Specifies miss threshold for recording a flap-list event.
cable flap-list power-adjust threshold Specifies the power-adjust threshold for recording a CM
flap-list event.
Cisco IOS CMTS Cable Command Reference
CBL-234 OL-15510-15
Cable Commands: cable e through cable i
cable flap-list aging
Command Description
cable flap-list size Specifies the maximum number of CMs that can be listed in
the flap-list table.
clear cable flap-list Clears all the entries in the flap-list table.
debug cable flap Displays information about the operation of the CM flap list
that is maintained for the cable interfaces.
ping docsis Sends a DOCSIS ping to a CM and increments the flap-list
counters as appropriate.
show cable flap-list Displays the current contents of the flap list.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-235
Cable Commands: cable e through cable i
cable flap-list insertion-time
cable flap-list insertion-time
To set the cable flap-list insertion time interval, use the cable flap-list insertion-time command in
global configuration mode. To disable insertion time, use the no form of this command.
cable flap-list insertion-time seconds
no cable flap-list insertion-time
Syntax Description seconds Insertion time interval in seconds. Valid values are from 60 to 86,400 seconds. The default
value is 180 seconds (3 minutes).
Command Default The default insertion time interval is 180 seconds (3 minutes).
Command Modes Global configuration (config)
Command History Release Modification
12.1 T This command was introduced.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
Usage Guidelines This command controls the operation of a flapping modem detector. When a CM makes two or more
initial Ranging Requests (also known as insertion or reinsertion requests) within the period of time
defined by this command, the CM is placed in the flap list. A CM is not put into the flap list if the time
between its two consecutive initial Ranging Requests is greater than the insertion time interval.
For example, if the CMTS is configured for the default insertion time of three minutes, and if the CM
reinserts itself four minutes after its last insertion, the CM is not placed in the flap list. However, if the
CM reinserts itself two minutes after its last insertion, the CM is placed in the flap list.
Also, a CM is put into the flap list only once for each insertion time interval, even if the CM reinserts
itself multiple times. For example, if the CMTS is set for the default insertion time interval of 3 minutes,
and the CM reinserts itself three times within that period, the flap list will show that the CM has flapped
once. If the CM reinserts itself three times within the first 3 minute period and three more times within
the next 3 minute period, the flap list will show that the CM has flapped twice.
Examples The following example shows how to set the insertion time interval to 62 seconds:
Router(config)# cable flap-list insertion-time 62
Cisco IOS CMTS Cable Command Reference
CBL-236 OL-15510-15
Cable Commands: cable e through cable i
cable flap-list insertion-time
Related Commands Command Description
cable flap-list aging Specifies the number of days to keep a CM in the flap-list
table before aging it out of the table.
cable flap-list miss-threshold Specifies miss threshold for recording a flap-list event.
cable flap-list power-adjust threshold Specifies the power-adjust threshold for recording a CM
flap-list event.
cable flap-list size Specifies the maximum number of CMs that can be listed in
the flap-list table.
clear cable flap-list Clears all the entries in the flap-list table.
debug cable flap Displays information about the operation of the CM flap list
that is maintained for the cable interfaces.
ping docsis Sends a DOCSIS ping to a CM and increments the flap-list
counters as appropriate.
show cable flap-list Displays the current contents of the flap list.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-237
Cable Commands: cable e through cable i
cable flap-list miss-threshold
cable flap-list miss-threshold
To set the miss threshold for recording a flap-list event, use the cable flap-list miss-threshold command
in global configuration mode. To disable this function, use the no form of this command.
cable flap-list miss-threshold misses
no cable flap-list miss-threshold
Syntax Description misses Specifies the number of consecutive MAC-layer keepalive (Station Maintenance) that can be
missed before a CM is placed in the flap list. The valid range is 1 to 12, with a default of 6.
Command Default The default number of station maintenance messages that can be missed is 6.
Command Modes Global configuration (config)
Command History Release Modification
12.1 T This command was introduced.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
Usage Guidelines In a DOCSIS network, the CMTS regularly sends out MAC-layer keepalive messages, known as station
maintenance messages, to each CM that is online. If a CM does not respond to a station maintenance
message, the CMTS repeats sending these messages either until the CM responds or the CMTS reaches
the maximum allowable number of messages that can be sent.
The cable flap-list miss-threshold command specifies how many consecutive station maintenance
messages can be missed before the cable modem is placed in the flap list. A miss occurs when a CM does
not reply to a station maintenance message.
Note Station maintenance messages are occasionally lost due to noise or congestion in a typical DOCSIS
network, with a loss rate of approximately 8 percent considered nominal. A higher miss rate can indicate
RF plant problems, such as intermittent upstream problems, fiber laser clipping, or common-path
distortion.
Examples The following example shows how to set the miss threshold to 5:
Router(config)# cable flap-list miss-threshold 5
Cisco IOS CMTS Cable Command Reference
CBL-238 OL-15510-15
Cable Commands: cable e through cable i
cable flap-list miss-threshold
Related Commands Command Description
cable flap-list aging Specifies the number of days to keep a CM in the flap-list
table before aging it out of the table.
cable flap-list insertion-time Sets the insertion time interval that determines whether a CM
is placed in the flap list.
cable flap-list power-adjust threshold Specifies the power-adjust threshold for recording a CM
flap-list event.
cable flap-list size Specifies the maximum number of CMs that can be listed in
the flap-list table.
clear cable flap-list Clears all the entries in the flap-list table.
debug cable flap Displays information about the operation of the CM flap list
that is maintained for the cable interfaces.
ping docsis Sends a DOCSIS ping to a CM and increments the flap-list
counters as appropriate.
show cable flap-list Displays the current contents of the flap list.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-239
Cable Commands: cable e through cable i
cable flap-list power-adjust threshold
cable flap-list power-adjust threshold
To specify the power-adjust threshold for recording a flap-list event, use the cable flap-list
power-adjust threshold command in global configuration mode. To disable power-adjust thresholds,
use the no form of this command.
cable flap-list power-adjust threshold dB
no cable flap-list power-adjust threshold
Syntax Description dB Specifies the minimum power adjustment, in decibels, that results in a flap-list event. Valid values
are from 1 to 10 dB.
Command Default The default minimum power adjustment threshold is 2 dB.
Command Modes Global configuration (config)
Command History Release Modification
12.1 T This command was introduced.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
Usage Guidelines This command controls the operation of a flapping modem detector. When the power adjustment of a
CM exceeds the configured threshold value, the modem is placed in the flap list.
Note A power adjustment threshold of less than 2 dB might cause excessive flap-list event recording. Cisco
recommends setting this threshold value to 3 dB or higher.
Note For underground HFC networks with 4 amplifier cascade length, a typical threshold value should be 3
dB. For overhead HFC networks with 4 amplifier cascade length, a typical threshold value should be 4
dB. Longer coaxial cascades without return path thermal gain control and sites with extreme daily
temperatures will have larger threshold ranges.
Examples The following example shows the power-adjust threshold being set to 5 dB:
Router(config)# cable flap-list power-adjust threshold 5
Cisco IOS CMTS Cable Command Reference
CBL-240 OL-15510-15
Cable Commands: cable e through cable i
cable flap-list power-adjust threshold
Related Commands Command Description
cable flap-list aging Specifies the number of days to keep a CM in the flap-list table before
aging it out of the table.
cable flap-list insertion-time Sets the insertion time interval that determines whether a CM is
placed in the flap list.
cable flap-list miss-threshold Specifies miss threshold for recording a flap-list event.
cable flap-list size Specifies the maximum number of CMs that can be listed in the
flap-list table.
clear cable flap-list Clears all the entries in the flap-list table.
debug cable flap Displays information about the operation of the CM flap list that is
maintained for the cable interfaces.
ping docsis Sends a DOCSIS ping to a CM and increments the flap-list counters
as appropriate.
show cable flap-list Displays the current contents of the flap list.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-241
Cable Commands: cable e through cable i
cable flap-list size
cable flap-list size
To specify the maximum number of CMs that can be displayed from the flap-list table, use the cable
flap-list size command in global configuration mode. To reset it to the default flap-list table size, use
the no form of this command.
cable flap-list size number
no cable flap-list size
Syntax Description number Maximum number of CMs to be displayed. Valid values are from 1 to
8191 depending on the type of line cards, with a default of 100 CMs.
Command Default None
Command Modes Global configuration (config)
Command History Release Modification
12.1 T This command was introduced.
Usage Guidelines • The flap-list size is determined by the architecture of the CMTS and the cable line cards. Previously,
the cable flap-list tables were stored on the Route Processors and Performance Routing Engine
(PRE) modules.
• The legacy non-distributed cable line cards, Cisco uBR-MC16C/MC16E/MC16S line card and
Cisco uBR-MC28C/MC28E line card did not store the flap-list tables in the line cards.
• The distributed line cards are designed such that they store the flap-list tables on the line cards. For
a CMTS using distributed line cards, the flap-list size is the maximum size per line card.
• The distributed line cards supported on a Cisco uBR7200 router are Cisco uBR-MC28U/X and
Cisco uBR-16U/16X.
• The distributed line cards supported on a Cisco uBR10012 router are Cisco uBR10-MC5X20S/U/H.
• You can calculate the flap list sizes using the following formulas:
– For a Cisco uBR10012 router without line card high availability (LC-HA)—8191 * (Number of
cable line cards)
– For a Cisco uBR10012 router with line card high availability (LC-HA)—8191 * (Number of
cable line cards - 1)
– For a Cisco uBR72VXR router using legacy and distributed line cards—8191 * (1 + Number of
distributed cable line cards)
• The flap-list tables sizes are as follows:
– A fully loaded Cisco uBR10012 router
With distributed line cards and no LC-HA configured—8191 * 8 = 65528 CMs.
Cisco IOS CMTS Cable Command Reference
CBL-242 OL-15510-15
Cable Commands: cable e through cable i
cable flap-list size
With distributed line cards and LC-HA configured—8191 * (8-1) = 57337 CMs.
Note Legacy line cards behave as the distributed line cards on a Cisco uBR10012 router. Thus,
the flap-list sizes are same as for distributed line cards.
– A fully loaded Cisco uBR7246VXR router
With distributed line cards— 8191 * 6 = 49146 CMs.
With legacy line cards—8191 * (1+0) = 8191 CMs.
With legacy and distributed line cards— 8191 * (1 + no of the distributed line cards) CMs.
Examples The following example shows how to display a maximum of 200 flap-list entries:
Router#configure terminal
Router(config)#cable flap-list size 200
Router(config)#
Related Commands Command Description
cable flap-list aging Specifies the number of days to keep a CM in the flap-list
table before aging it out of the table.
cable flap-list insertion-time Sets the insertion time interval that determines whether a
CM is placed in the flap list.
cable flap-list miss-threshold Specifies miss threshold for recording a flap-list event.
cable flap-list power-adjust threshold Specifies the power-adjust threshold for recording a CM
flap-list event.
clear cable flap-list Clears all the entries in the flap-list table.
debug cable flap Displays information about the operation of the CM flap list
that is maintained for the cable interfaces.
ping docsis Sends a DOCSIS ping to a CM and increments the flap-list
counters as appropriate.
show cable flap-list Displays the current contents of the flap list.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-243
Cable Commands: cable e through cable i
cable freq-range
cable freq-range
To configure the Cisco CMTS router for the range of frequencies that are acceptable on upstreams, use
the cable freq-range command in global configuration mode. To restore the default value (which is
based on the cable interface and on the Annex A/B configuration), use the no form of this command.
cable freq-range [european | japanese | north-american]
no cable freq-range
Note The frequency range specified in this command does not apply to upstreams of the
Cisco uBR-MC3GX60V cable interface line cards. To specify the upstream frequency for the
Cisco uBR-MC3GX60V cable interface line card, use the cable upstream frequency command.
Syntax Description european Configures the Cisco CMTS router to accept upstream frequency ranges that
conform with the EuroDOCSIS specifications (5 MHz to 65 MHz).
japanese Configures the Cisco CMTS router to accept upstream frequency ranges that
conform to the extended range used in Japan (5 MHz to 55 MHz).
north-american Configures the Cisco CMTS router to accept upstream frequency ranges that
conform to the DOCSIS specifications (5 MHz to 42 MHz).
Command Default no cable freq-range, which defaults to a frequency range based on the Annex configuration:
• Annex A = european (EuroDOCSIS, 5 MHz to 65 MHz)—Supported only on cable interfaces that
support EuroDOCSIS
• Annex B = north-american (DOCSIS, 5 MHz to 55 MHz)—All cable interfaces support the 5 MHz
to 42 MHz range. The 42 MHz to 55 MHz range is supported only on certain cable interfaces.
Command Modes Global configuration (config)
Command History Release Modification
12.2(15)BC2 This command was introduced for the Cisco uBR7246VXR and Cisco uBR10012
universal broadband routers.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for
the Cisco uBR7225VXR router was added.
Usage Guidelines In Cisco IOS Release 12.2(15)BC2 and later, the Cisco CMTS router supports three different modes of
operation, depending on the cable interface line cards being used. The range of frequencies that are
allowed in each mode are as follows:
• North American DOCSIS (Annex B)—Upstreams use frequencies between 5 MHz and 42 MHz.
This range is supported by all cable interface line cards.
Cisco IOS CMTS Cable Command Reference
CBL-244 OL-15510-15
Cable Commands: cable e through cable i
cable freq-range
• European EuroDOCSIS (Annex A)—Upstreams use frequencies between 5 MHz and 65 MHz.
• Japanese Extended Range (Annex B)—Upstreams use frequencies between 5 MHz and 55 MHz.
To configure the router so that it supports the proper range of upstream frequencies, use the upstream
freq-range command. After you have configured the router with the cable freq-range command, the
cable upstream frequency and cable spectrum-group (interface configuration) commands then
accept only frequencies that are in the configured range.
Typically, the upstream freq-range command is not needed because the default behavior covers the
most common configurations. However, this command can be used in the following situations:
• This command is required to enable EuroDOCSIS operations on the Cisco uBR-MC16U/X and
Cisco uBR-MC28U/X cards.
• This command is never needed for the Cisco uBR-MC5X20U card nor for EuroDOCSIS cable
interfaces (Cisco uBR-MC16E card, and the Cisco uBR7111E and Cisco uBR7114E routers),
because these interfaces default to the EuroDOCSIS range of frequencies. However, if you have
previously used this command to restrict the allowable range of frequencies, you must use the
european option to re-enable the EuroDOCSIS range of frequencies.
• The north-american option is usually not needed, because this is the default mode of operations for
all DOCSIS cable interfaces. However, this option can be useful on the Cisco uBR-MC16U/X and
Cisco uBR-MC28U/X cards when noise exists on the frequencies above 42 MHz. In this situation,
using the north-american option filters out the higher frequencies and reduces the impact of that
noise.
• Similarly, the japanese option is not needed on those cable interface cards that support it, because
this is the default configuration on those cards. However, if you have previously used the
north-american option on an interface, you need to use the japanese option to re-enable the
extended frequency range.
• Even when the upstream freq-range command is not needed to enable a frequency range, using it
ensures that the cable upstream frequency and cable spectrum-group commands allow only
frequencies that are within the desired range. This can help operators from assigning invalid
frequencies to upstreams.
Tip If one or more cable interface line cards that are installed in the chassis do not support the frequency
range that you select with this command, the command displays an informational warning message for
each of those cable interface cards. Also, you cannot configure the router for a particular frequency range
if an upstream or spectrum group on the router is currently configured for a frequency that is invalid for
the new range. If you try to do so, the command is ignored and a warning message is printed prompting
you to reconfigure the upstream or spectrum group before retrying the command.
Note This command configures only the range of frequencies that can be configured on an upstream. It does
not configure the upstreams for the DOCSIS (Annex B) or EuroDOCSIS (Annex A) modes of operation,
which is done using the cable downstream annex interface command. (Annex C mode is not
supported.) You must configure the downstream for Annex A for EuroDOCSIS operations and Annex B
for DOCSIS operations. You can configure certain cable interface cards (such as the
Cisco uBR-MC28U) for both the DOCSIS Annex B mode and the EuroDOCSIS frequency range, but
this violates the DOCSIS specifications and should not be used on standard DOCSIS networks.
The allowable range for the upstream channel frequency depends on the cable interface line card and
Cisco IOS software release being used. See Table 2-11 for the currently supported values.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-245
Cable Commands: cable e through cable i
cable freq-range
Table 0-9 Allowable Frequency Range for Cable Interface Line Cards
Frequency Range Supported Cable Interfaces Minimum Cisco IOS Releases
5 to 42 MHz All cable interfaces All releases supported for the Cisco CMTS
5 to 55 MHz Cisco uBR-MC16E, Cisco IOS Release 12.2(15)BC2
Cisco uBR-MC16U/X,
Cisco uBR-MC28U/X,
Cisco uBR-MC5X20U
5 to 65 MHz Cisco uBR-MC16E, Cisco IOS Release 12.0(13)SC and 12.1(4)EC for
Cisco uBR-MC16U/X, Cisco uBR-MC16E
Cisco uBR-MC28U/X, Cisco IOS Release 12.1(5)EC1 for Cisco uBR711E
Cisco uBR-MC5X20U, and Cisco uBR7114E
Cisco uBR7111E and
Cisco uBR7114E routers Cisco IOS Release 12.2(15)BC2 for
Cisco uBR-MC16U/X, Cisco uBR-MC28U/X, and
Cisco uBR-MC5X20U
Note The cable freq-range command fails if any upstreams or spectrum groups on the router are currently
configured for a frequency that is outside the new range being selected. You must reconfigure those
upstreams or spectrum groups, using the cable upstream frequency or cable spectrum-group
commands, for lower frequencies, and then repeat the cable freq-range command.
Examples The following example shows how to configure the Cisco CMTS router to support the EuroDOCSIS
upstream frequency range of 5 MHz to 65 MHz. The router then displays a list of the cable interface line
cards, if any, that do not support this range. After giving this command, the cable upstream frequency
command shows the valid range of upstream frequencies as being the EuroDOCSIS range:
Router# configure terminal
Router(config)# cable freq-range european
Interface Cable3/0 does not support European frequency range
Interface Cable3/1 does not support European frequency range
Interface Cable5/0 does not support European frequency range
Interface Cable5/1 does not support European frequency range
Router(config)# interface cable 6/0 ! This cable interface supports EuroDOCSIS
Router(config-if)# cable upstream 0 frequency ?
<5000000-65000000> Return Frequency in HZ
Router(config-if)#
The following example shows how to configure the Cisco CMTS router to support the extended
Japanese upstream frequency range of 5 MHz to 55 MHz. The router then displays a list of the cable
interface line cards, if any, that do not support this range. After giving this command, the cable
upstream frequency command shows the valid range of upstream frequencies as being the extended
frequency range for Japanese networks:
Router# configure terminal
Router(config)# cable freq-range japanese
Interface Cable3/0 does not support Japanese frequency range
Cisco IOS CMTS Cable Command Reference
CBL-246 OL-15510-15
Cable Commands: cable e through cable i
cable freq-range
Interface Cable4/0 does not support Japanese frequency range
Interface Cable5/0 does not support Japanese frequency range
Router(config)# interface cable 6/0 ! This cable interface supports the Japanese range
Router(config-if)# cable upstream 0 frequency ?
<5000000-55000000> Return Frequency in HZ
The following example shows how to configure the Cisco CMTS router for its default configuration
(DOCSIS upstream frequency range of 5 MHz to 42 MHz). (No warning messages are displayed with
this configuration because all cable interface line cards support the basic DOCSIS frequency range.)
After giving this command, the cable upstream frequency command shows the valid range of upstream
frequencies as being the DOCSIS range:
Router# configure terminal
Router(config)# cable freq-range north-american
Router(config)# interface cable 3/0
Router(config-if)# cable upstream 0 frequency ?
<5000000-42000000> Return Frequency in HZ
The following example shows all of the commands that are needed to configure the cable interface and
upstream on a Cisco uBR-MC28U/X cable interface line card to support a frequency in the EuroDOCSIS
upstream frequency range of 5 MHz to 65 MHz:
Router# configure terminal
Router(config)# cable freq-range european
Router(config)# interface 3/0
Router(config-if)# cable downstream annex a
Router(config-if)# cable upstream 0 frequency 62500000
The following example shows the cable freq-range command failing because an upstream is configured
for a frequency that is invalid for the new range. The upstream must be reconfigured before the cable
freq-range command can be given successfully.
Router# configure terminal
Router(config)# cable freq-range japanese
%%Interface Cable 3/0/U0 has invalid frequency (62500000 Hz) for specified range
%%Set upstream frequencies within range prior to changing freq-range
Router(config)# interface 3/0
Router(config-if)# cable upstream 0 frequency 38600000
Router(config-if)# exit
Router(config)# cable freq-range japanese
Related Commands Command Description
cable downstream annex Sets the Motion Picture Experts Group (MPEG) framing format for a
downstream port on a cable interface line card.
cable upstream frequency Configures a fixed frequency of the upstream radio frequency (RF)
carrier for an upstream port.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-247
Cable Commands: cable e through cable i
cable helper-address
cable helper-address
To specify a destination IP address for User Datagram Protocol (UDP) broadcast Dynamic Host
Configuration Protocol (DHCP) packets, use the cable helper-address command in cable interface or
subinterface configuration mode. To disable this feature, use the no form of this command.
cable helper-address IP-address [cable-modem | host | mta | stb]
no cable helper-address IP-address [cable-modem | host | mta | stb]
Syntax Description IP-address The IP address of a DHCP server to which UDP broadcast packets will
be sent.
cable-modem (Optional) Specifies that only CM UDP broadcasts are forwarded.
host (Optional) Specifies that only host UDP broadcasts are forwarded.
mta (Optional) Specifies that only media terminal adapter (MTA) UDP
broadcasts are forwarded.
stb (Optional) Specifies that only set-top box (STB) UDP broadcasts are
forwarded.
Defaults If no options are specified, both CM and host UDP broadcasts are forwarded.
Command Modes Interface and subinterface configuration (cable interface only)
Command History Release Modification
12.1 T This command was introduced.
12.1(3a)EC This command was modified to add the subinterface support.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.3(33)SCB and the
mta and stb keywords were added.
Usage Guidelines This command enables CMs and their attached CPE devices (hosts) to use separate DHCP servers, so
that CMs and hosts receive their IP addresses from separate address pools. The cable-modem keyword
specifies that only UDP DHCP broadcasts from CMs are forwarded to that particular destination IP
address. The host keyword specifies that only UDP broadcasts from hosts (CPE devices) are forwarded
to that particular destination IP address.
Note You must specify both the cable-modem or host options in separate commands, using separate IP
addresses, if you decide to use them. If you specify only one option, then the other type of device (cable
modem or host) will not be able to connect with a DHCP server. In addition, if you use the cable-modem
or host option with the same IP address that was previously configured with this command, the new
configuration overwrites the old configuration.
Cisco IOS CMTS Cable Command Reference
CBL-248 OL-15510-15
Cable Commands: cable e through cable i
cable helper-address
The cable helper-address command is similar to the ip helper-address command, but the cable
helper-address command has been enhanced for cable interfaces and DOCSIS networks to allow
separate helper addresses for CMs and hosts. Use only the cable helper-address command on cable
interfaces, and use the ip helper-address command on all non-cable interfaces.
The cable helper-address command, as is the case with the ip helper-address command, cannot be
used on slave interfaces, so these commands are automatically removed from an interface configuration
when the interface is configured as a slave interface. Slave interfaces use the IP configuration of the
master interface, which includes not only the IP address for the interface itself, but also the helper
addresses that have been configured on the master interface.
Tip You can repeat this command to specify any number of helper addresses, but the Cisco IOS software
uses only the first 16 valid addresses that are configured on each interface (using either the cable
helper-address command or the ip helper-address command) when forwarding DHCP requests.
Examples The following example shows how to forward UDP broadcasts from both CMs and CPE devices to the
DHCP server at 172.23.66.44:
Router(config)# interface cable 1/0
Router(config-if)# cable helper-address 172.23.66.44
Router(config-if)# exit
Router(config)#
The following example shows how to forward UDP broadcasts from CMs and CPE devices to separate
DHCP servers:
Router(config)# interface cable 6/0
Router(config-if)# cable helper-address 172.23.66.143 host
Router(config-if)# cable helper-address 172.23.66.144 cable-modem
Router(config-if)# exit
Router(config)#
The following example shows that when you specify the cable-modem and host options with the same
IP address, the second command overwrites the first one:
Router(config)# interface cable 3/0
Router(config-if)# cable helper-address 10.10.10.13 host
Router(config-if)# cable helper-address 10.10.10.13 cable-modem
Router(config-if)# exit
Router(config)# exit
Router# show running-config | include helper-address
cable helper-address 10.10.10.13 cable-modem
Router#
Related Commands Command Description
cable dhcp-giaddr Modifies the GIADDR field of DHCPDISCOVER and
DHCPREQUEST packets with a Relay IP address before they are
forwarded to the DHCP server.
cable relay-agent-option Enables the system to insert the CM MAC address into a DHCP
packet received from a CM or host and forward the packet to a DHCP
server.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-249
Cable Commands: cable e through cable i
cable helper-address
Command Description
cable source-verify Turns on CM upstream verification.
cable telco-return spd Enforces the telco-return CM to use a specific Dynamic Host
dhcp-authenticate Configuration Protocol (DHCP) server.
cable telco-return spd Identifies the IP address of the Dynamic Host Configuration Protocol
dhcp-server (DHCP) server that the telco-return CM must access.
ip dhcp relay information Enables the system to insert the CM MAC address into a DHCP
option packet received from a CM or host and forward the packet to a DHCP
server.
ip dhcp smart-relay Monitors client retransmissions when address pool depletion occurs.
Cisco IOS CMTS Cable Command Reference
CBL-250 OL-15510-15
Cable Commands: cable e through cable i
cable host access-group
cable host access-group
To configure the access list for a host, use the cable host command in privileged EXEC mode. To
remove an access list, use this command with the no access-group option.
cable host {ip-address | mac-address} access-group {access-list | access-name}
cable host {ip-address | mac-address} no access-group
Syntax Description ip-address IP address for the device.
mac-address MAC address for the device.
access-group Enables access-group options. The no form removes access-group
specifications.
access-list | access-name Specifies the IP access list (standard or extended), either by access-list
number (1 to 199) or by access-list name.
Command Default No default behaviors or values
Command Modes Privileged EXEC (#)
Command History Release Modification
11.3 NA This command was introduced.
12.2(4)BC1 The functionality of this command was made identical to that of the cable modem
access-group command, but both commands were retained for backwards
compatibility.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
Usage Guidelines For the virtual route forwarding (VRF) syntax of this command, only the IP address option is supported.
Note The cable host command, and its SNMP equivalent, cdxCmCpeAccessGroup, are not supported on the
Cisco uBR10012 universal broadband router. On this router, use the standard DOCSIS MIB,
DOCS-SUBMGT-MIB, instead.
Tip This command is equivalent to configuring cdxCmCpeAccessGroup in CISCO-DOCS-EXT-MIB.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-251
Cable Commands: cable e through cable i
cable host access-group
Examples The following example shows how to assign access list number 2 to the cable host with an IP address of
10.1.1.1:
Router# cable host 10.1.1.1 access-group 2
Related Commands Command Description
cable device Configures an access list for a CM device or host.
cable modem access-group Configures the access-group for a CM.
clear cable host Clears the host from the table.
show cable device access-group Display the CMs and the hosts behind the CMs on the network.
show cable host access-group Displays the hosts behind the CMs on the network.
Cisco IOS CMTS Cable Command Reference
CBL-252 OL-15510-15
Cable Commands: cable e through cable i
cable high-priority-call-window
cable high-priority-call-window
To set the call window (in minutes) during which the Cisco CMTS router maintains records of
Emergency 911 calls, use the cable high-priority-call-window command in global configuration mode.
To remove the call window configuration from the Cisco CMTS router, use the no form of this
command:
cable high-priority-call-window minutes
no cable high-priority-call-window
Syntax Description window This value defines the length of time, in minutes, for which E911 Call History is to be
maintained.
Command Default This command and the PacketCable Emergency 911 Services Listing and History feature is disabled by
default on the Cisco CMTS.
Command Modes Global configuration (config)
Command History Release Modification
12.3(13a)BC This command was introduced supporting PacketCable Emergency 911 Services
Listing and History on the Cisco CMTS:
• Cisco uBR7246VXR router
• Cisco uBR10012 router
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
Usage Guidelines The following command example configures the call window on the Cisco uBR10012 router to be 1
minute in length:
Router(config)# cable high-priority-call-window 1
To observe Emergency 911 calls made within the configured window, use the show cable calls
command in privileged EXEC mode:
The following command example illustrates that one Emergency 911 call was made on the Cable8/1/1
interface on the Cisco uBR10012 router during the window set for high priority calls:
Router# show cable calls
Interface ActiveHiPriCalls ActiveAllCalls PostHiPriCallCMs RecentHiPriCMs
Cable5/0/0 0 0 0 0
Cable5/0/1 0 0 0 0
Cable5/1/0 0 0 0 0
Cable5/1/1 0 0 0 0
Cable5/1/2 0 0 0 0
Cable5/1/3 0 0 0 0
Cable5/1/4 0 0 0 0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-253
Cable Commands: cable e through cable i
cable high-priority-call-window
Cable6/0/0 0 0 0 0
Cable6/0/1 0 0 0 0
Cable7/0/0 0 0 0 0
Cable7/0/1 0 0 0 0
Cable8/1/0 0 0 0 0
Cable8/1/1 1 1 0 0
Cable8/1/2 0 0 0 0
Cable8/1/3 0 0 0 0
Cable8/1/4 0 0 0 0
Total 1 1 0 0
Related Commands Command Description
show cable calls Displays voice call history information and status for the PacketCable
Emergency 911 Services Listing and History feature.
show cable modem calls Displays voice call information for a particular cable modem.
Cisco IOS CMTS Cable Command Reference
CBL-254 OL-15510-15
Cable Commands: cable e through cable i
cable igmp static-group
cable igmp static-group
To configure cable per-physical-downstream static multicast support on the Cisco CMTS router, use the
cable igmp static-group command in global configuration mode.
cable igmp static-group multicast-group-ip [source source-ip] [subinterface]
Syntax Description multicast-group-ip IP address of the multicast group.
source source-ip (Optional) Source IP address for SSM.
subinterface (Optional) Subinterface number:
• default: 0 for the main interface
Note If the subinterface is configured at the virtual bundle interface,
the subinterface number option for this CLI must be
configured to match up with the desired subinterface devices.
Command Default Cable per-physical-downstream static multicast support is not defined by default.
Command Modes Global configuration (config)
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.
Usage Guidelines The Cable per-physical-downstream Static Multicast Support feature introduces the concept of a
physical IGMP static group, which is an extension of the existing logical IGMP static group. The
differences between the two IGMP static groups are:
• A cable bundle logical IGMP static group creates the IGMP static group for the logical IP domain
and forwards multicast traffics for the configured multicast group to every slave interface in the
same bundle.
• A cable bundle physical IGMP static group creates the IGMP static group on per-physical slave
interface basis and will only forwards multicast traffics to only configured slave interfaces.
When an IGMP static group is configured on a master interface, the IGMP static group will perform a
check for each slave interface in the multicast group. If the multicast group is configured as a physical
static group, then only the corresponding slave interfaces will be added to the cable bundle forwarding
table. If the multicast group is configured as a logical static group, then all slave interfaces will be added
to the cable bundle forwarding table.
Note When all remaining physical static groups are un-configured from the slave interface for a particular
multicast group on a particular bundle, the Cisco CMTS router will revert back to the logical static group
for that multicast group on that bundle.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-255
Cable Commands: cable e through cable i
cable igmp static-group
DSG Usage
The cable igmp static-group command will only appear in the output of the show
running-configuration command if it is configured via the CLI. If it is configured by DSG, the cable
igmp static-group command CLI will remain hidden for a particular multicast group. This is done in
order to eliminate any confusion with the current DSG configurations.
Note Any multicast group being used by DSG (or CLI) within the same CMTS, should not be used for CLI
(or DSG) configuration.
Examples The following example shows the cable igmp static-group command on the Cisco CMTS router:
Router(config-if)# cable igmp static-group 230.1.1.1
The following example shows the cable igmp static-group command with the source option on the
Cisco CMTS router:
Router(config-if)# cable igmp static-group 232.1.1.1 source 10.1.1.1
Related Commands Command Description
ip igmp static-group Configure static group membership entries on an interface.
Cisco IOS CMTS Cable Command Reference
CBL-256 OL-15510-15
Cable Commands: cable e through cable i
cable init-channel-timeout
cable init-channel-timeout
To specify the maximum time that a CM can spend performing initial ranging on the upstream channels
described in the Registration Response (REG-RSP) and Multipart Registration Response
(REG-RSP-MP) messages, use the cable init-channel-timeout command in cable interface
configuration mode. To disable this configuration, use the no form of this command.
cable init-channel-timeout value
no cable init-channel-timeout value
Syntax Description value Channel timeout value in seconds. Valid range is from 10 to 180 seconds.
The default value is 60.
Command Default None
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCC This command was introduced in Cisco IOS Release 12.2(33)SCC.
Examples The following example shows how to specify the channel timeout value on a cable interface at
slot/subslot/port 5/1/0 on a Cisco uBR10012 router:
Router# configure terminal
Router(config)# interface cable 5/1/0
Router(config-if)# cable init-channel-timeout 90
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-257
Cable Commands: cable e through cable i
cable insertion-interval
cable insertion-interval
To configure the interval between consecutive initial ranging slots on an upstream, use the cable
insertion-interval interface configuration command. To configure the automatic setting and ignore any
minimum or maximum time settings, use the no form of this command.
cable insertion-interval {fixed-intrvl | automatic [min-intrvl] [max-intrvl]}
no cable insertion-interval
Syntax Description fixed-intrvl Fixed interval between initial ranging slots in milliseconds. The valid range is 100 to
2000 milliseconds.
automatic Causes the Cisco CMTS MAC scheduler for each upstream CM to vary the initial
ranging times available to new CMs joining the network.
min-intrvl (Optional) Minimum value in milliseconds between the initial ranging slots on the
upstream. The valid range is 20 to 120, with a default of 60 milliseconds.
max-intrvl (Optional) Maximum value in milliseconds between the initial ranging slots on the
upstream. The valid range is 240 to 1800, with a default of 480 milliseconds.
Command Default Automatic (dynamically varying the frequency of initial ranging upstream slots between 60 milliseconds
and 480 milliseconds)
Command Modes Interface configuration—cable interface only (config-if)
Command History Release Modification
11.NA This command was introduced.
12.1 T This command was modified.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA) This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for
the Cisco uBR7225VXR router was added.
Usage Guidelines Use this command to specify the minimum and maximum duration between initial ranging opportunities
that appear in MAP messages sent by the Cisco CMTS router. MAP messages define the precise time
intervals during which CMs can send.
The default insertion interval setting (automatic) configures the Cisco CMTS router to optimize the initial
ranging times available to new CMs that attempt to join the network. The optimization algorithm
automatically varies the initial ranging times between 60 and 480 milliseconds, depending on the number of
CMs attempting to come online.
Use the cable insertion-interval automatic command to bring a large number of CMs online quickly
(for example, after a major power failure). After the CMs have come online, you can override the
automatic keyword by giving this command again and specifying a specific insertion interval.
Cisco IOS CMTS Cable Command Reference
CBL-258 OL-15510-15
Cable Commands: cable e through cable i
cable insertion-interval
Examples The following example shows the default configuration, which is to specify automatic insertion
intervals, using the default initial ranging intervals:
Router# configure terminal
Router(config)# interface cable 3/0
Router(config-if)# cable insertion-interval automatic
The following example shows how to set the minimum insertion interval to 100 ms:
Router# configure terminal
Router(config)# interface cable 5/1/0
Router(config-if)# cable insertion-interval 100
Related Commands Command Description
cable upstream data-backoff Specifies automatic or fixed start and stop values for data backoff.
cable upstream range-backoff Specifies automatic or configured initial ranging backoff calculation.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-259
Cable Commands: cable e through cable i
cable intercept
cable intercept
To allow the Cisco CMTS router to forward all traffic to and from a particular CPE to a data collector located
at particular User Datagram Protocol (UDP) port, use the cable intercept command in cable interface
configuration mode. To deactivate this function, use the no form of this command.
cable intercept mac-address ip-address udp-port
no cable intercept mac-address
Syntax Description mac-address Specifies the MAC address to be intercepted.
For Cisco uBR10012 router, a maximum of 4095 MAC addresses can be configured. For
Cisco uBR7200 series router, a maximum of 10 MAC addresses per interface can be
configured.
ip-address Specifies the IP address for the destination data collector.
udp-port Specifies the destination UDP port number for the intercept stream at the data collector.
Valid range is 0 to 65535.
Command Default Disabled
Command Modes Interface configuration—cable interface only (config-if)
Command History Release Modification
12.0(5)T1 This command was introduced.
12.0(6)SC This command was introduced on the 12.0 SC train.
12.1(2)EC This command was introduced on 12.1 EC train.
12.1(11b)EC Support was added to allow the data collector to be more than two hops from the
Cisco CMTS router.
12.2(4)BC1 This command was integrated into Cisco IOS Release 12.2(4)BC1.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
12.2(33)SCC This command was modified. The command is now configured under bundle
interface.
Usage Guidelines When this command is activated, the Cisco CMTS router examines each packet for the desired MAC
address; when a matching MAC address is found (for either the origination or destination endpoint), a
copy of the packet is encapsulated into a UDP packet, which is then sent to the specified server at the
given IP address and port.
Cisco IOS CMTS Cable Command Reference
CBL-260 OL-15510-15
Cable Commands: cable e through cable i
cable intercept
Note The data collecting system at the ip-address on the udp-port must be configured to listen for and capture
the necessary data stream. An IP route to the specified IP address must exist, and IP connectivity to that
device must be present for the traffic to be captured. Before Cisco IOS Release 12.1(11b)EC, the data
collecting system must be within two routing hops of the Cisco CMTS.
For Cisco uBR10012 router, a maximum of 4095 MAC intercepts can be configured. This includes the
MAC intercepts configured using the cable intercept command, and other lawful intercept features
(such as Service Independent Intercept [SII]). The bandwidth used by each MAC intercept is also a
deciding factor for the number of MAC intercepts that can be configured. High bandwidth usage by a
MAC intercept might reduce the number of MAC intercepts that can be configured.
This command is originally designed to comply with the United States Federal Communications
Assistance for Law Enforcement Act (CALEA) and other law enforcement wiretap requirements for
voice communications. For additional information, see the PacketCable Electronic Surveillance
Specification, which is available at the following URL at the PacketCable web site:
http://www.packetcable.com.
Note For lawful intercept, it is recommended to use SII (through SNMPv3) instead of the cable intercept
command.
Note Starting from Cisco IOS Release 12.2(33)SCC, the cable intercept command is configured under
bundle interface.
Examples The following commands specify that a copy of all traffic for the CPE with the MAC address of
0080.fcaa.aabb should be forwarded to the data collector that is listening at UDP port 512 at the IP
address of 10.12.13.8. The show interface cable intercept command displays which intercepts are
currently active.
Router# configure terminal
Router#(config) interface cable 6/0
Router(config-if)# cable intercept 0080.fcaa.aabb 10.12.13.8 512
Router(config-if)# exit
Router(config)# exit
Router# show interface cable 6/0 intercept
Destination Destination
MAC Address IP Address UDP Port
0080.fcaa.aabb 3.12.13.8 512
The following example shows the behavior of the cable intercept command that is configured under
bundle interface. The show running interface command displays which intercepts are currently
active.
Router# configure terminal
Router#(config) interface bundle 10
Router(config-if)# cable intercept 0080.fcaa.aabb 10.12.13.8 512
Router(config-if)# exit
Router(config)# exit
Router# show running interface bundle 10 | i intercept
cable intercept 0080.fcaa.aabb 10.12.13.8 512
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-261
Cable Commands: cable e through cable i
cable intercept
Related Commands Command Description
cable monitor Enables the forwarding of selected packets on the cable interface to
an external LAN analyzer.
show interface cable intercept Displays the CMs for which cable intercept is currently active.
Cisco IOS CMTS Cable Command Reference
CBL-262 OL-15510-15
Cable Commands: cable e through cable i
cable ip-init
cable ip-init
To configure the IP provisioning mode supported by the cable interface on a Cisco CMTS router, use
the cable ip-init command in interface or subinterface configuration mode. To remove the IP
provisioning configuration, use the no form of this command.
cable ip-init {apm | dual-stack | ipv4 | ipv6}
no cable ip-init {apm | dual-stack | ipv4 | ipv6}
Syntax Description apm Configures the interface to support Alternative Provisioning Mode (APM).
dual-stack Configures the interface to support both IPv4 and IPv6 addressing.
ipv4 Configures the interface to support IPv4 address only.
ipv6 Configures the inerface to support IPv6 address only.
Command Default None
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCA This command was introduced.
12.2(33)SCC This command was modified. The apm keyword was added.
Usage Guidelines The cable ip-init command configures the cable interface for the IP addressing mode that it supports.
This information is included in the IP initialization parameters of the MAC Domain Descriptor (MDD)
message.
Examples The following example shows how to configure a cable interface on a Cisco CMTS router to support
both IPv4 and IPv6 addressing:
interface cable 5/0/1
cable ip-init dual-stack
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-263
Cable Commands: cable e through cable i
cable ip-broadcast-echo
cable ip-broadcast-echo
To activate upstream IP broadcast echo so that the Cisco CMTS router can echo broadcast packets, use
the cable ip-broadcast-echo command in cable interface or subinterface configuration mode. To disable
the upstream IP broadcast echo, use the no form of this command.
cable ip-broadcast-echo
no cable ip-broadcast-echo
Syntax Description This command has no arguments or keywords.
Command Default Disabled
Command Modes Cable interface and subinterface configuration (config-if)
Command History Release Modification
11.3 XA This command was introduced.
12.1(3a) EC The subinterface support was added.
12.1(5)EC Support was added for the Cisco uBR7100 series routers.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for
the Cisco uBR7225VXR router was added.
Usage Guidelines By default, broadcast IP packets that arrive on the upstream at the Cisco CMTS router are not forwarded
on the downstream ports so that they would be delivered to the other CMs and CPE devices. This
behavior prevents broadcast storms in which such packets are repeatedly looped through the network.
The cable ip-broadcast-echo command changes this behavior by forwarding such packets on the
appropriate downstream ports, so that the packet is received by all CMs and CPE devices on that segment
of the network. This allows the cable network to behave more like a standard Ethernet network, and
support direct peer-to-peer communications using IP broadcasts.
Note This command should not be used in a typical service provider network.
Examples The following example shows how to activate IP broadcast echo in the cable interface configuration
mode:
Router(config-if)# cable ip-broadcast-echo
Cisco IOS CMTS Cable Command Reference
CBL-264 OL-15510-15
Cable Commands: cable e through cable i
cable ip-broadcast-echo
The following example shows how to activate IP broadcast echo in the cable subinterface configuration
mode:
Router(config)# interface cable 6/0.1
Router(config-subif)# cable ip-broadcast-echo
Related Commands Command Description
cable ip-multicast-echo Enables IP multicast echo so that the Cisco CMTS can echo multicast
packets.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-265
Cable Commands: cable e through cable i
cable ip-multicast-echo
cable ip-multicast-echo
To enable IP multicast echo so that the Cisco CMTS can echo multicast packets, use the cable
ip-multicast-echo command in cable interface configuration mode. To disable IP multicast echo, use
the no form of this command.
cable ip-multicast-echo
no cable ip-multicast-echo
Syntax Description This command has no arguments or keywords.
Command Default IP multicast echo is disabled by default.
Command Modes Cable interface configuration (config-if)
Command History Release Modification
11.3 XA This command was introduced for Cisco uBR7200 series routers.
12.1(3a) EC The subinterface support was added.
12.1(5)EC Support was added for Cisco uBR7100 series routers.
12.2(4)BC1 Support was added for the Cisco uBR10012 router.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
12.2(33)SCB The command default is changed to disabled in Cisco IOS Release 12.2(33)SCB and
later.
Usage Guidelines By default, multicast IP packets that arrive on the upstream at the Cisco CMTS are forwarded on the
appropriate downstream ports so that they are delivered to the other CMs and CPE devices on that
segment of the network. This allows the cable network to behave like a standard Ethernet network in
terms of its handling of multicast IP traffic.
This behavior might not be appropriate for certain applications or networks, so the no cable
ip-multicast-echo command changes this behavior by preventing the forwarding of multicast packets.
Disabling multicast traffic can prevent some types of broadcast storms in which such packets are
repeatedly looped through the network.
To verify if IP multicast echo has been activated or deactivated, enter the show running-config
command and look for the cable interface configuration information.
If IP multicast echo is enabled, it appears in this output of the show running-config command.
If IP multicast echo is disabled, it is not displayed in the output show running-config command.
If you are having trouble, make sure that you have entered the correct slot and port numbers when you
entered cable bundle interface configuration mode.
Cisco IOS CMTS Cable Command Reference
CBL-266 OL-15510-15
Cable Commands: cable e through cable i
cable ip-multicast-echo
Note On the Cisco uBR10012 router, input access lists are not applied to the multicast traffic that is echoed
on each downstream. To control the echoed multicast traffic, you therefore need to configure an output
access list and apply it to each downstream interface.
Examples The following example shows how to disable IP multicast echo in the bundle interface configuration
mode:
Router(config-if)# no cable ip-multicast-echo
Related Commands Command Description
cable ip-broadcast-echo Enables upstream IP broadcast echo so that the Cisco CMTS can echo
broadcast packets.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-267
Cable Commands: cable e through cable i
cable ipc-stats
cable ipc-stats
To enable the Cable IPC Statistics Collection tool on a Cisco CMTS router, use the cable ipc-stats
command in global configuration mode. To disable this configuration, use the no form of this command.
cable ipc-stats
no cable ipc-stats
Syntax Description This command has no arguments or keywords.
Command Default The Cable IPC Statistics Collection tool is not enabled by default.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced in Cisco IOS Release 12.2(33)SCC.
Usage Guidelines The Cable IPC Statistics Collection tool provides debugging information about all IPC messages. We
recommend that you enable this tool only when it is necessary as the tool consumes considerable amount
of CPU memory while running on a Cisco CMTS router.
The cable ipc-stats command is synchronized on all cable interface line cards from the active RP. You
do not have to use this command on cable interface line cards separately.
Examples The following example shows how to enable the Cable IPC Statistics Collection tool on a Cisco CMTS
router:
Router# configure terminal
Router(config)# cable ipc-stats
Related Commands Command Description
clear cable ipc-stats Clears the active database and resets IPC statistics in the active database to
zero.
show cable ipc-stats Displays statistics of all the IPC messages on a Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
CBL-268 OL-15510-15
Cable Commands: cable e through cable i
cable ipv6 source-verify
cable ipv6 source-verify
To enable source verification of IPv6 packets received by a cable interface upstream on a Cisco CMTS
router, use the cable ipv6 source-verify command in bundle interface or subinterface configuration
mode. To disable IPv6 source verification, use the no form of this command.
cable ipv6 source-verify [dhcp [server ip-address] | leasequery-filter upstream threshold
interval | leasetimer value]
no cable ipv6 source-verify
Syntax Description dhcp (Optional) Verifies IP address with the DHCPv6 server.
• server—Enables the Leasequery server to send the DHCPv6
Leasequeries.
• ip-address—IPv6 address of the Leasequery server.
leasequery-filter (Optional) Filters the IPv6 Leasequery requests.
• upstream—Indicates that the Leasequery requests are sent on cable
upstream interfaces.
• threshold—Maximum number of DHCP Leasequeries allowed per SID
for each interval period. The valid range is from 0 to 55.
• interval—Time period, in seconds, when Leasequeries should be
monitored. The valid range is from 1 to 5 seconds.
leasetimer (Optional) Specifies the time, in minutes, when the router should check its
internal CPE database for IP addresses whose lease times has expired.
• value—Lease time value. The valid range is from 1 to 240 minutes,
with a default of 60 minutes.
Command Default IPv6 source verification is disabled.
Command Modes Bundle interface configuration (config-if),
Bundle subinterface configuration (config-subif)
Command History Release Modification
12.2(33)SCA This command was introduced.
12.2(33)SCF1 This command was modified. The dhcp keyword was added to verify IPv6
address with the DHCPv6 server. The leasequery-filter and leasetimer
keywords were added to further filter the IPv6 Leasequery requests.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-269
Cable Commands: cable e through cable i
cable ipv6 source-verify
Usage Guidelines The IPv6 source verification feature is enabled on a cable bundle interface or subinterface.
When you enable IPv6 source verification on the Cisco CMTS bundle interface, the source verification
routine is run to verify the MAC-SID-IP binding of the packet. If the source verification succeeds, the
packet is forwarded. If the verification fails, then the packet is dropped.
When a cable modem (CM) is operating as a bridged modem device, then the Cisco CMTS router verifies
the entire IPv6 address for that CM and the CPEs behind that CM.
When a CM is operating as a router modem device, then the Cisco CMTS router only verifies the
network prefix for that CM and the CPEs behind that CM. To be successful, this means that all cable
modem routers must have different prefixes assigned to them.
The cable ipv6 source-verify command only controls the source verification of IPv6 packets. For
IPv4-based source verification, you must use the cable source-verify command, which also supports
different options.
Note On the Cisco uBR10012 router in Cisco IOS Release 12.2(33)SCA, source verification of IPv6 packets
occurs only on packets in the process-switched path of the route processor (RP).
Using the dhcp Option
If the dhcp option is used, the Cisco CMTS sends a DHCPv6 Leasequery message to the DHCP server
to verify the IP address. If a valid response is received from the DHCP server, the Cisco CMTS updates
its database with the new CPE device and allows future traffic through. If the DHCP server does not
return a successful response, all traffic from the CPE is dropped.
If you are using the dhcp option, you have the option to specify an alternate DHCP server using its IP
address.
Using the leasetimer Option
The leasetimer option adds another level of verification by activating a timer that periodically examines
the lease times for the IP addresses for known CPE devices. If the Cisco CMTS discovers that the DHCP
lease for a CPE device has expired, it removes that IP address from its database, preventing the CPE
device from communicating until it makes another DHCP request. This prevents users from treating
DHCP-assigned addresses as static addresses, as well as from using IP addresses that were previously
assigned to other devices.
The leasetimer option takes effect only when the dhcp option is also used on an interface. Also, this
option is supported only on the primary bundle interface and cannot be configured on subinterfaces.
Configuring it for a primary bundle interface automatically applies it to all subinterfaces.
Using the leasequery-filter Option
To prevent a large volume of Leasequery requests on a cable interface, use the cable ipv6 source-verify
leasequery-filter command. After configuring this command, the Cisco CMTS allows only the
configured number of DHCPv6 Leasequery requests within the specified interval time period.
For example, the cable ipv6 source-verify leasequery-filter 5 10 command configures the
Cisco CMTS so that the Cisco CMTS allows a maximum of five DHCPv6 Leasequery requests every 10
seconds for each SID.
Cisco IOS CMTS Cable Command Reference
CBL-270 OL-15510-15
Cable Commands: cable e through cable i
cable ipv6 source-verify
Examples The following example shows how to enable IPv6 source verification on a Cisco CMTS router bundle
interface by first configuring cable ipv6 source-verify at the bundle interface:
interface bundle 1
cable ipv6 source-verify
After you configure the bundle interface, associate the bundle at the cable interface:
interface cable 6/0/2
cable bundle 1
The following example shows how to configure the Cisco CMTS router to send DHCPv6 Leasequeries
to verify unknown source IP addresses in upstream data packets. Both cable ipv6 source-verify dhcp
and no cable nd commands must be configured on the Cisco CMTS bundle before the Cisco CMTS will
issue any DHCPv6 Leasequery to recover an unknown IPv6 CPE to the Cisco CMTS.
configure terminal
interface bundle 1
cable ipv6 source-verify dhcp
no cable nd
The following example shows how to configure the leasetimer option so that the Cisco CMTS checks
the IP addresses in the CPE database for that particular interface for expired lease time:
configure terminal
interface bundle 1
cable ipv6 source-verify dhcp
cable ipv6 source-verify leasetimer 120
The following example shows how to configure the Cisco CMTS router so that it allows a maximum of
five DHCP Leasequery requests per SID over each 2-second interval on a particular cable interface.
configure terminal
interface bundle 1
cable ipv6 source-verify dhcp
cable ipv6 source-verify leasequery-filter 5 2
Associated Features The cable ipv6 source-verify command is used to configure the following feature:
• Cable DHCP Leasequery
Related Commands Command Description
cable source-verify Enables verification of IPv4 addresses for CMs and CPE devices on
an upstream.
cable ipv6 source-verify Enables the Leasequery filter in the CMTS downstream for IPv6
leasequery-filter packets.
downstream
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-271
Cable Commands: cable e through cable i
cable ipv6 source-verify leasequery-filter downstream
cable ipv6 source-verify leasequery-filter downstream
To enable the Leasequery filter on the Cisco CMTS downstream for IPv6 packets, use the cable ipv6
source-verify leasequery-filter downstream command in global configuration mode. To disable the
Leasequery filter on the Cisco CMTS downstream, use the no form of this command.
cable ipv6 source-verify leasequery-filter downstream threshold interval
no cable ipv6 source-verify leasequery-filter downstream
Syntax Description downstream Filters the IPv6 Leasequery requests on the Cisco CMTS downstream.
• threshold—Maximum number of DHCP Leasequeries allowed for
unknown SIDs for each interval period. The valid range is from 0 to
255.
• interval—Time period, in seconds, when Leasequeries should be
monitored. The valid range is from 1 to 10 seconds.
Command Default IPv6 source verification for downstream is disabled.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCF1 This command was introduced.
Usage Guidelines Use the cable ipv6 source-verify leasequery-filter downstream command to enable the Leasequery
filter on the Cisco CMTS downstream for IPv6 packets.
Examples The following example shows how to enable the Leasequery filter on the CMTS downstream for IPv6
packets on all downstream cable interfaces.
Router# configure terminal
Router(config)# cable ipv6 source-verify leasequery-filter downstream 10 5
Associated Features The cable ipv6 source-verify leasequery-filter downstream command is used to configure the
following feature:
• Cable DHCP Leasequery
Related Commands
Cisco IOS CMTS Cable Command Reference
CBL-272 OL-15510-15
Cable Commands: cable e through cable i
cable ipv6 source-verify leasequery-filter downstream
Command Description
cable ipv6 Enables source verification of IPv6 packets received by a cable interface
source-verify upstream on a Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-273
Cable Commands: cable e through cable i
Cisco IOS CMTS Cable Command Reference
CBL-274 OL-15510-15
Cable Commands: cable l
Revised: July 2012, OL-15510-15
New Commands
Command Cisco IOS Software Release
cable l2-vpn-service default-nsi 12.2(33)SCA
cable load-balance docsis-policy 12.2(33)SCB
cable load-balance rule 12.2(33)SCB
cable l2-vpn 12.2(33)SCC
cable l2-vpn-service xconnect 12.2(33)SCC
cable load-balance d30-ggrp-default 12.2(33)SCC
cable load-balance docsis-enable 12.2(33)SCC
cable load-balance docsis-group 12.2(33)SCC
cable load-balance modem max-failures 12.2(33)SCC
cable load-balance restrict modem 12.2(33)SCC
cable linecard critical-event-poweroff 12.2(33)SCE
cable l2-vpn xconnect backup force-switchover 12.2(33)SCF
cable linecard auto-rommon-downgrade 12.2(33)SCF
cable linecard auto-rommon-upgrade 12.2(33)SCF
cable load-balance docsis30-enable 12.2(33)SCF1
cable logging downstream-index 12.2(33)SCG
Modified Commands
Command Cisco IOS Software Release
cable load-balance docsis-policy 12.2(33)SCC
cable load-balance rule 12.2(33)SCC
cable load-balance rule 12.2(33)SCD5
cable load-balance group 12.2(33)SCE4
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-275
Cable Commands: cable l
Command Cisco IOS Software Release
cable load-balance group (interface) 12.2(33)SCE4
cable load-balance group interval 12.2(33)SCE4
cable load-balance group policy ugs 12.2(33)SCE4
cable load-balance group threshold 12.2(33)SCE4
cable load-balance group threshold 12.2(33)SCE4
(Supporting_Dynamic_Channel_Change)
Replaced Commands
Command Replacement Command Effective Cisco IOS Release
cable l2-vpn-service cable l2-vpn-service xconnect 12.2(33)SCC
default-nsi
Cisco IOS CMTS Cable Command Reference
CBL-276 OL-15510-15
Cable Commands: cable l
cable l2vpn
cable l2vpn
To enable the Ethernet Layer 2 Virtual Private Network (L2VPN) service and enter L2VPN
configuration mode, use the cable l2vpn command in global configuration mode. To disable this
configuration, use the no form of this command.
cable l2vpn mac-address [customer-name]
no cable l2vpn mac-address [customer-name]
Syntax Description mac-address MAC address of a CM.
customer-name (Optional) Customer name.
Command Default None
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced in Cisco IOS Release 12.2(33)SCC.
Examples The following example shows how to enable the Ethernet L2VPN service and enter L2VPN
configuration mode on the Cisco uBR10012 router:
Router# configure terminal
Router(config)# cable l2vpn 0000.396e.6a68 customer1
Router(config-l2vpn)#
Related Commands Command Description
service instance Specifies an Ethernet service instance for a particular customer.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-277
Cable Commands: cable l
cable l2-vpn-service atm-vc
cable l2-vpn-service atm-vc
To enable the use of Layer 2 tunnels for the Customer Premises Equipment (CPE) traffic that is behind
cable modems so that individual CPE traffic can be routed to a particular permanent virtual connection
(PVC) on an Asynchronous Transfer Mode (ATM) interface, use the cable l2-vpn-service atm-vc
command in global configuration mode. To disable the use of Layer 2 tunneling, use the no form of this
command.
cable l2-vpn-service atm-vc
no cable l2-vpn-service atm-vc
Syntax Description This command has no arguments or keywords.
Command Default The use of Layer 2 tunneling for ATM PVC mapping is disabled.
Command Modes Global configuration (config)
Command History Release Modification
12.2(11)BC3 This command was introduced for Cisco uBR7100 series and Cisco uBR7200 series
routers.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
Usage Guidelines This command enables the use of Layer 2 tunnels on all cable and ATM interfaces in the router—which
in turn allows you to map cable modems, on the basis of their hardware (MAC) addresses, to particular
PVCs on an ATM interface—using the cable vc-map command.
Examples The following example shows how to enable the use of Layer 2 tunnels on a router so that cable modems
can be mapped to particular PVCs on an ATM interface:
Router# config terminal
Router(config)# cable l2-vpn-service atm-vc
Related Commands Command Description
cable vc-map Maps a cable modem to a particular PVC on an ATM interface.
debug cable l2-vpn Displays debugging messages for the Layer 2 mapping of cable modems
to a particular PVC on an ATM interface.
show cable l2-vpn vc-map Displays the mapping of one or all cable modems to PVCs on the ATM
interfaces.
Cisco IOS CMTS Cable Command Reference
CBL-278 OL-15510-15
Cable Commands: cable l
cable l2-vpn-service default-nsi
cable l2-vpn-service default-nsi
Note Effective with Cisco IOS Release 12.2(33)SCC, the cable l2-vpn-service default-nsi command is
replaced by the cable l2-vpn-service xconnect command. See the cable l2-vpn-service xconnect
command for more information.
To configure an Ethernet Network System Interface for Layer 2 VPN support over cable, use the cable
l2-vpn-service default-nsi command in global configuration mode. To remove the interface, use the no
form of this command.
cable l2-vpn-service default-nsi type number
no cable l2-vpn-service default-nsi type number
Syntax Description type Interface type. See the Usage Guidelines section for supported types.
number Interface or subinterface number. For more information about the numbering
syntax for your networking device, use the question mark (?) online help
function.
Command Default No NSI interface is configured.
Command Modes Global configuration
Command History Release Modification
12.2(33)SCA This command was introduced.
12.2(33)SCC This command was replaced by the cable l2-vpn-service xconnect
command.
Usage Guidelines The Cisco CMTS routers only support the configuration of a single L2VPN NSI per CMTS.
This command supports the following interface types:
• Cisco uBR100012 Universal Broadband Router—Gigabit Ethernet.
• Cisco uBR7246VXR Universal Broadband Router—Fast Ethernet or Gigabit Ethernet
Examples The following example configures the Gigabit Ethernet line card located in slot 4/0/0 as an NSI for
L2VPN using global configuration mode:
cable l2-vpn-service default-nsi GigabitEthernet4/0/0
Related Commands
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-279
Cable Commands: cable l
cable l2-vpn-service default-nsi
Command Description
show cable l2-vpn Displays the mapping of one or all cable modems to IEEE 802.1Q VLANs
dot1q-vc-map on the router’s Ethernet interfaces.
Cisco IOS CMTS Cable Command Reference
CBL-280 OL-15510-15
Cable Commands: cable l
cable l2-vpn-service dot1q
cable l2-vpn-service dot1q
To enable the use of Layer 2 tunnels so that traffic for individual cable modems can be routed over a
particular Virtual Local Area Network (VLAN), use the cable l2-vpn-service dot1q command in global
configuration mode. To disable the use of Layer 2 tunneling, use the no form of this command.
cable l2-vpn-service dot1q
no cable l2-vpn-service dot1q
Syntax Description This command has no arguments or keywords.
Command Default Layer 2 tunneling is disabled.
Command Modes Global configuration
Command History Release Modification
12.2(15)BC2 This command was introduced for Cisco uBR7246VXR universal broadband routers.
Usage Guidelines This command enables the use of Layer 2 tunnels, using IEEE 802.1Q VLAN tagging, on all cable
interfaces in the router. This in turn allows you to map traffic to and from cable modems, on the basis
of the modems’ hardware (MAC) addresses, to a particular VLAN on a particular WAN interface, using
the cable dot1q-vc-map command.
Examples The following example shows how to enable the use of IEEE 802.1Q Layer 2 tunnels on a router so that
cable modems can be mapped to particular VLAN:
Router# config terminal
Router(config)# cable l2-vpn-service dot1q
Router(config)#
The following example shows how to disable the use of IEEE 802.1Q Layer 2 tunnels on a router. All
mapping of cable modems to IEEE 802.1Q VLANs is halted (but any other Layer 2 mapping, such as
the mapping of cable modems to ATM PVCs, is unaffected).
Router# config terminal
Router(config)# no cable l2-vpn-service dot1q
Router(config)#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-281
Cable Commands: cable l
cable l2-vpn-service dot1q
Related Commands Command Description
cable dot1q-vc-map Maps a cable modem to a particular Virtual Local Area Network
(VLAN) on a local outbound Ethernet interface.
debug cable l2-vpn Displays debugging messages for the Layer 2 mapping of cable
modems to particular PVCs or VLANs.
show cable l2-vpn dot1q-vc-map Displays the mapping of one or all cable modems to IEEE 802.1Q
Virtual Local Area Networks (VLANs) on the router’s Ethernet
interfaces.
Cisco IOS CMTS Cable Command Reference
CBL-282 OL-15510-15
Cable Commands: cable l
cable l2-vpn-service xconnect
cable l2-vpn-service xconnect
To enable Multiprotocol Label Switching (MPLS) tunnel traffic on the network side interface to support
configuration of MPLS pseudowires for L2VPN service, use the cable l2-vpn-service xconnect
command in global configuration mode. To disable this configuration, use the no form of this command.
cable l2-vpn-service xconnect nsi {dot1q | mpls}
no cable l2-vpn-service xconnect nsi {dot1q | mpls}
Syntax Description nsi Specifies the network side interface (NSI).
dot1q Specifies the usage of DOT1Q tunneling on the NSI for Ethernet L2VPN
traffic.
mpls Specifies the usage of MPLS tunneling on the NSI for Ethernet L2VPN
traffic.
Command Default None
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced in Cisco IOS Release 12.2(33)SCC.
Usage Guidelines You must enable MPLS tunnel traffic on the network side interface using the cable l2-vpn-service
xconnect command before provisioning MPLS pseudowires.
Examples The following example shows how to enable the use of Layer 2 tunnels based on an AToM pseudowire
on the Cisco uBR10012 router:
Router# configure terminal
Router(config)# cable l2-vpn-service xconnect nsi mpls
Related Commands Command Description
cable l2vpn Enables the Ethernet Layer 2 Virtual Private Network (L2VPN).
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-283
Cable Commands: cable l
cable l2-vpn xconnect backup force-switchover
cable l2-vpn xconnect backup force-switchover
To manually force a switchover to a pseudowire peer, use the xconnect backup force-switchover
command in privileged EXEC mode.
cable l2-vpn xconnect backup force-switchover peer ip-address vcid
Syntax Description peer ip-address vcid Specifies the IP address and virtual circuit (VC) ID of the pseudowire to be
used for the switchover.
• ip-address—IP address of the peer pseudowire.
• vcid—Virtual circuit address of the peer pseudowire.
Command Default The pseudowire will not be changed.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCF This command was introduced.
Usage Guidelines You can perform a switchover only to an available member in the redundancy group. That is, if the
member being specified in the cable l2vpn xconnect backup force-switchover command is not
available, the command will be rejected.
Examples The following example shows how to manually switchover to a peer router.
Router# cable l2vpn xconnect backup force-switchover peer 10.10.1.1 123
Related Commands Command Description
backup delay Specifies how long a backup pseudowire VC should wait before taking
over after the primary pseudowire VC goes down.
backup peer Configures a redundant peer for a pseudowire VC.
show cable l2vpn Displays information about the mapping between a Multiprotocol Label
xconnect Switching (MPLS) pseudowire and its VCs.
show mpls l2transport vc Displays information about Any Transport over MPLS (AToM) VCs and
static pseudowires that have been enabled to route Layer 2 packets on a
router
show xconnect all Displays information about xconnect attachment circuits and
pseudowires.
Cisco IOS CMTS Cable Command Reference
CBL-284 OL-15510-15
Cable Commands: cable l
cable linecard auto-rommon-downgrade
cable linecard auto-rommon-downgrade
To enable the automatic ROM-Monitor (ROMMON) image downgrade on cable interface line cards, use
the cable linecard auto-rommon-downgrade command in global configuration mode. To disable
automatic ROMMON image downgrade on cable interface line cards, use the no form of this command.
cable linecard auto-rommon-downgrade
no cable linecard auto-rommon-downgrade
Syntax Description This command has no arguments or keywords.
Command Default The automatic ROMMON image downgrade is disabled.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCF This command was introduced.
Usage Guidelines The automatic ROMMON downgrade is disabled by default on all line cards, and we recommend that
you do not change this default behavior.
Examples The following example shows how to enable automatic ROMMON downgrade on all cable interface line
cards:
Router(config)# cable linecard auto-rommon-downgrade
The following example shows how to disable automatic ROMMON downgrade on all cable interface
line cards:
Router(config)# no cable linecard auto-rommon-downgrade
Related Commands Command Description
cable linecard Enables or disables automatic ROMMON image upgrade on
auto-rommon-upgrade cable interface line cards.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-285
Cable Commands: cable l
cable linecard auto-rommon-upgrade
cable linecard auto-rommon-upgrade
To enable the automatic ROM-Monitor (ROMMON) image upgrade on cable interface line cards, use
the cable linecard auto-rommon-upgrade command in global configuration mode. To disable
automatic ROMMON upgrade on cable interface line cards, use the no form of this command.
cable linecard auto-rommon-upgrade
no cable linecard auto-rommon-upgrade
Syntax Description This command has no arguments or keywords.
Command Default The automatic ROMMON image upgrade is disabled.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCF This command was introduced.
Usage Guidelines To perform automatic ROMMON upgrade on the cable interface line card, use the cable linecard
auto-rommon-upgrade command to enable automatic ROMMON image upgrade on the line card and
then reload the line card.
Examples The following example shows how to enable automatic ROMMON image upgrade on all cable interface
line cards:
Router(config)# cable linecard auto-rommon-upgrade
The following example shows how to disable automatic ROMMON image upgrade on all cable interface
line cards:
Router(config)# no cable linecard auto-rommon-upgrade
Related Commands Command Description
cable linecard Enables or disables automatic ROMMON image downgrade on
auto-rommon-downgrade cable interface line cards.
Cisco IOS CMTS Cable Command Reference
CBL-286 OL-15510-15
Cable Commands: cable l
cable linecard critical-event-poweroff
cable linecard critical-event-poweroff
To power off the Cisco uBR-MC3GX60V cable interface line card when a device temperature reaches
critical threshold values on the CMTS chassis, use the cable linecard critical-event-poweroff
command in the global configuration mode. To disable this feature, configure the no form of the
command.
cable linecard critical-event-poweroff
no cable linecard critical-event-poweroff
Syntax Description This command has no arguments or keywords.
Command Default Enabled
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCE This command was introduced.
Usage Guidelines The PRE will power off the Cisco uBR-MC3GX60V line card if any of the device temperatures on the
line card exceeds the critical threshold value. To disable this power off feature, user should configure
the no cable linecard critical-event-poweroff command and save the configuration.
The temperature thresholds for the devices on the Cisco uBR-MC3GX60V line card are:
Router#show environment subslot 6/0
------------------------------------------------------------------------
TEMPERATURE/POWER INFORMATION
------------------------------------------------------------------------
Number of Temperature Sensors : 9
Sampling frequency : 2 minutes
------------------------------------------------------------------------
Sensor | ID | Current | Minor | Major | Critical | Alarm |
| | Temperature | Threshold | Condition |
| | degC | degC | |
------------------------------------------------------------------------
Nickel 10G 1 69 84 89 94 Normal
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-287
Cable Commands: cable l
cable linecard critical-event-poweroff
Inlet #1 2 47 64 69 74 Normal
CPU 3 68 86 91 96 Normal
Raven 4 46 64 69 74 Normal
Santana 5 36 57 62 67 Normal
Coldplay 6 63 73 78 83 Normal
Waxbill 7 76 85 90 95 Normal
Fauna 8 70 77 82 87 Normal
Fluorine 9 62 70 75 80 Normal
------------------------------------------------------------------------
Power: 146.216 watts
Examples The following example allows the PRE to power off the Cisco uBR-MC3GX60V line card when the
device temperature reaches critical threshold values.
Router# cable linecard critical-event-poweroff
Related Commands Command Description
show environment Displays temperature, voltage, fan, and power supply
information.
Cisco IOS CMTS Cable Command Reference
CBL-288 OL-15510-15
Cable Commands: cable l
cable load-balance d20-ggrp-default
cable load-balance d20-ggrp-default
To configure a DOCSIS 2.0 general load balancing group (GLBG) that is created automatically for each
fiber node (FN) configuration, use the cable load-balance d20-ggrp-default command in the global
configuration mode. To disable the default values of the DOCSIS 2.0 GLBG, use the no form of this
command.
cable load-balance d20-ggrp-default {disable | init-tech-list tech-list | docsis-policy 0-0xffffffff}
no cable load-balance d20-ggrp-default disable
Note The default values that are set using the command apply to DOCSIS 2.0 GLBGs created thereafter.
Parameters for existing DOCSIS 2.0 GLBGs do not change.
Syntax Description disable Disables the default values of the DOCSIS 2.0 GLBG that are enabled by
default.
init-tech-list tech-list Sets the default DOCSIS 2.0 GLBG DCC and DBC initialization techniques.
docsis-policy Sets the default DOCSIS 2.0 GLBG load balancing policy.
0-0xffffffff
Command Default no cable load-balance d20-ggrp-default disable
cable load-balance d20-ggrp-default init-tech-list 0-4
cable load-balance d20-ggrp-default docsis-policy 0
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines The group parameters in the cable load-balance d20-ggrp-default command can be set as default
values.
Examples The following is a sample output of the cable load-balance d20-ggrp-default command.
Router(config)# cable load-balance d20-ggrp-default
Router(config)# cable load-balance d20-ggrp-default disable
Router(config)# cable load-balance d20-ggrp-default docsis-policy 2
Router(config)# cable load-balance d20-ggrp-default init-tech-list 1
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-289
Cable Commands: cable l
cable load-balance d30-ggrp-default
cable load-balance d30-ggrp-default
To configure a DOCSIS 3.0 general load balancing group (GLBG) that is created automatically for each
MD-CM-SG based on the fiber node (FN) configuration, use the cable load-balance d30-ggrp-default
command in the global configuration mode. To disable the default values of the DOCSIS 3.0 GLBG, use
the no form of this command.
cable load-balance d30-ggrp-default {disable | init-tech-list tech-list | docsis-policy 0-0xffffffff}
no cable load-balance d30-ggrp-default disable
Note The default values that are set using the command apply to DOCSIS 3.0 GLBGs created thereafter.
Parameters for existing DOCSIS 3.0 GLBGs do not change.
Syntax Description disable Disables the default values of the DOCSIS 3.0 GLBG that are enabled by
default.
init-tech-list tech-list Sets the default DOCSIS 3.0 GLBG DCC and DBC initialization techniques.
docsis-policy Sets the default DOCSIS 3.0 GLBG load balancing policy.
0-0xffffffff
Command Default no cable load-balance d30-ggrp-default disable
cable load-balance d30-ggrp-default init-tech-list 0-4
cable load-balance d30-ggrp-default docsis-policy 0
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines The group parameters in the cable load-balance d30-ggrp-default command can be set as default
values.
Examples The following is a sample output of the cable load-balance d30-ggrp-default command.
Router(config)# cable load-balance d30-ggrp-default
Router(config)# cable load-balance d30-ggrp-default disable
Router(config)# cable load-balance d30-ggrp-default docsis-policy 2
Router(config)# cable load-balance d30-ggrp-default init-tech-list 1
Cisco IOS CMTS Cable Command Reference
CBL-290 OL-15510-15
Cable Commands: cable l
cable load-balance docsis-enable
cable load-balance docsis-enable
To enable or disable DOCSIS load balancing on the CMTS, use the cable load-balance docsis-enable
command in the global configuration mode. To disable DOCSIS load balancing, use the no form of this
command.
cable load-balance docsis-enable
no cable load-balance docsis-enable
Syntax Description This command has no arguments or keywords.
Command Default By default, the command is disabled on all the routers.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced.
Examples The following example shows how to enable DOCSIS load balancing on the CMTS using the cable
load-balance docsis-enable command.
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# cable load-balance docsis-enable
Config: Last Batch 0, 38 bytes
cable load-balance docsis-enable
end
Router(config)#
Related Commands Command Description
cable load-balance Configures a DOCSIS load balancing group on the CMTS.
docsis-group
show cable Displays real-time configuration, statistical and operational information for
load-balance load balancing operations on the router.
docsis-group
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-291
Cable Commands: cable l
cable load-balance docsis30-enable
cable load-balance docsis30-enable
To enable DOCSIS 3.0 static modem count-based load balancing, use the
cable load-balance docsis30-enable command in global configuration mode. To disable DOCSIS 3.0
static modem count-based load balancing, use the no form of this command.
cable load-balance docsis30 enable
no cable load-balance docsis30 enable
Syntax Description This command has no keywords or arguments.
Command Default By default, DOCSIS 3.0 static modem count-based load balancing is enabled.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCF1 This command was introduced.
Examples The following example shows how to disable DOCSIS 3.0 static modem count-based load balancing:
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# no cable load-balance docsis30-enable
Router(config)#
The following example shows how to verify if the DOCSIS 3.0 static modem count-based load balancing
is disabled:
Router# show cable load-balance | include DOCSIS 3
DOCSIS 2.0 LB Enabled: Yes DOCSIS 3.0 LB Enabled: No
DOCSIS 3.0 General LB
The following example shows how to enable DOCSIS 3.0 static modem count-based load balancing:
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# cable load-balance docsis30-enable
Router(config)#
The following example shows how to verify if DOCSIS 3.0 static modem count-based load balancing is
enabled:
Router# show cable load-balance | include DOCSIS 3
DOCSIS 2.0 LB Enabled: Yes DOCSIS 3.0 LB Enabled: Yes
DOCSIS 3.0 General LB
Cisco IOS CMTS Cable Command Reference
CBL-292 OL-15510-15
Cable Commands: cable l
cable load-balance docsis30-enable
Associated Features The cable load-balance docsis30-enable command is used to configure the following features:
• Load Balancing, Dynamic Channel Change, and Dynamic Bonding Change on the Cisco CMTS
Routers
• Restricted/General Load Balancing and Narrowband Dynamic Bandwidth Sharing with
Downstream Dynamic Load Balancing
Related Commands Command Description
show cable load-balance Displays real-time configurational, statistical and operational
information for load balancing operations on the router.
show cable load-balance Displays real-time configurational, statistical, and operational
docsis-group information of the DOCSIS group operations on the router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-293
Cable Commands: cable l
cable load-balance docsis-group
cable load-balance docsis-group
To configure a DOCSIS load balancing group (LBG) on the CMTS, use the cable load-balance
docsis-group command in the global configuration mode. To delete a DOCSIS load balancing group and
to remove it from the CMTS configuration, use the no form of this command.
cable load-balance docsis-group docsis-group-id
no cable load-balance docsis-group docsis-group-id
Cisco uBR10012 Router
cable load-balance docsis-group FN fn-id MD cable slot/subslot/port
Cisco uBR7225VXR and Cisco uBR7246VXR Routers
cable load-balance docsis-group FN fn-id MD cable slot/port
Syntax Description docsis-group-id DOCSIS load balance group ID. A valid DOCSIS load balance group ID
ranges from 1 to 2147483647 and does not overlap with the legacy LBG ID.
Therefore, both cable load-balance group 1 and cable load-balance
docsis-group 1 commands can be configured. The DOCSIS load balance
group ID ranging from 2147483648 to 2^32-1 is reserved for DOCSIS 3.0
general load balancing group (GLBG).
FN fn-id Specifies the fiber node (FN) where certain DOCSIS 3.0 GLBG parameters,
such as disable, docsis-policy, init-tech-list, interval, method, policy, and
threshold, can be configured.
MD cable Specifies the MAC domain interface of the fiber node.
slot/subslot/port
• 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.
MD cable slot/port Specifies the MAC domain interface of the fiber node on the
Cisco uBR7246VXR or Cisco uBR7225VXR router.
• 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.
Command Default None
Cisco IOS CMTS Cable Command Reference
CBL-294 OL-15510-15
Cable Commands: cable l
cable load-balance docsis-group
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines The cable load-balance docsis-group command creates a DOCSIS LBG with the specified number and
then enters the config-lb-group configuration mode. Use the config-lb-group configuration mode to
configure the DOCSIS LBG
• disable
• docsis-policy
• downstream
• init-tech-list
• init-tech-ovr
• interval
• method
• policy
• restricted
• service-type-id
• tag
• threshold
• upstream
Examples The following example shows how to create a DOCSIS group numbered "1":
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)# downstream Cable 1/1
Router(config-lb-group)# upstream Cable 1/0 2
Router(config-lb-group)# docsis-policy 0
Router(config-lb-group)# init-tech-ovr Cable 1/1 1 Cable 1/0 2 init-tech-list 1 ucc
Router(config-lb-group)# service-type-id ccc
Router(config-lb-group)# tag t1
Router(config-lb-group)# interval 10
Router(config-lb-group)# method modems us-method modems
Router(config-lb-group)# no policy us-across-ds pure-ds-load ugs
Router(config-lb-group)# restricted
Router(config-lb-group)# threshold pcmm 70 load 10 stability 50 ugs 70
Router(config-lb-group)#
The following example shows how to configure DOCSIS 3.0 GLBG parameters:
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# cable load-balance docsis-group FN 2 MD cable 1/0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-295
Cable Commands: cable l
cable load-balance docsis-group
Related Commands Command Description
docsis-policy Assigns a policy to a group, which is the default policy assigned to the CM
when the CM is not assigned a different policy.
downstream Sets downstream RF channels.
upstream Sets upstream channels.
init-tech-list Sets the DCC/DBC initialization techniques that the CMTS uses to load
balance cable modems. The init-tech-list command can also be used to
determine whether UCC can be used for modems during dynamic upstream
load balancing.
init-tech-ovr Sets DCC initialization techniques that overrides the physical upstream
channel pair. The init-tech-ovr command can also be used to determine
whether UCC can be used for modems during dynamic upstream load
balancing.
Note 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.
interval Sets the duration of time the CMTS waits before checking the load on an
interface.
method Selects the method the CMTS uses to determine the load. US methods can
be different from DS methods.
policy Selects modems, based on the type of service flow that will be balanced.
restricted Selects the restricted group type. By default, the general group type is
selected.
service-type-id Adds a service type ID that is compared with the cable modem provisioned
service type ID, to determine an appropriate restricted load balancing group
(RLBG).
tag Adds a tag to the load balancing group. The tag is used to assign the RLBG
to the CMs that have the same tag name.
threshold Specifies the threshold percentage of use exceeding which load balancing
occurs.
cable tag Configures the tag that gets added to the load balancing group.
Cisco IOS CMTS Cable Command Reference
CBL-296 OL-15510-15
Cable Commands: cable l
cable load-balance docsis-policy
cable load-balance docsis-policy
To create a DOCSIS policy and associate an existing rule and tag with the policy, use the cable
load-balance docsis-policy command in global configuration mode. To remove a DOCSIS policy, rule,
or tag from the policy, use the no form of this command.
cable load-balance docsis-policy policy-id [rule rule-id | tag tag name [override] ]
no cable load-balance docsis-policy policy-id [rule rule-id | tag tag name [override] ]
Syntax Description policy-id Specifies the DOCSIS policy to be created.
rule rule-id Specifies the rule to be used with the DOCSIS policy.
tag tag name Specifies the tag to be used with the DOCSIS policy.
override Overrides all the policies in the CM that has the specified tag name.
Command Default No default behavior or values for this command
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCB This command was introduced.
12.2(33)SCC The tag parameter was added to the command.
Usage Guidelines This command associates a rule with a policy. A policy is created only when a rule is associated with it.
Similarly, the policy is removed if you remove the last rule associated with the policy.
Examples The following example defines a DOCSIS policy, and associates a predefined rule and tag with this
policy:
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# cable load-balance docsis-policy 1 rule 1
Router(config)# cable load-balance docsis-policy 1 tag SPG override
Router(config)#
Related Commands Command Description
cable load-balance Creates a rule to prevent CM from disabling or enabling load balancing.
rule
cable tag Creates a tag to associate it with DOCSIS policies and groups.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-297
Cable Commands: cable l
cable load-balance group
cable load-balance group
To create a load-balance group and configure the type of load-balancing to be used, use the cable
load-balance group command in global configuration mode. To delete a load-balance group, use the no
form of this command. To reset a load-balance group to its default configuration, use the default form
of this command.
cable load-balance group n [method utilization | method modem | method service-flows]
no cable load-balance group n
Syntax Description n Specifies the number of the load balance group. In Cisco IOS Release
12.2(33)SCE3 and earlier, the valid range is from 1 to 80. In
Cisco IOS Release 12.2(33)SCE4 and later, the valid range is from 1 to 256.
method modem (Optional) Specifies that the load-balance group should use the number of
active cable modems on an interface to determine the current load (default).
This method does not take into account the amount of traffic flowing
through those particular cable modems.
method service-flows (Optional) Specifies that the load-balance group should use the number of
active service flow IDs (SFIDs) on an interface to determine the current
load.
method utilization (Optional) Specifies that the load-balance group should use an interface’s
current percentage of utilization to determine the current load.
Tip The utilization method does not begin moving cable modems for
load balancing until the utilization of the interface is at 25 percent
or more. This is done to avoid the unnecessary moving of cable
modems due to temporary spikes in an interface’s utilization rates.
Command Default No load-balance groups are created. By default, a load-balance group uses the actual number of cable
modems online each interface to determine load balancing needs (modem option).
Note If you do not create any load-balance groups, the Cisco CMTS defaults to using a form of
registration-based load balancing that attempts to equally distribute cable modems among upstreams at
the time the cable modems register and come online. No load balancing is done for downstreams or for
cable modems that are already online.
Command Modes Global configuration
Command History Release Modification
12.2(15)BC1 This command was introduced for the Cisco uBR7246VXR and
Cisco uBR10012 routers.
12.2(33)SCE4 The valid range for the load balance group was changed.
Cisco IOS CMTS Cable Command Reference
CBL-298 OL-15510-15
Cable Commands: cable l
cable load-balance group
Usage Guidelines The cable load-balance command creates a load-balance group, which can then be assigned to a number
of upstream and downstream cable interfaces to allow the Cisco CMTS to load balance cable modems
as needed. The Cisco CMTS can use the load-balance groups for static, passive, and dynamic load
balancing of both upstream and downstream channels. You can configure downstreams and upstreams
to use the same load balancing parameters, or you can configure upstreams and downstreams separately.
Note You can create a maximum of 20 load-balance groups on each chassis. However, you can reuse those
load-balance groups on different sets of cable interfaces, as long as they are in different domains. If
downstreams are not included in a load-balance group, then each downstream can be considered a
separate domain.
Use the cable load-balance group (global configuration) command to initially create and configure a
load-balance group. Then use the cable load-balance group (interface configuration) command to
assign this load-balance group to an upstream or downstream, so that the cable interface will begin
participating in load-balancing operations.
You can configure a load-balance group to use one of the following types of load-balancing methods:
• Modem Method—Uses the number of active cable modems on an interface.
• Service Flow Method—Uses the number of active Service Flow IDs (SFIDs) on an interface.
• Utilization Method—Uses an interface’s current percentage of utilization.
See the following sections for more information about each method.
Modem Method
The modem method of load-balancing uses the number of active cable modems on an interface to
determine the current load. This is a form of distribution-based load balancing, in which the absolute
numbers of modems are used to determine whether interfaces are load balanced.
This method does not take into account the amount of traffic flowing through the cable modems, but the
system does take into account the relative bandwidth of the channels being used, so that channels with
higher bandwidths are allocated higher numbers of cable modems. This means that when interfaces are
using different channel widths or modulation profiles, the system can assign different numbers of cable
modems to the interfaces to achieve a balanced load. For example:
• Channel widths— If two upstreams are being load balanced, and one upstream is configured with a
channel width of 1.6 MHz and the other upstream is configured for a channel width of 3.2 MHz, the
Cisco CMTS allocates twice as many cable modems to the second upstream, because its channel
width is twice as large as the first upstream’s channel width.
• Modulation profiles— If one downstream is configured for 64-QAM and the other downstream is
configured for 256-QAM, the Cisco CMTS allocates a proportionately larger number of cable
modems to the second downstream so as to achieve a balanced load.
When both the channel width and different modulation profile are set differently on two interfaces, the
system calculates a “weight” value to use as a guide to determine the relative bandwidths of the
interfaces.
Tip In a system with balanced loads, the interfaces will contain the same number of cable modems only when
the interfaces are configured with the same modulation parameters.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-299
Cable Commands: cable l
cable load-balance group
Service Flow Method
The service-flows method of load balancing uses the number of active service flow IDs (SFIDs) on an
interface to determine the current load. This is a form of distribution-based load balancing, in which the
absolute numbers of service flows are used to determine whether interfaces are load balanced.
This method does not take into account the amount of traffic flowing on each SFID, but the system does
take into account the relative bandwidth of the channels being used, so that channels with higher
bandwidths are allocated higher numbers of SFIDs. This means that when interfaces are using different
channel widths or modulation profiles, the system can assign different numbers of SFIDs to the
interfaces to achieve a balanced load. For example:
• Channel widths— For example, if two upstreams are being load balanced, and one upstream is
configured with a channel width of 1.6 MHz and the other upstream is configured for a channel
width of 3.2 MHz, the Cisco CMTS allocates twice as many SFIDs to the second upstream, because
its channel width is twice as large as the first upstream’s channel width.
• Modulation profiles— For example, if one downstream is configured for 64-QAM and the other
downstream is configured for 256-QAM, the Cisco CMTS allocates a proportionately larger number
of SFIDs to the second downstream so as to achieve a balanced load.
When both the channel width and different modulation profile are set differently on two interfaces, the
system calculates a “weight” value to use as a guide to determine the relative bandwidths of the
interfaces.
Tip In a system with balanced loads, the interfaces will contain the same number of SFIDs only when the
interfaces are configured with the same modulation parameters.
Utilization Method
The utilization method uses an interface’s current percentage of utilization to determine the current
load. This method uses the amount of traffic being sent over an interface, in the form of the percentage
of total bandwidth being used. (To avoid unnecessary movement of cable modems, the utilization
method does not perform load balancing until an interface is at least 25 percent of utilization.)
Note Do not use the utilization method of load balancing on cable interfaces that have a small
number of cable modems and where a single modem is responsible for the majority of the
interface load. In this condition, the Cisco CMTS could end up continually moving cable
modems from one interface to another in an endless attempt to load balance the interfaces.
To avoid this, configure the utilization threshold to a value that is higher than what can be
caused by any single cable modem.
When using the utilization method, the system takes into account the relative throughput and bandwidth
(as determined by the modulation profiles and channel widths) of each interface when evaluating the
load on those interfaces. For example, if two upstreams are being load-balanced using the utilization
method, and the first upstream has twice the bandwidth of the second upstream, the two upstreams are
considered balanced when they reach the same percentage of utilization. The first upstream is carrying
more traffic than the second upstream because it has a larger capacity for traffic, but the percentage of
utilization will be the same.
Cisco IOS CMTS Cable Command Reference
CBL-300 OL-15510-15
Cable Commands: cable l
cable load-balance group
Note Certain conditions can cause a system instability that could result in the Cisco CMTS endlessly
attempting to load balance the interfaces. For example, this situation could occur in noisy environments,
where cable modems drop offline on a regular basis, or when cable modems are repeatedly trying to
register because the provisioning system has sent them the wrong DOCSIS configuration files. If the
Cisco CMTS detects such unstable situations, it does not load balance cable modems from those
interfaces until the system stabilizes. However, if the system instability persists, you should increase the
threshold values using the cable load-balance group threshold command until you can solve the
stability problems.
Use the no form of this command to delete a load-balance group. Deleting a load-balance group also
automatically removes all upstream and downstream channel associations that were made with that
group using the cable load-balance and cable upstream load-balance commands.
Tip To exclude individual cable modems from one or more types of load balancing, use the cable
load-balance exclude command.
Examples The following example shows how to create a load-balance group numbered 10, using the default
method of modem, which specifies that the Cisco CMTS uses the actual number of cable modems that
are online to determine load-balancing operations.
Router# config terminal
Router(config)# cable load-balance group 10
Router(config)#
The following example shows how to create a load-balance group numbered 1, which uses the number
of active SFIDs on an interface to determine the current load on the interface:
Router# config terminal
Router(config)# cable load-balance group 1 method service-flows
Router(config)#
Associated Features The cable load-balance group command is used to configure the following features:
• IGMP-Triggered Dynamic Channel Change Load Balancing for DOCSIS 2.0 Cable Modems
• Load Balancing and Dynamic Channel Change on the Cisco CMTS Routers
• Restricted/General Load Balancing and Narrowband Dynamic Bandwidth Sharing with
Downstream Dynamic Load Balancing
Related Commands Command Description
cable load-balance Excludes a particular cable modem, or all cable modems from a particular
exclude vendor, from one or more types of load-balancing operations.
cable load-balance Assigns a downstream to a load-balance group.
group (interface
configuration)
cable load-balance Configures the frequency of the load-balancing policy updates.
group interval
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-301
Cable Commands: cable l
cable load-balance group
Command Description
cable load-balance Configures how the Cisco CMTS should load balance cable modems with
group policy ugs active unsolicited grant service (UGS) service flows.
cable load-balance Configures the threshold values that a load-balance group should use for
group threshold load-balancing operations.
cable upstream Assigns an upstream to a load-balance group.
load-balance group
clear cable Clears the counters or state machine used to track load-balancing
load-balance operations.
show cable Displays real-time statistical and operational information for
load-balance load-balancing operations.
Cisco IOS CMTS Cable Command Reference
CBL-302 OL-15510-15
Cable Commands: cable l
cable load-balance group (interface)
cable load-balance group (interface)
To assign a downstream cable interface to a load balance group, use the cable load-balance group
command in interface configuration mode. To remove a downstream from a load balance group, use the
no form of this command.
cable load-balance group n
no cable load-balance group n
Syntax Description n Specifies the number of the load balance group to which the downstream should be assigned.
In Cisco IOS Release 12.2(33)SCE3 and earlier, the valid range is from 1 to 80. In
Cisco IOS Release 12.2(33)SCE4 and later, the valid range is from 1 to 256.
Command Default A downstream is not assigned to a load balance group. When you use this command to add a downstream
to a group, it also automatically adds all of the associated upstreams to the same group, unless you have
also used the cable upstream load-balance group command to assign the upstreams to different groups.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.2(15)BC1 This command was introduced for the Cisco uBR7246VXR and Cisco uBR10012
routers.
12.2(33)SCE4 The valid range for the load balance group was changed.
Usage Guidelines After you have used the cable load-balance group (global configuration) command to initially create
and configure a load balance group, use the cable load-balance group (interface configuration)
command to assign this load balance group to a downstream. This enables the cable interface to begin
participating in load-balancing operations.
Tip Use the cable upstream load-balance group command to assign this load balance group to an upstream.
The following rules apply when creating and assigning load balance groups:
• A downstream or upstream can belong to only one load balance group.
• All downstreams and upstreams in a load balance group must share physical radio frequency (RF)
connectivity to the same group of cable modems. Downstreams can be in a separate load balance
group than upstreams, but all downstreams or all upstreams that have the same RF physical
connectivity must be members of the same load balance group. You cannot distribute downstreams
or upstreams that share physical connectivity across multiple load balance groups.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-303
Cable Commands: cable l
cable load-balance group (interface)
Note If both downstreams and upstreams are assigned to the same load balance group, the
Cisco CMTS attempts to balance both the downstream and upstream values when it moves
cable modems.
• If the load balance group includes downstream interfaces, you must also configure the downstream
center frequency on those interfaces, using the cable downstream frequency cable interface
command. This command is informational-only on cable interfaces that use an external upconverter,
but it is required for load balancing, so that the Cisco CMTS knows where to move cable modems
when it is load balancing downstreams.
• Load balancing is done only on a per-chassis basis—all interfaces in a load balance group must be
in the same chassis.
Note In Cisco IOS Release 12.2(15)BC1, you can configure an interface for both load balancing and
Hot-Standby Connection-to-Connection (HCCP) N+1 redundancy, but load balancing does not continue
after a switchover from a Working to a Protect interface. Load balancing resumes when the Cisco CMTS
switches back to the Working interface.
Examples The following example shows how to assign the first downstream on the cable interface line in slot five
to load balance group 5:
Router# config terminal
Router(config)# interface cable 5/0
Router(config-if)# cable load-balance group 5
Router(config-if)#
Associated Features The cable load-balance group command is used to configure the following features:
• IGMP-Triggered Dynamic Channel Change Load Balancing for DOCSIS 2.0 Cable Modems
• Load Balancing and Dynamic Channel Change on the Cisco CMTS Routers
• Restricted/General Load Balancing and Narrowband Dynamic Bandwidth Sharing with
Downstream Dynamic Load Balancing
Related Commands Command Description
cable load-balance exclude Excludes a particular cable modem, or all cable
modems from a particular vendor, from one or
more types of load-balancing operations.
cable load-balance group (global configuration) Creates and configures a load balance group.
cable load-balance group interval Configures the frequency of the load balancing
policy updates.
cable load-balance group policy ugs Configures how the Cisco CMTS should load
balance cable modems with active unsolicited
grant service (UGS) service flows.
cable load-balance group threshold Configures the threshold values that a load
balance group should use for load-balancing
operations.
Cisco IOS CMTS Cable Command Reference
CBL-304 OL-15510-15
Cable Commands: cable l
cable load-balance group (interface)
Command Description
cable upstream load-balance group Assigns an upstream to a load balance group.
clear cable load-balance Clears the counters or state machine used to track
load balancing operations.
show cable load-balance Displays real-time statistical and operational
information for load balancing operations.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-305
Cable Commands: cable l
cable load-balance group (Supporting Dynamic Channel Change)
cable load-balance group (Supporting Dynamic Channel Change)
To set multiple parameters for Load Balancing with Dynamic Channel Change (DCC), use the following
command in global configuration mode. To remove this c onfiguration, use the no form of this
command.
cable load-balance group group-num {dcc-init-technique | interval | method | policy | threshold}
no cable load-balance group group-num {dcc-init-technique | interval | method | policy | threshold}
Syntax Description dcc-init-technique Sets DCC initialization technique
interval Sets interface polling interval
method Sets upstream load balancing type/method
policy Sets load balancing policy
threshold Load balancing threshold in percentage
Command Default Load balancing is not configured by default on the Cisco CMTS.
Command Modes Global configuration mode.
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.
Examples The following example illustrates configuration of the initialization techniques specified for DCC:
Router(config)# cable load-balance group 1 dcc-init-technique 4
For further examples of this command, and related keywords, refer to related commands, and refer also
to Configuring Load Balancing and Dynamic Channel Change (DCC) on the Cisco CMTS.
Usage Guidelines This command is subject to the restrictions and prerequisites described in Configuring Load Balancing
and Dynamic Channel Change (DCC) on the Cisco CMTS.
Cisco IOS CMTS Cable Command Reference
CBL-306 OL-15510-15
Cable Commands: cable l
cable load-balance group (Supporting Dynamic Channel Change)
Related Commands Command Description
cable load-balance group Sets the initialization technique for Dynamic Channel Change
dcc-init-technique (Supporting (DCC) for Load Balancing.
Dynamic Channel Change)
cable load-balance group policy Sets the type of service flow for use with Load Balancing and
(Supporting Dynamic Channel DCC, whether PacketCable MultiMedia (PCMM) or
Change) Unsolicited Grant Service (UGS).
cable load-balance group threshold Sets the threshold levels for corresponding service flow types
(Supporting Dynamic Channel for the specified Load Balancing group, supporting Dynamic
Change) Channel Change (DCC)
show controllers cable Displays statistics for Dynamic Channel Change (DCC) for
load balancing.
test cable dcc (Supporting Dynamic Performs testing functions for Load Balancing with DCC
Channel Change)
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-307
Cable Commands: cable l
cable load-balance group interval
cable load-balance group interval
To configure the frequency of the load-balancing policy updates, use the cable load-balance group
interval command in global configuration mode. To reset the frequency of the policy updates to its
default values, use the no form of this command.
cable load-balance group n interval interval
no cable load-balance group n interval
Syntax Description n Specifies the number of the load balance group. In Cisco IOS Release 12.2(33)SCE3 and
earlier, the valid range is from 1 to 80. In Cisco IOS Release 12.2(33)SCE4 and later, the
valid range is from 1 to 256.
interval Specifies the frequency, in seconds, for how often the Cisco CMTS router should determine
the current load on each cable interface. This also determines the minimum time between
when cable modems can be moved to load balance the interfaces. One cable modem at most
is moved during each interval time period. The valid range is 1 to 1000 seconds. 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 Each load balance group uses the default interval value, if the interval time period is not specified.
Command Modes Global configuration
Command History Release Modification
12.2(15)BC1 This command was introduced for the Cisco uBR7246VXR and Cisco uBR10012
routers.
12.2(33)SCE1 The default value for the interval keyword was changed from 10 seconds to 30
seconds.
12.2(33)SCE4 The valid range for the load balance group was changed.
Usage Guidelines To properly perform load balancing, the Cisco CMTS must determine the actual load on an interface on
a periodic basis. This frequency of the updates also determines how frequently cable modems can be
moved to achieve balanced loads. One cable modem, at most, is moved during each update period.
The more often these updates are performed, the more accurate the Cisco CMTS can be in performing
its load balancing operations. As a general rule, begin with the default frequency value, and then adjust
the value accordingly, in small increments, as load balancing conditions or performance levels might
require. The default interval value was changed in Cisco IOS Release 12.2(33)SCF to reduce thrashing
of cable modems when utilization-based method is used with DOCSIS load balancing.
Cisco IOS CMTS Cable Command Reference
CBL-308 OL-15510-15
Cable Commands: cable l
cable load-balance group interval
Note Having too small an interval could result in cable modems being constantly moved to achieve balanced
loads during peak usage times when load balance could spike to transient heavy traffic. Also, more
frequent updates can have a performance impact, especially on routers with a large number of active
interfaces and cable modems.
Examples The following example shows how to configure load-balance group 3 so that it performs a policy update
every 30 seconds:
Router# config terminal
Router(config)# cable load-balance group 3 interval 30
Router(config)#
The following example shows how to reset load-balance group 10 to its default update frequency of 10
seconds:
Router# config terminal
Router(config)# no cable load-balance group 10 interval
Router(config)#
Associated Features The cable load-balance group interval command is used to configure the following feature:
• Load Balancing and Dynamic Channel Change on the Cisco CMTS Routers
Related Commands Command Description
cable load-balance exclude Excludes a particular cable modem, or all cable modems from
a particular vendor, from one or more types of load-balancing
operations.
cable load-balance group (global Creates and configures a load-balance group.
configuration)
cable load-balance group (interface Assigns a downstream to a load-balance group.
configuration)
cable load-balance group policy ugs Configures how the Cisco CMTS should load balance cable
modems with active unsolicited grant service (UGS) service
flows.
cable load-balance group threshold Configures the threshold values that a load-balance group
should use for load-balancing operations.
cable upstream load-balance group Assigns an upstream to a load-balance group.
clear cable load-balance Clears the counters or state machine used to track
load-balancing operations.
show cable load-balance Displays real-time statistical and operational information for
load-balancing operations.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-309
Cable Commands: cable l
cable load-balance group policy
cable load-balance group policy
The following command is introduced to the Cisco CMTS starting in Cisco IOS Release 12.2(17b)BC4.
To set the type of service flow policy for use with Load Balancing, use the following command in global
configuration mode. This enhancement synchronizes the pending statistic between different cable
interface line cards in the load balancing group. The result is an alternative downstream load balancing
scheme that makes use of per-upstream loads rather than total downstream loads.
To remove this configuration, use the no form of this command.
cable load-balance group ds-lb-group-id policy us-groups-across-ds
no cable load-balance group ds-lb-group-id policy us-groups-across-ds
Syntax Description ds-lb-group-id Specifies the load balancing group being configured. This downstream
group includes the upstream segment in load balancing decisions.
us-groups-across-ds Specifies the upstream group to be distributed in load balancing decisions
for the downstream group specified.
Command Default By default, this load balancing configuration is not enabled on the Cisco CMTS.
Command Modes Global configuration mode.
Command History Release Modification
12.2(17b)BC4 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.
Examples The following example illustrates this command and one supported implementation:
Router(config)# cable load-balance group 1 policy 2
Router(config)#
In this example, a cable modem that comes online on the interface cable 5/0 Upstream 2 could potentially
come online on the following interfaces:
• cable 3/0 upstream 2
• cable 4/0 upstream 2
• cable 6/0 upstream 2
• nowhere else, however
With downstream load balancing prior to Cisco IOS Release 12.2(17b)BC4, having 100 cable modems
per segment would be possible in an extreme case that distributes cable modems as follows:
U0 U1 U2 U3 Downstream
3/0 97 1 1 1 100
4/0 1 97 1 1 100
5/0 1 1 97 1 100
6/0 1 1 1 97 100
Cisco IOS CMTS Cable Command Reference
CBL-310 OL-15510-15
Cable Commands: cable l
cable load-balance group policy
Usage Guidelines This command is subject to the restrictions and prerequisites described in Configuring Load Balancing
and Dynamic Channel Change (DCC) on the Cisco CMTS.
Cisco IOS Release 12.2(17b)BC4 enables the optional operation of making downstream load balancing
decisions as follows:
• The target downstream segment is in the same downstream load balancing group as the source
downstream segment.
• The upstream load balancing group can be set for the corresponding channel on which a cable
modem is balanced.
• The Cisco CMTS automatically locates the upstream segment for a load balancing group and
processes the upstream group status on the source interface that has the lowest load.
• The target downstream segment must have an upstream channel set in the upstream load balancing
group.
• The highest target upstream segment must carry less load than any other potential target —the
highest upstream segment on other interfaces.
This command enables an alternative downstream load balancing scheme that makes use of
per-upstream loads rather than total downstream loads.
This enhancement performs downstream load balancing that accounts upstream channel loads in the
same upstream load balancing group, rather than on the basis of the entire downstream channel load.
Prior Cisco IOS releases may not have distributed cable modems evenly over individual upstream
channels, nor in a way that accounted for downstream and upstream together.
This enhancement applies when downstream load balancing occurs on a headend system with separate
upstream load balancing segments; the upstream segments are spread over multiple downstreams
segments.
This optional configuration supports output of the show cable load-balance command so that the
command displays more information about loads on channels that are configured on external or remote
cable interface line cards.
Related Commands Command Description
show cable load-balance Displays information about loads on channels that are
configured on external or remote cable interface line cards, to
include integrated per-upstream load balancing information.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-311
Cable Commands: cable l
cable load-balance group policy ugs
cable load-balance group policy ugs
To configure whether the Cisco CMTS should load balance cable modems with Unsolicited Grant
Service (UGS) service flows (which are typically used for active voice calls), use the cable
load-balance group policy ugs command in global configuration mode. To reset the load-balance group
to its default policy setting, use the no form of this command.
cable load-balance group n policy ugs
no cable load-balance group n policy ugs
Syntax Description n Specifies the number of the load-balance group. In Cisco IOS Release
12.2(33)SCE3 and earlier, the valid range is from 1 to 80. In
Cisco IOS Release 12.2(33)SCE4 and later, the valid range is from 1 to 256.
Defaults Cable modems with active UGS service flows can be moved for load-balancing (cable load-balance
group n policy ugs)
Command Modes Global configuration
Command History Release Modification
12.2(15)BC1 This command was introduced for the Cisco uBR7246VXR and
Cisco uBR10012 routers.
12.2(33)SCE4 The valid range for the load balance group was changed.
Usage Guidelines The cable load-balance group policy ugs command determines whether a load-balance group can move
cable modems with UGS service flows, so as to enforce dynamic load balancing policies. Because most
voice calls use UGS service flows to allow real-time traffic, this option is primarily used to determine
whether the Cisco CMTS will move cable modems with active voice calls.
If you disable this option (no cable load-balance group policy ugs), the Cisco CMTS does not move
cable modems with active UGS service flows to a new upstream or downstream. This prevents some
possible interruptions of service to these customers, but it could result in denial of service conditions for
other customers if the interface starts becoming overloaded.
To avoid this, the default configuration (cable load-balance group policy ugs) of this command allows
the Cisco CMTS to move cable modems to a new upstream or downstream, even if they have active UGS
service flows. This enables the Cisco CMTS to perform optimum load balancing, but it could cause a
momentary interruption in the voice call—users on the voice call might hear a momentary drop during
the call, but the call should not be terminated.
Note The cable load-balance group policy ugs command affects only dynamic load-balancing operations
and does not affect static and passive load-balancing operations. Dynamic load balancing is enabled
using the enforce option with the cable load-balance group threshold command.
Cisco IOS CMTS Cable Command Reference
CBL-312 OL-15510-15
Cable Commands: cable l
cable load-balance group policy ugs
Examples The following example shows how to enable the UGS policy on a load-balance group (the default
configuration), so that the Cisco CMTS can move cable modems with active UGS service flows as
needed to enforce the current dynamic load balancing policy:
Router# config terminal
Router(config)# cable load-balance group 13 policy ugs
Router(config)#
The following example shows how to configure a load-balance group so that the Cisco CMTS does not
move cable modems with active UGS service flows (default configuration):
Router# config terminal
Router(config)# no cable load-balance group 100 policy ugs
Router(config)#
Associated Features The cable load-balance group policy ugs command is used to configure the following feature:
• Load Balancing and Dynamic Channel Change on the Cisco CMTS Routers
Related Commands Command Description
cable load-balance Assigns a downstream to a load-balance group.
group (interface)
cable load-balance Excludes a particular cable modem, or all cable modems from a particular
exclude vendor, from one or more types of load-balancing operations.
cable load-balance Creates and configures a load-balance group.
group
cable load-balance Configures the frequency of the load-balancing policy updates.
group interval
cable load-balance Configures the threshold values that a load-balance group should use for
group threshold load-balancing operations.
cable upstream Assigns an upstream to a load-balance group.
load-balance group
show cable Displays real-time statistical and operational information for
load-balance load-balancing operations.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-313
Cable Commands: cable l
cable load-balance group threshold
cable load-balance group threshold
To configure the threshold values that a load-balance group should use for load-balancing operations,
use the cable load-balance group threshold command in global configuration mode. To reset the
load-balance group to its default threshold values, use the no form of this command.
cable load-balance group n threshold {load load-value [enforce threshold] |
load minimum number | stability percent | ugs band-value}
Syntax Description n Specifies the number of the load-balance group. In Cisco IOS Release
12.2(33)SCE3 and earlier, the valid range is from 1 to 80. In
Cisco IOS Release 12.2(33)SCE4 and later, the valid range is from 1 to 256.
load load-value Specifies the maximum load difference, as expressed in a percentage of
total load, that can exist between interfaces in a load-balance group before
the Cisco CMTS performs load balancing. If the load between interfaces is
greater than the value specified by load-value, cable modems that are
registering are assigned to the lesser-utilized interface until the load
difference is once again below this value. The valid range for load-value is
1 to 100 percent, with a default of 10 percent.
Note The default of 10 percent is the minimum recommended threshold.
Do not set this threshold below 10 percent unless you have been
instructed to do so by Cisco TAC.
enforce threshold (Optional) Enables dynamic load balancing, which moves online cable
modems after their initial registration to achieve load balancing of the cable
interfaces in a load-balance group. Cable modems that are currently online
are moved when the load difference between two interfaces in the
load-balance group exceeds this percentage. Modems continue to be moved
until the load difference falls below this value.
The possible valid range for threshold is 1 to 100 percent, but the threshold
must be equal to or greater than the percentage specified with the load-value
option. For this reason, the actual minimum for threshold is the current
setting of the load-value option. The default is also the same value as the
load-value parameter.
load minimum number (Optional) Specifies that cable modems should be moved only if the load
between the two interfaces is greater than the specified number of cable
modems or service flows (valid only when the method is the number of
modems or service flows). The valid range is 1 to 100, with a default of 5.
Cisco IOS CMTS Cable Command Reference
CBL-314 OL-15510-15
Cable Commands: cable l
cable load-balance group threshold
stability percent Specifies the threshold to be used to determine whether a channel or
interface is unstable, in terms of the percentage of successful ranging
requests. The percent value specifies the minimum percentage of successful
ranging requests that is acceptable; otherwise, the CMTS begins moving
CMs. The valid range is 1 to 100 percent, with a default of 50 percent.
ugs band-value Specifies that the Cisco CMTS should move cable modems with active
UGS service flows when the current UGS usage reaches the percentage of
total bandwidth available that is specified by the band-value parameter. The
valid range for band-value is 0 to 100 percent, with a default of 70 percent.
Note This option is effective only when the enforce option has also been
used to enable dynamic load balancing, and the Cisco CMTS has
been authorized to move cable modems with active UGS service
flows (using the cable load-balance group policy ugs command).
Defaults The load parameter defaults to 10 percent, the load minimum parameter defaults to 5, the stability
parameter defaults to 50 percent, and the ugs parameter defaults to 70 percent. By default, only static
load balancing is done (no enforce option). If the enforce option is given without a threshold value, it
defaults to the same value as the load parameter.
Command Modes Global configuration
Command History Release Modification
12.2(15)BC1 This command was introduced for the Cisco uBR7246VXR and
Cisco uBR10012 routers.
12.2(33)SCE4 The valid range for the load balance group was changed.
Usage Guidelines The cable load-balance group threshold command configures a load-balance group for the threshold
values that it should use to determine when a cable modem should be moved to a new downstream or
upstream. You can specify the following different thresholds:
• load—Specifies the maximum load usage that can exist between interfaces in a load-balance group
before the Cisco CMTS begins static load-balancing operations. The default value of load-value is
10 percent, which means that two upstreams or two downstreams can have usage rates that vary up
to 10 percent before the Cisco CMTS begins rebalancing the load usage. This rebalancing, however,
is done only when cable modems first register with the Cisco CMTS—the Cisco CMTS does not
switch cable modems that are already online.
For example, if the load value is 10 percent, and upstream 1 is at 23 percent and upstream 2 is at 30
percent, no cable modems are moved. However, if load usage for upstream 2 reaches 35 percent, the
Cisco CMTS begins assigning new cable modems, as they register, to upstream 1 until the
difference in load usage between the two upstreams falls below 10 percent.
Note The default of 10 percent is the minimum recommended threshold. Do not set this threshold
below 10 percent unless you have been instructed to do so by Cisco TAC.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-315
Cable Commands: cable l
cable load-balance group threshold
• enforce—Enables dynamic load balancing, so that the Cisco CMTS can move cable modems that
are already online. This option has its own threshold value, which specifies the difference in load
usage that must exist between two interfaces in a group before the Cisco CMTS begins moving
online cable modems. The Cisco CMTS continues to move cable modems until the difference in
load usage rates falls below the threshold value.
When using dynamic load balancing and an upstream channel is overloaded, the Cisco CMTS sends
an Upstream Channel Change (UCC) request to a cable modem to instruct it to move to another
upstream. The cable modem should move to the new upstream channel, without going offline or
having to reregister with the CMTS.
When using dynamic load balancing and a downstream channel is overloaded, the Cisco CMTS
sends an abort response to a cable modem’s ranging request (RNG-REQ) message. When the cable
modem sends a new REG-REQ message, the Cisco CMTS specifies the new downstream channel
in the Downstream Frequency Override field in its REG-RSP message. The cable modem must go
offline and reregister on the new downstream channel, so as to conform to the DOCSIS 1.0
specifications.
Note In Cisco IOS Release 12.2(15)BC1, the dynamic load balancing method results in cable
modems going offline and having to reregister whenever the modems are moved between
downstreams. This is because the DOCSIS 1.0 specification requires cable modems to
reregister whenever the downstream is changed using the Downstream Frequency Override
message. Cable modems should not go offline when moved between upstreams.
The Cisco CMTS also continues to enforce the load threshold value to perform static load balancing
as well. Therefore, the threshold percentage should be equal to or greater than the percentage
specified with the load load-value option.
For example, if you specify load 10 enforce 15, the Cisco CMTS monitors the load usage between
cable interfaces in the load-balance group. If upstream 1 reaches 33 percent and upstream 2 reaches
45 percent, the Cisco CMTS begins static load-balancing operations by assigning new cable
modems to upstream 1 when they register. If the difference still continues to grow, and upstream 2
reaches 50 percent, the Cisco CMTS also begins dynamic load-balancing operations by moving
online cable modems, until the difference in load usage falls below 15 percent. The Cisco CMTS
then continues static load-balancing operations until the difference falls below 10 percent.
Tip The enforce threshold is not displayed in the configuration file if it is the same as the load
threshold. For example, if you enter the “cable load-balance group 1 threshold load 50
enforce 50” command, it appears as “cable load-balance group 1 threshold load 50 enforce”
in the configuration file.
• load minimum—Specifies that cable modems should be moved only if the load between the two
interfaces is greater than the specified number of cable modems or service flows. This option is valid
only when you have configured the load-balance group using either the method modem or
method service-flows options with the cable load-balance group command. It is not used with the
utilization method.
• stability—Specifies the minimum percentage of ranging requests that are successful before the
Cisco CMTS determines that the interface or channel is unstable. When the channel has fewer than
this percentage of cable modems responding to periodic ranging requests over a one-minute period,
the Cisco CMTS begins moving modems to other channels in the load-balance group. For example,
when set to 75 percent, the Cisco CMTS begins moving modems when fewer than 75 percent of
modems are replying to ranging requests.
Cisco IOS CMTS Cable Command Reference
CBL-316 OL-15510-15
Cable Commands: cable l
cable load-balance group threshold
• ugs—Specifies a threshold for when the Cisco CMTS should move cable modems that have active
UGS service flows, which are typically used for active voice calls. This option goes into force only
when dynamic load balancing has been enabled (using the enforce option), and the Cisco CMTS has
been allowed to move cable modems with active UGS service flows). The band-value threshold
specifies the maximum usage of UGS service flows that should exist before the Cisco CMTS begins
moving calls.
For example, if the band-value threshold is at its default of 70 percent, the Cisco CMTS does not
begin moving cable modems with active UGS service flows until UGS usage on an upstream or
downstream reaches 70 percent of the total available bandwidth. The Cisco CMTS continues
moving cable modems that are online with active UGS service flows until the UGS usage on the
interface falls below 70 percent.
Note Certain conditions can cause a system instability that could result in the Cisco CMTS endlessly
attempting to load balance the interfaces. For example, this situation could occur in noisy environments,
where cable modems drop offline on a regular basis, or when cable modems are repeatedly trying to
register because the provisioning system has sent them the wrong DOCSIS configuration files. If the
Cisco CMTS detects such unstable situations, it does not load balance cable modems from those
interfaces until the system stabilizes. However, if the system instability persists, you should increase the
threshold values using the cable load-balance group threshold command until the system stabilizes.
Examples The following example shows how to configure load-balance group 2 so that it performs static load
balancing when the difference between two cable interfaces in the group is 20 percent or more.
Router# config terminal
Router(config)# cable load-balance group 2 threshold load 20
Router(config)#
The following example shows how to configure load-balance group 5 so that it performs static load
balancing when the difference in usage between two cable interfaces in the group is 20 percent or more,
and so that it performs dynamic load balancing when the difference in usage is 30 percent or more. The
Cisco CMTS will also begin moving cable modems with active UGS service flows when UGS service
flows reach 60 percent of the total bandwidth available on the upstream channel.
Router(config)# cable load-balance group 5 threshold load 20 enforce 30
Router(config)# cable load-balance group 5 threshold ugs 60
Router(config)# cable load-balance group 5 policy ugs
Router(config)#
Note You must configure the load-balance group with the cable load-balance group policy ugs command
before the Cisco CMTS begins enforcing the threshold that was set with the cable load-balance group
threshold ugs command.
Associated Features The cable load-balance group threshold command is used to configure the following feature:
• Load Balancing and Dynamic Channel Change on the Cisco CMTS Routers
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-317
Cable Commands: cable l
cable load-balance group threshold
Related Commands Command Description
cable load-balance Excludes a particular cable modem, or all cable modems from a particular
exclude vendor, from one or more types of load-balancing operations.
cable load-balance Creates and configures a load-balance group.
group
cable load-balance Assigns a downstream to a load-balance group.
group (interface)
cable load-balance Configures the frequency of the load-balancing policy updates.
group interval
cable load-balance Configures how the Cisco CMTS should load balance cable modems with
group policy ugs active unsolicited grant service (UGS) service flows.
cable upstream Assigns an upstream to a load-balance group.
load-balance group
clear cable Clears the counters or state machine used to track load-balancing
load-balance operations.
show cable Displays real-time statistical and operational information for
load-balance load-balancing operations.
Cisco IOS CMTS Cable Command Reference
CBL-318 OL-15510-15
Cable Commands: cable l
cable load-balance group threshold (Supporting Dynamic Channel Change)
cable load-balance group threshold (Supporting Dynamic
Channel Change)
To set the threshold levels and corresponding service flow types for the specified Load Balancing group,
supporting Dynamic Channel Change (DCC) on the Cisco router, use the following command in global
configuration mode. To remove threshold settings, use the no form of this command.
cable load-balance group n threshold {load | pcmm | stability | ugs} {0-100}
cable load-balance group n threshold ugs <1-100>
cable load-balance group n threshold load <1-100> {minimum}
cable load-balance group n threshold load 75 {enforce}
Syntax Description n Specifies the number of the load balance group. In Cisco IOS Release
12.2(33)SCE3 and earlier, the valid range is from 1 to 80. In
Cisco IOS Release 12.2(33)SCE4 and later, the valid range is from 1 to 256.
load Interface load threshold settings
pcmm PCMM service flow threshold
stability Threshold for stability detection
ugs UGS service flow threshold
1-100 Interface utilization threshold in percentage of interface capacity.
load Interface load threshold settings
1-100 Threshold value in percentage
minimum Set minimum number of modems/flows difference before loadbalancing
starts
enforce Enters the enforce threshold
Command Default Load balancing is not configured by default on the Cisco CMTS.
Command Modes Global configuration mode.
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)SCE4 The valid range for the load balance group was changed.
Examples The following command specifies the reserved bandwidth threshold. Above this level, cable modems
with active PCMM service flows participate in load balancing, and the default threshold is 70%. Note
that if UGS is used for PCMM, the UGS threshold needs to be crossed as well. The default UGS
threshold is 70%)
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-319
Cable Commands: cable l
cable load-balance group threshold (Supporting Dynamic Channel Change)
Router(config)# cable load-balance group 4 threshold pcmm <pcmm-value>
Usage Guidelines In Cisco IOS releases prior to Cisco IOS Release 12.3(17a)BC, the load balancing default setting is
UGS. This is not the case with Cisco IOS Release 12.3(17a)BC. In this latter release, and subsequent
releases, configuration is required if the cable modems with active UGS flows are desired to participate
in load balancing.
This command is subject to the restrictions and prerequisites described in Configuring Load Balancing
and Dynamic Channel Change (DCC) on the Cisco CMTS.
Associated Features The cable load-balance group threshold command is used to configure the following feature:
• Load Balancing and Dynamic Channel Change on the Cisco CMTS Routers
Related Commands Command Description
cable load-balance group Sets multiple parameters for Load Balancing with DCC.
(Supporting Dynamic Channel
Change)
cable load-balance group Sets the initialization technique for Dynamic Channel Change
dcc-init-technique (Supporting (DCC) for Load Balancing.
Dynamic Channel Change)
cable load-balance group policy Sets the type of service flow for use with Load Balancing and
(Supporting Dynamic Channel DCC, whether PacketCable MultiMedia (PCMM) or
Change) Unsolicited Grant Service (UGS).
show controllers cable Displays statistics for Dynamic Channel Change (DCC) for
load balancing.
Cisco IOS CMTS Cable Command Reference
CBL-320 OL-15510-15
Cable Commands: cable l
cable load-balance modem max-failures
cable load-balance modem max-failures
To configure the number of times a CM can fail before the CM is removed from the dynamic load
balancing group, use the cable load-balance modem max-failures command in the global
configuration mode. To remove the configured number for a CM to fail, use the no form of this
command.
cable load-balance modem max-failures 0-100
no cable load-balance modem max-failures
Syntax Description 0-100 Specifies the maximum number of failures before a CM is removed from the
dynamic LB. However, if you give the value 0, the cable load-balance
modem max-failures command gets disabled.
Note The CM is excluded from the dynamic load balance operations after
it has failed the specified number of times, however it still belongs
to a LBG.
Command Default The default value is 10.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced.
Examples The following example shows how to configure CM using the cable load-balance modem max-failures
command.
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# cable load-balance modem max-failures 10
Router(config)#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-321
Cable Commands: cable l
cable load-balance restrict modem
cable load-balance restrict modem
To configure a list of cable modems statically provisioned at the CMTS, to a restricted load balancing
group (RLBG) or a service type ID, use the cable load-balance restrict modem command in the global
configuration mode. To remove the configured list of cable modems, use the no form of this command.
cable load-balance restrict modem index mac-addr [mac-mask] {docsis-group docsis-group-id |
service-type-id string}
no cable load-balance restrict modem index mac-addr [mac-mask] {docsis-group
docsis-group-id | service-type-id string}
Syntax Description index Assigns an index number ranging from 1 to 4294967295.
mac-addr Specifies the MAC address of the modem that is restricted.
mac-mask Specifies the MAC mask of the modem that is restricted.
docsis-group Restricts modems to a DOCSIS load balancing group.
docsis-group-id
service-type-id string Restricts modems to a service type ID.
Command Default No default behavior or values.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced.
Examples The following example shows how to assign a group of modems with a common MAC mask to a group
or a service type ID using the cable load-balance restrict modem command. To assign the modem to
a LBG, you can either specify the LBG ID or the service type ID.
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# cable load-balance restrict modem 1 001a.c30c.7eee FFFF.FFFF.0000
docsis-group 100
Router(config)#
Cisco IOS CMTS Cable Command Reference
CBL-322 OL-15510-15
Cable Commands: cable l
cable load-balance rule
cable load-balance rule
To create a rule that prevents cable modem (CM) from disabling or enabling load balancing, use the
cable load-balance rule command in cable global configuration mode. To remove a defined rule, a rule
from all policies, or the policy itself if it is the last rule of that policy, use the no form of this command.
cable load-balance rule rule-id {disable-period {dis-start start-time dis-period disable-period}
| disable-throughput-lowerbound {ds n | us n} | disabled | enabled | vdoc-enabled}
no cable load-balance rule rule-id
Syntax Description rule-id Specifies the rule to load balance CM.
disable-period Specifies the number of seconds to prevent CM from load balancing at a
given start time.
dis-start start-time Specifies the start time to disable CM from load balancing. The dis-start is
the start time ranging from 0 to 86400 seconds from midnight.
dis-period disable Specifies the period to disable CM from load balancing. The dis-period is the
period duration time ranging from 0 to 86400 seconds from midnight.
disable-throughput-lo Disables load balancing if CM throughput is lower than a threshold.
werbound
ds n | us n Specifies downstream or upstream channels throughput lowerbound in kbps,
ranging from 0 to 1000000.
disabled Disables the CM from load balancing.
enabled Enables load balancing on CM.
vdoc-enabled Enables the video over DOCSIS (VDOC) load balancing for static multicast
groups.
Command Default No default behavior or values for this command
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCB This command was introduced.
12.2(33)SCC The disable-throughput-lowerbound parameter was added in the
command.
12.2(33)SCD5 The vdoc-enabled parameter was added in the command.
Usage Guidelines The no form of this command supports the following actions:
• Remove a defined rule.
• Remove the rule from all policies.
• Remove the policy itself if it is the last rule of that policy.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-323
Cable Commands: cable l
cable load-balance rule
Note Static multicast groups must be configured on the specific bundle interface as well as on the correct
forwarding interfaces to enable the vdoc-enabled rule.
Examples The following example shows how to create a rule:
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# cable load-balance rule 1 disable-period dis-start 40 dis-period 50
Router(config)# cable load-balance rule 1 disable-throughput-lowerbound ds 2500
Router(config)# cable load-balance rule 1 disabled
Router(config)# cable load-balance rule 2 enabled
Router(config)# cable load-balance rule 1 vdoc-enabled
Router(config)#
Related Commands Command Description
cable load-balance Creates a DOCSIS policy and associates a new or existing rule with the
docsis-policy policy.
Cisco IOS CMTS Cable Command Reference
CBL-324 OL-15510-15
Cable Commands: cable l
cable logging badipsource
cable logging badipsource
To log error messages about bad IP source addresses on the cable interfaces to a separate log buffer, use
the cable logging badipsource command in global configuration mode. To turn off the logging function
and clear out the buffer, so that any error messages are logged to the console or current system log, use
the no form of this command.
cable logging badipsource [buffer-size]
no cable logging badipsource
Syntax Description buffer-size Specifies the total size of the buffer that will contain the logged error messages. The valid
range is 4096 to 1048576 bytes (4 KB to 1 MB), with a default value of 4096 bytes.
Note The maximum buffer size is limited by the amount of actual unused memory that
is available on the Cisco CMTS.
Command Default By default, error messages for bad IP source addresses are logged to the console or current system log.
The default logging buffer size is 4096 entries.
Command Modes Global configuration
Command History Release Modification
12.1(13)EC This command was introduced for the Cisco uBR7100 series and Cisco uBR7200 series
universal broadband routers.
12.2(11)CY Support was added for the Cisco uBR10012 universal broadband router.
12.2(11)BC2 Support was added to the Release 12.2 BC train for the Cisco uBR7100 series,
Cisco uBR7200 series, and Cisco uBR10012 routers.
12.2(15)BC1, The maximum buffer size was adjusted to 1 MB, which can contain approximately
12.2(15)CX 2000 error messages. Also, if the requested amount of memory is not available in a
contiguous block, the CMTS displays an error message and does not change the buffer
size.
Usage Guidelines The cable source-verify command enables service providers to verify that the IP addresses being used
on the cable interface have been properly assigned by the provider’s DHCP servers. When a bad IP
address is detected, the Cisco CMTS generates a BADIPSOURCE error message in the console logs.
In previous Cisco IOS releases, the Cisco CMTS generated these particular error messages for every IP
packet that contained a bad IP source address. This can create a large volume of error messages that can
make it difficult to see other error messages in the console logs.
To create a separate log for these error messages, use the cable logging badipsource command. You
can also specify the size of the buffer that will contain these error messages. When the buffer becomes
full, the oldest messages are deleted to make room for newer messages, so choose a buffer size that will
allow you to retain all messages until you can examine them.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-325
Cable Commands: cable l
cable logging badipsource
On the Cisco uBR10012 router, this command includes only the BADIPSOURCE error messages
generated by the PRE module. The cable interface line cards also generate their own error messages, but
because these error messages are typically duplicates of the ones generated by the PRE module, they are
not included in the separate log.
Tip If you find that the current buffer is too small to contain the current volume of error log messages, you
can issue this command again with a larger buffer size. However, doing so will automatically clear out
all messages currently in the buffer, so be certain that you have viewed all of the current messages before
giving a second cable logging badipsource command.
Note Be cautious when specifying the buffer size, because the Cisco CMTS could run out of memory for other
tasks. Use the show memory EXEC command to display the maximum available processor memory,
and set the buffer size for this command to a value well within that maximum value.
To display the contents of this error log, use the show cable logging command. To clear the buffer after
you have viewed the error messages, use the clear cable logging command. You can also use the service
timestamps log command to add a timestamp to the messages in the log.
To print the BADIPSOURCE messages to the console or syslog server, use the no cable logging
badipsource command (which is the default configuration). Note that this configuration does not turn
off the generation of BADIPSOURCE messages, but only configures the system for the default log
message behavior.
Tip If you do not want to see any BADIPSOURCE messages at all, use the cable logging badipsource 4096
command so that these messages go to a separate buffer with the smallest possible size. You will then
not see these error messages unless you explicitly use the show cable logging command to display them.
Examples The following example shows how to enable the logging of bad IP source address error messages, using
a buffer size of 524,288 bytes (512 KB):
Router# configure terminal
Router(config)# cable logging badipsource 524288
Router(config)#
Tip You must also use the cable source-verify command to enable verification of source IP addresses before
the buffer will contain any error messages about bad IP source addresses. If you do not use the cable
source-verify command, you can still use the cable logging badipsource command to create a buffer,
but the buffer will always remain empty.
The following example shows how to enlarge the current buffer for bad IP source address error messages
by giving the cable logging badipsource command a second time. Because this will empty out the
buffer of all current messages, be sure to display the current buffer contents before giving the command
a second time.
Router# configure terminal
Router(config)# cable logging badipsource 8192
Router(config)# exit
Router# show cable logging badipsource
<<buffer contents omitted>>
Cisco IOS CMTS Cable Command Reference
CBL-326 OL-15510-15
Cable Commands: cable l
cable logging badipsource
Router# configure terminal
Router(config)# cable logging badipsource 256000
The following example shows how to stop the logging of bad IP source address error messages to a
separate buffer. This clears out all error messages from the buffer and removes the buffer from memory,
and future error messages for bad IP source addresses are logged to the console or to the current system
log, if any.
Router# configure terminal
Router(config)# no cable logging badipsource
Router(config)#
Related Commands cable source-verify Enables verification of IP addresses for CMs and CPE devices on the upstream.
clear cable logging Removes all error messages about bad IP source addresses on the cable
interfaces from the error log buffer.
show cable logging Displays the log of error messages about bad IP source addresses on the cable
interfaces.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-327
Cable Commands: cable l
cable logging downstream-index
cable logging downstream-index
To enable logging for downstream indexes, use the cable logging downstream-index command in
global configuration mode. To turn off logging and clear the buffer, use the no form of this command.
cable logging downstream-index [buffer-size]
no cable logging downstream-index [buffer-size]
Syntax Description buffer-size Total size of the buffer that contains the logged downstream indexes. The
valid range is from 4096 to 4121440 bytes, with a default value of 4096
bytes.
Note The maximum buffer size is limited by the amount of actual unused
memory that is available on the Cisco CMTS.
Command Default By default, the downstream indexes are logged on the line card on which this configuration is enabled.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCG This command was introduced.
Usage Guidelines The cable logging downstream-index command is configured on the Cisco uBR-MC3GX60V or
Cisco UBR-MC20X20V cable line cards or on the line card that is configured to be the modular-host for
a SPA. The downstream index logging may be enabled on the cable line card that has the MAC domain.
Note This command is used to collect data only when requested by Cisco TAC.
Caution Be cautious when specifying the buffer size because the Cisco CMTS could run out of memory for other
tasks. Use the show memory EXEC command to display the maximum available processor memory, and
set the buffer size for this command to a value well within the maximum value.
To display the contents of the downstream index log, use the show cable logging downstream-index
command. To clear the buffer after you have viewed the log, use the clear cable logging
downstream-index command. You can also use the service timestamps log command to add a
timestamp to the messages in the log.
Cisco IOS CMTS Cable Command Reference
CBL-328 OL-15510-15
Cable Commands: cable l
cable logging downstream-index
Examples The following example shows how to enable downstream index logging:
Router> enable
Router# conf t
Router(config)# cable logging downstream-index 4096
Related Commands Command Description
clear cable logging Removes all downstream index log messages.
show cable logging Displays all downstream index log messages
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-329
Cable Commands: cable l
cable logging layer2events
cable logging layer2events
To save selected (low priority) DOCSIS events that are specified in CMTS MIB Registry to the cable
logging buffer (instead of to the general logging buffer), use the cable logging layer2events command
in global configuration mode. To disable the logging of DOCSIS events to the cable logging buffer, use
the no form of this command.
cable logging layer2events
no cable logging layer2events
Syntax Description This command has no additional arguments or keywords.
Command Default By default, the DOCSIS events are saved to the general logging buffer on the Cisco CMTS. The default
logging buffer size is 4096 entries.
Command Modes Global configuration mode
Command History Release Modification
12.3(9a)BC This command was introduced on the Cisco uBR10012 and Cisco uBR7246VXR
universal broadband routers.
Usage Guidelines Use the show cable logging command to check whether the logging feature is enabled and the status of
the logging buffer.
Examples The following example shows how to clear the log buffer that contains a bad IP source address error
messages:
Router# show cable logging summary
Cable logging: BADIPSOURCE Enabled
Total buffer size (bytes): 1000000
Used buffer size (bytes) : 36968
Logged messages : 231
Router# clear cable logging badipsource
Router# show cable logging summary
Cable logging: BADIPSOURCE Enabled
Total buffer size (bytes): 1000000
Used buffer size (bytes) : 0
Logged messages : 0
Cisco IOS CMTS Cable Command Reference
CBL-330 OL-15510-15
Cable Commands: cable l
cable logging layer2events
Related Commands Command Description
cable logging badipsource Logs error messages about bad IP source addresses on the cable
interfaces to a separate log buffer,
show cable logging Indicates whether the logging feature is enabled and the status of the
logging buffer.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-331
Cable Commands: cable l
cable logging layer2events
Cisco IOS CMTS Cable Command Reference
CBL-332 OL-15510-15
Cable Commands: cable m
Revised: July 2012, OL-15510-15
New Commands
Command Cisco IOS Software Release
cable modem service-class-name 12.3(23)BC2
cable multicast group-encryption 12.2(33)SCA
cable multicast group-qos 12.2(33)SCA
cable multicast qos group 12.2(33)SCA
cable multicast auth enable default-action 12.2(33)SCB
cable multicast auth profile-name 12.2(33)SCB
cable modulation-profile global-scheme 12.2(33)SCC
cable mrc-mode 12.2(33)SCC
cable mtc-mode 12.2(33)SCC
cable multicast group-qos default 12.2(33)SCC1
cable metering ipdr 12.2(33)SCD2
cable metering ipdr-d3 12.2(33)SCD2
cable multicast mdf-disable 12.2(33)SCD3
cable multicast source 12.2(33)SCE
Modified Commands
Command Cisco IOS Software Release
cable modem remote-query 12.3(23)BC
cable modem service-class-name 12.2(33)SCB
cable multicast auth profile-name 12.2(33)SCC
cable metering destination 12.2(33)SCD2
cable metering filesystem 12.2(33)SCD2
cable modem remote-query 12.2(33)SCD5
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-333
Cable Commands: cable m
Command Cisco IOS Software Release
cable monitor 12.2(33)SCE
cable multicast mdf-disable 12.2(33)SCE4
cable multicast mdf-disable 12.2(33)SCF2
cable metering ipdr 12.2(33)SCG
cable metering ipdr-d3 12.2(33)SCG
Cisco IOS CMTS Cable Command Reference
CBL-334 OL-15510-15
Cable Commands: cable m
cable map-advance
cable map-advance
To configure the dynamic map advance algorithm, use the cable map-advance command in cable
interface configuration mode. Use the no form of this command to disable this function.
cable map-advance [dynamic [safety] | static] [max-delay]
no cable map-advance
Syntax Description dynamic safety Enables the dynamic MAP advance algorithm that automatically tunes
lookahead time in MAPs based on the current farthest CM on a
particular upstream port. The safety argument specifies a safety factor
for the dynamic map advance algorithm in microseconds. This value
controls the amount of extra lookahead time in MAPs to account for
inaccuracies of the measurement system and internal software
latencies. The valid range is 300 to 1500 microseconds, with a default
of 1000.
Note Using larger safety factors increases the run time lookahead in
MAPs, but reduces the upstream performance.
static Enables the static map advance algorithm that uses a fixed lookahead
time value in MAPs based on the worst-case propagation delay of 100
mile HFC cable network.
max-delay Specifies the maximum round trip delay between the cable plant and
furthest CM in microseconds. The valid range is 100 to 2000
microseconds, with a default of 1800. The typical delay for a mile of
coaxial cable is approximately 7 microseconds. The typical delay for a
mile of fiber cable is approximately 8 microseconds.
Defaults Dynamic map advance with a safety factor of 1000 microseconds and a max-delay of 1800 microseconds
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.1T This command was introduced.
12.0 (9)SC, 12.1(2)EC1 The dynamic option was added.
12.1(10)EC The max-delay option was added. The dynamic MAP algorithm was also
enhanced so that it can quickly determine whether the furthest CM is now
offline, so that the MAP advance algorithm can be updated accordingly.
12.2(8)BC1 The range for the max-delay option was changed to the current values of
between 100 and 2000 microseconds.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-335
Cable Commands: cable m
cable map-advance
Usage Guidelines The max-delay option, which was introduced in Cisco IOS Release 12.1(10)EC, specifies the maximum
possible round-trip delay between the cable plant and furthest CM in the cable network. A CM will not
be allowed to exceed the maximum timing offset given by the max-delay value (in static mode) or given
by the combination of the max-delay and safety values (in dynamic mode). If a CM reports a timing
offset beyond the maximum value, the CMTS will reset its offset to the maximum value and put an
exclamation point (!) next to its offset value in the show cable modem display.
In dynamic MAP operation, Cisco IOS 12.1(10)EC also implements a regular polling of the furthest CM,
to determine if that CM is now offline. If the furthest CM has gone offline, the CMTS scans the currently
online CMs to determine which CM is now the furthest offline and updates the dynamic MAP advance
algorithm with the new value.
Examples The following example shows how to configure the dynamic map advance to 1500 microseconds:
router(config-if)# cable map-advance dynamic 1500
Related Commands show cable modem Displays statistics for the connected CMs.
Cisco IOS CMTS Cable Command Reference
CBL-336 OL-15510-15
Cable Commands: cable m
cable match address
cable match address
To specify that IP multicast streams be encrypted, use the cable match address command in cable
interface configuration mode. To specify that multicast streams should not be encrypted, use the no form
of this command.
cable match address access-list
no cable match address
Syntax Description access-list Specifies that the IP multicast streams defined by the access list be encrypted. Access lists
can be IP access list numbers or an IP access list name. Valid access list numbers are from
100 to 199.
Command Default No default behavior or values
Command Modes Interface configuration—cable interface only (config-if)
Command History Release Modification
12.1 T This command was introduced.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
Usage Guidelines The cable match address command binds an access-list to a cable interface, allowing multicast
encryption to be performed on traffic through that interface. To configure the access list, use the
ip access-list command.
Note This command is not available for cable subinterfaces.
For additional information on configuring for multicast operations, see the chapters on IP Multicast in
the Release 12.2 Cisco IOS IP Configuration Guide and in Volume 3 of the Cisco IOS IP Command
Reference.
Note This command is available only on images that support Baseline Privacy Interface (BPI) and Baseline
Privacy Interface Plus (BPI+) encryption.
Examples The following example shows how to specify that the multicast stream defined by the access list named
reno be encrypted on cable interface 3/0:
Router(config)# interface c3/0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-337
Cable Commands: cable m
cable match address
Router(config-if)# cable match address reno
The following example shows how to specify that the multicast stream defined by the access list number
102 be encrypted:
Router(config)# interface c3/0
Router(config-if)# cable match address 102
Related Commands Command Description
ip access-list Defines an IP access list by name.
Cisco IOS CMTS Cable Command Reference
CBL-338 OL-15510-15
Cable Commands: cable m
cable max-hosts
cable max-hosts
To specify the maximum number of hosts that can be attached to a subscriber's CM, use the cable
max-hosts command in cable interface configuration mode. Use the no form of this command to reset
the allowable number of hosts attached to a CM to the default value of 0 hosts.
cable max-hosts n
no cable max-hosts
Syntax Description n Specify the maximum number of hosts that can be attached to a CM on this interface. Valid range
is from 0 to 255 hosts. Default value is 0.
Command Default 0
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.0(4)XI This command was introduced.
12.0(6)SC, 12.1(2)EC1 Support was added on the Cisco IOS 12.0 SC and 12.1 EC release trains.
Usage Guidelines The Cisco CMTS uses three commands set the maximum number of hosts for a particular CM, for all
CMs on a particular cable interface, or for all CMs using the Cisco CMTS router:
• cable modem max-hosts—Sets the maximum number of hosts for a particular CM.
• cable max-hosts—Sets the maximum number of hosts for all CMs on a particular cable interface.
• cable modem max-cpe—Sets the maximum number of hosts for all CMs using the Cisco CMTS
router.
The more specific commands override the settings of the less specific commands. For example, if you
use the cable modem max-cpe command to set the maximum number of hosts to 2 for all CMs, you can
still use the cable modem max-hosts command to give a particular CM a larger maximum host value.
Note The CMTS assigns the MAX Host value to a cable modem at the time that the cable modem registers
with the CMTS. Changing any of the MAX Host commands affects only cable modems that register after
the change.
Tip For more information on how these commands interact to set the maximum CPE values, see the chapter
Maximum CPE or Host Parameters for the Cisco Cable Modem Termination System in the
Cisco CMTS Feature Guide, available on Cisco.com and the Documentation CD-ROM.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-339
Cable Commands: cable m
cable max-hosts
Examples The following example shows how to set the maximum hosts for CMs on this particular cable interface
to 15:
Router(config)# interface c6/0
Router(config-if)# cable max-hosts 15
Related Commands Command Description
cable modem access-group Specifies an access group for a CM.
cable modem change-frequency Changes the downstream frequency or upstream channel ID.
cable modem max-cpe Sets the maximum number of hosts for all CMs using the
Cisco CMTS router.
cable modem max-hosts Sets the maximum number of hosts for a particular CM.
show cable modem Displays CM configuration settings.
Cisco IOS CMTS Cable Command Reference
CBL-340 OL-15510-15
Cable Commands: cable m
cable metering data-per-session
cable metering data-per-session
To view the number of cable metering data flows per session for a cable modem termination system, use
the cable metering data-per-session command in the global configuration mode. To disable this
feature, use the no form of this command.
cable metering data-per-session data-per-session timer timer value
no cable metering data-per-session data-per-session timer timer value
Syntax Description data-per-session The number of data flows per session. The range is from 3 to 30. The default
is 5.
timer Displays the cable line card timer to wake up.
timer value The timer wake up interval value in milliseconds. The range is from 8 to 500.
The default is 100.
Command Default The cable metering data flow values will not be visible.
Command Modes Global configuration mode
Command History Release Modification
12.2(33)SCB1 This command was introduced.
12.3(23)BC7 This command was integrated into Cisco IOS Release 12.3(23)BC7.
Usage Guidelines The cable metering data-per-session command allows users to view the number of cable metering data
flows per session. The command limits or throttles the data collection between the cable line card and
the route processor.
Examples The following example displays the number of cable metering data flows per session:
Router#configure terminal
Router(config)#cable metering data-per-session 8 timer 100
Router#show run | inc metering
cable metering destination 2.7.36.88 6789 0 15 non-secure
cable metering data-per-session 8 timer 100
Related Commands Command Description
show cable Displays information about the most recent successful usage-based billing
metering-status operation.
cable metering Enables usage-based billing and to stream the billing records to an external
destination collection server,
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-341
Cable Commands: cable m
cable metering destination
cable metering destination
To enable usage-based billing and to stream the billing records to an external collection server, use the
cable metering destination command in global configuration mode. To disable usage-based billing, use
the no form of this command.
cable metering destination ip-address port [ip-address2 port2] retries minutes {non-secure |
secure} [cpe-list-suppress] [flow-aggregate] [full-records]
no cable metering
Syntax Description ip-address port Address and TCP port number for the billing application on the external
server:
• ip-address—IP address for the external collection server.
• port—TCP port number for the billing collection application on the
server. The valid range is from 0 to 65535, but the port should not be
one of the widely-used TCP port numbers (0 to 1024).
ip-address2 port2 (Optional) IP address and TCP port number for a billing application on a
secondary external server that is used if the primary server fails to respond:
• ip-address2—IP address for the secondary external server.
• port2—TCP port number for the billing collection application on the
secondary server. The valid range is from 0 to 65535, but the port
should not be one of the widely-used TCP port numbers (0 to 1024).
retries Number of retry attempts that the Cisco CMTS makes to establish a secure
connection with the external server before using the secondary server (if
configured) and sending an SNMP trap about the failure. The valid range
for n is from 0 to 5, with a default of 1 retry attempt.
minutes Frequency of the billing records streamed to the external server. The valid
range is 2 to 1440 minutes (24 hours), with no default.
Note We recommend a minimum interval of 30 minutes.
non-secure Specifies that the Cisco CMTS should use an unencrypted TCP connection
when connecting with the billing application on the external server.
secure Specifies that the Cisco CMTS should use a secure socket layer (SSL) TCP
connection when connecting with the billing application on the external
server.
Note This option is available only on the Cisco CMTS software images
that support Baseline Privacy Interface (BPI) encryption.
cpe-list-suppress (Optional) Eliminates the customer premises equipment (CPE) IP addresses
from the billing records to improve performance.
Note The default is for CPE addresses to be included in the billing record,
up to a maximum of five CPE IP addresses for each cable modem.
flow-aggregate (Optional) Combines all information for an individual cable modem into
one record. Separate counters are maintained for upstream and downstream
traffic, but those counters include all service flows in that direction.
full-records (Optional) Provides information about full service flow (active and idle)
records.
Cisco IOS CMTS Cable Command Reference
CBL-342 OL-15510-15
Cable Commands: cable m
cable metering destination
Command Default Usage-based billing is disabled, by default. When enabled, CPE IP addresses (a maximum of five per
cable modem) are included in the billing records by default.
Command Modes Global configuration (config)
Command History Release Modification
12.3(9a)BC This command was introduced.
Note In Cisco IOS Release 12.3(9a)BC, this command supports the
monitoring of all service flows for DOCSIS 1.0, DOCSIS 1.1,
and DOCSIS 2.0 cable modems:
• upstream and downstream
• primary
• secondary
• dynamic
12.2(33)SCD2 This command was modified to add the full-records keyword.
Note In Cisco IOS Release 12.2(33)SCD2 and later releases, this
command is also supported on DOCSIS 3.0 cable modems.
Usage Guidelines The cable metering destination command enables usage-based filling and configures it for streaming
mode, where the Cisco CMTS creates the billing records and regularly sends them to an external server
for use by the billing application.
The Cisco CMTS attempts to establish a connection with the first (primary) external server, and if this
fails, the CMTS sends an SNMP trap about the failure. The Cisco CMTS retries the connection for the
number of times specified in the cable metering destination command, and if all of those attempts fail,
the Cisco CMTS switches to the secondary external server, if configured. The Cisco CMTS repeats this
sequence at every interval, and always tries to connect to the primary server first before attempting to
use the secondary server.
Note You can enable usage-based billing using either the cable metering filesystem or cable metering
destination command, but not both. If you give these commands twice, the second command will
overwrite the first.
If the CMTS cannot transmit the billing record to the external server, and if metering traps have been
enabled using the snmp-server enable traps cable metering command, the CMTS sends an SNMP trap
to the SNMP manager describing the reason for the failure. Typically, the reason is either that a timeout
occurred with the external server, or that the billing record no longer exists on the local filesystem. An
SNMP trap is sent for each connection failure.
To disable usage-based billing, use the no cable metering command. This immediately stops the
collection of billing information, except when the billing records are currently being streamed to the
external server. If a billing operation is in progress when you give the no cable metering command, the
system displays the message “CMTS Metering in progress. Ignoring current config.” Wait until the
billing operation is finished and then reenter the no cable metering command.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-343
Cable Commands: cable m
cable metering destination
Note If the show cable metering-status command displays the status of a streaming operation as “success”
but the records were not received on the billing application server, verify that the Cisco CMTS and
server are configured for the same type of communications (non-secure TCP or secure SSL). If the
Cisco CMTS is configured for non-secure TCP and the server is configured for secure SSL, the
Cisco CMTS transmits the billing record successfully, but the server discards all of the data, because it
did not arrive in a secure SSL stream.
Examples The following example shows how to enable usage-based billing for streaming mode, with the CMTS
transmitting the billing records every 60 minutes to the server at the IP address of 10.10.10.37 and TCP
port of 5215, using a secure socket layer (SSL) TCP connection. A secondary external service is also
defined. The CMTS will retry the connection three times before giving up and switching to the
secondary server, as well as sending an SNMPv3 trap to notify the SNMP management system of the
failure:
U7246VXR# configure terminal
U7246VXR(config)# cable metering destination 10.10.10.37 5215 10.10.10.41 5215 3 60 secure
U7246VXR(config)#
The following example shows how to enable usage-based billing for streaming mode, with the CMTS
transmitting the billing records every 30 minutes to the server at the IP address of 10.10.10.37 and TCP
port of 8181, using an unencrypted TCP connection. No secondary server is defined. The CMTS will
retry the connection only once before giving up and sending an SNMPv3 trap to notify the SNMP
management system of the failure:
Router# configure terminal
Router(config)# cable metering destination 10.10.10.37 8181 1 30 non-secure
Router(config)#
The following example shows how to enable usage-based billing, using the same configuration as above,
except that the billing records do not include the IP addresses for the CPE devices:
Router# configure terminal
Router(config)# cable metering destination 10.10.10.37 8181 1 30 non-secure
cpe-list-suppress
Router(config)#
The following example shows how to enable usage-based billing, using an unencrypted TCP connection,
including the IP addresses for the CPE devices, and enabling the full-records option:
Router# configure terminal
Router(config)# cable metering destination 10.10.10.37 11 1 222 non-secure full-records
cpe-list-suppress
Router#
Related Commands Command Description
cable metering filesystem Enables usage-based billing and writes the billing records to a file
on a local file system.
cable metering ipdr Enables usage-based billing using the IPDR and SP2.1 protocol.
cable metering ipdr-d3 Enables usage-based billing on DOCSIS 3.0 cable modems.
cable metering Enables debugging of usage-based billing operations.
source-interface
Cisco IOS CMTS Cable Command Reference
CBL-344 OL-15510-15
Cable Commands: cable m
cable metering destination
show cable metering-status Displays information about the most recent usage-based billing
operation.
snmp-server enable traps cable Ensures that the Simple Network Management Protocol (SNMP)
traps are sent for cable-related events.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-345
Cable Commands: cable m
cable metering filesystem
cable metering filesystem
To enable usage-based billing and to write the records to a file on a local file system, use the cable
metering filesystem command in global configuration mode. To disable usage-based billing, use the no
form of this command.
cable metering filesystem filesystem [cpe-list-suppress] [flow-aggregate] [full-records]
no cable metering
Syntax Description filesystem File system where the billing record file is written. The filesys parameter
has a maximum length of 25 characters and must specify a valid file system
on the router (such as slot0, disk1, or flash).
Note The system will write the billing records to this file system using a
file name that contains the hostname of the router followed by a
timestamp when the record was written.
cpe-list-suppress (Optional) Eliminates the customer premises equipment (CPE) IP addresses
from the billing records to improve performance.
Note If this option is not selected, a maximum of five CPE IP addresses
are included in the billing record for each cable modem.
flow-aggregate (Optional) Combines all information for an individual cable modem into
one record. Separate counters are maintained for upstream and downstream
traffic, but those counters include all service flows in that direction.
full-records (Optional) Provides information about full service flow (active and idle)
records.
Command Default Usage-based billing is disabled, by default. When usage-based billing is enabled, CPE IP addresses (a
maximum of five) are included in the billing records by default.
Command Modes Global configuration (config)
Cisco IOS CMTS Cable Command Reference
CBL-346 OL-15510-15
Cable Commands: cable m
cable metering filesystem
Command History Release Modification
12.3(9a)BC This command was introduced.
Note In Cisco IOS Release 12.3(9a)BC, this command supports the
monitoring of all service flows for DOCSIS 1.0, 1.1, and 2.0
cable modems:
– upstream and downstream
– primary
– secondary
– dynamic
12.2(33)SCD2 This command was modified to add the full-records keyword.
Note In Cisco IOS Release 12.2(33)SCD2 and later releases, this
command is also supported on the DOCSIS 3.0 cable
modems.
Usage Guidelines The cable metering filesystem command enables usage-based filling and configures it for file mode,
where the CMTS writes the billing records to the local file system. The system writes the billing record
to the filesystem specified by this command, using a file name that consists of the router’s hostname
followed by a timestamp for when the file was created.
When the CMTS writes a billing record, it can also optionally send an SNMPv3 trap to notify the billing
application that a billing record is available for pickup. The billing application can then log into the
Cisco CMTS and use the File Transfer Protocol (FTP) or Secure Copy (SCP) to pick up the file.
Note You can enable usage-based billing using either the cable metering filesystem or cable metering
destination command, but not both. If you give these commands twice, the second command will
overwrite the first.
If the CMTS cannot write the billing record to the local filesystem, and if metering traps have been
enabled using the snmp-server enable traps cable metering command, the CMTS sends an SNMP trap
to the SNMP manager describing the reason for the failure. Typically, the reason is either that the disk
is full or that an disk error occurred (such as no PCMCIA card in the slot).
To disable usage-based billing, use the no cable metering command. This immediately stops the
collection of billing information, except when the billing records are currently being written to the local
file system. If a billing operation is in progress when you give the no cable metering command, the
system displays the message “CMTS Metering in progress. Ignoring current config.” Wait until the
billing operation is finished and then reenter the no cable metering command.
Examples The following example shows how to enable usage-based billing, writing the records to a file on the
disk0: device.
U7246VXR# configure terminal
U7246VXR(config)# cable metering filesystem disk0:
U7246VXR(config)#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-347
Cable Commands: cable m
cable metering filesystem
Note Do not use nvram as the file system. For example, do not use:
Router(config)# cable metering filesystem nvram:
The following example shows how to enable usage-based billing, writing the records to files on the disk2
device on an NPE-G1 processor:
Router# configure terminal
Router(config)# cable metering filesystem disk2:
Router(config)#
The following example shows how to enable usage-based billing, writing the records to files in Flash
Memory. The IP addresses for the CPE devices are not included in the billing records.
Router# configure terminal
Router(config)# cable metering filesystem flash: cpe-list-suppress
Router(config)#
The following example shows how to enable usage-based billing, writing the records to files in Flash
Memory, and enabling the full-records option:
Router# configure terminal
Router(config)# cable metering filesystem disk2:xyz full-records
Router#
Related Commands Command Description
cable metering destination Enables usage-based billing and streams the billing records to an
external server.
cable metering ipdr Enables usage-based billing using the IPDR and SP2.1 protocol.
cable metering ipdr-d3 Enables usage-based billing on DOCSIS 3.0 cable modems.
cable metering Enables debugging of usage-based billing operations.
source-interface
show cable metering-status Displays information about the most recent usage-based billing
operation.
snmp-server enable traps cable Enables the sending of Simple Network Management Protocol
(SNMP) traps for cable-related events.
Cisco IOS CMTS Cable Command Reference
CBL-348 OL-15510-15
Cable Commands: cable m
cable metering ipdr
cable metering ipdr
To configure the Subscriber Account Management Interface Specification (SAMIS) and to enable
usage-based billing on DOCSIS 2.0 cable modems, use the cable metering ipdr command in global
configuration mode. To disable usage-based billing, use the no form of this command.
cable metering ipdr interval session session-id [flow-aggregate] [full-records]
no cable metering
Syntax Description interval Metering data streaming interval in minutes. The valid range is from
2 to 1440 minutes (24 hours).
session session id IP Detail Records (IPDR) session ID. The valid session ID range is from
1 to 255.
flow-aggregate (Optional) Combines all information for an individual cable modem into
one record. Separate counters are maintained for upstream and downstream
traffic, but those counters include all service flows in that direction.
full-records (Optional) Provides information about full service flow (active and idle)
records.
Command Default Usage-based billing is disabled, by default.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCA This command was introduced.
Note In Cisco IOS Release 12.2(33)SCA, this command is
supported on DOCSIS 1.0, DOCSIS 1.1, and DOCSIS 2.0
cable modems.
12.2(33)SCD2 The command was modified to include the full-records keyword.
Note In Cisco IOS Release 12.2(33)SCD2 and later releases, this
command is also supported on DOCSIS 3.0 cable modems.
Usage Guidelines The cable metering ipdr command configures how SAMIS data is exported. This command is used for
DOCSIS 2.0 SAMIS schema.
When flow-aggregate is enabled, the service flows are combined into one record per cable modem:
• ServiceClassName element always returns a null value in IPDR records, even when service flows
on the cable modem have a valid service class name.
• ServiceIdentifier element always returns a zero value.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-349
Cable Commands: cable m
cable metering ipdr
Examples The following example shows how to enable usage-based billing for IPDR, with the billing record
interval set to every 60 minutes with full-records and flow-aggregate options enabled:
Router# configure terminal
Router(config)# cable metering ipdr 60 session 111 full-records flow-aggregate
Router(config)#
Related Commands Command Description
cable metering destination Enables usage-based billing, and streams the billing records to an
external server.
cable metering filesystem Enables usage-based billing and writes the billing records to a file
on a local file system.
cable metering Enables debugging of usage-based billing operations.
source-interface
show cable metering-status Displays information about the most recent usage-based billing
operation.
snmp-server enable traps cable Ensure that the Simple Network Management Protocol (SNMP)
traps are sent for cable-related events.
Cisco IOS CMTS Cable Command Reference
CBL-350 OL-15510-15
Cable Commands: cable m
cable metering ipdr-d3
cable metering ipdr-d3
To configure the Subscriber Account Management Interface Specification (SAMIS) and to enable
usage-based billing on DOCSIS 3.0 cable modems, use the cable metering ipdr-d3 command in global
configuration mode. To disable usage-based billing, use the no form of this command.
cable metering ipdr-d3 session session-id type type [flow-aggregate] [full-records]
no cable metering
Syntax Description session session id Specifies the IPDR session ID. The valid session ID range is from 1 to 255.
type type Specifies the IPDR DOCSIS 3.0 service definition type of metering. The
valid type range is from 1 to 2.
flow-aggregate (Optional) Combines all information for an individual cable modem into
one record. Separate counters are maintained for upstream and downstream
traffic, but those counters include all service flows in that direction.
full-records (Optional) Provides information about full service flow (active and idle)
records.
Command Default Usage-based billing is disabled, by default.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCD2 This command was introduced.
Usage Guidelines The cable metering ipdr-d3 command configures how the SAMIS data is exported. This command is
used for DOCSIS 3.0 SAMIS schema (including type 1 and type 2).
When flow-aggregate is enabled, the service flows are combined into one record per cable modem:
• ServiceClassName element always returns a null value in IPDR records, even when service flows
on the cable modem have a valid service class name.
• ServiceIdentifier element always returns a zero value.
Examples The following example shows how to enable usage-based billing for IPDR DOCSIS 3.0, with
full-records and flow-aggregate options enabled:
Router# configure terminal
Router(config)# cable metering ipdr-d3 session 111 type 2 full-records flow-aggregate
Router(config)#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-351
Cable Commands: cable m
cable metering ipdr-d3
Related Commands Command Description
cable metering destination Enables usage-based billing, and streams the billing records to an
external server.
cable metering filesystem Enables usage-based billing and writes the billing records to a file
on a local file system.
cable metering Enables debugging of usage-based billing operations.
source-interface
cable sflog max-entry Enables service flow logging and configuring the number and
duration of entries in the log.
show cable metering-status Displays information about the most recent usage-based billing
operation.
snmp-server enable traps cable Ensures that Simple Network Management Protocol (SNMP) traps
metering are sent for cable-related events.
Cisco IOS CMTS Cable Command Reference
CBL-352 OL-15510-15
Cable Commands: cable m
cable metering source-interface
cable metering source-interface
To enables specification of the source-interface for the billing packets, use the cable metering
source-interface command in privileged EXEC mode. To turn off the specified source-interface, use the
no form of this command.
cable metering source-interface interface
no cable metering source-interface interface
Syntax Description interface Specifies the source of the usage based billing packets originated by the
router using the cable metering source-interface command. This is often
used to set the source-interface as the ip address of the loopback interface.
Command Default Usage billing is disabled. When enabled, CPE IP addresses (a maximum of five per cable modem) are
included in the billing records by default.
Command Modes Global configuration
Command History Release Modification
12.3(21)BC This command was introduced.
Usage Guidelines The cable metering source-interface command enables the user to specify the source-interface of the
usage based billing packets. All billing packets are usually automatically assigned a source-interface,
but users using the cable metering source-interface command can set the source-interface to be the ip
address of the loopback interface.
If the user does not specify the source-interface configuration, SAMIS will pick the highest IP address
of the loopback interface as the source interface. If the loopback interface is not there, then SAMIS will
select the highest IP of the physical interface for source interface.
Refer the DDTS for more info CSCek39658.
Note If a loopback interface is specified, the mac address would be that of the management interface in the
docID in the billing packet.
Note The option of specifying the source-interface for metering is available only after the metering mode is
configured.
If the cable metering source-interface command is used when the Cable ARP Filtering feature is
operating in the File Mode, the CMTS IP address in the billing packets will be changed to the ip address
of the source-interface as specified through cable metering source-interface command or through
setting the ccmtrCollectionSrcIfIndex object. The mac address in the billing packets' header will also
be changed to the mac address of the source-interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-353
Cable Commands: cable m
cable metering source-interface
If the cable metering source-interface command is used when the Cable ARP Filtering feature is
operating in the Streaming Mode, the CMTS IP address in the billing packets, as well as the source IP
address of the billing packets, will be changed to the ip address of the source-interface as specified
through cable metering source-interface command or through setting the ccmtrCollectionSrcIfIndex
object. The mac address in the billing packets' header will also be changed to the mac address of the
source-interface.
When defining the source-interface, the following possible error checks can be performed to determine
if the source-interface that the user has defined is a valid source-interface for metering:
1. Verify that the interface specified is up and has an ip address.
2. Verify that the ip address is in the same subnet/majornet as that of the destination address.
Note Even after performing these error checks, there are no guarantees that the billing packets will be sent out
since the TCP connection may not succeed due to the absence of a physical connection between the
CMTS and the collection server.
Examples The following is an example where the source-interface specified was a loopback interface and it had a
mac-address of 000C31F6F400 and an ip address of 1.100.100.100.
Router# configure terminal
Router(config)# cable metering source-interface loopback 1.100.100.100
<?xmlversion="1.0"encoding="UTF8"?><IPDRDocxmlns="http://www.ipdr.org/namespaces/ipdr"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="DOCSIS-3.5-A.0.xsd" docId="C7B1B20E-0000-0000-0000-000C31F6F400"
creationTime="2006-03-02T18:03:58Z" IPDRRecorderInfo="VXR3" version="3.5-A.0"><IPDR
xsi:type="DOCSIS-Type"><IPDRcreationTime>2006-03-02T18:03:58Z</IPDRcreationTime><CMTShostn
ame>VXR3</CMTShostname><CMTSipAddress>1.100.100.100</CMTSipAddress><CMTSsysUpTime>185867
</CMTSsysUpTime><CMTScatvIfName>Cable4/0</CMTScatvIfName><CMTScatvIfIndex>16</CMTScatvIfIn
dex><CMTSupIfName>Ca4/0-upstream0</CMTSupIfName><CMTSupIfType>129</CMTSupIfType><CMTSdownI
fName>Ca4/0-downstream</CMTSdownIfName><CMmacAddress>00-07-0E-07-0B-0D</CMmacAddress><CMip
Address>11.11.0.2</CMipAddress><CMdocsisMode>1.0</CMdocsisMode><Rectype>1</Rectype><servic
eIdentifier>0</serviceIdentifier><serviceClassName></serviceClassName><serviceDirection>1<
/serviceDirection><serviceOctetsPassed>6225</serviceOctetsPassed><servicePktsPassed>21</se
rvicePktsPassed><serviceSlaDropPkts>0</serviceSlaDropPkts><serviceSlaDelayPkts>1</serviceS
laDelayPkts><serviceTimeCreated>0</serviceTimeCreated><serviceTimeActive>0</serviceTimeAct
ive></IPDR><IPDR
xsi:type="DOCSIS-Type"><IPDRcreationTime>2006-03-02T18:03:58Z</IPDRcreationTime><CMTShostn
ame>VXR3</CMTShostname><CMTSipAddress>1.100.100.100</CMTSipAddress><CMTSsysUpTime>185867
</CMTSsysUpTime><CMTScatvIfName>Cable4/0</CMTScatvIfName><CMTScatvIfIndex>16</CMTScatvIfIn
dex><CMTSupIfName>Ca4/0-upstream0</CMTSupIfName><CMTSupIfType>129</CMTSupIfType><CMTSdownI
fName>Ca4/0-downstream</CMTSdownIfName><CMmacAddress>00-07-0E-07-0B-0D</CMmacAddress><CMip
Address>11.11.0.2</CMipAddress><CMdocsisMode>1.0</CMdocsisMode><Rectype>1</Rectype><servic
eIdentifier>0</serviceIdentifier><serviceClassName></serviceClassName><serviceDirection>2<
/serviceDirection><serviceOctetsPassed>12300</serviceOctetsPassed><servicePktsPassed>29</s
ervicePktsPassed><serviceSlaDropPkts>0</serviceSlaDropPkts><serviceSlaDelayPkts>13</servic
eSlaDelayPkts><serviceTimeCreated>0</serviceTimeCreated><serviceTimeActive>0</serviceTimeA
ctive></IPDR><IPDRDoc.End count="2" endTime="2006-03-02T18:03:59Z"/></IPDRDoc>
Router(config)#
The following is an example where the source-interface specified was a loopback interface and it had a
mac-address of 00027D67DC0 and an ip address of 2.90.100.100.
Router# configure terminal
Router(config)# cable metering source-interface loopback 2.90.100.10
Accept 2.90.100.100:42380
Cisco IOS CMTS Cable Command Reference
CBL-354 OL-15510-15
Cable Commands: cable m
cable metering source-interface
<?xmlversion="1.0"encoding="UTF8"?><IPDRDocxmlns="http://www.ipdr.org/namespaces/ipdr"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="DOCSIS-3.5-A.0.xsd" docId="C7B701D1-0000-0000-0000-00027D67DC00"
creationTime="2006-03-06T18:45:37Z" IPDRRecorderInfo="ubr7246-R7427"
version="3.5-A.0"><IPDR
xsi:type="DOCSIS-Type"><IPDRcreationTime>2006-03-06T18:45:37Z</IPDRcreationTime><CMTShostn
ame>ubr7246-R7427</CMTShostname><CMTSipAddress>2.90.100.100</CMTSipAddress><CMTSsysUpTime>
372172
</CMTSsysUpTime><CMTScatvIfName>Cable3/0</CMTScatvIfName><CMTScatvIfIndex>5</CMTScatvIfInd
ex><CMTSupIfName>Ca3/0-upstream0</CMTSupIfName><CMTSupIfType>129</CMTSupIfType><CMTSdownIf
Name>Ca3/0-downstream</CMTSdownIfName><CMmacAddress>00-50-04-F9-EF-88</CMmacAddress><CMipA
ddress>11.40.1.2</CMipAddress><CMdocsisMode>1.0</CMdocsisMode><Rectype>1</Rectype><service
Identifier>3</serviceIdentifier><serviceClassName></serviceClassName><serviceDirection>2</
serviceDirection><serviceOctetsPassed>228392</serviceOctetsPassed><servicePktsPassed>2216<
/servicePktsPassed><serviceSlaDropPkts>0</serviceSlaDropPkts><serviceSlaDelayPkts>0</servi
ceSlaDelayPkts><serviceTimeCreated>6500</serviceTimeCreated><serviceTimeActive>3648</servi
ceTimeActive></IPDR><IPDR
xsi:type="DOCSIS-Type"><IPDRcreationTime>2006-03-06T18:45:37Z</IPDRcreationTime><CMTShostn
ame>ubr7246-R7427</CMTShostname><CMTSipAddress>2.90.100.100</CMTSipAddress><CMTSsysUpTime>
372172
</CMTSsysUpTime><CMTScatvIfName>Cable3/0</CMTScatvIfName><CMTScatvIfIndex>5</CMTScatvIfInd
ex><CMTSupIfName>Ca3/0-upstream0</CMTSupIfName><CMTSupIfType>129</CMTSupIfType><CMTSdownIf
Name>Ca3/0-downstream</CMTSdownIfName><CMmacAddress>00-50-04-F9-EF-88</CMmacAddress><CMipA
ddress>11.40.1.2</CMipAddress><CMdocsisMode>1.0</CMdocsisMode><Rectype>1</Rectype><service
Identifier>4</serviceIdentifier><serviceClassName></serviceClassName><serviceDirection>1</
serviceDirection><serviceOctetsPassed>200134</serviceOctetsPassed><servicePktsPassed>2197<
/servicePktsPassed><serviceSlaDropPkts>0</serviceSlaDropPkts><serviceSlaDelayPkts>0</servi
ceSlaDelayPkts><serviceTimeCreated>6500</serviceTimeCreated><serviceTimeActive>3648</servi
ceTimeActive></IPDR><IPDRDoc.End count="2" endTime="2006-03-06T18:45:37Z"/></IPDRDoc>
Closing socket 2.90.100.100:42380
Router(config)#
Related Commands Command Description
cable metering Enables usage-based billing and streams the billing records to an
source-interface external server.
cable metering filesystem Enables usage-based billing and writes the billing records to a file
on a local file system.
debug cable remote-query Turns on debugging to gather information from remote CMs.
show cable metering-status Displays information about the most recent usage-based billing
operation.
snmp-server enable traps cable Enables the sending of Simple Network Management Protocol
(SNMP) traps for cable-related events.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-355
Cable Commands: cable m
cable modem access-group
cable modem access-group
To configure the access-group for a CM, use the cable modem access-group command in privileged
EXEC mode. To disable the specification, use the no access-group form of this command.
cable modem {mac-addr | ip-addr} access-group [access-list | access-name]
cable modem {mac-addr | ip-addr} no access-group
Note The cable modem access-group command is not supported on the Cisco uBR10012 universal
broadband router.
Syntax Description ip-addr Specifies the IP address for the CM.
mac-address Specifies the MAC address for the CM.
access-list Specifies the IP access list (standard or extended). Valid values are 1 to 199.
access-name Specifies the access-list name.
Command Default No default behaviors or values
Command Modes Privileged EXEC
Command History Release Modification
11.3(8) NA This command was introduced.
12.2(4)BC1 The functionality of this command was made identical to that of the cable host
access-group command, but both commands were retained for backwards compatibility.
Examples The following example shows the cable modem access-group command assigning access-list 1 to the
CM with the MAC address of abcd.ef01.2345:
Router# cable modem abcd.ef01.2345 access-group 1
Router#
Related Commands Command Description
cable host access-group Configures the access list for a host.
cable modem change-frequency Changes the downstream frequency or upstream channel ID.
cable modem max-hosts Specifies the maximum hosts for a CM.
cable modem qos profile Specifies the QoS profile for a CM.
show cable modem Displays CM configuration settings.
Cisco IOS CMTS Cable Command Reference
CBL-356 OL-15510-15
Cable Commands: cable m
cable modem change-frequency
cable modem change-frequency
To override the frequency used by a CM, use the cable modem change-frequency command in
privileged EXEC mode.
cable modem {mac-addr | ip-addr} change-frequency
{ds-frequency-hz [us-channel-id] | us-channel-id}
Syntax Description ip-addr Specifies the IP address for the CM.
mac-address Specifies the MAC address for the CM.
ds-frequency-hz Specifies the downstream frequency for the CM (in Hertz).
us-channel-id Specifies the upstream channel ID.
Command Default No default behavior or values
Command Modes Privileged EXEC
Command History Release Modification
12.0(4)XI This command was introduced.
Usage Guidelines This command allows the CMTS administrator to change the downstream frequency for a CM,
overriding the DOCSIS configuration file setting. This command is not applicable on Cisco IOS
Release 12.1(3a)EC.
Examples The following example shows how to change the downstream frequency of the CM having IP address
172.172.172.12 to 570 MHz:
Router# cable modem 172.172.172.12 change-freq 57000000
Router#
Related Commands Command Description
cable modem access-group Specifies an access group for a CM.
cable modem max-hosts Specifies the maximum hosts for a CM.
cable modem qos profile Specifies the QoS profile for a CM.
show cable modem Displays CM configuration settings.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-357
Cable Commands: cable m
cable modem max-cpe
cable modem max-cpe
To specify a maximum number of permitted hosts per modem (overriding the max-cpe value in the CM
configuration file), use the cable modem max-cpe command in global configuration mode.
cable modem max-cpe [n | unlimited]
Syntax Description n Specifies the configuration file value. Valid range is 1 to 255.
unlimited Specifies the maximum CPE value to be unlimited.
Command Default The max-cpe value provided in the configuration file will be used by the CMTS to limit the number of
hosts connected to a single CM (no cable modem max-cpe).
Command Modes Global configuration
Command History Release Modification
12.0(10)SC, 12.1(2)EC This command was introduced.
Examples The following example shows how to override the max-cpe setting in a CM configuration file:
Router(config)# cable modem max-cpe unlimited
Usage Guidelines The CMTS enables up to n number of hosts for a modem.When set to unlimited, or n is larger than the
max-cpe value in the configuration file of a CM, this command overrides the configuration file value.
Note When setting to unlimited or n is greater than the max-cpe value in the configuration file of a CM, the
CM has to control the maximum number of hosts, and the DHCP server has to control the number of IP
addresses assigned to hosts behind a single CM.
Caution Use of this command might open a security hole in the system by enabling denial of service attacks.
Specifically, it might enable a user to obtain a large number of IP addresses, thereby taking down the
entire network, after all the available IP addresses have been reserved by this single user.
Cisco recommends that, if this command is enabled, the number of IP addresses assigned to hosts behind
a single modem be strictly controlled by the DHCP server.
The Cisco CMTS uses three commands set the maximum number of hosts for a particular CM, for all
CMs on a particular cable interface, or for all CMs using the Cisco CMTS router:
• cable modem max-hosts—Sets the maximum number of hosts for a particular CM.
• cable max-hosts—Sets the maximum number of hosts for all CMs on a particular cable interface.
Cisco IOS CMTS Cable Command Reference
CBL-358 OL-15510-15
Cable Commands: cable m
cable modem max-cpe
• cable modem max-cpe—Sets the maximum number of hosts for all CMs using the Cisco CMTS
router.
The more specific commands override the settings of the less specific commands. For example, if you
use the cable modem max-cpe command to set the maximum number of hosts to 2 for all CMs, you can
still use the cable modem max-hosts command to give a particular CM a larger maximum host value.
Note The CMTS assigns the MAX Host value to a cable modem at the time that the cable modem registers
with the CMTS. Changing any of the MAX Host commands affects only cable modems that register after
the change.
Tip For more information on how these commands interact to set the maximum CPE values, see the chapter
Maximum CPE or Host Parameters for the Cisco Cable Modem Termination System in the
Cisco CMTS Feature Guide, available on Cisco.com and the Documentation CD-ROM.
Note The “Number of CPES” field in the show cable modem command shows the maximum CPE value for
the CM, not the value for the CMTS that is set by the cable modem max-cpe command.
Related Commands Command Description
cable max-hosts Sets the maximum number of hosts for all CMs on a particular cable
interface.
cable modem access-group Specifies an access group for a CM.
cable modem change-frequency Changes the downstream frequency or upstream channel ID.
cable modem max-hosts Sets the maximum number of hosts for a particular CM.
cable modem qos profile Specifies the QoS profile for a CM.
show cable modem Displays CM configuration settings.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-359
Cable Commands: cable m
cable modem max-hosts
cable modem max-hosts
To specify the maximum number of customer premises equipment (CPE) devices (hosts) that can be
supported by a specific CM, use the cable modem max-hosts command in privileged EXEC mode.
cable modem {mac-addr | ip-addr} max-hosts {n | default}
Syntax Description ip-addr Specifies the IP address for the CM.
mac-address Specifies the MAC address for the CM.
max-hosts {n | default} Specifies either the maximum number of hosts supported by the CM (from 0
to 255), or specifies the default value of 0.
Command Default 0
Command Modes Privileged EXEC
Command History Release Modification
12.0(4)XI This command was introduced.
Usage Guidelines The Cisco CMTS uses three commands set the maximum number of hosts for a particular CM, for all
CMs on a particular cable interface, or for all CMs using the Cisco CMTS router:
• cable modem max-hosts—Sets the maximum number of hosts for a particular CM.
• cable max-hosts—Sets the maximum number of hosts for all CMs on a particular cable interface.
• cable modem max-cpe—Sets the maximum number of hosts for all CMs using the Cisco CMTS
router.
The more specific commands override the settings of the less specific commands. For example, if you
use the cable modem max-cpe command to set the maximum number of hosts to 2 for all CMs, you can
still use the cable modem max-hosts command to give a particular CM a larger maximum host value.
Note The CMTS assigns the MAX Host value to a cable modem at the time that the cable modem registers
with the CMTS. Changing any of the MAX Host commands affects only cable modems that register after
the change.
Tip For more information on how these commands interact to set the maximum CPE values, see the chapter
Maximum CPE or Host Parameters for the Cisco Cable Modem Termination System in the
Cisco CMTS Feature Guide, available on Cisco.com and the Documentation CD-ROM.
Cisco IOS CMTS Cable Command Reference
CBL-360 OL-15510-15
Cable Commands: cable m
cable modem max-hosts
Examples The following example shows sets the CM with the IP address of 172.172.172.12 to a maximum of 40
attached CPE devices:
Router# cable modem 172.172.172.12 max-hosts 40
Related Commands Command Description
cable modem access-group Specifies an access group for a CM.
cable modem Changes the downstream frequency or upstream channel ID.
change-frequency
cable max-hosts Sets the maximum number of hosts for all CMs on a particular cable
interface.
cable modem max-cpe Sets the maximum number of hosts for all CMs using the
Cisco CMTS router.
cable modem qos profile Specifies the QoS profile for a CM.
show cable modem Displays CM configuration settings.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-361
Cable Commands: cable m
cable modem qos profile
cable modem qos profile
To force a DOCSIS 1.0 CM to use a specific quality-of-service (QoS) profile, use the cable modem qos
profile command in global configuration mode.
cable modem {mac-addr | ip-addr} qos profile qos-profile-index [no-persistence]
Syntax Description ip-addr Specifies the IP address for the CM.
mac-address Specifies the MAC address for the CM.
qos-profile-index Specifies QoS profile index values. The valid range is 1 to 255, with no default. In
Cisco IOS Release 12.2(15)BC1 and later releases, this profile must be created on
the Cisco CMTS using the cable qos profile command. In addition, this profile
should specify a maximum upstream bandwidth equal to or less than the current
bandwidth. If the new profile specifies a higher bandwidth, it is ignored, and the
cable modem continues to use the bandwidth that was specified at registration time.
no-persistence (Optional) Specifies that the QoS profile should not remain in force when a cable
modem reboots. Instead, when a cable modem reboots, it uses the QoS profile
specified in its DOCSIS configuration file.
The default is without this option, so that the QoS profile remains in force for cable
modems across reboots.
Command Default No default behaviors or values
Command Modes Global configuration
Command History Release Modification
12.0(4)XI This command was introduced.
12.1(11)EC This command was supported on Cisco IOS Release 12.1 EC.
12.2(8)BC1 This command was enhanced to allow a DOCSIS 1.1 CMTS to temporarily change the
QoS profile for DOCSIS 1.0 and 1.0+ CMs.
12.2(15)BC1 This command was changed so that it does not have any effect unless both the QoS
profile specified by this command and the QoS profile specified for the CM in its
DOCSIS configuration file are already created on the Cisco CMTS. This restriction did
not exist in previous releases.
12.2(15)BC2 The no-persistence option was added. Also, the restriction on changing CM-created
profiles that was implemented in Cisco IOS Release 12.2(15)BC1 was removed, so that
this command can again be used to change the profile of a CM that is using a
CM-created profile, as was the case in earlier releases.
Usage Guidelines On a Cisco CMTS running DOCSIS 1.0 software, the cable modem qos profile command forces a CM
to use a specific QoS profile.
Cisco IOS CMTS Cable Command Reference
CBL-362 OL-15510-15
Cable Commands: cable m
cable modem qos profile
On a Cisco CMTS running DOCSIS 1.1 software, the cable modem qos profile command temporarily
forces a DOCSIS 1.0 or DOCSIS 1.0+ CM to use a specific QoS profile, without forcing the CM to first
go off-line and re-register. For DOCSIS 1.0+ CMs, this command affects only the primary SID on the
CM.
Note In Cisco IOS Release 12.2(15)BC1, this command has an effect only when the profile that it specifies
and the original QoS profile on the CM have been created already on the Cisco CMTS, using the cable
qos profile command. In Cisco IOS Release 12.2(15)BC2 and later releases, this restriction is removed
and this command can also be used to change the profile for a CM even when it is using a CM-created
QoS profile.
This command does not affect DOCSIS 1.1 CMs, which support dynamic service change messages that
allow the QoS profile to be changed dynamically.
Note This command acts as a toggle. Give the cable modem qos profile command once to enforce a QoS
profile. Give the same command again with the same parameters to cancel the enforcement of that profile
(the CM will return to using its registered profile.)
When the no-persistence option is specified, the QoS profile is not applied when a cable modem reboots.
Instead, the Cisco CMTS allows the cable modem to use the QoS profile that is specified in its DOCSIS
configuration file.
The no-persistence option can be used when initially when identifying potential problem applications
and users. When repeat offenders are identified, the service provider can remove the no-persistence
option, so that these users continue to use the specified QoS profile even if they reboot their cable
modems.
Examples The following example shows how to specify a QoS profile index to a CM:
Router# cable modem qos profile 255
Router#
Related Commands Command Description
cable modem access-group Specifies an access group for a CM.
cable modem change-frequency Changes the downstream frequency or upstream channel ID.
cable modem max-hosts Specifies the maximum hosts for a CM.
show cable modem Displays CM configuration settings.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-363
Cable Commands: cable m
cable modem remote-query
cable modem remote-query
To enable and configure the remote query feature to gather cable modem performance statistics on the
Cisco CMTS router, use the cable modem remote-query command in global configuration mode. To
disable the gathering of cable modem statistics, use the no form of this command.
cable modem remote-query [polling-interval community-string] [src-ip ip-address]
no cable modem remote-query [src-ip ip-address]
Syntax Description polling-interval (Optional) The delay between each poll that the Cisco CMTS router makes to
collect cable modem statistics. When the Cisco CMTS router completes one remote
query poll, the router waits this time period before beginning another poll. The
valid range is from 1 to 86,400 seconds, with a recommended default value of
30 seconds.
community-string (Optional) The Simple Network Management Protocol (SNMP) community string.
Note If resetting a configured SNMP community string value, first disable the
remote query feature with the no form of this command, then set the new
community string using the cable modem remote-query command when
the polling delays is timed out.
src-ip ip-address (Optional) Specifies the source IP address for SNMP requests.
Note You should enable the remote query feature before configuring src-ip
option.
Command Default None
Command Modes Global configuration (config)
Command History Release Modification
12.0(7)XR, 12.1(2)T This command was introduced.
12.1(2)EC1 Support for this command was added to the 12.1 EC train.
Note This command is not supported on Cisco IOS
Release 12.1(3a)EC1 but is supported on Cisco IOS Release
12.1(4)EC and later 12.1 EC releases.
12.2(4)BC1b Support for this command was added to the 12.2 BC train.
12.2(15)BC1, 12.2(15)CX The sysDescr field is now obtained for each cable modem when the remote
query feature is enabled. (This value can be displayed using the verbose
option of the show cable modem command.
12.3(23)BC Support for the scr-ip option was added to this release.
Cisco IOS CMTS Cable Command Reference
CBL-364 OL-15510-15
Cable Commands: cable m
cable modem remote-query
Usage Guidelines To use the remote query feature, you must configure the cable modem and Cisco CMTS as follows:
• Configure a read-only SNMP community string on the cable modem for use with the remote query
feature. This should be a separate community string from the read-write string used to remotely
monitor and configure the cable modem.
• Configure a matching community string on the Cisco CMTS using the snmp-server community
community-string and snmp-server manager commands.
• Enable the remote query feature on the Cisco CMTS with the cable modem remote-query
command. The polling-interval should be chosen so that the statistics can be obtained in a timely
manner without seriously impacting system performance. Cisco recommends initially setting the
polling-interval to 30 seconds and adjusting that time period as needed.
Note If the remote query feature is enabled, the Cisco CMTS router consumes extra memory per cable modem
and takes additional CPU time. We recommend that you do not configure this feature on routers that have
lower free memory or a large number of cable modems.
The polling-interval time period determines only how long the Cisco CMTS router waits after
completing one polling cycle before beginning a new polling cycle. It does not indicate how long the
router spends in each polling cycle, which depends on the number of cable modems being polled. To
calculate the approximate time for a polling cycle, assume 4 to 5 CMs per second (100 to 200
milliseconds per CM). Also take into account the possibility that one or more cable modems might not
respond, with an approximate timeout period of 90 seconds.
You must specify matching community strings for the cable modem, the snmp-server community
community-string command, and the cable modem remote-query command.
You can reissue the cable modem remote-query command to change the polling interval at any time,
and the change becomes effective immediately. However, to change the SNMP community string, you
must first disable remote polling with the no snmp manager and no cable modem remote-query
commands. Then reconfigure the new community string with the snmp-server community
community-string, snmp-server manager, and cable modem remote-query commands.
You must configure the remote query feature before configuring the scr-ip option.
Tip After enabling the remote query feature, you can display the collected statistics with the show cable
modem remote-query command. You can also display these statistics by querying the attributes in the
CISCO-DOCS-REMOTE-QUERY-MIB MIB.
Resetting the Community String for Cable Modem Remote Query
In Cisco IOS Release 12.3BC and later releases, if you wish to reconfigure the SNMP community string
for the cable modem remote query feature, perform these brief steps.
1. Disable the remote query feature with the no form of this command.
2. Reset the timers on the Cisco CMTS router with short timeout values for the polling interval, so that
timeout commences quickly. Use the cable modem remote-query command in privileged EXEC
mode, using a very low value for the polling interval value.
3. Once time-outs are applied, reset the community string value with the cable modem remote-query
command.
4. Change the polling interval timers on the Cisco CMTS router back to preferred levels using the
cable modem remote-query command in privileged EXEC mode.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-365
Cable Commands: cable m
cable modem remote-query
Examples The following example illustrates how to set the polling interval to 5 seconds and the SNMP community
string to private:
Router# configure terminal
Router(config)# cable modem remote-query 5 private
Router(config)# snmp-server community private
Router(config)# snmp-server manager
The following example demonstrates how to change the remote query configuration, by first deleting the
existing configuration and then giving the new configuration:
Router# configure terminal
Router(config)# no cable modem remote-query
Router(config)# no snmp-server manager
Router(config)# cable modem remote-query 10 public
Router(config)# snmp-server community public
Router(config)# snmp-server manager
Related Commands Command Description
debug cable remote-query Turns on debugging to gather information from remote CMs.
show cable modem Displays information for the registered and unregistered CMs.
show cable modem phy Displays DOCSIS PHY layer information for one or more CMs.
show cable modem Displays the statistics accumulated by the remote query feature.
remote-query
snmp-server enable traps cable Enables traps that are sent when the remote polling of CMs has
been completed.
Cisco IOS CMTS Cable Command Reference
CBL-366 OL-15510-15
Cable Commands: cable m
cable modem service-class-name
cable modem service-class-name
To change a QoS service class for a particular cable modem (CM), use the cable modem
service-class-name command in privileged EXEC mode.
cable modem {ip-address | mac-address} service-class-name name
Syntax Description ip-address Specifies the IP address of the CM to be assigned the named service class.
mac-address Specifies the MAC address of the CM to be assigned the named service
class.
name Specifies the name of the QoS service class.
Command Default No default behavior or values
Command Modes Privileged EXEC (#)
Command History Release Modification
12.3(23)BC2 This command was introduced.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.2(33)SCB. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines This command has the following restrictions:
• The no form of the command is not supported, as the CMTS does not cache the service class
parameters of the modem.
• The command is supported only on DOCSIS 1.1 CMs primary service flows.
• You can specify this command only after the CM has been online for at least 200 seconds.
• The parameters defined by the named service class should be a subset of the admitted qos
parameters. Normally, the admitted and the active parameters have the same qos parameters.
However, it is better to ensure that the following parameters are a subset of the original or registered
set of parameters: priority, max-rate, max-burst, min-rate, max-latency, min-packet-size,
act_timeout, or adm_timeout. Also, ensure that the values of required_mask, forbidden_mask
and aggregate_mask are the same.
Examples The following example changes the QoS parameter set for the CM with MAC address aaaa.bbbb.cccc to
the service class named “test”:
Router# cable modem aaaa.bbbb.cccc service-class-name test
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-367
Cable Commands: cable m
cable modem service-class-name
Related Commands Command Description
cable service class Sets parameters for a DOCSIS 1.1 cable service class.
service-class Identifies a particular service class for cable modem monitoring in an
(enforce-rule) enforce-rule.
Cisco IOS CMTS Cable Command Reference
CBL-368 OL-15510-15
Cable Commands: cable m
cable modem vendor
cable modem vendor
To associate the name of a vendor with its Organizational Unique Identifier (OUI), use the cable modem
vendor command in global configuration mode. To remove the association of the vendor name with its
OUI, use the no form of this command.
cable modem vendor OUI [vendor-name]
no cable modem vendor OUI [vendor-name]
Syntax Description OUI Specifies the Organizational Unique Identifier (OUI). An OUI is the first 3 octets (3
bytes, 6 hexadecimal digits) of the CM MAC address and typically indicates the vendor for
the CM. The octets can be specified as one string (for example: 000102), or each octet can
be separated by a hyphen, period, or colon (for example: 00-01-02 or 00:01:02 or 00.01.02).
Note You can use either a period or colon as the separator between octets when
manually entering this command, but the command that is written to the running
and startup configuration files will always use a period.
vendor-name (Optional) Specifies an arbitrary string identifying the vendor for this OUI.
Command Default A default database contains approximately 300 OUIs associated with approximately 60 vendor names.
Command Modes Global configuration
Command History Release Modification
12.2(8)BC2 This command was introduced.
Usage Guidelines The cable modem vendor command allows you to associate an arbitrary string with an OUI to identify
the vendor of the associated CM. The vendor name is then displayed as part of the show cable modem
vendor command.
The show cable modem vendor command uses a default database of approximately 300 OUIs. If the
OUI and vendor are not in that database, the show cable modem vendor command displays the OUI as
the vendor name, but you can use the cable modem vendor command to associate a vendor name with
the new OUI.
If you specify an OUI with the cable modem vendor command that already exists in the OUI database,
the previous value is overwritten with the new value. You can use the default prefix to restore the
original value for an OUI in the default database.
You can also use the no cable modem vendor command to remove the association between an OUI and
a vendor name. The show cable modem vendor command then displays only the OUI as the vendor
name.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-369
Cable Commands: cable m
cable modem vendor
Tip The Institute of Electrical and Electronics Engineers (IEEE) is the official issuer of OUI values. The
IEEE OUI web site is at http://standards.ieee.org/regauth/oui/index.shtml.
Examples The following shows several examples of the cable modem vendor command using Cisco OUIs:
Router(config)# cable modem vendor 00:01:42 Cisco
Router(config)# cable modem vendor 00:01:43 Cisco
Router(config)# cable modem vendor 00:01:63 Cisco
Router(config)# cable modem vendor 00:01:64 Cisco
Router(config)# cable modem vendor 00:0A:41 Cisco
Router(config)# cable modem vendor 00:0A:42 Cisco
Router(config)#
The following shows an example of the default cable modem vendor command being used to restore
the original association between Cisco and its company OUI of 00:00:0C. Any previous user-defined
vendor name is deleted from the OUI database.
Router(config)# default cable modem vendor 00000C
The following shows an example of the no cable modem vendor command being used to remove the
association between Cisco and an OUI of 00:0A:42. If any CMs exist with that OUI, the show cable
modem vendor command will display the OUI (“00:0A:42”) as the vendor name.
Router(config)# no cable modem vendor 00:0A:42
Router(config)#
Related Commands Command Description
show cable modem vendor Displays the vendor name or Organizational Unique Identifier (OUI) for
the CMs on each cable interface.
Cisco IOS CMTS Cable Command Reference
CBL-370 OL-15510-15
Cable Commands: cable m
cable modulation-profile
cable modulation-profile
To define a modulation profile for use on the router, use the cable modulation-profile command in
global configuration mode. To remove the entire modulation profile or to reset a default profile to its
default values, use the no form of this command.
DOCSIS 1.0 and 1.1 Mixed Mode:
cable modulation-profile profile {mix | qam-16 | qpsk | robust-mix}
no cable modulation-profile profile {iuc | mix | qam-16 | qpsk | robust-mix}
cable modulation-profile profile iuc fec-tbytes fec-len burst-len guard-t mod scrambler seed diff
pre-len last-cw uw-len
DOCSIS 1.x/2.0 Mixed Mode:
cable modulation-profile profile {mix-high | mix-low | mix-mid | mix-qam | qam-16 | qpsk |
robust-mix-high | robust-mix-mid | robust-mix-qam}
no cable modulation-profile profile {iuc | mix-high | mix-low | mix-mid | mix-qam | qam-16 |
qpsk | robust-mix-high | robust-mix-mid | robust-mix-qam}
cable modulation-profile profile iuc fec-tbytes fec-len burst-len guard-t mod scrambler seed diff
pre-len last-cw uw-len
DOCSIS 2.0 A-TDMA Mode:
cable modulation-profile profile {mix-high | mix-low | mix-mid | mix-qam | qam-8 | qam-16 |
qam-32 | qam-64 | qpsk | robust-mix-high | robust-mix-low | robust-mix-mid}
no cable modulation-profile profile {iuc | mix-high | mix-low | mix-mid | mix-qam | qam-8 |
qam-16 | qam-32 | qam-64 | qpsk | robust-mix-high | robust-mix-low | robust-mix-mid}
cable modulation-profile profile iuc fec-tbytes fec-len burst-len guard-t mod scrambler seed diff
pre-len last-cw uw-len
Cisco IOS Release 12.2(33)SCC and Later
DOCSIS 2.0 A-TDMA Mode and DOCSIS 2.0 S-CDMA Mode:
cable modulation-profile profile {mix-high | mix-low | mix-mid | mix-qam | qam-16 | qpsk |
robust-mix-high | robust-mix-low | robust-mix-mid}
no cable modulation-profile profile {iuc | mix-high | mix-low | mix-mid | mix-qam | qam-16 |
qpsk | robust-mix-high | robust-mix-low | robust-mix-mid}
cable modulation-profile profile iuc fec-tbytes fec-len burst-len guard-t mod scrambler seed diff
pre-len last-cw uw-len
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-371
Cable Commands: cable m
cable modulation-profile
Syntax Description profile Specifies the modulation profile number. The valid values for the profile number
depend on the cable interface being used and the upstream’s mode of operation.
See Table 10 for a list of valid ranges based on cable interface and modulation
type.
In Cisco IOS Release 12.2(15)CX and later releases, you can create a maximum
of 10 profiles for each mode of operation, for a total of 30 profiles. In earlier
software releases, you can create a maximum of 8 profiles only for DOCSIS 1.0
and DOCSIS 1.1 mode.
mix (DOCSIS 1.0 and DOCSIS 1.1 mode only) Creates a default QPSK/16-QAM mix
modulation profile where short and long grant bursts are sent using 16-QAM,
while request, initial ranging, and station maintenance bursts are sent using
QPSK). The burst parameters are set to their default values for each burst type.
mix-high (DOCSIS 1.x/2.0 mixed and DOCSIS 2.0 modes only) Creates a default
QPSK/64-QAM modulation profile.
mix-low (DOCSIS 1.x/2.0 mixed and DOCSIS 2.0 modes only) Creates a default
QPSK/16-QAM modulation profile.
mix-mid (DOCSIS 1.x/2.0 mixed and DOCSIS 2.0 A-TDMA modes only) Creates a
default QPSK/32-QAM modulation profile.
mix-qam (DOCSIS 1.x/2.0 mixed and DOCSIS 2.0 A-TDMA modes only) Creates a
default 16-QAM/64-QAM modulation profile.
qam-8 (DOCSIS 2.0 A-TDMA mode only) Creates a default 8-QAM modulation profile.
This modulation profile is available in hidden and internal mode only from Cisco
IOS Release 12.2(33)SCC onwards.
qam-16 Creates a default 16-QAM modulation profile.
qam-32 (DOCSIS 2.0 A-TDMA mode only) Creates a default 32-QAM modulation
profile.
This modulation profile is available in hidden and internal mode only from Cisco
IOS Release 12.2(33)SCC onwards.
qam-64 (DOCSIS 2.0 A-TDMA mode only) Creates a default 64-QAM modulation
profile.
This modulation profile is available in hidden and internal mode only from Cisco
IOS Release 12.2(33)SCC onwards.
qpsk Creates a default QPSK modulation profile.
robust-mix (DOCSIS 1.0 and DOCSIS 1.1 mode only) Creates a default QPSK/16-QAM
modulation profile with a longer preamble that is more robust and more able to
deal with noise on the upstream better than the mix profile.
robust-mix-high (DOCSIS 1.x/2.0 mixed and DOCSIS 2.0 A-TDMA modes only) Creates a
default QPSK/64-QAM mixed modulation profile with a longer preamble that is
more robust and more able to deal with noise on the upstream better than the
mix-high profile.
robust-mix-low (DOCSIS 2.0 A-TDMA mode only) Creates a default QPSK/16-QAM
modulation profile with a longer preamble that is more robust and better able to
deal with noise on the upstream than the mix-low profile.
robust-mix-mid (DOCSIS 1.x/2.0 mixed and DOCSIS 2.0 A-TDMA modes only) Creates a
default QPSK/32-QAM modulation profile with a longer preamble that is more
robust and better able to deal with noise on the upstream than the mix-mid
profile.
Cisco IOS CMTS Cable Command Reference
CBL-372 OL-15510-15
Cable Commands: cable m
cable modulation-profile
robust-mix-qam (DOCSIS 1.x/2.0 mixed mode only) Creates a default 16-QAM/64-QAM mixed
modulation profile with a longer preamble that is more robust and better able to
deal with noise on the upstream than the mix-qam profile.
iuc Interval usage code. Valid entries depend on the mode of operation:
• If the upstream is configured for DOCSIS 1.0 and DOCSIS 1.1 modulation
profiles, the valid values are initial, long, request, reqdata, short, or
station.
• If the upstream is configured for DOCSIS 1.x and DOCSIS 2.0 mixed
modulation profiles, the valid values are a-long, a-short, a-ugs, initial, long,
request, reqdata, short, or station.
• If the upstream is configured for DOCSIS 2.0 A-TDMA modulation profiles,
the valid values are a-long, a-short, a-ugs, initial, long, request, reqdata,
short, or station.
The reqdata burst type is included as a placeholder for scripts that might
reference it, but the DOCSIS MAC scheduler on the Cisco CMTS does not use
this type of burst.
When you are using the initial and station bursts for DOCSIS 2.0 A-TDMA
mode, qam-8, qam-32, and qam-64 modulation profiles are available in hidden
mode only.
preamble (DOCSIS 1.x/2.0 mixed and DOCSIS 2.0 A-TDMA modes only, for a-long and
a-short options) Specifies the preamble format. Valid values are qpsk0 and
qpsk1.
rs-interleave-depth (DOCSIS 1.x/2.0 mixed and DOCSIS 2.0 A-TDMA modes only, for a-long and
a-short options) Specifies the RS interleave depth. The valid range is from 0 to
114.
rs-interleave-block (DOCSIS 1.x/2.0 mixed and DOCSIS 2.0 A-TDMA modes only, for a-long and
a-short options) Specifies the RS interleave block size. The valid range is from
18 to 2048.
fec-tbytes The number of bytes that can be corrected per FEC code word. For DOCSIS 1.0
and DOCSIS 1.1 mode, valid values are from 0 to 10 (decimal), where 0 means
no FEC. For DOCSIS 2.0 A-TDMA mode, the valid values are from 0 to 16
(decimal), where 0 means no FEC.
fec-len FEC code-word length. Valid values are from 16 to 253.
burst-len Maximum burst length in minislots. Valid values are from 0 to 255, where 0
means no limit.
guard-t Guard time in symbols. The time between successive bursts, with a range from 22
to 255. (In Cisco IOS Release 12.2(15)BC2 and earlier releases, the minimum
guard time was 0 symbols, but we do not recommend using a guard time smaller
than 22 symbols.)
mod Modulation. Valid entries are 16qam and qpsk for DOCSIS 1.0 and DOCSIS 1.1
upstreams. Valid entries are 8qam, 16qam, 32qam, 64qam, and qpsk for
DOCSIS 2.0 upstreams.
The qam-8, qam-32, and qam-64 modulation profiles are available in hidden and
internal modes only from Cisco IOS Release 12.2(33)SCC onwards.
scrambler Enable or disable scrambler. Valid entries are scrambler and no-scrambler.
seed (Required if scrambler option used) Scrambler seed in hexadecimal format.
Valid values are from 0x0 to 0x7FFF.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-373
Cable Commands: cable m
cable modulation-profile
diff Enable or disable differential encoding. Valid entries are diff and no-diff.
In DOCSIS 2.0 mode, differential encoding cannot be enabled for the 8-QAM,
32-QAM, and 64-QAM modulations.
The qam-8, qam-32, and qam-64 modulation profiles are available in hidden and
internal modes only from Cisco IOS Release 12.2(33)SCC onwards.
pre-len Preamble length in bits. Valid values are from 2 to 256.
last-cw Handling of FEC for last code word. Valid entries are fixed for fixed code-word
length and shortened for shortened last code word.
uw-len Upstream unique word length. Enter uw8 for 8-bit unique code words or uw16
for 16-bit unique code words.
Command Default Modulation profile 1 is defined as a qpsk Time Division Multiple Access (TDMA) profile.
In Cisco IOS Release 12.2(15)CX, Release 12.2(15)BC2 and later releases, additional modulation
profiles are defined as the default mixed TDMA/A-TDMA profile and the default Advanced TDMA
(A-TDMA) profile. See Table 10 for a list of valid ranges based on cable interface and modulation type.
Command Modes Global configuration (config)
Command History Release Modification
11.3 NA This command was introduced.
12.0(7)XR2 This command was supported.
12.0(6)SC The mix, qpsk, and qam-16 options were added.
and
12.1(3a)EC1
12.2(8)BC2 Support was added for the Cisco uBR10012 router.
12.2(11)CY Support was added for the Cisco uBR-MC5X20S cable interface line card. This
includes creating default modulation profile 21 for the card.
12.2(15)CX Support was added for the Cisco uBR-MC16U/X and Cisco uBR-MC28U/X cable
interface line card, including support for DOCSIS 2.0 A-TDMA and mixed modulation
profiles on this card.
The robust predefined modulation profiles were also added for all modes of operation.
The robust profiles use a longer preamble to provide better handling of noise on the
upstream, but they also consume more bandwidth at the PHY layer than the other
profiles.
12.2(15)BC2 Support was added for the Cisco uBR10-MC5X20S/U cable interface line cards,
including support for DOCSIS 2.0 A-TDMA and mixed modulation profiles. Support
for the IUC-11 burst profile (Advanced UGS, a-ugs) was also added for mixed
TDMA/A-TDMA modulation profiles.
12.3BC This command was integrated into Cisco IOS Release 12.3BC. Support was added for
the Cisco uBR10-MC5X20H cable interface line card.
Cisco IOS CMTS Cable Command Reference
CBL-374 OL-15510-15
Cable Commands: cable m
cable modulation-profile
Release Modification
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
12.2(33)SCC This command was modified. Moved qam-8, qam-32, and qam-64 options to hidden
and internal mode only. Support was added for Synchronous Code Division Multiple
Access (S-CDMA) modulation profiles.
Usage Guidelines A modulation profile is a collection of at least six burst profiles that are sent out in an upstream channel
descriptor (UCD) message to configure a modem’s transmit parameters.
You can use the no cable modulation-profile command to remove all modulation profiles except the
default modulation profiles (1, 21, 41, 101, 121, 201, 221, 241, and 321, depending on the cable interface
line cards being used). In the case of the default modulation profiles, the no cable modulation-profile
command resets the default profile to its default values.
We recommend that you use the predefined profiles instead of manually specifying the individual bursts
for a modulation profile. The predefined profiles are optimized for the default of 32 symbols per minislot
for each particular modulation scheme. The robust predefined profiles use a longer preamble for better
handling of noise on the upstream, but at the cost of consuming more PHY layer bandwidth than the
other non-robust profiles.
If you want to manually specify the individual bursts, enter a line with all parameters for each upstream
burst type. Then repeat this command for each burst type, which also must be fully specified. A profile
with incomplete or missing bursts can cause unreliable operation or loss of modem connectivity.
Caution Changes to modulation profiles causes changes to the physical layer. Because changing physical layer
characteristics affects router performance and function, this task should be reserved for expert users who
have a thorough understanding of DOCSIS systems and how each parameter affects the network.
Note The reqdata burst type is included as a placeholder for SNMP scripts that might reference it, but it has
no effect. You can use this command (and SNMP commands) to specify the reqdata types, but the
DOCSIS MAC scheduler on the Cisco CMTS does not use this type of burst.
From Cisco IOS Release 12.2(33)SCC onwards, the qam-8, qam-32, and qam-64 modulation profiles
are available in hidden and internal modes only. When you are using the initial and station bursts for
DOCSIS 2.0 A-TDMA mode, qam-8, qam-32, and qam-64 modulation profiles are available in hidden
mode only. However, these modulation profiles are available for a-long, a-short, a-ugs, long, request,
reqdata, and short.
Modulation Profile Ranges
The valid range for modulation profiles depends on the cable interface being used and the type of
modulation profile being created. Table 10 lists the valid ranges according to cable interface and
modulation type.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-375
Cable Commands: cable m
cable modulation-profile
Table 10 Allowable Ranges for Modulation Profiles
Cable Interface DOCSIS 1.X (TDMA) Mixed DOCSIS 1.X/2.0 DOCSIS 2.0 (A-TDMA) DOCSIS 2.0 (S-CDMA)
1
Cisco uBR7100 series 1 to 10 , default=1 N/A N/A N/A
Cisco uBR-MC16C 1 to 10, default=1 N/A N/A N/A
Cisco uBR-MC16S 1 to 10, default=1 N/A N/A N/A
Cisco uBR-MC28C 1 to 10, default=1 N/A N/A N/A
Cisco uBR-MC5X20S, 21 to 30, default=21 121 to 130, 221 to 230, default=221 321 to 330 (default is
Cisco uBR-MC5X20U, default=121 321)
Cisco uBR-MC5X20H
Cisco uBR-MC16U/X, 41 to 50, default=41 141 to 150, 241 to 250, default=241 N/A
Cisco uBR-MC28U/X default=141
1. Only 8 modulation profiles are supported in Cisco IOS software releases before 12.2(15)BC1, so in these releases the valid range is from 1 to 8.
DOCSIS 1.0 and DOCSIS 1.1 Support
For DOCSIS 1.0 and 1.1 cable modems, the following burst types are required: request, request data,
initial maintenance, station maintenance, short grant, and long grant. You must issue the
cable modulation-profile command six times for each individual burst type to correctly create a new
modulation profile.
The three default profiles can be used to quickly create modulation profiles, without having to specify
the parameters for each individual burst: mix, qpsk, and qam-16. The burst parameters for the request,
initial, station maintenance, short, and long bursts are set to their default values for each burst type. (The
reqdata burst type is not created when using the default modulation profiles because it is not used by
the MAC scheduler.)
The default profiles allow basic profiles to be implemented for initial network connectivity. As the
characteristics of a cable plant become better known, the profiles can then be adjusted accordingly.
Note Do not use the qam-16 mode unless you have verified that your cable plant can support that modulation
profile. Most cable plants should instead use the qpsk or mix modulation profile for the primary profile.
Caution Turning the scrambler off can cause packet loss and is used only in lab testing environments.
Errors or incompatible configurations in the burst profiles cause cable modems to drop connectivity, to
drop short or long data packets, or to fail to connect to the network. It is possible to build a burst profile
set for which no implementation of a DOCSIS receiver is capable of receiving the modem’s
transmission.
Data rates of 160 Ksymbol/sec and 2560 Ksymbol/sec are highly sensitive to unique word length,
preamble length, and FEC sizing. Incorrect choices for these values can cause poor, or no, connectivity
at these symbol rates.
Cisco IOS CMTS Cable Command Reference
CBL-376 OL-15510-15
Cable Commands: cable m
cable modulation-profile
DOCSIS 2.0 Support
Cisco IOS Release 12.2(11)CY, 12.2(15)BC1, 12.3BC, 12.2(33)SCA, 12.2(33)SCC, and later releases
support 10 modulation profiles for each of the three DOCSIS modes (DOCSIS 1.X, DOCSIS 2.0, and
mixed mode), for a total maximum of 30 modulation profiles. In addition, the router also creates several
default modulation profiles (1, 21, 41, 101, 121, 141, 201, 221, 241, and 321, depending on the cable
interface line cards that are installed).
Examples The following example shows how to create a mixed modulation profile, using 16-QAM for the short
and long grant bursts and QPSK for the request, initial ranging, and station maintenance bursts. The burst
parameters are set to their default values for each burst type.
Router(config)# cable modulation-profile 8 mix
Router(config)# exit
Router# show cable modulation-profile 8
Mod IUC Type Preamb Diff FEC FEC Scrambl Max Guard Last Scrambl Preamb
length enco T CW seed B time CW offset
BYTES size size size short
8 request qpsk 64 no 0x0 0x10 0x152 0 8 no yes 0
8 initial qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0
8 station qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0
8 short qam 144 no 0x6 0x4B 0x152 6 8 yes yes 0
8 long qam 160 no 0x8 0xDC 0x152 0 8 yes yes 0
Router#
Note The above example shows the default values for the burst parameters. The main differences in the default
values between 16-QAM and QPSK bursts are in the Type and Preamble Length fields.
The following example shows how to define the burst parameters for profile 2 with the following
parameters: 0 fec-tbytes, 16 kbytes fec-len, a burst-len of 1, a guard time of 8, a mod value of qpsk,
scrambler enabled with a seed value of 152, differential encoding disabled, a preamble length of 64 bits,
a fixed code-word length, and 8-bit unique words for upstream unique word length.
Router(config)# cable modulation-profile 2 request 0 16 1 8 qpsk scrambler 152 no-diff 64
fixed uw8
Router(config)# cable modulation-profile 2 reqdata 0 16 1 8 qpsk scrambler 152 no-diff 64
fixed uw8
Router(config)# cable modulation-profile 2 initial 5 34 0 48 qpsk scrambler 152 no-diff
128 fixed uw16
Router(config)# cable modulation-profile 2 station 5 34 0 48 qpsk scrambler 152 no-diff
128 fixed uw16
Router(config)# cable modulation-profile 2 short 6 75 6 8 16qam scrambler 152 no-diff 144
fixed uw8
Router(config)# cable modulation-profile 2 long 8 220 0 8 16qam scrambler 152 no-diff 160
fixed uw8
Note You must create all of the bursts (request, initial, station, short and long) for this modulation profile,
using the cable modulation-profile command. The reqdata burst is optional.
The following example shows an example of a DOCSIS 1.X/DOCSIS 2.0 mixed modulation profile:
Router# configure terminal
Router(config)# cable modulation-profile 142 request 0 16 0 8 qpsk scrambler 152 no-diff
64 fixed uw8
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-377
Cable Commands: cable m
cable modulation-profile
Router(config)# cable modulation-profile 142 initial 5 34 0 48 qpsk scrambler 152 no-diff
32 fixed uw16
Router(config)# cable modulation-profile 142 station 5 34 0 48 qpsk scrambler 152 no-diff
32 fixed uw16
Router(config)# cable modulation-profile 142 short 5 75 6 8 qpsk scrambler 152 no-diff 72
shortened uw8
Router(config)# cable modulation-profile 142 long 8 220 0 8 qpsk scrambler 152 no-diff 80
shortened uw8
Router(config)# cable modulation-profile 142 a-short qpsk0 0 18 5 99 10 8 64qam scrambler
152 no-diff 128 shortened uw8
Router(config)# cable modulation-profile 142 a-long qpsk0 0 18 15 200 0 8 64qam scrambler
152 no-diff 128 shortened uw8
Router(config)#
The following example shows an example of a DOCSIS 2.0 A-TDMA modulation profile:
Router# configure terminal
Router(config)# cable modulation-profile 242 request qpsk0 0 0 0 16 0 8 qpsk scrambler 152
no-diff 64 fixed uw8
Router(config)# cable modulation-profile 242 initial qpsk0 0 0 5 34 0 48 qpsk scrambler
152 no-diff 32 fixed uw16
Router(config)# cable modulation-profile 242 station qpsk0 0 0 5 34 0 48 qpsk scrambler
152 no-diff 32 fixed uw16
Router(config)# cable modulation-profile 242 short qpsk0 0 0 5 75 6 8 qpsk scrambler 152
no-diff 72 shortened uw8
Router(config)# cable modulation-profile 242 long qpsk0 0 0 8 220 0 8 qpsk scrambler 152
no-diff 80 shortened uw8
Router(config)# cable modulation-profile 242 a-short qpsk0 0 18 5 99 10 8 64qam scrambler
152 no-diff 128 shortened uw8
Router(config)# cable modulation-profile 242 a-long qpsk0 0 18 15 200 0 8 64qam scrambler
152 no-diff 128 shortened uw8
Router(config)#
The following example shows an example of a DOCSIS 2.0 S-CDMA modulation profile:
Router# configure terminal
Router(config)# cable modulation-profile 324 request 0 16 10 16qam scrambler 152 no-diff
64 fixed qpsk0 spreader 12 12 no-tcm
Router(config)# cable modulation-profile 324 initial 0 16 10 16qam scrambler 152 no-diff
64 fixed qpsk0 off-spreader 12 12 no-tcm
Router(config)# cable modulation-profile 324 station 0 16 10 16qam scrambler 152 no-diff
64 fixed qpsk0 off-spreader 12 12 no-tcm
Router(config)# cable modulation-profile 324 a-short 0 16 10 16qam scrambler 152 no-diff
64 fixed qpsk0 off-spreader 12 12 no-tcm
Router(config)# cable modulation-profile 324 a-long 16 10 16qam scrambler 152 no-diff 64
fixed qpsk0 off-spreader 12 12 no-tcm
Router(config)# cable modulation-profile 324 a-ugs 16 10 16qam scrambler 152 no-diff 64
fixed qpsk0 off-spreader 12 12 no-tcm
Router(config)#
See the show cable modulation-profile command for a description of the output display fields.
Related Commands Command Description
cable upstream modulation-profile Assigns a modulation profile to an interface.
show cable modulation-profile Displays a modulation profile group’s information.
Cisco IOS CMTS Cable Command Reference
CBL-378 OL-15510-15
Cable Commands: cable m
cable modulation-profile global-scheme
cable modulation-profile global-scheme
To define a global modulation profile for use on the router, use the cable modulation-profile
global-scheme command in global configuration mode. To remove the newly created modulation profile
or to reset to the legacy profile mode, use the no form of this command.
cable modulation-profile global-scheme profile
no cable modulation-profile global-scheme
Syntax Description profile Modulation profile number. The valid values for the profile number range from 1
to 400.
Command Default The global modulation profile scheme is disabled by default.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines Using the global modulation profile scheme, you can assign any number between 1 to 400 to any
modulation profiles. It eliminates the number space restriction and increases the number of modulation
profiles that can be created per DOCSIS mode. The global modulation profile mode allows you to create
and configure DOCSIS 3.0 channel type 4SR (scdma-d3). When an upstream DOCSIS mode is changed
to scdma-d3 , it is initially assigned to the system created default modulation profile as shown in
Table 11.
Note Though you can assign any number between 1 to 400 to any modulation profile, the default modulation
profile number assigned to an upstream channel for a given channel type will remain the same. That is,
modulation profile numbers 21, 121, 221, 321, and 381 will be applicable for TDMA, mixed, A-TDMA,
S-CDMA, and DOCSIS 3.0 S-CDMA channel types.
All the existing and previously defined modulation profiles are converted to the new format. However,
all the newly created modulation profiles, which are outside of the legacy number space range, are lost
when you revert to the legacy modulation profile.
Note The default profiles cannot be deleted. Using the no cable modulation global command on the default
profiles resets them to their original, default values.
Modulation Profile Ranges
The valid range for modulation profiles depends on the cable interface being used and the type of
modulation profile being created.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-379
Cable Commands: cable m
cable modulation-profile global-scheme
Table 11 lists the valid ranges according to cable interface and modulation type:
Table 11 Allowable Ranges for Modulation Profiles
Cable Interface DOCSIS 2.0 (S-CDMA) DOCSIS 3.0 (S-CDMA)
Cisco UBR-MC20X20V 321 to 330 (default is 321) 1 to 400 (default is 381)
Examples The following example shows how to create a global modulation profile scheme:
Router(config)# cable modulation-profile global-scheme
Related Commands Command Description
cable upstream modulation-profile Assigns a modulation profile to an interface.
show cable modulation-profile Displays modulation profile information of a group.
Cisco IOS CMTS Cable Command Reference
CBL-380 OL-15510-15
Cable Commands: cable m
cable monitor
cable monitor
To enable the forwarding of selected packets on the cable interface to an external LAN analyzer, use the
cable monitor command in cable interface configuration mode. To disable this function, use the no form
of this command.
cable monitor [incoming | outbound] [timestamp]
interface interface {slot/{subslot | bay}/port} [access-list {name | number}] | [mac-address
address] | [sid sid-number] | [upstream number]
[packet-type {data docsis | data ethernet | mac [type type] }]
cable monitor outbound downstream {modular-cable | Integrated-cable | wideband-cable}
slot/(subslot | bay}/controller:channel
no cable monitor
Syntax Description incoming Forwards only packets being received on the upstream.
outbound Forwards only packets being transmitted on the downstream.
timestamp Enables packet time-stamping by appending a four-byte value to the
forwarded packets. The timestamp value is in hundredths of a second.
interface interface Specifies the WAN interface to which an external LAN analyzer is
attached, and to which packets should be forwarded.
interface—Specifies the interfaces such as Ethernet, Fast Ethernet, Gigabit
Ethernet, or Ten Gigabit Ethernet interface.
slot Slot where the 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 uBR7100 series router—The valid value is 1.
subslot | bay (Cisco uBR10012 only) Secondary subslot of the cable interface line card
or bay of the SPA. The valid subslot values are 0 or 1 for the cable line
card. Valid values for bay are from 0 to 3.
port Specifies the WAN interface number.
access-list name| number (Optional) Specifies the IP access list name or number (1 to 2699).
mac-address address (Optional) Specifies the MAC address of the device being monitored.
sid sid-number (Optional) Specifies the service ID for the packets that should be
forwarded (1 to 16384).
Note This option is supported only in Cisco IOS releases that support
DOCSIS 1.1 operations.
upstream number (Optional) Specifies the upstream interface. Valid values for the Cisco
uBR-MC20X20V and Cisco uBR-MC5X20 line cards range from 0 to 3
packet-type (Optional) Specifies whether data or MAC packets are forwarded.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-381
Cable Commands: cable m
cable monitor
data docsis Specifies that complete DOCSIS packets (both the DOCSIS header and the
complete Ethernet frame) should be forwarded.
Note Enabling this option can result in %LINK-4-TOOBIG messages
being generated if the original Ethernet frame is at or near the
maximum Ethernet size of 1500 bytes. This is because this option
adds additional bytes (the DOCSIS header) to the Ethernet frame,
which can result in a total frame size that exceeds the maximum
size that is allowed for standard Ethernet frames.
data ethernet Specifies that the DOCSIS header should be stripped from the packet and
that only the Ethernet frame should be forwarded.
mac [type type] Specifies that only DOCSIS MAC-layer packets should be forwarded. If
you are using the sid option, you can also optionally specify the type
option with one of the following keywords to indicate that only the specific
type of MAC-layer traffic should be forwarded:
dsa—Dynamic service addition
dsc—Dynamic service change
dsd—Dynamic service deletion
map-grant—Grants
map-req—Requests
outbound downstream Enables cable monitor on the specified downstream interface.
controller: channel controller:channel—Identifies the controller.
• Valid range for Cisco uBR-MC3GX60V line card is from 0 to 2.
– RF channel—The valid range is from 0 to 23.
– Bonding group—The valid range is from 0 to 31.
• Valid range for Cisco UBR-MC20X20 line card is 0 to 4.
– RF channel—The valid range is from 0 to 3.
– Bonding group—The valid range is from 0 to 5.
• Valid value for Cisco Wideband SPA is 0.
– RF channel—The valid range is from 0 to 23.
– Bonding group—The valid range is from 0 to 31.
Command Default Both upstream (incoming) and downstream (outbound) traffic is forwarded.
Command Modes Interface configuration—cable interface only (config-if)
Command History Release Modification
12.1(3a)EC This command was introduced.
12.1(4)CX The sid option was added for DOCSIS 1.1 support.
12.2(4)XF Support was added for the Cisco uBR10012 universal broadband router.
12.2(4)BC1 Support was added to the Release 12.2 BC train.
Cisco IOS CMTS Cable Command Reference
CBL-382 OL-15510-15
Cable Commands: cable m
cable monitor
Release Modification
12.3(13a)BC Supports the Cisco MC5x20U-D broadband processing engine (BPE) and the Cisco
MC28U cable interface line card.
12.3(17a)BC • Access Control Lists are now supported on the Cisco uBR-MC5X20U/D and
Cisco uBR-MC28U cable interface line cards
• Unconditional downstream sniffing now enables downstream packets to be
monitored, either for MAC or data packets. This enhancement supports both
DOCSIS and Ethernet packet encapsulation.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
12.2(33)SCB Support was added for the Ten Gigabit Ethernet interface type.
12.2(33)SCE Support was added for the Cisco UBR-MC3XG60V line cards.
Usage Guidelines The cable monitor command allows an external LAN packet analyzer to monitor inbound and outbound
data packets for specific types of traffic between the Cisco CMTS and the CMs on a cable interface. This
feature enables the CMTS administrator to analyze traffic problems with customer data exchanges.
The interface used for forwarding packets can be used only for the external LAN analyzer; and cannot
be used for other purposes. For complete information on configuring and using this feature, see the
Cable Monitor for the Cisco CMTS chapter in the Cisco CMTS Feature Guide or the Cisco IOS CMTS
Cable Software Configuration Guide, available on Cisco.com.
Note The cable monitor outbound downstream command can be enabled:
– only one mac-domain on a line card at a time
– for one modular-cable or intergrated-cable interface per line card at one time
– for one wideband-cable interface per line card at one time
Tip One possible software utility you can use for decoding the DOCSIS MAC frames is Wireshark software,
which is available for Windows and Unix systems at http://www.wireshark.org.
Associated Features The cable monitor command is used to configure the following features:
• Cable Monitor and Intercept Features on the Cisco CMTS Routers
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-383
Cable Commands: cable m
cable monitor
Examples The following example shows how to configure the Cisco CMTS so that it monitors incoming
MAC-layer packets for the CM with the MAC address of 0123.4567.89ab and forwards copies of the
packets to the LAN analyzer on the Ethernet interface in slot 1, port 2:
Router(config-if)# cable monitor incoming interface e1/2 mac-address 0123.4567.89ab
packet-type mac
The following example shows how to configure a Cisco CMTS running DOCSIS 1.1 software so that it
monitors incoming MAC-layer packets of type DSA for the CM identified by SID 173 and forwards
copies of the packets to the LAN analyzer on the Ethernet interface in slot 1, port 2:
Router(config-if)# cable monitor incoming interface e1/2 sid 173 packet-type mac type dsa
The following example shows how to configure a mac domain to monitor all packets on a modular
primary downstream and forward copies of the packets to a Gigabit Ethernet interface:
Router# configure terminal
Router(config)# interface cable 5/0/0
Router(config-if)# cable monitor outbound downstream Modular-Cable 5/1/0:21
Router(config-if)# cable monitor outbound interface GigabitEthernet3/0/0
Router(config-if)# exit
The following example shows how to configure a mac domain to monitor all packets on a particular
downstream bonding group and forward copies of the packets to a Gigabit Ethernet interface:
Router# configure terminal
Router(config)# interface cable 5/0/0
Router(config-if)# cable monitor outbound downstream Wideband-Cable 5/1/2:30
Router(config-if)# cable monitor outbound interface GigabitEthernet3/0/0
Router(config-if)# exit
The following example shows how to configure a mac domain to monitor all packets on a particular
bonding group destined to a specific modem and forward copies of the packets to a Gigabit Ethernet
interface:
Router# configure terminal
Router(config)# interface cable 5/0/0
Router(config-if)# cable monitor outbound downstream Wideband-Cable 5/1/2:30
Router(config-if)# cable monitor outbound interface GigabitEthernet3/0/0 mac-address
0123.4567.89ab
Router(config-if)# exit
Related Commands Command Description
cable intercept Allows the CMTS to forward all traffic to and from a particular CM to a
data collection server located at particular User Datagram Protocol
(UDP) port.
show interface cable monitor Displays monitor flow information on the upstream port.
Cisco IOS CMTS Cable Command Reference
CBL-384 OL-15510-15
Cable Commands: cable m
cable mrc-mode
cable mrc-mode
To enable Multiple Receive Channel (MRC) mode for a Media Access Control (MAC) interface during
or after the cable modem (CM) registration, use the cable mrc-mode command in cable interface
configuration mode. To disable this configuration, use the no form of this command.
cable mrc-mode
no cable mrc-mode
Syntax Description This command has no arguments or keywords.
Command Default The MRC mode is enabled by default on a downstream bonding capable cable interface line card.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCC This command was introduced in Cisco IOS Release 12.2(33)SCC.
Usage Guidelines When you enable or disable the MRC mode, cable modems switch the operation to or from the MRC
mode only after the reinitialization of cable modems. You cannot enable the MRC mode on a
non-upstream bonding capable cable interface line card.
Examples The following example shows how to enable the MRC mode for a MAC interface:
Router# configure terminal
Router(config)# interface cable 7/1/0
Router(config-if)# cable mrc-mode
Related Commands Command Description
cable mtc-mode Enables or disables the Multiple Transmit Channel mode (MTC) for a MAC
interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-385
Cable Commands: cable m
cable mtc-mode
cable mtc-mode
To enable Multiple Transmit Channel (MTC) mode for a Media Access Control (MAC) interface during
or after the cable modem (CM) registration, use the cable mtc-mode command in cable interface
configuration mode. To disable this configuration, use the no form of this command.
cable mtc-mode [required-attribute]
no cable mtc-mode [required-attribute]
Syntax Description required-attribute Specifies the per-CM basis MTC mode configuration.
Command Default The MTC mode is enabled by default with the required attribute. With this default configuration, the
Cisco CMTS router enables the MTC mode on a per-CM basis by looking at the configuration file of
each cable modem.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines Multiple Transmit Channel mode is a CM capability that enables CMs to send upstream traffic on
multiple upstream channels. You can enable the MTC mode on a cable interface line card in two ways:
• MTC mode on a per-CM basis—By default, the MTC mode is enabled with the required attribute.
With this default configuration, the Cisco CMTS router enables MTC mode on a per-CM basis by
looking at each CM’s configuration file. When the CM configuration file has the bonded-bit (bit-0)
on in type-length-value (TLV) 43.9.3 (cable modem upstream required attribute mask), the
Cisco CMTS router lets the CM come online in the MTC mode. If the CM configuration file does
not have the bonded-bit on, the CM comes online in non-MTC mode.
• MTC mode for all cable modems in a MAC domain—The MTC mode for all cable modems in a
MAC domain is disabled by default on an upstream bonding capable cable interface line card. You
can enable the MTC mode for all cable modems in a MAC domain using the cable mtc-mode
command in cable interface configuration mode.
Note You do not have to use the required-attribute keyword to enable the MTC mode for all cable modems
in a MAC domain. You can use the no form of this command with the required-attribute keyword to
disable the default per-CM basis configuration.
You cannot enable the MTC mode on a non-upstream bonding capable cable interface line card.
Cisco IOS CMTS Cable Command Reference
CBL-386 OL-15510-15
Cable Commands: cable m
cable mtc-mode
Examples The following example shows how to enable the MTC mode for all cable modems in a MAC domain:
Router# configure terminal
Router(config)# interface cable 7/1/0
Router(config-if)# cable mtc-mode
Related Commands Command Description
cable mrc-mode Enables the Multiple Receive Channel mode (MRC) for a MAC interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-387
Cable Commands: cable m
cable multicast auth enable default-action
cable multicast auth enable default-action
To enable cable multicast authorization profile and set the maximum sessions limit, use the cable
multicast auth enable default-action command in global configuration mode. To disable a cable
multicast authorization profile, use the no form of this command.
cable multicast auth enable default-action {permit | deny} max-sessions [limit]
no cable multicast auth enable
Syntax Description permit Specifies packets to forward.
deny Specifies packets to reject.
limit Specifies the maximum number of dynamic multicast sessions allowed per
CM.
No default value.
Max value allowed is 65535.
Command Default Cable multicast authorization is disabled.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines This command is used to enable cable multicast authorization profile feature and defines the default
value. However, it does not define the actual authorization files.
Examples The following example shows how to enable the default multicast authorization profile:
Router(config)# cable multicast auth enable default-action deny max-sessions 10
Related Commands Command Description
cable multicast Defines the cable multicast authorization profile.
authorization
profile-name
show cable multicast Displays the list of defined multicast authorization profiles and all CMs
authorization associated with corresponding profiles.
Cisco IOS CMTS Cable Command Reference
CBL-388 OL-15510-15
Cable Commands: cable m
cable multicast auth profile-name
cable multicast auth profile-name
To define a cable multicast authorization profile, and to set it as the default profile, use the cable
multicast auth profile-name command in global configuration mode. To disable a cable multicast
authorization profile, use the no form of this command.
cable multicast auth profile-name name [default]
no cable multicast auth profile-name name [default]
Syntax Description name Specifies the name of the authorization profile to be used.
default (Optional) Specifies that the profile name should be treated as the default
profile.
Command Default Cable multicast authorization is disabled.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCB This command was introduced.
12.2(33)SCC The optional default keyword was added.
Usage Guidelines This command defines a cable multicast authorization profile, and optionally sets it as the default profile.
If the default keyword is not used while modifying the profile, the profile is automatically converted to
a non-default profile. Similarly, if the default keyword is added while modifying a profile, the profile is
treated as a default profile.
Examples The following example shows how to use the selected multicast authorization profile:
Router(config)# cable multicast auth profile-name GOLD default
Related Commands Command Description
cable multicast This command enables the cable multicast authorization features. If the
authorization enable multicast authorization feature is disabled, all defined authorization profiles
default-action are ineffective.
match rule This command configures the match rule, rule priority and related action in
the selected cable multicast authorization profile
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-389
Cable Commands: cable m
cable multicast group-encryption
cable multicast group-encryption
To configure a group encryption profile for a multicast group, use the cable multicast group-encryption
command in global configuration mode. To disable a group encryption profile, use the no form of this
command.
cable multicast group-encryption number algorithm 56bit-des
no cable multicast group-encryption number algorithm 56bit-des
Syntax Description number Specifies the number of a specific cable multicast QoS group encryption
profile. The valid range is 1–255.
algorithm 56bit-des Specifies that the data encryption standard (DES) is 56 bits.
Command Default Cable multicast group encryption is disabled.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCA This command was introduced.
Usage Guidelines To apply encryption rules to a cable multicast QoS group, you must first enable and identify an
encryption group.
Examples The following example enables encryption, identifies encryption group 12, and applies the encryption
rule to QoS group 2:
Router(config)# cable multicast group-encryption 12 algorithm 56bit-des
Router(config)# cable multicast qos group 2 priority 7 global
Router(config-mqos)# group-encryption 12
Related Commands Command Description
cable multicast qos Specifies and configures a cable multicast QoS group.
group
show interface bundle Displays multicast session information for a specific virtual cable bundle.
multicast-sessions
show interface cable Displays multicast session information for a specific cable interface.
multicast-sessions
Cisco IOS CMTS Cable Command Reference
CBL-390 OL-15510-15
Cable Commands: cable m
cable multicast group-qos
cable multicast group-qos
To configure a QoS profile for a QoS group, use the cable multicast group-qos command in global
configuration mode. To disable a QoS profile, use the no form of this command.
cable multicast group-qos number scn service-class-name control {single | aggregate
[limit max-sessions]}
no cable multicast group-qos number scn service-class-name control {single | aggregate
[limit max-sessions]}
Syntax Description number Specifies the QoS profile number for the cable multicast QoS group. The
valid range is 1–255. If a multicast group does not match the group QoS
classifiers, a default group-QoS option is applied to the multicast flow.
scn service-class-name Specifies a service class name for the QoS profile.
control Specifies the type of control to the service flow.
single Specifies that a separate service flow is created for each session.
aggregate Specifies that service flows are grouped for sessions in the same multicast
QoS group.
limit max-sessions (Optional) Specifies the Internet Group Management Protocol (IGMP)
session limit for aggregate service flows. The valid range is 1–255.
Command Default The QoS profile for a QoS group is not enabled.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCA This command was introduced.
Usage Guidelines If a QoS profile number is not specified, a default QoS profile is applied. The default group QoS
configuration creates a default multicast service flow for each cable interface that is used when a
multicast session does not match any classifiers of a GC on the interface.
Examples The following example configures QoS profile 5 with a service name of name1 and a control of single
to indicate that a separate service flow is created for each session. QoS profile 5 is then assigned to QoS
group 2.
Router(config)# cable multicast group-qos 5 scn name1 control single
Router(config)# cable multicast qos group 2 priority 7 global
Router(config-mqos)# cable multicast group-qos 5
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-391
Cable Commands: cable m
cable multicast group-qos
Related Commands Command Description
cable multicast qos Specifies and configures a cable multicast QoS group.
group
show interface bundle Displays multicast session information for a specific virtual cable bundle.
multicast-sessions
show interface cable Displays multicast session information for a specific cable interface.
multicast-sessions
Cisco IOS CMTS Cable Command Reference
CBL-392 OL-15510-15
Cable Commands: cable m
cable multicast group-qos default
cable multicast group-qos default
To configure the service class name of the default multicast quality of service (MQoS) for the QoS
profile, use the cable multicast group-qos default command in global configuration mode. To disable
the service class name of the default MQoS for the QoS profile, use the no form of this command.
cable multicast group-qos default scn service-class-name aggregate
no cable multicast group-qos default scn service-class-name aggregate
Syntax Description scn service-class-name Specifies a service class name for the QoS profile.
aggregate Specifies that service flows are grouped for sessions in the same MQoS
group.
Command Default The default MQoS profile is not configured.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC1 This command was introduced.
Usage Guidelines If you configure the service class name with the DOCSIS Setup Gateway (DSG) tunnel when no default
MQoS exists, the configuration is rejected and you are prompted to configure the default MQoS.
The CMTS selects the primary downstream channel to forward the multicast traffic when the default
MQoS is configured and there is no matching MQoS group configuration. Otherwise, the wideband
interface is used to forward the multicast traffic.
Note If you configure or unconfigure the default MQoS while the CMTS is sending multicast traffic, duplicate
traffic is generated for approximately 3 minutes (or 3 times the query interval).
Examples The following example configures the default MQoS profile with the service class name name1.
Router(config)# cable multicast group-qos default scn name1 aggregate
Related Commands Command Description
cable multicast Configures a QoS profile for a QoS group.
group-qos
cable multicast qos Specifies and configures a cable multicast QoS group.
group
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-393
Cable Commands: cable m
cable multicast group-qos default
Command Description
show interface bundle Displays multicast session information for a specific virtual cable bundle.
multicast-sessions
show interface cable Displays multicast session information for a specific cable interface.
multicast-sessions
Cisco IOS CMTS Cable Command Reference
CBL-394 OL-15510-15
Cable Commands: cable m
cable multicast mdf-disable
cable multicast mdf-disable
To disable Multicast DSID-based Forwarding (MDF) capability of all cable modems associated with a
Cisco CMTS router, use the cable multicast mdf-disable command in global configuration mode. To
enable MDF on the cable modem, use the no form of this command.
cable multicast mdf-disable [wb-incapable-cm | dsg]
no cable multicast mdf-disable [wb-incapable-cm | dsg]
Syntax Description wb-incapable-cm (Optional) Disables MDF on all DOCSIS 2.0 hybrid cable modems.
dsg (Optional) Disables MDF capability of all DSG embedded cable modems,
including DOCSIS 3.0 DSG and DOCSIS 2.0 DSG hybrid modems.
Command Default By default, MDF is not always enabled on the cable modem because it is dependent on the cable modem
hardware.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCD3 This command was introduced.
12.2(33)SCE4 The wb-incapable-cm keyword was added.
12.2(33)SCF2 The DSG keyword was added, and behavior of the wb-incapable-cm
keyword was changed to include only non-DSG DOCSIS 2.0 hybrid cable
modems.
Usage Guidelines In Cisco IOS Release 12.2(33)SCE4, the wb-incapable-cm keyword was added to the
cable multicast mdf-disable command to disable MDF on all DOCSIS 2.0 hybrid cable modems,
including DOCSIS 2.0 DSG embedded cable modems. In Cisco IOS Release 12.2(33)SCF2, the
wb-incapable-cm keyword was changed to include only non-DSG DOCSIS 2.0 hybrid cable modems.
After disabling MDF capability, you must run clear cable modem reset command to bring all DSG
embedded cable modems online.
Examples The following example shows how to disable MDF capability on all cable modems:
Router# configure terminal
Router(config)# cable multicast mdf-disable
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-395
Cable Commands: cable m
cable multicast mdf-disable
The following example shows how to disable MDF capability of all non-DSG DOCSIS 2.0 hybrid cable
modems:
Router# configure terminal
Router(config)# cable multicast mdf-disable wb-incapable-cm
The following example shows how to disable MDF capability of all DSG embedded cable modems:
Router# configure terminal
Router(config)# cable multicast mdf-disable dsg
Associated Features The cable multicast mdf-disable command is associated with the following feature:
• DOCSIS 3.0 Multicast Support on the CMTS Routers
Related Commands Command Description
ip multicast-routing Enables multicast routing globally or on a particular virtual routing and
forwarding (VRF) interface.
Cisco IOS CMTS Cable Command Reference
CBL-396 OL-15510-15
Cable Commands: cable m
cable multicast qos group
cable multicast qos group
To specify and configure a cable multicast QoS group and enter multicast QoS configuration mode, use
the cable multicast qos group command in global configuration mode. To disable a cable multicast QoS
group, use the no form of this command.
cable multicast qos group id priority value [global]
no cable multicast qos group id priority value [global]
Syntax Description id Specifies the number of the cable multicast QoS group. The valid range is
1–255.
priority value Specifies the priority of the cable multicast QoS group. The valid range is
from 1 to 255.
Starting with Cisco IOS Release 12.2(33)SCC, the valid range is from 1 to
63 and from 192 to 255. The values from 64 to 191 are used internally by the
Cisco CMTS.
global (Optional) Specifies that the multicast QoS group configuration is applied to
all cable interfaces.
Command Default A cable multicast QoS group is not identified.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCA This command was introduced.
Usage Guidelines You must configure a group QoS profile (cable multicast group-qos) and a group encryption profile
(cable multicast group-encryption) before you configure a cable multicast QoS group.
Examples The following example specifies multicast QoS group 2 with a priority of 6 and global application.
Application ID, group encryption, group QoS, session range, ToS, and VRF options are configured for
QoS group 2.
Router(config)# cable multicast qos group 2 priority 6 global
Router(config-mqos)# application-id 44
Router(config-mqos)# group-encryption 4
Router(config-mqos)# group-qos 3
Router(config-mqos)# session-range 224.10.10.01 255.255.255.254
Router(config-mqos)# tos 1 6 15
Router(config-mqos)# vrf name1
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-397
Cable Commands: cable m
cable multicast qos group
Related Commands Command Description
application-id Specifies an application type to allow admission control to be applied to a
group configuration.
cable multicast Configures a group encryption profile for a multicast group.
group-encryption
cable multicast Configures a group QoS profile for a multicast QoS group.
group-qos
session-range Identifies the multicast QoS group session range.
show interface bundle Displays multicast session information for a specific virtual cable bundle.
multicast-sessions
show interface cable Displays multicast session information for a specific cable interface.
multicast-sessions
tos Sets the type of service (ToS) low byte, high byte, and mask values within a
multicast QoS group.
vrf Specifies the name for a virtual routing and forwarding (VRF) instance.
Cisco IOS CMTS Cable Command Reference
CBL-398 OL-15510-15
Cable Commands: cable m
cable multicast source
cable multicast source
To configure a multicast session range for a PacketCable Multimedia (PCMM) multicast group on a
Cisco CMTS router, use the cable multicast source command in global configuration mode. To disable
this configuration, use the no form of this command.
cable multicast source pcmm
no cable multicast source pcmm
Syntax Description pcmm Specifies the PCMM client and enters the multicast session range
configuration mode.
Command Default None
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCE This command was introduced in Cisco IOS Release 12.2(33)SCE.
Examples The following example shows how to configure a multicast session range for a PCMM multicast group
on a Cisco CMTS router:
Router# configure terminal
Router(config)# cable multicast source pcmm
Router(config-msrc)# session-range 229.0.0.0 255.0.0.0
Related Commands Command Description
show packetcable gate Displays information about the total number of PCMM multicast gates.
multimedia
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-399
Cable Commands: cable m
cable multicast source
Cisco IOS CMTS Cable Command Reference
CBL-400 OL-15510-15
Cable Commands: cable p through cable r
Revised: July 2012, OL-15510-15
New Commands
Command Cisco IOS Software Release
cable rf-bandwidth-percent 12.3(23)BC
cable rcp-control 12.2(33)SCB
cable rcc template 12.2(33)SCB
cable rf-change-dampen-time 12.2(33)SCB
cable rsvp default-scn 12.2(33)SCB
cable rf-change trigger 12.2(33)SCB
cable privacy revocation crl skip-sig-check 12.2(33)SCC
cable privacy revocation enable 12.2(33)SCC
cable privacy revocation ocsp skip-sig-check 12.2(33)SCC
cable privacy revocation skip-cm-cert 12.2(33)SCC
cable privacy revocation timeout 12.2(33)SCC
cable qos pre-registration 12.2(33)SCD2
cable privacy bpi-plus-policy 12.2(33)SCD5
cable rate-limit-algorithm min-plus-excess 12.2(33)SCD5
cable rf-adapt timer 12.2(33)SCF
cable resiliency ds-bonding 12.2(33)SCG
cable queue-limit 12.2(33)SCG
Modified Commands
Command Cisco IOS Software Release
cable rf-bandwidth-percent 12.3(23)BC1
cable rf-channel 12.3(23)BC, 12.3(23)BC1
cable rf-bandwidth-percent 12.2(33)SCB
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-401
Cable Commands: cable p through cable r
Command Cisco IOS Software Release
cable rf-channel 12.2(33)SCB
cable privacy bpi-plus-enforce 12.2(33)SCD5
cable privacy bpi-plus-exclude 12.2(33)SCD5
cable rf-change-trigger 12.2(33)SCE4
Cisco IOS CMTS Cable Command Reference
CBL-402 OL-15510-15
Cable Commands: cable p through cable r
cable power
cable power
To manually power a cable interface line card on or off on a Cisco uBR10012 router, use the cable
power command in privileged EXEC mode.
cable power [on | off] slot/card
Syntax Description on Turns on power to the specified cable interface line card.
off Turns off power to the specified cable interface line card. Power to that
particular card slot remains off until power is turned back on using the
cable power on version of this command.
slot/card Specifies the slot and card number for the desired cable interface card
number. The valid range for slot is 5 to 8 and for card is 0 or 1.
Defaults Cable interface line cards are powered on by default when the card is inserted into the chassis slot.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(4)BC1b This command was introduced for the Cisco uBR10012 router.
12.2(8)BC1 This command is disabled if a working TCC+ card is not present in the
Cisco uBR10012 router.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines This command is typically not used during normal operations, but it can be used for lab, diagnostic, and
troubleshooting purposes. For example, using this command to first power off and then power on a card
is functionally equivalent to performing an online insertion and removal (OIR) of the card.
Be aware of the following points when using this command:
• Using the cable power off command is functionally equivalent to disconnect the cables from the
card’s upstream and downstream connectors and then removing the card from the chassis. When you
use this command to turn off power to a card, the output for the show interface cable command for
that card will display the message “Hardware is not present.”
Note You can also use the LC Power off Status Reg and Line Card Presence Status Reg fields in
the show controllers clock-reference command to determine whether a cable interface line
card is actually present in the chassis and whether it has been powered on or off.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-403
Cable Commands: cable p through cable r
cable power
• Powering off a cable interface line card automatically drops all sessions with the cable modems that
are using that card’s upstreams and downstreams. Do not use this command on a live network unless
this is what you intend.
• All cards are powered on when you upgrade to a new software image for the Cisco uBR10012
router, even if a card had previously been powered off using the cable power off command.
• You can turn power both on and off to a cable interface line card slot, even if a card is not physically
present in the slot.
• This is the only CLI command that actually powers off a card. The hw module reset command
appears to perform a similar function, but it performs only the equivalent of issuing the shutdown
and no shutdown commands on the card.
• When power is turned off for a cable interface line card, the power to that card slot will remain off
until the cable power on command is used to turn the power back on. If you insert a cable interface
card in to a slot that had been previously powered down, you will have to use the cable power on
command to turn on power before being able to use the card.
• This command requires that a working TCC+ card be present because the TCC+ card controls and
monitors the operation of the cable interface line cards. In Cisco IOS Release 12.2(8)BC1 and later,
this command is disabled if a working TCC+ card is not present in the router.
Note The Cisco uBR10012 router requires a working TCC+ card for normal operations. Using the
router without a working TCC+ card is not a supported configuration.
Examples The following example shows how to power off the first cable interface card in a Cisco uBR10012
chassis (card 5, slot 0). It also shows the output from the show interface cable command, with a line
that indicates that the hardware is not present.
router# cable power off 5/0
Line Card 5/0 is POWERED OFF
router# show int c5/0/0
Cable5/0/0 is down, line protocol is down
Hardware is not present
Hardware is UBR10012 CLC, address is 0005.00e0.2f14 (bia 0005.00e0.2f14)
Internet address is 10.20.42.1/24
MTU 1500 bytes, BW 27000 Kbit, DLY 1000 usec,
reliability 255/255, txload 1/255, rxload 1/255
...
router#
Note The show interface cable command will not display output for a card that is not physically present, so
if you can use the show interface cable command but it indicates that the hardware is not present, this
usually means that power to the card has been turned off using the cable power off command.
The following example shows the error message that results when you attempt to power on or off a cable
interface card that is not physically present in the chassis:
router# cable power off 6/1
Line Card 6/1 is not present
router#
Note Power is still turned on or off to a cable interface line card slot, even when the card is not physically
present in that slot.
Cisco IOS CMTS Cable Command Reference
CBL-404 OL-15510-15
Cable Commands: cable p through cable r
cable power
Related Commands Command Description
hw module reset Resets a line card, performing the equivalent of the shutdown, no shutdown
commands.
show controllers Displays status information from the TCC+ card, including whether a line
clock-reference card is physically present and whether power has been turned off to its slot.
show interface cable Displays configuration and status information for a cable interface line card.
show version Displays the basic configuration of the router, including whether an active
TCC+ card is present.
shutdown Disables or enables the interface on a line card.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-405
Cable Commands: cable p through cable r
cable pre-equalization exclude
cable pre-equalization exclude
To exclude a cable modem (CM) from pre-equalization during registration with the Cisco CMTS router,
use the cable pre-equalization exclude command in global configuration mode. To remove exclusion
for the specified cable modem or interface, use the no form of this command.
cable pre-equalization exclude {modem mac-addr | oui id}
no cable pre-equalization exclude {modem mac-addr | oui id}
Syntax Description modem mac-addr Excludes the cable modem with the specified MAC address from
pre-equalization during cable modem registration.
oui id Excludes the specified Organizational Unique Identifier (OUI) from
pre-equalization during cable modem registration.
Command Default Pre-equalization is disabled by default on a Cisco CMTS router, and for cable modems that have a valid
and operational DOCSIS configuration file.
Command Modes Global configuration (config)
Command History Release Modification
12.3(17a)BC This command was introduced to the Cisco uBR10012 router and the Cisco
uBR7246VXR router.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
Usage Guidelines Use the cable pre-equalization exclude command to disable pre-equalization for DOCSIS 1.1 CMs that
claim pre-equalization support but do not properly implement pre-equalization functions.
To enable pre-equalization, use the cable upstream equalization-coefficient interface configuration
command. Pre-equalization starts when a cable modem that supports DOCSIS 1.1 or above sends the
CMTS router a ranging request message indicating that pre-equalization is possible.
The following example of output from the show cable modem verbose command shows which modems
are indicating pre-equalizer support during the DOCSIS registration process. In this example, the first
two modems are capable of pre-equalization support, and the last two modems support DOCSIS 1.0,
which does not support pre-equalization. You do not need to use the cable pre-equalization exclude
command for DOCSIS 1.0 CMs.
Router# show cable modem verbose | include MAC Address|Equalizer
MAC Address : 0019.474a.c4b0
Transmit Equalizer Support : {Taps/Symbol= 1, Num of Taps= 24}
MAC Address : 0019.474a.c498
Transmit Equalizer Support : {Taps/Symbol= 1, Num of Taps= 24}
MAC Address : 0020.40dc.4ce4
Transmit Equalizer Support : {Taps/Symbol= 0, Num of Taps= 0}
MAC Address : 0020.4077.21a0
Cisco IOS CMTS Cable Command Reference
CBL-406 OL-15510-15
Cable Commands: cable p through cable r
cable pre-equalization exclude
Transmit Equalizer Support : {Taps/Symbol= 0, Num of Taps= 0}
Exclusion is supported for a specified DOCSIS 1.1 cable modem, or for a specified OUI value for the
entire interface. Removing the cable pre-equalization exclude configuration returns the cable modem
or interface to normal pre-equalization processes during cable modem registration.
Examples The following example configures pre-equalization to be excluded for the specified cable modem.
Pre-equalization data is not sent for the corresponding cable modem:
Router(config)# cable pre-equalization exclude modem 1111.2222.3333
The following example configures pre-equalization to be excluded for the specified OUI value of the
entire interface. Pre-equalization data is not sent for the corresponding OUI value of the entire interface:
Router(config)# cable pre-equalization exclude oui 00.09.04
The following series of commands configures pre-equalization on the Cisco uBR10012 router with
MC5X20U BPEs. On the PRE Console, configure the following commands.
Router# conf t
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# cable pre-equalization exclude oui 00.09.04
Router(config)# end
Router# show run
Router# show running-config | inc oui
cable pre-equalization exclude oui 00.09.04
Router#
On the line card console for the same Cisco uBR10012 router, verify the configuration with the
following command:
Linecard# show running-config | inc oui
cable pre-equalization exclude oui 00.09.04
The following series of commands configures pre-equalization on the Cisco uBR72436VXR router with
MC28U cable interface line cards. On the Network Processing Engine (NPE) console, configure and
verify with the following commands.
Router# conf t
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# cable pre-equalization exclude oui 00.09.24
Router(config)# end
Router#show run
02:58:10: %SYS-5-CONFIG_I: Configured from console by consolen
Router# show running-config | inc oui
cable pre-equalization exclude oui 00.09.24
On the line card console for the same Cisco uBR7246VXR router, verify the configuration with the
following command:
Linecard# show running-config | inc oui
cable pre-equalization exclude oui 00.09.24
After either of these exclusion methods for pre-equalization are configured, you can verify that all
ranging messages do not include pre-equalization data. Use the following debug commands in global
configuration mode:
• debug cable range
• debug cable interface cx/x/x mac-addr
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-407
Cable Commands: cable p through cable r
cable pre-equalization exclude
Verify the ranging message for the non-excluded cable modems include pre-equalization data, and for
the excluded cable modems, the ranging messages do not include such data.
The following example removes pre-equalization exclusion for the specified OUI and interface. This
results in the cable modem or OUI to return to normal pre-equalization functions. Ranging messages
resume sending pre-equalization data.
Router(config)# no cable pre-equalization exclude {modem mac-addr | oui id}
You can verify removal of this feature using the debug cable interface command.
Related Commands Command Description
debug cable interface Verifies pre-equalization data and configurations.
debug cable range Verifies ranging messages for pre-equalization.
Cisco IOS CMTS Cable Command Reference
CBL-408 OL-15510-15
Cable Commands: cable p through cable r
cable primary-sflow-qos11 keep
cable primary-sflow-qos11 keep
To preserve the traffic counters for primary service flows after a CM that was provisioned for
DOCSIS 1.1 quality of service (QoS) goes offline, use the cable primary-sflow-qos11 keep command
in global configuration mode. To return to the default configuration and reset the counters to zero when
a DOCSIS 1.1-provisioned CM goes offline, use the no form of this command.
cable primary-sflow-qos11 keep {all | snmp-only}
no cable primary-sflow-qos11 keep
Syntax Description all Preserves all primary service flow traffic counters when a DOCSIS 1.1-provisioned CM
goes offline. This includes the counters displayed by CLI commands and counters that are
obtained through SNMP requests.
snmp-only Preserves only the primary service flow traffic counters that are obtained through SNMP
requests. The counters displayed by CLI commands are reset to zero when a DOCSIS
1.1-provisioned CM goes offline.
Command Default Primary service flow traffic counters are not preserved after a DOCSIS 1.1-provisioned CM goes offline
(no cable primary-sflow-qos11 keep). Service-flow information is always preserved for
DOCSIS 1.0-provisioned CMs, regardless of the configuration of this command.
Command Modes Global configuration
Command History Release Modification
12.2(15)CX, This command was introduced.
12.2(15)BC2
Usage Guidelines By default, when a CM that is provisioned for DOCSIS 1.1 quality of service (QoS) service flows goes
offline, the CMTS deletes all service flow information, including traffic counters, that correspond to that
CM. The cable primary-sflow-qos11 keep command preserves the service flow traffic counters after a
DOCSIS 1.1-provisioned CM goes offline and then comes back online. This allows service providers to
track the total usage of CMs over a period of time, regardless of the number of times the CMs go offline
and reboot.
Note This command affects only CMs that are provisioned for DOCSIS 1.1 operations and that are currently
online all cable interfaces on the Cisco CMTS. Information is not preserved for DOCSIS
1.1-provisioned CMs that went offline before this command was given. The service-flow information
for CMs that are provisioned for DOCSIS 1.0 operations is always preserved, regardless of how this
command is configured.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-409
Cable Commands: cable p through cable r
cable primary-sflow-qos11 keep
Examples The following example shows how to preserve both the CLI and SNMP service flow counters when a
DOCSIS 1.1-provisioned CM goes offline:
Router(config)# cable primary-sflow-qos11 keep all
Router(config)#
The following example shows how to preserve only the SNMP-based service flow counters when a
DOCSIS 1.1-provisioned CM goes offline. The CLI-based counters are still reset to zero when this CM
goes offline.
Router(config)# cable primary-sflow-qos11 keep snmp-only
Router(config)#
The following example shows how to disable this command and return to the default behavior, which is
to reset all CLI-based and SNMP-based counters when a DOCSIS 1.1-provisioned CM goes offline.
Router(config)# no cable primary-sflow-qos11 keep
Router(config)#
Related Commands Command Description
cable sflog Enables service flow logging and configures the number and duration
of entries in the log.
show cable modem counters Displays downstream and upstream traffic counters for one or more
CMs.
Cisco IOS CMTS Cable Command Reference
CBL-410 OL-15510-15
Cable Commands: cable p through cable r
cable privacy
cable privacy
To enable and configure BPI or BPI+ encryption, use the cable privacy command in cable interface
configuration mode. To disable privacy or to remove a particular configuration, use the no form of this
command.
cable privacy [accept-self-signed-certificate | authenticate-modem | authorize-multicast |
mandatory | oaep-support | dsx-support | retain-failed-certificates | skip-validity-period]
no cable privacy [accept-self-signed-certificate | authenticate-modem | authorize-multicast |
mandatory | oaep-support | dsx-support | retain-failed-certificates | skip-validity-period]
Syntax Description accept-self-signed-certificate (Optional) Allows cable modems to register using self-signed
manufacturer certificates, as opposed to a manufacturer certificate
that is chained to the DOCSIS root certificate.
authenticate-modem (Optional) Uses AAA protocols in conjunction with BPI to
authenticate all CMs.
authorize-multicast (Optional) Uses AAA protocols with baseline privacy interface (BPI)
to authorize all multicast stream (IGMP) join requests.
mandatory (Optional) Requires baseline privacy be active for all CMs with
BPI/BPI+ enabled in their DOCSIS configuration files or the CMs are
forced to go offline.
If a CM does not have BPI enabled in its DOCSIS configuration file,
it will be allowed online without BPI.
oaep-support (Optional) Enables Optimal Asymmetric Encryption Padding (OAEP)
BPI+ encryption.
dsx-support (Optional) Enables encryption for dynamic services SIDs.
retain-failed-certificates (Optional) Allows to retain failed certificates.
skip-validity-period (Optional) Enables to skip certificate validity period.
Command Default The encryption priority defaults to 128bit AES, 56bit DES, 40bit DES depending on modem capability.
The CMTS treats self-signed manufacturer certificates as untrusted. Untrusted certificates are not
retained by the CMTS.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.1 T This command was introduced.
12.1(4)CX, Added the dsx-support and oaep-support keywords as part of support for BPI+
12.2(1)XF1, encryption.
12.2(4)BC1
12.2(11)BC1 Changed the accept-self-signed-certificate option from a global configuration option
to a cable interface option.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-411
Cable Commands: cable p through cable r
cable privacy
Release Modification
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
12.2(33)SCC This command was modified. Added the retain-failed-certificates and
skip-validity-period keywords. Removed the 40-bit-des keyword.
Usage Guidelines This command is applicable only on images that support BPI or BPI+ encryption.
Note The cable privacy accept-self-signed-certificate command affects only those CMs that register after
you give the command. For example, if you give the no cable privacy accept-self-signed-certificate
command so that CMs cannot register using self-signed certificates, you must then issue the clear cable
modem all reset command to force all CMs reregister using certificates that are chained to the DOCSIS
root certificate.
Providing Self-Signed Certificates
Cisco IOS Release 12.2(33)SCC and later releases allow self-signed CA certificates to be programmed
on the file system to allow specific modems to authenticate. This is frequently used for test equipment
and modems that are not DOCSIS compliant.
To provide self-signed CA certificates, perform the following steps:
1. Acquire the CA certificate in Distinguished Encoding Rules (DER) format. This can be supplied by
the manufacturer or retrieved from the cable modem.
2. Store the self-signed CA certificate in the bootflash by naming it “trusted-cert-scert n”, for example
“trusted-cert-scert1” or “trusted-cert-scert2”.
3. Ensure that cable privacy accept-self-signed-certificate command is not enabled.
4. Save the configuration.
5. Reboot the router.
The router reads the new files and the self-signed cable modem comes online.
Examples The following example shows how to force baseline privacy interface (BPI) to be used for all CMs on a
particular cable interface:
Router(config)# interface cable 3/1
Router(config-if)# cable privacy mandatory
The following example shows how to turn on the BPI modem authentication for an interface:
Router(config)# interface cable 5/1/1
Router(config-if)# cable privacy authenticate-modem
The following example shows how to turn on BPI multicast authorization on a particular cable interface:
Router(config)# interface cable 1/0
Router(config-if) cable privacy authorize-multicast
The following example shows how to allow CMs to register with self-signed certificates on a particular
cable interface:
Router(config)# interface cable 7/1/0
Router(config-if) cable privacy accept-self-signed-certificate
Cisco IOS CMTS Cable Command Reference
CBL-412 OL-15510-15
Cable Commands: cable p through cable r
cable privacy
The following example shows how to allow CMs to enable privacy DSX support on a particular cable
interface:
Router(config)# interface cable 3/1
Router(config-if) cable privacy dsx-support
The following example shows how to allow CMs to enable OAEP support on a particular cable interface:
Router(config)# interface cable 3/1
Router(config-if) cable privacy oaep-support
The following example shows how to allow CMs to retain failed certificates on a particular cable
interface:
Router(config)# interface cable 3/1
Router(config-if) cable privacy retain-failed-certificates
The following example shows how to allow CMs to skip certificate validity period on a particular cable
interface:
Router(config)# interface cable 3/1
Router(config-if) cable privacy skip-vailidity-period
Related Commands Command Description
cable privacy Adds CM certificates for BPI+ encryption.
add-certificate
cable privacy eae-policy Selects Early Authentication and Encryption policy.
cable privacy hotlist Adds a CM certificate to the DOCSIS hotlist so that it is no longer
accepted.
cable privacy kek Sets key encryption keys and timeout periods.
cable privacy tek Sets traffic encryption keys and timeout periods.
show cable privacy Displays information about BPI status and operation.
debug cable privacy Displays debug messages for BPI operation.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-413
Cable Commands: cable p through cable r
cable privacy bpi-plus-enforce
cable privacy bpi-plus-enforce
Note Effective with Cisco IOS Release 12.2(33)SCD5, the cable privacy bpi-plus-enforce command is
replaced with the cable privacy bpi-plus-policy command. For more information, see the
cable privacy bpi-plus-policy command.
To mandate that a cable modem provisioned in DOCSIS 1.1 or higher must register with DOCSIS
Baseline Privacy Interface Plus (BPI+), and not use the earlier DOCSIS BPI, use the
cable privacy bpi-plus-enforce command in global configuration mode. To remove this configuration,
use the no form of this command.
cable privacy bpi-plus-enforce
no cable privacy bpi-plus-enforce
Syntax Description This command has no arguments or keywords.
Command Default The cable privacy bpi-plus-enforce command is not enabled by default, but must be configured for
optimal DOCSIS BPI+ security.
Command Modes Global configuration (config)
Command History Release Modification
12.3(21)BC This command was introduced.
12.2(33)SCD5 This command was replaced with the cable privacy bpi-plus-policy
command.
Usage Guidelines The cable privacy bpi-plus-enforce command enables the Cisco CMTS router to detect cloned cable
modems and eliminate denial-of-service (DOS) attacks that are caused by cloned cable modems.
If the cable modem is not provisioned to use DOCSIS BPI or BPI+ security certificates, then the existing
behavior of the Cisco CMTS router remains unchanged. The Cisco CMTS router does not attempt to
distinguish between two cable modems if neither is provisioned for BPI+ security.
Note The non-DOCSIS compliant cable modems that are commonly available contain an option to force
registration in DOCSIS BPI, as opposed to DOCSIS BPI+ mode, even in DOCSIS 1.1-provisioned
networks.
Examples The following example illustrates logging messages that are created with the detection of cloned cable
modems:
SLOT 7/0: Nov 14 12:07:26: %UBR10000-6-CMMOVED: Cable modem 0007.0e03.3e71 has been moved
from interface Cable7/0/1 to interface Cable7/0/0.
Cisco IOS CMTS Cable Command Reference
CBL-414 OL-15510-15
Cable Commands: cable p through cable r
cable privacy bpi-plus-enforce
Nov 14 12:07:57: %UBR10000-5-CLONED_CM_DETECTED: Cloned CM with MAC address 0013.7116.e726
access detected at Cable7/0/0 interface
Related Commands Command Description
cable logging layer2events Saves selected (low priority) DOCSIS events that are specified in the
Cisco CMTS MIB registry to the cable logging buffer (instead of to
the general logging buffer).
cable privacy bpi-plus-policy Configures the BPI+ enforcement policies on a Cisco CMTS router.
show cable logging Displays the log of messages about bad IP source addresses or
DOCSIS layer events on the cable interfaces.
show cable modem Displays information for registered and non-registered cable
modems on the Cisco CMTS.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-415
Cable Commands: cable p through cable r
cable privacy bpi-plus-exclude
cable privacy bpi-plus-exclude
To exclude cable modems from the Baseline Privacy Interface Plus (BPI+) enforcement policies
configured on a Cisco CMTS router, use the cable privacy bpi-plus-exclude command in global
configuration mode. To disable this configuration, use the no form of this command.
cable privacy bpi-plus-exclude mac-address [address-mask]
no cable privacy bpi-plus-exclude mac-address [address-mask]
Syntax Description mac-address Cable modem MAC address.
address-mask (Optional) Cable modem subnet.
Command Default None
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCD5 This command was introduced.
Usage Guidelines You can exclude individual cable modems, which are compliant with DOCSIS 1.0 and later versions,
from the BPI+ enforcement policy based on their MAC addresses on a per-MAC domain basis. If a cable
modem is added to the exclusion list, the Cisco CMTS router does not enforce the BPI+ enforcement
policy on that cable modem. You can exclude a maximum of 30 cable modems per MAC domain.
Examples The following example shows how to exclude a cable modem from the BPI+ enforcement policy based
on its MAC address:
Router# configure terminal
Router(config)# cable privacy bpi-plus-exclude 0010.9571.03ab
Related Commands Command Description
cable privacy Configures the BPI+ enforcement policy on a Cisco CMTS router.
bpi-plus-policy
show interface cable Displays baseline privacy information.
privacy
Cisco IOS CMTS Cable Command Reference
CBL-416 OL-15510-15
Cable Commands: cable p through cable r
cable privacy bpi-plus-policy
cable privacy bpi-plus-policy
To configure the Baseline Privacy Interface Plus (BPI+) enforcement policies on a Cisco CMTS router,
use the cable privacy bpi-plus-policy command in cable interface configuration mode. To disable this
configuration, use the no form of this command.
cable privacy bpi-plus-policy {capable-enforcement | d11-enabled-enforcement |
d11-enforcement | total-enforcement}
no privacy bpi-plus-policy {capable-enforcement | d11-enabled-enforcement |
d11-enforcement | total-enforcement}
Syntax Description capable-enforcement Specifies that BPI+ enforcement is required on all BPI+ capable cable
modems that are BPI+ enabled and provisioned with DOCSIS1.1
configuration file (Policy 1).
d11-enabled-enforcement Specifies that BPI+ enforcement is required on all cable modems that
register with a DOCSIS 1.1 configuration file with parameters indicating
BPI+ is enabled with or without TLV 29 (Policy 2).
d11-enforcement Specifies that BPI+ enforcement is required on all cable modems that are
compliant with DOCSIS 1.1 and later versions (Policy 3).
total-enforcement Specifies that BPI+ enforcement is required on all cable modems
(Policy 4).
Command Default None
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCD5 This command was introduced.
Usage Guidelines The cable privacy bpi-plus-policy command replaced the cable privacy bpi-plus-enforce command
in Cisco IOS Relase12.2(33)SCD5. If you upgrade from an earlier Cisco IOS Release to
Cisco IOS Release 12.2(33)SCD5 and later, the existing BPI+ enforcement configuration is disabled by
default during the upgrade. You must reconfigure the BPI+ enforcement policy using the cable privacy
bpi-plus-policy command.
You can configure only one enforcement policy at a time per MAC domain. If you configure one policy
after another, the latest policy supersedes the already existing policy. For example, if you want Policy 2
to take over Policy 1, you can directly configure the former without disabling the latter.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-417
Cable Commands: cable p through cable r
cable privacy bpi-plus-policy
Examples The following example shows how to configure BPI+ enforcement policies on the cable interface 3/0 on
the Cisco uBR7246VXR router:
Router# configure terminal
Router(config)# interface cable 3/0
Router(config-if)# cable privacy bpi-plus-policy capable-enforcement
Router(config-if)# cable privacy bpi-plus-policy d11-enabled-enforcement
Router(config-if)# cable privacy bpi-plus-policy d11-enforcement
Router(config-if)# cable privacy bpi-plus-policy total-enforcement
Related Commands Command Description
cable privacy Excludes individual cable modems from BPI+ enforcement policies based
bpi-plus-exclude on their MAC addresses.
show interface cable Displays baseline privacy information.
privacy
Cisco IOS CMTS Cable Command Reference
CBL-418 OL-15510-15
Cable Commands: cable p through cable r
cable privacy clone-detect
cable privacy clone-detect
To enable the clone modem functionality for a cable modem, use the cable privacy clone-detect
command in global configuration mode. To disable clone modem functionality, use the no form of this
command.
cable privacy clone-detect
no cable privacy clone-detect
Syntax Description This command has no keywords or arguments.
Command Default The clone modem functionality is enabled.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines Use this command to enable or disable the clone modem functionality.
Examples The following example shows how to enable the clone modem functionality, so that the cloned cable
modems cannot register with the CMTS:
Router# configure terminal
Router(config)# cable privacy clone-detect
Related Commands Command Description
cable privacy Enables and configures BPI+ encryption on a cable interface.
cable privacy Specifies that a cable modem provisioned in DOCSIS 1.1 or higher
bpi-plus-enforce must register with DOCSIS BPI+, and not use the earlier DOCSIS BPI.
cable logging layer2events Saves selected (low priority) DOCSIS events that are specified in the
Cisco CMTS MIB registry to the cable logging buffer (not of the
general logging buffer).
show cable logging Displays the log of messages, about bad IP source addresses or
DOCSIS-layer events, on the cable interfaces.
show cable modem Displays information for registered and non-registered cable modems
on the Cisco CMTS.
show running-config Displays the bundles that are configured on a Cisco CMTS router
interface cable showing the running configuration for each of the cable interfaces.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-419
Cable Commands: cable p through cable r
cable privacy eae-exclude
cable privacy eae-exclude
To force a cable modem to register without an Early Authentication and Encryption (EAE) and add it to
the EAE exclusion list, use the cable privacy eae-exclude command in global configuration mode. To
remove a particular CM from the exclusion list, use the no form of this command.
cable privacy eae-exclude cm-mac-address [mask]
no cable privacy eae-exclude cm-mac-address [mask]
Syntax Description cm-mac-address Hardware (MAC) address of a specific cable modem to be added to the EAE
exclusion list.
mask (Optional) Mask value for the cable modem.
Command Default The EAE exclusion list does not contain any MAC address.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines The exclusion list is mainly used to debug issues with specific cable modems.
Examples The following example shows how to add a CM with the MAC address of 00C0.8345.de51 to the EAE
exclusion list, so that this particular CM cannot register with the CMTS:
Router# configure terminal
Router(config)# cable privacy eae-exclude 00C0.8345.de51
Router(config)#
Related Commands Command Description
cable privacy Enables and configures BPI+ encryption on a cable interface.
cable privacy kek Sets key encryption keys and timeout periods.
cable privacy tek Sets traffic encryption keys and timeout periods.
show cable privacy Displays information about BPI status and operation.
Cisco IOS CMTS Cable Command Reference
CBL-420 OL-15510-15
Cable Commands: cable p through cable r
cable privacy eae-policy
cable privacy eae-policy
To enable the Early Authentication and Encryption (EAE) policy, use the cable privacy eae-policy
command in cable interface configuration mode. To disable the EAE policy, use the no form of this
command.
cable privacy eae-policy {capability-enforcement | disable-enforcement | ranging-enforcement
| total-enforcement}
no cable privacy eae-policy {capability-enforcement | disable-enforcement |
ranging-enforcement | total-enforcement}
Syntax Description capability-enforcement Enforces EAE on capable modems.
disable-enforcement Disables EAE thereby preventing the CMTS from enforcing EAE on
any cable modem.
ranging-enforcement Enforces EAE only on DOCSIS 3.0 modems.
total-enforcement Enforces EAE on all cable modems.
Command Default EAE policy is disabled.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines The EAE policy is applied on a MAC domain and the policies are mutually exclusive. The CMTS
enforces EAE only on CMs that initialize on a downstream channel on which the CMTS is transmitting
MAC Domain Descriptor (MDD) messages.
The EAE exclusion list is a global list and is created on all line cards as part of the DOCSIS 3.0
specifications. Cable modems in the EAE exclusion list are always exempted from EAE enforcement. If
the CMTS receives an authorization request before the CM is registered in the EAE exclusion list, the
CMTS rejects that request.
Examples The following example shows how to enforce EAE policy on capable modems:
Router(config)# interface cable 3/1
Router(config-if)# cable privacy eae-policy capability-enforcement
The following example shows how to disable EAE policy so that the CMTS does not enforce EAE policy
on any cable modem:
Router(config)# interface cable 3/1
Router(config-if)# cable privacy eae-policy disable-enforcement
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-421
Cable Commands: cable p through cable r
cable privacy eae-policy
The following example shows how to enforce EAE policy on DOCSIS 3.0 modems only:
Router(config)# interface cable 3/1
Router(config-if) cable privacy eae-policy ranging-enforcement
The following example shows how to enforce EAE policy on all cable modems:
Router(config)# interface cable 3/1
Router(config-if) cable privacy eae-policy total-enforcement
Related Commands Command Description
cable privacy hotlist Adds a CM certificate to the DOCSIS hotlist so that it is no longer
accepted.
cable privacy kek Sets Key Encryption Keys and timeout periods.
cable privacy tek Sets Traffic Encryption Keys and timeout periods.
show cable privacy Displays information about BPI status and operation.
Cisco IOS CMTS Cable Command Reference
CBL-422 OL-15510-15
Cable Commands: cable p through cable r
cable privacy encrypt-alg-priority
cable privacy encrypt-alg-priority
To specify the order in which to use the Advanced Encryption Standard (AES) and Data Encryption
Standard (DES) encryption algorithm, use the cable privacy encrypt-alg-priority command in global
configuration mode. To remove the encryption algorithm and revert to the default priority, use the no
form of this command.
cable privacy encrypt-alg-priority {aes128-des40-des56 | aes128-des56-des40 |
des40-aes128-des56 | des40-des56-aes128 | des56-aes128-des40 | des56-des40-aes128}
no cable privacy encrypt-alg-priority
Syntax Description aes128-des40-des56 Specifies the order of the encryption algorithm priority.
AES with a 128-bit block is given the highest priority, followed by DES with
40-bit block size, and DES with 56-bit block size.
aes128-des56-des40 Specifies the order of the encryption algorithm priority.
AES with a 128-bit block size is given the highest priority, followed by DES
with 56-bit block size, DES with 40-bit block size.
des40-aes128-des56 Specifies the order of the encryption algorithm priority.
DES with 40-bit block size is given the highest priority, followed by AES with
a 128-bit block size, and DES with 56-bit block size.
des40-des56-aes128 Specifies the order of the encryption algorithm priority.
DES with 40-bit block size is given the highest priority, followed by DES with
56-bit block size and AES with 128-bit block size.
des56-aes128-des40 Specifies the order of the encryption algorithm priority.
DES with 56-bit block size is given the highest priority, followed by AES with
a 128-bit block size, and DES with 40-bit block size.
des56-des40-aes128 Specifies the order of the encryption algorithm priority.
DES with 56-bit block size is given the highest priority, followed by DES with
40-bit block size, and AES with a 128-bit block size.
Command Default Default value is aes128-des56-des40.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines Use this command to specify the order of the encryption algorithm priority.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-423
Cable Commands: cable p through cable r
cable privacy encrypt-alg-priority
Examples The following example shows how to assign AES the highest priority, followed by 40-bit DES, and
56-bit DES.
Router# configure terminal
Router(config)# cable privacy encrypt-alg-priority aes128-des40-des56
Router(config)#
Related Commands Command Description
cable privacy Enables and configures BPI+ encryption on a cable interface.
cable privacy kek Sets Key Encryption Keys and timeout periods.
cable privacy tek Sets Traffic Encryption Keys and timeout periods.
show cable privacy Displays information about BPI status and operation.
Cisco IOS CMTS Cable Command Reference
CBL-424 OL-15510-15
Cable Commands: cable p through cable r
cable privacy hotlist
cable privacy hotlist
To mark a manufacturer’s or CM certificate as untrusted and add them to the CMTS hotlist of invalid
certificates, thereby preventing those CMs from registering, use the cable privacy hotlist command in
global configuration mode. To remove a particular CM or manufacturer’s certificate from the hotlist, use
the no form of this command.
cable privacy hotlist {cm mac-address | manufacturer cert-serial-number}
no cable privacy hotlist {cm mac-address | manufacturer cert-serial-number}
Syntax Description cm mac-address Specifies the MAC address for the CM to be added to the hotlist. The mac-address
should be specified as a hexadecimal string, without periods or other separators.
In Cisco IOS Release 12.2(15)BC2 and later releases, you can also specify it as
three sets of hexadecimal digits, separated by periods.
manufacturer Specifies the serial number for the particular manufacturer CA certificate. The
cert-serial-number cert-serial-number should be specified as a hexadecimal string up to 32 bytes in
length. Enter multiple lines as needed, and use a blank line to terminate the string.
Command Default The CMTS hotlist does not contain any certificates.
Command Modes Global configuration
Command History Release Modification
12.1(7)CX, This command was introduced for the Cisco uBR7100 series and Cisco uBR7200
12.2(1)XF1, series routers.
12.2(4)BC1
12.2(11)BC1 The accept-self-signed-certificate option was moved to the cable privacy cable
interface command.
12.2(15)BC2 The mac-address can be specified in the canonical form of three pairs of
hexadecimal digits, separated by periods (for example, 0000.0001.0002).
12.2(33)SCB5 This command was integrated into the 12.2SC release train.
Usage Guidelines This command is applicable only on images that support BPI or BPI+ encryption.
Note The cable privacy hotlist command is not supported on the Cisco uBR10012 router running Cisco IOS
releases prior to Cisco IOS release 12.3(23)BC9, Cisco IOS release 12.2(33)SCB5, and Cisco IOS
release12.2(33)SCC. To add a manufacturer’s or CM certificate to the hotlist on the Cisco uBR10012
router, use SNMP commands to set the appropriate attributes in DOCS-BPI-PLUS-MIB. For more
information, see the DOCSIS 1.1 for the Cisco CMTS Routers.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-425
Cable Commands: cable p through cable r
cable privacy hotlist
Examples The following command adds the CM certificate with the MAC address of 00C0.8345.de51 to the hotlist,
so that this particular CM cannot register with the CMTS:
Router# config t
Router(config)# cable privacy hotlist cm 00C08345de51
Router(config)#
The following example adds a manufacturer CA certificate into the BPI+ hotlist, so that the CMTS will
reject any CM attempting to register with a certificate from that particular manufacturer:
Router# config t
Router(config)# cable privacy hotlist manufacturer
3435414631413439383335453731423733333643
Associated Features The cable privacy hotlist command is used to configure the following features:
• DOCSIS 1.1 for the Cisco CMTS Routers
Related Commands Command Description
cable privacy Enables and configures BPI+ encryption on a cable interface.
cable privacy Adds CM certificates for BPI+ encryption.
add-certificate
option Determines whether a specific CM is online.
cable privacy kek Sets key encryption keys and timeout periods.
cable privacy tek Sets traffic encryption keys and timeout periods.
show cable privacy Displays information about BPI status and operation.
debug cable privacy Displays debug messages for BPI operation.
Cisco IOS CMTS Cable Command Reference
CBL-426 OL-15510-15
Cable Commands: cable p through cable r
cable privacy kek
cable privacy kek
To set key encryption keys (KEKs) life-time values for baseline privacy on an HFC network, use the
cable privacy kek command in cable interface configuration mode. To restore the default values, use
the no form of this command.
cable privacy kek life-time [seconds]
no cable privacy kek life-time
Note This command is applicable only on images that support BPI or BPI+ encryption.
Syntax Description life-time seconds (Optional) Length of the key encryption life-time in seconds.Valid range is 300
to 604,8000. The default is 604,800 seconds (7 days).
Command Default The life-time option to 604,800 seconds (7 days).
Command Modes Interface configuration only (config-if)
Command History Release Modification
11.3 XA This command was introduced.
12.1(4)CX, The valid range for both options was changed to support DOCSIS 1.1 and BPI+
12.2(1)XF1, encryption.
12.2(4)BC1
Usage Guidelines Baseline privacy on an HFC network is configured with key encryption keys (KEKs) and traffic
encryption keys (TEKs). The encryption is based on 40-bit or 56-bit data encryption standard (DES)
encryption algorithms.
A KEK is assigned to a CM based on the CM service identifier (SID) and permits the CM to connect to
the Cisco CMTS when baseline privacy is activated. KEKs can be set to expire based a life-time value.
The life-time keyword is used to assign a more permanent key to a CM.
A CM that has a life-time key assigned by the Cisco CMTS requests a new key before the current one
expires.
Examples The following example shows how to set the KEK privacy life-time to 750,000 seconds:
Router(config)# interface cable c3/0
Router(config-if)# cable privacy kek life-time 750000
Router(config-if)#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-427
Cable Commands: cable p through cable r
cable privacy kek
Related Commands Command Description
cable privacy add-certificate Configures certificates for BPI+ encryption.
cable privacy Enables and configures BPI+ encryption on a cable interface.
cable privacy tek Sets traffic encryption keys and timeout periods.
option Determines whether a specific CM is online.
privacy Configures the BPI or BPI+ configuration parameters in a DOCSIS
configuration file.
show cable privacy Displays information about BPI status and operation.
show interface cable privacy Displays the current values of the KEK and TEK timers for an
interface.
debug cable privacy Displays debug messages for BPI operation.
Cisco IOS CMTS Cable Command Reference
CBL-428 OL-15510-15
Cable Commands: cable p through cable r
cable privacy revocation crl skip-sig-check
cable privacy revocation crl skip-sig-check
To allow the Cisco CMTS router to skip the certification revocation list (CRL) response signature check,
use the cable privacy revocation crl skip-sig-check command in global configuration mode. To enable
CRL signature check, use the no form of this command.
cable privacy revocation crl skip-sig-check
no cable privacy revocation crl skip-sig-check
Syntax Description This command has no keywords or arguments.
Command Default The CRL response signature check is enabled by default.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines The cable privacy revocation crl skip-sig-check command allows you to use the CRL response from
the CRL server without validating the signature of the response.
Examples The following example shows how to skip the CRL response signature check:
Router(config)# cable privacy revocation crl skip-sig-check
Related Commands Command Description
cable privacy revocation Allows to skip the OCSP response signature check.
ocsp skip-sig-check
cable privacy revocation Allows to disable checking of the CM certificates.
skip-cm-cert
cable privacy revocation Sets the timeout value of CRL or OCSP response time.
timeout
cable privacy revocation Allows to quickly enable privacy revocation checking.
enable
show cable privacy Displays information about BPI status and operation.
debug cable privacy Displays debug messages for BPI operation.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-429
Cable Commands: cable p through cable r
cable privacy revocation enable
cable privacy revocation enable
To quickly enable privacy revocation checking, use the cable privacy revocation enable command in
global configuration mode. To disable privacy revocation checking, use the no form of this command.
cable privacy revocation enable
no cable privacy revocation enable
Syntax Description This command has no keywords or arguments.
Command Default The privacy revocation checking is disabled by default.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines This command allows you to quickly enable or disable revocation checking. When you enable
revocation checking, it creates the trustpoints for both the EU and US certificates.
Examples The following example shows how to enable revocation checking:
Router(config)# cable privacy revocation enable
Related Commands Command Description
cable privacy revocation Allows to skip the OCSP response signature check.
ocsp skip-sig-check
cable privacy revocation Allows to disable checking of the CM certificates.
skip-cm-cert
cable privacy revocation Sets the timeout value of CRL or OCSP response time.
timeout
show cable privacy Displays information about BPI status and operation.
debug cable privacy Displays debug messages for BPI operation.
Cisco IOS CMTS Cable Command Reference
CBL-430 OL-15510-15
Cable Commands: cable p through cable r
cable privacy revocation ocsp skip-sig-check
cable privacy revocation ocsp skip-sig-check
To allow the Cisco CMTS router to skip the Online Certificate Status Protocol (OCSP) response
signature check, use the cable privacy revocation ocsp skip-sig-check command in global
configuration mode. To enable OCSP signature check, use the no form of this command.
cable privacy revocation ocsp skip-sig-check
no cable privacy revocation ocsp skip-sig-check
Syntax Description This command has no keywords or arguments.
Command Default OCSP response signature check is enabled by default.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines The cable privacy revocation ocsp skip-sig-check command allows you to use the OCSP response
from the OCSP responder without validating the signature of the response.
Examples The following example shows how to skip the OCSP response signature check:
Router(config)# cable privacy revocation ocsp skip-sig-check
Related Commands Command Description
cable privacy revocation Allows to quickly enable privacy revocation checking.
enable
cable privacy revocation Allows to disable checking of the CM certificates.
skip-cm-cert
cable privacy revocation Sets the timeout value of CRL or OCSP response time.
timeout
show cable privacy Displays information about BPI status and operation.
debug cable privacy Displays debug messages for BPI operation.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-431
Cable Commands: cable p through cable r
cable privacy revocation skip-cm-cert
cable privacy revocation skip-cm-cert
To disable checking of the CM certificates, use the cable privacy revocation skip-cm-cert command
in global configuration mode. To enable checking of CM certificates, use the no form of this command.
cable privacy revocation skip-cm-cert
no cable privacy revocation skip-cm-cert
Syntax Description This command has no keywords or arguments.
Command Default CM certificate checking is enabled by default.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines The cable privacy revocation skip-cm-cert command allows you to disable checking of CM
certificates.
Note Checking CM certificates requires a lot of processing power, which impacts the router performance.
Examples The following example shows how to disable checking of CM certificates:
Router(config)# cable privacy revocation skip-cm-cert
Related Commands Command Description
cable privacy revocation Allows to quickly enable privacy revocation checking.
enable
cable privacy revocation Allows to skip the OCSP response signature check.
ocsp skip-sig-check
cable privacy revocation Sets the timeout value of CRL or OCSP response time.
timeout
show cable privacy Displays information about BPI status and operation.
debug cable privacy Displays debug messages for BPI operation.
Cisco IOS CMTS Cable Command Reference
CBL-432 OL-15510-15
Cable Commands: cable p through cable r
cable privacy tek
cable privacy tek
To set traffic encryption keys (TEKs) life-time values for baseline privacy on an HFC network, use the
cable privacy tek command in cable interface configuration mode. To restore the default value, use the
no form of this command.
cable privacy tek life-time [seconds]
no cable privacy tek life-time
Note This command is applicable only on images that support BPI or BPI+ encryption.
Syntax Description life-time seconds (Optional) Length of the traffic encryption life-time in seconds. Valid range is
180 to 604,8000. Default is 43,200 seconds (12 hours).
Command Default The life-time option to 43200 seconds (12 hours).
Command Modes Interface configuration only (config-if)
Command History Release Modification
11.3 XA This command was introduced.
12.1(4)CX, The valid range for both options was changed to support DOCSIS 1.1 and BPI+
12.2(1)XF1, encryption.
12.2(4)BC1
Usage Guidelines Baseline privacy on an HFC network is configured with key encryption keys (KEKs) and traffic
encryption keys (TEKs). The encryption is based on 40-bit or 56-bit data encryption standard (DES)
encryption algorithms.
The TEK is assigned to a CM when its KEK has been established. The TEK is used to encrypt data traffic
between the CM and the Cisco CMTS. TEKs can be set to expire based a life-time value.
The life-time keyword is used to assign a more permanent key to a CM.
A CM that has a life-time key assigned by the Cisco CMTS requests a new key before the current one
expires.
Examples The following example shows how to set the traffic encryption key life-time to 800000 seconds:
Router(config)# interface cable c3/0
Router(config-if)# cable privacy tek life-time 800000
Router(config-if)#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-433
Cable Commands: cable p through cable r
cable privacy tek
Related Commands Command Description
cable privacy add-certificate Configures certificates for BPI+ encryption.
cable privacy Enables and configures BPI+ encryption on a cable interface.
cable privacy kek Sets key encryption keys and timeout periods.
option Determines whether a specific CM is online.
privacy Configures the BPI or BPI+ configuration parameters in a DOCSIS
configuration file.
show cable privacy Displays information about BPI status and operation.
show interface cable privacy Displays the current values of the KEK and TEK timers for an
interface.
debug cable privacy Displays debug messages for BPI operation.
Cisco IOS CMTS Cable Command Reference
CBL-434 OL-15510-15
Cable Commands: cable p through cable r
cable privacy revocation timeout
cable privacy revocation timeout
To set the timeout value of certification revocation list (CRL) or Online Certificate Status Protocol
(OCSP) response time for authorization “reply” or “reject” messages, use the cable privacy revocation
timeout command in global configuration mode. To return to the default timeout value, use the no form
of this command.
cable privacy revocation timeout
no cable privacy revocation timeout
Syntax Description This command has no keywords or arguments.
Command Default Default timeout value is 1 second.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines This command only takes effect if cable privacy revocation enable command is configured. The
timeout value for authorization “reply” or “reject” messages in the CM configuration file must be greater
than the revocation timeout value.
Examples The following example shows how to set the timeout value for CRL or OCSP response:
Router(config)# cable privacy revocation timeout 15
Related Commands Command Description
cable privacy revocation Allows to quickly enable privacy revocation checking.
enable
cable privacy revocation Allows to skip the OCSP response signature check.
ocsp skip-sig-check
cable privacy revocation Allows to disable checking of the CM certificates.
skip-cm-cert
show cable privacy Displays information about BPI status and operation.
debug cable privacy Displays debug messages for BPI operation.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-435
Cable Commands: cable p through cable r
cable proxy-arp
cable proxy-arp
To activate cable proxy Address Resolution Protocol (ARP) on the cable interface or subinterface, use
the cable proxy-arp command in cable interface or subinterface configuration mode. To disable this
feature, use the no form of this command.
cable proxy-arp
no cable proxy-arp
Syntax Description This command has no arguments or keywords.
Command Default Proxy APR service is enabled.
Command Modes Cable interface and subinterface configuration
Command History Release Modification
11.3 XA This command was introduced.
12.1(3a)EC The subinterface support was added.
Usage Guidelines This command enables or disables direct host-to-host communications over the same cable subnet.
Because the downstream and upstream are separate interfaces, CMs cannot directly perform address
resolution with other CMs on the cable plant. This means that the CMs must send all traffic through the
CMTS, even if the destination CM is on the same subnet.
The cable proxy-arp command enables the Cisco CMTS to act as a proxy for ARP requests generated
by the CMs, which allows CMs on the same cable subnet to communicate directly which each other,
without the traffic having to be routed first through the CMTS. The no cable proxy-arp command
disables this feature, preventing CMs on the same subnet from communicating with each other without
routing the traffic through the CMTS.
Note Using the no cable arp and no cable proxy-arp commands shifts all responsibility for the management
of the IP addresses used by CMs and CPE devices to the DHCP server and provisioning system.
Examples The following example shows how to activate proxy ARP for host-to-host communications:
Router(config-subif)# cable proxy-arp
The following example shows how to activate proxy ARP for host-to-host communications, on the cable
subinterface:
Router(config)# interface cable 6/0.1
Router(config-subif)# cable proxy-arp
Cisco IOS CMTS Cable Command Reference
CBL-436 OL-15510-15
Cable Commands: cable p through cable r
cable proxy-arp
Related Commands Command Description
cable arp Activates cable Address Resolution Protocol (ARP).
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-437
Cable Commands: cable p through cable r
cable qos enforce-rule
cable qos enforce-rule
To create an enforce-rule to enforce a particular quality of service (QoS) profile for subscriber traffic
management, and to enter enforce-rule configuration mode, use the cable qos enforce-rule command in
global configuration mode. To delete an enforce-rule and to remove it from the CMTS configuration,
use the no form of this command.
cable qos enforce-rule rule-name
no cable qos enforce-rule rule-name
Syntax Description rule-name Name of the enforce-rule to be created and configured. This name can be any arbitrary and
unique string from 1 to 15 characters in length.
Command Default No enforce-rules are created.
Command Modes Global configuration (config)
Command History Release Modification
12.2(15)BC1 This command was introduced.
12.3(9a)BC This command was integrated into Cisco IOS Release 12.3(9a)BC. This command
replaces the cable qos monitoring command.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
Usage Guidelines The cable qos enforce-rule command creates an enforce-rule with the specified name and then enters
enforce-rule configuration mode. After entering enforce-rule configuration mode, use the following
commands to configure the enforce-rule:
• activate-rule at-byte-count
• enabled (enforce-rule)
• enforced qos-profile
• monitoring-duration
• penalty-period
• registered qos-profile
At the very minimum, you must use the activate-rule at-byte-count and registered qos-profile
commands to configure an enforce-rule, and the enabled command to activate it, before it takes effect.
Note Effective with Cisco IOS Release 12.3(9a)BC, the activate-rule at-byte-count command is not
available in Cisco IOS software.
Cisco IOS CMTS Cable Command Reference
CBL-438 OL-15510-15
Cable Commands: cable p through cable r
cable qos enforce-rule
Maximum Number of Rules
The Cisco CMTS routers support a certain maximum number of enforce-rules depending on your Cisco
IOS software release. If you have created the maximum number of enforce-rules and want to create
another rule, you must first delete one of the existing rules.
• Cisco IOS Release 12.2(15)BC1 and later—Supports a maximum of 20 enforce-rules.
• Beginning in Cisco IOS Release 12.3(23)BC2—Supports a maximum of 40 enforce-rules.
Note The maximum number of enforce-rules is counted as the total number of rules created on both the
upstreams and downstreams combined.
Examples The following example shows the creation of an enforce-rule named “residential.” The system then
enters the enforce-rule configuration mode.
Router# configure terminal
Router(config)# cable qos enforce-rule residential
Router(enforce-rule)# ?
Configuration commands for QoS enforce rules:
activate-rule Activate rule parameters
enabled Enable the enforce-rule
enforced Enforced qos-profile
exit Exit from QoS enforce rule editing mode
monitoring-duration Monitoring duration parameters
no Negate a command or set its defaults
penalty-period Penalty-period
registered Registered qos-profile
Router(enforce-rule)# activate-rule at-byte-count 50000000 downstream enforced
Router(enforce-rule)# registered qos-profile 5
Router(enforce-rule)# enforced qos-profile 99
Router(enforce-rule)# monitoring-duration 120 sample-rate 20
Router(enforce-rule)# penalty-period 1440
Router(enforce-rule)# enabled
Router(enforce-rule)# exit
Router(config)# exit
The following example shows the deletion of an enforce-rule named “test”:
Router# configure terminal
Router(config)# no cable qos enforce-rule test
The following example shows the error message that is displayed if you try to create more than 20
enforce-rules in Cisco IOS Release 12.3(23)BC1 and earlier:
Router# configure terminal
Router(config)# cable qos enforce-rule residential
Can't create more enforce-rules. The maximum number is 20.
The following example shows the error message that is displayed when you try to name an enforce-rule
with a name that is larger than 15 characters. An error message is displayed, and the name is truncated
to the first 15 characters.
Router# configure terminal
Router(config)# cable qos enforce-rule reallyreallyreallylongname
Only the first 15 characters would be taken
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-439
Cable Commands: cable p through cable r
cable qos enforce-rule
Related Commands Command Description
activate-rule at-byte-count Specifies the number of bytes that a subscriber can transmit
during the monitoring period.
debug cable subscriber-monitoring Displays enforce-rule debug messages for subscriber traffic
management on the Cisco CMTS routers.
enabled (enforce-rule) Activates an enforce-rule and begins subscriber traffic
management on a Cisco CMTS router.
duration Specifies the time period and sample rate to be used for
monitoring subscribers.
penalty-period Specifies the time period that an enforced QoS profile should
be in effect for subscribers that violate their registered QoS
profiles.
qos-profile enforced Specifies a QoS profile that should be enforced when users
violate their registered QoS profiles.
qos-profile registered Specifies the registered QoS profile that should be used for this
enforce-rule.
show cable qos enforce-rule Displays the QoS enforce-rules that are currently defined.
show cable subscriber-usage Displays subscribers who are violating their registered QoS
profiles.
Cisco IOS CMTS Cable Command Reference
CBL-440 OL-15510-15
Cable Commands: cable p through cable r
cable qos permission
cable qos permission
To specify permission for updating the quality of service (QoS) table, use the cable qos permission
command in global configuration mode. To remove a previously enabled permission, use the no form of
this command.
cable qos permission {create | enforce index | modems | update}
no cable qos permission
Syntax Description create Permits creation of QoS table entries by Simple Network Management Protocol
(SNMP).
enforce The enforce keyword overrides the provisioned QoS profile of the CM and enforces a
index specific CMTS-local QoS profile. The index argument specifies the number of the QoS
profile to be enforced on all CMs connecting to the CMTS. Valid values are from 1 to
255.
Note Both the originally provisioned QoS profile and the enforced QoS profile must
be created on the Cisco CMTS. This option does not support profiles that are
created by the CM.
modems Permits creation of QoS table entries by modem registration requests.
update Permits dynamic update of QoS table entries by SNMP.
Command Default Enable by modem and SNMP
Command Modes Global configuration
Command History Release Modification
11.3 NA This command was introduced.
11.3(9)NA The enforce keyword was added.
12.1(4)CX This command was deprecated for DOCSIS 1.1 use, because DOCSIS 1.1 replaces the
QoS profile model with a service flow model.
Usage Guidelines If the QoS profile to be enforced does not exist at the CMTS during registration, the CMTS uses the QoS
profile configured for the registering CM.
If you disable the use of CM-created profiles, using the no cable qos permission command, any CMs
using such a profile go offline immediately and the CM-created profiles are removed.
This no cable qos permission command is similar to the docsIfCmtsQosProfilePermissions attribute in
the DOCS-IF-MIB, as both prohibit CMs from creating their own QoS profiles in the future. However,
the no cable qos permission command also immediately deletes QoS profiles that have been created by
the cable modems and takes those modems offline. The docsIfCmtsQosProfilePermissions method does
not affect QoS profiles that are currently in use, but only unused profiles and profiles that are created in
the future.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-441
Cable Commands: cable p through cable r
cable qos permission
Examples The following example shows how to enable CMs to request arbitrary QoS parameters:
Router(config)# cable qos permission modems
The following example shows how a CM with a QoS profile 4 created by the CM is reset to use QoS
profile 225 enforced by the cable router (management):
CMTS01# show cable modem
Interface SID Online Timing Receive QoS IP address MAC address
State Offset Power
Cable6/0/U0 1 online 2848 0.00 4 19.2.20.139 0010.7b6b.7215
CMTS01# show cable qos profile 4
Service Prio Max Guarantee Max Max tx TOS TOS Create B
class upstream upstream downstream burst mask value by priv
bandwidth bandwidth bandwidth enab
4 7 128000 64000 2048000 255 0x0 0x0 cm no
CMTS01(config)# cable qos profile 225 max-upstream 256
CMTS01(config)# cable qos permission enforce 225
CMTS01# clear cable modem all reset
CMTS01# show cable modem
Interface SID Online Timing Receive QoS IP address MACaddress
State Offset Power
Cable6/0/U0 1 offline 2848 0.25 2 19.2.20.139 0010.7b6b.7215
CMTS01# debug cable reg
....
00:15:59: Finished parsing REG Request
00:15:59: Overriding Provisioned QoS Parameters In REG-REQ
....
CMTS01# show cable modem
Interface SID Online Timing Receive QoS IP address MACaddress
State Offset Power
Cable6/0/U0 1 online 2852 0.00 225 19.2.20.139 0010.7b6b.7215
CMTS01# show cable qos profile 225
Service Prio Max Guarantee Max Max tx TOS TOS Create B
class upstream upstream downstream burst mask value by priv
bandwidth bandwidth bandwidth enab
225 0 256000 0 0 0 0x0 0x0 management no
Related Commands Command Description
cable qos profile Configures a QoS profile.
show cable qos Displays the status of permissions for changing QoS tables for a cable
permission router.
show cable qos profile Displays the QoS profiles that have been defined.
Cisco IOS CMTS Cable Command Reference
CBL-442 OL-15510-15
Cable Commands: cable p through cable r
cable qos pre-registration
cable qos pre-registration
To ensure that cable modems get online when a large number of existing online cable modems are
actively transmitting data, use the cable qos pre-registration us-priority command.
cable qos pre-registration us-priority priority-value
Syntax Description us-priority Specifies the upstream priority to be assigned to the pre-registration traffic.
priority-value Priority value of the QoS profile-2.
The valid range is from 0 to 7.
Note When a cable modem begins initializing, its default upstream
service flow is assigned a QoS profile-2 priority of zero. Zero is the
lowest priority scheduled.
Command Default Zero is the default QoS profile-2 priority of the initializing cable modem.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCD2 This command was introduced.
Usage Guidelines The cable qos pre-registration command allows the Cisco CMTS operators to enforce a profile on all
cable modems that have not yet begun initialization. However, this command has no affect on cable
modems that have already started initialization and may be having difficulties getting [w-]online.
Examples The following example shows how to set the priority of the QoS profile-2.
Router# configure terminal
Router(config)# cable qos pre-registration us-priority 2
Router(config)#
Related Commands Command Description
show cable qos profile Displays the QoS profiles for a Cisco CMTS.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-443
Cable Commands: cable p through cable r
cable qos pro max-ds-burst
cable qos pro max-ds-burst
To define ERBA on the downstream for DOCSIS 1.0 cable modems, use the cable qos promax-ds-burst
command in global configuration mode. To remove this ERBA setting from the QoS profile, use the no
form of this command.
cable qos pro max-ds-burst burst-size
no cable qos pro max-ds-burst
Syntax Description burst-size The QoS profile’s downstream burst size in bytes.
Command Default This DOCSIS 1.0 configuration is disabled by default.
Command Modes Global configuration
Command History Release Modification
12.3(13a)BC This command was introduced for the Cisco uBR7100 Series and Cisco
uB7246VXR router.
Usage Guidelines To display ERBA settings as applied to DOCSIS 1.0 cable modems and QoS profiles on the Cisco
CMTS, use the show cable qos profile command in Privileged EXEC mode.
The following example of the cable qos profile command in global configuration mode illustrates
changes to the cable qos profile command. Fields relating to the ERBA feature are shown in bold for
illustration:
Router(config)# cable qos pro 10 ?
grant-interval Grant interval
grant-size Grant size
guaranteed-upstream Guaranteed Upstream
max-burst Max Upstream Tx Burst
max-ds-burst Max Downstream Tx burst (cisco specific)
max-downstream Max Downstream
max-upstream Max Upstream
name QoS Profile name string (cisco specific)
priority Priority
privacy Cable Baseline Privacy Enable
tos-overwrite Overwrite TOS byte by setting mask bits to value
The following example of the show cable qos profile command illustrates that the maximum
downstream burst has been defined, and is a management-created QoS profile:
Router# show cable qos pro
ID Prio Max Guarantee Max Max TOS TOS Create B IP prec.
upstream upstream downstream tx mask value by priv rate
bandwidth bandwidth bandwidth burst enab enab
1 0 0 0 0 0 0xFF 0x0 cmts(r) no no
2 0 64000 0 1000000 0 0xFF 0x0 cmts(r) no no
3 7 31200 31200 0 0 0xFF 0x0 cmts yes no
4 7 87200 87200 0 0 0xFF 0x0 cmts yes no
Cisco IOS CMTS Cable Command Reference
CBL-444 OL-15510-15
Cable Commands: cable p through cable r
cable qos pro max-ds-burst
6 1 90000 0 90000 1522 0xFF 0x0 mgmt yes no
10 1 90000 0 90000 1522 0x1 0xA0 mgmt no no
50 0 0 0 96000 0 0xFF 0x0 mgmt no no
51 0 0 0 97000 0 0xFF 0x0 mgmt no no
The following example illustrates the maximum downstream burst size in sample QoS profile 10 with
the show cable qos prof verbose command in privileged EXEC mode:
Router# show cable qos pro 10 ver
Profile Index 10
Name
Upstream Traffic Priority 1
Upstream Maximum Rate (bps) 90000
Upstream Guaranteed Rate (bps) 0
Unsolicited Grant Size (bytes) 0
Unsolicited Grant Interval (usecs) 0
Upstream Maximum Transmit Burst (bytes) 1522
Downstreamam Maximum Transmit Burst (bytes) 100000
IP Type of Service Overwrite Mask 0x1
IP Type of Service Overwrite Value 0xA0
Downstream Maximum Rate (bps) 90000
Created By mgmt
Baseline Privacy Enabled no
Usage Guidelines If a cable modem registers with a QoS profile that matches one of the existing QoS profiles on the Cisco
CMTS, then the maximum downstream burst size, as defined for that profile, is used instead of the
default DOCSIS QoS profile of 1522.
For example, a DOCSIS 1.0 configuration that matches QoS profile 10 in the previous examples would
be as follows:
03 (Net Access Control) = 1
04 (Class of Service Encodings Block)
S01 (Class ID) = 1
S02 (Maximum DS rate) = 90000
S03 (Maximum US rate) = 90000
S06 (US burst) = 1522
S04 (US Channel Priority) = 1
S07 (Privacy Enable) = 0
The maximum downstream burst size (as well as the ToS overwrite values) are not explicitly defined in
the QoS configuration file because they are not defined in DOCSIS. However, because all other
parameters are a perfect match to profile 10 in this example, then any cable modem that registers with
these QoS parameters has a maximum downstream burst of 100000 bytes applied to it.
For further illustration, consider a scenario in which packets are set in lengths of 1000 bytes at 100
packets per second (pps). Therefore, the total rate is a multiplied total of 1000, 100, and 8, or 800kbps.
To change these settings, two or more traffic profiles are defined, with differing downstream QoS
settings as desired. Table 0-12 provides two examples of such QoS profiles for illustration:
Table 0-12 Sample QoS Profiles with Differing ERBA (Maximum Downstream) Settings
QoS Profile Setting QoS Profile 101 QoS Profile 102
Maximum Downstream Transmit Burst (bytes) max-burst 4000 max-burst 4000
Maximum Downstream Burst (bps) max-ds-burst 20000 max-ds-burst 5000
Maximum Downstream Bandwidth max-downstream 100 max-downstream 100
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-445
Cable Commands: cable p through cable r
cable qos pro max-ds-burst
In this scenario, both QoS profiles are identical except for the max-ds-burst size, which is set to 5000 in
QoS profile 101 and 5000 in QoS profile 102.
Optimal Settings for DOCSIS 1.0 Downstream Powerburst
DOCSIS allows the setting different token bucket parameters for each service flow, including the token
bucket burst size. When burst sizes are closer to 0, QoS is enforced in a stricter manner, allowing a more
predictable sharing of network resources, and as a result easier network planning.
When burst sizes are larger, individual flows can transmit information faster (lower latency), although
the latency variance can be larger as well.
For individual flows, a larger burst size is likely to be better. As long as the system is not congested, a large
burst size reduces the chances of two flows transmitting at the same time, because each burst is likely to take
less time to transmit. However, as channel bandwidth consumption increases, it is probably that large burst
traffic would exceed the thresholds of buffer depths, and latency is longer than with well shaped traffic.
For additional information about the cable qos profile command and configuring QoS profiles, refer to
the following documents on Cisco.com:
• DOCSIS 1.1 for the Cisco CMTS
Related Commands Command Description
cable qos profile Configures a QoS profile.
show cable qos Displays the status of permissions for changing QoS tables for a cable router.
permission
show cable qos profile Displays the QoS profiles that have been defined.
Cisco IOS CMTS Cable Command Reference
CBL-446 OL-15510-15
Cable Commands: cable p through cable r
cable queue-limit
cable queue-limit
To set the DOCSIS service flow queue limits to non-default values on the Cisco CMTS, use the cable
queue-limit command in global configuration mode. To disable this function, use the no form of this
command.
cable queue-limit queue_limit_in_ms bandwidth-threshold threshold_value
no cable queue-limit queue_limit_in_ms bandwidth-threshold threshold_value
Syntax Description queue_limit_in_ms Queue limit in milliseconds. The valid range is from 1 to 200 milliseconds.
threshold_value Queue bandwidth threshold in Kbps. The valid range is from 0 to 1000000.
Note The queue limit specification take effect only if the queue shape
rate exceeds the queue-bandwidth threshold.
Command Default This command is not enabled by default.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCG This command was introduced.
Usage Guidelines The queue size on the downstream interfaces can be adjusted to be different than the default settings; for
example, when the application can benefit from a larger queue size on a high speed queue.
The queue size in packets is calculated as:
queue-size = bandwidth (Kbps) * queue-limit (ms) / 8 / 1518
(where 1518 B is the packet size, and bandwidth is the same as queue shape rate).
Associated Features The cable queue-limit bandwidth-threshold command is used to configure the following features:
• DOCSIS WFQ Scheduler on the Cisco CMTS Routers
Examples The following example shows how to set the queue limit to 25 ms at max-rate when bandwidth exceeds
100000 Kbps:
Router(config)# cable queue-limit 25 bandwidth-threshold 100000
Related Commands
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-447
Cable Commands: cable p through cable r
cable queue-limit
Command Description
show pxf cpu queue Displays parallel express forwarding (PXF) queuing, link queue statistics,
and the service flow queue information including the queue size.
show pxf cable interface Displays information about a particular service ID (SID), including
information about the status of queues used by the SID.
Cisco IOS CMTS Cable Command Reference
CBL-448 OL-15510-15
Cable Commands: cable p through cable r
cable rate-limit-algorithm min-plus-excess
cable rate-limit-algorithm min-plus-excess
To enable a service flow to receive not only its configured minimum reserved traffic rate bandwidth but
also its expected excess traffic rate bandwidth, use the cable rate-limit-algorithm min-plus-excess
command in global configuration mode. To disable this configuration, use the no form of this command.
cable rate-limit-algorithm min-plus-excess
no cable rate-limit-algorithm min-plus-excess
Syntax Description min-plus-excess Specifies that the service flow requires a bandwidth of the specified
minimum reserved traffic rate, plus excess traffic rate.
Command Default When the cable rate-limit-algorithm min-plus-excess command is not configured, service flows with
the minimum reserved traffic rate configured are guaranteed only their minimum reserved traffic rate.
Excess traffic rate bandwidth may not be shared evenly among service flows with or without the
minimum rate configured.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCD5 This command was introduced.
Usage Guidelines The cable rate-limit-algorithm min-plus-excess command enables a service flow to receive its
configured minimum reserved traffic rate bandwidth plus its expected excess traffic rate bandwidth.
Examples The following example shows how to specify the min-plus-excess keyword:
Router> enable
Router# configure terminal
Router(config)# cable rate-limit-algorithm argument min-plus-excess
Router(config)#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-449
Cable Commands: cable p through cable r
cable rate-limit-algorithm min-plus-excess
Related Commands Command Description
show interface cable Displays the current time-slot scheduling state, statistics, and weighted fair
mac-scheduler queuing (WFQ) parameters for the indicated cable interface.
show interface cable Displays the attributes of the DOCSIS service flows on a cable interface.
service-flow
Cisco IOS CMTS Cable Command Reference
CBL-450 OL-15510-15
Cable Commands: cable p through cable r
cable rcc-template
cable rcc-template
To define a receive channel configuration (RCC) template, use the cable rcc-template command in
global configuration mode.
cable rcc-template index
Syntax Description index Specifies an RCC template ID in the range 1 to 255.
Command Default If an RCC template is not assigned to a cable interface, the CMTS will use the wideband cable interface
generated RCC for a receive channel profile (RCP).
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines A valid RCC template consists of a configured RCP ID, a receive module (RM) entry, and a receive
channel (RC) entry.
First, you define an RCC template for an RCP, and then assign the template to a cable interface to
generate RCCs based on the actual DS channel configuration.
Note When assigning an RCC template to a cable interface, use this command in interface configuration
mode.
Examples The following example shows how to define an RCC template:
Router# configure terminal
Router(config)# cable rcc-template 1
Related Commands Command Description
rcp-id Specifies an ID for the Receive Channel Profile.
receive-module Specifies a receive module entry in the form of a numeric value.
receive-channel Specifies a receive channel entry in the form of a numeric value.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-451
Cable Commands: cable p through cable r
cable rcp-control
cable rcp-control
To enable the receive channel profile (RCP) reporting with verbose description, use the cable
rcp-control command in interface configuration mode. To revert to the default simple RCP reporting,
use the no form of this command.
cable rcp-control verbose
no cable rcp-control
Syntax Description verbose Enables RCP reporting with verbose description that contains complete
subtype encodings defined in DOCSIS 3.0.
Command Default If this command is not used, cable modems use the default RCP reporting method that contains only the
RCP identifiers.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines Use this command to enable a CM to send detailed RCP data in the registration request. This detailed
RCP data can be verified using the debug cable registration command. This verbose RCP data is useful
while configuring a receive channel configuration (RCC) template.
Examples The following example shows how to enable RCP reporting with verbose description on a cable interface
on the Cisco uBR10012 router:
Router# configure terminal
Router(config)# interface cable 8/0/0
Router(config-if)# cable rcp-control verbose
Related
Commands Command Description
debug cable Displays debug messages for the CM registration process.
registration
cable rcc-template Defines a Receive Channel Configuration (RCC) template.
Cisco IOS CMTS Cable Command Reference
CBL-452 OL-15510-15
Cable Commands: cable p through cable r
cable redundancy hashfilter
cable redundancy hashfilter
To set the MAC address and DDC node mappings of the DDC redundancy scheme, use the cable
redundancy hashfilter command in global configuration mode. This hash filter is to be shared by all
DDC nodes (routers) in the redundancy scheme. To remove the hash filter from the Cisco CMTS router,
use the no form of this command.
cable redundancy hashfilter hash_id {type namestring | mac-mask mac-mask | mac-map
mac-address node node_id | oui-map oui node node_id}
no cable redundancy hashfilter
Syntax Description hash_id Unique ID for the shared hash filter. Multiple (differently named) hash
filters are supported in the same Cisco DDC Redundancy scheme at the
same time, though only one hash filter can be enabled at any one time.
Supported range is 1 to 3.
type namestring Alphanumeric hash filter name. Only the namestring of default is supported
at this time.
mac-mask mac-mask Specifies the number of bits in the cable modem’s MAC address to be used
by the hashing algorithm.
mac-map mac-address A manually configured MAC address for the DDC node (overrides any
default MAC address configured on the router).
node node_id This value overrides the node that all cable modems with the shared
mac-address or oui value will use, and updates the MAC address mapping
in the hash filter.
oui-map oui This value overrides the node that all cable modems with the shared OUI
value will use, and updates the OUI address mapping in the hash filter.
Command Default • Cable redundancy hash filters are disabled (not configured) by default.
• Only the hash filter name of default is supported at this time.
Command Modes Global configuration (config)
Command History Release Modification
Release 12.3(9a)BC This command was introduced on the Cisco uBR7246 universal broadband
router.
Usage Guidelines This command is used in the early stages of configuring DDC Redundancy on all DDC nodes (routers)
in the scheme. For additional information in context, refer to the “Configuring Cisco DDC Redundancy
on the Cisco uBR7246VXR Universal Broadband Router” feature documentation on Cisco.com.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-453
Cable Commands: cable p through cable r
cable redundancy hashfilter
Note This configuration must be present and identical on each CMTS router participating in the DDC
redundancy scheme.
Examples The following example implements the cable redundancy hashfilter command in four sequential steps,
completing the entire mapping information required for one DDC node in a redundancy scheme of two
routers:
Router# cable redundancy hashfilter 1 type default
Router# cable redundancy hashfilter 1 macmask FFFF.FF00.0000
Router# cable redundancy hashfilter 1 macmap 0007.0e03.68ad node 2
Router# cable redundancy hashfilter 1 ouimap 00070e node 1
Related Commands Command Description
cable redundancy myid Sets the total number of Cisco DDC nodes (routers) in the DDC
Redundancy scheme, and sets the ID of the current DDC node.
cable redundancy node Configures the DDC node with active or standby state.
show cable redundancy Displays the current DDC redundancy configurations and status.
Cisco IOS CMTS Cable Command Reference
CBL-454 OL-15510-15
Cable Commands: cable p through cable r
cable redundancy myid
cable redundancy myid
To set the total number of Cisco DDC nodes (routers) in the DDC Redundancy scheme, and to set the ID
of the current DDC node, use the cable redundancy myid command in global configuration mode. To
remove a DDC node ID from the router, use the no form of this command.
cable redundancy myid node_id nodes nodes
no cable redundancy myid node_id
Syntax Description node_id A unique identifier for the Cisco DDC node currently being configured. The
value must be 1 or greater (not to exceed the value used for nodes). This
value must be unique on each CMTS that participates in the scheme.
nodes Total number of Cisco CMTS routers participating in the DDC redundancy
scheme (range 1 to 3). This value must be identical on all DDC nodes
(routers).
Command Default DDC Redundancy is disabled and DDC nodes (routers) are not configured for DDC redundancy by
default.
Command Modes Global configuration (config)
Command History Release Modification
Release 12.3(9a)BC This command was introduced on the Cisco uBR7246 universal broadband
router.
Usage Guidelines This configuration must be present (identical except node_id) on all DDC nodes (routers) participating
in the scheme.
This command is used in the early stages of configuring DDC Redundancy on all DDC nodes (routers)
in the scheme. For additional information in context, refer to the “Configuring Cisco DDC Redundancy
on the Cisco uBR7246VXR Universal Broadband Router” feature documentation on Cisco.com.
Examples The following example configures the DDC node (router) ID to be 2 in a scheme in which there are three
DDC nodes total.
Router# cable redundancy myid 2 nodes 3
Related Commands Command Description
cable redundancy node Configures the DDC node with active or standby state.
show cable redundancy Displays the current DDC redundancy configurations and status.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-455
Cable Commands: cable p through cable r
cable redundancy node
cable redundancy node
To set the DDC node (router) with which a subinterface is associated, and to set the state for that
interface, use the cable redundancy node command in subinterface configuration mode. To remove this
configuration from the router, use the no form of this command.
cable redundancy node node_id {active | standby} [force]
no cable redundancy node node_id {active | standby}
Syntax Description node_id DDC node (router) with which the subinterface is associated. The range is
the number of DDC nodes in the scheme.
force Optional keyword forces the subinterface into the standby state regardless
of the number of active voice or E911 calls.
Command Default DDC switchover events are disabled by default and must be manually initiated on a case-by-case basis.
Command Modes Subinterface configuration (config-subif)
Command History Release Modification
Release 12.3(9a)BC This command was introduced on the Cisco uBR7246 universal broadband
router.
Usage Guidelines This command can be used in the context of DDC configuration, testing or forced switchover events.
Refer to earlier procedures in this document for additional information.
Note Use of this command is subject to additional constraints described in the “Active Voice Call Protection
in Cisco DDC Redundancy” section of the “Configuring Cisco DDC Redundancy on the Cisco
uBR7246VXR Universal Broadband Router” feature documentation on Cisco.com..
Examples The following command sequence sets the DDC node states in a scheme with two DDC nodes (routers),
then forces a switchover event on DDC node 1 that puts it into standby state.
Router(config-subif)# cable redundancy node 2 active
Router(config-subif)# cable redundancy node 1 standby
Router(config-subif)# cable redundancy node 1 standby force
Related Commands Command Description
cable redundancy myid Sets the total number of Cisco DDC nodes (routers) in the DDC
Redundancy scheme, and sets the ID of the current DDC node.
show cable redundancy Displays the current DDC redundancy configurations and status.
Cisco IOS CMTS Cable Command Reference
CBL-456 OL-15510-15
Cable Commands: cable p through cable r
cable redundancy node frequency
cable redundancy node frequency
To set the downstream frequencies for each node participating in the scheme other than the current DDC
node (router), use the cable redundancy node frequency command in interface configuration mode.
This frequency is used to switch cable modems to the downstream frequency of the backup interface (on
another DDC node) via DFO and DCC messages. To remove this setting from the router, use the no form
of this command.
cable redundancy node node_id frequency frequency
no cable redundancy node node_id frequency frequency
Syntax Description node_id DDC target node ID for which the frequency is being set.
frequency Downstream frequency of the target interface.
Command Default Cable downstream frequency override is enabled by default.
Command Modes Interface configuration mode (config-if)
Command History Release Modification
Release 12.3(9a)BC This command was introduced on the Cisco uBR7246 universal broadband
router.
Usage Guidelines This command must be present on each cable interface participating in the scheme, regardless of its
bundle status.
Examples The following example configures the downstream frequency of DDC node 1 to be 435000000.
Router(config-if)# cable redundancy node 1 frequency 435000000
Related Commands Command Description
cable redundancy myid Sets the total number of Cisco DDC nodes (routers) in the DDC
Redundancy scheme, and sets the ID of the current DDC node.
cable redundancy node Configures the DDC node with active or standby state.
cable redundancy target Configures the DDC node by setting the target DDC node (router)
to use in a DDC switchover event.
cable redundancy threshold Configures the DDC node by setting the active voice call threshold
on the current DDC node (router)
show cable redundancy Displays the current DDC redundancy configurations and status.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-457
Cable Commands: cable p through cable r
cable redundancy target
cable redundancy target
To set the target DDC node (router) to use in a DDC switchover event, use the cable redundancy target
command in interface configuration mode. To remove this configuration from the router, use the no form
of this command.
cable redundancy target node_id
no cable redundancy target node_id
Syntax Description node_id Target node ID (in relation to the current DDC node)
Command Default When this command is not present, the default target node is the next higher node in the scheme.
Command Modes Interface configuration (config-if)
Command History Release Modification
Release 12.3(9a)BC This command was introduced on the Cisco uBR7246 universal broadband
router.
Usage Guidelines The downstream frequency that is used in a DDC switchover event is the frequency set on the respective
target DDC node, as set with this command.
Note This command may be present on each participating cable interface, regardless of its bundle status.
When this command is not present, the default target node is the next higher node in the scheme (the
next higher node_id value in the scheme). For example, if there are three participating nodes, the default
target nodes are as follows (respectively):
• If the current node is 1, the target node is 2.
• If the current node is 2, the target node is 3.
• If the current node is 3, the target node is 1.
Examples The following example configures the target node on the current router to be DDC node 1, often referred
to as CMTS A in additional sections of this document.
Router(config-if)# cable redundancy target 1
Related Commands Command Description
cable redundancy myid Sets the total number of Cisco DDC nodes (routers) in the DDC
Redundancy scheme, and sets the ID of the current DDC node.
cable redundancy node Configures the DDC node with active or standby state.
Cisco IOS CMTS Cable Command Reference
CBL-458 OL-15510-15
Cable Commands: cable p through cable r
cable redundancy target
Command Description
cable redundancy node Configures the DDC scheme by setting the DS frequencies for each
frequency node in the scheme other than the current DDC node (router).
cable redundancy threshold Configures the DDC node by setting the active voice call threshold on
the current DDC node (router).
show cable redundancy Displays the current DDC redundancy configurations and status.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-459
Cable Commands: cable p through cable r
cable redundancy threshold
cable redundancy threshold
To set the active voice call threshold on the current DDC node (router), use the
cable redundancy threshold command in interface configuration mode. To remove this configuration
from the router, use the no form of this command.
cable redundancy threshold max-calls
no cable redundancy threshold
Syntax Description max-calls The threshold value for the number of active voice calls.
Command Default The threshold for maximum calls is not set by default.
Command Modes Interface configuration (config-if)
Command History Release Modification
Release 12.3(9a)BC This command was introduced on the Cisco uBR7246 universal broadband
router.
Usage Guidelines If the number of active voice calls exceeds this value, a DDC switchover does not take place unless it is
forced by using the cable redundancy node node_id standby force subinterface configuration
command.
If the command is configured on a bundle master, the threshold is used to compare with the total number
of voice calls in the bundle. This command is not accepted on interfaces configured as bundle slaves.
If this threshold is not configured, this check does not occur and the DDC switchover proceeds regardless
of how many voice calls are active. This is subject to additional constraints described in the “Call Priority
in Cisco DDC Redundancy” section of the “Configuring Cisco DDC Redundancy on the Cisco
uBR7246VXR Universal Broadband Router” feature documentation on Cisco.com.
Examples The following example configures DDC redundancy not to take place if there are more than 20 active or
E911 calls at the time a DDC switchover event is attempted or requested.
Router(config-if)# cable redundancy threshold 20
Related Commands Command Description
cable redundancy myid Sets the total number of Cisco DDC nodes (routers) in the DDC
Redundancy scheme, and sets the ID of the current DDC node.
cable redundancy node Configures the DDC node with active or standby state.
cable redundancy node Configures the DDC scheme by setting the DS frequencies for each
frequency node in the scheme other than the current DDC node (router).
cable redundancy target Configures the DDC node (node_id) by setting the target DDC node
(router) to use in a DDC switchover event.
show cable redundancy Displays the current DDC redundancy configurations and status.
Cisco IOS CMTS Cable Command Reference
CBL-460 OL-15510-15
Cable Commands: cable p through cable r
cable registration-timeout
cable registration-timeout
To set the value of the DOCSIS registration timeout timer (T9 timer) on a particular interface, use the
cable registration-timeout command in cable interface configuration mode. To reset the timeout value
to the default, use the no form of this command.
cable registration-timeout minutes
no cable registration-timeout
Syntax Description minutes Sets the value of the DOCSIS CM registration timeout timer (T9 timer). Valid range is from
2 to 60 minutes. The default is 3 minutes.
Command Default 3 minutes
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.0(7)XR2 This command was introduced.
Usage Guidelines The DOCSIS 1.1 specification states that the CMTS should enforce the T9 timer, which is a registration
timeout timer that specifies the maximum time allowed between the CMTS sending a successful Ranging
Response (RNG-RSP) message and the CM replying with a Registration Request (REG-REQ) message.
If this timer expires, the CMTS must remove the CM from its list of active CMs, and the CM must restart
the registration process.
The cable registration-timeout command can be used to customize the value of the T9 timer for each
cable interface, to accommodate the CMs using that interface.
Examples The following example shows the registration timeout value being increased from 3 minutes to
10 minutes:
Router# configure terminal
Router (config)# interface c6/0
Router(config-if)# cable registration-timeout 10
Router(config-if)# exit
Router(config)#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-461
Cable Commands: cable p through cable r
cable relay-agent-option
cable relay-agent-option
To enable the system to insert the CM MAC address into a Dynamic Host Configuration Protocol
(DHCP) packet received from a CM or host and forward the packet to a DHCP server, use the cable
relay-agent-option command in cable interface configuration mode. To disable MAC address insertion,
use the no form of this command.
cable relay-agent-option
no cable relay-agent-option
Syntax Description This command has no keywords or arguments.
Command Default no cable relay-agent-option
Command Modes Interface configuration (cable interface only)
Command History Release Modification
11.3 NA This command was introduced.
12.0 mainline, This command was made obsolete and was replaced by the ip dhcp relay information
12.1(2)EC1, option command.
12.0(10) SC
Usage Guidelines This functionality enables the use of DHCP Option 82 to allow a DHCP server to identify the CM
sending the request and to initiate the appropriate action based on this information. On Cisco IOS
Release 12.0 and later releases, use the ip dhcp relay information option command to enable Option 82
processing.
Examples The following example shows how to enable the insertion of DHCP relay agent information into DHCP
packets:
Router(config-if)# cable relay-agent-option
Related Commands Command Description
cable helper-address Specifies a destination IP address for User Datagram
Protocol (UDP) broadcast (DHCP) packets.
cable dhcp-giaddr Modifies the GIADDR field of DHCPDISCOVER and
DHCPREQUEST packets with a Relay IP address before
they are forwarded to the DHCP server.
cable source-verify Turns on CM upstream verification.
Cisco IOS CMTS Cable Command Reference
CBL-462 OL-15510-15
Cable Commands: cable p through cable r
cable relay-agent-option
Command Description
cable telco-return spd dhcp-authenticate Enforces the telco-return CM to use a specific DHCP
server.
cable telco-return spd dhcp-server Identifies the IP address of the DHCP server that the
telco-return CM must access.
ip dhcp relay information option Enables the system to insert the CM MAC address into a
DHCP packet received from a CM or host and forward
the packet to a DHCP server.
ip dhcp smart-relay Monitors client retransmissions when address pool
depletion occurs.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-463
Cable Commands: cable p through cable r
cable resiliency ds-bonding
cable resiliency ds-bonding
To enable the Downstream Resiliency Bonding Group feature and to create a resiliency bonding group
(RBG) on the Cisco CMTS router, use the cable resiliency ds-bonding command in global
configuration mode. To disable this feature, use the no form of this command.
cable resiliency ds-bonding
no cable resiliency ds-bonding
Command Default None
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCG This command was introduced.
Usage Guidelines The cable resiliency ds-bonding command is used to configure the Downstream Resiliency Bonding
Group feature.
Examples The following example shows how to configure the Downstream Resiliency Bonding Group feature:
Router(config)# cable resiliency ds-bonding
Associated Features The cable ds-resiliency command is used to configure the following feature:
Downstream Resiliency Bonding Group
Related Commands Command Description
cable ds-resiliency Reserves a resiliency bonding group for a line card on the Cisco CMTS
router.
show cable modem Displays resiliency status of the cable modem in resiliency mode on the
resiliency Cisco CMTS router.
show cable resiliency Displays all information about resiliency bonding groups on the Cisco
CMTS router.
Cisco IOS CMTS Cable Command Reference
CBL-464 OL-15510-15
Cable Commands: cable p through cable r
cable rf-adapt timer
cable rf-adapt timer
To configure timers for RF adaptation, use the cable rf-adapt timer command in global configuration
mode. To disable the timers, use the no form of this command.
cable rf-adapt timer {general time | candidate time | relocation time}
no cable rf-adapt timer
Syntax Description general Period when the RF adaptation process examines the physical layer
statistics of all modems on RF adaptation-enabled upstream channels. The
valid range is from 1 to 300 seconds. The default value is 10 seconds.
candidate Period when the RF adaptation process examines the physical layer
statistics of modems flagged as downgrade and/or upgrade candidates. The
valid range is from 1 to 300 seconds. The default value is 1 second.
relocation Period when the RF adaptation process performs a single relocation of a
candidate modem from its current upstream channel to the appropriate
destination. The valid range is from 1 to 300 seconds. The default value is
1 second.
time Time in seconds. The valid range is from 1 to 300.
Command Default Default timer values are used.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCF This command was introduced.
Examples The following example shows how to set timers for cable modem upstream RF adaptation:
Router(config)# cable rf-adapt timer general 120
Router(config)# cable rf-adapt timer candidate 10
Router(config)# cable rf-adapt timer relocation 5
Related Commands Command Description
cable upstream rf-adapt Enables RF adaptation on the physical upstream channel.
cable upstream rf-adapt Configures the primary upstream logical channel and secondary
(logical channel) upstream logical channel.
cable upstream threshold Configures the upstream for the signal-to-noise ratio (SNR) and
forward error correction (FEC) threshold values to be used in
determining the allowable noise levels.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-465
Cable Commands: cable p through cable r
cable rf-adapt timer
Command Description
cable upstream threshold Configures the hysteresis value to be used in conjunction with the
hysteresis dynamic modulation upgrade thresholds.
cable upstream threshold Configures the upstream RF adaptation threshold value, which
rf-adapt prevents excessive relocation of modems from the primary upstream
channel to the secondary upstream channel.
show cable modem rf-adapt Displays the RF adaptation history.
show cable rf-adapt Displays the downgrade and upgrade candidate lists.
Cisco IOS CMTS Cable Command Reference
CBL-466 OL-15510-15
Cable Commands: cable p through cable r
cable rf-bandwidth-percent
cable rf-bandwidth-percent
To enable either static or dynamic bandwidth sharing for a modular cable (MC) interface, use the cable
rf-bandwidth-percent command in interface configuration mode. To remove bandwidth sharing for the
MC interface, use the no form of this command.
cable rf-bandwidth-percent percent-value [remaining ratio excess-value]
no cable rf-bandwidth-percent
Syntax Description percent-value Specifies static bandwidth allocation of a downstream RF channel. The
range is 1–96. The default is 0.
remaining ratio (Optional) Specifies the ratio of the remaining or excess bandwidth that can
be allocated to the modular cable channel.
Note This option is only available when dynamic bandwidth sharing is
enabled.
excess-value Specifies the value of excess bandwidth that can be allocated to the modular
cable channel. The range is 1–100. The default value is 1.
Command Default The default static bandwidth percentage for a modular cable interface is 0.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.3(23)BC This command was introduced for the Cisco uBR10012 router.
12.3(23)BC1 The remaining ratio option was added.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.2(33)SCB.
Usage Guidelines The total percentage of the RF channel bandwidth allocated to both the modular cable (MC) and
wideband interfaces must not exceed 96 percent. The remaining 4 percent of the bandwidth is reserved
for minislot allocation packet (MAP) and other MAC management messages (MMM) DOCSIS traffic
using this RF channel as its primary channel.
When dynamic bandwidth sharing (DBS) is enabled on the MC interface, the bandwidth percentage is
converted to a committed information rate (CIR) value for the corresponding link queue. By
re-interpreting the bandwidth percentage value as a CIR value for the MC interface, the interface
receives, at minimum, the configured percent of bandwidth and more when the RF channel’s bandwidth
is not consumed by other interfaces sharing the same RF channel. The remaining ratio option is only
available when DBS is enabled using the cable dynamic-bw-sharing command.
If the cable rf-bandwidth-percent command is not configured and DBS is enabled, no bandwidth is
reserved for the MC interface and it is effectively in the protocol down state—the MC link queue is not
created. Static bandwidth sharing (the default) or DBS can be configured on an MC interface, but you
cannot have both on the same interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-467
Cable Commands: cable p through cable r
cable rf-bandwidth-percent
Examples The folowing is an example of static bandwidth allocation configuration:
Router# configure terminal
Router(config)# interface modular-cable 1/0/0:0
Router(config-if)# cable rf-bandwidth-percent 70
The following is an example of dynamic bandwidth sharing configuration:
Router# configure terminal
Router(config)# interface modular-cable 1/0/0:0
Router(config-if)# shutdown
Router(config-if)# cable dynamic-bw-sharing
Router(config-if)# no shutdown
Router(config-if)# cable rf-bandwidth-percent 70 remaining ratio 25
Related Commands Command Description
cable Enables dynamic bandwidth sharing on a specific modular cable or
dynamic-bw-sharing wideband cable interface.
cable rf-channel Associates an RF channel on a Wideband SPA with a wideband channel and
allocates bandwidth.
show pxf cable Displays information about the RF channel Versatile Traffic Management
controller System (VTMS) links and link queues.
show pxf cpu queue Displays parallel express forwarding (PXF) queueing and link queue
statistics.
Cisco IOS CMTS Cable Command Reference
CBL-468 OL-15510-15
Cable Commands: cable p through cable r
cable rf-change-dampen-time
cable rf-change-dampen-time
To configure the amount of time a radio frequency (RF) channel must remain in its new state (either up
or down), use the cable rf-change-dampen-time command in global configuration mode. To restore the
default value, use the no form of this command.
cable rf-change-dampen-time seconds
no cable rf-change-dampen-time
Syntax Description seconds Specifies the amount of time in seconds for a non-primary RF channel to
remain in its new state. The valid range is 1 to 65535. The default value is 30.
Command Default If this command is not used, the default value of 30 seconds will be restored.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines This command applies to all non-primary RF channels on a CMTS.
Examples The following example shows how to specify the amount of time for a non-primary RF channel to remain
in its new state:
Router# configure terminal
Router(config)# cable rf-change-dampen-time 10
Related Commands Command Description
cable Specifies the persistence thresholds for an event before the event triggers an
rf-change-trigger action for the cable modem.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-469
Cable Commands: cable p through cable r
cable rf-channel
cable rf-channel
To associate an RF channel on the Cisco Wideband SPA with a wideband interface and allocate
bandwidth, use the cable rf-channel command in interface configuration mode. To remove an
association of an RF channel to a wideband interface, use the no form of this command.
cable rf-channel {rf-port | controller controller-num channel channel-num} [bandwidth-percent
bw-percent] [remaining ratio excess-value]
no cable rf-channel {rf-port | controller controller-num channel channel-num}
Syntax Description rf-port Specifies the RF channel physical port on the Wideband SPA
field-programmable gate array (FPGA).
Note Valid values for the RF port depend on the configuration set with
the annex modulation command (see the “Usage Guidelines”
section).
controller controller-num Specifies the controller associated with the RF channel. The valid range
is from 0 to 4.
channel channel-num Specifies the channel from the controller. The valid range is from 0 to 3.
bandwidth-percent (Optional) Specifies the percent of bandwidth from this RF channel that
bw-percent will be used for the wideband interface. The range is 0 to 100. If
bandwidth-percent is not used, the default bandwidth value is
100 percent.
remaining ratio (Optional) Specifies the ratio of the excess bandwidth that can be
excess-value allocated to the wideband interface. The default value is 1. The range is 1
to 100.
Note This option is only available when dynamic bandwidth sharing
(DBS) is enabled.
Command Default No default RF channel association with a wideband interface is configured. If the cable rf-channel
command is used without specifying bandwidth-percent, the default bandwidth value is 100 percent.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.3(21)BC This command was introduced for the Cisco uBR10012 router.
12.3(23)BC The annex and modulation keyword options were added.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
12.3(23)BC1 The remaining ratio option was added.
12.2(33)SCB The remaining ratio option was integrated into Cisco IOS
Release 12.2(33)SCB.
Cisco IOS CMTS Cable Command Reference
CBL-470 OL-15510-15
Cable Commands: cable p through cable r
cable rf-channel
Usage Guidelines The cable rf-channel command associates an RF channel (port) on a Wideband SPA with a wideband
interface. Optionally, you can specify the percent of bandwidth from this RF channel that will be used
for the specified wideband interface.
The Cisco uBR10012 router supports two Wideband SPAs. Each Wideband SPA supports up to 24 RF
channels depending on how the SPA is configured with the annex modulation command. For annex A
and 256 QAM modulation, each Wideband SPA supports up to 18 RF channels at full rate and up to 24
RF channels at less than full rate. For all other cases, the SPA supports 24 RF channels.
Note The command changes in Cisco IOS releases 12.3(23)BC and 12.3(23)BC1 are not supported in Cisco
IOS release 12.2(33)SCA.
Note In Cisco IOS Releases 12.3(21)BC and 12.3(21a)BC3, the cable rf-channel command is not available
on the Cisco IOS command line until annex and modulation have been set with annex modulation
command.
Effective with Cisco IOS Release 12.3(23)BC, the annex modulation command is obsolete and annex
and modulation are included as keyword options in the rf-channel frequency command.
Each Wideband SPA supports up to 32 wideband channels. A wideband interface cannot consist of RF
channels from two different Wideband SPAs. The number of RF channels that can be aggregated into a
wideband interface is determined by the capability of the wideband cable modem.
• The Linksys WCM300-NA, WCM300-EURO, and WCM300 JP wideband cable modems can
receive a wideband interface consisting of up to eight downstream RF channels at 6 MHz per
channel, or up to six downstream RF channels at 8 MHz per channel. The modem requires that the
channels be received in a 50-MHz capture window.
• The Scientific Atlanta DPC2505 and EPC2505 wideband cable modems support the receiving of one
wideband interface. The wideband channel consists of three downstream RF channels at either 6
MHz per channel or 8 MHz per channel.
An RF channel can be associated with multiple wideband interfaces as long as the wideband interfaces
belong to the same virtual bundle interface (cable bundle) and the RF channel’s total allocated bandwidth
does not exceed 100 percent. As an example, Table 13 shows that a single RF channel can be associated
with multiple wideband interfaces as long as the total allocated bandwidth for the RF channel does not
exceed 100 percent.
Table 13 RF Channel Bandwidth Allocation
Wideband Bandwidth
RF Channel Interface Allocated
10 0 30 percent
10 1 30 percent
10 2 40 percent
Total Bandwidth Percent: 100 percent
Table 14 shows that a single RF channel can be associated with a narrowband and multiple wideband
interfaces as long as the total allocated bandwidth for the RF channel does not exceed 100 percent.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-471
Cable Commands: cable p through cable r
cable rf-channel
Table 14 Bandwidth Allocation Using a Primary-Capable RF Channel
Wideband Wideband Wideband Total
Modular Cable Channel 0 Channel 1 Channel 2 Bandwidth
Interface Percent
54 percent (4 10 percent 22 percent 14 percent 100 percent
percent used
Bandwidth internally for
Allocated from RF DOCSIS
Channel 10 signaling)
Note Each RF channel on the CMTS can be mapped to a specific QAM port on an edge QAM device. Traffic
from different Wideband SPAs cannot be mixed on the same QAM port.
When dynamic bandwidth sharing (DBS) is enabled, the bandwidth percentage is converted to a
committed information rate (CIR) value that provides the level of guaranteed bandwidth for the
wideband interface. The reserved bandwidth for the wideband interface is the sum of its link queue CIR
values and is used for admission control of the service flows with minimal reserved rate. With DBS
enabled and the cable rf-channel command configured, the corresponding link queue can have 100
percent of the CIR value. The excess-value is the percent of excess bandwidth that can be allocated to
the wideband channel.
Static bandwidth sharing (the default) or DBS can be configured on a wideband interface, but you cannot
have both on the same interface.
Examples The following example shows how to associate RF channel 10 and RF channel 11 with wideband
interface 0:
Router(config)# interface wideband-cable 1/0/0:0
Router(config-if)# cable rf-channel 10 bandwidth-percent 50
Router(config-if)# cable rf-channel 11
The following example shows how to associate a controller to the RF channel for a wideband interface:
Router(config)# interface wideband-Cable 7/1/0:0
Router(config-if)# cable rf-channel controller 0 channel 1
In the preceding example, because no bandwidth-percent is specified in the second cable rf-channel
command, the default value (100 percent of bandwidth) applies; that is, 100 percent of RF channel 11
bandwidth is used for wideband interface 0.
The following example shows bandwidth allocation when DBS is enabled:
Router(config)# interface wideband-cable 1/0/0:0
Router(config-if)# shutdown
Router(config-if)# cable dynamic-bw-sharing
Router(config-if)# no shutdown
Router(config-if)# cable rf-channel 10 bandwidth-percent 50 remaining ratio 5
In the preceding example, because DBS is enabled, the wideband interface is guaranteed 50 percent of
the bandwidth and 5 as the value for allocating excess bandwidth.
Cisco IOS CMTS Cable Command Reference
CBL-472 OL-15510-15
Cable Commands: cable p through cable r
cable rf-channel
Related Commands Command Description
annex modulation Sets the annex and modulation for the Wideband SPA.
cable bonding-group-id Specifies a Bonding Group ID and indicates whether the bonding group
is a primary or secondary bonded channel.
cable Enables dynamic bandwidth sharing on a specific modular cable or
dynamic-bw-sharing wideband cable interface.
controller modular-cable Enters controller configuration mode to configure the Wideband SPA
controller.
downstream cable Assigns a primary downstream channel for a fiber node.
ip-address (controller) Sets the IP address of the Wideband SPA FPGA.
modular-host subslot Specifies the modular-host line card for Wideband protocol operations.
rf-channel cable Assigns a downstream channel ID to an RF channel.
downstream channel-id
rf-channel description Specifies the description for each RF channel.
rf-channel frequency Sets the frequency for each RF channel.
rf-channel ip-address Sets the IP address, MAC address and UDP port for each RF channel.
mac-address udp-port
rf-channel network delay Specifies the CIN delay for each RF channel.
upstream cable connector Specifies the upstream channel ports for a fiber node.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-473
Cable Commands: cable p through cable r
cable rsvp default-scn
cable rsvp default-scn
To specify the default service class that enables the Resource ReSerVation Protocol (RSVP) created
service flows to inherit characteristics , use the cable rsvp default-scn command in global configuration
mode.
cable rsvp default-scn service-class name
Syntax Description service-class name The name of a downstream DOCSIS service-class .
Command Default Service class is not configured.
Command Modes Global configuration mode
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines The cable rsvp default-scn command allows users to specify the default service class that enables the
RSVP created service flows to inherit characteristics.
Examples The following example configures a default RSVP service class.
Router#configure terminal
Router(config)# cable service class 220 name RSVPClass
Router(config)#cable service class 220 downstream
Router(config)#cable service class 220 max-latency 100000
Router(config)#cable service class 220 req-attr-mask ffff0000
Router(config)#cable rsvp default-scn RSVPClass
Router(config)#cable rsvp default-scn RSVPClass
Related Commands Command Description
show cable rsvp Displays the contents of the RSVP to DOCSIS service-flow mapping
flow-db database.
Cisco IOS CMTS Cable Command Reference
CBL-474 OL-15510-15
Cable Commands: cable p through cable r
cable rf-change-trigger
cable rf-change-trigger
To specify the amount of time an event must persist before it triggers an action for the reporting cable
modem, use the cable rf-change-trigger command in global configuration mode. To restore the default
value, use the no form of this command.
cable rf-change-trigger {percent value | count number} [secondary]
no cable rf-change-trigger {percent value | count number} [secondary]
Syntax Description percent value Indicates the percentage of cable modems that must report that a particular
non-primary RF channel is down before that channel is removed from the
bonding group. The valid range is 1 to 100. The default value is 0.
count number Specifies the number of cable modems reporting an impairment for a
non-primary downstream channel. The default value is 0.
secondary (Optional) Configures the Cisco CMTS to move the unicast secondary
service flows to the primary channel interface, when the number of cable
modems reporting RF channel impairment is less than the configured
(percent or count) threshold.
Note Only those unicast secondary service flows, which share the same
wideband interface as the primary interface, are moved to the
primary channel interface.
By default, the secondary keyword is not configured.
Command Default If this command is not used, the default value (0) is used.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCB This command was introduced.
12.2(33)SCE4 This command was modified. A new keyword secondary was added to move
the unicast secondary SFs, which share the same interface as the primary SF,
to the primary channel interface when the trigger threshold is not reached.
Usage Guidelines This command applies to all non-primary RF channels on a Cisco CMTS router. The default value of 0
prevents any bonding group modifications. In order to dampen the change of a logical state of an RF
channel, the trigger for the channel can be set to one half of the number used for the logical state. For
example, if you enter cable rf-change-trigger percent 20, when 20 percent of the cable modems report
an RF channel is down, the logical state of the RF channel is changed to down. And when 10 percent of
the cable modems report that the affected RF channel is back, the logical state is changed to up.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-475
Cable Commands: cable p through cable r
cable rf-change-trigger
In the case of a small number of wideband modems, you can specify an absolute value for triggering an
event in addition to the percentage. Both values must be true in order to trigger the suspension of an RF
channel. When both values are 0, the cable modem is reset if the cable modem reports an RF failure
through a status message. Also, if you set thresholds to 0, then all cable modems with RF failures are
reset and any RFs suspended from a bonding group are reactivated.
Examples The following example shows how to specify the amount of time an event must persist before it triggers
an action for the reporting cable modem:
Router# configure terminal
Router(config)# cable rf-change-trigger percent 50 count 1
The following example shows how to configure the Cisco CMTS to move secondary SFs to primary
interface when the trigger threshold is not reached, in Cisco IOS Release 12.2(33)SCE4:
Router# configure terminal
Router(config)# cable rf-change-trigger percent 50 count 1 secondary
Associated Features The cable rf-change-trigger command is used to configure the following features:
• Wideband Modem Resiliency
Related Commands Command Description
cable Specifies the amount of time an RF channel must remain in its new state.
rf-change-dampen-time
Cisco IOS CMTS Cable Command Reference
CBL-476 OL-15510-15
Cable Commands: cable p through cable r
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-477
Cable Commands: cable p through cable r
Cisco IOS CMTS Cable Command Reference
CBL-478 OL-15510-15
Cable Commands: cable s
Revised: July 2012, OL-15510-15
New Commands
Command Cisco IOS Software Release
cable service attribute ds-bonded 12.3(23)BC
downstream-type bonding-enabled
cable service attribute non-ds-bonded 12.3(23)BC
downstream-type bonding-disabled
cable service attribute non-ds-bonded 12.3(23)BC
legacy-ranging downstream-type
cable service attribute voice-enabled 12.3(23)BC
cable service type 12.2(33)SCB
cable submgmt default 12.2(33)SCB
cable set mpls-experimental value 12.2(33)SCC
cable sid-cluster-group 12.2(33)SCC
cable sid-cluster-switching 12.2(33)SCC
cable service attribute withhold-TLVs 12.2(33)SCB10
cable source-verify enable-sav-static 12.2(33)SCC
cable source-verify group 12.2(33)SCC
cable source-route 12.2(33)SCF
Modified Commands
Command Cisco IOS Software Release
cable service class 12.2(33)SCB
cable service class 12.2(33)SCB1
cable service class 12.2(33)SCF2
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-479
Cable Commands: cable s
cable service attribute ds-bonded downstream-type bonding-enabled
cable service attribute ds-bonded downstream-type
bonding-enabled
To force a downstream bonding-capable modem to initialize on a bonded primary-capable downstream
channel, use the cable service attribute ds-bonded downstream type bonding-enabled command in
global configuration mode. To restore default configuration, use the no form of the command.
cable service attribute ds-bonded downstream-type bonding-enabled [enforce]
no cable service attribute ds-bonded downstream-type bonding-enabled
Syntax Description enforce Enforces bonding-capable modems to register only on bonded RF channels.
Command Default A bonding-capable modem is allowed to register on the primary channel selected by the modem for
initiation even if the channel is not part of a bonding group.
Command Modes Global configuration
Command History Release Modification
12.3(23)BC This command was introduced for the uBR10012 router.
Usage Guidelines For bonding capable cable modems, the primary channel selection that is done by the CMTS depends on
whether the modems can resolve its MAC Domain Downstream Service Group ID (MD-DS-SG). The
CM must attempt to determine its MAC Domain Downstream Service Group ID (MD-DS-SG-ID) if an
MDD is present on the downstream. If a modem has resolved its MD-DS-SG, the CMTS selects a bonded
primary channel, the primary channel that is part of an operational wideband channel, from the RF
channel set corresponding to the MD-DS-SG determined by the modem. The bonded primary channel
selected by the CMTS needs to be hosted by an interface on the same uBR10-MC5X20 cable interface
line card as the modem’s initial primary channel. If there are multiple primary capable channels that
meet the above criteria, the final primary channel will be randomly selected among the eligible channel
set.
When the CMTS has an existing record of a CM (listed in the show cable modem command output) that
should be moved to a bonded channel, a Dynamic Frequency Override (DFO) is triggered to be sent in
the RNG-RSP from the CMTS to that CM.
If a CM is ranging for the first time (not listed in the show cable modem command output), no DFO is
triggered at initial-ranging time. The CM proceeds to register and the CMTS gleans the bonding
capabilities of the CM to determine if it should be moved to a bonded channel. If the CM is on a wrong
primary DS channel, the DOCSIS specification does not allow a DFO at this time, so the CMTS rejects
the registration of the CM forcing it to enter the reject(c) state. The CMTS then waits for the CM to start
ranging again. If the CM engages with the same incorrect DS channel, the CMTS triggers a DFO to the
CM during initial-ranging because it now has a record of that CM.
Cisco IOS CMTS Cable Command Reference
CBL-480 OL-15510-15
Cable Commands: cable s
cable service attribute ds-bonded downstream-type bonding-enabled
If a modem has not resolved its MD-DS-SG and the enforce option is configured, the CMTS selects a
bonded primary channel based on MAP group associated with the modem’s upstream channel.
Typically, an upstream channel is configured into a single fiber node and the CMTS infers the topology
information based on the downstream channels associated with the upstream. If the enforce option is not
configured or the CMTS cannot find a target primary channel, the modem will be allowed to register on
the primary channel currently selected by the modem for initialization.
Note The CMTS will only try to move the modem with MD-DS-SG unresolved if the enforce option is
configured.
By default, changing the primary channel to select a wideband channel is not enforced and modems are
allowed to operate on a primary channel even if they are not included in any load balancing groups. At
any time after the system is up, enabling the primary channel selection for bonding capable modems will
not affect existing modems in the system. The operator has to manually reset the bonding capable
modems using the clear cable modem command either globally or at per-MAC Domain level.
Note Enabling primary channel selection for wideband modems will not affect existing modems in the system.
Examples Router# configure terminal
Router(config)# cable service attribute ds-bonded downstream-type bonding-enabled [enforce]
Related Commands cable dfo-retry-count Configures the Downstream Frequency Override (DFO)
retry count.
cable service attribute non-ds-bonded Forces the non-bonding-capable modems to register only on
downstream-type bonding-disabled non-bonded RF channels on the CMTS.
cable service attribute voice-enabled Restricts voice services to only to the uBR10-MC5x20 line
cards for high availability.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-481
Cable Commands: cable s
cable service attribute non-ds-bonded downstream-type bonding-disabled
cable service attribute non-ds-bonded downstream-type
bonding-disabled
To force the non-bonding-capable modems to register only on non-bonded RF channels on the CMTS,
use the cable service attribute non-ds-bonded downstream-type bonding-disabled command in
global configuration mode. To restore default behavior, use the no form of the command.
cable service attribute non-ds-bonded downstream-type bonding-disabled
Syntax Description This command has no keywords or arguments.
Command Default The non-bonding-capable modem registers on its current primary channel.
Command Modes Global configuration
Command History Release Modification
12.3(23)BC This command was introduced for the Cisco uBR10012 router.
Usage Guidelines A modem is identified as a non-bonding-capable modem if the modem reports a Multiple Receive
Channel Support value of 1 for TLV 5.29 or an RCP ID unknown to the CMTS during the modem’s
registration request.
The non-bonding capable modem, identified at registration, will be moved to a non-bonded primary
channel through downstream frequency override, if its current primary channel is part of a bonding
group. The target non-bonded primary channel will be selected among primary capable channels that are
associated to the modem’s current upstream channel, however not included in any wideband channels
associated to any host interfaces on the local line card. Once this option is enabled, the bonded primary
channels will be taken out of load balancing group, to prevent non-bonding capable modems to be moved
back to bonded primary channels for load balancing purpose.
Note Enabling primary channel selection for wideband modems will not affect existing modems in the system.
The operator has to reset the existing non-bonding capable modems using the clear cable modem
command.
Examples Router# configure terminal
Router(config)# cable service attribute non-ds-bonded downstream-type bonding disabled
Cisco IOS CMTS Cable Command Reference
CBL-482 OL-15510-15
Cable Commands: cable s
cable service attribute non-ds-bonded downstream-type bonding-disabled
Related Commands cable dfo-retry-count Configures the Downstream Frequency Override (DFO) retry
count.
cable service attribute ds-bonded Forces a downstream bonding-capable modem to initialize on
downstream-type bonding-disabled a bonded primary-capable downstream channel.
cable service attribute voice-enabled Restricts voice services to only to the uBR10-MC5x20 line
cards for high availability.
clear cable modem Removes all modems or modems hosted by a uBR10-MC5x20
downstream interface under a specific category.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-483
Cable Commands: cable s
cable service attribute non-ds-bonded legacy-ranging downstream-type
cable service attribute non-ds-bonded legacy-ranging
downstream-type
To redirect potential non-bonding-capable modems that access the CMTS with INIT-RNG_REQ at
initialization to a specified downstream channel frequency, use the cable service attribute
non-ds-bonded legacy-ranging downstream-type command in global configuration mode. To restore
default behavior, use the no form of the command.
cable service attribute non-ds-bonded legacy-ranging downstream-type frequency freq
no cable service attribute legacy-ranging downstream-type
Syntax Description frequency freq Specifies the downstream channel frequency to which modems that access the
CMTS with legacy INIT-RNG-REQ are moved.
Command Default The non-bonding-capable modem continues the ranging process on the primary channel currently
selected by the modem for initialization.
Command Modes Global configuration
Command History Release Modification
12.3(23)BC This command was introduced for the uBR10012 router.
Usage Guidelines The cable service attribute non-ds-bonded command provides the ability to prevent potential
non-bonding-capable modems that access CMTS with legacy INIT-RNG-REQ at initialization to
register on a CMTS that supports bonding-capable modem. These modems that use legacy initial ranging
will be redirected to a specified downstream channel frequency.
Note If the frequency option is used and if the frequency is modified, then the new frequency setting will only
impact new modems trying to initialize after the frequency is modified. To enforce the downstream
channel selection policy on existing modems, each modem has to be manually reset either globally or at
the individual primary channel level using the clear cable modem command.
Examples Router# configure terminal
Router(config)# cable service attribute non-ds-bonded legacy-ranging downstream-type frequency
55000000
Cisco IOS CMTS Cable Command Reference
CBL-484 OL-15510-15
Cable Commands: cable s
cable service attribute non-ds-bonded legacy-ranging downstream-type
Related Commands cable service attribute voice-enabled Restricts voice services only to the uBR10-MC5x20 line cards
for high availability.
cable service attribute ds-bonded Forces a downstream-bonding capable modem to initialize on
downstream-type bonding-enabled a bonded primary-capable downstream channel.
cable service attribute Forces the non-bonding-capable modems to register only on
non-ds-bonded downstream-type non-bonded RF channels on the CMTS.
bonding-disabled
clear cable modem Removes all modems or modems hosted by a uBR10-MC5x20
line card downstream interface under a specific category.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-485
Cable Commands: cable s
cable service attribute voice-enabled
cable service attribute voice-enabled
To restrict voice services only to the uBR10-MC5X20 downstream interfaces for high availability, use
the cable service attribute voice-enabled command in global configuration mode. To remove the
restriction of voice services to the uBR10-MC5X20 downstream interfaces, use the no form of the
command.
cable service attribute voice-enabled downstream-type HA-capable
no cable service attribute voice-enabled downstream-type HA-capable
Syntax Description downstream-type Restricts voice services to a specific downstream type.
HA-capable Restricts voice services to the uBR10-MC 5x20 line card.
Command Default All primary-capable downstream channels on the uBR10-MC 5x20 line card and the SPA can support
downstream voice service flows.
Command Modes Global configuration
Command History Release Modification
12.3(23)BC This command was introduced for the Cisco uBR10012 router.
Usage Guidelines A voice-enabled cable modem is identified either at registration by decoding DHCP TLV 122 in the
modem's DHCP-ACK, or at its first voice call if DHCP TLV 122 is not exchanged. If a voice-enabled
modem is detected at registration on a SPA downstream channel, it will be moved to the uBR10-MC5x20
downstream channel in the CGD via downstream frequency override. If the voice-enabled modem is
detected at its first voice call after registration, it will be moved after the call is over to the
uBR10-MC5x20 channel in the CGD via DCC. If the voice enabled modem fails to come up on the target
uBR10-MC5x20 channel, the CMTS will continue to move the modem until three retries (the maximum
number of allowed retries) has been reached, when the modem will be allowed to stay on the SPA
downsream channel until another set of retries is attempted by the CMTS every 24 hours. A voice
enabled modem on the uBR10-MC5x20 channel will be excluded from being load balanced to a SPA
downstream channel. If this option is configured at any time after the system if up, voice enabled
modems that have been identified on the SPA dowsntream channel without active voice calls will be
gradually moved to the uBR10-MC5x20 downstream channel in the CGD at the rate of one modem per
five seconds.
Examples Router# configure terminal
Router(config)# cable service attribute voice-enabled downstream-type HA-capable
Cisco IOS CMTS Cable Command Reference
CBL-486 OL-15510-15
Cable Commands: cable s
cable service attribute voice-enabled
Related Commands cable service attribute non-ds-bonded Forces a non-bonding-capable modem to register only on
non-bonded RF channels.
cable service attribute ds-bonded Forces a downstream-bonding capable modem to initialize
on a bonded primary-capable DS channel.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-487
Cable Commands: cable s
cable service attribute withhold-TLVs
cable service attribute withhold-TLVs
To block sending of DOCSIS 3.0 time, length, value (TLVs) to DOCSIS 1.x and DOCSIS 2.0 cable
modems, use the cable service attribute withhold-TLVs command in global configuration mode. To
unblock sending of the DOCSIS 3.0 TLVs to DOCSIS 1.x and DOCSIS2.0 cable modems, use the no
form of this command.
cable service attribute withhold-TLVs peak-rate
no cable service attribute withhold-TLVs peak-rate
Syntax Description peak-rate Specifies the DOCSIS 3.0 peak traffic rate TLVs 24.27 and 25.27, which are
blocked from being sent to the non-DOCSIS 3.0 cable modems.
Command Default The DOCSIS 3.0 TLVs are sent to all cable modems.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCB10 This command was introduced for the Cisco uBR10012 router.
Usage Guidelines Some DOCSIS 1.x and DOCSIS 2.0 cable modems may fail to come online when they receive
DOCSIS 3.0 TLVs from the CMTS during registration. The cable service attribute withhold-TLVs
command allows you to restrict sending of the configured DOCSIS 3.0 TLVs to DOCSIS 1.x and
DOCSIS 2.0 cable modems. This command does not restrict sending of DOCSIS 3.0 TLVs to DOCSIS
3.0 cable modems.
Note In Cisco IOS Release 12.2(33)SCB10 only the peak-rate keyword is supported, which represents
TLVs 24.27 and 25.27.
Examples The following example shows how to configure the CMTS to restrict sending of DOCSIS 3.0 peak traffic
rate TLVs 24.27 and 25.27 to non-DOCSIS 3.0 cable modems:
Router # configure terminal
Router(config)# cable service attribute withhold-TLVs peak-rate
The following warning message is displayed when the above example is configured.
Warning: This configuration may violate D3.0 MULPI specification per section 6.4.8.
Cisco IOS CMTS Cable Command Reference
CBL-488 OL-15510-15
Cable Commands: cable s
cable service attribute withhold-TLVs
Related Commands Command Description
cable service class Defines and modifies a service class
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-489
Cable Commands: cable s
cable service class
cable service class
To set parameters for DOCSIS 1.1 cable service class, use the cable service class command in global
configuration mode. To delete a service class or to remove a configuration, use the no form of the
command.
cable service class class-index [keyword-options]
no cable service class class-index [keyword-options]
Syntax Description class-index Specifies the class ID for the class to be modified. Valid range is 1
to 255.
activity-timeout Specifies the activity timeout (0 to 65,535).
admission-timeout Specifies the admitted timeout (0 to 65,535).
downstream Specifies that the service class is for the downstream direction
(from the CMTS to the CM). (The default direction is upstream.)
grant-interval Specifies the grant interval (0 to 4,294,967,295 microseconds).
grant-jitter Specifies the grant jitter (0 to 4,294,967,295 microseconds).
grant-size Specifies the grant size (0 to 65,535 bytes).
grants-per-interval Specifies the grants per interval (0 to 127 grants).
max-burst Specifies the maximum transmission burst (1522 to 4,294,967,295
bytes).
Note The recommended value range is 1600 to 1800 bytes. Using
a value of 0 or greater than 1800 bytes can cause latency
issues for Voice-over-IP. A value of less than 1522 bytes
can prevent the upstream transmission of large ethernet
frames for any CM or CMTS not implementing
fragmentation.
max-buff-size Specifies the maximum buffer size of the upstream service-flow
queue (or buffer) on the CM. The valid range is from 0 to
4294967295 bytes. The default value is 0.
max-concat-burst Specifies the maximum concatenation burst (0 to 65,535 bytes).
max-latency Specifies the maximum latency allowed (0 to 4,294,967,295
microseconds).
max-rate Specifies the maximum rate (0 to 4,294,967,295 bps).
min-buff-size Specifies the minimum buffer size of the upstream service-flow
queue (or buffer) on the CM. The valid range is from 0 to
4294967295 bytes. The default value is 0.
min-packet-size Specifies the minimum packet size for reserved rate (0 to 65,535
bytes).
min-rate Specifies the minimum rate (0 to 4,294,967,295 bps).
name Specifies the service class name string.
peak-rate Specifies the peak rate (0 to 4,294,967,295 bps). Default value is
zero, which represents the line rate.
Note The peak-rate option is not supported on the DOCSIS 1.0
modems.
Cisco IOS CMTS Cable Command Reference
CBL-490 OL-15510-15
Cable Commands: cable s
cable service class
poll-interval Specifies the poll interval (0 to 4,294,967,295 microseconds).
poll-jitter Specifies the poll jitter (0 to 4,294,967,295 microseconds).
priority Specifies the priority (0 to 7, where 7 is the highest priority).
req-trans-policy Specifies the request transmission policy bit field (0 to FFFFFFF in
hexadecimal).
sched-type Specifies the service class schedule type:
2–Best-Effort Schedule Type
3–Non-Real-Time Polling Service Schedule Type (supported
only in Cisco 12.2(4)BC and later releases)
4–Real-Time Polling Service Schedule Type
5–Unsolicited Grant Service with Activity Detection Schedule
Type
6–Unsolicited Grant Service Schedule Type
tar-buff-size Specifies the target or desired size of the upstream service-flow
queue (or buffer) on the CM. The valid range is from 0 to
4294967295 bytes. The default value is 0.
tos-overwrite and-mask or-mask Overwrites the ToS byte by first ANDing the TOS value with the
and-mask value and then ORing the result of that operation with the
or-mask value. Both parameters must be specified in hexadecimal.
The and-mask value can range from 0x0 to 0xFF and the or-mask
value can range from 0x0 to 0xFF.
upstream Specifies that the service class is for the upstream direction (from
the CM to the CMTS). This is the default direction.
n Specifies the bundle identifier.
req-attr-mask Specifies the required attribute mask bit field (0 to FFFFFFF in
hexadecimal).
forb-attr-mask Specifies the forbidden attribute mask bit field (0 to FFFFFFF in
hexadecimal).
Command Default Values that are not specified are set to their DOCSIS 1.1 defaults, if applicable to the service-class
schedule type. See Section C.2.2, Service Flow Encodings, in the DOCSIS 1.1 specification.
Command Modes Global configuration (config)
Command History Release Modification
12.1(4)CX This command was introduced for DOCSIS 1.1 operation. This command replaced the
cable qos profile command that was used in previous versions for DOCSIS 1.0
operation.
12.2(4)BC1 This command was integrated into Cisco IOS release 12.2(4)BC1. This command was
also enhanced to support NRTPS scheduling.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-491
Cable Commands: cable s
cable service class
Release Modification
12.2(11)BC2 The default value for the maximum transmission burst parameter (max-burst) was
changed from 1522 bytes to 3044 bytes. The default value for the maximum
concatenation burst parameter was also changed from 0 bytes (unlimited) to 1522
bytes. These changes are to accommodate the latest revision of the DOCSIS 1.1
specification (SP-RFI-v1.1-I09-020830).
12.3BC This command was integrated into Cisco IOS release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS release 12.2(33)SCA.
12.2(33)SCB This command was modified with the addition of req-attr-mask and forb-attr-mask
keywords.
12.2(33)SCB1 This command was modified with the addition of peak-rate to set value greater than
the max-rate.
12.2(33)SCF2 This command was modified. Three new keywords max-buff-size, min-buff-size,
and tar-buff-size were added as part of the Upstream Buffer Control feature.
Usage Guidelines The sched-type option must always be specified for each class. When a certain scheduling type is
selected, take care that the mandatory parameters for that scheduling type are explicitly entered, while
nonapplicable parameters must be explicitly removed.
The default direction is upstream. We recommend that you do not change the direction of a service class
after you have created it, because some of the existing service class parameters might not be appropriate
for the new direction. Instead, delete the current service class and create a new service class with the
correct upstream or downstream direction.
If the service class is newly created, a service-class name must be defined before entering the parameters
for the service class.
Note Section C.2.2.6.10, IP Type of Service Overwrite, of the DOCSIS 1.1 specification changed the
operation of tos-overwrite option. In DOCSIS 1.1 networks, the new TOS value is calculated by the
following formula: New IP TOS = ((Original TOS value AND and-mask) OR or-mask). (For a
description of the previous method of calculating the TOS value, see the cable qos profile command.)
The default is to leave the TOS value unchanged (no overwrite).
Examples The following examples show configurations that use the cable service class command to create service
classes. Based on the scheduling type specified, some command lines are mandatory, while others are
optional.
Each example shown here is a complete configuration set for creating a service class.
Configuring a Service Class for Unsolicited Grant Scheduling Service
Router(config)# cable service class 1 name UP_UGS
Router(config)# cable service class 1 sched-type 6
Router(config)# cable service class 1 grant-size 100
Router(config)# cable service class 1 grant-interval 20000
Router(config)# cable service class 1 grant-jitter 4000
Router(config)# cable service class 1 grants-per-interval 1
Router(config)# cable service class 1 min-packet-size 100
Router(config)# cable service class 1 req-trans-policy 0x1FF
Router(config)# cable service class 1 tos-overwrite 0x1F 0xE0
Router(config)# cable service class 1 activity-timeout 30
Cisco IOS CMTS Cable Command Reference
CBL-492 OL-15510-15
Cable Commands: cable s
cable service class
Router(config)# cable service class 1 admission-timeout 30
Configuring a Service Class for Unsolicited Grant Scheduling with Activity Scheduling
Router(config)# cable service class 2 name UP_UGSAD
Router(config)# cable service class 2 sched-type 5
Router(config)# cable service class 2 grant-size 100
Router(config)# cable service class 2 grant-interval 20000
Router(config)# cable service class 2 grant-jitter 4000
Router(config)# cable service class 2 grants-per-interval 1
Router(config)# cable service class 2 poll-interval 10000
Router(config)# cable service class 2 poll-jitter 4000
Router(config)# cable service class 2 min-packet-size 100
Router(config)# cable service class 2 req-trans-policy 0x1FF
Router(config)# cable service class 2 tos-overwrite 0x1F 0xE0
Router(config)# cable service class 2 activity-timeout 30
Router(config)# cable service class 2 admission-timeout 30
Configuring a Service Class with Real-Time Polling Service
Router(config)# cable service class 3 name UP_RTPS
Router(config)# cable service class 3 sched-type 4
Router(config)# cable service class 3 poll-interval 10000
Router(config)# cable service class 3 poll-jitter 4000
Router(config)# cable service class 3 min-rate 64000
Router(config)# cable service class 3 max-rate 128000
Router(config)# cable service class 3 max-burst 2000
Router(config)# cable service class 3 max-concat-burst 1522
Router(config)# cable service class 3 req-trans-policy 0x1FF
Router(config)# cable service class 3 tos-overwrite 0x1F 0xE0
Router(config)# cable service class 3 activity-timeout 30
Router(config)# cable service class 3 admission-timeout 30
Configuring a Service Class for Best-Effort Upstream Service
Router(config)# cable service class 4 name UP_BE
Router(config)# cable service class 4 sched-type 2
Router(config)# cable service class 4 priority 5
Router(config)# cable service class 4 min-rate 0
Router(config)# cable service class 4 max-rate 128000
Router(config)# cable service class 4 max-burst 2000
Router(config)# cable service class 4 max-concat-burst 1522
Router(config)# cable service class 4 req-trans-policy 0x0
Router(config)# cable service class 4 tos-overwrite 0x1F 0xE0
Router(config)# cable service class 4 activity-timeout 30
Router(config)# cable service class 4 admission-timeout 30
Configuring a Service Class for Best-Effort Downstream Service
Router(config)# cable service class 5 name DOWN_BE
Router(config)# cable service class 5 priority 5
Router(config)# cable service class 5 min-rate 0
Router(config)# cable service class 5 max-rate 1000000
Router(config)# cable service class 5 max-burst 3000
Router(config)# cable service class 5 activity-timeout 30
Router(config)# cable service class 5 admission-timeout 30
Configuring a Service Class for Peak-Rate
Router(config)# cable service class 201 name hsd
Router(config)# cable service class 201 downstream
Router(config)# cable service class 201 max-rate 1024000
Router(config)# cable service class 201 min-rate 1024000
Router(config)# cable service class 201 peak-rate 2000000
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-493
Cable Commands: cable s
cable service class
Configuring a Service Class with Upstream Buffer Control Parameters
Router(config)# cable service class 10 name REG-US
Router(config)# cable service class 10 upstream
Router(config)# cable service class 10 max-buff-size 20000
Router(config)# cable service class 10 min-buff-size 10000
Router(config)# cable service class 10 tar-buff-size 15000
Associated Features The cable service class command is used to configure the following features:
• Configuring Upstream Cable Interface Features on the Cisco CMTS Routers
• Upstream Scheduler Mode for the Cisco CMTS Routers
Related Commands Command Description
cable qos profile Creates a DOCSIS 1.0 QoS profile.
show cable service-class Displays the service classes that have been created.
Cisco IOS CMTS Cable Command Reference
CBL-494 OL-15510-15
Cable Commands: cable s
cable service flow activity-timeout
cable service flow activity-timeout
To configure the activity timeout for dynamic cable service flows in DOCSIS 1.1 environments, where
PacketCable is inactive, use the cable service flow activity-timeout command in global configuration
mode. To remove the activity timer once configured, use the no form of this command.
cable service flow activity-timeout n
no cable service flow activity-timeout [<n>]
Syntax Description n The timeout length in seconds. Valid range is 0 - 65535 seconds. Setting this value to 0 configures
the service flow to never timeout.
Command Default The default timeout length for a DOCSIS 1.0+ cable service flow is 300 seconds (five minutes).
Command Modes Global configuration
Command History Release Modification
12.3(13a)BC2 This command was introduced to support DOCSIS 1.1 service flow operation in
non-Packet-Cable environments.
Usage Guidelines Dynamic service flows in DOCSIS 1.0+ are created with a default activity timeout of 300 seconds. This
enables the deletion of idle service flows after five minutes. This new command enables such functions
within DOCSIS 1.1 environments with a wide range of timeout length options.
In DOCSIS 1.1, the default inactivity timeout is often set by the application that triggers the creation of
dynamic service flows. PacketCable frequently performs this function when supported on the Cisco
CMTS. However, this new command configures inactivity timeout where PacketCable is not active on
the Cisco CMTS.
Note When PacketCable is supported, PacketCable sets the inactivity timeout from the PacketCable gate, and
the PacketCable activity overrides timeout values set with this command. This is the case even where
the inactivity timeout is set to zero, which configures the service flow to never timeout.
Apart from PacketCable, this command enables the cable modemto control the setup of the dynamic
service flows, and to remove inactive service flows. During the creation of service flows, all Upstream
and Downstream flows in the request are checked to see if the configured activity timeout needs to be
applied.
Note The cable service flow activity-timeout command affects new calls only; it does not clear any existing
hung flows. To clear existing flows, use the test cable dsd <mac-add> <sid> command.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-495
Cable Commands: cable s
cable service flow activity-timeout
Examples The following example in global configuration mode configures the cable modems connected to the
Cisco CMTS to use activity timeout of zero, which means that related service flows do not timeout in a
non-PacketCable environment:
Router(config)# cable service flow activity-timeout 0
Related Commands Command Description
cable qos profile Creates a DOCSIS 1.0 QoS profile.
cable service flow inactivity-threshold Sets the amount of time a dynamic service-flow can be present
in the system without any activity (DOCSIS 1.1 operation).
cable service-flow inactivity-timeout Sets the amount of time a dynamic service-flow can be present
in the system without any activity (DOCSIS 1.0 operation).
show cable service-class Displays the service classes that have been created.
Cisco IOS CMTS Cable Command Reference
CBL-496 OL-15510-15
Cable Commands: cable s
cable service flow inactivity-threshold
cable service flow inactivity-threshold
To set the inactivity threshold value for service flows using Unsolicited Grant Service with Activity
Detection (UGS-AD), use the cable service flow inactivity-threshold command in global configuration
mode. To disable the inactivity timer and reset the threshold limit timer to its default of 10 seconds, so
that service flows revert to UGS activity only, use the no form of this command.
cable service flow inactivity-threshold n
no cable service flow inactivity-threshold n
Syntax Description n Specifies the threshold limit in seconds, with 10 seconds as the default. Configurable limits are 1 to
3600 seconds.
Command Default The default is to enable the inactivity timer, with a default value of 10 seconds.
Command Modes Global configuration
Command History Release Modification
12.1(4)CX This command replaced the cable service-flow inactivity-timeout command for
DOCSIS 1.1 operation.
12.2(4)BC1 Support for this command was added to the Release 12.2 BC train.
Usage Guidelines DOCSIS 1.1 allows a CM to request Unsolicited Grant Service (UGS) for an upstream, allowing the CM
to reserve a certain amount of Constant Bit Rate (CBR) bandwidth for real-time traffic, such as
Voice-over-IP (VoIP) calls. The UGS-AD variation allows the CMTS to switch a service flow to Real
Time Polling Service (RTPS) after a certain period of inactivity, so that bandwidth is not reserved when
it is not needed. The CM can then request UGS service when the flow again becomes active.
Note This command replaced the cable service-flow inactivity-timeout command, which was used in
DOCSIS 1.0 operation to enable or disable watchdog cleanup of dynamic service flows that are not
sending any packets on the upstream.
The cable service flow inactivity-threshold command sets the inactivity timer for how long a service
flow must be inactive before the CMTS can switch it from UGS-AD to RTPS. The no cable service flow
inactivity-threshold command disables the timer and resets it to its default value of 10 seconds, so that
the CMTS always provides UGS service to the service flow, even when the flow is idle.
Caution The no cable service flow inactivity-threshold command effectively disables the use of RTPS and
USG-AD services and configures the CMTS to provide only UGS services. This will prevent a CM that
registered for USG-AD services from being able to obtain upstream transmission opportunities, resulting
in a significant loss of bandwidth when a large number of CMs are requesting UGS-AD service flows.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-497
Cable Commands: cable s
cable service flow inactivity-threshold
Examples The following example shows the inactivity timer being set to 20 seconds:
Router(config)# cable service flow inactivity-threshold 20
Router(config)#
The following command disables the inactivity timer, so that the service flow remains UGS, even during
periods of inactivity:
Router(config)# no cable service flow inactivity-threshold
Router(config)#
Related Commands Command Description
cable service class Sets the DOCSIS 1.1 service class parameters.
cable service-flow inactivity-timeout Sets the amount of time a dynamic service-flow can be present in
the system without any activity (DOCSIS 1.0 operation).
show controllers cable Displays information for the cable interface.
Cisco IOS CMTS Cable Command Reference
CBL-498 OL-15510-15
Cable Commands: cable s
cable service-flow inactivity-timeout
cable service-flow inactivity-timeout
To set the amount of time a dynamic service-flow can be present in the system without any activity, use
the cable service-flow inactivity-timeout command in global configuration mode. To remove the
specification, use the no form of this command.
cable service-flow inactivity-timeout minutes
no cable service-flow inactivity-timeout
Syntax Description minutes Specifies service-flow inactivity-timeout in minutes. Valid range is 1 to 120 minutes. Default
value is 30 minutes.
Command Default 30 minutes
Command Modes Global configuration
Command History Release Modification
12.1(3a)EC This command was introduced.
12.1(4)CX This command was replaced by the cable service flow inactivity-threshold command
for DOCSIS 1.1 operation.
Usage Guidelines Resources such as service identifiers (SIDs) and bandwidth are dynamically allocated by a CM using
Dynamic Service Addition (DSA) transaction. If the CM fails to release these resources by issuing a
Dynamic Service Deletion (DSD), then the resources might be locked indefinitely. Use this command
to release unused resources.
Examples The following example shows how to set the inactivity timeout for dynamic service flows to 2 minutes.
Once this setting is specified, any dynamic SID that does not show any activity in 2 minutes will be
deleted.
Router(config)# cable service-flow inactivity-timeout 2
The following example shows how to set the inactivity timeout back to the default value of 30 minutes:
Router(config)# cable service-flow inactivity-timeout
Related Commands Command Description
cable service flow inactivity-threshold Sets the amount of time a dynamic service-flow can be present
in the system without any activity (DOCSIS 1.1 operation).
cable qos permission Specifies permission for updating the cable router QoS table.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-499
Cable Commands: cable s
cable service-flow inactivity-timeout
Command Description
cable qos profile Configures a QoS profile.
show controllers cable Displays QoS profiles.
Cisco IOS CMTS Cable Command Reference
CBL-500 OL-15510-15
Cable Commands: cable s
cable service type
cable service type
To redirect CMs matching a service-type to downstream frequency, use the cable service type command
in global configuration mode. To cancel the redirection of CMs, use the no form of this command.
cable service type service-type-id ds-frequency frequency
no cable service type service-type-id ds-frequency frequency
Syntax Description service-type-id Specifies the service type identifier to be redirected.
The maximum length of service-type-id is 16.
ds-frequency Specifies the downstream frquency the CMs will be redirected to.
frequency
Command Default Disabled
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines This command will redirect the CMs matching a particular service-type identifier to downstream
frequency. Multiple service types can be redirected to one frequency. However, one service type cannot
be redirected to multiple DS frequencies.
Examples The following example shows how to redirect the CMs matching the service type to downstream
frequency:
Router(config)# cable service type commercial ds-frequency 519000000
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-501
Cable Commands: cable s
cable set mpls-experimental
cable set mpls-experimental
To specify experimental bits for Multiprotocol Label Switching (MPLS) labels, use the cable set
mpls-experimental command in Ethernet service configuration mode. To disable this configuration, use
the no form of this command.
cable set mpls-experimental value
no cable set mpls-experimental value
Syntax Description value Experimental bit for MPLS labels. Valid values are from 0 to 7.
Command Default If this command is not used, the experimental bits on the MPLS label are set to zero.
Command Modes Ethernet service configuration (config-ethsrv)
Command History Release Modification
12.2(33)SCC This command was introduced in Cisco IOS Release 12.2(33)SCC.
Usage Guidelines The experimental bits are set for all inner and outer MPLS labels for the egress Layer 2 VPN traffic on
the WAN interface.
Examples The following example shows how to set an experimental bit for MPLS labels on a Cisco uBR10012
router:
Router# configure terminal
Router(config)# cable l2vpn 0000.396e.6a68 customer1
Router(config-l2vpn)# service instance 2000 Ethernet
Router(config-ethsrv)# xconnect 101.1.0.2 221 encapsulation mpls pw-type 4
Router(config-ethsrv)# cable set mpls-experimental 7
Related Commands Command Description
cable l2vpn Enables Ethernet L2VPN service and enters L2VPN configuration mode.
service instance Configures an Ethernet service instance for a particular customer.
xconnect Binds an attachment circuit to a pseudowire.
Cisco IOS CMTS Cable Command Reference
CBL-502 OL-15510-15
Cable Commands: cable s
cable sflog
cable sflog
To enable service flow logging and to configure the number and duration of entries in the log, use the
cable sflog command in global configuration mode. To disable service flow logging, use the no form of
the command.
cable sflog max-entry number entry-duration time
no cable sflog
Syntax Description max-entry number Specifies the maximum number of entries in the service flow log. When the
log becomes full, the oldest entries are deleted to make room for new entries.
The valid range is 0 to 59999, with a default of 0 (which disables service
flow logging).
Note The max-entry value applies to the entire chassis on the
Cisco uBR7100 series and Cisco uBR7200 series routers, but applies
to individual cable line cards on the Cisco uBR10012 router.
entry-duration time Specifies how long, in seconds, entries can remain in the service flow log.
The CMTS deletes entries in the log that are older than this value. The valid
range is 1 to 86400 seconds, with a default value of 3600 seconds (1 hour).
Defaults max-entry = 0 (service flow logging is disabled) and entry-duration = 3600 seconds
Command Modes Global configuration
Command History Release Modification
12.2(15)BC1 This command was introduced.
Usage Guidelines A DOCSIS specification currently being developed requires the DOCSIS CMTS to maintain a log table
that contains entries of deleted service flows. The cable sflog command enables the logging of deleted
service flows in this table and also sets the maximum number of entries in the log. When the log becomes
full, the oldest entries are deleted to make room for the newest ones.
This command also configures how long each entry can remain in the log. When an entry has been in
the table for the specified time, the CMTS deletes it, even if the log is not currently full.
To display the service flow log, use SNMP commands to display the docsQosServiceFlowLogEntry
entries in the docsQosServiceFlowLogTable table. These attributes are defined in the Data Over Cable
System Interface Specification Quality of Service Management Information Base (DOCSIS-QOS MIB)
internet draft.
Cisco IOS Release 12.2(15)BC1 supports version 4 of this DOCSIS-QOS MIB draft, which is available
on the IETF Internet-Drafts web site:
http://http://www.ietf.org/ID.html
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-503
Cable Commands: cable s
cable sflog
Note At the time of this document’s release, the DOCSIS-QOS MIB is still in draft form and is therefore
subject to change in future releases of Cisco IOS software.
The max-entry value specified by this command applies to the entire chassis for the Cisco uBR7100
series and Cisco uBR7200 series routers, but to individual line cards on the Cisco uBR10012 router.
However, the Cisco uBR10012 router still maintains only one log table for all deleted service flows.
For example, if the max-entry value is set to 10,000 on a Cisco uBR7200 series router, the service flow
log table holds a maximum of 10,000 entries for all cable line cards in the chassis. If the max-entry value
is set to 10,000 on a Cisco uBR100012 router that has four cable line cards installed, the service flow
log table holds a maximum of 40,000 entries, with each cable line card having a maximum of 10,000
entries each.
Examples The following example shows how to enable service flow logging with a maximum of 2,000 entries in
the log, and with each entry remaining in the log for a maximum of 2 hours (7200 seconds):
Router(config)# cable sflog max-entry 2000 entry-duration 7200
The following example shows how to set the max-entry value to its default of 0 and disable service flow
logging:
Router# configure terminal
Router(config)# no cable sflog
Router(config)# exit
Router#
Related Commands Command Description
cable service-flow Sets the amount of time a dynamic service-flow can be present in the system
inactivity-timeout without any activity (DOCSIS 1.0 operation).
cable service flow Sets the amount of time a dynamic service-flow can be present in the system
inactivity-threshold without any activity (DOCSIS 1.1 operation).
Cisco IOS CMTS Cable Command Reference
CBL-504 OL-15510-15
Cable Commands: cable s
cable shared-secondary-secret
cable shared-secondary-secret
To configure one or more secondary shared-secret keys that CMs can use to successfully process the
DOCSIS configuration file and register with the CMTS, use the cable shared-secondary-secret
command in cable interface configuration mode. To remove the secondary shared secrets, use the no
form of this command.
cable shared-secondary secret index index-num [0 | 7] authentication-key
no cable shared-secondary secret index index-num
Syntax Description index index-num Specifies the order in which the CMTS will use the secondary shared-secrets
to verify the CM during the registration process. The valid range is 1 to 16.
0 (Optional) Specifies that an unencrypted message will follow.
7 (Optional) Specifies that an encrypted message will follow.
Note As a general rule, the 7 option is not used by users at the command
line because it requires a pre-encrypted password. Typically, the 7
option is useful only when cutting and pasting commands from
another router’s configuration file.
authentication-key Text string specifying the shared secret string. When you also use the service
password-encryption command, the key is stored in encrypted form. The
text string can be any arbitrary string up to 80 characters in length.
Defaults No secondary shared secret is used. If no encryption option is specified, the key is stored in the
configuration file as encrypted text if the service password-encryption command has also been given.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.2(8)BC2 This command was introduced.
Usage Guidelines The cable shared-secondary-secret command can be used to supplement the cable shared-secret
command so as to prevent unauthorized interception and alteration of the DOCSIS configuration file that
is downloaded to the CM during the registration process. The DOCSIS specification allows for a CM
and CMTS to use a shared secret (a secret encryption string) to calculate the MD5 Message Integrity
Check (MIC) value for the DOCSIS configuration file that is downloaded to the CM.
The CM must use the proper shared secret encryption string to successfully decrypt and process the
configuration file, and then register with the CMTS. If the CM does not have the proper encryption
string, it will be unable to calculate the proper MIC value, and the show cable modem command will
show reject(m) for the modem to indicate a MIC authentication failure.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-505
Cable Commands: cable s
cable shared-secondary-secret
The cable shared-secondary-secret command allows a cable operator to specify up to 16 alternate
DOCSIS shared secrets. If a CM has a MIC authentication failure during registration, the CMTS then
checks the MIC values using the alternate shared secrets. If a match is found, the CM is allowed online.
If none of the alternate MIC values match the value returned by the CM, the CMTS refuses to allow the
CM to come online and instead logs a MIC authentication failure.
The use of secondary shared secrets allow the MSO to gradually phase in changes to the shared secret
key. If a shared secret has been compromised, or if the MSO decides to regularly change the shared
secret, the MSO can use the cable shared-secret command to immediately change the primary shared
secret. The previous key can then be made a secondary shared secret, using the cable
shared-secondary-secret command, so that CMs can continue to register until the MSO can change all
of the DOCSIS configuration files to use the new shared secret.
To use the secondary shared-secret feature, you must do the following:
• You must specify a shared secret with the cable shared-secret command. The cable
shared-secondary-secret command has no effect if you have not specified a primary shared secret.
Note At any particular time, the majority of CMs should use the primary shared secret to avoid
excessive registration times.
• Create DOCSIS configuration files that use the shared-secret encryption string to create the MD5
MIC value. This can be done using the Cisco DOCSIS Configurator tool by entering the
shared-secret string in the CMTS Authentication field in the Miscellaneous parameters.
Tip The shared-secret string itself is not saved in the DOCSIS configuration file, so you must re-enter the
string in the CMTS Authentication field whenever you create or edit a DOCSIS configuration file using
the Cisco DOCSIS Configurator tool.
• Use the cable shared-secondary-secret command to configure the cable interfaces with one or
more matching shared-secret strings. The string configured on an interface must match the string
used to create the DOCSIS configuration files downloaded to the CMs on that interface, or the CMs
will not be able to register. You can use different shared secrets for each interface, if you are also
using a different set of configuration files for each interface.
• To encrypt the shared-secret strings in the CMTS configuration, you must include the service
password-encryption global configuration command in the router’s configuration.
Note You cannot use the shared secret feature with the files created by the internal DOCSIS configuration file
editor (cable config-file command).
Examples The following example shows how to specify multiple secondary shared-secret string using encrypted
keys:
Router# config t
Router(config)# service password-encryption
Router(config)# int c6/0
Router(config-if)# cable shared-secret n01jk_1a
Router(config-if)# cable shared-secondary-secret index 1 cabl3-x21b
Router(config-if)# cable shared-secondary-secret index 2 dasc9_ruld55ist5q3z
Router(config-if)# cable shared-secondary-secret index 3 j35u556_x_0
Router(config-if)# exit
Cisco IOS CMTS Cable Command Reference
CBL-506 OL-15510-15
Cable Commands: cable s
cable shared-secondary-secret
Router(config)# exit
Router# show running-config | include shared
cable shared-secret 7 1407513181A0F13253920
cable shared-secondary-secret 7 14031A021F0D39263D3832263104080407
cable shared-secondary-secret 7 071B29455D000A0B18060615142B38373F3C2726111202431259545D6
cable shared-secondary-secret 7 0501555A34191B5F261D28420A555D
Router#
Note In this example, the shared-secret strings are initially entered as clear text, but because the service
password-encryption command has been used, the strings are encrypted in the configuration file.
Related Commands Command Description
cable dynamic-secret Enables the dynamic shared secret feature, so that DOCSIS configuration
files are verified with a dynamically generated shared secret.
cable shared-secret Configures an authentication shared-secret key that CMs must use to
successfully process the DOCSIS configuration file and register with the
CMTS.
cable tftp-enforce Requires that all CMs on a cable interface attempt to download a DOCSIS
configuration file using the Trivial File Transfer Protocol (TFTP) through
the cable interface before being allowed to register and come online.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-507
Cable Commands: cable s
cable shared-secret
cable shared-secret
To configure an authentication shared-secret encryption key that CMs must use to successfully process
the DOCSIS configuration file and register with the CMTS, use the cable shared-secret command in
cable interface configuration mode. To disable the use of a shared-secret key during the CM registration
phase, use the no form of this command.
cable shared-secret [0 | 7] authentication-key
no cable shared-secret
Syntax Description 0 (Optional) Specifies that an unencrypted message (clear text) will follow.
7 (Optional) Specifies that an encrypted message will follow.
Note As a general rule, the 7 option is not used by users at the command
line because it requires a pre-encrypted password. Typically, the 7
option is useful only when cutting and pasting commands from
another router’s configuration file.
authentication-key Text string specifying the shared secret string. When you also use the service
password-encryption command, the key is stored in encrypted form. The
text string can be any arbitrary string up to 80 characters in length.
Defaults No shared-secret encryption key is used during registration, only the default DOCSIS MD5-encrypted
checksum. When cable shared-secret is given without specifying an encryption option, the key is stored
in the configuration file as an encrypted password if the service password-encryption command has
also been given.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
11.3 XA This command was introduced.
Usage Guidelines The cable shared-secret command can be used to prevent unauthorized interception and alteration of
the DOCSIS configuration file that is downloaded to the CM during the registration process. The cable
shared-secret command specifies a secret encryption string that the CMTS uses to calculate the MD5
Message Integrity Check (MIC) value that is appended to every DOCSIS configuration file and that the
CM and CMTS use to verify the file’s integrity.
The CM must use the shared secret encryption string to successfully decrypt and process the
configuration file, and then register with the CMTS. If the CM does not have the proper encryption
string, it will be unable to calculate the proper MIC value, and the show cable modem command will
show reject(m) for the modem to indicate a MIC authentication failure.
Cisco IOS CMTS Cable Command Reference
CBL-508 OL-15510-15
Cable Commands: cable s
cable shared-secret
To use the shared-secret feature, you must do the following:
• Create DOCSIS configuration files that use the shared-secret encryption string to create the MD5
MIC value. This can be done using the Cisco DOCSIS Configurator tool by entering the
shared-secret string in the CMTS Authentication field in the Miscellaneous parameters.
Note The shared-secret string itself is not saved in the DOCSIS configuration file, so you must
re-enter the string in the CMTS Authentication field whenever you create or edit a DOCSIS
configuration file using the Cisco DOCSIS Configurator tool.
• Use the cable shared-secret command to configure the cable interfaces with a matching
shared-secret string. The string configured on an interface must match the string used to create the
DOCSIS configuration files downloaded to the CMs on that interface, or the CMs will not be able
to register. You can use different shared secrets for each interface, if you are also using a different
set of configuration files for each interface.
• To encrypt the shared-secret string in the CMTS configuration, you must include the service
password-encryption global configuration command in the router’s configuration.
Note You cannot use the shared secret feature with the files created by the internal DOCSIS configuration file
editor (cable config-file command).
Note In Cisco IOS Release 12.2(8)BC2 and later releases, you can also use the cable
shared-secondary-secret command to specify multiple shared-secret strings, so that you can gradually
phase in a new shared secret string.
Upgrading When Using Shared Secret Passwords
Cisco IOS Release 12.2 BC changed the encryption algorithm used for the cable shared-secret
command. If you are upgrading from a Cisco IOS 12.1 EC or 12.0 SC release, you cannot cut and paste
the cable shared-secret configuration lines that include an encrypted password. Instead, you must
re-enter the original shared secret passwords at the CLI prompt, and then resave the configuration.
For example, if the actual shared secret password is “cm-sharedsecret-password”, enter the cable
shared-secret cm-sharedsecret-password command at the CLI prompt. If you have enabled password
encryption, the configuration file will then show only the newly encrypted password.
Note This change affects only the encryption of the passwords that are stored in the configuration file. It does
not affect the actual encryption that is used between the CMTS and CMs, so you do not need to change
the shared secret in the DOCSIS configuration files for the CMs.
Examples The following example shows how to specify a shared-secret string using an encrypted key:
Router# config t
Router(config)# service password-encryption
Router(config)# int c6/0
Router(config-if)# cable shared-secret password
Router(config-if)# exit
Router(config)# exit
Router# show running-config | include shared
cable shared-secret 7 1407513181A0F13253920
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-509
Cable Commands: cable s
cable shared-secret
Router#
Note In this example, the shared-secret string is initially entered as clear text, but because the service
password-encryption command has been used, the string is encrypted in the configuration file.
The following example shows how to remove the use of a shared-secret encryption key on a cable
interface. That particular interface then ignores any shared-secret that is used when calculating the MD5
checksum:
Router# config t
Router(config)# int c6/0
Router(config-if)# no cable shared-secret
Router(config-if)# end
Router#
Related Commands Command Description
cable dynamic-secret Enables the dynamic shared secret feature, so that DOCSIS
configuration files are verified with a dynamically generated shared
secret.
cable Configures one or more secondary shared-secret keys that CMs can use
shared-secondary-secret to successfully process the DOCSIS configuration file and register with
the CMTS.
cable tftp-enforce Requires that all CMs on a cable interface attempt to download a
DOCSIS configuration file using the Trivial File Transfer Protocol
(TFTP) through the cable interface before being allowed to register and
come online.
Cisco IOS CMTS Cable Command Reference
CBL-510 OL-15510-15
Cable Commands: cable s
cable sid-cluster-group
cable sid-cluster-group
To configure a SID cluster group on a cable interface line card, use the cable sid-cluster-group
command in cable interface configuration mode. To disable the configuration, use the no form of this
command.
cable sid-cluster-group [dynamic | req-multiplier value | num-of-cluster number]
no cable sid-cluster-group [dynamic | req-multiplier value | num-of-cluster number]
Syntax Description dynamic If specified, the SID cluster is dynamically derived based on the service flow
rate.
req-multiplier value Specifies the queue-depth request byte multiplier. Valid values are 1, 2, 4, 8,
and 16. A cable modem uses queue-depth based requesting for all bandwidth
requests, if the Multiple Transmit Channel mode is enabled.
num-of-cluster number Specifies the number of SID clusters. Valid values are from 1 to 8. The
default value is 1.
Command Default None
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCC This command was introduced in Cisco IOS Release 12.2(33)SCC.
Usage Guidelines The SID cluster configuration may impact overall system performance. So we recommend not to
customizing SID cluster values unless justified. The default SID cluster configuration will meet most of
the requirements.
If the cable sid-cluster-group command is not used, the router accepts the default SID cluster
configuration. By default, only one SID cluster is configured.
Examples The following example shows how to configure a SID cluster on a cable interface in slot 5, subslot 1,
and port 0 on a Cisco uBR10012 router:
Router# configure terminal
Router(config)# interface cable 5/1/0
Router(config-if)# cable sid-cluster-group
Router(config-if)# cable sid-cluster-group dynamic
Router(config-if)# cable sid-cluster-group req-multiplier 8
Router(config-if)# cable sid-cluster-group num-of-cluster 3
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-511
Cable Commands: cable s
cable sid-cluster-group
Related Commands Command Description
cable sid-cluster-switching Specifies SID cluster switchover criteria on a cable interface line card.
Cisco IOS CMTS Cable Command Reference
CBL-512 OL-15510-15
Cable Commands: cable s
cable sid-cluster-switching
cable sid-cluster-switching
To specify Service ID (SID) cluster switchover criteria on a cable interface line card, use the
cable sid-cluster-switching command in cable interface configuration mode. To disable the
configuration, use the no form of this command.
cable sid-cluster-switching [max-outstanding-byte value | max-request value | max-time
seconds | max-total-byte value]
no cable sid-cluster-switching [max-outstanding-byte value | max-request value | max-time
seconds | max-total-byte value]
Syntax Description max-outstanding-byte (Optional) Specifies the total size, in bytes, for outstanding requests using
value the SID cluster. The valid values are from 0 to 4294967295.
max-request value (Optional) Specifies the maximum number of requests that can be made
using the SID cluster. The valid values are from 0 to 255. The default value
is 1.
max-time milliseconds (Optional) Specifies the total time, in milliseconds, that a service flow can
continue to use the SID cluster for bandwidth requests. The valid values are
from 0 to 65535.
max-total-byte value (Optional) Specifies the total number of bytes that can be requested using the
SID cluster. The valid values are from 0 to 4294967295.
Command Default None
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCC This command was introduced in Cisco IOS Release 12.2(33)SCC.
Usage Guidelines If the service flow has only one SID cluster and the SID cluster switchover criterion limit is met, the
cable modem stops sending bandwidth requests until the SID cluster is cleared.
The SID cluster configuration along with switchover criterion may impact overall system performance.
So we recommend not to customizing switchover criterion unless justified. The default switchover
criterion will meet most of the requirements. If the cable sid-cluster-switching command is not used,
the router accepts the default SID cluster switchover criterion. That is only one request can be made
using the SID cluster.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-513
Cable Commands: cable s
cable sid-cluster-switching
Examples The following example shows how to specify SID cluster switchover criteria on a cable interface in slot
5, subslot 1, and port 0 on a Cisco uBR10012 router:
Router# configure terminal
Router(config)# interface cable 5/1/0
Router(config-if)# cable sid-cluster-switching
Router(config-if)# cable sid-cluster-switching max-outstanding-byte 4444
Router(config-if)# cable sid-cluster-switching max-request 222
Router(config-if)# cable sid-cluster-switching max-time 444
Router(config-if)# cable sid-cluster-switching max-total-byte 67890
Related Commands Command Description
cable sid-cluster-group Configures a SID cluster on a cable interface line card.
Cisco IOS CMTS Cable Command Reference
CBL-514 OL-15510-15
Cable Commands: cable s
cable source-route
cable source-route
To configure the virtual routing and forwarding instance (VRF) source route, use the cable source-route
command in the cable modem's subinterface configuration mode. To disable the route, use the no form
of this command.
cable source-route
no cable source-route
Syntax Description This command has no arguments or keywords.
Command Default The VRF source route is not configured.
Command Modes Subinterface configuration (config-subif)
Command History Release Modification
12.2(33)SCF This command was introduced.
Examples The following example shows how to configure the VRF source route:
Note This command is supported on the Cisco uBR10012 broadband routers only.
Router(config-subif)# cable source-route
Related Commands Command Description
cable vrf-steering Steers or directs the cable modems to the specified VRF.
cable-modem
ip vrf Defines a VRF instance and enters the interface configuration mode.
show ip arp vrf Displays which VRF contains a specific cable modem in the ARP table.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-515
Cable Commands: cable s
cable source-verify
cable source-verify
To enable verification of IP addresses for CMs and CPE devices on the upstream, use the
cable source-verify command in cable interface or subinterface configuration mode. To disable
verification, use the no form of this command.
cable source-verify [dhcp | leasetimer value]
no cable source-verify
Syntax Description dhcp (Optional) Specifies that queries will be sent to verify unknown source
IP addresses in upstream data packets.
leasetimer value (Optional) Specifies the time, in minutes, for how often the router
should check its internal CPE database for IP addresses whose lease
times have expired. The valid range for value is 1 to 240 minutes, with
a default of 60 minutes.
Command Default Disabled. When the dhcp option is specified, the leasetimer option defaults to 60 minutes.
Command Modes Interface configuration (config-if)
Subinterface configuration (config-subif)
Command History Release Modification
11.3 XA This command was introduced.
12.0(7)T The dhcp keyword was added.
12.0(10)SC, 12.1(2)EC Support was added for these trains.
12.1(3a)EC Subinterface support was added.
12.1(13)EC, The leasetimer keyword was added.
12.2(11)BC1
12.2(15)BC1 The verification of CPE devices was changed when using the dhcp keyword.
12.2(15)BC2 Support for verifying CMs and CPE devices that are on a different subnet
than the cable interface was enhanced to use Reverse Path Forwarding
(RFP).
12.3(9a)BC Cisco IOS Release 12.3(9a)BC adds the option of using a per SID basis for
deriving lease queries from CPE devices. This release also introduces a
global rate limit for lease queries initiated by downstream traffic.
Usage Guidelines Configuring the cable source-verify command on the master interface of a bundle will configure it for
all of the slave interfaces in the bundle as well.
Cisco IOS CMTS Cable Command Reference
CBL-516 OL-15510-15
Cable Commands: cable s
cable source-verify
The cable source-verify command helps to prevent the spoofing of IP addresses by CMs or their CPE
devices by verifying that the upstream packets coming from each CM are known to be associated with
the IP address in that packet. Packets with IP addresses that do not match those associated with the CM
are dropped.
In order to protect the Cisco CMTS from denial of service attacks, Cisco IOS Release 12.3(9a)BC adds
the option of using a per SID basis for deriving leasequeries from CPE devices. This release also
introduces a global rate limit for leasequeries initiated by downstream traffic. These enhancements
reduce the CPU utilization of Dynamic Host Configuration Protocol (DHCP) Receive and ISR processes
when the Cisco CMTS is configured with the cable source-verify dhcp and no cable arp commands.
When cable source-verify dhcp and no cable arp commands are configured, DHCP leasequery is sent
for downstream packets to verify unknown IP addresses within the IP address range configured on the
cable bundle interface.
For DHCP leasequery to work in the downstream direction, the Cisco Network Registrar (CNR) should
be made aware of the DHCP Option 82. This is required to make the CMTS map the CPE IP address to
the correct CM. To do this, configure the ip dhcp relay information option command on the bundle
interface to insert service class relay agent option into the DHCP DISCOVER messages. When the
configuration is in place, during DHCP DISCOVER, the values of DHCP Option 82 is cached by the
CNR and is returned to the CMTS on any subsequent DHCP leasequery for that IP address.
The Cisco CMTS maintains a database that links the MAC and IP addresses of known CPE devices with
the CMs that are providing network access for those CPE devices. The CMTS typically populates this
database with information obtained by examining the DHCP packets sent between the CPE devices and
the DHCP server. Other IP traffic provides information about which CMs service which CPE devices.
After the cable source-verify command is issued, every IP upstream packet is examined. If the IP and
MAC addresses of the CPE device are already associated with a known, online CM, it is allowed
through. If not, the source IP address is examined to determine if it belongs to the cable network. If so,
and if the dhcp option is not used, the packet is allowed through.
Using the dhcp Option
Note Do not enable the local DHCP server on the Cisco CMTS and configure local DHCP address pools using
the ip dhcp pool command, when using dhcp option, because this prevents DHCP address validation.
If the dhcp option is used, all packets with unknown IP addresses within the cable network are dropped,
but the Cisco CMTS sends a DHCP leasequery message to the DHCP server to verify the IP address. If
a valid response is received from the DHCP server, the CMTS updates its database with the new CPE
device and allows future traffic through. If the DHCP server does not return a successful response, all
traffic from the CPE is dropped.
In Cisco IOS Release 12.2(15)BC1 and later releases, the dhcp option extends the verification to CPE
devices that had been online using a valid IP address but then were reconfigured by the user with an
unused static IP address. With Cisco IOS Release 12.2(15)BC1 and later, CPE devices are not allowed
online when they are using static IP addresses that have not been allocated by the DHCP server. If you
are using the dhcp option, the CPE device must use an IP address that has been assigned by the DHCP
server.
Note You must enable the ip dhcp relay information option command to properly trigger the leasequery
after configuring the cable source-verify dhcp command. If the ip dhcp relay information option
command is not enabled, the leasequery does not recover the IP address of the CPE properly.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-517
Cable Commands: cable s
cable source-verify
Note The dhcp option automatically blocks all statically-assigned IP addresses unless the DHCP server has
been configured to recognize those addresses and respond with the appropriate leasequery response.
The cable source-verify command by itself prevents someone from stealing another customer’s IP
address. The cable source-verify dhcp command adds another level of security by refusing access to
any CPE device with an IP address that has not been assigned by the DHCP server.
Note This dhcp option requires that the DHCP server support the leasequery message. The CNR supports
leasequery in version 7.0 onwards. The leasequery message is defined in an IETF draft, and available at
the URL: http://www.ietf.org/rfc/rfc4388.txt
Caution Do not enable the local DHCP server on the Cisco CMTS and configure local DHCP address pools,
using the ip dhcp pool command, when you are also enabling the cable source-verify dhcp command,
because the DHCP server on the Cisco CMTS can intercept the leasequery messages and prevent them
from reaching the external DHCP server. This in turn prevents address validation from succeeding
because the DHCP server on the Cisco CMTS does not support leasequery messages.
Note When the cable source-verify dhcp feature is enabled, and a statically-defined IP address has been
added to the CMTS for a CM using the cable trust command to override the cable source-verify dhcp
checks for this device, packets from this CM will continue to be dropped until an entry for this CM is
added to the ARP database of the CMTS. To achieve this, disable the cable source-verify dhcp feature,
ping the CMTS from the CM to add an entry to the ARP database, and re-enable the cable source-verify
dhcp feature.
Using the leasetimer Option
Note The leasetimer option takes effect only when the dhcp option is also used on an interface. Also, this
option is supported only on the master interface and cannot be configured on subinterfaces. Configuring
it for a master interface automatically applies it to all subinterfaces.
The leasetimer option adds another level of verification by activating a timer that periodically examines
the lease times for the IP addresses for known CPE devices. If the CMTS discovers that the DHCP lease
for a CPE device has expired, it removes that IP address from its database, preventing the CPE device
from communicating until it makes another DHCP request. This prevents users from treating
DHCP-assigned addresses as static addresses, as well as from using IP addresses that were previously
assigned to other devices.
Note The leasetimer option is active only if you have also specified the cable source-verify dhcp command
for the cable interface. If the dhcp option is not used, the leasetimer option has no effect. In addition,
the leasetimer option can be configured only on an interface, not a subinterface. Applying it to a master
interface automatically applies it to all subinterfaces.
The leasetimer option allows you to configure how often the timer checks the lease times, so as to
specify the maximum amount of time a CPE device can use an IP address that was previously assigned
by the DHCP server but whose lease time has since expired. The time period can range from 1 minute
Cisco IOS CMTS Cable Command Reference
CBL-518 OL-15510-15
Cable Commands: cable s
cable source-verify
to 240 minutes (4 hours), with a grace period of 2 minutes to allow a PC enough time to make a DHCP
request to renew the IP address. To turn off the timer, so that the CMTS no longer checks the lease times,
issue the cable source-verify command without the dhcp option, or turn off the feature entirely with the
no cable source-verify command.
Using Multiple Subnets
In Cisco IOS Release 12.2(15)BC2 and later releases, the cable source-verify command can verify IP
addresses that are on different subnets than what is being used on the cable interface or subinterfaces
only when Reverse Path Forwarding (RPF) is used in conjunction.
Note You must enable RPF before running the cable source-verify command to verify IP addresses on
subinterfaces.
Examples The following example shows how to enable RPF before running the cable source-verify command to
verify IP addresses on subinterfaces:
Router# configure terminal
Router(config)# ip cef
Router(config)# interface cable 4/0
Router(config-if)# ip verify unicast source reachable-via rx
Note Beginning with Cisco IOS Release 12.2(33)SCA, ip verify unicast source reachable-via rx command
must be used with the allow-default keyword.
The following example shows how to turn on CM upstream verification and configures the Cisco CMTS
router to send DHCP leasequeries to verify unknown source IP addresses in upstream data packets:
Router# configure terminal
Router#(config) interface cable 4/0
Router(config-if)# cable source-verify dhcp
Router(config-if)#
The following example shows how to enable the leasetimer feature so that every two hours, the CMTS
checks the IP addresses in the CPE database for that particular interface for expired lease times:
Router# configure terminal
Router#(config) interface cable 1/0
Router(config-if)# cable source-verify dhcp
Router(config-if)# cable source-verify leasetimer 120 #
The following example shows how to configure the cable interface so that the CMTS can verify IP
addresses that are on a different subnet than the one that the cable interface is using:
Router# configure terminal
Router(config)# ip cef
Router#(config) interface cable 7/0/0
Router(config-if)# ip verify unicast source reachable-via rx
Router(config-if)# cable source-verify dhcp
The following example shows the error message that is displayed if you try to configure the leasetimer
option on a subinterface, instead of an interface:
Router# configure terminal
Router#(config) interface cable 1/0.1
Router(config-subif)# cable source-verify dhcp
Router(config-subif)# cable source-verify leasetimer 120
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-519
Cable Commands: cable s
cable source-verify
Related Commands Command Description
cable arp Enables or disables the use of the ARP protocol for CMs and their
CPE devices.
cable helper-address Specifies a destination IP address for User Datagram Protocol (UDP)
broadcast (DHCP) packets.
cable dhcp-giaddr Modifies the GIADDR field of DHCP DISCOVER and
DHCPREQUEST packets with a Relay IP address before they are
forwarded to the DHCP server.
cable logging badipsource Logs error messages about bad IP source addresses on the cable
interfaces.
cable relay-agent-option Enables the system to insert the CM MAC address into a DHCP
packet received from a CM or host and forward the packet to a DHCP
server.
cable source-verify Controls the number of DHCP leasequery request messages that are
leasequery-filter sent for unknown IP addresses on all cable downstream interfaces on
downstream the Cisco CMTS router.
cable source-verify Controls the number of DHCP leasequery request messages that are
leasequery-filter upstream sent for unknown IP addresses per each service ID (SID) on an
upstream.
clear cable logging Removes all error messages about bad IP source addresses on the
cable interfaces from the error log buffer.
ip dhcp relay information Enables the system to insert the CM MAC address into a DHCP
option packet received from a CM or host and forward the packet to a DHCP
server.
ip dhcp smart-relay Monitors client retransmissions when address pool depletion occurs.
ip verify unicast Enables Unicast Reverse Path Forwarding (Unicast RPF), which
reverse-path checks each packet received on an interface to verify that the packet’s
source IP address appears in the routing tables as belonging to that
interface, so as to prevent spoofed IP source addresses.
Cisco IOS CMTS Cable Command Reference
CBL-520 OL-15510-15
Cable Commands: cable s
cable source-verify enable-sav-static
cable source-verify enable-sav-static
To enable source address verification (SAV) on the Cisco CMTS, use the cable source-verify
enable-sav-static command in global configuration mode. To disable the SAV, use the no form of this
command.
cable source-verify enable-sav-static
no cable source-verify enable-sav-static
Syntax Description This command has no arguments or keywords.
Command Default SAV is disabled by default
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines The cable source-verify enable-sav-static command allows you to enable of SAV prefix processing on
the Cisco CMTS. If the SAV feature is enabled, the SAV prefixes are matched during source
verification. If the feature is disabled the SAV prefixes are not matched, and the configured SAV
prefixes do not have any impact on the outcome of the source verification.
This feature is disabled by default.
Examples The following example shows how to enable SAV prefix processing on the Cisco CMTS:
Router(config)# cable source-verify enable-sav-static
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-521
Cable Commands: cable s
cable source-verify enable-sav-static
Related Commands Command Description
cable source-verify group Configures SAV groups.
prefix Configures IPv4 or IPv6 prefixes in a SAV group.
Cisco IOS CMTS Cable Command Reference
CBL-522 OL-15510-15
Cable Commands: cable s
cable source-verify group
cable source-verify group
To configure the source address verification (SAV) prefix group, use the cable source-verify group
command in global configuration mode. To disable the use of configured SAV prefix group, use the no
form of this command.
cable source-verify group groupname
no cable source-verify group groupname
Syntax Description groupname Name of the SAV prefix group. The groupname can be any arbitrary string
up to 15 characters in length.
Command Default None
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines The cable source-verify group command is used to configure SAV groups. A SAV group is a group of
IPv4 or IPv6 prefixes. The Cisco CMTS uses these prefixes to authenticate a cable modem (CM). A CM
may be configured with an IPv4 or IPv6 prefix belonging to a particular SAV group. The time, length,
value (TLV) 43.7.1 specifies the group name to which a given CM belongs. The Cisco CMTS considers
a packet from a CM authorized if that packet is sourced with an IP address that belongs to the configured
prefix in a SAV group.
A maximum of 255 SAV groups can be configured on a Cisco CMTS, with each SAV group containing
up to four IPv4s, IPv6s, or a combination of both the prefixes (totalling up to four)..
Examples The following example shows how to configure a SAV group with one IPv6 prefixes and one IPv4
prefixes:
Router(config)# cable source-verify group sav1
Router(config)# prefix 10.16.0.0/12
Router(config)# prefix 10::/12
Router(config)# exit
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-523
Cable Commands: cable s
cable source-verify group
Related Commands Command Description
cable source-verify enable-sav-static Enables SAV prefix processing.
prefix Configures IPv4 or IPv6 prefixes in a SAV group.
Cisco IOS CMTS Cable Command Reference
CBL-524 OL-15510-15
Cable Commands: cable s
cable source-verify leasequery-filter downstream
cable source-verify leasequery-filter downstream
To control the number of Dynamic Host Configuration Protocol (DHCP) LEASEQUERY request
messages that are sent for unknown IP addresses on all cable downstream interfaces on the Cisco Cable
Modem Termination System (CMTS) router, use the cable source-verify leasequery-filter
downstream command in global configuration mode. To stop the filtering of DHCP lease queries, use
the no form of this command.
cable source-verify leasequery-filter downstream threshold interval
no cable source-verify leasequery-filter downstream
Syntax Description threshold Maximum number of DHCP lease queries allowed per SID for each interval period. The
valid range is 0 to 255 lease queries.
interval Time period, in seconds, over which lease queries should be monitored. The valid range is
1 to 10 seconds.
Command Default Filtering of DHCP lease queries is disabled.
Command Modes Global configuration
Command History Release Modification
12.2(15)BC1d, This command was introduced for the Cisco uBR7100 series, Cisco uBR7246VXR,
12.2(15)BC2b and Cisco uBR10012 universal broadband routers.
Usage Guidelines When the cable source-verify dhcp and no cable arp commands are configured on a cable interface,
the Cisco CMTS router sends a DHCP LEASEQUERY request to the DHCP server to verify unknown
IP addresses that are found in packets to and from customer premises equipment (CPE) devices that are
using the cable modems on the cable interface. The DHCP server returns a DHCP ACK message with
the MAC address of the CPE device that has been assigned this IP address, if any. The router can then
verify that this CPE device is authorized to use this IP address, which prevents users from assigning
unauthorized IP addresses to their CPE devices.
Problems can occur, though, when viruses, denial of service (DoS) attacks, and theft-of-service attacks
scan ranges of IP addresses, in an attempt to find unused addresses. This type of activity can generate a
large volume of DHCP LEASEQUERY requests, which can result in high CPU utilization and a lack of
available bandwidth for other customers.
To prevent such a large volume of LEASEQUERY requests on all downstreams in the Cisco CMTS
router, use the cable source-verify leasequery-filter downstream command. After configuring this
command, the Cisco CMTS allows only a certain number of DHCP LEASEQUERY requests in the
downstream direction within each interval time period.
For example, the cable source-verify leasequery-filter downstream 5 10 command configures the
router so that it allows a maximum of 5 DHCP LEASEQUERY requests every 10 seconds for each SID
on the downstream direction. This command applies to all downstream cable interfaces in the router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-525
Cable Commands: cable s
cable source-verify leasequery-filter downstream
Note The cable source-verify leasequery-filter downstream command enables DHCP lease query filtering
on all downstreams, but the actual filtering does not begin until the cable source-verify dhcp command
and the no cable arp command are configured on a particular downstream. You can configure these
commands on either the downstream’s main interface, or on a subinterface for the downstream. If these
commands are configured on a subinterface, however, the lease query filtering occurs only for cable
modems using that subinterface.
Tip Use the cable source-verify leasequery-filter upstream command to filter DHCP LEASEQUERY
requests in the upstream direction.
Examples The following example shows how to configure the Cisco CMTS router so that it allows a maximum of
10 DHCP lease query requests per SID over each five-second interval on all downstream cable
interfaces. This example also shows the configuration of cable source-verify dhcp and no cable arp
commands on a cable interface, which are required to use this feature.
Router# configure terminal
Router(config)# cable source-verify leasequery-filter downstream 10 5
Router(config)# interface cable 5/1/0
Router(config-if)# cable source-verify dhcp
Router(config-if)# no cable arp
Router(config-if)#
Related Commands Command Description
cable arp Activates the cable Address Resolution Protocol
(ARP).
cable arp filter Controls the number of ARP requests and replies
that can be forwarded over a cable interface.
cable source-verify Enables verification of IP addresses for cable
modems (CMs) and CPE devices on the upstream.
cable source-verify leasequery-filter upstream Controls the number of DHCP lease query
messages that are sent for unknown IP addresses per
each service ID (SID) on an upstream.
show cable leasequery-filter Displays the number of DHCP lease query
messages that have been filtered for all cable
modems or for a particular cable interface.
Cisco IOS CMTS Cable Command Reference
CBL-526 OL-15510-15
Cable Commands: cable s
cable source-verify leasequery-filter upstream
cable source-verify leasequery-filter upstream
To control the number of Dynamic Host Configuration Protocol (DHCP) LEASEQUERY request
messages that are sent for unknown IP addresses per each service ID (SID) on an upstream, use the cable
source-verify leasequery-filter upstream command in cable interface configuration mode. To disable
the filtering of DHCP lease queries, use the no form of this command.
cable source-verify leasequery-filter upstream threshold interval
no cable source-verify leasequery-filter upstream
Syntax Description threshold Maximum number of DHCP lease queries allowed per SID for each interval
period. The valid range is 0 to 20 lease queries.
interval Time period, in seconds, over which lease queries should be monitored. The
valid range is 1 to 5 seconds.
Defaults Filtering of DHCP lease queries is disabled.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.2(15)BC1d, This command was introduced for the Cisco uBR7100 series,
12.2(15)BC2b Cisco uBR7246VXR, and Cisco uBR10012 universal broadband routers.
Usage Guidelines When the cable source-verify dhcp and no cable arp commands are configured on a cable interface,
the Cisco Cable Modem Termination System (CMTS) router sends a DHCP LEASEQUERY request to
the DHCP server to verify unknown IP addresses that are found in packets to and from customer
premises equipment (CPE) devices that are using the cable modems on the cable interface. The DHCP
server returns a DHCP ACK message with the MAC address of the CPE device that has been assigned
this IP address, if any. The router can then verify that this CPE device is authorized to use this IP address,
which prevents users from assigning unauthorized IP addresses to their CPE devices.
Problems can occur, though, when viruses, denial of service (DoS) attacks, and theft-of-service attacks
scan ranges of IP addresses, in an attempt to find unused addresses. This type of activity can generate a
large volume of DHCP LEASEQUERY requests, which can result in high CPU utilization and a lack of
available bandwidth for other customers.
To prevent such a large volume of LEASEQUERY requests on the upstreams on a cable interface, use
the cable source-verify leasequery-filter upstream command. After configuring this command, the
Cisco CMTS allows only a certain number of DHCP LEASEQUERY requests in the upstream direction
within each interval time period.
For example, the cable source-verify leasequery-filter upstream 5 5 command configures the router
so that it allows a maximum of 5 DHCP LEASEQUERY requests every 5 seconds for each SID on the
upstream direction. This command applies to all upstreams on the cable interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-527
Cable Commands: cable s
cable source-verify leasequery-filter upstream
Note The cable source-verify leasequery-filter upstream command enables DHCP lease query filtering on
all upstreams on a cable interface, but the actual filtering does not begin until the cable source-verify
dhcp command and the no cable arp command are configured on the upstream’s associated downstream
interface. You can configure these commands on either the downstream’s main interface, or on a
subinterface for the downstream. If these commands are configured on a subinterface, however, the lease
query filtering occurs only for cable modems using that subinterface.
Note If using cable interface bundling, configure the cable source-verify leasequery-filter upstream
command on all master and slave interfaces.
Tip Use the cable source-verify leasequery-filter downstream command to filter DHCP LEASEQUERY
requests in the downstream direction.
Examples The following example shows how to configure the Cisco CMTS router so that it allows a maximum of
five DHCP lease query requests per SID over each two-second interval on all upstreams on a particular
cable interface. This example also shows the configuration of cable source-verify dhcp and no cable
arp commands on the cable interface, which are required to use this feature.
Router# configure terminal
Router(config)# interface cable 6/0
Router(config-if)# cable source-verify dhcp
Router(config-if)# cable source-verify leasequery-filter upstream 5 2
Router(config-if)# no cable arp
Router(config-if)#
Related Commands Command Description
cable arp Activates the cable Address Resolution Protocol (ARP).
cable arp filter Controls the number of ARP requests and replies that can be forwarded over
a cable interface.
cable source-verify Enables verification of IP addresses for cable modems (CMs) and CPE
devices on the upstream.
cable source-verify Controls the number of DHCP lease query messages that are sent for
leasequery-filter unknown IP addresses on all cable downstream interfaces on the
downstream Cisco CMTS router.
show cable Displays the number of DHCP lease query messages that have been filtered
leasequery-filter for all cable modems or for a particular cable interface.
Cisco IOS CMTS Cable Command Reference
CBL-528 OL-15510-15
Cable Commands: cable s
cable spectrum-group (global)
cable spectrum-group (global)
To create and configure a spectrum group, use the cable spectrum-group command in global
configuration mode. To disable this spectrum group, use the no form of this command.
cable spectrum-group group-number [time day hh:mm:ss] frequency up-freq-hz [pwr-lvl-dbmv]
cable spectrum-group group-number [time day hh:mm:ss] band up-freq1-hz up-freq2-hz
[pwr-lvl-dbmv]
no cable spectrum-group group-number
Syntax Description group-number Specifies the spectrum group for which you are specifying a parameter
value or specifies the number of the spectrum group you wish to
remove from your router configuration. Valid range is from 1 to 32, or
from 1 to 40, depending on the Cisco IOS software release.
time day hh:mm:ss (Optional) for scheduled spectrum groups, enter the day of the week
(Sun—Sat) and the time of day that the frequency and input power
level should change.
frequency up-freq-hz Specifies a center frequency for the upstream group. The valid range is
5,000,000 Hz to 42,000,000 Hz (DOCSIS), 55,000,000 Hz (Japan), or
65,000,000 (EuroDOCSIS).
Note You can enter this command multiple times for the same
spectrum group to create a group of individual frequencies to
be used for frequency hopping.
band up-freq1-hz Specifies a range of center frequencies the Cisco CMTS can scan to
up-freq2-hz find an acceptable channel to which the spectrum group may hop. The
valid range for up-freq1-hz is 5,000,000 Hz to 42,000,000 Hz
(DOCSIS), 55,000,000 Hz (Japan), or 65,000,000 (EuroDOCSIS), but
up-freq2-hz must be greater than up-freq1-hz.
Note When creating spectrum groups for cable line cards that
support Advanced Spectrum Management (Cisco
uBR10-MC16S, uBR10-MC16U/X, uBR10-MC28U/X, and
uBR10-MC5X20S/U), use the band option. The frequency
option is not supported for these types of line cards.
pwr-lvl-dbmv (Optional) Specifies the nominal input power level. The valid range is
–10 to +25 dBmV, with a default of 0 dBmV. Some cable plants might
want to change only the input power level, and not the frequency, on a
daily time schedule.
Command Default If not specified, the group is set for a nominal input power level of 0 dBmV and the group is not
scheduled for automatic frequency or power changes.
Command Modes Global configuration
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-529
Cable Commands: cable s
cable spectrum-group (global)
Command History Release Modification
11.3 NA This command was introduced.
12.0(7)XR2 The band parameter for this command was added to enable frequency range scanning
capabilities in the Cisco uBR-MC16S cable interface line card.
12.0(13)SC, The allowable frequency range was increased to 65 MHz to support the EuroDOCSIS
12.1(4)EC, frequency range of the Cisco uBR-MC16E cable interface line card.
12.2(4)BC1
12.2(15)BC2 The maximum number of spectrum groups was increased from 32 to 40 groups per
router.
Usage Guidelines Frequency agility is configured and activated using spectrum groups that are controlled by the spectrum
manager. You can create from 1 to 32, or from 1 to 40, spectrum groups for each cable modem card
upstream port, depending on the Cisco IOS software release.
To create spectrum groups, specify a list of upstream frequencies and nominal power levels that each
spectrum group can use when an upstream frequency change is necessary. Each spectrum group should
have its own list of upstream frequencies. At 1.6 MHz, the valid range is –10 dBmV to 25 dBmV. The
power level value should be changed only if you want to change only the power level as part of spectrum
management. The standard power level is 0 dBmV.
The the cable spectrum-group command sets the center frequency for the upstream, but the total
frequency bandwidth that is actually used depends on the channel width. Table 0-15 shows the possible
center frequencies for each channel width, for both DOCSIS and EuroDOCSIS cable interfaces.
Table 0-15 Allowable Center Frequencies
Center Frequency (MHz) Center Frequency (MHz)
Channel Width (MHz) DOCSIS (5 to 42 MHz) EuroDOCSIS (5 to 65 MHz)
200,000 5.1 to 41.9 5.1 to 64.9
400,000 5.2 to 41.8 5.2 to 64.8
800,000 5.4 to 41.6 5.4 to 64.6
1,600,000 5.8 to 41.2 5.8 to 64.2
3,200,000 6.6 to 40.4 6.6 to 63.4
The allowable range for the upstream channel frequency depends on the cable interface line card and
Cisco IOS software release being used. See Table 2-11 for the currently supported values.
Table 0-16 Allowable Frequency Range for the cable upstream frequency Command
Frequency Range Supported Cable Interfaces Minimum Cisco IOS Releases
5 to 42 MHz All supported cable interfaces All releases supported for the Cisco CMTS
Cisco IOS CMTS Cable Command Reference
CBL-530 OL-15510-15
Cable Commands: cable s
cable spectrum-group (global)
Table 0-16 Allowable Frequency Range for the cable upstream frequency Command
Frequency Range Supported Cable Interfaces Minimum Cisco IOS Releases
5 to 55 MHz Cisco uBR-MC16U/X and Cisco IOS Release 12.2(15)BC2
Cisco uBR-MC28U/X, when
operating with extended
frequencies for Japanese
mode
5 to 65 MHz Cisco uBR-MC16E, Cisco IOS Release 12.0(13)SC, 12.1(4)EC, and
Cisco uBR7111E and 12.2(4)BC1
Cisco uBR7114E routers
Note If both an Cisco uBR-MC16E cable interface line card and a Cisco uBR-MC16C or a
Cisco uBR-MC16S cable interface line card are present in the chassis, a spectrum group in the 42-MHz
to 65-MHz range should not be assigned.
Tip Cisco cable interface line cards always program the upstream’s center frequency in 16 KHz increments,
and this is the frequency displayed by the show controller cable upstream command. For example, if
you use the cable upstream frequency command to specify a center frequency of 27 MHz (cable
upstream x frequency 27000000), the actual center frequency will be 27.008 MHz, which is the next
highest 16 KHz boundary.
You must repeat this command for each frequency or power level that you want to add to a spectrum
group’s list of valid values.
After you have created one or more spectrum groups for your cable network, you can add characteristics
to them, providing you with more definitive control over frequency usage and frequency hopping.
The cable interface does not operate until you either create and configure a spectrum group or set a fixed
upstream frequency. See the cable upstream channel-width command.
Examples The following example shows how to configure spectrum group 1 with an upstream frequency of
6,500,000 Hz and a default power level of 0 dBmV:
Router(config)# cable spectrum-group 1 frequency 6500000
The following example shows how to add the upstream frequency 7,000,000 Hz to the list of valid
frequencies with a default power level of 0 dBmV for spectrum group 1:
Router(config)# cable spectrum-group 1 frequency 7000000
The following example shows how to configure spectrum group 2 with an upstream frequency
7,500,000 Hz and change the power level to 5 dBmV:
Router(config)# cable spectrum-group 2 frequency 7500000 5
The following example shows how to configure spectrum group 3 with an upstream band of 12,000,000
to 18,000,000 Hz and default power level of 0 dBmV:
Router(config)# cable spectrum-group 3 band 12000000 18000000
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-531
Cable Commands: cable s
cable spectrum-group (global)
The following example shows how to add the upstream band 20,000,000 to 24,000,000 Hz to the list of
valid bands with a change in the power level of 13 dBmV for spectrum group 3:
Router(config)# cable spectrum-group 3 band 20000000 24000000 13
The following example shows how to configure a continuous band between 5,000,004 and
40,000,000 Hz for scheduled spectrum group 4 with a default power level of 0 dBmV. The spectrum
group will be available to the spectrum group starting at 12:00 p.m. local time each Monday:
Router(config)# cable spectrum-group 4 time Monday 12:00:00 band 5000004 40000000
The following example shows how to add the upstream frequency 9,500,000 Hz to the list of valid
frequencies and change the nominal power level to 5 dBmV. The spectrum manager adjusts frequencies
and power levels on this group at 2:00 a.m. local time each day:
Router(config)# cable spectrum-group 3 time 02:00:00 frequency 9500000 5
The following example shows how to remove a specified spectrum group from your configuration:
Router(config)# no cable spectrum-group 3
Router(config)#
Related Commands Command Description
cable modulation-profile Configures preset modulation profiles that you can apply to
one or more upstream cable interfaces when you identify and
configure spectrum groups.
cable spectrum-group hop period Sets the minimum frequency-hop interval for a cable spectrum
group.
cable spectrum-group hop threshold Specifies a hop threshold for a cable spectrum group.
cable spectrum-group shared Specifies the upstream ports in a spectrum group can share the
same upstream frequency.
cable upstream frequency Specifies that the upstream should either be set to a specific
center frequency or be set dynamically.
cable upstream power-level Specifies the upstream cable interface receive power level in
dBmV.
cable upstream shutdown Activates or shuts down a specified upstream cable interface.
cable upstream hopping blind Disengages the advanced spectrum management features of
the Cisco uBR-MC16S and Cisco uBR-MC5X20S cable
interface line cards by enabling blind frequency hopping
behavior.
show controllers cable Displays information about the cable interface, including the
upstream center frequency.
Cisco IOS CMTS Cable Command Reference
CBL-532 OL-15510-15
Cable Commands: cable s
cable spectrum-group (interface)
cable spectrum-group (interface)
To assign a default spectrum group to all of the upstreams on a cable interface, use the cable
spectrum-group command in interface configuration mode. To remove the spectrum groups from the
upstreams, use the no form of this command.
cable spectrum-group group-number
no cable spectrum-group group-number
Syntax Description group-number Specifies the spectrum group that should be used as the default group for the upstreams
on this cable interface. The valid range is from 1 to 32, or from 1 to 40, depending on
the Cisco IOS software release.
Command Default No default behavior or values.
Command Modes Interface configuration
Command History Release Modification
11.3 NA This command was introduced.
12.2(15)BC2 The maximum number of spectrum groups was increased from 32 to 40 groups per
router.
Usage Guidelines This command assigns a default spectrum group to all of the upstreams on the cable interface. All
upstreams on the interface use this spectrum group unless you override this configuration, using one of
the following commands:
• To assign a different spectrum group to a particular upstream, use the cable upstream
spectrum-group command.
• To assign a new frequency to a particular upstream, use the cable upstream frequency command.
These two commands override the cable spectrum-group command for the particular upstreams to
which they are applied. The remaining upstreams in the interface, however, continue to use the default
configuration that is specified by the cable spectrum-group command.
Tip You must first create and configure the spectrum groups before you can assign them to an interface. To
create and configure spectrum groups, use the set of cable spectrum-group commands that are available
in global configuration mode.
Examples The following example shows how to assign spectrum group 1 to all of the upstreams on the cable
interface in slot 3/0:
Router(config)# interface cable 3/0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-533
Cable Commands: cable s
cable spectrum-group (interface)
Router(config-if)# cable spectrum-group 1
Router(config-if)# exit
Router(config)#
Related Commands Command Description
cable modulation-profile Configures preset modulation profiles that you can
apply to one or more upstream cable interfaces when
you identify and configure spectrum groups.
cable spectrum-group (global configuration) Creates and configures a spectrum group.
cable spectrum-group hop period Sets the minimum frequency-hop interval for a cable
spectrum group.
cable spectrum-group hop threshold Specifies a hop threshold for a cable spectrum group.
cable spectrum-group shared Specifies the upstream ports in a spectrum group can
share the same upstream frequency.
cable upstream hopping blind Disengages the advanced spectrum management
features of the Cisco uBR-MC16S and
Cisco uBR-MC5X20S cable interface line cards by
enabling blind frequency hopping behavior.
cable upstream spectrum-group Assigns a spectrum group to an individual upstream
on a cable interface line card.
Cisco IOS CMTS Cable Command Reference
CBL-534 OL-15510-15
Cable Commands: cable s
cable spectrum-group hop period
cable spectrum-group hop period
To change the minimum time between frequency hops, use the cable spectrum-group hop period
command in global configuration mode. To reset the frequency hop interval for this spectrum group to
its default value, use the no form of this command.
cable spectrum-group groupnum hop period seconds
no cable spectrum-group groupnum hop period
Syntax Description groupnum Spectrum group number. Valid values are from 1 to 32, or from 1 to 40, depending on the
Cisco IOS software release.
seconds Specifies the frequency-hop time period in seconds. Valid values are from 1 to 3600
seconds (before Cisco IOS Release 12.2(8)BC1), or from 1 to 300 seconds (Cisco IOS
Release 12.2(8)BC1 or later).
Command Default Before Cisco IOS Release 12.2(15)BC1: 25 seconds
Cisco IOS Release 12.2(15)BC1 and later releases: 20 seconds when N+1 HCCP redundancy is not
configured, and 15 seconds when N+1 HCCP redundancy is configured on the cable interface
Command Modes Global configuration
Command History Release Modification
12.1 T This command was introduced.
12.1(7)CX1 The default hop period was changed from 300 seconds to 25 seconds to accommodate
the new spectrum management features for the Cisco uBR-MC16S spectrum
management card.
12.2(8)BC1 The maximum frequency-hop time period was changed from 3600 to 300 seconds.
12.2(15)BC1 The default hop period was changed from 25 seconds to 20 seconds when N+1 HCCP
redundancy is not configured on the cable interface, and changed to 15 seconds when
N+1 HCCP redundancy is configured.
12.2(15)BC2 The maximum number of spectrum groups was increased from 32 to 40 groups per
router.
Usage Guidelines The cable spectrum-group hop period command defines the minimum amount of time that must pass
between upstream frequency hops. If ingress noise becomes excessive on a particular upstream, you can
set this time period to a smaller value, so as to allow frequency hopping to continue more rapidly until a
clear channel is found. Conversely, if the problem appears to be a transient condition, such as a defective CM
generating a large volume of errored packets, this time period can be increased to a larger value, so as to avoid
excessive frequency hopping by allowing more time between frequency hops.
On the Cisco uBR-MC1xC cards, the maximum recommended hop period is 20 seconds. On the
Cisco uBR-MC16S and Cisco uBR-MC5X20S/U cards, the minimum recommended hop period is 25
seconds and the maximum recommended hop period is 35 seconds.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-535
Cable Commands: cable s
cable spectrum-group hop period
In Cisco IOS Release 12.2(15)BC2, the Cisco CMTS adaptively increases the hop period from the
user-defined value to the maximum value (300 seconds) whenever an upstream does not currently have
any CMs ranging on it, so as to avoid unnecessary frequency hopping. The user-defined value is restored
when a CM starts ranging on the upstream.
Note The hop period should be set to at least 25 seconds on the Cisco uBR-MC16S and
Cisco uBR-MC5X20S/U cards so that transient network problems that are unrelated to ingress noise do
not generate unnecessary frequency hops.
Examples The following example shows how to change the minimum frequency-hop interval to 60 seconds. This
means that frequency hops for this spectrum group cannot occur more quickly than once every 60
seconds, even if other characteristics, such as exceeding the CNR or FEC threshold values, would
normally trigger the hop.
Router# configure terminal
Router(config)# cable spectrum-group 1 hop period 60
Router(config)#
Related Commands Command Description
cable modulation-profile Creates a cable modulation profile.
cable spectrum-group hop threshold Specifies a hop threshold for a cable spectrum group.
cable upstream channel-width Configures an upstream for a range of allowable channel
widths.
cable upstream modulation-profile Configures an upstream for one modulation profile (static
profile) or two modulation profiles (Dynamic Upstream
Modulation).
show cable hop Displays the current hop period and threshold for an upstream,
along with other statistics.
Cisco IOS CMTS Cable Command Reference
CBL-536 OL-15510-15
Cable Commands: cable s
cable spectrum-group hop threshold
cable spectrum-group hop threshold
To specify a frequency hop threshold for a spectrum group, use the cable spectrum-group hop
threshold command in global configuration mode. To delete the hop threshold for this spectrum group,
use the no form of this command.
cable spectrum-group groupnum hop threshold [percent]
no cable spectrum-group groupnum hop threshold
Syntax Description groupnum Spectrum group number. Valid values are from 1 to 32, or from 1 to 40, depending on the
Cisco IOS software release.
percent (Optional) Specifies the frequency hop threshold as a percentage of station maintenance
messages that are lost. Valid range is from 1 to 100 percent.
Command Default 20 percent
Command Modes Global configuration
Command History Release Modification
12.1 T This command was introduced.
12.1(7)CX1 The default hop threshold was changed from 100 percent to 20 percent to
accommodate the new spectrum management features for the Cisco uBR-MC16S
spectrum management card.
12.2(4)BC1 Support for this command was added to the Release 12.2 BC train.
12.2(15)BC2 The maximum number of spectrum groups was increased from 32 to 40 groups per
router.
Usage Guidelines The Cisco CMTS sends a station maintenance message to each CM at least once every 25 to 30 seconds.
If a CM does not respond to a station maintenance message within that time period, the CMTS then
resends station maintenance messages at a faster rate (typically one second apart) in an attempt to restore
connectivity with the CM.
Station maintenance messages can be lost because CMs have lost connectivity with the CMTS, or
because ingress noise and other factors are causing dropped and errored packets. Downstream noise can
also affect the delivery of station maintenance messages. When a user-configurable percentage of station
maintenance messages are lost, the CMTS hops to a new upstream frequency to improve connectivity
and sends out an Upstream Channel Descriptor (UCD) update to the CMs to inform them of the change.
The optimal hop threshold value depends on several factors, including the quality of the upstream return
path and the number of CMs on the upstream. In addition, the hop threshold works together with the hop
period so that transient network problems do not generate an unnecessary number of frequency hops.
Ideally, the hop threshold should be set low enough so that the frequency hop can occur before a
significant number of CMs go offline, but not so low that it generates frequency hops that are not needed.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-537
Cable Commands: cable s
cable spectrum-group hop threshold
For example, if the hop threshold is at its default of 20 percent and an upstream has 100 active CMs, a
power outage that affected 20 CMs would usually cause a frequency hop since this is a 20 percent loss
of CMs, which in turn would be responsible for at least 20 percent loss of station maintenance messages.
But in this situation, the frequency hop would be unneeded because changing the upstream frequency
could not correct the original problem (the power outage). If this were a common situation on this
upstream, the network administrator might increase the hop threshold so that the repeated power outages
would not generate unneeded frequency hops.
If, on the other hand, the power outage affected only 10 CMs, a frequency hop would not occur unless
another factor, such as ingress noise, created a sufficient loss of station maintenance messages to reach
the 20 percent threshold. In this situation, the default threshold of 20 percent might be sufficient.
Downstream problems can also generate frequency hops. For example, if 20 CMs were on a particularly
noisy downstream, over time they could miss a sufficient number of station maintenance messages to
generate a frequency hop. The network administrator could increase the hop threshold to limit the
possibility of frequency hops due to downstream impairments.
Also, faulty CMs could generate a frequency hop under certain conditions. For example, if a number of
faulty CMs generated a large number of uncorrectable forward error correction (FEC) errors or
otherwise missed 50 to 60 percent of their station maintenance messages, without actually going offline,
over time they could miss a sufficient number of station maintenance messages to cause a frequency hop
or modulation change. The network administrator could increase the hop threshold to prevent the CMTS
from generating a frequency hop or modulation change for problems such as these, which are unrelated
to actual noise on the upstream.
Note If a previous frequency hop had already occurred within the user-configurable hop period, the CMTS
will not immediately frequency hop. Instead, the CMTS would wait until the hop period expires, and if
the percentage of station maintenance messages still exceeds the hop threshold, the CMTS would
perform another frequency hop.
Tip When an upstream has 25 or fewer CMs (which is typical with lab and test environments), the CMTS
increases the rate at which it sends station maintenance messages to the CMs. This higher polling rate,
along with the small number of CMs, means that frequency hopping can occur more quickly than with
a normally loaded upstream, especially when a small number of CMs are powered down or generate
noisy traffic.
Note The DOCSIS specification states that when a CM misses 16 sequential station maintenance messages,
the CMTS should consider the CM offline and should stop sending station maintenance messages to that
CM. The CM must then reregister with the CMTS to resume connectivity.
Examples The following example shows how to set the threshold that triggers frequency hop to 25 percent of
station maintenance messages on the upstream that is assigned to spectrum-group 4:
Router# configure terminal
Router(config)# cable spectrum-group 4 hop threshold 25
Router(config)#
Cisco IOS CMTS Cable Command Reference
CBL-538 OL-15510-15
Cable Commands: cable s
cable spectrum-group hop threshold
Related Commands Command Description
cable modulation-profile Creates a cable modulation profile.
cable spectrum-group hop period Sets the minimum frequency-hop interval for a cable spectrum
group.
cable upstream channel-width Configures an upstream for a range of allowable channel
widths.
cable upstream modulation-profile Configures an upstream for one modulation profile (static
profile) or two modulation profiles (Dynamic Upstream
Modulation).
show cable hop Displays the current hop period and threshold for an upstream,
along with other statistics.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-539
Cable Commands: cable s
cable spectrum-group shared
cable spectrum-group shared
To specify that the upstream ports in a spectrum group share the same upstream frequency, use the cable
spectrum-group shared command in global configuration mode. To delete this specification, use the
no form of this command.
cable spectrum-group groupnum shared
no cable spectrum-group groupnum shared
Syntax Description groupnum Spectrum group number. Valid values are from 1 to 32, or from 1 to 40, depending on the
Cisco IOS software release.
Command Default Upstream port frequency is the same for all ports in the spectrum group.
Command Modes Global configuration
Command History Release Modification
12.1 T This command was introduced.
12.2(11)BC3 Support was added for this command on the Cisco uBR-LCP2-MC16S card on the
Cisco uBR10012 router.
12.2(15)BC2 The maximum number of spectrum groups was increased from 32 to 40 groups per
router.
Usage Guidelines Because this command forces upstream ports to use the same spectrum, you must ensure that you do not
configure spectrum groups that have overlapping frequencies. To use shared spectrum groups, each
group must be using a discrete set of frequencies.
Caution Depending on the frequencies being used, and how cable modems are distributed across those
frequencies and among spectrum groups, switching from a group from shared to non-shared, or from
non-shared to shared, could cause CMs in the spectrum group to go offline and begin reranging
procedures. You should therefore use this command only during regularly schedule maintenance times,
so that a minimum number of online customers are affected.
Note This command does not enable any sort of load balancing on the shared upstreams.
Cisco IOS CMTS Cable Command Reference
CBL-540 OL-15510-15
Cable Commands: cable s
cable spectrum-group shared
Examples The following example shows how to specify that all the upstream ports for spectrum group 4 share the
same upstream frequency, and that these upstream frequencies are not assigned to other upstream
interfaces:
Router(config)# cable spectrum-group 4 shared
Router(config)#
Related Commands Command Description
cable modulation-profile Configures preset modulation profiles that you can
apply to one or more upstream cable interfaces when
you identify and configure spectrum groups.
cable spectrum-group (global configuration) Creates a spectrum group of one or more frequencies
for an upstream.
cable spectrum-group hop period Sets the minimum frequency-hop interval for a cable
spectrum group.
cable spectrum-group hop threshold Specifies a hop threshold for a cable spectrum group.
cable upstream hopping blind Disengages the advanced spectrum management
features of the Cisco uBR-MC16S and
Cisco uBR-MC5X20S cable interface line cards by
enabling blind frequency hopping behavior.
show controllers cable Displays information about the cable interface,
including the upstream center frequency.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-541
Cable Commands: cable s
cable submgmt default
cable submgmt default
To set the default values for attributes in the Subscriber Management MIB (DOCS-SUBMGT-MIB), and
to enable Cisco Static CPE Override on the Cisco CMTS, use the cable submgmt default global
configuration command. To restore the original defaults, use the no form of this command.
cable submgmt default [active | learnable | max-cpe cpe-num]
no cable submgmt default [active | learnable | max-cpe cpe-num]
cable submgmt default filter-group {cm | cpe | mta | stb | ps} {downstream | upstream}
group-id
no cable submgmt default filter-group {cm | cpe| mta | stb | ps} {downstream | upstream}
group-id
Syntax Description no When used with the active and learnable options, the no form of the command sets
the default attributes to false. When used with the max-cpe and filter-group
options, the no form of the command sets the attribute to 0.
active (Optional) Sets the docsSubMgtCpeActiveDefault attribute, which controls
whether the CMTS manages the CPE devices for a particular CM—when set to
TRUE, the CMTS enforces the MAX-CPE value and the implemented filters. The
no cable submgmt default active command sets the default value to FALSE (the
original default), which turns off CPE management at the CMTS.
learnable (Optional) Sets the docsSubMgtCpeLearnableDefault attribute, which controls
whether the CMTS learns the CPE IP addresses for a particular CM—when set to
TRUE (the original default), the CMTS learns IP addresses up to the MAX-CPE
value. The no cable submgmt default learnable command sets the default value
to FALSE, which means that the IP address for each allowable CPE device must
be specified in the DOCSIS configuration file.
max-cpe cpe-num (Optional) Sets the docsSubMgtCpeMaxIpDefault attribute, which specifies the
default number of simultaneous IP addresses (CPE devices) permitted for the CM.
The possible range is 0 to 1024, where 0 specifies that all CPE traffic from the CM
is dropped. The default is 16.
filter-group Specifies a filter group, which can be applied to either upstream or downstream
traffic for either a CM or its CPE devices.
cm Specifies that the filter group applies to traffic to or from a CM.
cpe Specifies that the filter group applies to traffic to or from a CPE device.
mta Specifies that the filter group applies to traffic to or from a multimedia terminal
adaptor (mta.)
stb Specifies that the filter group applies to traffic to or from a Set-Top Box (stb.)
ps Specifies that the filter group applies to traffic to or from a portal server (ps.)
downstream Specifies that the filter group applies to the downstream traffic that is going to the
specified CM or CPE device.
Cisco IOS CMTS Cable Command Reference
CBL-542 OL-15510-15
Cable Commands: cable s
cable submgmt default
upstream Specifies that the filter group applies to the upstream traffic that is coming from
the specified CM or CPE device.
group-id Specifies the filter group ID (0 to 254) to be applied for the CM or CPE,
downstream or upstream filter. This ID references the filter indexes that are used
for rows in the docsSubMgtPktFilterTable. A value of 0 indicates that no filtering
is used for this particular type of traffic.
Command Default The Subscriber Management MIB defaults to the following default values:
• The active parameter defaults to FALSE (the CMTS does not actively manage CPE devices).
• The learnable parameter defaults to TRUE (the CMTS learns the IP addresses for CPE devices).
• The max-cpe parameter defaults to 16 IP addresses.
• The filter group ID for each type of filter group defaults to 0, which means that no filtering is done
on that type of traffic.
Command Modes Global configuration (config)
Command History Release Modification
12.1(7)CX1 This command was introduced.
12.3(9a)BC This command was integrated into Cisco IOS Release 12.3(9a)BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the
Cisco uBR7225VXR router was added.
12.2(33)SCB This command was updated to support MTA, STB, and portal server.
Usage Guidelines This command enables field technicians to add a temporary CPE device behind the subscriber’s cable
modem. The temporary CPE device shares the same SID settings as the original CPE device, even
though the temporary CPE device has a different MAC address. The original CPE device automatically
changes from dhcp cpe to static cpe in the CMTS host routing tables, and the CPE device continues to
receive service with the same SID.
To disable Cisco CMTS Static CPE Override on the Cisco CMTS, use the no form of this command.
This automatically updates the routing tables and enables the MAC address from the technician’s laptop
for a future field service connection at a different location.Prior to using this command, the first
(existing) DHCP CPE device maintains its DHCP dynamic MAC address behind the cable modem. The
SID is assigned to this IP address.
However, by enabling Static CPE override, you gain the following states and options on two CPE
devices behind the cable modem.
• The SID definition on the first CPE device is assigned a different static IP address. This enables you
to change the existing (dynamic) DHCP IP address to a static IP address without first clearing the
DHCP CPE host entries from the Cisco CMTS. The CPE IP state changes from dhcp to static cpe.
• This static override allows a second CPE device with a second MAC address behind the same cable
modem with SID1 to be assigned same IP address as the first CPE device.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-543
Cable Commands: cable s
cable submgmt default
Note The second CPE device changes from dhcp cpe to static CPE in the CMTS host tables.
The DOCSIS 1.1 Subscriber Management MIB (DOCS-SUBMGT-MIB) creates and maintains a number
of tables that describe the state of subscriber management for the CMs and CPE devices being serviced
by the Cisco CMTS. The CMTS creates rows in these tables for each CM and CPE device when the CM
registers with the CMTS, and if the CM does not specify a value for an attribute in this table, the CMTS
uses the defaults specified by the cable submgmt default command.
Timesaver The DOCS-SUBMGT-MIB MIB contains its own default values for these attributes, and those defaults
can be overridden by giving the appropriate SNMP SET commands. The cable submgmt default
command, however, allows the new defaults to be included in the Cisco IOS configuration file so that
the defaults are automatically reconfigured whenever the CMTS reboots or reloads.
Note The cable submgmt default command sets only the default value for these attributes. These default
values are used only if the CM does not specify other values when it registers with the CMTS. If the CM
does specify different values at registration time, those values are used instead of these default values.
The attributes in DOCS-SUBMGT-MIB control how the CMTS manages the CPE devices behind a CM
and the filters that are applied to the traffic to and from a particular CM and its CPE devices. The
following sections describe the relationship between the different forms of the cable submgmt default
commands and the attributes in DOCS-SUBMGT-MIB.
CPE Management
The first form of the cable submgmt default command controls the default values for the entries in the
docsSubMgtCpeControlTable, which controls how the CMTS manages the CPE devices for each CM:
cable submgmt default active
Sets the docsSubMgtCpeActiveDefault attribute, which is the default value for the
docsSubMgtCpeControlActive attribute in docsSubMgtCpeControlTable. This attribute controls
whether the CMTS performs CPE management for a particular CM.
• The cable submgmt default active command sets the default to TRUE, which specifies that the
CMTS is to manage CPE devices by enforcing the MAX-CPE number and the implemented filters.
• The no cable submgmt default active command sets the default to FALSE (the default value),
which specifies that the CMTS is not to perform CPE management for the particular CM.
cable submgmt default learnable
Sets the docsSubMgtCpeLearnableDefault attribute, which is the default value for the
docsSubMgtCpeControlLearnable attribute in docsSubMgtCpeControlTable. This attribute controls
whether the CMTS learns the IP addresses for CPE devices behind a particular CM.
• The cable submgmt default learnable command sets the default to TRUE (the default value),
which specifies that the CMTS is to learn the IP addresses for the CPE devices behind the CM, up
to the value specified by the MAX-CPE parameter. The CMTS learns the IP addresses by
monitoring the traffic sent by the CPE devices, and the first CPE devices to transmit traffic are the
first CPE devices to be learned.
• The no cable submgmt default learnable command sets the default to FALSE, which specifies that
the CMTS does not learn the IP addresses for the CPE devices behind a particular CM. Instead, the IP
addresses for each CM that is to be allowed access must be specified in the DOCSIS configuration file.
Cisco IOS CMTS Cable Command Reference
CBL-544 OL-15510-15
Cable Commands: cable s
cable submgmt default
cable submgmt default max-cpe cpe-num
Sets the docsSubMgtCpeMaxIpDefault attribute, which specifies the default value for the
docsSubMgtCpeControlMaxCpeIp attribute in docsSubMgtCpeControlTable. This attribute specifies
the maximum number of IP addresses that can transmit traffic through a particular CM. The possible
range is 0 to 1024, and the original default is 16.
Note The MAX-CPE attribute is used only when the CMTS is actively managing CPE devices for the CM.
Filter Group Management
The second form of the cable submgmt default command controls the default values for the entries in
the docsSubMgtCmFilterTable, which assigns the CM to one or more filter groups. A filter group
specifies what filters are applied to the traffic going to or coming from each particular CM or CPE
device. Filter groups can be numbered 0 to 1024, where 0 specifies that no filtering is done for that
particular traffic type.
Note The actual filters specified in these commands must be created by setting the appropriate attributes in
the DOCS-SUBMGT-MIB MIB using SNMP SET commands.
cable submgmt default filter-group cpe downstream group-id
Sets the ocsSubMgtSubFilterDownDefault attribute, which is the default value for the
docsSubMgtSubFilterDownstream attribute in the docsSubMgtCmFilterTable. This attribute applies to
downstream traffic that is sent to the CPE devices behind a particular CM.
cable submgmt default filter-group cpe upstream group-id
Sets the docsSubMgtSubFilterUpDefault attribute, which is the default value for the
docsSubMgtSubFilterUpstream attribute in the docsSubMgtCmFilterTable. This attribute applies to
upstream traffic that is sent by the CPE devices behind a particular CM.
cable submgmt default filter-group cm downstream group-id
Sets the docsSubMgtCmFilterDownDefault attribute, which is the default value for the
docsSubMgtCmFilterDownstream attribute in the docsSubMgtCmFilterTable. This attribute applies to
downstream traffic that is addressed to a particular CM.
cable submgmt default filter-group cm upstream group-id
Sets the docsSubMgtCmFilterUpDefault attribute, which is the default value for the
docsSubMgtCmFilterUpstream attribute in the docsSubMgtCmFilterTable. This attribute applies to
upstream traffic that is sent by a particular CM.
Note For more information about using static CPE override, see the Cisco CMTS Static CPE Override feature
on Cisco.com.
Examples The following commands specify that the CMTS defaults to actively managing the CPE devices for each
CM that registers, allowing and learning up to four IP addresses for the CPE devices behind that CM.
Router# configure terminal
Router(config)# cable submgmt default active
Router(config)# cable submgmt default learnable
Router(config)# cable submgmt default max-cpe 4
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-545
Cable Commands: cable s
cable submgmt default
The following commands specify that the CMTS defaults to actively managing the CPE devices for each
CM that registers. Each CM, however, must specify its own MAX-CPE value; otherwise, that value
defaults to 0 and all traffic to and from the CPE devices for that CM is blocked.
Router# configure terminal
Router(config)# cable submgmt default active
Router(config)# cable submgmt default max-cpe 0
The following commands specify that the CMTS defaults to not actively managing the CPE devices for
each CM that registers. However, if the CM at registration time indicates that the CMTS is to actively
manage the CPE devices, the CMTS defaults to allowing only one CPE device. Learning also is disabled,
so that one CPE device, therefore, must be specified in the DOCSIS configuration file that the CM uses
to register.
Router# configure terminal
Router(config)# no cable submgmt default active
Router(config)# no cable submgmt default learnable
Router(config)# cable submgmt default max-cpe 1
The following commands specify that the CMTS defaults to assigning three filter groups to each CM
that registers. Unless the CM indicates otherwise at registration time, downstream and upstream traffic
for the CPE devices behind the CM is filtered according to the rules for filter groups 20 and 21,
respectively. Filter group 1 is applied to the downstream traffic addressed to the CM. Upstream traffic
sent by the CM, however, is not filtered.
Router# configure terminal
Router(config)# cable submgmt default filter-group cpe downstream 20
Router(config)# cable submgmt default filter-group cpe upstream 21
Router(config)# cable submgmt default filter-group cm downstream 1
Router(config)# cable submgmt default filter-group cm upstream 0
Note The above example assumes that filter groups 1, 20, and 21 have already been created on the CMTS
using the appropriate SNMP commands.
Related Commands Command Description
cable filter group Creates a DOCSIS 1.1 filter group that filters packets on the basis of the
TCP/IP and UDP/IP headers.
Cisco IOS CMTS Cable Command Reference
CBL-546 OL-15510-15
Cable Commands: cable s
cable sync-interval
cable sync-interval
To specify the interval between successive sync message transmissions from the Cisco CMTS, use the
cable sync-interval command in cable interface configuration mode. To return the sync message
interval to its default value, use the no form of this command.
cable sync-interval msec
no cable sync-interval
Syntax Description msec Specifies the interval in milliseconds (ms) between successive sync message transmissions from
the Cisco CMTS. Valid values are from 1 to 200 ms. Default value is 10 ms.
Command Default 10 ms
Command Modes Interface configuration (cable interface only)
Command History Release Modification
11.3 NA This command was introduced.
Usage Guidelines To verify whether or not a sync message interval has been configured, enter the show running-config
command and look for the cable interface configuration information. If a sync message interval has been
configured, it appears in this output. If the sync message interval has been deactivated or reset to its
default value, no sync interval command line appears in the output.
Examples The following example shows how to specify the interval for the sync message transmissions to 100 ms:
Router (config-if)# cable sync-interval 100
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-547
Cable Commands: cable s
cable sync-interval
Cisco IOS CMTS Cable Command Reference
CBL-548 OL-15510-15
Cable Commands: cable t
Revised: July 2012, OL-15510-15
New Commands
Command Cisco IOS Software Release
cable tag 12.2(33)SCC
cable tx-power-headroom 12.2(33)SCE3
cable throttle-modem 12.2(33)SCF3
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-549
Cable Commands: cable t
cable tag
cable tag
To configure a tag for a DOCSIS load balancing group on the CMTS, use the cable load-balance
docsis-group command in the global configuration mode. To delete the tag and remove it from the
CMTS configuration, use the no form of this command.
cable tag 1-1000
no cable tag 1-1000
Syntax Description 1-1000 Specifies a cable tag number.
Command Default No default behavior or values.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines The cable tag command creates a tag with the specified number and then enters the cmts-tag
configuration mode. Use the following commands in the cmts-tag configuration mode to configure the
tag:
• docsis-version
• exclude
• exit
• name
• oui
• override
• service-class
• service-type-id
Examples The following example shows how to create a tag numbered as “1' following which the system enters
the cmts-tag configuration mode:
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# cable tag 1
Router(config-cmts-tag)# name CSCO
Router(config-cmts-tag)# service-type-id commercial
Router(config-cmts-tag)# service-class work
Router(config-cmts-tag)# docsis-version docsis20
Router(config-cmts-tag)# oui 00.1a.c3
Cisco IOS CMTS Cable Command Reference
CBL-550 OL-15510-15
Cable Commands: cable t
cable tag
Router(config-cmts-tag)# override
The following example shows how to configure the tag to exclude a DOCSIS version, a MAC address,
a service class name, or a service type ID.
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# cable tag 1
Router(config-cmts-tag)# exclude docsis-version docsis10
Router(config-cmts-tag)# exclude oui 00.1a.c3
Router(config-cmts-tag)# exclude service-class work
Router(config-cmts-tag)# exclude service-type-id commercial
Related Commands Command Description
docsis-version Configures the specified DOCSIS version of the cable modem (CM) for the
tag.
exclude Configures the tag to exclude a DOCSIS version, a MAC address, a service
class name, or a service type ID.
name Specifies the name of the tag.
oui Configures the specified Organization Unique Identifier (OUI) of the CM
for the tag.
override Overrides type/length/value (TLV) or Simple Network Management
Protocol (SNMP) settings when assigning the restricted load balancing
group (RLBG) to CMs.
service-class Configures the specified service class name for the tag.
service-type-id Configures the specified service type ID for the tag.
tag Associates the cable modem tag with a RLBG.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-551
Cable Commands: cable t
cable telco-return enable
cable telco-return enable
To enable telco-return support, use the cable telco-return enable command in cable interface
configuration mode. To disable this feature, use the no form of this command.
telco-return enable
no cable telco-return enable
Syntax Description This command has no arguments or keywords.
Command Default Telco-return support is disabled.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.0(4)XI This command was introduced.
Examples The following example shows how to enable telco-return:
Router(config-if)# cable telco-return enable
Note This command is available only in images that support telco-return. These images have a “t” as part of
the image name.
Related Commands Command Description
cable telco-return interval Defines the interval for sending Telephony Channel
Descriptor (TCD) and Termination System Information
(TSI) messages.
cable telco-return registration-ip Selects a different IP address for the telco-return CM to
send its registration requests.
cable telco-return spd dhcp-authenticate Indicates that telco-return CMs must use a specific DHCP
server.
cable telco-return spd dhcp-server Identifies the IP address of the DHCP server that the
telco-return CMs must use.
cable telco-return spd dial-timer Sets the number of seconds that a telephone connection is
idle before the telco-return CM disconnects the call.
cable telco-return spd factory-default Indicates the service provider descriptor (SPD) that the
telco-return CM uses during the initialization process.
cable telco-return spd manual-dial Enables the telco-return CM to operate in manual-dial
mode.
Cisco IOS CMTS Cable Command Reference
CBL-552 OL-15510-15
Cable Commands: cable t
cable telco-return enable
cable telco-return spd password Sets the password that the telco-return CM uses for
authentication when establishing a PPP connection.
cable telco-return spd phonenum Sets the telephone numbers that the telco-return CM dials
when connecting to the headend’s network access server.
cable telco-return spd ppp-authenticate Selects the authentication procedure to use when the
telco-return CM is establishing a PPP connection.
cable telco-return spd radius-realm Selects a RADIUS server domain to use for the login
response string.
cable telco-return spd service-provider Includes the service provider name in the SPD message.
cable telco-return spd threshold Sets the number of failed dial-up connections that can
occur before the CM indicates a connection failure.
cable telco-return spd username Sets the username that the telco-return CM uses for
authentication when establishing a PPP connection.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-553
Cable Commands: cable t
cable telco-return interval
cable telco-return interval
To set the interval for sending Telephony Channel Descriptor (TCD) and Termination System
Information (TSI) messages, use the cable telco-return interval command in cable interface
configuration mode. To restore the default value, use the no form of this command.
cable telco-return interval seconds
no cable telco-return interval
Syntax Description seconds Number of seconds between intervals for sending TCD and TSI messages. Valid range is 2
through 60 seconds.
Command Default 2 seconds
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.0(4)XI This command was introduced.
Examples The following example shows how to set the TCD and TSI message interval to 40 seconds:
Router(config-if)# cable telco-return interval 40
Note This command is available only in images that support telco-return. These images have a “t” as part of
the image name.
Related Commands Command Description
cable telco-return enable Enables telco-return functionality.
cable telco-return registration-ip Selects a different IP address for the telco-return CM to
send its registration requests.
cable telco-return spd dhcp-authenticate Indicates that telco-return CMs must use a specific DHCP
server.
cable telco-return spd dhcp-server Identifies the IP address of the DHCP server that the
telco-return CMs must use.
cable telco-return spd dial-timer Sets the number of seconds that a telephone connection is
idle before the telco-return CM disconnects the call.
cable telco-return spd factory-default Indicates the service provider descriptor (SPD) that the
telco-return CM uses during the initialization process.
cable telco-return spd manual-dial Enables the telco-return CM to operate in manual-dial
mode.
Cisco IOS CMTS Cable Command Reference
CBL-554 OL-15510-15
Cable Commands: cable t
cable telco-return interval
cable telco-return spd password Sets the password that the telco-return CM uses for
authentication when establishing a PPP connection.
cable telco-return spd phonenum Sets the telephone numbers that the telco-return CM dials
when connecting to the headend’s network access server.
cable telco-return spd ppp-authenticate Selects the authentication procedure to use when the
telco-return CM is establishing a PPP connection.
cable telco-return spd radius-realm Selects a RADIUS server domain to use for the login
response string.
cable telco-return spd service-provider Includes the service provider name in the SPD.
cable telco-return spd threshold Sets the number of failed dial-up connections that can
occur before the CM indicates a connection failure.
cable telco-return spd username Sets the username that the telco-return CM uses for
authentication when establishing a PPP connection.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-555
Cable Commands: cable t
cable telco-return registration-ip
cable telco-return registration-ip
To select a different IP address for the telco-return CM to send its registration requests, use the cable
telco-return registration-ip command in cable interface configuration mode. To restore the default
value, use the no form of this command.
cable telco-return registration-ip ip-address
no cable telco-return registration-ip
Syntax Description ip-address Registration IP address that is sent in Termination System Information (TSI) messages.
Value is any of the cable interface’s IP addresses.
Command Default The downstream channel IP address of the Cisco CMTS is used.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.1(2)EC This command was introduced.
Usage Guidelines This command sets the Registration IP Address parameter in TSI messages. By default, the downstream
channel IP address of the Cisco CMTS is also used for the registration IP address. When this cable
telco-return registration-ip command is configured, telco-return CMs send their registration requests
to this IP address instead of to the downstream channel IP address.
Note This command is available only in images that support telco-return. These images have a “t” as part of
the image name.
Examples The following example shows how to send the CM’s registration requests to IP address 172.16.1.1:
Router(config-if)# cable telco-return registration-ip 172.16.1.1
Related Commands Command Description
cable telco-return enable Enables telco-return functionality.
cable telco-return interval Defines the interval for sending Telephony Channel
Descriptor (TCD) and TSI messages.
cable telco-return spd dhcp-authenticate Indicates that telco-return CMs must use a specific DHCP
server.
cable telco-return spd dhcp-server Identifies the IP address of the DHCP server that the
telco-return CMs must use.
Cisco IOS CMTS Cable Command Reference
CBL-556 OL-15510-15
Cable Commands: cable t
cable telco-return registration-ip
cable telco-return spd dial-timer Sets the number of seconds that a telephone connection is
idle before the telco-return CM disconnects the call.
cable telco-return spd factory-default Indicates the service provider descriptor (SPD) that the
telco-return CM uses during the initialization process.
cable telco-return spd manual-dial Enables the telco-return CM to operate in manual-dial
mode.
cable telco-return spd password Sets the password that the telco-return CM uses for
authentication when establishing a PPP connection.
cable telco-return spd phonenum Sets the telephone numbers that the telco-return CM dials
when connecting to the headend’s network access server.
cable telco-return spd ppp-authenticate Selects the authentication procedure to use when the
telco-return CM is establishing a PPP connection.
cable telco-return spd radius-realm Selects a RADIUS server domain to use for the login
response string.
cable telco-return spd service-provider Includes the service provider name in the SPD.
cable telco-return spd threshold Sets the number of failed dial-up connections that can
occur before the CM indicates a connection failure.
cable telco-return spd username Sets the username that the telco-return CM uses for
authentication when establishing a PPP connection.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-557
Cable Commands: cable t
cable telco-return spd dhcp-authenticate
cable telco-return spd dhcp-authenticate
To require the telco-return CM to use a specific Dynamic Host Configuration Protocol (DHCP) server,
use the cable telco-return spd dhcp-authenticate command in cable interface configuration mode. To
restore the default value, use the no form of this command.
cable telco-return spd spd-number dhcp-authenticate
no cable telco-return spd spd-number dhcp-authenticate
Syntax Description spd-number Service provider descriptor (SPD) number for which this parameter is set. Valid range is
1 through 5.
Command Default The CM can use any available DHCP server.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.0(4)XI This command was introduced.
Usage Guidelines This command sets the DHCP Authenticate parameter to TRUE (1) for the specified SPD in the
Telephony Channel Descriptor (TCD) messages. It indicates that the CM must use the DHCP server that
is specified with the cable telco-return spd dhcp-server command.
Note This command is available only in images that support telco-return. These images have a “t” as part of
the image name.
Examples The following example indicates that for SPD 2, CMs must use the DHCP server identified by IP address
192.168.255.255:
Router(config-if)# cable telco-return spd 2 dhcp-authenticate
Router(config-if)# cable telco-return spd 2 dhcp-server 192.168.255.255
Related Commands Command Description
cable telco-return enable Enables telco-return functionality.
cable telco-return interval Defines the interval for sending TCD and Termination
System Information (TSI) messages.
cable telco-return registration-ip Selects a different IP address for the telco-return CM to
send its registration requests.
Cisco IOS CMTS Cable Command Reference
CBL-558 OL-15510-15
Cable Commands: cable t
cable telco-return spd dhcp-authenticate
cable telco-return spd dhcp-server Identifies the IP address of the DHCP server that the
telco-return CMs must use.
cable telco-return spd dial-timer Sets the number of seconds that a telephone connection is
idle before the telco-return CM disconnects the call.
cable telco-return spd factory-default Indicates the SPD that the telco-return CM uses during the
initialization process.
cable telco-return spd manual-dial Enables the telco-return CM to operate in manual-dial
mode.
cable telco-return spd password Sets the password that the telco-return CM uses for
authentication when establishing a PPP connection.
cable telco-return spd phonenum Sets the telephone numbers that the telco-return CM dials
when connecting to the headend’s network access server.
cable telco-return spd ppp-authenticate Selects the authentication procedure to use when the
telco-return CM is establishing a PPP connection.
cable telco-return spd radius-realm Selects a RADIUS server domain to use for the login
response string.
cable telco-return spd service-provider Includes the service provider name in the SPD.
cable telco-return spd threshold Sets the number of failed dial-up connections that can
occur before the CM indicates a connection failure.
cable telco-return spd username Sets the username that the telco-return CM uses for
authentication when establishing a PPP connection.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-559
Cable Commands: cable t
cable telco-return spd dhcp-server
cable telco-return spd dhcp-server
To identify the IP address of the Dynamic Host Configuration Protocol (DHCP) server that the
telco-return CM must access, use the cable telco-return spd dhcp-server command in cable interface
configuration mode. To restore the default value, use the no form of this command.
cable telco-return spd spd-number dhcp-server ip-address
no cable telco-return spd spd-number dhcp-server
Syntax Description spd-number Service provider descriptor (SPD) number for which this parameter is
set. Valid range is 1 through 5.
ip-address IP address of the DHCP server that CMs must use.
Command Default The IP address is set to 0.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.0(4)XI This command was introduced.
Usage Guidelines This command sets the DHCP Server parameter in the specified SPD in Telephony Channel Descriptor
(TCD) messages. Telco-return CMs use the DHCP server that is identified by this IP address if the cable
telco-return spd dhcp-authenticate command is configured. If the cable telco-return spd
dhcp-authenticate command is not configured, the CMs use any available DHCP server.
Note This command is available only in images that support telco-return. These images have a “t” as part of
the image name.
Examples The following example indicates that for SPD 2, CMs must use the DHCP server identified by IP address
192.168.255.255:
Router(config-if)# cable telco-return spd 2 dhcp-authenticate
Router(config-if)# cable telco-return spd 2 dhcp-server 192.168.255.255
Related Commands Command Description
cable telco-return enable Enables telco-return functionality.
cable telco-return interval Defines the interval for sending TCD and Termination
System Information (TSI) messages.
Cisco IOS CMTS Cable Command Reference
CBL-560 OL-15510-15
Cable Commands: cable t
cable telco-return spd dhcp-server
cable telco-return registration-ip Selects a different IP address for the telco-return CM to
send its registration requests.
cable telco-return spd dhcp-authenticate Indicates that telco-return CMs must use a specific DHCP
server.
cable telco-return spd dial-timer Sets the number of seconds that a telephone connection is
idle before the telco-return CM disconnects the call.
cable telco-return spd factory-default Indicates the SPD that the telco-return CM uses during the
initialization process.
cable telco-return spd manual-dial Enables the telco-return CM to operate in manual-dial
mode.
cable telco-return spd password Sets the password that the telco-return CM uses for
authentication when establishing a PPP connection.
cable telco-return spd phonenum Sets the telephone numbers that the telco-return CM dials
when connecting to the headend’s network access server.
cable telco-return spd ppp-authenticate Selects the authentication procedure to use when the
telco-return CM is establishing a PPP connection.
cable telco-return spd radius-realm Selects a RADIUS server domain to use for the login
response string.
cable telco-return spd service-provider Includes the service provider name in the SPD.
cable telco-return spd threshold Sets the number of failed dial-up connections that can
occur before the CM indicates a connection failure.
cable telco-return spd username Sets the username that the telco-return CM uses for
authentication when establishing a PPP connection.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-561
Cable Commands: cable t
cable telco-return spd dial-timer
cable telco-return spd dial-timer
To set the number of seconds that a telephone connection is idle before the telco-return CM disconnects
the call, use the cable telco-return spd dial-timer command in cable interface configuration mode. To
restore the default value, use the no form of this command.
cable telco-return spd spd-number dial-timer seconds
no cable telco-return spd spd-number dial-timer
Syntax Description spd-number Service provider descriptor (SPD) number for which this parameter is
set. Valid range is 1 through 5.
seconds Number of seconds that a connection is idle before the CM
disconnects the call. Valid range is 0 through 4,294,967,295. The
default of 0 means that the dial-timer is not used.
Command Default The dial-timer is set to 0, which means that inactive telephone connections are not disconnected.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.0(4)XI This command was introduced.
Usage Guidelines This command sets the Demand Dial Timer parameter for the specified SPD in Telephony Channel
Descriptor (TCD) messages. This enables the CM to emulate true dial-on-demand functionality by
monitoring inactive networking time and allowing it to disconnect any telephone connection that
exceeds the timer.
Note This command is available only in images that support telco-return. These images have a “t” as part of
the image name.
Examples The following example shows how to set the timer to 2 hours:
Router(config-if)# cable telco-return spd 2 dial-timer 7200
Related Commands Command Description
cable telco-return enable Enables telco-return functionality.
cable telco-return interval Defines the interval for sending TCD and Termination
System Information (TSI) messages.
Cisco IOS CMTS Cable Command Reference
CBL-562 OL-15510-15
Cable Commands: cable t
cable telco-return spd dial-timer
cable telco-return registration-ip Selects a different IP address for the telco-return CM to
send its registration requests.
cable telco-return spd dhcp-authenticate Indicates that telco-return CMs must use a specific DHCP
server.
cable telco-return spd dhcp-server Identifies the IP address of the DHCP server that the
telco-return CMs must use.
cable telco-return spd factory-default Indicates the SPD that the telco-return CM uses during the
initialization process.
cable telco-return spd manual-dial Enables the telco-return CM to operate in manual-dial
mode.
cable telco-return spd password Sets the password that the telco-return CM uses for
authentication when establishing a PPP connection.
cable telco-return spd phonenum Sets the telephone numbers that the telco-return CM dials
when connecting to the headend’s network access server.
cable telco-return spd ppp-authenticate Selects the authentication procedure to use when the
telco-return CM is establishing a PPP connection.
cable telco-return spd radius-realm Selects a RADIUS server domain to use for the login
response string.
cable telco-return spd service-provider Includes the service provider name in the SPD.
cable telco-return spd threshold Sets the number of failed dial-up connections that can
occur before the CM indicates a connection failure.
cable telco-return spd username Sets the username that the telco-return CM uses for
authentication when establishing a PPP connection.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-563
Cable Commands: cable t
cable telco-return spd factory-default
cable telco-return spd factory-default
To indicate the service provider descriptor (SPD) that the telco-return CM uses during the initialization
process, use the cable telco-return spd factory-default command in cable interface configuration
mode. To restore the default value, use the no form of this command.
cable telco-return spd spd-number factory-default
no cable telco-return spd spd-number factory-default
Syntax Description spd-number Service provider descriptor (SPD) that contains the set of telephony
attributes used by the CM during initialization. Valid range is 1
through 5.
Command Default The Factory Default Flag in the SPD is set to 0, which means that this SPD is not used for the
initialization process.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.0(4)XI This command was introduced.
Usage Guidelines This command sets the Factory Default parameter in the specified SPD in Telephony Channel Descriptor
(TCD) messages. This determines the set of telephony attributes, as defined by the SPD, that are used
for the initialization process when the CM is powered on or is reset to its factory default.
Note This command is available only in images that support telco-return. These images have a “t” as part of
the image name.
Examples The following example shows how to set the telco-return CM to use SPD 2 during the initialization
procedure:
Router(config-if)# cable telco-return spd 2 factory-default
Related Commands Command Description
cable telco-return enable Enables telco-return functionality.
cable telco-return interval Defines the interval for sending TCD and Termination
System Information (TSI) messages.
cable telco-return registration-ip Selects a different IP address for the telco-return CM to
send its registration requests.
Cisco IOS CMTS Cable Command Reference
CBL-564 OL-15510-15
Cable Commands: cable t
cable telco-return spd factory-default
cable telco-return spd dhcp-authenticate Indicates that telco-return CMs must use a specific
Dynamic Host Configuration Protocol (DHCP) server.
cable telco-return spd dhcp-server Identifies the IP address of the DHCP server that the
telco-return CMs must use.
cable telco-return spd dial-timer Sets the number of seconds that a telephone connection
is idle before the telco-return CM disconnects the call.
cable telco-return spd manual-dial Enables the telco-return CM to operate in manual-dial
mode.
cable telco-return spd password Sets the password that the telco-return CM uses for
authentication when establishing a PPP connection.
cable telco-return spd phonenum Sets the telephone numbers that the telco-return CM
dials when connecting to the headend’s network access
server.
cable telco-return spd ppp-authenticate Selects the authentication procedure to use when the
telco-return CM is establishing a PPP connection.
cable telco-return spd radius-realm Selects a RADIUS server domain to use for the login
response string.
cable telco-return spd service-provider Includes the service provider name in the SPD.
cable telco-return spd threshold Sets the number of failed dial-up connections that can
occur before the CM indicates a connection failure.
cable telco-return spd username Sets the username that the telco-return CM uses for
authentication when establishing a PPP connection.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-565
Cable Commands: cable t
cable telco-return spd manual-dial
cable telco-return spd manual-dial
To enable the telco-return CM to operate in manual-dial mode, use the cable telco-return spd
manual-dial command in cable interface configuration mode. To restore the default value, use the no
form of this command.
cable telco-return spd spd-number manual-dial
no cable telco-return spd spd-number manual-dial
Syntax Description spd-number Service provider descriptor (SPD) number for which this parameter is
set. Valid range is 1 through 5.
Command Default Manual-dial mode is disabled.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.0(4)XI This command was introduced.
Usage Guidelines This command sets the Manual Dial vendor-specific parameter in the specified SPD in Telephony
Channel Descriptor (TCD) messages.
Note This command is available only in images that support telco-return. These images have a “t” as part of
the image name.
Examples The following example shows how to set manual-dial mode for SPD 1:
Router(config-if)# cable telco-return spd 1 manual-dial
Related Commands Command Description
cable telco-return enable Enables telco-return functionality.
cable telco-return interval Defines the interval for sending TCD and Termination
System Information (TSI) messages.
cable telco-return registration-ip Selects a different IP address for the telco-return CM to
send its registration requests.
cable telco-return spd dhcp-authenticate Indicates that telco-return CMs must use a specific
DHCP server.
Cisco IOS CMTS Cable Command Reference
CBL-566 OL-15510-15
Cable Commands: cable t
cable telco-return spd manual-dial
cable telco-return spd dhcp-server Identifies the IP address of the DHCP server that the
telco-return CMs must use.
cable telco-return spd dial-timer Sets the number of seconds that a telephone connection
is idle before the telco-return CM disconnects the call.
cable telco-return spd factory-default Indicates the SPD that the telco-return CM uses during
the initialization process.
cable telco-return spd password Sets the password that the telco-return CM uses for
authentication when establishing a PPP connection.
cable telco-return spd phonenum Sets the telephone numbers that the telco-return CM dials
when connecting to the headend’s network access server.
cable telco-return spd ppp-authenticate Selects the authentication procedure to use when the
telco-return CM is establishing a PPP connection.
cable telco-return spd radius-realm Selects a RADIUS server domain to use for the login
response string.
cable telco-return spd service-provider Includes the service provider name in the SPD.
cable telco-return spd threshold Sets the number of failed dial-up connections that can
occur before the CM indicates a connection failure.
cable telco-return spd username Sets the username that the telco-return CM uses for
authentication when establishing a PPP connection.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-567
Cable Commands: cable t
cable telco-return spd password
cable telco-return spd password
To set the password that the telco-return CM uses for authentication when establishing a PPP connection
with the access server, use the cable telco-return spd password command in cable interface
configuration mode. To restore the default value, use the no form of this command.
cable telco-return spd spd-number password password-string
no cable telco-return spd spd-number password
Syntax Description spd-number Service provider descriptor (SPD) number for which this parameter is
set. Valid range is 1 through 5.
password-string Login password that the CM uses for authentication during the
initialization procedure.
Command Default No password is used.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.0(4)XI This command was introduced.
Usage Guidelines This command sets the Login Password parameter for the specified SPD in Telephony Channel
Descriptor (TCD) messages.
Note This command is available only in images that support telco-return. These images have a “t” as part of
the image name.
Examples The following example shows how to set the password to 9JwoKd7 in service provider descriptor 2:
Router(config-if)# cable telco-return spd 2 password 9JwoKd7
Related Commands Command Description
cable telco-return enable Enables telco-return functionality.
cable telco-return interval Defines the interval for sending TCD and Termination
System Information (TSI) messages.
cable telco-return registration-ip Selects a different IP address for the telco-return CM to
send its registration requests.
Cisco IOS CMTS Cable Command Reference
CBL-568 OL-15510-15
Cable Commands: cable t
cable telco-return spd password
cable telco-return spd dhcp-authenticate Indicates that telco-return CMs must use a specific DHCP
server.
cable telco-return spd dhcp-server Identifies the IP address of the DHCP server that the
telco-return CMs must use.
cable telco-return spd dial-timer Sets the number of seconds that a telephone connection is
idle before the telco-return CM disconnects the call.
cable telco-return spd factory-default Indicates the SPD that the telco-return CM uses during the
initialization process.
cable telco-return spd manual-dial Enables the telco-return CM to operate in manual-dial
mode.
cable telco-return spd phonenum Sets the telephone numbers that the telco-return CM dials
when connecting to the headend’s network access server.
cable telco-return spd ppp-authenticate Selects the authentication procedure to use when the
telco-return CM is establishing a PPP connection.
cable telco-return spd radius-realm Selects a RADIUS server domain to use for the login
response string.
cable telco-return spd service-provider Includes the service provider name in the SPD.
cable telco-return spd threshold Sets the number of failed dial-up connections that can
occur before the CM indicates a connection failure.
cable telco-return spd username Sets the username that the telco-return CM uses for
authentication when establishing a PPP connection.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-569
Cable Commands: cable t
cable telco-return spd phonenum
cable telco-return spd phonenum
To set the telephone numbers that the telco-return CM uses when connecting to the headend’s network
access server, use the cable telco-return spd phonenum command in cable interface configuration
mode. To delete previously entered telephone numbers, use the no form of this command.
cable telco-return spd spd-number phonenum dial-string
no cable telco-return spd spd-number phonenum dial-string
Syntax Description spd-number Service provider descriptor (SPD) number for which this parameter is
set. Valid range is 1 through 5.
dial-string Telephone number that the CM uses to connect to the headend’s
network access server.
Command Default No default behavior or values
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.0(4)XI This command was introduced.
Usage Guidelines This command sets the Phone Number parameters in the specified SPD in Telephony Channel Descriptor
(TCD) messages. You can repeat this command, entering as many as three telephone numbers for the
CM to use when attempting to establish a PPP connection with the network access server. The phone
numbers are mapped to the parameters Phone Number1, Phone Number2, Phone Number3 in the order
in which you enter them. The CM attempts to connect using Phone Number1 first. If it fails to connect,
and its number of retries exceeds the limit set with the cable telco-return spd threshold command, the
CM dials the next number in the list.
Note This command is available only in images that support telco-return. These images have a “t” as part of
the image name.
Examples The following example shows how to set the primary phone number to 9255551212. If the CM fails to
connect using that number, it tries the next phone number, 9255551234:
Router(config-if)# cable telco-return spd 2 phonenum 9255551212
Router(config-if)# cable telco-return spd 2 phonenum 9255551234
Cisco IOS CMTS Cable Command Reference
CBL-570 OL-15510-15
Cable Commands: cable t
cable telco-return spd phonenum
Related Commands Command Description
cable telco-return enable Enables telco-return functionality.
cable telco-return interval Defines the interval for sending TCD and Termination
System Information (TSI) messages.
cable telco-return registration-ip Selects a different IP address for the telco-return CM to
send its registration requests.
cable telco-return spd dhcp-authenticate Indicates that telco-return CMs must use a specific DHCP
server.
cable telco-return spd dhcp-server Identifies the IP address of the DHCP server that the
telco-return CMs must use.
cable telco-return spd dial-timer Sets the number of seconds that a telephone connection is
idle before the telco-return CM disconnects the call.
cable telco-return spd factory-default Indicates the SPD that the telco-return CM uses during
the initialization process.
cable telco-return spd manual-dial Enables the telco-return CM to operate in manual-dial
mode.
cable telco-return spd password Sets the password that the telco-return CM uses for
authentication when establishing a PPP connection.
cable telco-return spd ppp-authenticate Selects the authentication procedure to use when the
telco-return CM is establishing a PPP connection.
cable telco-return spd radius-realm Selects a RADIUS server domain to use for the login
response string.
cable telco-return spd service-provider Includes the service provider name in the SPD.
cable telco-return spd threshold Sets the number of failed dial-up connections that can
occur before the CM indicates a connection failure.
cable telco-return spd username Sets the username that the telco-return CM uses for
authentication when establishing a PPP connection.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-571
Cable Commands: cable t
cable telco-return spd ppp-authenticate
cable telco-return spd ppp-authenticate
To select the authentication method used when the telco-return CM is establishing a PPP connection,
use the cable telco-return spd ppp-authenticate command in cable interface configuration mode. To
restore the default value, use the no form of this command.
cable telco-return spd spd-number ppp-authenticate [both | chap | pap]
no cable telco-return spd spd-number ppp-authenticate
Syntax Description spd-number Service provider descriptor (SPD) number for which this parameter is
set. Valid range is 1 through 5.
both Challenge Handshake Authentication Protocol (CHAP) is used if the
network access server supports CHAP. Password Authentication
Protocol (PAP) is used only if the network access server does not
support CHAP.
chap CHAP authentication is used.
pap PAP authentication is used.
Command Default The default is both; either CHAP or PAP is used depending on the methods supported by the network
access server.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.0(4)XI This command was introduced.
Usage Guidelines This command sets the PPP Authentication parameter for the specified SPD in Telephony Channel
Descriptor (TCD) messages.
Note This command is available only in images that support telco-return. These images have a “t” as part of
the image name.
Examples The following example requires the CM to perform CHAP authentication:
Router(config-if)# cable telco-return spd 2 ppp-authenticate chap
Cisco IOS CMTS Cable Command Reference
CBL-572 OL-15510-15
Cable Commands: cable t
cable telco-return spd ppp-authenticate
Related Commands Command Description
cable telco-return enable Enables telco-return functionality.
cable telco-return interval Defines the interval for sending TCD and Termination
System Information (TSI) messages.
cable telco-return registration-ip Selects a different IP address for the telco-return CM to
send its registration requests.
cable telco-return spd dhcp-authenticate Indicates that telco-return CMs must use a specific DHCP
server.
cable telco-return spd dhcp-server Identifies the IP address of the DHCP server that the
telco-return CMs must use.
cable telco-return spd dial-timer Sets the number of seconds that a telephone connection is
idle before the telco-return CM disconnects the call.
cable telco-return spd factory-default Indicates the SPD that the telco-return CM uses during the
initialization process.
cable telco-return spd manual-dial Enables the telco-return CM to operate in manual-dial
mode.
cable telco-return spd password Sets the password that the telco-return CM uses for
authentication when establishing a PPP connection.
cable telco-return spd phonenum Sets the telephone numbers that the telco-return CM dials
when connecting to the headend’s network access server.
cable telco-return spd radius-realm Selects a RADIUS server domain to use for the login
response string.
cable telco-return spd service-provider Includes the service provider name in the SPD.
cable telco-return spd threshold Sets the number of failed dial-up connections that can
occur before the CM indicates a connection failure.
cable telco-return spd username Sets the username that the telco-return CM uses for
authentication when establishing a PPP connection.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-573
Cable Commands: cable t
cable telco-return spd radius-realm
cable telco-return spd radius-realm
To select a RADIUS server domain to use for the login response string, use the cable telco-return spd
radius-realm command in cable interface configuration mode. To restore the default value, use the no
form of this command.
cable telco-return spd spd-number radius-realm string
no cable telco-return spd spd-number radius-realm
Syntax Description spd-number Service provider descriptor (SPD) number for which this parameter is
set. Valid range is 1 through 5.
string Alphanumeric string identifying a RADIUS server domain.
Command Default The default value is the null string.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.0(4)XI This command was introduced.
Usage Guidelines This command sets the RADIUS Realm parameter for the specified SPD in Telephony Channel
Descriptor (TCD) messages. When this command is configured, telco-return CMs use this realm string
to construct a domain name for the login username when responding to a PPP login query.
Note This command is available only in images that support telco-return. These images have a “t” as part of
the image name.
Examples The following example shows a login response string of “sandy@sunol”:
Router(config-if)# cable telco-return spd 3 radius-realm sunol
Router(config-if)# cable telco-return spd 3 username sandy
Related Commands Command Description
cable telco-return enable Enables telco-return functionality.
cable telco-return interval Defines the interval for sending TCD and Termination
System Information (TSI) messages.
cable telco-return registration-ip Selects a different IP address for the telco-return CM to
send its registration requests.
Cisco IOS CMTS Cable Command Reference
CBL-574 OL-15510-15
Cable Commands: cable t
cable telco-return spd radius-realm
cable telco-return spd dhcp-authenticate Indicates that telco-return CMs must use a specific DHCP
server.
cable telco-return spd dhcp-server Identifies the IP address of the DHCP server that the
telco-return CMs must use.
cable telco-return spd dial-timer Sets the number of seconds that a telephone connection is
idle before the telco-return CM disconnects the call.
cable telco-return spd factory-default Indicates the SPD that the telco-return CM uses during
the initialization process.
cable telco-return spd manual-dial Enables the telco-return CM to operate in manual-dial
mode.
cable telco-return spd password Sets the password that the telco-return CM uses for
authentication when establishing a PPP connection.
cable telco-return spd phonenum Sets the telephone numbers that the telco-return CM dials
when connecting to the headend’s network access server.
cable telco-return spd ppp-authenticate Selects the authentication procedure to use when the
telco-return CM is establishing a PPP connection.
cable telco-return spd service-provider Includes the service provider name in the SPD.
cable telco-return spd threshold Sets the number of failed dial-up connections that can
occur before the CM indicates a connection failure.
cable telco-return spd username Sets the username that the telco-return CM uses for
authentication when establishing a PPP connection.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-575
Cable Commands: cable t
cable telco-return spd service-provider
cable telco-return spd service-provider
To include the service provider name in the SPD, use the cable telco-return service-provider command
in cable interface configuration mode. To remove the parameter from the SPD, use the no form of this
command.
cable telco-return spd spd-number service-provider spd-string
no cable telco-return spd spd-number service-provider
Syntax Description spd-number Service provider descriptor number for which this parameter is set.
Valid range is 1 through 5.
spd-string Alphanumeric string that identifies the service provider.
Command Default No default behavior or values
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.0(4)XI This command was introduced.
Usage Guidelines This command sets the Service Provider Name parameter for the specified SPD in the Telephony
Channel Descriptor (TCD) messages.
Note This command is available only in images that support telco-return. These images have a “t” as part of
the image name.
Examples The following example shows the service provider name being set to “san_jose” for SPD 2:
Router(config-if)# cable telco-return spd 2 service-provider san_jose
Related Commands Command Description
cable telco-return enable Enables telco-return functionality.
cable telco-return interval Defines the interval for sending TCD and Termination
System Information (TSI) messages.
cable telco-return registration-ip Selects a different IP address for the telco-return CM to
send its registration requests.
cable telco-return spd dhcp-authenticate Indicates that telco-return CMs must use a specific DHCP
server.
Cisco IOS CMTS Cable Command Reference
CBL-576 OL-15510-15
Cable Commands: cable t
cable telco-return spd service-provider
cable telco-return spd dhcp-server Identifies the IP address of the DHCP server that the
telco-return CMs must use.
cable telco-return spd dial-timer Sets the number of seconds that a telephone connection is
idle before the telco-return CM disconnects the call.
cable telco-return spd factory-default Indicates the SPD that the telco-return CM uses during
the initialization process.
cable telco-return spd manual-dial Enables the telco-return CM to operate in manual-dial
mode.
cable telco-return spd password Sets the password that the telco-return CM uses for
authentication when establishing a PPP connection.
cable telco-return spd phonenum Sets the telephone numbers that the telco-return CM dials
when connecting to the headend’s network access server.
cable telco-return spd ppp-authenticate Selects the authentication procedure to use when the
telco-return CM is establishing a PPP connection.
cable telco-return spd radius-realm Selects a RADIUS server domain to use for the login
response string.
cable telco-return spd threshold Sets the number of failed dial-up connections that can
occur before the CM indicates a connection failure.
cable telco-return spd username Sets the username that the telco-return CM uses for
authentication when establishing a PPP connection.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-577
Cable Commands: cable t
cable telco-return spd threshold
cable telco-return spd threshold
To set the number of failed dial-up connections that can occur before the CM indicates a connection
failure, use the cable telco-return spd threshold command in cable interface configuration mode. To
restore the default value, use the no form of this command.
cable telco-return spd spd-number threshold threshold-number
no cable telco-return spd spd-number threshold
Syntax Description spd-number Service provider descriptor (SPD) number for which this parameter is
set. Valid range is 1 through 5.
threshold-number Number of dial-up attempts that fail before the CM declares a
connection failure. Valid range is 1 through 255.
The default value is 1.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.0(4)XI This command was introduced.
Usage Guidelines This command sets the Connection Threshold parameter for the specified SPD in the Telephony Channel
Descriptor (TCD) messages. A dial-up attempt is considered a connection failure if an answer
connection is not made after ten rings. The CM continues to try to connect until the connection threshold
is reached. If multiple phone numbers are configured using the cable telco-return spd phonenum
command, the CM dials each phone number until it makes a connection or exceeds the configured
threshold.
Note This command is available only in images that support telco-return. These images have a “t” as part of
the image name.
Examples The following example shows the connection threshold being set to 20:
Router(config-if)# cable telco-return spd 2 threshold 20
Related Commands Command Description
cable telco-return enable Enables telco-return functionality.
cable telco-return interval Defines the interval for sending TCD and Termination
System Information (TSI) messages.
Cisco IOS CMTS Cable Command Reference
CBL-578 OL-15510-15
Cable Commands: cable t
cable telco-return spd threshold
cable telco-return registration-ip Selects a different IP address for the telco-return CM to
send its registration requests.
cable telco-return spd dhcp-authenticate Indicates that telco-return CMs must use a specific DHCP
server.
cable telco-return spd dhcp-server Identifies the IP address of the DHCP server that the
telco-return CMs must use.
cable telco-return spd dial-timer Sets the number of seconds that a telephone connection is
idle before the telco-return CM disconnects the call.
cable telco-return spd factory-default Indicates the SPD that the telco-return CM uses during the
initialization process.
cable telco-return spd manual-dial Enables the telco-return CM to operate in manual-dial
mode.
cable telco-return spd password Sets the password that the telco-return CM uses for
authentication when establishing a PPP connection.
cable telco-return spd phonenum Sets the telephone numbers that the telco-return CM dials
when connecting to the headend’s network access server.
cable telco-return spd ppp-authenticate Selects the authentication procedure to use when the
telco-return CM is establishing a PPP connection.
cable telco-return spd radius-realm Selects a RADIUS server domain to use for the login
response string.
cable telco-return spd service-provider Includes the service provider name in the SPD.
cable telco-return spd username Sets the username that the telco-return CM uses for
authentication when establishing a PPP connection.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-579
Cable Commands: cable t
cable telco-return spd username
cable telco-return spd username
To set the username that the telco-return CM uses for authentication when establishing a PPP connection
with the access server, use the cable telco-return spd username command in cable interface
configuration mode. To restore the default value, use the no form of this command.
cable telco-return spd spd-number username login-string
no cable telco-return spd spd-number username login-string
Syntax Description spd-number Service provider descriptor (SPD) number for which this parameter is
set. Valid range is 1 through 5.
login-string Username that the CM uses for authentication during the initialization
procedure.
Command Default The default value is guest.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.0(4)XI This command was introduced.
Usage Guidelines This command sets the Login Username parameter for the specified SPD in the Telephony Channel
Descriptor (TCD) messages.
Note This command is available only in images that support telco-return. These images have a “t” as part of
the image name.
Examples The following example shows the username being set to “sandy” for SPD 3:
Router(config-if)# cable telco-return spd 3 username sandy
Related Commands Command Description
cable telco-return enable Enables telco-return functionality.
cable telco-return interval Defines the interval for sending TCD and Termination
System Information (TSI) messages.
cable telco-return registration-ip Selects a different IP address for the telco-return CM to
send its registration requests.
Cisco IOS CMTS Cable Command Reference
CBL-580 OL-15510-15
Cable Commands: cable t
cable telco-return spd username
cable telco-return spd dhcp-authenticate Indicates that telco-return CMs must use a specific DHCP
server.
cable telco-return spd dhcp-server Identifies the IP address of the DHCP server that the
telco-return CMs must use.
cable telco-return spd dial-timer Sets the number of seconds that a telephone connection is
idle before the telco-return CM disconnects the call.
cable telco-return spd factory-default Indicates the SPD that the telco-return CM uses during the
initialization process.
cable telco-return spd manual-dial Enables the telco-return CM to operate in manual-dial
mode.
cable telco-return spd password Sets the password that the telco-return CM uses for
authentication when establishing a PPP connection.
cable telco-return spd phonenum Sets the telephone numbers that the telco-return CM dials
when connecting to the headend’s network access server.
cable telco-return spd ppp-authenticate Selects the authentication procedure to use when the
telco-return CM is establishing a PPP connection.
cable telco-return spd radius-realm Selects a RADIUS server domain to use for the login
response string.
cable telco-return spd service-provider Includes the service provider name in the SPD.
cable telco-return spd threshold Sets the number of failed dial-up connections that can
occur before the CM indicates a connection failure.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-581
Cable Commands: cable t
cable tftp-enforce
cable tftp-enforce
To require that all CMs on a cable interface attempt to download a DOCSIS configuration file using the
Trivial File Transfer Protocol (TFTP) through the cable interface before being allowed to register and
come online, use the cable tftp-enforce command in cable interface configuration mode. To disable this
feature, use the no form of this command.
cable tftp-enforce [mark-only]
no cable tftp-enforce [mark-only]
Syntax Description mark-only (Optional) Allow CMs to come online without attempting to download
a DOCSIS configuration file through the Cisco CMTS cable interface,
but prints a warning message and marks those CMs with a pound sign
(#) in the show cable modem command.
Command Default TFTP downloads through the Cisco CMTS are not required (no cable tftp-enforce).
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.1(11b)EC1 This command was introduced for the Cisco uBR7100 series and
Cisco uBR7200 series universal broadband routers.
12.1(19)EC CMs that fail the TFTP checked are now marked with a reject(c) error in the
show cable modem command, instead of the original reject(m) error, so as
to be consistent with the behavior in the Release 12.2 BC train.
12.2(8)BC2 Support for this command was added to the 12.2 BC release train for the
Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012
universal broadband routers.
12.2(15)BC1 The command was enhanced on the Cisco uBR10012 router to prevent the
router from rejecting cable modems that did properly download a DOCSIS
configuration file. See the “Operation on the Cisco uBR10012 Router”
section on page 583.
Usage Guidelines The cable tftp-enforce cable interface configuration command requires all cable modems on a cable
interface to attempt a TFTP request for the DOCSIS configuration file through the cable interface with
the Cisco CMTS router before being allowed to register and come online. This can help prevent the
following situations from occurring:
• Users who attempt theft-of-service by reconfiguring their local networks to allow the downloading
of an unauthorized DOCSIS configuration file from a local TFTP server. Typically, some users do
this to obtain services that they have not paid for, such as higher guaranteed bandwidths or a higher
priority Quality of Service (QoS) profile.
Cisco IOS CMTS Cable Command Reference
CBL-582 OL-15510-15
Cable Commands: cable t
cable tftp-enforce
• Some brands or models of cable modems might be running older software releases that cache the
DOCSIS configuration file and use the cached version instead of downloading the actual file from
a TFTP server during the registration process. Although this can marginally speed up the
registration process, it also violates the DOCSIS requirements and could create a situation in which
the cable modem is not using the proper DOCSIS configuration file. A user might then be
mistakenly accused of theft-of-service, when in reality the problem is the non-DOCSIS-compliant
cable modem.
The cable tftp-enforce command identifies these situations and can block these cable modems from
registering and coming online. This command also has a mark-only option that allows these cable
modems to come online, but it also identifies the cable modems so that the network administrators can
investigate the situation further before taking any action.
When the command is used without the mark-only option, cable modems that do not download a TFTP
file through the cable interface are blocked from registering and coming online. The following message
is displayed on the console when such a cable modem attempts to register:
06:53:57: %UBR7200-4-REGISTRATION_BEFORE_TFTP: Registration request unexpected:
Cable Modem did not attempt TFTP. Registration Rejected. CM Mac Addr <00ff.ff66.12fb>
The mark-only option allows cable modems that do not download the TFTP file to come online, but it
also prints a warning message on the console and marks the cable modem in the show cable modem
command with a pound sign (#). The following message is displayed on the console when such a cable
modem registers with the Cisco CMTS.
06:53:57: %UBR7200-4-REGISTRATION_BEFORE_TFTP: Registration request unexpected:
Cable Modem did not attempt TFTP. Modem marked with #. CM Mac Addr <00ff.ff66.12fb>
Tip Cisco recommends that you initially configure cable interfaces with the mark-only option, so that
potential problems are identified without immediately interfering with users’ ability to come online.
After you identify and resolve these initial problems, reconfigure the cable interfaces without the
mark-only option to block problem cable modems that attempt to come online without downloading a
valid DOCSIS configuration file.
The default behavior is not to require the TFTP download through the cable interface with the
Cisco CMTS router. Each cable interface must be configured with this command to require the TFTP
download.
Note The cable tftp-enforce command cannot be used on subinterfaces or on non-cable interfaces.
Operation on the Cisco uBR10012 Router
In Cisco IOS Release 12.2(15)BC1 and later releases, the Cisco uBR10012 router can occasionally
allow a cable modem to temporarily come online before the system has received confirmation that the
cable modem has downloaded the proper DOCSIS configuration file. This situation can occur when the
cable interface line card receives a registration request (REG-REQ) message from a cable modem before
the PRE1 module has notified the line card whether the modem did download the proper file from the
TFTP server.
In previous Cisco IOS releases, these cable modems were not allowed to come online (or marked as
TFTP violators) even if they had successfully downloaded the appropriate DOCSIS configuration file.
In Cisco IOS Release 12.2(15)BC1 and later releases, however, the Cisco uBR10012 router allows these
cable modems to temporarily come online until the PRE1 module has finished determining the modem’s
TFTP status. If the system determines that the modem did not download the appropriate DOCSIS
configuration file, it is then taken offline (or marked as a TFTP violator).
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-583
Cable Commands: cable t
cable tftp-enforce
Note In the above situation, cable modems that do not download a DOCSIS configuration file are marked as
“offline” instead of “reject(c)” by the show cable modem command. The console still displays the
%UBR10000-4-REGISTRATION_BEFORE_TFTP error message, however, to allow you to identify
these cable modems as TFTP violators.
Examples The following example shows how to enforce TFTP downloads for all of the cable modems on cable
interface 3/0. These cable modems must attempt a TFTP download of the DOCSIS configuration file
through the cable interface with the Cisco CMTS. If they do not, they are not allowed to register or come
online, and they are marked as having either a registration error—reject(c)—in the show cable modem
command.
Note The initial version of this feature marked CMs that failed the TFTP check as having a Message Integrity
Check (MIC) failure—reject(m). The command was changed to show reject(c) in Cisco IOS Release
12.2(8)BC2 and Release 12.1(19)EC.
Router# configure terminal
Router(config)# interface cable 3/0
Router(config-if)# cable tftp-enforce
Router(config-if)# exit
Router(config)#
Router# show cable modems
Interface Prim Online Timing Rec QoS CPE IP address MAC address
Sid State Offset Power
Cable3/0/U1 1 online(pt) 2734 0.50 5 0 10.1.1.38 00ff.fffa.0a35
Cable3/0/U0 2 online(pt) 2729 0.25 5 0 10.1.1.50 00ff.ff07.382f
Cable3/0/U0 3 init(i) 2732 0.25 2 0 10.1.1.48 00ff.ff03.307d
Cable3/0/U1 4 online(pt) 2737 0.75 5 0 10.1.1.34 00ff.ff59.4477
Cable3/0/U1 5 reject(m) 2215 0.25 2 0 10.1.1.47 00ff.ff66.12fb
Router#
Note DOCSIS-compliant cable modems that are rejected with a MIC failure go into the offline state for a short
period of time and then retry the registration process.
The debug cable registration command can be used to display additional information:
Router# debug cable interface c3/0 verbose
Router# debug cable registration
CMTS registration debugging is on
Jun 6 23:27:15.859: Registration request from 00ff.ff66.12fb, SID 7 on Cable3/0/U1
Jun 6 23:27:15.859: Found a network access control parameter: Ok
Jun 6 23:27:15.859: Found a class of service block: Ok
Jun 6 23:27:15.859: Found Baseline Privacy config: Ok
Jun 6 23:27:15.859: Found Max CPE: Ok
Jun 6 23:27:15.859: Found CM MIC: Ok
Jun 6 23:27:15.859: Found CMTS MIC: Ok
Jun 6 23:27:15.859: Found modem ip: Ok
Jun 6 23:27:15.859: Found modem capabilities: Ok
Jun 6 23:27:15.859: Finished parsing REG Request
Jun 6 23:27:15.859: Cable Modem sent Registration Request without attempting required
TFTP
22:33:21 %UBR7200-4-REGISTRATION_BEFORE_TFTP: Registration request unexpected:
Cisco IOS CMTS Cable Command Reference
CBL-584 OL-15510-15
Cable Commands: cable t
cable tftp-enforce
Cable Modem did not attempt TFTP. Registration Rejected. CM Mac Addr <00ff.ff66.12fb>
Registration failed for Cable Modem 00ff.ff66.12fb on interface Cable3/0/U0:
CoS/Sflow/Cfr/PHS failed in REG-REQ
Jun 6 23:27:15.859: REG-RSP Status : failure (2)
Jun 6 23:27:15.859: Registration Response:
Jun 6 23:27:15.859: 0x0000: C2 00 00 1B 00 00 00 50 73 4E B4 19 00 05 00 E0
Jun 6 23:27:15.859: 0x0010: 56 AC 00 09 00 00 03 01 07 00 00 02 02
Jun 6 23:27:15.859: Registration Response Transmitted
The following example of the mark-only option shows how that cable modems that do not attempt a
TFTP download through the Cisco CMTS are allowed to register and come online, but they are marked
with a pound sign (#) when using the show cable modem command.
Router# configure terminal
Router(config)# interface cable 3/0
Router(config-if)# cable tftp-enforce mark-only
Router(config-if)# exit
Router(config)#
Router# show cable modems
Interface Prim Online Timing Rec QoS CPE IP address MAC address
Sid State Offset Power
Cable3/0/U1 1 online(pt) 2734 0.50 5 0 10.1.1.38 00ff.fffa.0a35
Cable3/0/U0 2 online(pt) 2729 0.25 5 0 10.1.1.50 00ff.ff07.382f
Cable3/0/U0 3 init(i) 2732 0.25 2 0 10.1.1.48 00ff.ff03.307d
Cable3/0/U1 4 online(pt) 2737 0.75 5 0 10.1.1.34 00ff.ff59.4477
Cable3/0/U1 5 #online 2213 0.25 6 0 10.1.1.47 00ff.ff66.12fb
Router#
The debug cable registration command can be used to display additional information:
Jun 6 23:27:15.859: Registration request from 00ff.ff66.12fb, SID 7 on Cable3/0/U1
Jun 6 23:27:15.859: Found a network access control parameter: Ok
Jun 6 23:27:15.859: Found a class of service block: Ok
Jun 6 23:27:15.859: Found Baseline Privacy config: Ok
Jun 6 23:27:15.859: Found Max CPE: Ok
Jun 6 23:27:15.859: Found CM MIC: Ok
Jun 6 23:27:15.859: Found CMTS MIC: Ok
Jun 6 23:27:15.859: Found modem ip: Ok
Jun 6 23:27:15.859: Found modem capabilities: Ok
Jun 6 23:27:15.859: Finished parsing REG Request
Jun 6 23:27:15.859: Cable Modem sent Registration Request without attempting required
TFTP
23:27:15: %UBR7200-4-REGISTRATION_BEFORE_TFTP: Registration request unexpected:
Cable Modem did not attempt TFTP. Modem marked with #. CM Mac Addr <00ff.ff66.12fb>
Jun 6 23:27:15.859: Sec sids obtained for all requested classes of service
Jun 6 23:27:15.859: Performing connection admission control (CAC) for each Sid
Jun 6 23:27:15.859: CAC Status for ClassID:1 is CAC_SUCCESS
Jun 6 23:27:15.859: Registration Status: ok (0)
Jun 6 23:27:15.859: Registration Response Transmitted
Tip You can also use the show interface cable sid and show cable qos profile commands to examine the
SID and service classes in use, to determine whether a CM has registered using unauthorized QoS
parameters.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-585
Cable Commands: cable t
cable tftp-enforce
Related Commands Command Description
cable dynamic-secret Enables the dynamic shared secret feature, so that DOCSIS
configuration files are verified with a dynamically generated shared
secret.
cable shared-secondary-secret Configures one or more secondary shared-secret keys that CMs can
use to successfully process the DOCSIS configuration file and
register with the CMTS.
cable shared-secret Configures an authentication shared-secret key that CMs must use to
successfully process the DOCSIS configuration file and register with
the CMTS.
debug cable registration Displays debug messages for the CM registration process.
show cable modem Displays information for the registered and unregistered CMs.
Cisco IOS CMTS Cable Command Reference
CBL-586 OL-15510-15
Cable Commands: cable t
cable throttle-modem
cable throttle-modem
To enable the Cable Modem Registration Throttling feature, which improves the cable modem online
speed at initial ranging stage by reducing CPU usage, use the cable throttle-modem command in global
configuration mode. To disable this feature, use the no form of this command.
cable throttle-modem init-rate value holdoff-time value flush-rate value
no cable throttle-modem
Syntax Description init-rate value Specifies the maximum number of modems allowed to pass the initialization
step per second. The valid range is from 1 to 1000. The default value is 32.
holdoff-time value Specifies the maximum number of seconds a cable modem is allowed to wait
in the throttling queue. The valid range is from 5 to 100. The default value
is 45.
flush-rate value Specifies the maximum number of modems flushed per second from the
throttling queue after the holdoff time expires. The valid range is from 100
to 1000. The default value is 300.
Command Default This command is disabled by default.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCF3 This command was introduced.
Usage Guidelines The cable throttle-modem command enables dynamic adjustment of number of cable modems in the
registration queue thus reducing CPU usage.
You must manually disable the cable throttle-ranging command configuration to enable the cable
throttle-modem command configuration.
Note The cable throttle-modem command is available only on the Cisco uBR10012 CMTS.
Examples The following example shows how to enable the Cable Modem Registration Throttling feature on a
Cisco CMTS:
Router# configure terminal
Router(config)# cable throttle-modem init-rate 1 holdoff-time 5 flush-rate 100
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-587
Cable Commands: cable t
cable throttle-modem
Related Commands Command Description
cable throttle-ranging Enables faster cable modem registration times.
show cable Displays cable throttle configuration information.
throttle-modem
Cisco IOS CMTS Cable Command Reference
CBL-588 OL-15510-15
Cable Commands: cable t
cable throttle-ranging
cable throttle-ranging
To enable faster cable modem registration times, use the cable throttle-ranging command in global
configuration mode. To disable faster cable modem registration times, use the no form of this command.
cable throttle-ranging
no cable throttle-ranging
Syntax Description This command has no arguments or keywords
Defaults This command is disabled by default.
Command Modes Global configuration
Command History Release Modification
12.3(21)BC This command was introduced.
Usage Guidelines The cable throttle-ranging command enables faster cable modem registration times on the CMTS.
Reload the Cisco CMTS with a Cisco IOS Release 12.3(21)BC image and configure the cable
throttle-ranging command on the CMTS. Once the cable throttle-ranging has been configured, save
the new configuration and reload the Cisco CMTS again. Faster cable modem registration times will
now be enabled on the Cisco CMTS.
Note The cable throttle-ranging command is only available on an ubr10k CMTS.
Examples The following example shows how to enable Fast CM registration feature on a Cisco CMTS:
Router(config)# cable throttle-ranging
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-589
Cable Commands: cable t
cable time-server
cable time-server
To enable the integrated time-of-day (ToD) server on the Cisco CMTS series, enter the cable
time-server command in global configuration mode. To disable the time-of-day server function, use the
no form of this command.
cable time-server
no cable time-server
Syntax Description This command has no keywords or arguments.
Command Default Disabled
Command Modes Global configuration
Usage Guidelines Per the DOCSIS specifications, the ToD server uses the UDP protocol, so UDP minor servers must also
be enabled using the service udp-small-servers max-servers no-limit command.
Command History Release Modification
12.0(4)XI This command was introduced.
Examples The following example shows how to enable the time-of-day server:
Router# configure terminal
Router(config)# service udp-small-servers max-servers no-limit
Router(config)# cable time-server
Router(config)#
Cisco IOS CMTS Cable Command Reference
CBL-590 OL-15510-15
Cable Commands: cable t
cable trust
cable trust
To enable packets from trusted source MAC addresses in DHCP, use the cable trust command in global
configuration mode. To remove a trusted MAC address from the MAC exclusion list, use the no form of
this command. Removing a MAC address from the exclusion list subjects all packets from that source
to standard DHCP source verification.
cable trust mac-address
no cable trust mac-address
Syntax Description mac-address The MAC address of a trusted DHCP source, and from which packets will
not be subject to standard DHCP source verification.
Defaults Disabled
Command Modes Global configuration
Usage Guidelines Per the DOCSIS specifications, the ToD server uses the UDP protocol, so UDP minor servers must also
be enabled using the service udp-small-servers max-servers no-limit command.
Command History Release Modification
12.3(13a)BC This command was introduced.
Usage Guidelines This command and capability are only supported in circumstances in which the Cable Source Verify
feature is first enabled on the Cisco CMTS.
When this feature is enabled in addition to cable source verify, a packet’s source must belong to the
MAC Exclude list on the Cisco CMTS. If the packet succeeds this exclusionary check, then the source
IP address is verified against Address Resolution Protocol (ARP) tables as per normal and previously
supported source verification checks. The service ID (SID) and the source IP address of the packet must
match those in the ARP host database on the Cisco CMTS. If the packet check succeeds, the packet is
allowed to pass. Rejected packets are discarded in either of these two checks.
Any trusted source MAC address in the optional exclusion list may be removed at any time. Removal of
a MAC address returns previously trusted packets to non-trusted status, and subjects all packets to
standard source verification checks on the Cisco CMTS.
Note When the cable source-verify dhcp feature is enabled, and a statically-defined IP address has been
added to the CMTS for a CM using the cable trust command to override the cable source-verify dhcp
checks for this device, packets from this CM will continue to be dropped until an entry for this CM is
added to the ARP database of the CMTS. To achieve this, disable the cable source-verify dhcp feature,
ping the CMTS from the CM to add an entry to the ARP database, and re-enable the cable source-verify
dhcp feature.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-591
Cable Commands: cable t
cable trust
For additional information about the enhanced Cable Source Verify DHCP feature, and general
guidelines for its use, 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
• IP Address Verification for the Cisco uBR7200 Series Cable Router
• CABLE SECURITY, Cable Source-Verify and IP Address Security, White Paper
Examples The following example shows how to enable the time-of-day server:
Router# configure terminal
Router(config)# cable trust 0007.0e03.69f9
Router(config)# Ctrl^Z
Router#
Cisco IOS CMTS Cable Command Reference
CBL-592 OL-15510-15
Cable Commands: cable t
cable tx-power-headroom
cable tx-power-headroom
To configure cable modems with the extended transmit power capability based on the
Organizational Unique Identifier (OUI), use the cable tx-power-headroom command in
global configuration mode. To disable this configuration, use the no form of this command.
cable tx-power-headroom OUI dB-value
no cable tx-power-headroom OUI dB-value
Syntax Description OUI First 24 bits of a MAC address that is unique to the cable modem vendor.
dB-value Decibel value for the upstream channel transmit power. The valid range is
from 1 to 6 dB.
Command Default None
Command Modes Global configuration (config)
Command History Release Modification
Cisco IOS Release 12.2(33)SCE3 This command was introduced.
Usage Guidelines You can use the cable tx-power-headroom command for each unique OUI. You can specify either the
MAC address or the OUI value with this command. If you specify the MAC address, only its OUI value
is saved.
Examples The following example shows how to configure extended transmit power on the Cisco CMTS router in
Cisco IOS Release 12.2(33)SCE3:
Router# configure terminal
Router(config)# cable tx-power-headroom 0025.2ed0.8cba 3
Related Commands Command Description
cable upstream Specifies the power budget offset value on the
max-channel-power-off Cisco CMTS router for the reduced channel set assignment.
show cable modem Displays transmit power values for each assigned upstream
channel along with cable modem details.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-593
Cable Commands: cable t
cable tx-power-headroom
Cisco IOS CMTS Cable Command Reference
CBL-594 OL-15510-15
Cable Commands: cable u through cable w
Revised: July 2012, OL-15510-15
New Commands
Command Cisco IOS Software Release
cable upstream rate-adapt (global) 12.3(23)BC2
cable upstream rate-adapt (interface) 12.3(23)BC2
cable upstream attribute-mask 12.2(33)SCB
cable upstream threshold hysteresis 12.3(23)BC7
cable upstream equalization-error-recovery 12.3(23)BC7
cable upstream active-codes 12.2(33)SCC
cable upstream bonding-group 12.2(33)SCC
cable upstream codes-per-minislot 12.2(33)SCC
cable upstream max-codes-per-subframe 12.2(33)SCC
cable upstream max-interleave-step 12.2(33)SCC
cable upstream max-logical-chans 12.2(33)SCC
cable upstream ranging-poll 12.2(33)SCC
cable upstream resiliency 12.2(33)SCC
cable upstream spreading-interval 12.2(33)SCC
cable upstream qos wfq 12.2(33)SCD2
cable util-interval 12.2(33)SCD2
cable upstream dpon 12.2(33)SCE
cable upstream max-channel-power-off 12.2(33)SCE3
cable upstream rate-limit-bwreq 12.2(33)SCF
exempted-priority
cable upstream rf-adapt 12.2(33)SCF
cable upstream rf-adapt(logical channel) 12.2(33)SCF
cable upstream threshold rf-adapt 12.2(33)SCF
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-595
Cable Commands: cable u through cable w
Command Cisco IOS Software Release
cable vrf-steering cable-modem 12.2(33)SCF
cable upstream ext-power 12.2(33)SCF2
Modified Commands
Command Cisco IOS Software Release
cable wideband auto-reset 12.3(23)BC
cable upstream modulation 12.3(23)BC7
cable upstream equalization-error-recovery 12.2(33)SCB4
cable upstream channel-width 12.2(33)SCC
cable upstream docsis-mode 12.2(33)SCC
cable upstream modulation-profile 12.2(33)SCC
cable upstream shutdown 12.2(33)SCC
cable upstream threshold 12.2(33)SCC
cable upstream max-ports 12.2(33)SCE
cable upstream ranging-init-technique 12.2(33)SCE
cable upstream connector 12.2(33)SCE
cable upstream rate-limit-ccf 12.2(33)SCF
cable upstream threshold 12.2(33)SCF
cable upstream threshold hysteresis 12.2(33)SCF
cable upstream load-balance group 12.2(33)SCE4
cable upstream resiliency 12.2(33)SCG
cable upstream docsis-mode 12.2(33)SCG
Cisco IOS CMTS Cable Command Reference
CBL-596 OL-15510-15
Cable Commands: cable u through cable w
cable upstream active-codes
cable upstream active-codes
To specify the number of active codes that can be configured on an upstream channel, use the
cable upstream active-codes command in cable interface configuration mode. To set the default value
of active codes to 112 when ingress noise cancellation is enabled and to 128 when it is disabled, use the
no form of this command.
cable upstream n active-codes active-code
no cable upstream n active-codes
Syntax Description n Specifies the upstream port. Valid values start with 0 for the first
upstream port on the cable interface line card.
active-code Specifies the number of active codes. Valid values are from 64 to 128,
with a default value of 112, when ingress noise cancellation is enabled;
and a default value of 128, when ingress noise cancellation is disabled.
Command Default The active-code setting cannot be applied if the Synchronous Code Division Multiple Access (S-CDMA)
is not configured.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines This command is applicable only for S-CDMA channels. You should configure S-CDMA to apply the
active-code setting.
Examples The following example sets the active code to 128 on upstream port 0:
Router(config)# interface cable 7/0/4
Router(config-if)# cable upstream 0 active-codes 128
Router(config-if)#
Related Commands Command Description
cable upstream Specifies the number of codes per minislot allowed on an upstream
codes-per-minislot channel.
cable upstream Specifies the spreading interval for S-CDMA channels on an
spreading-interval upstream channel.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-597
Cable Commands: cable u through cable w
cable upstream admission-control
cable upstream admission-control
To specify the percentage overbooking rate that is allowed on an upstream channel, use the
cable upstream admission-control command in cable interface configuration mode. To set
overbooking rate to its default of 100 percent, use the no form of this command.
cable upstream n admission-control percentage
no cable upstream n admission-control
Syntax Description n Specifies the upstream port. Valid values start with 0 for the first
upstream port on the cable interface line card.
percentage Specifies the percentage overbooking rate to limit overbooking. Valid
values are from 10 to 1000 percent, with a default of 100 percent.
Command Default 100 percent
Command Modes Interface configuration (cable interface only)
Command History Release Modification
11.3(6) NA This command was introduced.
Usage Guidelines This command limits the maximum number of CMs for a given upstream port by looking at the minimum
guaranteed upstream bandwidth allocated to each CM. Cable modems providing residential services and
commercial services can be given different weights according to their traffic needs. This command
affects only whether CMs can register with the CMTS—it does not affect CMs that have already come
online.
The CMTS uses the minimum guaranteed upstream bandwidth field from the CM’s DOCSIS
configuration file to calculate whether the CM can come online or not. If the CM’s minimum guaranteed
upstream bandwidth would exceed the total upstream bandwidth multiplied by the overbooking
percentage specified by this command, the CM cannot come online on that upstream. The CM will
attempt to find another upstream, and if it cannot register on any upstreams, it will attempt to lock on to
a new downstream.
Note A CM with a guaranteed upstream bandwidth does not consume that bandwidth unless it has active
traffic. By guaranteeing a CM a minimum upstream bandwidth, individual customers are assured of
never being totally shut out from network access in a very high-traffic situation.
Table 0-1 shows the approximate bandwidth for each upstream channel, depending on channel width,
symbol rate, and modulation type, when admission control is used at 100 percent. When setting
admission control to other values, scale the bandwidth values in Table 0-1 accordingly, so as to plan for
the maximum number of CMs effectively allowed per upstream port.
Cisco IOS CMTS Cable Command Reference
CBL-598 OL-15510-15
Cable Commands: cable u through cable w
cable upstream admission-control
Table 0-17 Admission Control Bandwidth Table
Channel Symbol Rate QPSK Virtual Channel 16 QAM Virtual Channel
Width (KHz) (Ksym/sec) Bandwidth—100% limit (bits/sec) Bandwidth—100% limit (bits/sec)
200 160 320,000 640,000
400 320 640,000 1,280,000
800 640 1,280,000 2,560,000
1600 1280 2,560,000 5,120,000
3200 2560 5,120,000 10,240,000
For example, with a 3.2 MHz channel width and QPSK modulation, the total bandwidth is approximately
5 Mbps. This is the maximum allowable bandwidth that can be allocated to CMs at the default admission
rate of 100%. If each CM is allocated a minimum upstream bandwidth of 128 kbps, this means a
maximum of 40 CMs will be allowed to come online.
To verify whether or not upstream admission control is configured and activated, use the show interface
command for a cable upstream to display its configuration information. If upstream admission control
is configured and enabled, the output contains an entry stating “CIR admission control enforced.” If
upstream admission control is disabled, no admission control entry is displayed in the output.
Note Setting the admission control limit to below the current total reserved bandwidth for the channel does
not immediately force any CMs offline, but may prevent CMs from reconnecting if they drop offline at
a later time. Increasing the admission control limit allows more CMs to connect.
When an upstream becomes overbooked, use the test cable ucc command to move a cable modem that
is currently online from one upstream port to another. For example, the following example shows that
the cable modem with the IP address of 10.128.1.128 is being moved from port C3/0/U0 to C3/0/U1:
Router# show cable modem 10.128.1.128
Interface Prim Online Timing Rec QoS CPE IP address MAC address
Sid State Offset Power
Cable3/0/U0 101 online 1919 5.25 7 0 10.128.1.128 0030.1976.7067
Router# test cable ucc c3/0 101 1
Router# show cable modem 10.128.1.128
Interface Prim Online Timing Rec QoS CPE IP address MAC address
Sid State Offset Power
Cable3/0/U1 101 online 1920 5.25 7 0 10.128.1.128 0030.1976.7067
Examples The following example shows overbooking on upstream port 4 being limited to 125 percent:
Router(config)# interface cable 3/0
Router(config-if)# cable upstream 4 admission-control 125
Router(config-if)#
Use the show interface cable upstream command to display the current status of admission control on
an interface. For example, the following command output shows that this upstream has allocated a total
bandwidth of 2.5 Mbit/sec to those online CMs that were assigned a guaranteed upstream bandwidth in
their DOCSIS configuration files.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-599
Cable Commands: cable u through cable w
cable upstream admission-control
This displays also shows that the admission control is being enforced at a subscription level of 125
percent. The Virtual channel BW field is computed by multiplying channel bandwidth by the admission
control limit. The Admissions requests rejected counter shows the number of cable modems that
attempted to register but were refused because of the admission control policy.
Router# show interface c3/0 u4
Cable3/0: Upstream 4 is up
Received 11585 broadcasts, 11854 multicasts, 3222651 unicasts
0 discards, 829 errors, 0 unknown protocol
3246090 packets input, 5 uncorrectable
557 noise, 0 microreflections
Total Modems On This Upstream Channel : 69 (68 active)
Default MAC scheduler
Queue[Rng Polls] 0/64, fifo queueing, 0 drops
Queue[Cont Mslots] 0/52, fifo queueing, 0 drops
Queue[CIR Grants] 0/64, fair queueing, 0 drops
Queue[BE Grants] 0/64, fair queueing, 0 drops
Queue[Grant Shpr] 0/64, calendar queueing, 0 drops
Reserved slot table currently has 0 CBR entries
Req IEs 205196036, Req/Data IEs 0
Init Mtn IEs 7604617, Stn Mtn IEs 422496
Long Grant IEs 4848, Short Grant IEs 1646196
Avg upstream channel utilization : 1%
Avg percent contention slots : 94%
Avg percent initial ranging slots : 1%
Avg percent minislots lost on late MAPs : 0%
Total channel bw reserved 2500000 bps
CIR admission control enforced
Subscribtion level 125%
Virtual channel bw 6400000 bps
Admission requests rejected 32
Current minislot count : 5200298 Flag: 0
Scheduled minislot count : 5200420 Flag: 0
Router#
If a CM is denied access due to the admission control policy, its entry in the show cable modem
command output shows “reject(c)”:
Router# show cable modem
Interface Prim Online Timing Rec QoS CPE IP address MAC address
Sid State Offset Power
Cable2/0/U0 1 online 2288 0.50 4 0 10.16.30.66 0010.7bb3.fb45
Cable2/0/U0 2 online 2288 0.50 4 0 10.16.30.68 0010.7bb3.fb7b
Cable2/0/U0 3 init(i) 2280 0.00 2 0 10.16.30.69 0010.9500.05e
. . .
Cable3/0/U1 113 online 3921 0.00 5 0 10.128.1.108 0030.9433.c38b
Cable3/0/U1 114 online 3920 0.25 6 0 10.128.1.87 0030.1976.6ebf
Cable3/0/U0 115 reject(c) 3922 0.25 2 0 10.128.1.75 0030.1976.703b
Cable3/0/U0 116 online 3919 0.75 5 0 10.128.1.57 0030.1976.6fa1
Related Commands Command Description
debug cable mac-scheduler Displays information for the MAC layer’s scheduler and admission
control activities.
debug cable us-adm-ctrl Displays debug messages for upstream admission control activity.
Cisco IOS CMTS Cable Command Reference
CBL-600 OL-15510-15
Cable Commands: cable u through cable w
cable upstream admission-control
show cable modem Displays statistics for a CM, including its upstream port and primary
SID.
show interface cable upstream Displays the interface configuration, which for an upstream includes
the current admission control policy, if any.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-601
Cable Commands: cable u through cable w
cable upstream attribute-mask
cable upstream attribute-mask
To specify an upstream attribute mask in hexadecimal format, use the cable upstream attribute-mask
command in cable interface configuration mode. Use the no form of this command to set default value
to upstream channel attribute mask.
cable upstream attribute-mask attribute-mask
no cable upstream upstream attribute-mask attribute-mask
Syntax Description upstream Specifies the upstream port.
attribute-mask Specifies the attribute mask bitmap in hexadecimal format.
attribute-mask
Example: 0-FFFFFFFF
Command Default If the router is not high availability (HA) supported and the upstream channel is not bonded, the default
value for cable upstream attribute mask is 0x00.
If the router is HA supported, the default value is 0x20000000.
If the upstream channel is part of a bonding group, the default value is 0x80000000.
If the router is HA supported and the upstream channel is part of a bonding group, the default value is
0xA0000000.
Command Modes Interface configuration—cable interface only (config-if)
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines This command sets the attribute mask of upstream channel.
Examples The following example shows how to set upstream attribute mask in hexadecimal format:
Router(config-if)# cable upstream 0 attribute-mask ffff
Related Commands Command Description
clear cable modem This command clears the cable modem attribute masks.
attribute-masks
Cisco IOS CMTS Cable Command Reference
CBL-602 OL-15510-15
Cable Commands: cable u through cable w
cable upstream bonding-group
cable upstream bonding-group
To create a static upstream bonding group on a cable interface, use the cable upstream bonding-group
command in cable interface configuration mode. To disable this configuration, use the no form of this
command.
cable upstream bonding-group id
no cable upstream bonding-group id
Syntax Description id Bonding group ID on the cable interface. Valid values are from 1 to 65535.
Command Default None
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCC This command was introduced in Cisco IOS Release 12.2(33)SCC.
Usage Guidelines You can configure up to 32 static upstream bonding groups for each Media Access Control (MAC)
domain. If you delete an upstream bonding group using the no form of the command, the Cisco CMTS
router enforces the bonded upstream service flows associated with the deleted upstream bonding group
to readmit.
Under the upstream bonding configuration submode, you can specify the following for an upstream
bonding group:
• Upstream channels
• Bandwidth reservation
• Provisioned attribute masks
Examples The following example shows how to configure an upstream bonding group on a cable interface in slot 7,
subslot 1, and port 0 on a Cisco uBR10012 router:
Router# configure terminal
Router(config)# interface cable 7/1/0
Router(config-if)# cable upstream bonding-group 235
Related Commands Command Description
upstream cable Specifies the upstream channel ports for a fiber node.
connector
cable fiber-node Creates a fiber node and enters cable fiber-node configuration mode.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-603
Cable Commands: cable u through cable w
cable upstream channel-width
cable upstream channel-width
To specify an upstream channel width for an upstream port, use the cable upstream channel-width
command in cable interface configuration mode. To set the channel width back to the default setting of
1,600,000 Hz, use the no form of this command.
cable upstream n channel-width first-choice-width [last-choice-width]
no cable upstream n channel-width
Syntax Description n Specifies the upstream port number. Valid values start with 0 for the
first upstream port on the cable interface line card.
first-choice-width Specifies the upstream channel width in hertz (Hz). Valid values for all
cards are displayed in Table 18.
last-choice-width (Cisco uBR-MC16U/X, Cisco uBR-MC28U/X, and
Cisco uBR-MC5X20S/U/H only)
The upstream channel width in hertz. The valid values are the same as
those for the first-choice-width parameter, but for proper operation, the
last-choice-width should be equal to or less than the first-choice-width
value. Use this parameter with supported cards to enable symbol rate
management algorithms.
Command Default The first-choice-width value and the last-choice-width value default to 1,600,000 Hz. When an upstream
channel is configured to operate in DOCSIS 2.0 A-TDMA or DOCSIS 3.0 S-CDMA-mode, only three
channel width options (1.6 Mhz, 3.2 Mhz, and 6.4 Mhz) are available.
Command Modes Interface configuration (config-if)
Command History Release Modification
11.3(5)NA This command was introduced.
12.0(4)XI The last-choice-width argument was added.
12.2(11)CY, Support was added for the Cisco uBR10-MC5X20S cable interface line card
12.2(11)BC3 on the Cisco uBR10012 router.
12.2(15)CX Support was added for the Cisco uBR-MC16U/X and Cisco uBR-MC28U/X
cable interface line card, including DOCSIS 2.0 A-TDMA and mixed
modulation profiles using 6.4 MHz channel widths.
12.2(15)BC2 Support was added for DOCSIS 2.0 A-TDMA and mixed modulation profiles
using 6.4 MHz channel widths on the Cisco uBR-MC5X20S/U cable
interface line cards.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
12.2(33)SCC Support was added for Cisco UBR10-MC20X20V cable interface line card.
Cisco IOS CMTS Cable Command Reference
CBL-604 OL-15510-15
Cable Commands: cable u through cable w
cable upstream channel-width
Usage Guidelines The last-choice-width parameter is supported only by the Cisco uBR-MC16S, Cisco uBR-MC16U/X,
Cisco uBR-MC28U/X, and Cisco uBR-MC5X20S/U cable interface line cards. When one of these
particular cards is installed, the system attempts to increase the channel width from the smallest channel
width value to the largest channel width value.
When you specify both channel width values, the smaller value is taken as the last-choice-width
parameter and the larger value is taken as the first-choice-width parameter. In the event of noise in the
channel, the symbol rate automatically steps down to a value that is lower than the first-choice-width
and greater or equal to the last-choice-width to maintain a stable channel.
Table 18 Supported Channel Widths and DOCSIS Modes for Cable Interfaces
Mixed
Channel DOCSIS 1.X DOCSIS DOCSIS 2.0 DOCSIS 2.0 DOCSIS 3.0
Cable Interface Width (TDMA) 1.X/2.0 (A-TDMA) (S-CDMA) (S-CDMA)
Cisco uBR-MC16U/X1, 6.4 MHz 41 to 50 141 to 150 241 to 250 N/A N/A
Cisco uBR-MC28U/X 3.2 MHz (default is 41) (default is (default is
1.6 MHz 141) 241)
800 kHz
400 kHz
200 kHz
Cisco uBR-MC5X20S/U/H 6.4 MHz 21 to 30 121 to 130 221 to 230 N/A N/A
3.2 MHz (default is 21) (default is (default is
1.6 MHz 121) 221)
800 kHz
400 kHz
200 kHz
Cisco uBR-MC20X202 6.4 MHz 21 to 30 121 to 130 221 to 230 321 to 330 1 to 400
3.2 MHz (default is 21) (default is (default is (default is (default is
1.6 MHz 121) 221) 321) 381)
800 kHz
400 kHz
200 kHz
1. Supports 6,400,000 Hz (5,120,000) symbols/sec) while operating in the DOCSIS 2.0 (A-TDMA-only) mode.
2. The DOCSIS 3.0 S-CDMA modulation profiles do not support 200 kHz, 400 kHz, and 800 kHz channel widths.
Note The UBR-MC20X20V cable interface line card has three variants, UBR-MC20X20V-0D,
UBR-MC20X20V-5D, and UBR-MC20X20V-20D. The UBR-MC20X20V-0D line card supports 20
upstreams and zero (no) downstreams. The UBR-MC20X20V-5D line card supports 20 upstreams and
five downstreams, and the UBR-MC20X20V-20D line card supports 20 upstreams and 20 downstreams.
Note In Cisco IOS Release 12.2(15)BC1 and later releases, changing the channel width could force a
frequency hop, if the current frequency does not fit within the new channel width parameters, or if the
system needs to reset the fixed frequency or shared frequency group parameters to match the new
channel width.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-605
Cable Commands: cable u through cable w
cable upstream channel-width
Caution In DOCSIS 1.X networks, do not change the channel width more than one step at a time on an interface
that has cable modems that are currently online. The DOCSIS 1.X specifications require that cable
modems remain online when the channel width is changed in single step increments (such as 800,000 to
1,600,000 Hz), but cable modems can go offline when you change the channel width in larger amounts
(such as changing it from 800,000 to 3,200,000 Hz). To check if the DOCSIS 2.0 cable modems support
changing the channel width by two steps, test each brand of modem before attempting it on a live
network. Also, after changing the channel width, do not change the channel width again until all cable
modems have performed their ranging adjustments for the new width (which could take up to a minute,
depending on the number of cable modems).
Note To specify only one channel width for the Cisco uBR-MC16U/X, Cisco uBR-MC28U/X, or
Cisco uBR-MC5X20S/U/H card, specify the same value for both the first-choice-width and
last-choice-width parameters. For example:
cable upstream 0 channel-width 800000 800000
When using this command to change channel-widths for an upstream interface on the
Cisco uBR-MC5X20S cable interface line card, some DOCSIS 1.1 CMs can go offline if you do not
change the minislot size to the corresponding value. See the following examples for the correct
channel-width and minislot pairings:
Router(config-if)# cable upstream 0 channel-width 3200000
Router(config-if)# cable upstream 0 minislot 4
Router(config-if)# cable upstream 0 channel-width 1600000
Router(config-if)# cable upstream 0 minislot 8
Router(config-if)# cable upstream 0 channel-width 800000
Router(config-if)# cable upstream 0 minislot 16
Router(config-if)# cable upstream 0 channel-width 400000
Router(config-if)# cable upstream 0 minislot 32
Router(config-if)# cable upstream 0 channel-width 200000
Router(config-if)# cable upstream 0 minislot 64
Note This limitation does not affect DOCSIS 1.1-compliant CMs. Also, in Cisco IOS Release 12.2(15)CX,
Cisco IOS Release 12.2(15)BC2, and later releases, there is no need to manually change the minislot size
on the Cisco uBR-MC16U/X, Cisco uBR-MC28C, and Cisco uBR-MC28U/X cards. These cards
automatically change the minislot size when the channel width is changed, to produce 32 symbols per
minislot.
PacketCable Limitations
The 200,000 Hz channel width cannot be used on:
• Upstreams that support PacketCable voice calls
• Upstreams that use Unsolicited Grant Service (UGS) or UGS with Activity Detection (UGS-AD)
service flows.
Using this small channel width with voice and other UGS/UGS-AD service flows results in rejected calls
because of “DSA MULTIPLE ERRORS”.
Cisco IOS CMTS Cable Command Reference
CBL-606 OL-15510-15
Cable Commands: cable u through cable w
cable upstream channel-width
Examples The following example shows the upstream port 2 on a Cisco uBR-MCXXC card being configured with
a channel width of 200,000 Hz (which is equivalent to a symbol rate of 160 kilosymbols/second):
Router(config-if)# cable upstream 2 channel-width 200000
Router(config-if)#
The following example shows the upstream port 2 on a Cisco uBR-MC16U/X, Cisco uBR-MC28U/X,
or Cisco uBR-MC5X20S card being configured with a channel width of 200,000 Hz (which is equivalent
to a symbol rate of 160 kilosymbols/second):
Router(config-if)# cable upstream 2 channel-width 200000 200000
Router(config-if)#
The following example shows the upstream port 3 being configured to step from a channel width of
1,600,000 Hz to a channel width of 3,200,000 Hz in increments of 200,000 Hz:
Router(config-if)# cable upstream 3 channel-width 1600000 3200000
Router(config-if)#
The following example shows an upstream port on a Cisco uBR-MC16U/X, Cisco uBR-MC28U/X, or
Cisco uBR-MC5X20S card being configured with a channel width of 6.4 MHz, which is supported only
in DOCSIS 2.0 A-TDMA-only mode:
Router(config-if)# cable upstream 0 channel-width 6400000
Router(config-if)#
The following example shows an upstream port on a Cisco uBR-MC5X20H card being configured with
a channel width of 6.4 MHz in DOCSIS 3.0 S-CDMA mode:
Router(config-if)# cable upstream 0 channel-width 6400000
Router(config-if)#
Related Commands Command Description
cable upstream hopping blind Disables optimum frequency hopping on the
Cisco uBR-MC16S and Cisco uBR-MC5X20S cable interface
line cards.
cable upstream minislot-size Specifies the minislot size for a specific upstream interface.
cable upstream modulation-profile Overrides modulation types specified in the modulation profile
for the specified upstream channel.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-607
Cable Commands: cable u through cable w
cable upstream codes-per-minislot
cable upstream codes-per-minislot
To specify the number of codes-per-minislot allowed on an upstream channel, use the cable upstream
codes-per-minislot command in cable interface configuration mode. To set the default values to the
codes-per-minislot, which depend on the setting of the cable upstream spreading-interval command,
use the no form of this command.
cable upstream n codes-per-minislot code
no cable upstream n codes-per-minislot
Syntax Description n Specifies the upstream port. Valid values start with 0 for the first
upstream port on the cable interface line card.
code Specifies the number of codes-per-minislot. Valid values range from 2
to 32.
Command Default The codes-per-minislot setting cannot be applied if the Synchronous Code Division Multiple Access
(S-CDMA) is not configured. The default value of codes-per-minislot depends on the setting of the
cable upstream spreading-interval command.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines This command limits the maximum number of codes-per-minislot for a given upstream port. You should
configure S-CDMA to apply the active-code setting.
Examples The following example sets the codes-per-minislot to 8 on the upstream port 0:
Router(config)# interface cable 7/1/0
Router(config-if)# cable upstream 0 codes-per-minislot 8
Router(config-if)#
Related Commands Command Description
cable upstream active-codes Specifies the number of active codes that can be configured on an
upstream channel.
cable upstream Specifies the spreading interval for SCDMA on an upstream channel.
spreading-interval
Cisco IOS CMTS Cable Command Reference
CBL-608 OL-15510-15
Cable Commands: cable u through cable w
cable upstream concatenation
cable upstream concatenation
To enable DOCSIS concatenation at the CMTS, use the cable upstream concatenation command in
cable interface configuration mode. To turn off concatenation, use the no form of this command.
cable upstream n concatenation
no cable upstream n concatenation
Syntax Description n Specifies the upstream port number. Valid values start with 0 for the
first upstream port on the cable interface line card.
Command Default Concatenation is enabled
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.0(7)XR2 This command was introduced.
Usage Guidelines Concatenation is part of DOCSIS 1.0 extension support. Concatenation provides for improved
bandwidth efficiency but must be supported at both the headend CMTS and the CM.
DOCSIS concatenation combines multiple upstream packets into one packet to reduce packet overhead
and overall latency and increase transmission efficiency. Using concatenation, a DOCSIS CM needs to
make only one bandwidth request for a concatenated packet, compared to making bandwidth requests
for each individual packet. This technique is especially effective for bursty real-time traffic such as voice
calls.
Concatenation support improves upstream per CM data throughput. The Cisco CMTS radio frequency
(RF) line card driver can receive only one MAC frame in a data burst. Thus the CM must make explicit
bandwidth requests for every packet it sends upstream. This limits the maximum upstream data
throughput received by the CM due to the inherent request-to-grant round-trip latency of the hybrid
fiber-coaxial (HFC) cable system incurred by every packet. To increase this per-CM upstream
throughput, the Cisco CMTS driver has been enhanced to receive a concatenated burst of multiple MAC
frames from the same CM.
Note Concatenation is not supported on the Cisco uBR-MC11 FPGA and Cisco uBR-MC16B cable interface
line cards.
Examples The following example shows how to enable concatenation for CMs on upstream port 2 on the cable
interface in slot 3/0:
Router(config)# interface c3/0
Router(config-if)# cable upstream 2 concatenation
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-609
Cable Commands: cable u through cable w
cable upstream connector
cable upstream connector
To map a MAC domain upstream port to a physical port on the Cisco cable interface line cards
(Cisco uBR-MC5X20U/H, Cisco uBR-MC20X20V, Cisco uBR-MC88V, Cisco uBR-MC28U, or
Cisco uBR-MC3GX60V), use the cable upstream connector command in cable interface configuration
mode. To remove the mapping, use the no form of this command.
cable upstream port connector physical-port shared
no cable upstream port connector physical-port shared
Syntax Description port Index of the MAC domain upstream. The index range is configured with the
cable upstream max-ports n command, and the valid range is 0 to n-1.
physical-port Index of the actual physical port to be mapped.
The valid range for Cisco uBR-MC520U/H, Cisco uBR-MC20X20V, and
Cisco uBR-MC3GX60V cable line cards is from 0 to 19.
The valid range for Cisco uBR-MC28U and Cisco uBR-MC88V cable line
cards is from 0 to 7.
shared Indicates that the connector is shared by multiple upstream ports.
Note This option is not valid for Cisco uBR-MC3GX60V cable interface
lin ecard on Cisco IOS Release 12.2(33)SCE and later releases. A
connector becomes shared automatically when multiple upstream
ports are mapped to it.
Command Default By default, each MAC domain has four upstream ports allocated. For all the currently supported cable
line cards—Cisco uBR-MC5X20U/H, Cisco uBR-MC20X20V, Cisco uBR-MC88V,
Cisco uBR-MC28U, and Cisco uBR-MC3GX60V the default mapping is four upstream for each MAC
domain.
For the Cisco uBR-MC5X20U/H and Cisco uBR-MC28U cable line cards, each MAC domain has one
downstream and four upstreams. For the other cards, each MAC domain can have multiple downstreams.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(15)BC1 This command was introduced to support the Cisco uBR-MC5X20S
cable interface line card.
12.2(15)BC2 Support was added for the Cisco uBR-MC5X20U card. Also, the
entAliasMappingTable in the ENTITY-MIB was updated to show the
mapping between the physical upstream connectors and the logical
upstream connectors.
12.2(33)SCE Support for the shared keyword was removed.
Cisco IOS CMTS Cable Command Reference
CBL-610 OL-15510-15
Cable Commands: cable u through cable w
cable upstream connector
Usage Guidelines The cable upstream connector command maps a MAC domain upstream port to a particular physical
RF port on the cable line card front panel. For all cable line cards except the Cisco uBR-MC3GX60V,
the default mapping assigns one upstream port to one physical port. The default mapping of
Cisco uBR-MC3GX60V cable line card assigns four upstream ports to one physical port. The physical
ports are mapped sequentially in the order in which they appear on the front panel.
The no version of this command removes the upstream port mapping and shuts down the upstream port.
The port must be remapped to another physical port before it can come online again.
Tip Use the cable upstream max-ports command to set the maximum number of upstream ports per MAC
domain before using the cable upstream connector command.
Table 19 and Table 20 show the default port mapping.
Table 19 Default Upstream Port Assignments for the Cisco uBR-MC5X20U/H Cable Interface Line Card
Physical Ports (upstream, as labeled on the card)
Physical Upstream Ports 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
MAC Domain 0 Upstream 0 1 2 3
MAC Domain 1 Upstream 0 1 2 3
MAC Domain 2 Upstream 0 1 2 3
MAC Domain 3 Upstream 0 1 2 3
MAC Domain 4 Upstream 0 1 2 3
Table 20 Default Upstream Port Assignments for the Cisco uBR-MC3GX60V Cable Interface Line Card
Physical Ports (upstream, as labeled on the card)
Physical Upstream Ports 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
MAC Domain 0 Upstream 0-3
MAC Domain 1 Upstream 0-3
MAC Domain 2 Upstream 0-3
MAC Domain 3 Upstream 0-3
MAC Domain 4 Upstream 0-3
MAC Domain 5 Upstream 0-3
MAC Domain 6 Upstream 0-3
MAC Domain 7 Upstream 0-3
MAC Domain 8 Upstream 0-3
MAC Domain 9 Upstream 0-3
MAC Domain 10 Upstream 0-3
MAC Domain 11 Upstream 0-3
MAC Domain 12 Upstream 0-3
MAC Domain 13 Upstream 0-3
MAC Domain 14 Upstream 0-3
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-611
Cable Commands: cable u through cable w
cable upstream connector
Each MAC domain can have up to 8 upstream ports. Each upstream port can be mapped to a physical
port.
Examples The following example shows how to configure a MAC domain with 8 upstream ports:
Router# configure terminal
Router(config)# interface cable 8/1/0
Router(config-if)# cable upstream max-ports 8
Router(config-if)# cable upstream 0 connector 16
Router(config-if)# cable upstream 1 connector 17
Router(config-if)# cable upstream 2 connector 18
Router(config-if)# cable upstream 3 connector 12
Router(config-if)# cable upstream 4 connector 13
Router(config-if)# cable upstream 5 connector 14
Router(config-if)# cable upstream 6 connector 15
Router(config-if)# cable upstream 7 connector 11
Router(config-if)# exit
Router(config)# exit
Router#
Note The "WARNING: This upstream will be removed from all the upstream channel bonding groups in the
MAC Domain." warning message is displayed when you configure no cable upstream connector
command.
Note When an upstream is mapped to a physical upstream port (connector), it is also mapped to an internal
upstream PHY receiver. In Cisco uBR-MC5X20U/H, Cisco uBR-MC20X20V, and Cisco uBR-MC88V
cable line cards, each upstream PHY chip has two connectors and two receivers, and can support two
upstreams. The two upstreams can be mapped in four ways:
• Straight mapping:
upstream1 =>connector1 =>receiver1;
upstream2 =>connector2 =>receiver2;
• Share A mapping:
upstream1 =>connector1 =>receiver1;
upstream2 =>connector1 =>receiver2;
• Share B mapping:
upstream1 =>connector2 =>receiver1;
upstream2 =>connector2 =>receiver2;
• Crossed mapping:
upstream1 =>connector2 =>receiver1;
upstream2 =>connector1 =>receiver2;
The card hardware only supports the first three mappings, and does not support crossed mapping. During
normal configuration, certain configuration sequence can cause crossed mapping. When that happens,
the connector command will fail, and the CNNR-NOXC error message is displayed. To fix the cross
mapping, remove all existing upstream connector configurations in these two connectors, and
re-provision them.
Related Commands
Cisco IOS CMTS Cable Command Reference
CBL-612 OL-15510-15
Cable Commands: cable u through cable w
cable upstream connector
Command Description
cable upstream max-ports Configures the maximum number of upstreams on a
downstream (MAC domain) on a Cisco uBR-MC5X20S cable
interface line card.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-613
Cable Commands: cable u through cable w
cable upstream data-backoff
cable upstream data-backoff
To specify automatic or fixed start and stop values for data backoff, use the cable upstream
data-backoff command in cable interface configuration mode. To use the default data backoff values,
use the no form of this command.
cable upstream n data-backoff {automatic | start end}
no cable upstream n data-backoff
Syntax Description n Specifies the upstream port number. Valid values start with 0 for the
first upstream port on the cable interface line card.
automatic Specifies automatic data backoff start and stop values. It enables
dynamic variation in the start and end values.
start Binary exponential algorithm. Sets the start value for data backoff.
Valid values are from 0 to 15. The default value is 3.
end Binary exponential algorithm. Sets the end value for data backoff. Valid
values are from 0 to 15. The default value is 5.
Command Default The default cable upstream data-backoff values are 3 5.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.1 T This command was introduced.
12.1(5)EC1 Support was added for the Cisco uBR7100 series router.
12.2(4)BC1 Support was added for the Cisco uBR10012 router.
Usage Guidelines The DOCSIS-specified method of contention resolution for CMs used to send data or requests on the
upstream channel is a truncated binary exponential backoff with the initial backoff window and the
maximum backoff window controlled by the CMTS. The Cisco CMTS router specifies backoff window
values for both data and initial ranging, and sends these values downstream as part of the Bandwidth
Allocation Map (MAP) MAC message.
The values specified in this command are exponential power-of-two values. For example, a value of 4
indicates a window between 0 and 15; a value of 10 indicates a window between 0 and 1023.
Cisco recommends that you use the automatic settings for data backoff. If you decide to manually
specify the data-backoff values, use the following formula as a guideline for the start and end binary
exponents:
0.33 = (2**stop - 2**start)/n
where n is the number of CMs on the upstream. Choose start and stop values that come closest to the
value of 0.33 (which is the optimal probability to transmit on a contention-based system).
Cisco IOS CMTS Cable Command Reference
CBL-614 OL-15510-15
Cable Commands: cable u through cable w
cable upstream data-backoff
Examples The following example shows how to set the automatic data backoff values for upstream 2 on a cable
interface card:
Router# configure terminal
Router(config)# interface cable 3/0
Router(config-if)# cable upstream 2 data-backoff automatic
Router(config-if)#
Related Commands Command Description
cable insertion-interval Configures the interval between consecutive initial ranging slots on
an upstream.
cable upstream range-backoff Specifies automatic or configured initial ranging backoff
calculation.
show controllers cable Displays the backoff window setting for the configured upstream
port.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-615
Cable Commands: cable u through cable w
cable upstream description
cable upstream description
To assign a label to an upstream, use the cable upstream description command in cable interface
configuration mode. To remove the label from the upstream, use the no form of this command.
cable upstream n description label
no cable upstream n description
Syntax Description n Specifies the upstream port number. Valid values start with 0 for the
first upstream port on the cable interface line card.
label An arbitrary string, up to 80 characters long, that describes this
upstream for management and tracking purposes. If the string contains
any spaces, enclose the string within quotes.
Command Default No description is assigned to upstreams
Command Modes Interface configuration (cable interface only)
Command History Release Modification
11.3 NA This command was introduced.
Usage Guidelines Use the cable upstream description command to assign arbitrary labels to the upstreams on the cable
interfaces. These labels can contain any information that identifies the upstream and that could aid in
network management or troubleshooting.
Tip Use the show interface cable upstream command to display the labels that are assigned to a particular
upstream.
Examples The following example shows how to assign descriptions to the first two upstreams on the cable interface
in slot 3:
Router# configure terminal
Router(config)# interface cable 3/0
Router(config-if)# cable upstream 0 description "SJ-Node1-Upstream 0"
Router(config-if)# cable upstream 1 description "SJ-Node1-Upstream 1 (Unused)"
Router(config-if)#
Related Commands Command Description
show interface cable Displays the current configuration and status of a cable interface.
Cisco IOS CMTS Cable Command Reference
CBL-616 OL-15510-15
Cable Commands: cable u through cable w
cable upstream differential-encoding
cable upstream differential-encoding
To enable differential encoding on upstream traffic to a specified cable interface, use the cable
upstream differential-encoding command in cable interface configuration mode. To disable this
function, use the no form of this command.
cable upstream n differential-encoding
no cable upstream n differential-encoding
Syntax Description n Specifies the upstream port number. Valid values start with 0 for the
first upstream port on the cable interface line card.
Command Default Enabled
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.1 This command was introduced.
Usage Guidelines To verify whether or not upstream differential encoding is activated, enter the show running-config
command and look for the cable interface configuration information. If upstream differential encoding
is enabled, a differential encoding entry is displayed in the output of the show running-config
command. If upstream differential encoding is disabled, no differential encoding entry is displayed in
the output.
If you are having trouble, make sure that the cable connections are not loose or disconnected; the cable
interface line card is firmly seated in its chassis slot; the captive installation screws are tight; you have
entered the correct slot and port numbers; and you selected a valid frequency for your router.
Examples The following example shows how to enable differential encoding for upstream port 2:
Router(config-if)# cable upstream 2 differential-encoding
Router(config-if)#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-617
Cable Commands: cable u through cable w
cable upstream docsis-mode
cable upstream docsis-mode
To configure an upstream to use DOCSIS 1.x, DOCSIS 2.0 or DOCSIS 3.0 modulation profiles, use the
cable upstream docsis-mode command in cable interface configuration mode. To reset the upstream to
its default configuration, use the no form of this command.
cable upstream n docsis-mode {atdma | scdma | scdma-d3 | tdma | tdma-atdma}
no cable upstream n docsis-mode {atdma | scdma | scdma-d3 | tdma | tdma-atdma}
Syntax Description n Specifies the upstream port. Valid values start with 0 for the first
upstream port on the cable interface line card.
atdma Configures the upstream only for DOCSIS 2.0 Advanced Time Division
Multiple Access (A-TDMA) modulation profiles.
scdma Configures the upstream for DOCSIS 2.0 Synchronous Code Division
Multiple Access (S-CDMA) modulation profiles only.
scdma-d3 Configures the upstream for DOCSIS 3.0 S-CDMA modulation
profiles. The scdma-d3 option uses channel type 4SR mode.
tdma Configures the upstream only for DOCSIS 1.0/DOCSIS 1.1 Time
Division Multiple Access (TDMA) modulation profiles (default).
tdma-atdma Configures the upstream for both A-TDMA and TDMA operations
(mixed mode). If you are using abbreviations at the command line, you
must specify at least the tdma to select the mixed mode. If you choose
a shorter abbreviation, you select TDMA-only mode.
Command Default All upstreams are configured ATDMA-only mode.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(15)CX This command was introduced to support DOCSIS 2.0 A-TDMA and mixed
modulation profiles on the Cisco uBR-MC16U/X and Cisco uBR-MC28U/X
cable interface line card on the Cisco uBR7246VXR router.
12.2(15)BC2 Support was added for the Cisco uBR-MC5X20S/U cable interface line
cards on the Cisco uBR10012 router.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
12.2(33)SCC This command was modified with the addition of scdma and scdma-d3
keyword options and support was added for the Cisco UBR-MC20X20V
cable interface line card on the Cisco uBR10012 router.
12.2(33)SCG The command default was changed from TDMA to ATDMA.
Cisco IOS CMTS Cable Command Reference
CBL-618 OL-15510-15
Cable Commands: cable u through cable w
cable upstream docsis-mode
Usage Guidelines The DOCSIS 2.0 specification builds on the existing TDMA to support advanced modulation profiles
that increase potential upstream bandwidth. The A-TDMA profiles support higher QAM rates of up to
64-QAM and wider channel widths of up to 6.4 MHz (5.12 Msymbols).
Note The advanced hardware-based spectrum management features for the Cisco uBR-MC16S/U/X,
Cisco uBR-MC28U/X, and Cisco uBR-MC5X20S/U cards are supported only in the DOCSIS 1.0/1.1
TDMA-only mode. They cannot be used in the mixed or A-TDMA-only modes.
Note Starting with Cisco IOS Release 12.2(33)SCG and later, the default upstream DOCSIS mode is ATDMA
only.
The DOCSIS 2.0 specification allows an upstream to be configured in one of the following three modes:
• A-TDMA only mode—Upstreams only support cable modems that register using A-TDMA
modulation profiles. The CMTS does not allow DOCSIS 1.0 and DOCSIS 1.1 cable modems to
register and come online on these upstreams. The Cisco uBR-MC5X20S/U, Cisco uBR-MC16U/X,
and Cisco uBR-MC28U/X cards also support 6,400,000 Hz (5,120,000 symbols/sec) when
operating in DOCSIS 2.0 (A-TDMA-only) mode.
Changing the DOCSIS mode to A-TDMA only mode automatically changes the symbol rate to
5.12 megasymbols per second and the channel width to 6.4 MHz. It also automatically disables the
dynamic upstream modulation.
In addition, the following are required to support the DOCSIS 2.0 A-TDMA features:
– Cable modems must be DOCSIS 2.0 compliant.
– The DOCSIS configuration file for the cable modem must either omit the DOCSIS 2.0 Enable
field (TLV 39), or it must set TLV 39 to 1 (enable). If you set TLV 39 to 0 (disable), a
DOCSIS 2.0 CM uses the TDMA mode.
– The upstream must be configured for either A-TDMA-only or mixed TDMA/A-TDMA mode.
• TDMA-only mode—Upstreams only support cable modems that register using TDMA modulation
profiles. DOCSIS 2.0 cable modems can register on these upstreams only by using a
DOCSIS 1.0/DOCSIS 1.1 modulation profile (which typically would happen only when a
DOCSIS 2.0 cable modem cannot find an A-TDMA channel in its DOCSIS domain).
Changing the DOCSIS mode to TDMA-only mode automatically changes the symbol rate to 1.28
megasymbols per second and the channel width to 3.2 MHz. It also automatically disables the
dynamic upstream modulation.
• Mixed mode—Upstreams support both DOCSIS 1.0/DOCSIS 1.1 cable modems using TDMA
modulation profiles and DOCSIS 2.0 cable modems using A-TDMA modulation profiles. (The
maximum channel width in mixed mode is 3.2 MHz.)
Changing the DOCSIS mode to mixed mode also automatically changes the symbol rate to
1.28 megasymbols per second and the channel width to 3.2 MHz. Dynamic upstream modulation is
also automatically disabled.
Note Mixed mode upstreams do not support the 6.4 MHz channel width.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-619
Cable Commands: cable u through cable w
cable upstream docsis-mode
The DOCSIS 3.0 specification allows an upstream to be configured in one of the following modes:
• SCDMA-d3 mode—Upstreams only support cable modems that register using DOCSIS 3.0
S-CDMA modulation profiles.
• SCDMA mode—Upstreams only support cable modems that register using DOCSIS 2.0 S-CDMA
modulation profiles.
Note The DOCSIS 3.0 option scdma-d3 (4SR) is available only when the CMTS is configured to operate in
the global modulation profile format and is not available in the default mode. This option is available
only for the Cisco UBR-MC20X20V cable interface line card, and not for other legacy line cards.
Refer to the cable upstream channel-width command for valid values of supported channel widths and
DOCSIS modes for cable interfaces.
Note Changing the DOCSIS Mode for an Upstream Port Forces the Cable Modems on That Upstream to Go
Offline and Reregister
When you switch the DOCSIS mode of an upstream between the TDMA-only and mixed
TDMA/A-TDMA modes, cable modems that are currently online on that upstream are taken offline and
are forced to reregister. This helps the CMTS to determine the capabilities of the cable modems on the
new channels.
If you change an upstream port to A-TDMA only mode, DOCSIS 1.x cable modems will not be able to
come online on that upstream. If you change an upstream to TDMA only mode, DOCSIS 2.0-compliant
cable modems are expected to attempt to come online on another upstream that is configured for
A-TDMA or mixed mode. If no such upstreams are configured, or if the cable modem is configured to
use only that particular upstream, it comes online in the DOCSIS 1.x mode.
Note DOCSIS 2.0-compliant cable modems that are already online on a TDMA-only upstream do not
automatically reregister on another upstream that has been configured for mixed-mode operations. The
cable modem must either be reset or the CMTS must send an Upstream Channel Change (UCC) message
to instruct the cable modem to move to the new channel.
If you change an upstream port to the mixed TDMA/A-TDMA mode, and some cable modems remain
offline, or appear to come online but cannot pass traffic, upgrade the modem software to a
DOCSIS-compliant software version.
Note The cable physical plant must support the higher upstream bandwidths and symbol rates to be able to
use the A-TDMA or mixed mode modulation profiles.
Examples The following example configures the first four upstreams for the first downstream on the
Cisco uBR-MC28U/X cable interface line card in slot 5/0. The first two upstreams are configured for
A-TDMA mode and the last two upstreams are configured for mixed TDMA/A-TDMA mode.
Router# config terminal
Router(config)# interface cable 5/0/0
Router(config-if)# cable upstream 0 docsis-mode atdma
%%Docsis mode set to ATDMA only, 1.x CMs will go offline.
%%The following defaults will be set:
Cisco IOS CMTS Cable Command Reference
CBL-620 OL-15510-15
Cable Commands: cable u through cable w
cable upstream docsis-mode
%%Channel Width 6.4MHz
%%Minislot Size 1 tick
%%Modulation Profile 241
Router(config-if)# cable upstream 1 docsis-mode atdma
%%Docsis mode set to ATDMA only, 1.x CMs will go offline.
%%The following defaults will be set:
%%Channel Width 6.4MHz
%%Minislot Size 1 tick
%%Modulation Profile 241
Router(config-if)# cable upstream 2 docsis-mode tdma-atdma
%%Docsis mode set to DOCSIS2.0 Mixed Mode.
Router(config-if)# cable upstream 3 docsis-mode tdma-atdma
%%Docsis mode set to DOCSIS2.0 Mixed Mode.
Router(config-if)# exit
Router(config)# exit
Router#
The following example shows the abbreviations needed to configure TDMA-only and mixed
TDMA/A-TDMA modes.
Router# config terminal
Router(config)# interface cable 4/0
Router(config-if)# cable upstream 0 docsis-mode tdm
%%Docsis mode set to DOCSIS1.0 TDMA Mode.
Router(config-if)# cable upstream 1 docsis-mode tdma-
%%Docsis mode set to DOCSIS2.0 Mixed Mode.
Router(config-if)#
The following examples configures the SCDMA and SCDMA-d3 modes.
Router# config terminal
Router(config-if)# cable upstream 0 docsis-mode scdma
%interface Cable7/1/0 U0 Docsis mode set to DOCSIS2.0 SCDMA
%modulation profile set to 321
Router(config-if)#
Router# config terminal
Router(config-if)# cable upstream 0 docsis-mode scdma-d3
%interface Cable7/1/0 U0 Docsis mode set to DOCSIS3.0 SCDMA (1.x and 2.0 CMs wi)
%modulation profile set to 381
Router(config-if)#
SLOT 7/1: Jul 10 22:04:24.356: %UBR10000-6-PREAMLENADJUST: initial burst's prea.
SLOT 7/1: Jul 10 22:04:24.356: %UBR10000-6-PREAMLENADJUST: station burst's prea.
Router(config-if)# end
Related Commands Command Description
cable modulation-profile Defines a modulation profile for use on the router.
cable modulation-profile global-scheme Defines a global modulation profile for use on the router.
cable upstream channel-width Specifies an upstream channel width for an upstream port.
cable upstream equalization-coefficient Enables the use of a DOCSIS 1.1 pre-equalization
coefficient on an upstream.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-621
Cable Commands: cable u through cable w
cable upstream docsis-mode
Command Description
cable upstream maintain-psd Requires DOCSIS 2.0 CMs on an A-TDMA-only upstream
to maintain a constant power spectral density after a
modulation rate change.
cable upstream modulation-profile Assigns one or two modulation profiles to an upstream
port.
show cable modulation-profile Displays the modulation profile information for a
Cisco CMTS.
show interface cable mac-scheduler Displays the current time-slot scheduling state and
statistics.
Cisco IOS CMTS Cable Command Reference
CBL-622 OL-15510-15
Cable Commands: cable u through cable w
cable upstream dpon
cable upstream dpon
To enable the DOCSIS Passive Optical Network (DPON) for a MAC domain on the Cisco CMTS router,
use the cable upstream dpon command in interface configuration mode. To disable one or more DPONs
for the MAC domains, use the no form of this command.
cable upstream dpon
no cable upstream dpon
Syntax Description This command has no arguments or keywords.
Command Default D-PON is not enabled.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCE This command was introduced.
Usage Guidelines Configuring D-PON for a MAC domain enables D-PON for all MAC domains on that line card.
However, only a single MAC domain can be used within a D-PON fiber node. This is to ensure proper
scheduling of the upstream and to prevent multiple Optical Network Terminals (ONTs) from
transmitting upstream data at the same time.
You should configure the cable upstream ranging-init-technique 2 command to prevent the use of
additional broadcast initial ranging opportunities for the non-DPON reference upstream channels.
When you shutdown an upstream channel, the D-PON associated with that MAC domain will stop
working. To enable D-PON again, you must manually shut down and enable the MAC domain using the
shutdown and no shutdown command.
Examples The following example shows how to enable D-PON on a Cisco CMTS router:
Router# configure terminal
Router(config)# interface cable 7/0/1
Router(config-if)# cable upstream dpon
Router(config-if)# shutdown
Router(config-if)# no shutdown
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-623
Cable Commands: cable u through cable w
cable upstream dpon
Related Commands Command Description
cable upstream Configures the initial ranging technique for the modem in the MTC-mode.
ranging-init-technique
interface cable Specifies a cable interface.
show interface cable Displays the current time-slot scheduling state and statistics.
mac-scheduler
Cisco IOS CMTS Cable Command Reference
CBL-624 OL-15510-15
Cable Commands: cable u through cable w
cable upstream equalization-coefficient
cable upstream equalization-coefficient
To enable the use of a DOCSIS 1.1 or 2.0 pre-equalization coefficient on an upstream port, use the cable
upstream equalization-coefficient command in cable interface configuration mode. To disable the use
of the pre-equalization coefficient, use the no form of this command.
cable upstream n equalization-coefficient
no cable upstream n equalization-coefficient
Syntax Description n Specifies the upstream port number. Valid range is from 0 to 7 for
upstream ports in the cable interface line card.
Command Default Pre-equalization coefficient is disabled.
Command Modes Interface configuration (cconfig-if)
Command History Release Modification
12.2(4)BC1 This command was introduced.
12.2(15)CX Support was added for the Cisco uBR-MC16U/X and Cisco uBR-MC28U/X
cable interface line card, including DOCSIS 2.0 A-TDMA and mixed
modulation profiles.
12.2(15)BC2 Support was added for DOCSIS 2.0 A-TDMA and mixed modulation profiles
on the Cisco uBR-MC5X20S/U cable interface line cards.
12.3(23)BC6 Support was added for updated default modulation profiles for use with
pre-equalization on the Cisco uBR-MC5X20S/U/H cable interface line cards.
12.2(33)SCB Support was added for updated default modulation profiles for use with
pre-equalization on the Cisco uBR-MC5X20S/U/H cable interface line cards.
Usage Guidelines The DOCSIS 1.1 and 2.0 specifications allow a CMTS to specify a pre-equalization coefficient in the
DOCSIS ranging response (RNG-RSP) MAC management messages it forwards to the cable modems
(CM)s. When this is enabled, a CM can engage in transmit-side equalization (pre-equalization) to
mitigate the effects of certain impairments in the cable plant, such as in-channel tilt, and group delay.
These impairments are more significant with higher order modulation formats such as 64-QAM or
16-QAM, and near the first octave break-point of the diplex filters (34 MHz to 38 MHz). This
break-point exists predominantly as a time-domain group delay issue, and becomes severe for longer
amplifier cascades.
Each amplifier causes the DOCSIS upstream signal to traverse two diplex filters. All diplex filter
frequency splits (5-42 MHz, 5-65 MHz, or 5-88 MHz) share this characteristic, which is not visible in a
frequency response measurement or sweep test.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-625
Cable Commands: cable u through cable w
cable upstream equalization-coefficient
Note For more information about the use of pre-equalization, see the DOCSIS 2.0 RFI specification section
6.2.15, Transmit Pre-Equalizer, and section 8.3.6 Ranging Response (RNG-RSP) MAC Management
Messages.
DOCSIS 1.1 specifies the Type 4 type length value (TLV), and an 8-tap equalizer. DOCSIS 2.0 adds the
Type 9 TLV, and increases the equalizer to support 24 taps to compensate for more complex impairments.
The cable upstream equalization-coefficient command configures the CMTS to send Type 4 TLV or
Type 9 TLVs in the DOCSIS RNG-RSP MAC management messages to the CMs.
The no form of the command disables the CMTS from sending Type 4 TLV or Type 9 TLVs in the
DOCSIS RNG-RSP MAC management messages to the CMs.
After the CMTS stops sending pre-equalization TLVs to the CM, the CM must retain these values until
the modem’s cable interface resets, or a modification is made to the upstream channel descriptor (UCD),
which would make the stored equalization coefficients invalid.
Tip You can reset the cable modem’s interface by:
• Power cycling the cable modem
• Resetting the cable modem from the CMTS using the clear cable modem command
Router# clear cable modem aaaa.bbbb.cccc reset
You can reset the equalizer coefficient of all CMs on an upstream by:
• Changing the upstream center frequency. A 16-kHz or 32-kHz change is sufficient and unlikely to
take many CMs offline.
• Briefly changing the periodic ranging messages in the modulation profile between 16-QAM and
Quadrature Phase Shift Keying (QPSK), or 64-QAM and 16-QAM.
A CMTS operating in a pure DOCSIS 2.0 upstream mode sends equalizer data supporting 24 taps to all
modems during initial ranging.
The cable up 0 docsis-mode atdma command configures a DOCSIS 2.0-only upstream mode on the
CMTS.
A CMTS operating in a DOCSIS 1.1 or mixed TDMA-ATDMA upstream mode sends equalizer data
supporting 8 taps to all modems during initial ranging. The CMTS cannot send data supporting 24 taps
until it is notified by the CM, that it is DOCSIS 2.0 compliant in the Registration Request (REG-REQ)
message, immediately preceding the online state.
This can be configured on the CMTS using the cable up 0 docsis-mode tdma-atdma command.
When a CM receives a Type 4 TLV in the RNG-RSP MAC management message from the CMTS, it must
combine the previously stored values with the new values from the CMTS. Under certain HFC plant
conditions, a dynamic impairment occurs that require the CM to adjust its main equalizer tap. The
DOCSIS standard specifies a convolution function that is sometimes unable to adjust for dynamic
impairments. The result, is a CM whose signal-to-noise ratio (SNR) value as received by the CMTS, is
quite low compared to other CMs on the same upstream.
Cisco IOS CMTS Cable Command Reference
CBL-626 OL-15510-15
Cable Commands: cable u through cable w
cable upstream equalization-coefficient
In a mixed modulation profile, where station maintenance is of a lower order modulation format than the
data grants, it is possible for the modem to enter a steady state where the SNR estimate is:
• Below the required estimate for data grants to be processed by the CMTS
• Above the requirement for station maintenance
This results in a modem that responds to DOCSIS Layer 2 pings, but not to Layer 3 traffic. The following
commands can be used to check status:
• ping docsis {cm-mac address | cm ip address}—succeeds
• ping ip {cm IP address | CPE IP address}—fails
A cable modem whose SNR estimate is in this condition may enter the expired(pt) state when baseline
privacy interface plus (BPI+) is enabled. A modulation profile where station maintenance and data grants
are of the same order modulation, prevents this condition.
The CMTS may be configured to enable cable upstream pre-equalization on a per upstream port basis,
and may be configured to disable the sending of upstream equalization-coefficients on a per modem
MAC address or Organizational Unique Identifier (OUI) basis, using the related global exclude
commands.
Note Some DOCSIS 2.0 compliant CMs / embedded media terminal adapters (EMTA)s have been known to
report as DOCSIS 1.1 compliant to the CMTS, unless connected to a DOCSIS 2.0 format upstream.
These CMs are treated by the CMTS as DOCSIS 1.1, and only send 8-tap equalizer coefficients. A
firmware or SNMP set may be used on these cable modems to enable the proper reporting of DOCSIS
2.0 compliance under a DOCSIS 1.1-style upstream (for example, 3.2 MHz, 16-QAM, TDMA format).
Some older DOCSIS cable modem firmware versions will incorrectly process the transition from 8 to 24
taps when in a mixed TDMA-ATDMA mode, and will experience degrading or low SNR MER as
displayed with show cable modem phy command. Upgrade the CM firmware, and temporarily move
these modems to a pure DOCSIS 1.1 or 2.0 channel or disable pre-equalization for these devices with
the exclude command.
Examples The example shows how to enable the use of the pre-equalization coefficient on upstream port 0 in the
cable interface line card in slot 5/1 on the Cisco uBR10012 router, while excluding the equalization
coefficient messaging to a modem with MAC address aaaa.bbbb.cccc, and all modems with the OUI of
00aa.bb:
Router# configure terminal
Router# cable pre-equalization exclude aaaa.bbbb.cccc
Router# cable pre-equalization exclude 00aa.bb
Router(config)# interface cable 5/1/0
Router(config-if)# cable upstream 0 equalization-coefficient
Router(config-if)#
Related Commands Command Description
show cable modem phy Displays the physical layer RF parameters of the cable modem,
including USSNR estimate (MER).
show cable modem docsis version Displays the DOCSIS version of a cable modem, and the
upstream DOCSIS mode— TDMA or ATDMA.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-627
Cable Commands: cable u through cable w
cable upstream equalization-coefficient
Command Description
show cable modem [verbose] Displays detailed information about the cable modem. Lines
with the string Equalizer describe modem specific equalizer
data.
debug cable range Debugging commands to display the equalizer coefficients being
sent by the CMTS to the cable modem in the DOCSIS RNG-RSP
MAC management messages.
debug cable interface {interface} Debugging commands to display the equalizer coefficients being
{cm-mac-address}[verbose] sent by the CMTS to the cable modem in the DOCSIS RNG-RSP
MAC management messages.
Caution Certain debug settings can produce a very large
amount of data on a production router, and should be
used with caution. Specifying the CM mac-address
will dramatically reduce the amount of data produced.
Cisco IOS CMTS Cable Command Reference
CBL-628 OL-15510-15
Cable Commands: cable u through cable w
cable upstream equalization-error-recovery
cable upstream equalization-error-recovery
To enable the pre-equalizer direct load mechanism on an upstream port, use the cable upstream
equalization-error-recovery command in cable interface configuration mode.
cable upstream port number equalization-error-recovery
no cable upstream port number equalization-error-recovery
Syntax Description port number Specifies an upstream port number on a cable interface. Valid range is 0 to 7.
Command Default This command is enabled by default.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.3(23)BC7 This command was introduced.
12.2(33)SCB4 This command was integrated into Cisco IOS Release 12.2(33)SCB4.
Usage Guidelines The pre-equalizer direct load mechanism is enabled by default. However, to use this direct load
mechanism, you must enable the pre-equalization coefficient on an upstream port using the cable
upstream equalization-coefficient command.
The cable upstream equalization-error-recovery command enables the CMTS to send
Type-Length-Value (TLV) Type 9 in the DOCSIS RNG-RSP MAC management messages. This
mechanism helps CMs come online when TLV Type 4 convolved method causes CMs to go offline.
Note The TLV Type 9, called pre-equalizer direct load, supports only the DOCSIS 2.0 or 3.0-certified
modems. When a CM receives TLV Type 9, the CM replaces its data with the new data provided in the
DOCSIS RNG-RSP MAC management messages.
Examples The example shows how to enable the pre-equalizer direct load mechanism on a cable interface line card
in slot 8/0 on the Cisco uBR10012 router.
Router# configure terminal
Router(config)# interface cable 8/0/0
Router(config-if)# cable upstream 0 equalization-error-recovery
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-629
Cable Commands: cable u through cable w
cable upstream equalization-error-recovery
Related Commands Command Description
show cable modem Displays information for the registered and unregistered CMs.
cable upstream Enables the use of a DOCSIS 1.1 or 2.0 pre-equalization
equalization-coefficient coefficient on an upstream port.
show cable modem calls Displays displays voice call information for a particular CM,
identified either by its IP address or MAC address.
Cisco IOS CMTS Cable Command Reference
CBL-630 OL-15510-15
Cable Commands: cable u through cable w
cable upstream ext-power
cable upstream ext-power
To enable the DOCSIS extended transmit power support on the Cisco CMTS, use the cable upstream
ext-power command in interface configuration mode. To disable DOCSIS extended transmit power
support, use the no form of this command.
cable upstream ext-power
no cable upstream ext-power
Syntax Description This command has no arguments or keywords.
Command Default DOCSIS extended transmit power support is enabled.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCF2 This command was introduced.
Examples The following example shows how to enable DOCSIS extended transmit power support on the Cisco
CMTS:
Router# configure terminal
Router(config)# interface cable 7/0/0
Router(config-if)# cable upstream ext-power
Router(config-if)# end
Associated Features The cable upstream ext-power command is used to configure the following feature:
• Upstream Channel Bonding
Related Commands Command Description
show cable modem Displays the list of cable modems that are transmitting at an extended power
extended-power level.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-631
Cable Commands: cable u through cable w
cable upstream fec
cable upstream fec
To enable upstream forward error correction (FEC), use the cable upstream fec command in cable
interface configuration mode. To disable FEC, use the no form of this command.
cable upstream n fec
no cable upstream n fec
Syntax Description n Specifies the upstream port number. Valid values start with 0 for the first
upstream port on the cable interface line card.
Command Default Enabled
Command Modes Interface configuration (cable interface only)
Command History Release Modification
11.3 XA This command was introduced.
Usage Guidelines The Cisco CMTS uses FEC to attempt to correct any upstream data that might have been corrupted. To
use this feature, you need to activate FEC on the upstream RF carrier. When FEC is activated, the
Cisco CMTS commands all CMs on the network to activate FEC.
Examples The following example shows how to activate upstream forward error correction:
Router (config-if)# cable upstream 0 fec
Related Commands Command Description
cable upstream frequency Enters a fixed frequency of the upstream RF carrier for an
upstream port.
cable upstream power-level Sets the input power level for the upstream RF carrier in decibels
per millivolt (dBmV).
cable upstream scrambler Enables the cable upstream scrambler.
cable upstream shutdown Disables the upstream port.
Cisco IOS CMTS Cable Command Reference
CBL-632 OL-15510-15
Cable Commands: cable u through cable w
cable upstream fec-strength
cable upstream fec-strength
To override the forward error correction (FEC) setting specified in the modulation profile for this
upstream channel, use the cable upstream fec-strength command in cable interface configuration
mode. To restore the default value, use the no form of this command.
cable upstream n fec-strength t-bytes
no cable upstream n fec-strength
Syntax Description n Specifies the upstream port number. Valid values start with 0 for the
first upstream port on the cable interface line card.
t-bytes Overrides the FEC strength specified in the modulation profile for this
upstream channel. Valid values are from 0 to 10, where:
• 0 disables FEC.
• 1 is the lowest FEC strength.
• 10 is the highest FEC strength.
Command Default No default behavior or values
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.0(4)XI This command was introduced.
12.1T This command was deprecated and removed.
Examples The following example shows how to configure the cable upstream fec-strength command:
Router(config-if)# cable upstream 2 fec-strength 3
Related Commands Command Description
cable upstream channel-width Specifies an upstream channel width for a headend cable router.
cable upstream fec Enables the upstream FEC.
cable upstream hopping blind Disables optimum frequency hopping on the
Cisco uBR-MC16S and Cisco uBR-MC5X20S/U cable
interface line cards.
cable upstream modulation-profile Overrides modulation types specified in the modulation profile
for the specified upstream channel.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-633
Cable Commands: cable u through cable w
cable upstream fragmentation
cable upstream fragmentation
To enable fragmentation of DOCSIS frames on a particular upstream, use the cable upstream
fragmentation command in cable interface configuration mode. To disable fragmentation, use the no
form of this command.
cable upstream n fragmentation
no cable upstream n fragmentation
Syntax Description n Specifies the upstream port number. Valid values start with 0 for the first
upstream port on the cable interface line card.
Command Default By default, fragmentation is enabled for all upstream ports on ASIC line cards (Cisco uBR-MC11C,
Cisco uBR-MC12C, Cisco uBR-MC14C, Cisco uBR-MC16C, Cisco uBR-MC16S, and
Cisco uBR-MC28C) and disabled for all upstream ports on old FPGA line cards.
Note Cisco IOS Release 12.1 CX supports the Multiple Grant Mode of DOCSIS 1.1 fragmentation.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.1(4)CX This command was introduced.
12.2(4)BC1 Support for this command was added to the Release 12.2 BC train.
Usage Guidelines This command enables and disables DOCSIS layer 2 fragmentation, which reduces run-time jitter
experienced by constant bit rate (CBR) slots on the corresponding upstream. Disabling fragmentation
increases the run-time jitter, but also reduces the fragmentation reassembly overhead for fragmented
MAC frames. For ports running CBR traffic, fragmentation should be enabled (the default).
Note Do not confuse DOCSIS Layer 2 fragmentation with IP Layer 3 fragmentation.
Examples The following command shows DOCSIS fragmentation being enabled on upstream 0 on the cable
interface in slot 2/0:
Router# configure terminal
Router(config)# interface c2/0
Router(config-if)# cable upstream 0 fragmentation
Router(config-if)#
Cisco IOS CMTS Cable Command Reference
CBL-634 OL-15510-15
Cable Commands: cable u through cable w
cable upstream fragmentation
Related Commands Command Description
cable default-phy-burst Specifies a value for the upstream Maximum Traffic Burst
parameter for CMs that do not specify their own value.
cable upstream fragment-force Specifies that a cable interface line card should fragment DOCSIS
frames on an upstream when the frame exceeds a particular size.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-635
Cable Commands: cable u through cable w
cable upstream fragment-force
cable upstream fragment-force
To specify that a cable interface line card should fragment DOCSIS frames on an upstream when the
frame exceeds a particular size, use the cable upstream fragment-force command in cable interface
configuration mode. To disable the forcing of fragmentation, use the no form of this command.
cable upstream n fragment-force [fragment-threshold [number-of-fragments] ]
no cable upstream n fragment-force
Syntax Description n Specifies the upstream port number. Valid values start with 0 for the first
upstream port on the cable interface line card.
fragment-threshold (Optional) Number of bytes for the threshold at which DOCSIS frames are
fragmented. The valid value ranges from 1,500 to 3,500 bytes, with the
default value of 2,000 bytes.
For Cisco uBR10-MC5X20S cable interface line card running Cisco IOS
Release 12.3(23)BC1, the valid value ranges from 0 to 1,987 bytes, with the
default value of 1,600 bytes.
number-of-fragments (Optional) Number of fragments that the cable interface line card should
create when fragmenting DOCSIS frames. The card attempts to create this
many equal-sized fragments when fragmenting. The valid value ranges from
1 to 10 fragments, with the default value of 3 fragments.
The number-of-fragments option has been deprecated. See Usage Guidelines
section for more details.
Command Default Fragmentation is enabled.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(15)BC2 This command was introduced.
12.3(21a)BC This command was modified and the number-of-fragments option has been
deprecated.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.2(33)SCB.
Usage Guidelines DOCSIS 1.1 allows the CMTS to fragment DOCSIS frames to improve performance, especially in
networks that combine real-time traffic, such as voice, with data traffic. The cable upstream
fragment-force command allows you to specify the size of frames that should be fragmented, as well as
the number of fragments that should be created when fragmenting.
Cisco IOS CMTS Cable Command Reference
CBL-636 OL-15510-15
Cable Commands: cable u through cable w
cable upstream fragment-force
Tip This command takes effect only when fragmentation has been enabled on the upstream using the cable
upstream fragmentation command (which is the default configuration).
In the default configuration, the Cisco CMTS fragments DOCSIS frames that are 2,000 bytes or larger
in size, and it fragments these frames into equally-sized fragments. Starting from Cisco IOS Release
12.2(21a)BC, 12.2(33)SCB, and later releases, the larger frames are fragmented by the threshold. Instead
of dividing frames into equal number of fragments as before, the concatenated frames are cut into many
fragments, as defined in the threshold size, with the last one being the shortest. For example, the previous
form of the cable upstream fragment-force command fragments a concatenated frame of 9000 into 5
frames of 1800. The new form of the cable upstream fragment-force command fragments a
concatenated frame of 9000 into frames of 2000, 2000, 2000, 2000, and 1000.
Do not use a fragment size greater than 1,600 bytes on the Cisco uBR10-MC5X20S cable interface line
card running Cisco IOS Release 12.3(23)BC1. Do not use a fragment size greater than 2,000 bytes on
the Cisco uBR10-MC5X20U cable interface line card, and do not use a fragment size greater than 3,500
bytes on all other cable interface line cards, unless otherwise instructed by a Cisco TAC engineer.
When using DOCSIS concatenation, you might need to change the cable default-phy-burst command
from its default size, so that multiple frames can be concatenated into a maximum-sized burst. If you set
the cable default-phy-burst command to zero, the max burst then becomes the lowest of 255 mini-slots,
the maximum concatenated burst setting in the DOCSIS configuration file, or the value of the long data
grant burst that is specified in the upstream’s profile.
When you set the cable default-phy-burst command to zero, the CMTS fragments large requests into
big chunks and the cable modems will not be able to register on specific groupings of upstream interfaces
due to the large fragment size. We recommend the use of a fragment size of 2,000 bytes, if you want to
set the cable default-phy-burst command to zero to provide upstream speed of above 5 Mbps.
Caution Ensure that the number-of-fragments parameter is large enough to keep the size of each fragment of a
maximum-sized burst less than the 1,600 bytes or 2,000 bytes or 3,500 bytes specified above. If
fragments are too large, the cable modem might not be able to come online or pass traffic.
Note The number-of-fragments option has been deprecated from Cisco IOS Release 12.2(21a)BC,
12.2(33)SCB, and later releases.
Note Do not confuse DOCSIS Layer 2 fragmentation with IP Layer 3 fragmentation.
Examples The following example shows how to enable DOCSIS fragmentation on frames that are 1,500 bytes or
larger, using four fragments per frame:
Router# configure terminal
Router(config)# interface c2/0
Router(config-if)# cable upstream 0 fragment-force 1500 4
Router(config-if)#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-637
Cable Commands: cable u through cable w
cable upstream fragment-force
The following example shows how to disable the forced fragmentation of DOCSIS frames on an
upstream. This also resets the fragment-threshold parameter to default value.
Router# configure terminal
Router(config)# interface c5/1/0
Router(config-if)# no cable upstream 0 fragment-force
Router(config-if)#
Cisco IOS Release 12.2(21a)BC, 12.2(33)SCB and Later
The following example shows how to enable DOCSIS fragmentation on frames that are 2,000 bytes or
larger:
Router# configure terminal
Router(config)# interface c2/0
Router(config-if)# cable upstream 0 fragment-force 2000
Router(config-if)#
Related Commands Command Description
cable default-phy-burst Specifies a value for the upstream Maximum Traffic Burst parameter
for CMs that do not specify their own value.
cable upstream fragmentation Enables fragmentation of DOCSIS frames on a particular upstream.
Cisco IOS CMTS Cable Command Reference
CBL-638 OL-15510-15
Cable Commands: cable u through cable w
cable upstream freq-adj averaging
cable upstream freq-adj averaging
To specify the percentage of frequency adjustment packets that is required to change the adjustment
method from the regular power-adjustment method to the noise power-adjustment method, use
the cable upstream freq-adj averaging command in cable interface configuration mode. To
disable power adjustments, use the no form of this command.
cable upstream n freq-adj averaging % of frequency adjustment
no cable upstream n freq-adj averaging
Syntax Description n Specifies the upstream port number. Valid values start with 0 for the
first upstream port on the cable interface line card.
% of frequency adjustment Specifies the percentage of frequency-adjustment packets required to
switch from the regular power-adjustment method to the noise
power-adjustment method. Valid range is from 10 to 100 percent.
Command Default No default behavior or values
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.0(7)T This command was introduced.
Examples The following example shows how to change the power-adjustment method when the
frequency-adjustment packet count reaches 50 percent:
Router(config-if)# cable upstream 0 freq-adj averaging 50
Related Commands Command Description
cable upstream power-adjust Controls power-adjustment methods on the Cisco CMTS.
show cable flap-list Displays a list of CMs that have exceeded the threshold number of
power adjustments.
show cable modem Displays CM configuration settings.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-639
Cable Commands: cable u through cable w
cable upstream frequency
cable upstream frequency
To enter a fixed frequency of the upstream radio frequency (RF) carrier for an upstream port, use the
cable upstream frequency command in cable interface configuration mode. To restore the default value
for this command, use the no form of this command.
cable upstream n frequency up-freq-hz
no cable upstream n frequency up-freq-hz
Syntax Description n Specifies the upstream port number on the cable interface line card for
which you want to assign an upstream frequency. Valid values start with 0
for the first upstream port on the cable interface line card.
up-freq-hz The upstream center frequency is configured to a fixed Hertz (Hz) value.
The valid upstream frequency range is 5 MHz (5000000 Hz) to 42 MHz
(42000000 Hz), 55 MHz (55000000 Hz), or 65 MHz (65000000 Hz),
depending on the cable interface line card being used. If you wish to have
the Cisco CMTS dynamically specify a center frequency for the given
upstream interface, do not enter any frequency value.
Command Default Dynamic (not fixed frequency)
Command Modes Interface configuration (cable interface only)
Command History Release Modification
11.3 XA This command was introduced.
12.0(13)SC Support for the higher EuroDOCSIS upstream range (5 to 65 MHz) was
introduced for the Cisco uBR-MC16E cable interface line card.
12.1(4)EC, 12.2(4)BC1 Support for the higher EuroDOCSIS upstream range (5 to 65 MHz) was
introduced for the Cisco uBR7111E and Cisco uBR7114E routers.
12.2(15)BC2 The allowable range of frequencies that you can select with this command is
determined by the configuration of the upstream freq-range command.
Usage Guidelines The upstream channel frequency of your RF output must be set to comply with the expected input
frequency of your cable interface line card. To configure an upstream channel frequency, you may:
• Configure a fixed frequency between the allowable ranges and enable the upstream port,
or
• Create a global spectrum group, assign the interface to it, and enable the upstream port.
The allowable range for the upstream channel frequency depends on the cable interface line card and
Cisco IOS software release being used. See Table 21 for the currently supported values.
Cisco IOS CMTS Cable Command Reference
CBL-640 OL-15510-15
Cable Commands: cable u through cable w
cable upstream frequency
Table 21 Allowable Frequency Range for the cable upstream frequency Command
Frequency Range Supported Cable Interfaces Minimum Cisco IOS Releases
5 to 42 MHz All supported cable interfaces All releases supported for the
Cisco CMTS
5 to 55 MHz Cisco uBR-MC16U/X, Cisco IOS Release 12.2(15)BC2
Cisco uBR-MC28U/X,
Cisco uBR-MC5X20U
5 to 65 MHz Cisco uBR-MC16E, Cisco IOS Release 12.0(13)SC,
Cisco uBR-MC16U/X, 12.1(4)EC, and 12.2(4)BC1
Cisco uBR-MC28U/X,
Cisco uBR-MC5X20U,
Cisco uBR7111E and
Cisco uBR7114E routers
Note In Cisco IOS Release 12.2(15)BC2 and later releases, the allowable range of frequencies that you can
select with the cable upstream frequency command is determined by the configuration of the upstream
freq-range command.
Tip If both a Cisco uBR-MC16E cable interface line card and a Cisco uBR-MC16C and/or a
Cisco uBR-MC16S cable interface line card are present in the chassis, a spectrum group in the 42 MHz
to 65 MHz range should not be assigned.
To configure the default upstream frequency (which is no fixed frequency), enter the cable upstream n
frequency command without specifying a center frequency.
Examples The following example shows how to configure the upstream center frequency for port 0, located in slot
6, to 5,700,000 Hz:
Router(config-if)# cable upstream 0 frequency 5700000
Router(config-if)# exit
Router(config)# exit
Router# show running-config | include frequency
cable upstream 0 frequency 5696000
Router#
Note Cisco cable interface line cards always program the upstream’s center frequency in 16 KHz increments,
and this is the frequency displayed by the lines added to the router’s configuration and by the show
controllers cable upstream command. For example, if you use the cable upstream frequency
command to specify a center frequency of 27 MHz (cable upstream x frequency 27000000), the actual
center frequency will be 27.008 MHz, which is the next highest 16 KHz boundary. The configuration file
will therefore show the line cable upstream 0 frequency 27008000.
The following example shows how to configure the upstream center frequency to a frequency
(54,700,000 Hz) within the extended Japanese frequency range:
Router# configure terminal
Router(config)# upstream freq-range japanese
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-641
Cable Commands: cable u through cable w
cable upstream frequency
Router(config)# interface cable 3/0
Router(config-if)# cable upstream 0 frequency 54000000
Router(config-if)# exit
Router(config)# exit
Router#
The following example shows how to allow the Cisco CMTS to dynamically specify a center frequency
for the upstream port 0:
Router(config-if)# no cable upstream 0 frequency
The following command example from Cisco IOS Release 12.3 BC illustrates the allowable upstream
frequency range in Hz:
Router(config-if)# cable upstream 3 frequency ?
<5000000-55000000> Upstream Frequency in Hz
Related Commands Command Description
cable spectrum-group (global configuration) Creates spectrum groups, which contain one or more
upstream frequencies.
show controllers cable Displays information about the cable interface,
including the upstream center frequency.
upstream freq-range Configures the Cisco CMTS router for the range of
frequencies that are acceptable on upstreams.
Cisco IOS CMTS Cable Command Reference
CBL-642 OL-15510-15
Cable Commands: cable u through cable w
cable upstream hopping blind
cable upstream hopping blind
To override hop decisions, use the cable upstream hopping blind command in cable interface
configuration mode. To stop blind hopping, enter the no form of this command.
cable upstream n hopping blind
no cable upstream n hopping blind
Syntax Description n Specifies the upstream port for which blind frequency hopping will be
activated. Valid values start with 0 for the first upstream port on the
cable interface line card.
Command Default Disabled (hopping is optimized)
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.0(7)XR2 This command was introduced.
Usage Guidelines Enter this command to override the hardware spectrum manager’s decision to optimize hopping.
Note Do not use this command unless you have a specific reason to disable optimum hopping configurations.
For example, if you are experimenting with a Cisco uBR-MC16S or Cisco uBR-MC5X20S/U card, you
can use this command to enforce blind hopping on individual upstream channels.
Examples The following example shows how to specify hopping blind on the upstream port 0:
Router(config-if)# cable upstream 0 hopping blind
Related Commands Command Description
cable monitor Configures preset modulation profiles that you can
apply to one or more upstream cable interfaces when
you identify and configure spectrum groups.
cable spectrum-group (global configuration) Configures spectrum management characteristics for
the given spectrum group.
cable upstream channel-width Specifies the channel width of the given upstream
cable interface.
cable upstream frequency Specifies the center frequency for a given upstream
cable interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-643
Cable Commands: cable u through cable w
cable upstream hopping blind
Command Description
cable upstream power-level Specifies the upstream cable interface receive power
level in dBmV.
cable upstream shutdown Activates or shuts down a specified upstream cable
interface.
Cisco IOS CMTS Cable Command Reference
CBL-644 OL-15510-15
Cable Commands: cable u through cable w
cable upstream hop-priority
cable upstream hop-priority
To configure the priority of the corrective actions to be taken when a frequency hop is necessary due to
ingress noise on the upstream, use the appropriate cable upstream hop-priority command in cable
interface configuration mode.
cable upstream n hop-priority frequency modulation channel-width
cable upstream n hop-priority modulation frequency channel-width
cable upstream n hop-priority frequency channel-width modulation
Syntax Description n Specifies the upstream port. Valid values start with 0 for the
first upstream port on the cable interface line card.
frequency, modulation, channel-width Specifies the priority of corrective actions to be taken when
ingress noise occurs on a downstream.
Note The channel-width option must come after the
frequency option, either immediately or after the
modulation option, as shown in the above
examples.
Command Default The default priority is frequency, modulation, and channel-width.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.1(7)CX1 This command was introduced for Cisco uBR7200 series routers
using the Cisco uBR-MC16S cable interface line card.
12.2(8)BC2 Support was added for the Cisco uBR10012 router and the
Cisco uBR-LCP2-MC16S cable interface line card.
12.2(11)CY, 12.2(11)BC3 Support was added for the Cisco uBR10-MC5X20S cable interface
line card on the Cisco uBR10012 router.
12.2(15)BC2 Support was added for the Cisco uBR10-MC5X20U cable interface
line card on the Cisco uBR10012 router.
Usage Guidelines This command specifies the priority of the corrective actions that should be taken when a frequency hop
is necessary to correct excessive ingress noise on an upstream. For example, if the upstream on a
Cisco uBR-MC16S card is set for the default settings (frequency, modulation, and channel-width), the
following occurs when the upstream noise exceeds the CNR threshold value for the current modulation
profile:
1. The Cisco uBR-MC16S changes to a new frequency, if a clean frequency is available in its spectrum
group.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-645
Cable Commands: cable u through cable w
cable upstream hop-priority
2. If no clean frequency is available, the Cisco uBR-MC16S uses the Dynamic Upstream Modulation
feature to switch the upstream to the secondary modulation profile.
3. If the noise levels still exceed the CNR threshold value for the secondary modulation profile, and if
the upstream has been configured for a range of channel widths, the Cisco uBR-MC16S narrows the
channel width of the upstream by half. If the noise levels are still excessive, the channel width is
again cut in half, and this process continues until a clean upstream is found or the bandwidth is
reduced to the minimum channel width that has been configured using the cable upstream
channel-width command.
Allowable DOCSIS channel widths are 3.2 MHz, 1.6 MHz, 800 KHz, 400 KHz, and 200 KHz. If the
channel width drops to 200 KHz, but the noise still exceeds the SNR threshold, the CMs go offline.
Note The default specifies only a single channel width of 1.6 MHz. If this is not changed to
specify a range of allowable channel widths (using the cable upstream channel-width
command), the Cisco uBR-MC16S does not attempt to change the channel width.
To use the Dynamic Upstream Modulation feature, you must first create two modulation profiles (using
the cable modulation-profile command) and assign them to the upstream (using the cable upstream
modulation-profile command).
Examples The following example shows that when ingress noise on the upstream exceeds the threshold allowed for
the primary modulation profile, the Cisco uBR-MC16S line card should first switch to the secondary
modulation profile, then try frequency hopping, and if that fails to correct problem, to finally try
narrowing the channel width:
Router(config)# interface cable 3/0
Router(config-if)# cable upstream 0 hop-priority modulation frequency channel-width
Router(config-if)# exit
Router(config)#
Related Commands Command Description
cable modulation-profile Creates a cable modulation profile.
cable upstream channel-width Configures an upstream for a range of allowable channel widths.
cable upstream Configures an upstream for one modulation profile (static
modulation-profile profile) or two modulation profiles (Dynamic Upstream
Modulation).
show cable hop Displays the current hop period and threshold for an upstream,
along with other statistics.
show cable modulation-profile Displays the cable modulation profiles that have been created.
Cisco IOS CMTS Cable Command Reference
CBL-646 OL-15510-15
Cable Commands: cable u through cable w
cable upstream ingress-noise-cancellation
cable upstream ingress-noise-cancellation
To configure how often a cable interface line card should train its noise-cancellation circuitry so as to
adjust to noise levels on the upstream, use the cable upstream ingress-noise-cancellation command in
cable interface configuration mode. To disable the ingress noise cancellation feature, use the no form of
this command.
cable upstream n ingress-noise-cancellation interval
no cable upstream n ingress-noise-cancellation
Syntax Description n Upstream port number. Valid values start with 0 for the first upstream port
on the cable interface line card.
interval Triggering interval, in milliseconds. The valid range is 10 to 3000
milliseconds, with a default value of 200 milliseconds.
Command Default The default interval is 200 milliseconds.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(15)CX This command was introduced for the Cisco uBR-MC16U/X and
Cisco uBR-MC28U/X cable interface line cards on the Cisco uBR7246VXR
router.
12.3(17b)BC4 Support was added for the Cisco uBR10-MC5X20H broadband processing
engine on the Cisco uBR10012 router.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
12.2(23)BC10 and later The default interval was changed from 100 milliseconds to 200 milliseconds.
12.2(33)SCB11 and
later
12.2(33)SCC6 and later
12.2(33)SCD6 and later
12.2(33)SCE and later
12.2(33)SCF and later
Usage Guidelines
Note This command is available only on the Cisco uBR10-MC5X20H BPE, Cisco uBR-MC16U/X, and
Cisco uBR-MC28U/X cable interface line cards. It cannot be used on other cable interface line cards.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-647
Cable Commands: cable u through cable w
cable upstream ingress-noise-cancellation
Cable interface line cards, such as the Cisco uBR-MC28U/X cards, contain advanced hardware-based
noise cancellation circuitry that digitally removes in-channel impairments such as ingress, common path
distortion, and certain types of impulse noise. To configure how often these line cards should train their
noise cancellation circuity, so as to adapt to changes in the noise types and levels, use the cable
upstream ingress-noise-cancellation command.
When you enable ingress noise cancellation on an upstream, the Cisco CMTS periodically schedules a
256-symbol idle slot on the upstream channel. The interval option specified in the cable upstream
ingress-noise-cancellation command determines how often this idle slot is generated.
The default for BPE cards is for the card to train its circuitry every 200 milliseconds. The smaller the
triggering interval, the faster the card can adjust to changes in ingress noise, which makes the upstream
more robust to noise problems, but at the cost of decreasing bandwidth on the upstream channel. To
determine the bandwidth cost, in percentage of raw bandwidth, use the following formula:
(256/interval)/channel-symbol-rate
where interval is the time period in milliseconds specified by the cable upstream
ingress-noise-cancellation command, and channel-symbol-rate is the symbol rate in kilohertz. For
example, if the upstream is using a 2.56 MHz channel rate and a noise cancellation interval of 10
milliseconds, the bandwidth cost is 1% of the total raw bandwidth:
(256/10)/2560 = 0.01 (1% of bandwidth)
Broadband Processing Engine Support
The cable upstream ingress-noise-cancellation command is required on the Cisco uBR10-MC5X20H
broadband processing engine (BPE) to enable ingress noise cancellation.
The Cisco uBR10-MCX520S/U BPEs have ingress noise cancellation capability enabled by default, so
no configuration of ingress noise cancellation is available in the Cisco IOS software for these cards.
However, for configuration compatibility in support of high availability among
Cisco uBR10-MC5X20S/U/H cards, the Cisco IOS software will accept configuration of the cable
upstream ingress-noise-cancellation command for these BPEs without generating any warning or error
when synchronizing the configuration.
Examples The following example shows how to configure the first upstream on a Cisco uBR-MC16U/X or
Cisco uBR-MC28U/X card to perform ingress noise cancellation every 300 milliseconds:
interface cable 5/0
cable upstream 0 ingress-noise-cancellation 300
Related Commands cable modulation-profile Defines a modulation profile for use on the router.
cable upstream channel-width Specifies an upstream channel width for an upstream port.
cable upstream docsis-mode Configures an upstream to use either DOCSIS 1.x or DOCSIS
2.0 modulation profiles.
cable upstream frequency Enters a fixed frequency of the upstream RF carrier for an
upstream port.
cable upstream minislot-size Specifies the minislot size (in ticks) for a specific upstream
interface.
cable upstream Assigns one or two modulation profiles to an upstream port.
modulation-profile
Cisco IOS CMTS Cable Command Reference
CBL-648 OL-15510-15
Cable Commands: cable u through cable w
cable upstream ingress-noise-cancellation
cable upstream power-level Sets the input power level for the upstream RF carrier in
decibels per millivolt (dBmV).
show cable hop Displays CM configuration settings.
show cable modulation-profile Displays the modulation profile information for a Cisco CMTS.
show interface cable mac-schedule Displays the current time-slot scheduling state and statistics.
show interface cable sid Displays cable interface information.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-649
Cable Commands: cable u through cable w
cable upstream load-balance group
cable upstream load-balance group
To assign an upstream to a load-balance group, use the cable upstream load-balance group command
in interface configuration mode. To remove an upstream from a load-balance group, use the no form of
this command.
cable upstream uport load-balance group n
no cable upstream uport load-balance group n
Syntax Description uport Specifies the upstream port that should be assigned to the load-balance
group. Upstream port values start with 0 and end with a value that depends
on the number of upstream ports on the cable interface line card.
n Specifies the number of the load-balance group to which the upstream should
be assigned. In Cisco IOS Release 12.2(33)SCE3 and earlier, the valid range
is from 1 to 80. In Cisco IOS Release 12.2(33)SCE4 and later, the valid
range is from 1 to 256.
Command Default An upstream is not assigned to any load-balance groups. If you use the cable load-balance group
(interface configuration) command to assign a downstream interface to a load-balance group, all its
upstreams are automatically assigned to the same group until you use the cable upstream load-balance
group command to reassign an upstream to a different group.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.2(15)BC1 This command was introduced for the Cisco uBR7246VXR and
Cisco uBR10012 routers.
12.2(33)SCE4 The valid range for the load balance group was changed.
Usage Guidelines After you have used the cable load-balance group (global configuration) command to initially create
and configure a load-balance group, use the cable upstream load-balance group command to assign
this load-balance group to an upstream. This enables the cable interface to begin participating in
load-balancing operations.
Tip Use the cable load-balance group (interface configuration) command to assign this load-balance
group to a downstream.
The following rules apply when creating and assigning load-balance groups:
• A downstream or upstream can belong to only one load-balance group.
Cisco IOS CMTS Cable Command Reference
CBL-650 OL-15510-15
Cable Commands: cable u through cable w
cable upstream load-balance group
• All downstreams and upstreams in a load-balance group must share physical radio frequency (RF)
connectivity to the same group of cable modems. Downstreams can be in a separate load-balance
group than upstreams, but all downstreams or all upstreams that have the same RF physical
connectivity must be members of the same load-balance group. You cannot distribute downstreams
or upstreams that share physical connectivity across multiple load-balance groups.
• Load balancing is done only on a per-chassis basis—all interfaces in a load-balance group must be
in the same chassis.
Examples The following example shows how to assign the first four upstreams for cable interface 5/1 to load
balance group 14:
Router# config terminal
Router(config)# interface cable 5/1/0
Router(config-if)# cable upstream 0 load-balance group 14
Router(config-if)# cable upstream 1 load-balance group 14
Router(config-if)# cable upstream 2 load-balance group 14
Router(config-if)# cable upstream 3 load-balance group 14
Router(config-if)#
Associated Features The cable upstream load-balance group command is used to configure the following feature:
Load Balancing and Dynamic Channel Change on the Cisco CMTS Routers
Related Commands Command Description
cable load-balance exclude Excludes a particular cable modem, or all cable
modems from a particular vendor, from one or
more types of load-balancing operations.
cable load-balance group (global configuration) Creates and configures a load-balance group.
cable load-balance group (interface configuration) Assigns a downstream to a load-balance group.
cable load-balance group interval Configures the frequency of the load-balancing
policy updates.
cable load-balance group policy ugs Configures how the Cisco CMTS should load
balance cable modems with active unsolicited
grant service (UGS) service flows.
cable load-balance group threshold Configures the threshold values that a
load-balance group should use for
load-balancing operations.
clear cable load-balance Clears the counters or state machine used to
track load-balancing operations.
show cable load-balance Displays real-time statistical and operational
information for load-balancing operations.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-651
Cable Commands: cable u through cable w
cable upstream maintain-psd
cable upstream maintain-psd
To require DOCSIS 2.0 CMs on an A-TDMA-only upstream to maintain a constant power spectral
density (PSD) after a modulation rate change, use the cable upstream maintain-psd command in cable
interface configuration mode. To return to the default behavior, so that CMs do not need to maintain their
power spectral density, use the no form of this command.
cable upstream uport maintain-psd
no cable upstream uport maintain-psd
Syntax Description uport Specifies the upstream port to be configured. Upstream port values start with
0 and end with a value that depends on the number of upstream ports on the
cable interface line card.
Command Default Cable modems are not required to maintain their power spectral density after a modulation rate change
(no cable upstream maintain-psd)
Note In Cisco IOS Release 12.2(15)BC2 and later releases, this command is automatically removed from the
configuration when you configure an upstream for a TDMA-only or mixed TDMA/A-TDMA
configuration.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.2(15)CX This command was introduced to support DOCSIS 2.0 operations on
the Cisco uBR-MC16U/X and Cisco uBR-MC28U/X cable interface
line card.
12.2(15)BC2 Support was added for DOCSIS 2.0 operations on the
Cisco uBR-MC5X20S/U cable interface line cards.
Usage Guidelines Use this command to specify whether DOCSIS 2.0 CMs should maintain their power spectral density
when the Cisco CMTS changes their upstream modulation rate in an upstream channel descriptor (UCD)
message. When you configure an upstream with the cable upstream maintain-psd command, the
Cisco CMTS sets TLV 15 (Maintain Power Spectral Density) to ON in the UCD messages it sends to the
CMs on that upstream.
When TLV 15 is on, and when the new UCD specifies a new upstream modulation rate for the CM, the
CM must change its transmit power level to keep its power spectral density as close as possible to what
it was before the modulation rate change. The CM must maintain this power spectral density until the
CMTS sends a power adjustment command in a Ranging-Response (RNG-RSP) message.
Cisco IOS CMTS Cable Command Reference
CBL-652 OL-15510-15
Cable Commands: cable u through cable w
cable upstream maintain-psd
The default configuration (no cable upstream maintain-psd) configures TLV 15 to OFF, and CMs are
not required to maintain their power spectral density after a modulation rate change. However, per the
DOCSIS specifications, the CMs continue to maintain constant total input power on the upstream.
Note This command affects only DOCSIS 2.0 CMs that are online an upstream that is configured for the
DOCSIS 2.0 A-TDMA-only mode. This command has no effect on DOCSIS 1.0 and DOCSIS 1.1 CMs,
which will continue to maintain constant total input power on the upstream, per the DOCSIS 1.x
specifications.
Examples The following example shows how to configure four upstreams on a cable interface line card to require
cable modems to maintain a constant power spectral density after a modulation rate change.
Router# configure terminal
Router(config)# interface cable c6/1/0
Router(config-if)# cable upstream 0 maintain-psd
Router(config-if)# cable upstream 1 maintain-psd
Router(config-if)# cable upstream 2 maintain-psd
Router(config-if)# cable upstream 3 maintain-psd
Router(config-if)# exit
Router(config)# exit
Router#
The following example shows how to configure an upstream for the default behavior, which is that CMs
are not required to maintain a constant power spectral density after a modulation rate change, but do
continue to maintain constant total input power levels on the upstream.
Router# configure terminal
Router(config)# interface cable c5/1/0
Router(config-if)# no cable upstream 0 maintain-psd
Router(config-if)# exit
Router(config)# exit
Router#
Related Commands Command Description
cable upstream docsis-mode Configures an upstream to use either DOCSIS 1.x or DOCSIS
2.0 modulation profiles.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-653
Cable Commands: cable u through cable w
cable upstream max-channel-power-off
cable upstream max-channel-power-off
To set the power budget offset value on the Cisco CMTS router for the reduced upstream channel set
assignment, use the cable upstream max-channel-power-off command in cable interface configuration
mode. To disable this configuration, use the no form of this command.
cable upstream max-channel-power-off dB-value
no cable upstream max-channel-power-off dB-value
Syntax Description dB-value Decibel value for the upstream channel transmit power. The valid range is
from 1 to 6 dB. The default value is 3 dB.
Command Default The power budget offset is configured with the default value of 3 dB.
Command Modes Interface configuration (config-if)
Command History Release Modification
Cisco IOS Release 12.2(33)SCE3 This command was introduced.
Usage Guidelines The threshold value specified for the power budget offset (max-channel-power-offset) must be less than
the power threshold value (power-adjust continue) that determines the value of the Ranging Status field
in the Ranging Response (RNG-RSP) messages that the Cisco CMTS router sends to the cable modem.
You can specify the power threshold value using the cable upstream power-adjust command.
Examples The following example shows how to enable the Cisco CMTS router to reduce the channel set
assignment based on the total power budget of the cable modem in Cisco IOS Release 12.2(33)SCE3:
Router# configure terminal
Router(config)# interface cable 7/0/0
Router (config-if)# cable upstream max-channel-power-off 5
Related Commands Command Description
cable tx-power-headroom Specifies the extended transmit power on the
Cisco CMTS router.
show cable modem Displays transmit power values for each assigned upstream
channel along with cable modem details.
Cisco IOS CMTS Cable Command Reference
CBL-654 OL-15510-15
Cable Commands: cable u through cable w
cable upstream max-codes-per-subframe
cable upstream max-codes-per-subframe
To specify the upper limit to override the maximum value of codes-per-subframe defined in the
individual modulation profile setting for an upstream channel, use the cable upstream
max-codes-per-subframe command in cable interface configuration mode. To specify the default value
of 2 to maximum codes-per-subframe, use the no form of this command.
cable upstream n max-codes-per-subframe code
no cable upstream n max-codes-per-subframe
Syntax Description n Specifies the upstream port. Valid values start with 0 for the first
upstream port on the cable interface line card.
code Specifies the number of codes-per-subframe. Valid values range from 1
to 128, with a default value of 2.
Command Default The maximum codes per subframe setting cannot be applied if the Synchronous Code Division Multiple
Access (S-CDMA) is not configured.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines This command is applicable only for S-CDMA channels. You should configure S-CDMA to apply the
the maximum codes-per-subframe setting. The number of codes-per-subframe should not exceed the
number of active codes.
Examples The following example sets the number of codes-per-subframe to 128 on the upstream port 0:
Router(config)# interface cable 7/0/4
Router(config-if)# cable upstream 0 max-codes-per-subframe 128
Router(config-if)#
Related Commands Command Description
cable upstream active-codes Specifies the number of active codes allowed on an upstream
channel.
cable upstream Specifies the number of codes-per-minislot allowed on an upstream
codes-per-minislot channel.
cable upstream Specifies the spreading interval for S-CDMA on an upstream
spreading-interval channel.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-655
Cable Commands: cable u through cable w
cable upstream max-interleave-step
cable upstream max-interleave-step
To specify the upper limit to override the maximum interleave step for each burst defined in the
modulation profile for the upstream channel, use the cable upstream max-interleave-step command in
cable interface configuration mode. To specify the default interleave step size of 1, use the no form of
this command.
cable upstream n max-interleave-step max-interleave-step
no cable upstream n max-interleave-step
Syntax Description n Specifies the upstream port. Valid values start with 0 for the first
upstream port on the cable interface line card.
max-interleave-step Specifies the maximum number of interleave steps. Valid values range
from 1 to 31, with a default value of 1.
Command Default The maximum interleave step setting cannot be applied if the Synchronous Code Division Multiple
Access (S-CDMA) feature is not configured.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines This command is applicable only for S-CDMA channels and the command limits the maximum number
of interleave steps for a given upstream port. The max-interleave-step value should be less than the
spreading-interval value specified using the cable upstream spreading-interval command.
Examples The following example sets the number of interleave steps to 31 on the upstream port 0:
Router(config)# interface cable 7/0/4
Router(config-if)# cable upstream 0 max-interleave-steps 31
Router(config-if)#
Related Commands Command Description
cable upstream active-codes Specifies the number of active codes that can be configured on an
upstream channel.
cable upstream Specifies the number of codes-per-minislot allowed on an upstream
codes-perminislot channel.
Cisco IOS CMTS Cable Command Reference
CBL-656 OL-15510-15
Cable Commands: cable u through cable w
cable upstream max-interleave-step
cable upstream Specifies the upper limit and the maximum value of
max-codes-per-subframe codes-per-subframe defined in the individual modulation profile
setting for an upstream channel.
cable upstream Specifies the spreading interval for SCDMA on an upstream channel.
spreading-interval
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-657
Cable Commands: cable u through cable w
cable upstream max-logical-chans
cable upstream max-logical-chans
To specify the number of logical channels on a physical port, use the cable upstream
max-logical-chans command in cable interface configuration mode. To disable the use of multiple
logical channels, use the no form of this command.
cable upstream n max-logical-chans code
no cable upstream n max-logical-chans
Syntax Description n Specifies the upstream port. Valid values start with 0 for the first
upstream port on the cable interface line card.
code Specifies the number of logical channels per port. Valid values are 1
and 2.
Command Default The maximum logical channels setting cannot be applied if the Synchronous Code Division Multiple
Access (S-CDMA) is not configured.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines The cable upstream max-logical-chans command limits the number of logical channels per port on an
upstream channel. The default value is 1.
When two logical channels are configured through cable upstream max-logical-chans command, both
logical channels are mapped to the same physical port specified and the physical upstream bandwidth is
shared between the two logical channels. However, from the cable modem perspective, each logical
channel appears as an independent upstream channel.
When multiple logical channels are configured, the upstream related commands are categorized into two
groups: physical port level and logical channel level.
Physical Port Level
Physical port level commands use the format of cable upstream n, where n denotes the physical port
number.
Logical Channel Level
Logical channel level commands use the format of cable upstream n m, where n denotes the physical
port number, and m denotes the logical channel index number of 0 or 1.
Note Multiple logical channels and Spectrum groups cannot be configured on the same upstream port.
Cisco IOS CMTS Cable Command Reference
CBL-658 OL-15510-15
Cable Commands: cable u through cable w
cable upstream max-logical-chans
The following commands are supported at the logical channel level:
• cable upstream active-codes
• cable upstream attribute-mask
• cable upstream codes-per-minislot
• cable upstream concatenation
• cable upstream data-backoff
• cable upstream description
• cable upstream differential-encoding
• cable upstream docsis-mode
• cable upstream equalization-coefficient
• cable upstream fec
• cable upstream fragment-force
• cable upstream fragmentation
• cable upstream freq-adjust
• cable upstream max-codes-per-subframe
• cable upstream max-interleave-step
• cable upstream modulation-profile
• cable upstream power-adjust
• cable upstream range-backoff
• cable upstream rate-adapt
• cable upstream rate-limit
• cable upstream scheduling type
• cable upstream scrambler
• cable upstream shutdown
• cable upstream spreading-interval
• cable upstream threshold
• cable upstream unfrag-slot-jitter
Note The above logical channel level commands are not available at the physical port level, when logical
channels are configured. However, the cable upstream shutdown and cable upstream threshold
commands operate both at the physical and at the logical channel level.
The physical upstream port level commands such as cable upstream frequency and cable upstream
channel-width affects all logical channels configured under a physical port.
Examples The following example sets two logical channels on the upstream port 0:
Router(config)# interface cable 7/0/4
Router(config-if)# cable upstream 0 max-logical-chans 2
Router(config-if)#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-659
Cable Commands: cable u through cable w
cable upstream max-logical-chans
Related Commands Command Description
cable upstream Specifies the upstream attribute mask in hexadecimal format.
attribute-mask
cable upstream Specifies the number of codes-per-minislot allowed on an upstream
codes-per-minislot channel.
cable upstream concatenation Enables DOCSIS concatenation at the CMTS.
cable upstream data-backoff Specifies automatic or fixed start and stop values for data backoff.
cable upstream description Assigns arbitrary labels to the upstreams on the cable interfaces.
cable upstream Enables differential encoding on upstream traffic to a specified cable
differential-encoding interface.
cable upstream docsis-mode Configures an upstream to use DOCSIS 1.x or DOCSIS 2.0 or
DOCSIS 3.0 modulation profiles.
cable upstream Enables the use of a DOCSIS 1.x or DOCSIS 2.0 or DOCSIS 3.0
equalization-coefficient pre-equalization coefficient on an upstream port.
cable upstream fec Enables upstream forward error correction.
cable upstream Specifies that a cable interface line card should fragment DOCSIS
fragment-force frames on an upstream when the frame exceeds a particular size.
cable upstream Enables fragmentation of DOCSIS frames on a particular upstream.
fragmentation
cable upstream freq-adjust Specifies the percentage of frequency adjustment packets that is
required to change the adjustment method from the regular
power-adjustment method to the noise power-adjustment method.
cable upstream Specifies the upper limit to override the maximum value of
max-codes-per-subframe codes-per-subframe defined in the individual modulation profile
setting of an upstream channel.
cable upstream Specifies the upper limit to override the maximum interleave step for
max-interleave-step each burst defined in the modulation profile for the upstream
channel.
cable upstream Assigns up to three modulation profiles to an upstream port.
modulation-profile
cable upstream power-adjust Controls power-adjustment methods on the Cisco CMTS.
cable upstream range-backoff Specifies automatic or configured initial ranging backoff calculation.
cable upstream rate-adapt Enables and configures upstream utilization optimization.
cable upstream rate-limit Specifies DOCSIS rate limiting for an upstream port on a cable
interface line card.
cable upstream scheduling Enables various scheduler modes.
type
cable upstream scrambler Enables the cable upstream scrambler.
cable upstream shutdown Disables the upstream port.
cable upstream Specifies the spreading interval for S-CDMA on an upstream
spreading-interval channel.
cable upstream threshold Configures the upstream for the CNR or SNR and FEC threshold
values to be used in determining the allowable noise levels.
cable upstream Specifies how much jitter can be tolerated on the corresponding
unfrag-slot-jitter upstream due to unfragmentable slots.
Cisco IOS CMTS Cable Command Reference
CBL-660 OL-15510-15
Cable Commands: cable u through cable w
cable upstream max-ports
cable upstream max-ports
To configure the maximum number of upstreams on a MAC domain on a cable interface line card, use
the cable upstream max-ports command in cable interface configuration mode. To reset the card to its
default value of 4 upstreams per MAC domain, use the no form of this command.
cable upstream max-ports n
no cable upstream max-ports
Syntax Description n The valid range is 0 to 8, with a default of 4.
Command Default 4
Command Modes Interface configuration (cable interface only)
Command Modes
Release Modification
12.2(15)BC1 This command was introduced to support the Cisco uBR-MC5X20S
cable interface line card.
12.2(15)BC2 Support was added for the Cisco uBR-MC5X20U cable interface line
card.
12.2(33)SCE The minimum number of max-ports supported was changed from 1 to
0.
Usage Guidelines Use this command to specify how many upstreams a MAC domain will support on the cable interface
line card, before using the cable upstream connector command to assign upstreams to physical ports
on the card. The MAC domains on a card can be configured for different maximum upstream values.
After using this command, the valid range for upstreams on that cable interface will be from 0 to one
less than the maximum port value. For example, if you use the cable upstream max-ports 6 command
to specify a maximum of 6 upstreams for the MAC domain, the valid range for upstreams will be 0 to 5.
The total of max-ports on each interface should not be greater than the total number of upstream channels
in the line card. For example, the Cisco uBR-MC3GX60V line card that has a total of 60 upstream
channels can have a maximum of 60 max-ports and the Cisco UBR-MC20X20V line card that has a total
of 20 upstream channels can have a maximum of 20 max-ports.
If the max-port exceeds the number of upstream channels on a line card, the total number of ports that
can be unshut is limited to the actual number of channels available on the line card and the remaining
ports remain as shutdown.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-661
Cable Commands: cable u through cable w
cable upstream max-ports
The cable upstream connector command fails when all the upstream channels are mapped. For
example, with Cisco uBR-MC3GX60V line card, if 60 upstream ports are mapped to connectors, adding
more upstream ports to connectors fail. When you configure a total of 120 ports and unshut the first 60
ports but map the last 60 ports to connectors, none of the ports work because the port is either shutdown
or has no connector mapped to it.
Examples The following example shows how to configure all MAC domains on a Cisco uBR-MC5X20S card for
a maximum number of 6 upstreams.
Router# configure terminal
Router(config)# interface cable c6/1/0
Router(config-if)# cable upstream max-ports 1
Router(config-if)# interface cable c6/1/1
Router(config-if)# cable upstream max-ports 2
Router(config-if)# interface cable c6/1/2
Router(config-if)# cable upstream max-ports 3
Router(config-if)# interface cable c6/1/3
Router(config-if)# cable upstream max-ports 6
Router(config-if)# interface cable c6/1/4
Router(config-if)# cable upstream max-ports 8
Router(config-if)# exit
Router(config)# exit
Router#
Related Commands Command Description
cable upstream connector Maps an upstream port to a physical port on the cable
interface line card for use with a particular downstream.
Cisco IOS CMTS Cable Command Reference
CBL-662 OL-15510-15
Cable Commands: cable u through cable w
cable upstream minislot-size
cable upstream minislot-size
To specify the minislot size (in ticks) for a specific upstream interface, use the cable upstream
minislot-size command in cable interface configuration mode. To reset the minislot size to the default
for the current channel width setting, use the no form of this command.
cable upstream n minislot-size size
no cable upstream n minislot-size
Syntax Description n Specifies the upstream port number. Valid values start with 0 for the
first upstream port on the cable interface line card.
size Specifies the minislot size in time ticks. Valid minislot sizes are:
• 1—(32 symbols at 6.4MHz channel width) Supported by the
Cisco uBR-MC16U/X, Cisco uBR-MC28U/X and
Cisco uBR-MC5X20S/U cable interface line cards when operating
in Advanced TDMA (A-TDMA) DOCSIS 2.0 only mode.
• 2 (32 symbols at at 3.2 MHz channel width)
• 4 (64 symbols at 3.2 MHz channel width)
• 8 (128 symbols at 3.2 MHz channel width)
• 16 (256 symbols at 3.2 MHz channel width)
• 32 (512 symbols at 3.2 MHz channel width)
• 64 (1024 symbols at 3.2 MHz channel width)
• 128 (2048 symbols at 3.2 MHz channel width)
Command Default The default settings vary, depending on the upstream’s channel width. The default values were changed
in Cisco IOS Release 12.2(15)BC1 and later releases to better optimize data and voice traffic on the
upstream. Table 22 on page 664 lists the default minislot values for each channel width for Cisco IOS
releases before and after Cisco IOS Release 12.2(15)BC1.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
11.3(6) NA This command was introduced.
12.2(15)CX Support was added for the Cisco uBR-MC16U/X and Cisco uBR-MC28U/X
cable interface line cards, including support for minislot size of 1 to support
DOCSIS 2.0 A-TDMA and mixed modulation profiles.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-663
Cable Commands: cable u through cable w
cable upstream minislot-size
Release Modification
12.2(15)BC1 The default minislot size was reduced to optimize the upstream for data and
Voice-over-IP (VoIP) traffic. The previous defaults produced 16 bytes per
minislot when using QPSK modulation and a 1.6 MHz channel width, and the
new defaults produce 8 bytes per minislot with the same configuration.
12.2(15)BC2 Support was added for the minislot size of 1 to support DOCSIS 2.0
A-TDMA and mixed modulation profiles on the Cisco uBR-MC5X20S/U
cable interface line cards.
Usage Guidelines The minislot size determines the minimum amount of information that can be transmitted on the
upstream. How much a particular minislot size can contain depends on the modulation profile and
channel width being used, with higher-bandwidth settings allowing larger amounts of data.
Because DOCSIS specifications require that the minislot size contain at least 32 symbols, you might
need to change the minislot size whenever you change the channel width or modulation of an upstream,
to meet the DOCSIS requirements.
Note In Cisco IOS Release 12.2(15)CX, Cisco IOS Release 12.2(15)BC2, and later releases, manually
changing the minislot size is not needed on the Cisco uBR-MC16U/X, Cisco uBR-MC28C, and
Cisco uBR-MC28U/X cards, because these cards automatically change the minislot size when the
channel width is changed, to produce 32 symbols per minislot, as required by the DOCSIS
specifications.
Table 22 lists the default minislot sizes for each channel width for Cisco IOS releases before and after
Cisco IOS Release 12.2(15)BC1.
Table 22 Default Minislot Sizes
Releases Earlier than Cisco IOS Release Cisco IOS Release 12.2(15)BC1 and Later
12.2(15)BC1 (creates 64 symbols and 16 bytes Releases (creates 32 symbols and 8 bytes per
per minislot) minislot)
Default Minislot Size (in Default Minislot Size (in
Channel Width Ticks) Channel Width Ticks)
0.2 MHz 64 0.2 MHz 32
0.4 MHz 32 0.4 MHz 16
0.8 MHz 16 0.8 MHz 8
1.6 MHz 8 1.6 MHz 4
3.2 MHz 4 3.2 MHz 2
6.4 MHz 11
(DOCSIS 2.0 only)
1. You must be using a 6.4 MHz channel width if using a minislot size of 1 tick. Otherwise, you will violate the DOCSIS
requirements that each minislot should contain 32 symbols.
Cisco IOS CMTS Cable Command Reference
CBL-664 OL-15510-15
Cable Commands: cable u through cable w
cable upstream minislot-size
Increasing the Minislot Size for High Bandwidth Users
The DOCSIS specifications allow a maximum burst limit of 255 minislots, which could require
increasing the minislot size from the default values if you are offering service level agreements (SLAs)
that offer guaranteed upstream speeds of 2 Mbps or greater, or if you are allowing maximum
concatenation bursts greater than 2000 bytes. This is because the default minislot sizes might not
accommodate the largest bursts that are possible with these configurations.
The default minislot sizes provide for 8 or 16 bytes per minislot, depending on Cisco IOS release. If the
default setting provides 8 bytes per minislot, then the maximum possible burst is 8 bytes * 255 minislots,
or 2040 total bytes, which might not be sufficient for certain users with high guaranteed upstream speeds.
You should increase the minislot size to accommodate the expected maximum burst transmissions,
adding in approximately 10 percent for overhead.
Caution Using values of 64 or 128 for higher symbol rates such as 1280 kilosymbols/second or
2560 kilosymbols/second can cause performance problems. Depending on your current setting’s symbol
rate, you should select the minislot size (in ticks) that yields a minislot size of 32 or 64 symbols.
Examples The following example shows how to set the minislot size on upstream port 4 to 16:
Router# configure terminal
Router(config)# interface cable 3/0
Router(config-if)# cable upstream 4 minislot-size 16
Router(config-if)# exit
Router(config)# exit
Router#
Related Commands cable modulation-profile Defines a modulation profile for use on the router.
cable upstream channel-width Specifies an upstream channel width for an upstream port.
cable upstream docsis-mode Configures an upstream to use either DOCSIS 1.x or
DOCSIS 2.0 modulation profiles.
cable upstream Enables the use of a DOCSIS 1.1 pre-equalization
equalization-coefficient coefficient on an upstream.
cable upstream modulation-profile Assigns one or two modulation profiles to an upstream
port.
show cable hop Displays CM configuration settings.
show cable modulation-profile Displays the modulation profile information for a
Cisco CMTS.
show interface cable mac-schedule Displays the current time-slot scheduling state and
statistics.
show interface cable sid Displays cable interface information.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-665
Cable Commands: cable u through cable w
cable upstream modulation-profile
cable upstream modulation-profile
To assign up to three modulation profiles to an upstream port, use the cable upstream
modulation-profile command in cable interface configuration mode. To set the upstream modulation
profile to the single default profile based on the DOCSIS-mode setting of the upstream, use the no form
of this command.
cable upstream n modulation-profile primary-profile-number [secondary-profile-number]
[tertiary-profile-number]
no cable upstream n modulation-profile primary-profile-number [secondary-profile-number]
[tertiary-profile-number]
Syntax Description n Specifies the upstream port number. Valid values start with 0 for the
first upstream port on the cable interface line card.
primary-profile number Specifies the number identifying the primary modulation profile for the
upstream port. The primary modulation profile is used when the
upstream is operating with nominal noise conditions. The valid values
depend on the cable interface being used and the mode of operation.
See Table 23 for a list of valid ranges according to cable interface and
modulation type.
secondary-profile-number (Optional) Specifies the secondary modulation profile for the upstream
port, which is used when noise on the upstream increases to the point
that the primary modulation profile can no longer be used. The valid
values are the same ranges as the primary modulation profile.
The secondary modulation profile should specify a more robust
performance profile (in terms of coping with noise) than the primary
profile. The secondary profile is used for both basic and advanced
dynamic modulation.
tertiary-profile-number (Optional) Specifies the tertiary modulation profile for the upstream
port, which is used when noise on the upstream increases to the point
that the secondary modulation profile can no longer be used.
The tertiary modulation profile is only available for the basic dynamic
modulation. You cannot use the tertiary modulation profile when a
spectrum group is defined for the upstream.
Command Default Default modulation profiles are created, using profile numbers 1, 21, 41, 101, 121, 201, 221, 241, 321,
and 381 depending on the DOCSIS mode and the cable interface line cards being used. See Table 23 for
a list of the valid ranges for the individual cable interface cards.
Command Modes Interface configuration (config-if)
Cisco IOS CMTS Cable Command Reference
CBL-666 OL-15510-15
Cable Commands: cable u through cable w
cable upstream modulation-profile
Command History Release Modification
11.3 NA This command was first introduced.
12.0(7)XR2 and 12.1(1a)T1 This command was introduced into the Cisco IOS Release 12.0 and
Release 12.1 trains, replacing the previous version of the cable
upstream modulation-profile command.
12.1(3a)EC1 This command was modified to add the optional
secondary-profile-number parameter to enable the Dynamic Upstream
Modulation feature.
12.1(5)EC This command was introduced for the Cisco uBR7100 series universal
broadband routers.
12.1(7)CX1 This command was enhanced for the Cisco uBR-MC16S line card.
12.2(4)BC1 Support for this command was added for the Cisco IOS
Release 12.2 BC train.
12.2(8)BC2 Support for this command was added for the Cisco uBR-MC16S and
Cisco uBR-LCP2-MC16S line cards.
12.2(11)CY, 12.2(11)BC3 Support was added for the Cisco uBR10-MC5X20S cable interface
line card on the Cisco uBR10012 router.
12.2(15)CX Support was added for the Cisco uBR-MC16U/X and
Cisco uBR-MC28U/X cable interface line card, including DOCSIS
2.0 ATDMA and mixed modulation profiles.
12.2(15)BC2 Support was added for DOCSIS 2.0 ATDMA and mixed modulation
profiles on the Cisco uBR-MC5X20S/U/H cable interface line cards.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
12.3(23)BC7 This command was modified to add the optional
tertiary-profile-number parameter to enable Three Step Dynamic
Upstream Modulation feature.
12.2(33)SCC Support was added for DOCSIS 2.0 S-CDMA and DOCSIS 3.0
S-CDMA modulation profiles using 1.6 MHz, 3.2 MHz, and 6.4 MHz
channel widths on the Cisco UBR-MC20X20V cable interface line
card.
Usage Guidelines The cable upstream modulation-profile command assigns up to three modulation profiles to an
upstream port, depending on the type of cable interface and Cisco IOS software release being used. The
third modulation profile is only available for the basic dynamic modulation and is unavailable when a
spectrum group is defined for the upstream.
Static Modulation Profile (single profile)
The cable upstream modulation-profile command assigns a single modulation profile to an upstream
port on the Cisco uBR7100 series routers and on all cable interface line cards that are available for the
Cisco CMTS routers. This modulation profile affects all CMs and set-top boxes that are using that
upstream port.
Dynamic Upstream Modulation (up to three profiles)
The cable upstream modulation-profile command assigns up to three modulation profiles to an
upstream port to use the Dynamic Upstream Modulation feature. You must assign at least two profiles
to activate the Dynamic Upstream Modulation feature. This feature operates differently, depending on
the Cisco IOS software release and the cable interface line card that is providing the upstream port:
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-667
Cable Commands: cable u through cable w
cable upstream modulation-profile
• The upstream port is on a Cisco uBR7100 series router or on a Cisco uBR-MC28U/X, or
Cisco uBR-MC16U/X line card that is used on Cisco CMTS router running Cisco IOS Release
12.3(23)BC7 or later release.
When using the Dynamic Upstream Modulation feature, the primary modulation profile is the
default profile. The line card monitors the signal-to-noise ratio (SNR) value and forward error
correction (FEC) counters for the upstream, to track the upstream signal quality. For a dual
modulation profile, the line card monitors the SNR value, carrier-to-noise ratio (CNR) value, and
FEC counters to track the upstream signal quality.
When the noise on the upstream exceeds the threshold(s) for the primary profile, the upstream
switches to the secondary profile in a dual modulation profile. Whereas, in a three modulation
profile setup, the upstream can switch from primary profile to the secondary profile or directly to
the tertiary profile based on the SNR, and FEC counter thresholds. Two separate thresholds are used
for switching between the primary profile and the secondary profile and from secondary profile to
the tertiary profile.
When the noise conditions improve (defined as a SNR value that is 3 dB greater than the threshold
value and FEC counters that are below the threshold values), the upstream automatically switches
back to the primary modulation profile. For a Three Step Dynamic Upstream Modulation, the user
can configure the threshold values and FEC counters for the upgrade. However, there is no direct
upgrade from tertiary profile to the primary profile. The upgrade follows a sequential order, from
tertiary profile to secondary profile and then to the primary profile.
For example, in a dual modulation profile, the primary modulation profile could be configured for
16-QAM (or mixed 16-QAM and QPSK) operation and the secondary profile for QPSK operation.
If noise conditions on the upstream threaten to force CMs offline, the upstream switches to the
secondary profile to implement QPSK operation. When the noise ingress conditions are solved, the
upstream switches back to 16-QAM operation.
In a Three Step Dynamic Upstream Modulation, the primary modulation profile could be configured
for 64-QAM operation, the secondary modulation profile for 16-QAM operation (or mixed 64-QAM
and 16-QAM), and the tertiary modulation profile for QPSK. If the noise conditions increase, the
upstream switches to the secondary profile to implement 16-QAM (or mixed profile) operation and
then to the tertiary modulation profile to implement QPSK operation. When the noise ingress
conditions are improved, the upstream switches back to 16-QAM operation (or mixed 64-QAM and
16-QAM), and then to the 64-QAM operation, on further improvement of noise conditions.
Note For more information on this form of the Dynamic Upstream Modulation feature, see the
chapter, Spectrum Management for the Cisco Cable Modem Termination System, in the
Cisco CMTS Feature Guide.
When Dynamic Upstream Modulation is enabled and spectrum groups are configured on the same
interface, the line cards respond to excessive noise by first switching to the secondary modulation
profile. If the noise conditions worsen, the line card changes the modulation or frequency hopping
in an attempt to find a new upstream channel, and if that fails, the line card reduces the channel
width.
Note The default priority of switching modulation profile is frequency (F), modulation (M), and
channel-width (C). However, it is user configurable and can be changed to MFC or FCM.
• The upstream port is on a Cisco uBR-MC16U/X line card that is used on Cisco CMTS routers using
Cisco IOS Release 12.1(7)CX1 or later release, or on a Cisco uBR-MC5X20S/U/H line card.
Cisco IOS CMTS Cable Command Reference
CBL-668 OL-15510-15
Cable Commands: cable u through cable w
cable upstream modulation-profile
The Dynamic Upstream Modulation feature on the Cisco uBR-MC16U/X line card is identical to
other line cards except that the spectrum management hardware onboard the Cisco uBR-MC16U/X
or Cisco uBR-MC5X20S/U/H line card uses the CNR value (you can use only the CNR value for a
dual profile configuration) in conjunction with the SNR value. The CNR value is a more accurate
description of noise conditions on the upstream. Because of this, these line cards switch back to the
primary modulation profile when noise conditions improve to a CNR value that is only 3 dB greater
than the threshold value (assuming FEC counters are also below the threshold values).
Note If the Cisco CMTS router is running Cisco IOS Release 12.1(3a)EC1 or a later Cisco IOS
release, the Dynamic Upstream Modulation feature on the Cisco uBR-MC16U/X line card
operates the same as it does on the other line cards.
When Dynamic Upstream Modulation is enabled and spectrum groups are configured on the same
interface, the line cards take corrective action in response to excessive noise, as determined by the
cable upstream hop-priority command (either frequency hopping or changing to the secondary
modulation profile). If the noise conditions worsen, the line card takes the second corrective action
that has been defined, and if that fails, the line card takes the last corrective action.
Note The Dynamic Upstream Modulation feature uses the SNR, CNR, and FEC thresholds for 64-QAM,
16-QAM, and QPSK operation to determine when to switch modulation profiles. We recommend the use
of 64-QAM, 16-QAM, and QPSK for primary, secondary, and tertiary profiles in a Three Step Dynamic
Upstream Modulation.
For dual profile configuration, we recommend the use of 16-QAM or mixed 16-QAM and QPSK
modulation for primary profile and QPSK modulation for the secondary profile. However, this is
optional. Both modulation profiles can be either QPSK or QAM. It is not mandatory that one is QAM
and the other QPSK, but modulation profile switchover is tied to the QAM and QPSK thresholds.
Tip Modulation profiles must be first created using the cable modulation-profile command before they can
be assigned using the cable upstream modulation-profile command.
Modulation Profile Ranges
The valid range for modulation profiles depends on the cable interface used and the type of modulation
profile created.
Table 23 lists the valid ranges according to cable interface and modulation type.
Table 23 Supported Channel Widths and DOCSIS Modes for Cable Interfaces
Mixed DOCSIS DOCSIS 2.0 DOCSIS 3.0
Cable Interface DOCSIS 1.X (TDMA) 1.X/2.0 (A-TDMA) (S-CDMA)
Cisco uBR-MC16U/X1, 41 to 50 (default is 141 to 150 (default 241 to 250 (default N/A
Cisco uBR-MC28U/X 41) is 141) is 241)
Cisco uBR10-MC5X20S/U/H 21 to 30 (default is 121 to 130 (default 221 to 230 (default N/A
21) is 121) is 221)
Cisco UBR-MC20X20V2 21 to 30 (default is 121 to 130 (default 221 to 230 (default 1 to 400 (default is
21) is 121) is 221) 381)
1. Supports 6,400,000 Hz (5,120,000) symbols/sec) while operating in DOCSIS 2.0 (A-TDMA-only) mode .
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-669
Cable Commands: cable u through cable w
cable upstream modulation-profile
2. The UBR-MC20X20V cable interface line card has three variants, UBR-MC20X20V-0D, UBR-MC20X20V-5D, and UBR-MC20X20V-20D. The
UBR-MC20X20V-0D line card supports 20 upstreams and zero (no) downstreams. The UBR-MC20X20V-5D line card supports 20 upstreams and five
downstreams, and the UBR-MC20X20V-20D line card supports 20 upstreams and 20 downstreams.
In addition to the legacy modulation profile number schemes, the new global modulation profile scheme
introduced in Cisco IOS Release 12.2(33)SCC, allows you to assign any modulation profile number to
any DOCSIS-mode up to 400, without any restrictions.
The global modulation profile mode allows you to create and configure DOCSIS 3.0 channel type 4SR
(scdma-d3). When an upstream's DOCSIS mode is changed into scdma-d3 , it is initially assigned to the
system created default modulation profile as shown in Table 23.
Note Though you can assign any number between 1 to 400 to any modulation profile, the default modulation
profile number assigned to an upstream channel for a given channel type will remain the same. That is,
modulation profile numbers 21, 121, 221, 321, and 381 will be applicable for TDMA, mixed, A-TDMA,
S-CDMA, and DOCSIS 3.0 S-CDMA channel types.
All the existing and previously defined modulation profiles are converted to the new format. However,
all the newly created modulation profiles, which are outside of the legacy number space range, will be
lost when you revert to the legacy modulation profile.
For more details on the new global modulation profile scheme, refer to the cable modulation-profile
global-scheme command.
Examples The following example assigns the primary modulation profile 2, the secondary modulation profile 1,
and the tertiary modulation profile 4 to the upstream port 0 on the cable interface line card in slot 3. This
automatically enables the Dynamic Upstream Modulation feature for all CMs using that upstream.
Router(config)# interface cable 3/0
Router(config-if)# cable upstream 0 modulation-profile 2 1 4
Router(config-if)#
The following example assigns the primary modulation profile 2 and the secondary modulation profile 1,
to the upstream port 0 on the cable interface line card in slot 3. This automatically enables the Dynamic
Upstream Modulation feature for all CMs using that upstream.
Router(config)# interface cable 3/0
Router(config-if)# cable upstream 0 modulation-profile 2 1
Router(config-if)#
Related Commands Command Description
cable modulation-profile Creates a cable modulation profile.
cable modulation-profile Defines a global modulation profile for use on the router.
global-scheme
Cisco IOS CMTS Cable Command Reference
CBL-670 OL-15510-15
Cable Commands: cable u through cable w
cable upstream modulation-profile
Command Description
cable upstream hop-priority Determines the order of the corrective actions to be taken when
ingress noise exceeds the allowable value for an upstream.
This command is related to the cable upstream modulation-profile
command only when using advanced dynamic modulation
configuration, that is, when spectrum group is defined for the
upstream channel.
show cable Displays the cable modulation profiles that have been created.
modulation-profile
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-671
Cable Commands: cable u through cable w
cable upstream power-adjust
cable upstream power-adjust
To control power-adjustment methods on the Cisco CMTS, use the cable upstream power-adjust
command in cable interface configuration mode. To return to the default values, use the no form of this
command.
cable upstream n power-adjust {continue pwr-level | noise perc-pwr-adj | threshold value}
no cable upstream n power-adjust {continue | noise | threshold}
Syntax Description n Specifies the upstream port number. Valid values start with 0 for the
first upstream port on the cable interface line card.
continue pwr-level Specifies the power threshold value that determines the value of the
Ranging Status field in the Ranging Response (RNG-RSP) messages
that the CMTS sends to the CM. The valid range is from 2 to 15 dB,
with a default of 4 dB.
threshold value Specifies the power adjustment threshold. The threshold range is from
0 to 10 dB, with a default of 1 dB.
noise perc-pwr-adj Specifies the percentage of power adjustment packets that is required
to change the adjustment method from the regular power-adjustment
method to the noise power-adjustment method, which uses an
averaging algorithm to smooth out wide jumps in the power level. The
valid range is 10 to 100 percent, with a default of 30 percent.
Command Default The continue option defaults to 4 dB, the noise option defaults to 30 percent, and the threshold option
defaults to 1 dB.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.0(7)T This command was introduced.
Usage Guidelines When a CM comes online, it sets itself for the optimal power level, as determined by the CMTS. As the
CMTS periodically polls each CM, the CMTS examines the CM’s power level and orders the CM to
adjust its power level to adapt to current total attenuation between it and the CMTS. These power
adjustments can be required because of temperature variations, upstream frequency hopping, or
increased attenuation that has been added either intentionally or unintentionally. The cable upstream
power-adjust command controls how the CMTS makes these power adjustments.
Note To set the upstream power level on the CMTS, see cable upstream power-level, page 676.
Cisco IOS CMTS Cable Command Reference
CBL-672 OL-15510-15
Cable Commands: cable u through cable w
cable upstream power-adjust
Setting the threshold Option
The threshold option specifies the allowable range between the target upstream power for a CM and the
actual receive power that the CMTS is measuring for that CM. If the CM receive power level is above or
below the target power level by a value that is greater than the threshold option, the CMTS will
command the CM to change its power level. When the CMTS receive power level for a CM falls within
the threshold range of the target power level, the CMTS stops commanding the CM to change its power
level.
For example, the default threshold value of 1 dB means that the CM must be 1 dB above or below its
target power range before the CMTS will command it to change its power level. If the CM is within 1 dB
of its target power level, the CMTS does not adjust the CM’s power level.
Note The threshold parameter can be set from 0 dB to 10 dB with a default of 1 dB. However, do not set the
threshold to 0 dB because this means that the CMTS will command all CMs to continually change their
power levels until the CMTS measures the power levels at exactly 0 dBmV. Cisco recommends that you
set the threshold parameter to a minimum of its default value of 1 dB so that the CMs do not change
their power levels continually for minuscule RF plant variations.
Setting the continue Option
The continue option specifies the maximum allowable range for the CM’s power level, in relation to its
target power level. The CM can operate even at its maximum transmit power level, as long as it is within
the continue range. The continue parameter can be set from 2 dB to 15 dB, with a default of 4 dB. For
example, with the value of 2 dB, the CM can operate within 2 dB of its target power level, even if it is
transmitting at its maximum power level.
The continue option works together with the threshold option to control the CM’s operation. If the CM
is within the threshold range, the CMTS sets the Ranging Status field of its RNG-RSP messages to
SUCCESS. If the CM is outside the threshold range, but within the continue range, the CMTS sets the
Ranging Status field to CONTINUE.
Note Cisco recommends designing the network so that CMs are at least 6 dB from the CM’s maximum
transmit power level. This will accommodate new services, changing modulation schemes, different
channel widths, customer-installed passives, temperature variations, and other non-linearities. DOCSIS
specifies a minimal power range of +8 dBmV to +55 dBmV for 16-QAM operation and +8 dBmV to
+58 dBmV maximum power level for QPSK operation. Cisco CMs typically have a maximum power
level of +60 dBmV, which exceeds the DOCSIS standards.
Tip If a number of CMs are transmitting close to their maximum transmit power, try increasing the continue
range to allow the CMTS to continue adjusting the CM’s power levels. This situation can happen when
systems use high value taps, such as 29 dB taps, in the design of the plant.
Note When the CM requires 16 successive power adjustments that are greater than the value of the continue
option, the CMTS re-initializes the CM and starts to rescan downstream carriers, as per the DOCSIS
specification.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-673
Cable Commands: cable u through cable w
cable upstream power-adjust
Determining if the CM has Reached Its Maximum Power Level
Per the DOCSIS specification, the CMTS does not adjust the CM power level by commanding the CM
to set itself to an absolute power level. Instead, the CMTS changes the CM power levels by commanding
the CM to make relative power adjustments, using increments of +/–0.25 dB (or multiples thereof).
If the CMTS commands a CM to adjust its power level by a particular amount, but the measured power
level afterwards shows that the CM has made a smaller adjustment than requested, the show cable
flap-list and show cable modem commands show an exclamation point (!) for that particular CM. This
typically indicates that the CM has reached its maximum power level.
If the CM has not reached its maximum power level, but the show cable flap-list and show cable modem
commands still show an exclamation point (!) for that CM, the problem could be a fault in the upstream
path of the cable network. This fault is typically found as amplifier misalignment, where one upstream
amplifier is adjusted with too much input attenuation, and the next has too little. The amplifier with too
little attenuation enters non-linear operation and begins serious intermodulation.
Another possible cause is a faulty CM or a faulty connection between the CM and cable network. For
example, a faulty coaxial cable or bad F-connector could also create noise problems.
Note A CM that shows an exclamation point (!) in the show cable flap-list and show cable modem displays
is typically more prone to packet loss than other CMs.
Setting the noise Option
The noise option specifies that when the number of power adjustments beyond the threshold amount
exceeds a certain percentage of the total Ranging Requests for a CM, the CMTS switches into its noise
power-adjustment method. The noise power-adjustment method uses an averaging algorithm to make
power adjustments for a particular CM, so that if a modem is experiencing wide swings in its power
levels (known as “bouncing’), the CMTS averages the power levels before sending a power adjustment
to the CM. The CMTS returns to the normal power adjust method after receiving ten Ranging Request
messages with power adjustments below the threshold value.
For example, the cable upstream power-adjust noise 30 command instructs the CMTS that when
30 percent (3 out of the last 10) of the Ranging Responses for a particular CM resulted in a power
adjustment beyond the threshold level, the CMTS begins using power averaging for that CM to adjust
its power level.
Tip The cable upstream power-adjust noise command is typically not needed during normal operations,
but it can help in certain situations where the cable plant is experiencing ingress noise and other
interference that is forcing many CMs to frequently re-range. If the show cable flap-list and show cable
modem commands show a large number of CMs with asterisks (*), experiment with the noise option, so
that the CMTS will average its CM power readings before sending any power adjustments to the CMs.
Note When a CM is in power averaging mode, the show cable flap-list and show cable modem commands
shows an asterisk (*) for that particular CM.
Examples The following example shows the commands needed so that the CMTS will begin using the power
averaging adjustment method when 50 percent of Ranging Requests result in a power adjustment beyond
the threshold level of 2 dB:
Cisco IOS CMTS Cable Command Reference
CBL-674 OL-15510-15
Cable Commands: cable u through cable w
cable upstream power-adjust
Router(config)# interface c6/0
Router(config-if)# cable upstream 0 power-adjust threshold 2
Router(config-if)# cable upstream 0 power-adjust noise 50
Router(config-if)#
Related Commands Command Description
cable upstream frequency Configures a fixed frequency of the upstream RF carrier for an
upstream port.
cable upstream power-level Sets the input power level for the upstream radio frequency (RF)
carrier.
show cable flap-list Displays a list of CMs that have exceeded the threshold number of
power adjustments.
show cable modem Displays CM configuration settings.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-675
Cable Commands: cable u through cable w
cable upstream power-level
cable upstream power-level
To set the input power level for the upstream radio frequency (RF) carrier in decibels per millivolt
(dBmV), use the cable upstream power-level command in cable interface configuration mode. To
restore the default value for this command, use the no form of this command.
cable upstream n power-level dbmv
no cable upstream n power-level dbmv
Syntax Description n Specifies the upstream port number. Valid values start with 0 for the first
upstream port on the cable interface line card.
dbmv Decibels per millivolt designating the upstream signal input power level. Valid
range is –16 dBmV to +26 dBmV, depending on the cable interface and the
upstream’s symbol rate (channel width).
Command Default 0 dBmV
Command Modes Interface configuration (cable interface only)
Command History Release Modification
11.3 XA This command was introduced.
12.2(15)BC1 The allowable range of power levels was changed so that it depends on the
upstream’s channel width.
Usage Guidelines The Cisco CMTS controls the output power levels of the CMs to meet the desired upstream input power
level. The nominal input power level for the upstream RF carrier is specified in decibels per millivolt
(dBmV). The default setting of 0 dBmV is the optimal setting for the upstream power level.
The valid range for the input power level depends on the data rate, as expressed as the symbol rate and
channel width. Table 24 shows the valid power levels for each allowable rate, as given in the DOCSIS
specification. Higher (more positive) values cause the CMs to increase their transmit power, achieving
a greater carrier-to-noise ratio (CNR).
Table 24 Allowable DOCSIS Power Levels
Symbol Rate (Symbols per
second) Channel Width (Hz) Allowable Power Range (dBmV)
160,000 200,000 –16 to +14
320,000 400,000 –13 to +17
640,000 800,000 –10 to +20
1,280,000 1,600,000 –7 to +23
Cisco IOS CMTS Cable Command Reference
CBL-676 OL-15510-15
Cable Commands: cable u through cable w
cable upstream power-level
Table 24 Allowable DOCSIS Power Levels
Symbol Rate (Symbols per
second) Channel Width (Hz) Allowable Power Range (dBmV)
2,560,000 3,200,000 –4 to +26
1
5,120,000 6,400,000 –1 to +29 (max. valid value for DOCSIS is +26)
1. The 5.12 MSymbols/sec symbol rate and 6.4 MHz channel width are supported only on upstreams that are configured for
DOCSIS 2.0 A-TDMA-only operation.
Note Some cable interfaces might allow smaller ranges of either –10 to +10 or –10 to +25 dBmV.
Tip You can use inline attenuators to force CMs to transmit at higher power levels and to achieve a higher
CNR value on the network.
Caution If you increase the input power level or add inline attenuators before the CMTS, the CMs on your HFC
network increase their transmit power level. Be careful if you adjust this parameter. You might violate
the upstream return laser design parameters or exceed the CM’s maximum transmit power level.
Note Do not adjust your input power level by more than 5 dB in a 30-second interval. If you increase the
power level by more than 5 dB within 30 seconds, you will disrupt CM service on your network. If you
decrease the power level by more than 5 dB within 30 seconds, the CMs on your network will be forced
to re-range.
Tip When setting upstream power levels, Cisco recommends that the adjacent channels of equal bandwidth
not have a large variation. The recommended maximum input power variance is 5 to 6 dB.
Examples The following example shows how to set the input power level for upstream port 0 to -5 dBmV:
Router(config)# interface cable 5/1/0
Router(config-if)# cable upstream 0 power-level -5
Router(config-if)#
Related Commands Command Description
cable upstream fec Enables the upstream FEC.
cable upstream frequency Enters a fixed frequency of the upstream RF carrier for an upstream
port.
cable upstream power-adjust Controls how the CMTS adjusts the CM power level so that the CMs
reach the target transmit power setting.
cable upstream shutdown Disables the upstream port.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-677
Cable Commands: cable u through cable w
cable upstream qos wfq
cable upstream qos wfq
To configure weighted fair queuing (WFQ) parameters for optimum bandwidth utilization for upstream
service flows on a cable interface, use the cable upstream qos wfq command in cable interface
configuration mode. To disable this configuration, use the no form of this command.
cable upstream qos wfq {class | activity | weights priority0-priority7}
no cable upstream qos wfq {class | activity | weights priority0-priority7}
Syntax Description class Enables class-based weighted fair queuing.
activity Enables activity-based weighted fair queuing.
weights Specifies custom weight values for all the eight service flow priorities in a
priority0-priority7 service class. By default, the weight of a priority is equal to “priority+1.” For
example, priority 0 has a weight of 1 and priority 1 has a weight of 2.
You must specify custom weight values for all the eight service flow
priorities (0 to 7) when you modify the default weights of priorities. The
valid range is from 1 to 255.
Command Default None
Command Modes Cable interface configuration (config-if)
Command History Release Modification
12.2(33)SCD2 This command was introduced in Cisco IOS Release 12.2(33)SCD2.
Examples The following example shows how to configure WFQ parameters on a cable interface in slot 7, subslot 1,
and port 0 on a Cisco uBR10012 router:
Router# configure terminal
Router(config)# interface cable 7/1/0
Router(config-if)# cable upstream qos wfq class
Router(config-if)# cable upstream qos wfq activity
Router(config-if)# cable upstream qos wfq weights 10 20 30 40 50 60 70 80
Related Commands Command Description
show interface cable Displays the current scheduling state, statistics, and WFQ parameters
mac-scheduler configured on a cable interface.
Cisco IOS CMTS Cable Command Reference
CBL-678 OL-15510-15
Cable Commands: cable u through cable w
cable upstream range-backoff
cable upstream range-backoff
To specify automatic or configured initial ranging backoff calculation, use the cable upstream
range-backoff command in cable interface configuration mode. To set default values, use the no form
of this command.
cable upstream n range-backoff {automatic | start end}
no cable upstream n range-backoff
Syntax Description n Specifies the upstream port number. Valid values start with 0 for the
first upstream port on the cable interface line card.
automatic Specifies the fixed data backoff start and end values.
Note The automatic setting is not supported on
Cisco uBR-MC5X20S/U cable interface line cards, which
should use manually configured ranging backoff instead.
start Binary exponential algorithm. Sets the start value for initial ranging
backoff. Valid values are from 0 to 15.
end Binary exponential algorithm. Sets the end value for initial ranging
backoff. Valid values are from 0 to 15.
Command Default Ranging backoff is enabled with the automatic setting
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.1 T This command was introduced.
Usage Guidelines The DOCSIS-specified method of contention resolution for CMs used to send data or requests on the
upstream channel is a truncated binary exponential back-off with the initial backoff window and the
maximum backoff window controlled by the CMTS. The Cisco CMTS router specifies backoff window
values for both data and initial ranging and sends these values downstream as part of the Bandwidth
Allocation Map (MAP) MAC message. The values are power-of-two values. For example, a value of 4
indicates a window between 0 and 15; a value of 10 indicates a window between 0 and 1023.
The automatic setting is optimized for a maximum of 250 CMs per upstream port. Set manual values
for data backoff windows only when operating with more than 250 CMs per upstream port. (The
automatic setting is not supported on Cisco uBR-MC5X20S/U cable interface line cards, which should
use manually configured ranging backoff instead.)
Tip Use the show controllers cable upstream command to display the current Ranging Backoff settings.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-679
Cable Commands: cable u through cable w
cable upstream range-backoff
Examples The following example shows how to set the range backoff to automatic for upstream port 2:
Router(config)# interface cable 4/0
Router(config-if)# cable upstream 2 range-backoff automatic
Router(config-if)#
Related Commands Command Description
cable insertion-interval Configures the interval between consecutive initial ranging slots on an
upstream.
cable upstream data-backoff Specifies automatic or fixed start and stop values for data backoff.
Cisco IOS CMTS Cable Command Reference
CBL-680 OL-15510-15
Cable Commands: cable u through cable w
cable upstream ranging-init-technique
cable upstream ranging-init-technique
To configure the initial ranging technique for the modem in the Multiple Transmit Channel (MTC) mode,
use the cable upstream ranging-init-technique command in interface configuration mode. To disable
the ranging initialization technique, use the no form of this command.
cable upstream ranging-init-technique {1-4}
no cable upstream ranging-init-technique
Syntax Description 1-4 Type of ranging.
• 1—broadcast
• 2—unicast
• 3—broadcast or unicast
• 4—direct use
Command Default The default option is 1—broadcast
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines The ranging initialization technique is used when the modem transitions from a single channel to the
multiple transit channel mode (MTC-mode), for the initial ranging on the newly added channels during
registration.
Use the default value of 1 for initial ranging.
Examples The following example shows how to configure the initial ranging for the modem in the MTC-mode:
Router# configure terminal
Router(config)# interface cable 7/0/1
Router(config-if)# cable upstream ranging-init-technique 1
Related Commands Command Description
cable mtc-mode Enables the MTC-mode for a MAC interface.
interface cable Specifies a cable interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-681
Cable Commands: cable u through cable w
cable upstream ranging-poll
cable upstream ranging-poll
To change the default ranging poll interval (20 seconds) on upstream channels, use the cable upstream
ranging-poll command in cable interface configuration mode. To disable this configuration, use the no
form of this command.
cable upstream ranging-poll [interval value | t4-multiplier timeout_value]
no cable upstream ranging-poll [interval value | t4-multiplier timeout_value]
Syntax Description interval value (Optional) Specifies the ranging poll interval in milliseconds. Valid values
are from 20000 to 30000. The default value is 20000.
t4-multiplier (Optional) Specifies T4 timeout multiplier value for the cable modems that
timeout_value are in the MTC mode. The valid range is from 1 to 10.
Command Default None
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCC This command was introduced in Cisco IOS Release 12.2(33)SCC.
Usage Guidelines T4 multiplier is the T4 timeout multiplier value for cable modems that are in the MTC mode. The default
value is derived from the number of channels in the modem transmit channel set. You can change the
default T4 multiplier value using the cable upstream ranging-poll command in cable interface
configuration mode. For example, DOCSIS 2.0 defines T4 timeout for the modem at 30 seconds. If the
T4 multiplier value is equal to one, the cable modem will T4 time out in every 30 seconds. If you change
the T4 multiplier to four, then the new T4 timeout value will be 120 seconds (4 x 30 = 120).
In the MTC mode, you can increase the T4 timeout value in order to reduce the router overhead
associated with processing of ranging request (RNG-REQ) slots and ranging response (RNG-RSP)
messages. If an RNG-RSP message does not contain a T4 timeout multiplier value, then the cable
modem uses the default T4 timeout value.
Note We recommend that you do not modify the default ranging poll interval unless required. With the default
configuration, a DOCSIS 2.0 cable modem in non-MTC mode performs ranging on one upstream
channel every 20 seconds.
Cisco IOS CMTS Cable Command Reference
CBL-682 OL-15510-15
Cable Commands: cable u through cable w
cable upstream ranging-poll
Examples The following example shows how to change the default ranging poll interval and the T4 timeout
multiplier value on a cable interface line card:
Router# configure terminal
Router(config)# interface cable 7/1/0
Router(config-if)# cable upstream ranging-poll interval 24000 t4-multiplier 4
Related Commands Command Description
cable mtc-mode Enables the Multiple Transmit Channel mode (MTC) for a MAC interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-683
Cable Commands: cable u through cable w
cable upstream rate-adapt (global)
cable upstream rate-adapt (global)
To globally enable upstream utilization optimization on all cable modem upstream flows, use the cable
upstream rate-adapt command in global configuration mode. To disable global upstream utilization
optimization, use the no form of this command.
cable upstream rate-adapt [local | priority value | rate number]
no cable upstream rate-adapt [local | priority value | rate number]
Syntax Description local (Optional) Specifies upstream utilization optimization is enabled on a
specific upstream.
priority value (Optional) Specifies upstream utilization optimization is enabled if an
upstream flow meets or exceeds a defined priority. The valid range is 0–7.
rate number (Optional) Specifies upstream utilization optimization is enabled if an
upstream flow meets or exceeds the set minimum max-rate of the flow. The
valid range is 0–30000000.
Command Default Upstream utilization optimization is globally disabled.
Command Modes Global configuration (config)
Command History Release Modification
12.3(23)BC2 This command was introduced.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.2(33)SCB. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines If upstream utilization optimization is globally enabled, activated service flows are configured for
upstream utilization optimization. The command also turns on local upstream utilization optimization so
specific local upstreams can be configured to be rate-adapt enabled. Using the priority or rate option
allows you to restrict upstream utilization optimization to service flows that meet or exceed specified
levels for priority or rate.
Examples The following example enables upstream utilization optimization globally on all upstream flows.
Router(config)# cable upstream rate-adapt
Related Commands
Cisco IOS CMTS Cable Command Reference
CBL-684 OL-15510-15
Cable Commands: cable u through cable w
cable upstream rate-adapt (global)
Command Description
cable upstream Enables and configures upstream utilization optimization locally.
rate-adapt (interface)
show cable rate-adapt Displays the global and local upstream utilization optimization
configuration parameters.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-685
Cable Commands: cable u through cable w
cable upstream rate-adapt (interface)
cable upstream rate-adapt (interface)
To enable and configure upstream utilization optimization locally, use the cable upstream rate-adapt
command in cable interface configuration mode. To disable upstream utilization optimization on the
specified upstream flow, use the no form of this command.
cable upstream port rate-adapt [bcs slots | duration millisecs | fcms-off | priority value |
rate number]
no cable upstream port rate-adapt [bcs slots | duration millisecs | fcms-off | priority value |
rate number]
Syntax Description port Identifies the specific upstream flow to be optimized and configured.
bcs slots (Optional) Specifies the number of broadcast contention minislots (BCS).
MAPs that have gaps are filled with BCS. You can override the default of 10
with a larger or smaller number using the bcs option. The valid range
is 0–80. The default is 10 BCS.
duration millisecs (Optional) Specifies the length of time, in milliseconds, that a flow
rate-adapts. This keyword overrides the default duration. The default is 1.
The valid range is 0–2000.
fcms-off (Optional) Disables the forced broadcast contention minislot at the end of a
filled MAP.
priority value (Optional) Specifies the minimum priority required to enable rate-adapt on
a flow. This keyword overrides any globally configured rate-adapt priority.
The valid range is 0–7.
rate number (Optional) Specifies the minimum max-rate required to enable rate-adapt on
a flow. This keyword overrides any globally configured rate-adapt rate. The
valid range is 0–30000000.
Command Default Upstream utilization optimization is not enabled on a local upstream.
Command Modes Interface configuration—cable interface only (config-if)
Command History Release Modification
12.3(23)BC2 This command was introduced.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.2(33)SCB. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines If eligible, local upstream flows can utilize upstream utilization optimization.
Cisco IOS CMTS Cable Command Reference
CBL-686 OL-15510-15
Cable Commands: cable u through cable w
cable upstream rate-adapt (interface)
Examples The following example enables and configures rate-adapt on upstream 0 with a priority of 6 and a rate
of 200.
Router(config-if)# cable upstream 0 rate-adapt priority 6 rate 200
Related Commands Command Description
cable upstream Enables upstream utilization optimization globally on all cable modem
rate-adapt (global) upstream flows.
show cable rate-adapt Displays the global and local upstream utilization optimization
configuration parameters.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-687
Cable Commands: cable u through cable w
cable upstream rate-limit
cable upstream rate-limit
To set DOCSIS rate limiting for an upstream port on a cable interface line card, use the cable upstream
rate-limit command in cable interface configuration mode. To disable DOCSIS rate limiting for the
upstream port, use the no form of this command.
cable upstream n rate-limit [token-bucket [shaping]]
no cable upstream n rate-limit
Syntax Description n Specifies the upstream port number. Valid values start with 0 for the
first upstream port on the cable interface line card.
token-bucket shaping (Optional) Enables rate limiting for the specified upstream cable
interface using the token-bucket policing algorithm. The shaping
option enables token-bucket shaping.
Command Default Token-bucket algorithm with traffic shaping
Command Modes Interface configuration (cable interface only)
Command History Release Modification
11.3(6)NA This command was introduced for the Cisco uBR7246VXR universal
broadband routers.
11.3(9)NA The shaping keyword was added.
Usage Guidelines Upstream rate limiting allows upstream bandwidth requests from rate-exceeding CMs to be buffered
without incurring TCP-related timeouts and retransmits. This enables the Cisco CMTS to enforce the
peak upstream rate for each CM without degrading overall TCP performance for the subscriber CPE
devices. Upstream grant shaping is per cable modem (SID).
When the token-bucket algorithm is configured, the Cisco CMTS automatically drops packets in
violation of allowable upstream bandwidth.
Use of the default value (the upstream port’s rate limit) enforces strict DOCSIS-compliant rate limiting.
Cisco highly recommends to using the default setting of token-bucket with the shaping option.
Note This command is specific to the Cisco uBR7225VXR routers only.
Examples The following example shows how to configure the token bucket filter algorithm with traffic shaping on
upstream port 4:
Router(config-if)# cable upstream 4 rate-limit token-bucket shaping
Cisco IOS CMTS Cable Command Reference
CBL-688 OL-15510-15
Cable Commands: cable u through cable w
cable upstream rate-limit
Related Commands Command Description
cable downstream rate-limit Enables DOCSIS rate limiting on downstream traffic.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-689
Cable Commands: cable u through cable w
cable upstream rate-limit-bwreq exempted-priority
cable upstream rate-limit-bwreq exempted-priority
To configure the service flow priority of the bandwidth requests that should be exempted from being
throttled by the upstream (US) bandwidth request rate limiting (BRRL) feature, use the cable upstream
rate-limit-bwreq exempted-priority command in global configuration mode. To reset the exempted
priority to the default value, use the no form of this command.
cable upstream rate-limit-bwreq exempted-priority priority
no cable upstream rate-limit-bwreq
Syntax Description priority Service flow priority.
Bandwidth requests with this service flow priority value (and above) are
exempted from being throttled by the BRRL feature. For example, if the
priority value is set to 3, then bandwidth requests with priority 3, 4, 5, 6, and
7 are exempted. The valid range is from 0 to 7.
Command Default All bandwidth requests are throttled by the BRRL feature.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCF This command was introduced.
Usage Guidelines The upstream BRRL feature throttles incoming bandwidth requests in order to control CPU consumption
by the US scheduler.
The cable upstream rate-limit-bwreq exempted-priority command enables you to configure an
exempted priority. Any best effort(BE) service flow bandwidth requests received with this configured
priority or above, is exempted from BRRL and is therefore not dropped even if high CPU consumption
by the US scheduler is observed. For example, if the configured exempted priority is 4, any bandwidth
request with priority 4, 5, 6, or 7 is not dropped even if high CPU consumption is observed.
Exempted service flow priority is a platform level configuration and is applicable to all line cards. If the
exempted priority is set to value zero, all the BE bandwidth requests are exempted from being throttled
by the BRRL feature.
Examples The following example shows how to configure a BRRL exempted service flow priority to value 5:
Router# configure terminal
Router(config)# cable upstream rate-limit-bwreq exempted-priority 5
Cisco IOS CMTS Cable Command Reference
CBL-690 OL-15510-15
Cable Commands: cable u through cable w
cable upstream rate-limit-ccf
cable upstream rate-limit-ccf
To configure rate limiting parameters for upstream bonded service flows on a Cisco uBR10-MC5X20H
cable interface line card, use the cable upstream rate-limit-ccf command in global configuration mode.
To disable this configuration, use the no form of this command.
cable upstream rate-limit-ccf [aggregated-burst value | aggregated-throughput value |
cpu-burst value | cpu-threshold value]
no cable upstream rate-limit-ccf [aggregated-burst value | aggregated-throughput value |
cpu-burst value | cpu-threshold value]
Syntax Description aggregated-burst value (Optional) Specifies the burst rate for aggregated throughput-based rate
limiting in bits. The valid range is from 0 to 250000000. The default value
is 8000000.
aggregated-throughput (Optional) Specifies the throughput value for throughput-based rate limiting
value in bits per second (bps). The valid range is from 0 to 540000000. The default
value is 115000000.
cpu-burst value (Optional) Specifies the CPU burst for Continuous Concatenation and
Fragmentation (CCF) in percentage. The valid range is from 0 to 100. The
default value is 10.
cpu-threshold value (Optional) Specifies the CPU threshold for CCF in percentage. The valid
range is from 0 to 100. The default value is 50.
Command Default None
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced in Cisco IOS Release 12.2(33)SCC.
Examples The following example shows how to configure rate limiting parameters for upstream bonded service
flows on a Cisco uBR10012 router:
Router# configure terminal
Router(config)# cable upstream rate-limit-ccf
Router(config)# cable upstream rate-limit-ccf aggregated-burst 25000
Router(config)# cable upstream rate-limit-ccf aggregated-throughput 540000
Router(config)# cable upstream rate-limit-ccf cpu-burst 30
Router(config)# cable upstream rate-limit-ccf cpu-threshold 60
Related Commands
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-691
Cable Commands: cable u through cable w
cable upstream rate-limit-ccf
Command Description
show cable Displays information about rate limiting criteria configured on a
rate-limit-ccf Cisco uBR10-MC5X20H cable interface line card.
Cisco IOS CMTS Cable Command Reference
CBL-692 OL-15510-15
Cable Commands: cable u through cable w
cable upstream resiliency
cable upstream resiliency
To configure cable upstream resiliency on a cable interface line card, use the cable upstream resiliency
command in cable interface configuration mode. To disable the configuration, use the no form of this
command.
cable upstream resiliency {channel-down-detect number | modem-offline-detect number |
on-failure {disable-channel | extended-ranging | reset-modem} | sf-move RTPS}
no able upstream resiliency {channel-down-detect number | modem-offline-detect number |
on-failure {disable-channel | extended-ranging | reset-modem} | sf-move RTPS}
Syntax Description channel-down-detect Specifies the threshold (number of consecutive ranging misses) to determine
number if a channel is down. The valid values are from 8 to 64.
modem-offline-detect Specifies the threshold (number of consecutive ranging misses) to determine
number if a CM is offline. The valid values are from 4 to 16.
on-failure Allows you to specify what should be done if the channel is down and the
CM is offline.
disable-channel Allows the CMTS to mark the channel as unusable when a failure is
detected.
extended-ranging Allows the CMTS to continue ranging when a failure is detected.
reset-modem Enforces the CM to go offline when a failure is detected.
sf-move Moves the upstream service flows on an impaired upstream channel to
another good upstream channel in the transmit channel set of the cable
modem without resetting the cable modem.
RTPS Moves Real-time Polling Service (RTPS) type service flows.
Command Default By default, the threshold to determine if a channel is down is not enabled, the CMTS is set to continue
ranging when a failure is detected and the threshold to determine if a CM is offline is set to 8.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCC This command was introduced in Cisco IOS Release 12.2(33)SCC.
12.2(33)SCG This command was modified. The sf-move RTPS keyword was added.
Examples The following example shows how to configure upstream resiliency with different keywords on a cable
interface in slot 5, subslot 1, and port 0 on a Cisco uBR10012 router:
Router# configure terminal
Router(config)# interface cable 5/1/0
Router(config-if)# cable upstream resiliency channel-down-detect 30
Router(config-if)# cable upstream resiliency modem-offline-detect 16
Router(config-if)# cable upstream resiliency on-failure disable-channel
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-693
Cable Commands: cable u through cable w
cable upstream resiliency
Router(config-if)# cable upstream resiliency sf-move RTPS
The following example shows how to configure RTPS type service flow move on a cable interface in slot
7, subslot 0, and port 0 in Cisco IOS Release 12.2(33)SCG:
Router#show run all | i sf-move
no cable upstream resiliency sf-move RTPS
Router#conf t
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)#interface cable 7/0/0
Router(config-if)#cable upstream resiliency sf-move RTPS
Router(config-if)#end
Router#
Router#show run interface cable 7/0/0 | i sf-move
cable upstream resiliency sf-move RTPS
Router#
Associated Features The cable upstream resiliency command is used to configure the Upstream Channel Bonding feature.
Related Commands Command Description
interface cable Configures cable interface.
Cisco IOS CMTS Cable Command Reference
CBL-694 OL-15510-15
Cable Commands: cable u through cable w
cable upstream rf-adapt
cable upstream rf-adapt
To enable RF adaptation on the physical upstream channel, use the cable upstream rf-adapt command
in cable interface configuration mode. To disable the RF adaptation, use the no form of this command.
cable upstream port rf-adapt
no cable upstream port rf-adapt
Syntax Description port Upstream port number. The valid values start with 0 for the first
upstream port on the cable interface line card and ends with a value that
depends on the number of upstream ports supported by the cable
interface line card.
Command Default By default, RF adaptation is disabled.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCF This command was introduced.
Usage Guidelines The cable upstream port rf-adapt command is available only when the maximum number of logical
channels configured using the cable upstream max-logical-chans command is greater than 1.
Examples The following example shows how to enable RF adaptation on cable interface 8/0/0:
Router(config)# interface cable 8/0/0
Router(config-if)# cable upstream 0 max-logical-chans 2
Router(config-if)# cable upstream 0 rf-adapt
Related Commands Command Description
cable rf-adapt timer Configures timers for RF adaptation.
cable upstream rf-adapt Configures the primary upstream logical channel and secondary
(logical channel) upstream logical channel.
cable upstream threshold Configures the upstream for the signal-to-noise ratio (SNR) and
forward error correction (FEC) threshold values to be used in
determining the allowable noise levels.
cable upstream threshold Configures the hysteresis value to be used in conjunction with the
hysteresis dynamic modulation upgrade thresholds.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-695
Cable Commands: cable u through cable w
cable upstream rf-adapt
Command Description
cable upstream threshold Configures the upstream RF adaptation threshold value, which
rf-adapt prevents excessive relocation of modems from the primary upstream
channel to the secondary upstream channel.
show cable modem rf-adapt Displays the RF adaptation history.
show cable rf-adapt Displays the downgrade and upgrade candidate lists.
Cisco IOS CMTS Cable Command Reference
CBL-696 OL-15510-15
Cable Commands: cable u through cable w
cable upstream rf-adapt (logical channel)
cable upstream rf-adapt (logical channel)
To specify the primary upstream logical channel and the secondary upstream logical channel, use the
cable upstream port logical-channel-index rf-adapt [primary | secondary] command in cable
interface configuration mode. To reset to the default settings, use the no form of this command.
cable upstream port logical-channel-index rf-adapt [primary | secondary]
no cable upstream port logical-channel-index rf-adapt [primary | secondary]
Syntax Description port Upstream port number. The valid values start with 0 for the first
upstream port on the cable interface line card and ends with a value that
depends on the number of upstream ports supported by the cable
interface line card..
logical-channel-index Logical channel index. The valid values are 0 or 1.
primary (Optional) Assigns the logical channel as primary for RF adaptation. By
default, logical channel 0 is set as primary.
secondary (Optional) Assigns the logical channel as secondary for RF adaptation.
By default, logical channel 1 is set as secondary.
Command Default Uses the default configuration. Logical channel 0 is primary and logical channel 1 is secondary.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCF This command was introduced.
Usage Guidelines It is recommended that logical channel 0 is set as primary, and logical channel 1 is set as secondary.
Examples The following example shows how to configure primary and secondary logical channels:
Router> enable
Router# configure terminal
Router(config)# interface cable 8/0/0
Router(config-if)# cable upstream 0 max-logical-chans 2
Router(config-if)# cable upstream 0 rf-adapt
Router(config-if)# cable upstream 0 1 rf-adapt primary
Router(config-if)# cable upstream 0 0 rf-adapt secondary
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-697
Cable Commands: cable u through cable w
cable upstream rf-adapt (logical channel)
Related Commands Command Description
cable rf-adapt timer Configures timers for RF adaptation.
cable upstream rf-adapt Enables RF adaptation on the physical upstream channel.
cable upstream threshold Configures the upstream for the signal-to-noise ratio (SNR) and
forward error correction (FEC) threshold values to be used in
determining the allowable noise levels.
cable upstream threshold Configures the hysteresis value to be used in conjunction with the
hysteresis dynamic modulation upgrade thresholds.
cable upstream threshold Configures the upstream RF adaptation threshold value, which
rf-adapt prevents excessive relocation of modems from the primary upstream
channel to the secondary upstream channel.
show cable modem rf-adapt Displays the RF adaptation history.
show cable rf-adapt Displays the downgrade and upgrade candidate lists.
Cisco IOS CMTS Cable Command Reference
CBL-698 OL-15510-15
Cable Commands: cable u through cable w
cable upstream scheduling type
cable upstream scheduling type
To enable various scheduler modes, use the cable upstream scheduling type command in interface
configuration mode (cable interface only). To disable this feature, use the no form of this command.
cable upstream n scheduling type [ugs | rtps] mode [llq | docsis]
no cable upstream n scheduling type [ugs | rtps] mode [llq | docsis]
Syntax Description n Specifies the upstream port. Valid values start with 0 for the first upstream
port on the cable interface line card.
ugs (Optional) Selects scheduling for UGS.
rtps (Optional) Selects scheduling for rtPS.
mode Enables the selection of packet-based Low Level Queueing (LLQ) or
TDM-based DOCSIS scheduling.
llq (Optional) Selects LLQ scheduling.
docsis (Optional) Selects DOCSIS scheduling.
Command Default The only default is docsis.
Command Modes Interface configuration —cable interface only (config-if)
Command History Release Modification
12.3(13(BC) This command was introduced.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines Any combination of ugs, rtps, llq, and docsis is allowed.
Note the following restrictions:
• To ensure proper operation, Call Admission Control (CAC) must be enabled. When the Low Latency
Queueing (LLQ) option is enabled, it is possible for the upstream path to be filled with so many calls
that it becomes unusable, making voice quality unacceptable. CAC must be used to limit the number
of calls to ensure acceptable voice quality, as well as to ensure traffic other than voice traffic.
• Even if CAC is not enabled, the default (DOCSIS) scheduling mode blocks traffic after a certain
number of calls.
Examples The following example shows how to enable LLQ-type (packet-based) scheduling for UGS services on
upstream port 4 on a Cisco CMTS interface:
Router(config-if)# cable upstream 4 scheduling type ugs mode llq
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-699
Cable Commands: cable u through cable w
cable upstream scheduling type
The following example shows how to enable standard DOCSIS (TDM-based) scheduling for rtPS
services on upstream port 4 on a Cisco CMTS interface:
Router(config-if)# cable upstream 4 scheduling type rtps mode docsis
Related Commands Command Description
show interface cable Use this command to confirm whether LLQ scheduling is enabled.
mac-scheduler
Cisco IOS CMTS Cable Command Reference
CBL-700 OL-15510-15
Cable Commands: cable u through cable w
cable upstream scrambler
cable upstream scrambler
To enable the cable upstream scrambler, use the cable upstream scrambler command in cable interface
configuration mode. To restore the default configuration value for this command, use the no form of this
command.
cable upstream n scrambler
no cable upstream n scrambler
Syntax Description n Specifies the upstream port number. Valid values start with 0 for the first
upstream port on the cable interface line card.
Command Default Disabled
Command Modes Interface configuration (cable interface only)
Command History Release Modification
11.3 XA This command was introduced.
Usage Guidelines This command causes CMs to enable their pseudo-random scrambler circuitry to improve the robustness
of the upstream receiver on the line card.
The scrambler on the upstream radio frequency (RF) carrier enables CMs on the HFC network to use
built-in scrambler circuitry for upstream data transmissions. The scrambler circuitry improves reliability
of the upstream receiver on the cable interface line card. The upstream scrambler is activated by default
and should not be disabled under normal circumstances.
Caution Scrambler must be activated for normal operation. Deactivate only for prototype CMs that do not support
scrambler.
Examples The following example shows how to activate the upstream scrambler:
Router(config-if)# cable upstream 0 scrambler#
Related Commands Command Description
cable upstream fec Enables the upstream FEC.
cable upstream frequency Enters a fixed frequency of the upstream RF carrier for an
upstream port.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-701
Cable Commands: cable u through cable w
cable upstream scrambler
Command Description
cable upstream power-level Sets the input power level for the upstream RF carrier in decibels
per millivolt (dBmV).
cable upstream shutdown Disables the upstream port.
Cisco IOS CMTS Cable Command Reference
CBL-702 OL-15510-15
Cable Commands: cable u through cable w
cable upstream shutdown
cable upstream shutdown
To disable a single upstream physical or logical channel port, use the cable upstream shutdown
command in cable interface configuration mode. To enable the upstream port, use the no form of this
command.
Physical Channel
cable upstream n shutdown
no cable upstream n shutdown
Logical Channel
cable upstream n m shutdown
no cable upstream n m shutdown
Syntax Description n Specifies the upstream port number. Valid values start with 0 for the first
upstream port on the cable interface line card.
m Specifies the logical channel index of 0 or 1.
Command Default Upstream port is enabled
Command Modes Interface configuration (config-if)
Command History Release Modification
11.3 XA This command was introduced.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
12.2(33)SCC This command was modified with the addition of logical channel index.
Usage Guidelines The cable upstream shutdown command shuts down a single upstream physical or logical port without
affecting any of the other upstream or downstream ports on the cable interface.
Note The cable upstream shutdown command exists at both physical and logical channel level with minor
variations in the command syntax.
When multiple logical channels are configured, the upstream related CLIs are categorized into two
groups: physical port level and logical channel level. Logical channel level commands use the format
of cable upstream n m shutdown, where n denotes the physical port number, and m denotes the logical
channel index number.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-703
Cable Commands: cable u through cable w
cable upstream shutdown
When multiple logical channels are configured, the cable upstream shutdown command at the physical
level shuts down the upstream physical port and all the logical channles configured under that physical
port. To shut down the entire interface, use the shutdown command in cable interface configuration
mode.
Examples The following example shows how to disable the upstream port for the physical channel:
Router(config-if)# cable upstream 0 shutdown
The following example shows how to disable the upstream port for the logical channel:
Router(config-if)# cable upstream 0 0 shutdown
Related Commands Command Description
shutdown Shuts down (disables) an interface and all of its ports.
Cisco IOS CMTS Cable Command Reference
CBL-704 OL-15510-15
Cable Commands: cable u through cable w
cable upstream snr-polling
cable upstream snr-polling
To configure how often cable interface cards with hardware spectrum management should poll an
upstream to determine its Carrier-to-Noise Ration (CNR), use the cable upstream snr-polling command
in cable interface configuration mode.
cable upstream n snr-polling interval-in-ms
Note This command can be used only on upstreams on the Cisco uBR-MC16S cable interface line cards.
Syntax Description n Specifies the upstream port number. Valid values start with 0 for the
first upstream port on the cable interface line card.
interval-in-ms The valid range is 1000 to 25000 milliseconds, with a default of 15000
milliseconds.
Command Default 5000 milliseconds
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.1(7)CX1 This command was introduced for Cisco CMTS routers using the
Cisco uBR-MC16S cable interface line card.
12.2(8)BC2 Support was added for the Cisco uBR10012 router and the
Cisco uBR-LCP2-MC16S cable interface line card.
Usage Guidelines The Cisco uBR-MC16S cable interface line cards contain digital signal processors (DSPs) that perform
hardware spectrum management. Use the cable upstream snr-polling command to determine how often
that hardware should examine an upstream’s signal to determine the current CNR value.
Examples The following example shows how to configure the sixth upstream on a Cisco uBR-MC16S cable
interface card so that the DSP samples the upstream signal every 10 seconds (10,000 milliseconds):
Router(config)# interface cable 3/0
Router(config-if)# cable upstream 5 snr-polling 10000
Router(config-if)#
Related Commands Command Description
cable modulation-profile Creates a cable modulation profile.
cable upstream Configures an upstream for one modulation profile (static profile) or two
modulation-profile modulation profiles (Dynamic Upstream Modulation).
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-705
Cable Commands: cable u through cable w
cable upstream snr-polling
Command Description
show cable hop Displays the current hop period and threshold for an upstream, along with
other statistics.
show cable Displays the cable modulation profiles that have been created.
modulation-profile
Cisco IOS CMTS Cable Command Reference
CBL-706 OL-15510-15
Cable Commands: cable u through cable w
cable upstream spectrum-group
cable upstream spectrum-group
To assign a spectrum group to a single upstream on a cable interface line card, use the cable upstream
spectrum-group command in interface configuration mode. To remove a spectrum group from an
upstream, use the no form of this command.
cable upstream n spectrum-group group-number
no cable upstream n spectrum-group group-number
Syntax Description n Specifies the upstream port number. Valid values start with 0 for the first upstream
port on the cable interface line card.
group-number Specifies the spectrum group for which you are specifying a parameter value or
specifies the number of the spectrum group you wish to remove from your router
configuration. Valid range is from 1 to 32, or from 1 to 40, depending on the
Cisco IOS software release.
Command Default No default behavior or values.
Command Modes Interface configuration
Command History Release Modification
11.3 NA This command was introduced.
12.2(15)BC2 The maximum number of spectrum groups was increased from 32
to 40 groups per router.
Usage Guidelines This command assigns a spectrum group to a single upstream on the cable interface line card. To
configure the spectrum groups, use the set of cable spectrum-group commands in global configuration
mode.
Note You can also spectrum groups to all of the upstreams on the cable interface using the cable
spectrum-group (interface configuration) command.
Examples The following example shows how to assign spectrum group 12 to the first upstream on the cable
interface line card in slot 5/0:
Router(config)# interface cable 5/0
Router(config-if)# cable upstream 0 spectrum-group 12
Router(config-if)# exit
Router(config)#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-707
Cable Commands: cable u through cable w
cable upstream spectrum-group
Related Commands Command Description
cable modulation-profile Configures preset modulation profiles that you can
apply to one or more upstream cable interfaces
when you identify and configure spectrum groups.
cable spectrum-group (global configuration) Creates and configures a spectrum group.
cable spectrum-group (interface configuration) Assigns a spectrum group to all of the upstreams
on a cable interface line card.
cable spectrum-group hop period Sets the minimum frequency-hop interval for a
cable spectrum group.
cable spectrum-group hop threshold Specifies a hop threshold for a cable spectrum
group.
cable spectrum-group shared Specifies the upstream ports in a spectrum group
can share the same upstream frequency.
cable upstream hopping blind Disengages the advanced spectrum management
features of the Cisco uBR-MC16S and
Cisco uBR-MC5X20S/U cable interface line cards
by enabling blind frequency hopping behavior.
Cisco IOS CMTS Cable Command Reference
CBL-708 OL-15510-15
Cable Commands: cable u through cable w
cable upstream spreading-interval
cable upstream spreading-interval
To specify the spreading interval for Synchronous Code Division Multiple Access (S-CDMA) channels
on an upstream channel, use the cable upstream spreading-interval command in cable interface
configuration mode. To set the spreading interval value to its default setting, use the no form of this
command.
cable upstream n spreading-interval spreading-interval
no cable upstream n spreading-interval
Syntax Description n Specifies the upstream port. Valid values start with 0 for the first
upstream port on the cable interface line card.
spreading-interval Specifies the spreading interval for S-CDMA channels. Valid values
range from 1 to 32, with a default value of 16.
Command Default The spreading-interval setting cannot be applied if S-CDMA is not configured.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines This command is applicable only for S-CDMA channels. You should configure S-CDMA to apply the
spreading-interval.
Examples The following example sets the spreading interval to 32 on the upstream port 0:
Router(config)# interface cable 7/0/4
Router(config-if)# cable upstream 0 spreading-interval 32
Router(config-if)#
Related Commands Command Description
cable upstream active-codes Specifies the number of active codes that can be configured on an
upstream channel.
cable upstream Specifies the number of codes-per-minislot allowed on an upstream
codes-per-minislot channel.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-709
Cable Commands: cable u through cable w
cable upstream threshold
cable upstream threshold
To configure the upstream for the carrier-to-noise ratio (CNR) or signal-to-noise ratio (SNR) and
forward error correction (FEC) threshold values to be used in determining the allowable noise levels, use
the cable upstream threshold command in cable interface configuration mode. To return to the default
values, use the no form of the command.
Cisco IOS Releases 12.2(8)BC2 and Earlier
cable upstream n threshold cnr-profile1 cnr-threshold1 cnr-profile2 cnr-threshold2
corr-fec fec-corrected uncorr-fec fec-uncorrected
no cable upstream n threshold cnr-profile1 cnr-threshold1 cnr-profile2 cnr-threshold2
corr-fec fec-corrected uncorr-fec fec-uncorrected
Cisco IOS Releases 12.3(23)BC, 12.2(33)SCA and Later
Physical Channel
lcable upstream n threshold {cnr-profiles cnr-threshold1 cnr-threshold2 | snr-profiles
snr-threshold1 snr-threshold2 | hysteresis hysteresis-value | corr-fec fec-corrected |
uncorr-fec fec-uncorrected}
no cable upstream n threshold {cnr-profiles | snr-profiles | hysteresis | corr-fec | uncorr-fec}
Logical Channel
cable upstream n m threshold {snr-profiles snr-threshold1 snr-threshold2 | corr-fec fec-corrected
| uncorr-fec fec-uncorrected}
no cable upstream n m threshold {snr-profiles | corr-fec | uncorr-fec}
Syntax Description n Upstream port number. The valid values range from 0 to 3.
m Logical channel index of 0 or 1.
cnr-profiles Specifies the CNR threshold in dB.
cnr-threshold1 CNR threshold for the primary modulation profile specified for the
upstream.
The valid values range from 5 to 35 dB, with a default value of 25 dB.
To bypass both the primary and secondary CNR thresholds, set the first
parameter (cnr-threshold1) to 0. This disallows the second parameter
(cnr-threshold2), enabling you to bypass both the CNR thresholds.
cnr-threshold2 CNR threshold for the secondary modulation profile specified for the
upstream.
The valid values range from 5 to 35 dB, with a default value of 15 dB.
The secondary threshold value must be lesser than the primary
threshold.
If the first parameter (cnr-threshold1) is set to 0, then the second
parameter (cnr-threshold2) is not allowed.
snr-profiles Specifies the SNR threshold in dB.
Cisco IOS CMTS Cable Command Reference
CBL-710 OL-15510-15
Cable Commands: cable u through cable w
cable upstream threshold
snr-threshold1 SNR threshold for the primary modulation profile specified for the
upstream. This value is also used by the Cable Modem Upstream RF
Adaptation feature.
The valid values range from 5 to 35 dB, with a default value of 25 dB.
You can bypass the primary SNR threshold (snr-threshold1) by setting
it to 0.
snr-threshold2 SNR threshold for the secondary modulation profile specified for the
upstream.
The valid values range from 5 to 35 dB, with a default value of 15 dB.
The secondary threshold value must be lesser than the primary
threshold.
Though, you can bypass the primary SNR threshold (snr-threshold1) by
setting it to 0, you must enter the second parameter (snr-threshold2).
hysteresis hysteresis-value Specifies the hysteresis value to be used in conjunction with the
dynamic modulation upgrade thresholds.
The threshold is specified in dB, with a valid range of 0 to 10 dB, and a
default value of 3 dB.
You can bypass the hysteresis threshold by setting the value to 0.
corr-fec fec-corrected Specifies the allowable number of correctable FEC errors for the
upstream.
The fec-corrected parameter is given as a percentage of total packets
received on the upstream during the polling period, with a valid range
of 1 to 30, and a default of 3.
You can bypass the corr-fec threshold by setting the value to 0.
uncorr-fec fec-uncorrected Specifies the allowable number of uncorrectable FEC errors for the
upstream.
The fec-uncorrected parameter is given as a percentage of total packets
received on the upstream during the polling period, with a valid range
of 1 to 30, and a default of 1.
You can bypass the uncorr-fec threshold by setting the value to 0.
Command Default Uses the default values.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.1(7)CX1 This command was introduced for Cisco CMTS routers using the
Cisco uBR-MC16S cable interface line card.
12.2(8)BC2 Support was added for the Cisco uBR10012 router and the
Cisco uBR-LCP2-MC16S cable interface line card. Also, the ranges
and defaults for the correctable and uncorrectable FEC error
thresholds were changed.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-711
Cable Commands: cable u through cable w
cable upstream threshold
Release Modification
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
12.2(33)SCC This command was modified with the addition of snr-profiles
keyword option and support was added for Cisco uBR-MC5X20H
cable interface line card. Also, this command is used at both physical
and logical channel level with slight variations in the command syntax
for the uBR10012 router.
Usage Guidelines Separate CNR or SNR thresholds are assigned to the primary and secondary modulation profiles. Both
profiles, however, are assigned the same correctable and uncorrectable FEC values.
Note The uncorrectable FEC error count includes packets that have header checksum errors and “no unique
word detected” errors.
The hysteresis keyword of the cable upstream threshold command configures a hysteresis value to
prevent upstream channels from becoming unstable and continuously changing between modulation
profiles.
• The hysteresis value is used in dynamic modulation, frequency hopping, and dynamic channel-width
changes.
• The hysteresis value is used in conjunction with CNR or SNR thresholds to determine channel
configuration upgrade criteria for both advanced and basic spectrum management features.
The range and defaults for the correctable and uncorrectable FEC error thresholds were changed in
Cisco IOS Release 12.2(8)BC2.
From Cisco IOS Release 12.2(33)SCC onwards, you can configure two logical channels on a single
physical port for the uBR10012 router. When you configure logical channels, the upstream related
commands are categorized into two groups: physical port level and logical channel level.
Physical Port Level
Physical port level commands use the format of cable upstream n, where n denotes the physical port
number.
Logical Channel Level
Logical channel level commands use the format of cable upstream n m, where n denotes the physical
port number, and m denotes the logical channel index number of 0 or 1.
The following restrictions and conditions applies to both physical and logical channel configurations:
• You can bypass both the primary and secondary CNR thresholds by setting the first parameter to 0.
This disallows the second parameter, enabling you to bypass both the CNR thresholds.
• If you provide the primary CNR threshold, then you must enter the secondary CNR threshold also.
• You can bypass the primary SNR threshold by setting it to 0. However, you must enter the second
parameter. This is required as each threshold is used independently in Three Step Dynamic
Upstream Modulation feature.
• You can bypass the hysteresis, corr-fec, and uncorr-fec thresholds by setting their values to 0.
Cisco IOS CMTS Cable Command Reference
CBL-712 OL-15510-15
Cable Commands: cable u through cable w
cable upstream threshold
• For normal plant use, we recommend that the uncorrectable FEC threshold remain at its default of
1 percent to avoid an unacceptable number of errors on the channel.
Examples Cisco IOS Releases 12.2(8)BC2 and Earlier
The following example shows upstream 5 configured with the CNR threshold for the primary modulation
profile set to 20 dB, the CNR threshold for the secondary modulation profile set to 10 dB, the correctable
FEC error rate set to 5 percent of total packets received on the upstream, and the uncorrectable FEC error
rate set to 1 percent of total packets received on the upstream:
Router(config)# interface cable 3/0
Router(config-if)# cable upstream 5 threshold cnr-profile1 20 cnr-profile2 10 corr-fec 5
uncorr-fec 1
Router(config-if)#
Cisco IOS Releases 12.3(23)BC, 12.2(33)SCA and Later
The following example shows upstream 5 configured with the CNR threshold for the primary modulation
profile set to 20 dB, the CNR threshold for the secondary modulation profile set to 10 dB, the correctable
FEC error rate set to 5 percent of total packets received on the upstream, and the uncorrectable FEC error
rate set to 1 percent of total packets received on the upstream:
Router(config)# interface cable 3/0
Router(config-if)# cable upstream 5 threshold cnr-profiles 20 10
Router(config-if)# cable upstream 5 threshold corr-fec 5
Router(config-if)# cable upstream 5 threshold uncorr-fec 1
Router(config-if)#
The following example shows upstream 5 configured with the SNR threshold for the primary modulation
profile set to 20 dB, the SNR threshold for the secondary modulation profile set to 10 dB, the correctable
FEC error rate set to 5 percent of total packets received on the upstream, and the uncorrectable FEC error
rate set to 1 percent of total packets received on the upstream:
Router(config)# interface cable 3/0
Router(config-if)# cable upstream 5 threshold snr-profiles 20 10
Router(config-if)# cable upstream 5 threshold corr-fec 5
Router(config-if)# cable upstream 5 threshold uncorr-fec 1
Router(config-if)#
SNR Example on the Cisco uBR10012 Router Only
The following example shows upstream 5 and logical channel 1 configured with the SNR threshold for
the primary modulation profile set to 20 dB, the SNR threshold for the secondary modulation profile set
to 10 dB, the correctable FEC error rate set to 5 percent of total packets received on the upstream, and
the uncorrectable FEC error rate set to 1 percent of total packets received on the upstream:
Router(config)# interface cable 7/0/0
Router(config-if)# cable upstream 5 1 threshold snr-profiles 20 10
Router(config-if)# cable upstream 5 1 threshold corr-fec 5
Router(config-if)# cable upstream 5 1 threshold uncorr-fec 1
Router(config-if)#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-713
Cable Commands: cable u through cable w
cable upstream threshold
Related Commands Command Description
cable modulation-profile Creates a cable modulation profile.
cable modulation-profile Creates a global cable modulation profile that allows to assign any
global-system number from 1 to 400 for modulation profiles, irrespective of the
DOCSIS mode.
cable upstream hop-priority Determines the order of the corrective actions to be taken when
ingress noise exceeds the allowable value for an upstream.
cable upstream Configures an upstream for one modulation profile (static profile) or
modulation-profile two modulation profiles (dynamic upstream modulation).
cable upstream threshold Configures the upstream RF adaptation threshold value, which
rf-adapt prevents excessive relocation of modems from the primary upstream
channel to the secondary upstream channel.
show cable hop Displays the current hop period and threshold for an upstream, along
with other statistics.
show cable Displays the cable modulation profiles that have been created.
modulation-profile
Cisco IOS CMTS Cable Command Reference
CBL-714 OL-15510-15
Cable Commands: cable u through cable w
cable upstream threshold hysteresis
cable upstream threshold hysteresis
To configure a hysteresis value to be used in conjunction with the dynamic modulation upgrade
thresholds, use the cable upstream threshold hysteresis command in cable interface configuration
mode. To use the default hysteresis value, use the no form of this command.
cable upstream n threshold hysteresis hysteresis-in-dB
no cable upstream n threshold hysteresis
Syntax Description n Specifies the upstream port number. Valid values start with 0 for the
first upstream port on the cable interface line card.
hysteresis-in-dB Specifies the hysteresis value to be used in conjunction with the
dynamic modulation upgrade thresholds.
The valid values are from 0 to 10 dB.
Command Default The default value of hysteresis is 3 dB.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.3(23)BC7 This command was first introduced.
Usage Guidelines The cable upstream threshold hysteresis command can be used to configure a hysteresis value to
prevent upstream (US) channels from becoming unstable and continuously changing between
modulation profiles.
• The hysteresis value is used in dynamic modulation, frequency hopping, and dynamic
channel-width changes.
• The hysteresis value is used in conjunction with carrier-to-noise ratio (CNR) or signal-to-noise ratio
(SNR) thresholds to determine channel configuration upgrade criteria for both advanced and basic
spectrum management features.
• The hysteresis value is used for cable modem upstream RF adaptation upgrades from the secondary
to the primary upstream channel.
Examples The following example configures a hysteresis value to be used in conjunction with the SNR and CNR
thresholds for dynamic modulation upgrade.
Router(config)# interface cable 3/0
Router(config-if)# cable upstream 0 threshold hysteresis 5
Router(config-if)#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-715
Cable Commands: cable u through cable w
cable upstream threshold hysteresis
Related Commands Command Description
cable modulation-profile Creates a cable modulation profile.
cable upstream hop-priority Determines the order of the corrective actions to be taken when
ingress noise exceeds the allowable value for an upstream.
Note This command is related to the cable upstream threshold
hysteresis command only when using advanced dynamic
modulation configuration, that is, when spectrum group is
defined for the upstream channel.
cable upstream threshold Configures the upstream for the carrier-to-noise ratio (CNR) or
signal-to-noise ratio (SNR) and forward error correction (FEC)
threshold values to be used in determining the allowable noise levels.
cable upstream threshold Configures the upstream RF adaptation threshold value, which
rf-adapt prevents excessive relocation of modems from the primary upstream
channel to the secondary upstream channel.
show cable Displays the cable modulation profiles that have been created.
modulation-profile
Cisco IOS CMTS Cable Command Reference
CBL-716 OL-15510-15
Cable Commands: cable u through cable w
cable upstream threshold rf-adapt
cable upstream threshold rf-adapt
To configure the upstream RF adaptation threshold value, which prevents excessive relocation of
modems from the primary upstream channel to the secondary, use the cable upstream threshold
rf-adapt command in cable interface configuration mode. To use the default rf-adapt value, use the no
form of this command.
cable upstream port threshold rf-adapt threshold1-in-percent
no cable upstream port threshold rf-adapt
Syntax Description port Upstream port number. The valid values start with 0 for the first
upstream port on the cable interface line card and ends with a value that
depends on the number of upstream ports supported by the cable
interface line card.
threshold1-in-percent RF adaptation threshold value in percentage. The valid range is from 1
to 50. The value 0 indicates the RF adaptation threshold is bypassed.
The default value is 10 percent.
Command Default The default value is 10 percent.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCF This command was introduced.
Usage Guidelines The rf-adapt threshold represents a percentage of affected modems relative to the total modem
population on a given upstream channel. If the rf-adapt threshold is bypassed, then it is ignored while
determining if a downgrade candidate should be relocated. The rf-adapt threshold is applied only to the
physical channel and is used to prevent relocation of modems that are downgrade candidates.
The rf-adapt value is used by the upstream RF adaptation application to prevent the relocation of more
than x% of the total modem population on that upstream channel, during PHY layer impairment.
Examples The following example shows how to configure the rf-adapt threshold for cable modem upstream RF
adaptation.
Router(config)# interface cable 8/0/0
Router(config-if)# cable upstream 0 threshold rf-adapt 25
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-717
Cable Commands: cable u through cable w
cable upstream threshold rf-adapt
Related Commands Command Description
cable rf-adapt timer Configures timers for RF adaptation.
cable upstream rf-adapt Enables RF adaptation on the physical upstream channel.
cable upstream rf-adapt Configures the primary upstream logical channel and secondary
(logical channel) upstream logical channel.
cable upstream threshold Configures the upstream for the signal-to-noise ratio (SNR) and
forward error correction (FEC) threshold values to be used in
determining the allowable noise levels.
cable upstream threshold Configures the hysteresis value to be used in conjunction with the
hysteresis dynamic modulation upgrade thresholds.
show cable modem rf-adapt Displays the RF adaptation history.
show cable rf-adapt Displays the downgrade and upgrade candidate lists.
Cisco IOS CMTS Cable Command Reference
CBL-718 OL-15510-15
Cable Commands: cable u through cable w
cable upstream timing-adjust
cable upstream timing-adjust
To enable upstream timing adjustment for a specified cable interface, use the cable upstream
timing-adjust command in cable interface configuration mode. To return to the default values, use the
no form of this command.
cable upstream n timing-adjust {continue sec | threshold sec}
no cable upstream n timing-adjust {continue sec | threshold sec}
Syntax Description n Specifies the upstream port number. Valid values start with 0 for the
first upstream port on the cable interface line card.
continue sec Sets the minimum timing adjustment that sets continue ranging status
in seconds. The range for sec is 2 to 64 seconds. Default value is
2 seconds.
threshold sec Sets the timing adjustment threshold in seconds. Valid threshold value
is 1 to 32 seconds. Default is 1 second.
Command Default 2 seconds for continue and 1 second for threshold
Command Modes Interface configuration (cable interface only)
Command History Release Modification
11.3 NA This command was introduced.
12.0(12)SC This command was supported on the 12.0 SC release.
12.1(3)T This command was supported on the 12.1 T release.
12.1(3a)EC This command was removed and no longer supported on the 12.1 EC and
later releases (including those releases, such as 12.1 CX, that are based on the
12.1 EC train).
Usage Guidelines To verify whether or not upstream timing adjustment is configured and activated, enter the show
running-config command and look for the cable interface configuration information. If upstream timing
adjustment is enabled, either or both of the continue and threshold timing adjustment entries are
displayed in the show running-config output. If both the continue and threshold upstream timing
adjustments are disabled, no timing adjustment entry is displayed in the show running-config output.
If you are having trouble, make sure that the cable connections are not loose or disconnected; the cable
interface line card is firmly seated in its chassis slot; the captive installation screws are tight; and you
have entered the correct slot and port numbers.
Note The cable timing-adjust command is applicable only on Cisco IOS Release 12.0(12)SC and Cisco IOS
Release 12.1(3)T. It is deprecated and removed on Cisco IOS Release 12.1(3a)EC, 12.1(4)CX, and later
releases.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-719
Cable Commands: cable u through cable w
cable upstream timing-adjust
Examples The following example shows how to set the upstream time adjustment ranging value to 5 seconds:
CMTS01(config-if)# cable upstream 0 time-adjust continue 5
The following example shows how to set the threshold value to the default of 12 seconds:
CMTS01(config-if)# cable upstream 0 time-adjust threshold 12
Cisco IOS CMTS Cable Command Reference
CBL-720 OL-15510-15
Cable Commands: cable u through cable w
cable upstream unfrag-slot-jitter
cable upstream unfrag-slot-jitter
To control how much jitter can be tolerated on the corresponding upstream due to unfragmentable slots,
use the cable upstream unfrag-slot-jitter command in cable interface configuration mode. To disallow
all jitter, use the no form of this command.
cable upstream n unfrag-slot-jitter [limit jitter | cac-enforce]
no cable upstream n unfrag-slot-jitter [limit jitter | cac-enforce]
Syntax Description n Specifies the upstream port number. Valid values start with 0 for the first
upstream port on the cable interface line card.
limit jitter Specifies the allowable jitter limit caused by unfragmentable slots, in
microseconds (0 to 4,294,967,295).
cac-enforce Rejects service flows requesting jitter less than the fragmentable slot jitter.
Command Default By default, the limit is 0 microseconds and the cac-enforce option is enabled.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.1(4)CX This command was introduced.
12.2(4)BC1 Support was added to the Release 12.2 BC train.
Usage Guidelines This command controls how much jitter due to unfragmented slots is to be tolerated on each port. If the
specified value for the tolerated limit is less than the size of a maximum unfragmentable slot, the MAC
scheduler automatically blocks the slots in the scheduling table so that the unfragmentable slot can be
accommodated in the blocked space and avoid causing excessive jitter to CBR slots.
The cac-enforce option enforces the rule that service flows requesting run-time jitter less than
unfragmentable slot jitter should be rejected.
Examples The following example shows the jitter being set to 10 milliseconds (10,000 microseconds) for upstream
port 0 on cable interface 2/0:
Router# configure terminal
Router(config)# interface c2/0
Router(config-if)# cable upstream 0 unfrag-slot-jitter limit 10000
Router(config-if)#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-721
Cable Commands: cable u through cable w
cable util-interval
cable util-interval
To set the load and utilization interval of upstream and downstream physical channels, use the
cable util-interval command in global configuration mode. To remove the utilization interval, use the
no form of this command.
cable util-interval interval
no cable util-interval interval
Syntax Description interval Utilization interval for the upstream and downstream channels. The valid
range is from 1 to 86400 seconds.
Command Default The utilization interval is not set by default.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCD2 This command was introduced.
Usage Guidelines The cable util-interval command configures the same value as the
docsIfCmtsChannelUtilizationInterval and ccwbRFChanUtilInterval objects.
The unit of interval is seconds and it is not recommended to set a smaller value as it may cause frequent
utilization calculation that will consume more resources on both, the PRE and cable line card.
A value between 60 to 300 seconds or greater is recommended.
Examples The following example shows how to set the utilization interval for the upstream and downstream
channels:
Router# configure terminal
Router(config)# cable util-interval 22
Router(config)#
Related Commands Command Description
show running-config Displays the running configuration for each of the cable interfaces.
Cisco IOS CMTS Cable Command Reference
CBL-722 OL-15510-15
Cable Commands: cable u through cable w
cable vc-map
cable vc-map
To map a cable modem to a particular permanent virtual connection (PVC) on an Asynchronous Transfer
Mode (ATM) interface, use the cable vc-map command in global configuration mode. To remove this
mapping, use the no form of this command.
cable vc-map mac-address atm-interface vpi/vci [cust-name]
no cable vc-map mac-address
no cable vc-map customer cust-name
Syntax Description mac-address Specifies the hardware (MAC) address for the cable modem whose traffic is to
be mapped.
atm-interface Specifies the outbound ATM interface to which this cable modem should be
mapped.
vpi/vci Specifies the virtual path identifier (VPI) and virtual channel identifier (VCI) on
the ATM interface to which this cable modem should be mapped.
cust-name (Optional) Identifies the customer for this PVC. The cust-name can be any
arbitrary alphanumeric string, up to 127 characters long.
customer cust-name (Optional) Deletes all PVCs belong to this customer. The cust-name can be any
arbitrary alphanumeric string, up to 127 characters long.
Command Default No default behavior or values
Command Modes Global configuration
Command History Release Modification
12.2(11)BC3 This command was introduced for Cisco uBR7100 series and
Cisco uBR7246VXR universal broadband routers.
12.2(15)BC2 Support for the customer option was added.
Usage Guidelines This command maps a cable modem, on the basis of its hardware (MAC) address, to a particular PVC
on an ATM interface.
Note To use this command, you must first enable the use of Layer 2 tunnels, using the cable l2-vpn-service
atm-vc command. Then use the cable vc-map command to enable the mapping of individual cable
modems to specific PVCs.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-723
Cable Commands: cable u through cable w
cable vc-map
Examples The following example shows how to enable the use of Layer 2 tunnels and then map specific CMs to
specific PVCS:
Router# config terminal
Router(config)# cable l2-vpn-service atm-vc
Router(config)# cable vc-map 0007.0e03.69f9 ATM2/0 1/1
Router(config)# cable vc-map 0010.7bed.9c95 ATM2/0 1/2
Router(config)# exit
Router#
The following example shows the same configuration as above, but with the addition of a customer name
that identifies the customer that is using each particular PVC:
Router# config terminal
Router(config)# cable l2-vpn-service atm-vc
Router(config)# cable vc-map 0007.0e03.69f9 ATM2/0 1/1 ENTERPRISE-CO1
Router(config)# cable vc-map 0010.7bed.9c95 ATM2/0 1/2 ENTERPRISE-CO2
Router(config)# exit
Router#
Related Commands Command Description
cable l2-vpn-service atm-vc Enables the use of Layer 2 tunnels for the Customer Premises
Equipment (CPE) traffic that is behind cable modems, so that individual
CPE traffic can be routed to a particular PVC on an ATM interface.
debug cable l2-vpn Displays debugging messages for the Layer 2 mapping of cable modems
to a particular PVC on an ATM interface.
show cable l2-vpn vc-map Displays the mapping of one or all cable modems to PVCs on the ATM
interfaces.
Cisco IOS CMTS Cable Command Reference
CBL-724 OL-15510-15
Cable Commands: cable u through cable w
cable vrf-steering cable-modem
cable vrf-steering cable-modem
To steer or direct the cable modems to the first sub-bundle interface that is configured to use the virtual
routing and forwarding (VRF) instance, use the cable vrf-steering cable-modem command in the cable
subinterface configuration mode. To disable this feature, use the no form of this command.
cable vrf-steering cable-modem vrf-name
no cable vrf-steering cable-modem vrf-name
Syntax Description vrf-name VRF instance name.
Command Default Configure a sub-bundle using the ip vrf forwarding command first to enable this command.
Command Modes Subinterface configuration (config-if)
Command History Release Modification
12.2(33)SCF This command was introduced.
Examples The following example shows how to direct the cable modems to the specified VRF:
Note Create an ACL and route-map to steer the CPEs from the CM interface to the global interface before you
steer the CM to the first sub-bundle interface. Use the ip access-list extended access-list name and
route-map route map name permit commands to create an ACL and route-map respectively on the
Cisco uBR10012 routers. Use ip policy route-map route map name command to attach the route-map
to the CM's subbundle interface.
Router(config-if)#cable vrf-steering cable-modem vrfa
Related Commands Command Description
cable source-route Configures the VRF source route on the cable modem's subinterface
configuration mode.
ip vrf Defines a VRF instance and enters the interface configuration mode.
show ip arp vrf Displays which VRF contains a specific cable modem in the ARP table.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-725
Cable Commands: cable u through cable w
cable wideband auto-reset
cable wideband auto-reset
To enable wideband auto-reset mode on the CMTS, use the cable wideband auto-reset command in
global configuration mode. To disable wideband auto-reset mode, use the no form of this command.
cable wideband auto-reset
no cable wideband auto-reset
Syntax Description This command has no keywords or arguments.
Command Default Wideband auto-reset mode is disabled.
Command Modes Global configuration (config)
Command History Release Modification
12.3(21)BC This command was introduced for the uBR10012 router.
12.3(23)BC This command was updated.
12.2(33)SCA This command was integrated into Cisco IOS release 12.2(33)SCA.
Usage Guidelines Use this command to enable wideband auto-reset mode on the CMTS. If wideband auto-reset mode is
enabled, wideband cable modems registered on a cable interface as traditional DOCSIS modems
(DOCSIS 1.x/2.0 modems) are auto-reset when the cable interface becomes wideband-capable. When a
wideband cable modem auto-resets, it deregisters on the CMTS as a traditional DOCSIS cable modem
and immediately attempts to re-register as a wideband cable modem.
A cable interface is considered wideband-capable when at least one fully configured and operational
wideband channel has been associated with the interface’s traditional DOCSIS (narrowband) channel.
For a fully configured wideband CMTS, wideband cable modems may register as traditional DOCSIS
modems for a variety of reasons, such as cable interface line card boot order or line card online insertion
and removal (OIR). Rather than defer wideband cable modem registration, wideband cable modems are
permitted to register as traditional DOCSIS modems.
If a wideband-capable modem registers as a traditional DOCSIS modem, it registers on a primary
downstream channel that has been assigned with the downstream cable command to the modem’s fiber
node if the fiber node is configured. If the modem’s fiber node is not configured, the wideband-capable
modem can register on any downstream channel that is visible to it (as a traditional cable modem does).
Note In Cisco IOS Release12.3(21)BC, the primary downstream channel is a traditional DOCSIS downstream
channel for the fiber node. Beginning in Cisco IOS Release 12.3(23)BC, either an RF channel from the
SPA or a Cisco uBR10-MC5X20 downstream channel serves as a primary channel in a fiber node.
Beginning in Cisco IOS Release12.3(23)BC if the primary downstream channel for this fiber node is
assigned from a SPA downstream, then the downstream cable command is not required.
Cisco IOS CMTS Cable Command Reference
CBL-726 OL-15510-15
Cable Commands: cable u through cable w
cable wideband auto-reset
When and if a cable interface becomes wideband capable, wideband cable modems that have registered
as traditional DOCSIS modems are reset for CMTS routers with wideband auto-reset mode enabled.
These modems are only reset when the interface first becomes wideband-capable and are not reset again
if they subsequently fail to register as wideband cable modems.
Examples The following example shows how to enable wideband auto-reset mode:
Router# configure terminal
Router(config)# cable wideband auto-reset
Related Commands Command Description
cable bundle Configures a cable interface to belong to a virtual bundle interface.
downstream cable Assigns a primary downstream channel for a fiber node.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-727
Cable Commands: cable u through cable w
cable wideband auto-reset
Cisco IOS CMTS Cable Command Reference
CBL-728 OL-15510-15
Cable Commands: ca through cr
Revised: July 2012, OL-15510-15
New Commands
Command Cisco IOS Software Release
clear cable modem name 12.2(33)SCA
clear cable modem voice 12.3(23)BC
clear cable modem attribute-masks 12.2(33)SCB
clear cable modem cm-status 12.2(33)SCB
clear cable modem rcs-counts 12.2(33)SCB
clear cable modem service-type-id 12.2(33)SCB
clear cable rf-status 12.2(33)SCB
clear pxf statistics drl cable-wan-ip 12.2(33)SCB
clear pxf statistics drl wan-non-ip 12.2(33)SCB
clear cable ipc-stats 12.2(33)SCC
controller integrated-cable 12.2(33)SCC
clear packetcable rks 12.2(33)SCD
clear hccp linecard 12.2(33)SCE
clear cable multicast statistics counter 12.2(33)SCF
clear cable modem rf-adapt 12.2(33)SCF3
clear cable bgsync counters 12.2(33)SCG
Modified Commands
Command Cisco IOS Software Release
clear cable host 12.2(33)SCA
clear cable modem delete 12.3(23)BC, 12.2(33)SCA
clear cable modem reset 12.3(23)BC, 12.2(33)SCA
card 12.2(33)SCB
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-729
Cable Commands: ca through cr
Command Cisco IOS Software Release
controller modular-cable 12.2(33)SCB
clear cable modem cm-status 12.2(33)SCC
clear cable modem name 12.2(33)SCD
clear cable modem cm-status 12.2(33)SCD
controller integrated-cable 12.2(33)SCD
controller modular-cable 12.2(33)SCE
clear cable logging 12.2(33)SCG
Replaced Commands
Command Replacement Command Effective Cisco IOS Release
clear cable modem counters clear counters 12.2(15)BC1
Cisco IOS CMTS Cable Command Reference
CBL-730 OL-15510-15
Cable Commands: ca through cr
channel-group
channel-group
To add an interface (Gigabit Ethernet or Fast Ethernet) to an EtherChannel Group, and to associate that
interface with an EtherChannel link, use the channel-group command in interface configuration mode.
To remove an EtherChannel interface from the EtherChannel group, use the no form of this command.
channel-group n
no channel-group n
Syntax Description n The identifying number for the EtherChannel group with which to associate this interface.
An EtherChannel group can be identified in the range of 1 to 64, and each group can have
up to four interfaces, only one of which is the master.
Defaults By default, the channel-group command has the following behaviors:
• EtherChannel groups and ports are not defined.
• EtherChannel groups and ports are disabled (off mode) once configured, and must be enabled.
• The first port assigned to an EtherChannel group is the bundle master.
Command Modes Interface configuration (config-if)
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.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
Support for the Cisco uBR7225VXR router was added.
Usage Guidelines The no form of this command also removes the associated EtherChannel ports within the EtherChannel
group. For additional information, refer to the EtherChannel on the Cisco CMTS Routers feature
document on Cisco.com.
Examples The following example creates an EtherChannel link with a channel group identifier of 1 on the specified
port. If this is the first port assigned to EtherChannel group 1, it becomes the master in that EtherChannel
group.
Router(config-if)# channel-group etherchannel 1
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-731
Cable Commands: ca through cr
channel-group
Related Commands Command Description
show interface port-channel Displays the EtherChannel interfaces and channel identifiers, with
their mode and operational status.
Cisco IOS CMTS Cable Command Reference
CBL-732 OL-15510-15
Cable Commands: ca through cr
channel-id (cable configuration file)
channel-id (cable configuration file)
To create a DOCSIS configuration file that specifies the upstream channel ID for a CM configuration
file, use the channel-id command in cable config-file configuration mode. To remove the channel ID
specification, use the no form of this command.
channel-id upstreamchan-id
no channel-id
Syntax Description upstreamchan-id Specifies the upstream channel ID. Valid range is 0 to 255, depending on the
number of actual upstream ports on the cable interface being used.
Defaults If no upstream channel ID is specified, the CM uses the upstream channel from the Upstream Channel
Description (UCD) messages it receives on the downstream channel.
Command Modes Cable configuration file (config-file)
Command History Release Modification
12.1(2)EC1 This command was introduced.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
Support for the Cisco uBR7225VXR router was added.
Usage Guidelines This command sets the Upstream Channel ID Configuration Setting field in the DOCSIS configuration
file. Typically, the CM uses the upstream channel ID that is specified by the CMTS during the
registration process, but this command overrides that setting and forces the CM to use the upstream
channel specified in the DOCSIS configuration file. If that upstream does not exist, or if the upstream
cannot be obtained for some reason, the CM cannot come online.
Note If you are using a telco-return CM, the upstream channel must be 0.
Examples The following example shows how to set the upstream channel ID for the configuration file to 3. If the
CM cannot obtain this upstream channel, it does not come online.
Router(config)# cable config-file channeloverride.cm
Router(config-file)# channel-id 3
Router(config-file)# exit
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-733
Cable Commands: ca through cr
channel-id (cable configuration file)
Related Commands Command Description
cable config-file Creates a DOCSIS configuration file and enters configuration file
mode.
access-denied Disables access to the network.
cpe max Specifies CPE information.
download Specifies download information for the configuration file.
frequency Specifies downstream frequency.
option Provides config-file options.
privacy Specifies privacy options for baseline privacy images.
service-class Specifies service class definitions for the configuration file.
snmp manager Specifies Simple Network Management Protocol (SNMP) options.
timestamp Enables time-stamp generation.
Cisco IOS CMTS Cable Command Reference
CBL-734 OL-15510-15
Cable Commands: ca through cr
clear cable admission control counters
clear cable admission control counters
To reset all the resource counters on the Cisco CMTS to zero, use the
clear cable admission control counters command in privileged EXEC mode.
clear cable admission control counters
Command Default No default behaviors or values
Command Modes Privileged EXEC (#)
Command History Release Modification
12.3(13a)BC This command was introduced.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines The counters are also set to zero when a given resource is reconfigured. Counters can be displayed using
the show cable admission-control command.
For additional information, refer to the Admission Control for the Cisco CMTS feature documents on
Cisco.com.
Examples The following example resets configured admission control counters to zero, whether configured in
global or interface configuration mode:
Router# clear cable admission control counters
Related Commands Command Description
cable admission-control Configures the CPU and memory thresholds for the Cisco
CMTS and supporting broadband processing engines
(BPEs)
cable admission-control event Configures and enables Admission Control event types on
the Cisco CMTS.
cable admission-control ds-bandwidth Configures Admission Control downstream bandwidth
thresholds on the Cisco CMTS.
cable admission-control us-bandwidth Configures Admission Control upstream bandwidth
thresholds on the Cisco CMTS.
debug cable admission-control Enables automatic Admission Control troubleshooting
processes on the Cisco CMTS.
show cable admission-control Displays the current Admission Control configuration and
status on the Cisco CMTS, or on a specified interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-735
Cable Commands: ca through cr
clear cable arp-filter
clear cable arp-filter
To reset Address Resolution Protocol (ARP) filter statistics displayed by the show cable arp-filter
command, use the clear cable arp-filter command in privileged EXEC mode.
clear cable arp-filter {bundle number | cable {slot/port | slot/subslot/port}}
Syntax Description bundle number Resets the ARP filter statistics for the specified virtual bundle interface,
where number is a value from 1 to 255.
cable slot/port (Cisco uBR7100 and Cisco uBR7200 Series Routers) Specifies removal
of CMs on the specified cable interface and downstream port, where:
• slot—Specifies the chassis slot number of the cable interface line
card.
• port—Specifies the downstream port number.
Valid values for these arguments are dependent on your CMTS router
and cable interface line card. Refer to the hardware documentation for
your router chassis and cable interface line card for supported slot and
port numbering.
cable slot/subslot/port (Cisco uBR10012 Router) Specifies removal of CMs on the specified
cable interface, where:
• slot—Specifies the chassis slot number of the cable interface line
card. Valid slots are 5 to 8.
• subslot—Specifies the secondary slot number of the cable interface
line card. Valid subslots are 0 or 1.
• port—Specifies the downstream port number. Valid ports are 0 to
4, depending on the cable interface line card.
Syntax Description No default behavior or values
Command Modes Privileged EXEC (#)
Command History Release Modification
12.3(17a)BC This command was introduced.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines Use the clear cable arp-filter command to clear the ARP filter statistics that are displayed using the
show cable arp-filter command.
Cisco IOS CMTS Cable Command Reference
CBL-736 OL-15510-15
Cable Commands: ca through cr
clear cable arp-filter
Examples This example shows cable ARP filter statistics for virtual bundle interface number 10, followed by a
clearing of the ARP filter statistics on that bundle and the resulting display of cleared statistics.
Router# show cable arp-filter bundle 10
ARP Filter statistics for Bundle10:
Replies Rcvd: 3069 total. 3062 unfiltered, 7 filtered
Requests Forwarded: 1175 total. 1175 unfiltered, 0 filtered
Requests Sent For IP: 0 total. 0 unfiltered, 0 filtered
Router# clear cable arp-filter bundle 10
Router# show cable arp-filter bundle 10
ARP Filter statistics for Bundle10:
Replies Rcvd: 0 total. 0 unfiltered, 0 filtered
Requests Forwarded: 0 total. 0 unfiltered, 0 filtered
Requests Sent For IP: 0 total. 0 unfiltered, 0 filtered
Related Commands Command Description
cable arp filter Controls the number of ARP packets that are allowable for each
SID on a cable interface.
clear arp-cache Refreshes dynamically created entries from the ARP cache.
show cable arp-filter Displays the total number of ARP replies and requests that have
been sent and received, including the number of requests that
have been filtered.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-737
Cable Commands: ca through cr
clear cable bgsync counters
clear cable bgsync counters
To clear the background synchronization information on the Cisco CMTS, use the clear cable bgsync
counters command in global configuration mode.
clear cable bgsync counters
Syntax Description There are no arguments or keywords.
Command Modes Global configuration mode (config)
Command History Release Modification
12.2(33)SCG This command was introduced.
Usage Guidelines Use the clear cable bgsync counters command to clear the background synchronization information
statistics on the Cisco CMTS.
Examples The following example shows how to clear the background synchronization counters on the
Cisco uBR10012 router:
Router# configure terminal
Router(config)# clear cable bgsync counters
Router(config)#
Related Commands Command Description
cable bgsync Sets the data intervals for background synchronization on the Cisco CMTS.
cable bgsync active Activates background synchronization process on the Cisco CMTS.
show cable bgsync Displays the information on the background synchronization process.
Cisco IOS CMTS Cable Command Reference
CBL-738 OL-15510-15
Cable Commands: ca through cr
clear cable dsg
clear cable dsg
To reset counters related to DOCSIS Set-top Gateway (DSG) tunnels, use the clear cable dsg command
in privileged EXEC mode.
clear cable dsg
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(15)BC2 This command was introduced for the Cisco uBR7100 series and
Cisco uBR7246VXR routers.
12.3(13a)BC This command is obsolete.
Usage Guidelines DSG operation is disabled using the no cable dsg command, but this does not clear out the DSG-related
counter (“mapping entry is used”), so that you can retain its value in case you intend to restart DSG
operations again. If, however, you want to reset those counters to zero, use the clear cable dsg
command.
Note This command resets the “mapping entry is used” counters for all DSG tunnels and interfaces on the
router.
Examples The following example shows how to clear the DSG counters for all cable interfaces on the router, and
shows an example of the show cable dsg command showing the counters after they have been cleared.
Router# show cable dsg stats
DSG statistics information
DSG keepalive is set
Vendor: DDD, Tunnel count: 1
Vendor: BBB, Tunnel count: 2
Vendor name is DDD, tunnel MAC is 0001.0002.0003
Group address is 226.2.2.2, source address is *
Interface is Cable5/1, mapping entry is used 2
Received 5968 packets, forwarded 5289 packets
Dropped 679 packets, last second rate 16878 bits/sec
Router# clear cable dsg
Router# show cable dsg stats
DSG statistics information
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-739
Cable Commands: ca through cr
clear cable dsg
Vendor: DDD, Tunnel count: 1
Vendor: BBB, Tunnel count: 2
Vendor name is DDD, tunnel MAC is 0001.0002.0003
Group address is 226.2.2.2, source address is *
Interface is Cable5/1, mapping entry is used 0
Received 5968 packets, forwarded 5289 packets
Dropped 679 packets, last second rate 16878 bits/sec
Related Commands Command Description
cable dsg Enables the DOCSIS Set-Top Gateway (DSG) on a cable interface, and
configures its tunnel-mapping parameters.
cable dsg keepalive Enables keepalive messages over DOCSIS Set-Top Gateway (DSG)
tunnels on a cable interface.
debug cable dsg Enables the display of debugging messages for the operation of the
DOCSIS Set-Top Gateway (DSG) feature.
show cable dsg Displays the current DOCSIS Set-Top Gateway (DSG) tunneling
parameters.
Cisco IOS CMTS Cable Command Reference
CBL-740 OL-15510-15
Cable Commands: ca through cr
clear cable flap-list
clear cable flap-list
To reset the flap-list table for a specific CM or for all CMs connected to the Cisco CMTS router, use the
clear cable flap-list command in privileged EXEC mode.
clear cable flap-list {mac-addr | all} [save-counters]
Syntax Description mac-addr Specifies the 48-bit MAC address (hardware address) of an individual
CM to be cleared from the flap-list table.
all Removes all CMs from the flap-list table.
save-counters (Optional) Preserves the flap-list counters that are displayed by the
show cable flap-list command and by using SNMP requests to access
the CISCO-CABLE-SPECTRUM-MIB MIB.
Command Default Clears the flap-list counters.
Command Modes Privileged EXEC (#)
Command History Release Modification
11.3 NA This command was introduced.
11.3(7)NA The save-counters option was supported on the Cisco uBR7200 series
routers.
12.1(5)EC1 Support was added for the Cisco uBR7100 series routers.
12.2(4)BC1 Support for this command (without the save-counters option) was added for
the Cisco uBR10012 router.
12.2(15)BC2 The save-counters option was supported on the Cisco uBR10012 router.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines Cable modems are removed from the flap-list table after the number of days (between 1 and 60) specified
by the cable flap-list aging global configuration command. Use the clear cable flap-list command to
remove individual CMs from the flap-list while retaining flapping activity for other CMs, or to clear the
entire flap-list table.
Examples The following example shows how to remove all the CMs from the flap-list table:
Router# clear cable flap-list all
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-741
Cable Commands: ca through cr
clear cable flap-list
Related Commands Command Description
cable flap-list aging Specifies the number of days to keep a CM in the flap-list
table before aging it out of the table.
cable flap-list insertion-time Sets the insertion time interval that determines whether a
CM is placed in the flap list.
cable flap-list miss-threshold Specifies miss threshold for recording a flap-list event.
cable flap-list power-adjust threshold Specifies the power-adjust threshold for recording a CM
flap-list event.
cable flap-list size Specifies the maximum number of CMs that can be listed in
the flap-list table.
clear cable modem counters Zeroes the CM counters, including flap-list counters.
clear cable modem reset Removes a CM from the Station Maintenance List and resets
it.
debug cable flap Displays information about the operation of the CM flap list
that is maintained for the cable interfaces.
ping docsis Sends a DOCSIS ping to a CM and increments the flap-list
counters as appropriate.
show cable flap-list Displays the current contents of the flap list.
Cisco IOS CMTS Cable Command Reference
CBL-742 OL-15510-15
Cable Commands: ca through cr
clear cable hop
clear cable hop
To clear the forward error corrections (FEC) hop counters on one or all cable interfaces on a
Cisco CMTS, use the clear cable hop command in privileged EXEC mode.
clear cable hop [cable {slot/port | slot/subslot/port} [upstream uport]]
Syntax Description cable slot/port (Optional—Cisco uBR7100 and Cisco uBR7200 Series Routers)
Specifies removal of CMs on the specified cable interface and
downstream port, where:
• slot—Specifies the chassis slot number of the cable interface line
card.
• port—Specifies the downstream port number.
Valid values for these arguments are dependent on your CMTS router
and cable interface line card. Refer to the hardware documentation for
your router chassis and cable interface line card for supported slot and
port numbering.
cable slot/subslot/port (Optional—Cisco uBR10012 Router) Specifies removal of CMs on
the specified cable interface, where:
• slot—Specifies the chassis slot number of the cable interface line
card. Valid slots are 5 to 8.
• subslot—Specifies the secondary slot number of the cable
interface line card. Valid subslots are 0 or 1.
• port—Specifies the downstream port number. Valid ports are 0 to
4, depending on the cable interface line card.
upstream uport (Optional) Clears the hop counters on a specific upstream port on a
specific cable interface. The valid values for uport start with 0 for the
first upstream port on the cable interface line card.
Command Default No default behavior or values
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(15)BC1 This command was introduced.
12.3(BC) This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-743
Cable Commands: ca through cr
clear cable hop
Usage Guidelines The clear cable hop command clears the correctable and uncorrectable forward error corrections (FEC)
counters that are displayed by the show cable hop command. You can clear the counters for all
interfaces on the Cisco CMTS, for one specific interface (one downstream and its associated upstreams),
or for a specific upstream on a cable interface.
Examples The following example shows how to clear the frequency hop counters on all cable interfaces on the
Cisco CMTS, along with sample output from the show cable hop command that shows the counters
being cleared:
Router# show cable hop
Upstream Port Poll Missed Min Missed Hop Hop Corr Uncorr
Port Status Rate Poll Poll Poll Thres Period FEC FEC
(ms) Count Sample Pcnt Pcnt (sec) Errors Errors
Cable3/0/U0 15.008 Mhz 1000 * * *set to fixed frequency * * * 2238 133
Cable3/0/U1 admindown 1000 * * * frequency not set * * * 0 0
Cable3/0/U2 admindown 1000 * * * frequency not set * * * 0 0
Cable3/0/U3 admindown 1000 * * * frequency not set * * * 0 0
Router# clear cable hop
Router# show cable hop
Upstream Port Poll Missed Min Missed Hop Hop Corr Uncorr
Port Status Rate Poll Poll Poll Thres Period FEC FEC
(ms) Count Sample Pcnt Pcnt (sec) Errors Errors
Cable3/0/U0 15.008 Mhz 1000 * * *set to fixed frequency * * * 0 0
Cable3/0/U1 admindown 1000 * * * frequency not set * * * 0 0
Cable3/0/U2 admindown 1000 * * * frequency not set * * * 0 0
Cable3/0/U3 admindown 1000 * * * frequency not set * * * 0 0
Router#
The following example shows how to clear the frequency hop counters on a specific cable interface on
the Cisco CMTS:
Router# clear cable hop c5/0
Router#
The following example shows how to clear the frequency hop counters on a specific upstream on the
Cisco CMTS:
Router# clear cable hop c5/1/0 upstream 2
Router#
Related Commands Command Description
show cable hop Displays cable-hop statistics on a Cisco CMTS.
show cable modem Displays CM configuration settings.
Cisco IOS CMTS Cable Command Reference
CBL-744 OL-15510-15
Cable Commands: ca through cr
clear cable host
clear cable host
To clear the host from the router’s internal address tables, use the clear cable host command in
privileged EXEC mode.
clear cable host {ip-address | mac-address | name fqdn}
Syntax Description ip-address IPv4 or IPv6 address for the device to be cleared.
mac-address MAC address for the device to be cleared.
name fqdn Specifies the fully qualified domain name (FQDN) of the cable device
to be displayed. This option is only available if the show cable
modem domain-name command has been run for the first time to
update the cable DNS cache on the CMTS router.
Command Default No default behavior or values
Command Modes Privileged EXEC (#)
Command History Release Modification
11.3 NA This command was introduced for the Cisco uBR7200 series universal
broadband router.
12.1(5)EC1 Support was added for the Cisco uBR7100 series universal broadband router.
12.2(4)BC1 Support was added for the Cisco uBR10012 universal broadband router.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA, with the
following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was
added.
• The name keyword option was added for specifying the fully-qualified
domain name of a CM.
Usage Guidelines This command removes a host’s IP, MAC address, or domain name from the router’s internal address
tables. This might be necessary to allow a new host to come online from the previous host’s CM.
Note If the cleared host continues communicating through the CM, the Cisco CMTS adds the host back to its
internal address tables, and the show interface cable interface modem command shows it as having a
“static” address. To block the host from any further access, use the cable source-verify dhcp command,
so that the host cannot access the network unless it obtains an IP address from an authorized DHCP
server.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-745
Cable Commands: ca through cr
clear cable host
Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first
on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable
command.
Examples The following example shows how to remove a host’s MAC address from the internal address tables on
the Cisco CMTS router:
Router# clear cable host 0050.7366.17ab
The following example shows how to remove a host’s domain name from the internal address tables on
the Cisco CMTS router:
Router# clear cable host cisco
Related Commands Command Description
cable device Configures the access list for a CM device or host.
cable host access-group Configures the access list for the specified hosts.
show cable device access-group Display the CMs and the hosts behind the CMs on the network.
show cable host access-group Displays only the hosts behind the CMs on the network.
Cisco IOS CMTS Cable Command Reference
CBL-746 OL-15510-15
Cable Commands: ca through cr
clear cable ipc-stats
clear cable ipc-stats
To clear the active database and reset all IPC statistics in the active database to zero, use the clear cable
ipc-stats command in privileged EXEC mode.
clear cable ipc-stats
Syntax Description This command has no arguments or keywords.
Command Default None
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCC This command was introduced in Cisco IOS Release 12.2(33)SCC.
Usage Guidelines You must enable the Cable IPC Statistics Collection tool using the cable ipc-stats command before
using the clear cable ipc-stats command.
Examples The following example shows how to clear the active database using the clear cable ipc-stats command
on a Cisco CMTS router:
Router# clear cable ipc-stats
cr10k ipc stats is cleared at 03:38:54 PDT Fri Oct 9 2009
Router#
Related Commands Command Description
cable ipc-stats Enables the Cable IPC Statistics Collection tool on a Cisco CMTS router.
show cable ipc-stats Displays statistics of all the IPC messages on a Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-747
Cable Commands: ca through cr
clear cable load-balance
clear cable load-balance
To clear the counters or state machine used to track load-balancing operations, use the clear cable
load-balance command in privileged EXEC mode.
clear cable load-balance {counters | state}
Syntax Description counters Clears all load balancing statistical counters.
state Clears all state information in the load balancing state machine. This
command will also put all cable interfaces and their upstream channels in the
“up” state, unless they are explicitly shut down using the shutdown interface
configuration command.
Command Default No default behavior or values
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(15)BC1 This command was introduced for the Cisco uBR7246VXR and
Cisco uBR10012 routers.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Examples The following example shows how to clear all of the counters that track load-balancing operations,
resetting them all to zero:
Router# clear cable load-balance counters
The following example shows how to clear the state machine that is used for load-balancing operations.
Router# clear cable load-balance state
Related Commands Command Description
cable load-balance exclude Excludes a particular cable modem, or all cable
modems from a particular vendor, from one or
more types of load-balancing operations.
cable load-balance group (global configuration) Creates and configures a load-balance group.
cable load-balance group (interface configuration) Assigns a downstream to a load-balance group.
cable load-balance group interval Configures the frequency of the load-balancing
policy updates.
Cisco IOS CMTS Cable Command Reference
CBL-748 OL-15510-15
Cable Commands: ca through cr
clear cable load-balance
Command Description
cable load-balance group policy ugs Configures how the Cisco CMTS should load
balance cable modems with active unsolicited
grant service (UGS) service flows.
cable load-balance group threshold Configures the threshold values that a
load-balance group should use for
load-balancing operations.
cable upstream load-balance group Assigns an upstream to a load-balance group.
show cable load-balance Displays real-time statistical and operational
information for load-balancing operations.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-749
Cable Commands: ca through cr
clear cable logging
clear cable logging
To remove all error messages about bad IP source addresses on the cable interfaces from the error log
buffer, or to clear the downstream index buffer, use the clear cable logging command in privileged
EXEC mode.
clear cable logging {badipsource | downstream-index}
Syntax Description badipsource Clears the log buffer for BADIPSOURCE messages.
downstream-index Clears the log buffer for downstream index messages.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.1(13)EC This command was introduced for the Cisco uBR7100 series and
Cisco uBR7200 series universal broadband routers.
12.2(11)CY Support was added for the Cisco uBR10012 universal broadband router.
12.2(11)BC2 Support was added to the Release 12.2 BC train for the Cisco uBR7100
series, Cisco uBR7200 series, and Cisco uBR10012 routers.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
12.2(33)SCG The downstream-index keyword was added.
Usage Guidelines The cable logging badipsource command creates a circular buffer that contains the BADIPSOURCE
error messages that the Cisco CMTS generates when it discovers a CM or CPE device using an
unauthorized IP address. When the buffer becomes full, the oldest messages are deleted to make room
for newer messages.
When you have viewed all of the error messages in the current buffer, use the clear cable logging
command to clear out the buffer to make room for newer messages.
Examples The following example shows how to clear the log buffer that contains the bad IP source address error
messages:
Router# show cable logging summary
Cable logging: BADIPSOURCE Enabled
Total buffer size (bytes): 1000000
Used buffer size (bytes) : 36968
Logged messages : 231
Router# clear cable logging badipsource
Router# show cable logging summary
Cable logging: BADIPSOURCE Enabled
Total buffer size (bytes): 1000000
Cisco IOS CMTS Cable Command Reference
CBL-750 OL-15510-15
Cable Commands: ca through cr
clear cable logging
Used buffer size (bytes) : 0
Logged messages : 0
Router#
The following example shows how to clear the log buffer that contains the downstream index messages:
Router# show cable logging downstream-index
Cable logging: Enabled
Total buffer size (bytes): 1000000
Used buffer size (bytes) : 36968
Logged messages : 231
Router# clear cable logging downstream-index
Router# show cable logging downstream-index
Cable logging: Enabled
Total buffer size (bytes): 1000000
Used buffer size (bytes) : 0
Logged messages : 0
Router#
Related Commands cable logging badipsource Logs error messages about bad IP source addresses on the cable
interfaces.
cable logging Logs buffer messages about the downstream indexes.
downstream-index
cable source-verify Enables verification of IP addresses for CMs and CPE devices on the
upstream.
show cable logging Displays the log of error and buffer messages on the cable interfaces.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-751
Cable Commands: ca through cr
clear cable modem attribute-masks
clear cable modem attribute-masks
To clear the cable modem attribute masks, use the clear cable modem attribute-masks command in
privileged EXEC mode.
clear cable modem {mac-addr | ip-addr | cable slot/port {all | oui string | reject} } attribute-masks
clear cable modem {mac-addr | ip-addr | cable slot/subslot/port {all | oui string | reject} }
attribute-masks
Syntax Description mac-addr Specifies the MAC address for the CM.
ip-addr Specifies the IP address for the CM.
cable slot/port (Optional—Cisco uBR7100 and Cisco uBR7200 Series Routers) Specifies
removal of CMs on the specified cable interface and downstream port,
where:
• slot—Specifies the chassis slot number of the cable interface line card.
• port—Specifies the downstream port number.
Valid values for these arguments are dependent on your CMTS router and
cable interface line card. Refer to the hardware documentation for your
router chassis and cable interface line card for supported slot and port
numbering.
cable slot/subslot/port (Optional—Cisco uBR10012 Router) Specifies removal of CMs on the
specified cable interface, where:
• slot—Specifies the chassis slot number of the cable interface line card.
Valid slots are 5 to 8.
• subslot—Specifies the secondary slot number of the cable interface line
card. Valid subslots are 0 or 1.
• port—Specifies the downstream port number. Valid ports are 0 to 4,
depending on the cable interface line card.
all Resets the flapping counters for all CMs.
oui string Resets the flapping counters for all CMs that match the specified
Organization Unique Identifier (OUI). The string parameter can be either the
three-byte hexadecimal string (such as 00.00.0C).
reject Resets the flapping counters for all CMs that are currently in one of the reject
states.
attribute-masks Specifies the attribute mask bitmap in hexadecimal format.
Example: 0-FFFFFFFF
Command Default No default behavior or values for this command
Command Modes Privileged EXEC (#)
Cisco IOS CMTS Cable Command Reference
CBL-752 OL-15510-15
Cable Commands: ca through cr
clear cable modem attribute-masks
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines This command clears the cable modem attribute masks.
Examples The following example shows how to clear cable modem attribute masks for CMs:
Router# clear cable modem all attribute-masks
Router# clear cable modem oui SA attribute-masks
Router# clear cable modem c5/0/0 offline attribute-masks
Related Commands Command Description
cable upstream This command specifies an upstream attribute mask in hexadecimal format.
attribute-mask
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-753
Cable Commands: ca through cr
clear cable modem cm-status
clear cable modem cm-status
To reset the cable modem status events to zero, use the clear cable modem cm-status command in
privileged EXEC mode.
Cisco uBR7225VXR and Cisco uBR7246VXR Universal Broadband Routers
clear cable modem [ip address | mac address | cable slot/port] cm-status
Cisco uBR10012 Universal Broadband Router
clear cable modem [ip address | mac address | cable slot/subslot/port] cm-status
Syntax Description ip-address (Optional) IP address of a CM to be displayed. If you specify the IP address
for a CPE device behind a CM, information for that CM is displayed.
mac-address (Optional) MAC address of a CM to be displayed. If you specify the MAC
address for a CPE device behind a CM, information for that CM is displayed.
cable slot/subslot/port (Optional) Cable interface on the Cisco uBR10012 router. The following are
the valid values:
• slot = 5 to 8
• subslot = 0 or 1
• port = 0 to 4 (depending on the cable interface)
cable slot/port (Optional) Displays information for all CMs on the specified cable interface
and downstream port on the Cisco uBR7225VXR and Cisco uBR7246VXR
routers, where:
• slot—Slot where the 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
• port—Specifies the downstream port number.
cm-status Resets the CM status events to zero on the specified cable interface.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCB This command was introduced.
12.2(33)SCC This command was modified to clear the basic receive-statistics of all event
code types for a specific CM or a group of CMs.
12.2(33)SCD This command was modified. Support was added for Cisco uBR7225VXR
and Cisco uBR7246VXR routers.
Cisco IOS CMTS Cable Command Reference
CBL-754 OL-15510-15
Cable Commands: ca through cr
clear cable modem cm-status
Related Commands Command Description
clear cable flap-list Resets the flap-list table for a specific CM or for all CMs.
clear cable modem Removes one or more CMs from the internal address and routing tables on a
delete CMTS router and stops DOCSIS station maintenance messages.
clear cable modem Resets the lock on one or more CMs.
lock
clear cable modem Removes or resets CMs by domain name.
name
clear cable modem Removes one or more CMs from the Station Maintenance List and resets
reset them.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-755
Cable Commands: ca through cr
clear cable modem counters
clear cable modem counters
Note Effective with Cisco IOS Release 12.2(15)BC1, the clear cable modem counters command is replaced
by the clear counters command. See the clear counters command in the Cisco IOS software command
reference documentation for more information.
To reset the cable modem (CM) flap-list counters to zero, use the clear cable modem counters
command in privileged EXEC mode.
clear cable modem {mac-addr | ip-addr | [cable {slot/port | slot/subslot/port]{all | oui string |
reject}} counters
Syntax Description mac-addr Specifies the 48-bit hardware address (MAC address) of an individual
CM.
ip-addr Specifies the IP address of an individual CM.
cable slot/port (Optional—Cisco uBR7100 and Cisco uBR7200 Series Routers)
Specifies removal of CMs on the specified cable interface and
downstream port, where:
• slot—Specifies the chassis slot number of the cable interface line
card.
• port—Specifies the downstream port number.
Valid values for these arguments are dependent on your CMTS router
and cable interface line card. Refer to the hardware documentation for
your router chassis and cable interface line card for supported slot and
port numbering.
cable slot/subslot/port (Optional—Cisco uBR10012 Router) Specifies removal of CMs on the
specified cable interface, where:
• slot—Specifies the chassis slot number of the cable interface line
card. Valid slots are 5 to 8.
• subslot—Specifies the secondary slot number of the cable interface
line card. Valid subslots are 0 or 1.
• port—Specifies the downstream port number. Valid ports are 0 to
4, depending on the cable interface line card.
all Resets the flapping counters for all CMs.
oui string Resets the flapping counters for all CMs that match the specified
Organization Unique Identifier (OUI). The string parameter can be
either the three-byte hexadecimal string (such as 00.00.0C) or a vendor
name that has been defined using the cable modem vendor command.
reject Resets the flapping counters for all CMs that are currently in one of the
reject states. (See the show cable modem command for a description of
these states.)
Command Default No default behavior or values
Cisco IOS CMTS Cable Command Reference
CBL-756 OL-15510-15
Cable Commands: ca through cr
clear cable modem counters
Command Modes Privileged EXEC (#)
Command History Release Modification
12.1 T This command was introduced.
12.2(11)BC2 Support was added for the oui and reject options.
12.2(11)BC3 Support for clearing the counters for a particular cable interface was added.
12.2(15)BC1 This command was replaced by the clear counters command.
Examples The following example shows how to clear the counters for the CM at IP address 172.16.23.45:
Router# clear cable modem 172.16.23.45 counters
The following example shows how to clear the counters for all CMs that have an OUI that has been
defined as having the vendor name of Cisco using the cable modem vendor command:
Router# clear cable modem oui Cisco counters
The following example shows how to clear the counters for all CMs that are currently in one of the reject
states:
Router# clear cable modem reject counters
Note If running Cisco IOS Release 12.2(15)BC1 or later, use the clear cable modem flap-counters command
to clear the CM flap-list counters.
Related Commands Command Description
clear cable flap-list Resets the flap-list table for a specific CM or for all CMs.
clear cable modem delete Removes one or more CMs from the internal address and routing
tables on a CMTS router and stops DOCSIS station maintenance
messages.
clear cable modem flap-counters Resets the CM flap-list counters to zero.
clear cable modem lock Resets the lock on one or more CMs.
clear cable modem reset Removes one or more CMs from the Station Maintenance List and
resets them.
clear counters Resets interface counters and those counters associated with the
show cable modem counters command.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-757
Cable Commands: ca through cr
clear cable modem delete
clear cable modem delete
To remove one or more cable modems (CMs) from the internal address and routing tables on a CMTS
router and stop DOCSIS station maintenance messages, use the clear cable modem delete command in
privileged EXEC mode.
clear cable modem {ip-addr | mac-addr} delete
clear cable modem [cable {slot/port | slot/subslot/port}] {all | non-bonding-capable
[legacy-ranging] | offline | oui string | reject | wideband [registered-traditional-docsis]}
delete
Syntax Description ip-addr Specifies removal of an individual CM by its IPv4 or IPv6 address.
mac-addr Specifies removal of an individual CM by its 48-bit hardware address
(MAC address).
cable slot/port (Optional—Cisco uBR7100 and Cisco uBR7200 Series Routers)
Specifies removal of CMs on the specified cable interface and
downstream port, where:
• slot—Specifies the chassis slot number of the cable interface line
card.
• port—Specifies the downstream port number.
Valid values for these arguments are dependent on your CMTS router
and cable interface line card. Refer to the hardware documentation for
your router chassis and cable interface line card for supported slot and
port numbering.
cable slot/subslot/port (Optional—Cisco uBR10012 Router) Specifies removal of CMs on the
specified cable interface, where:
• slot—Specifies the chassis slot number of the cable interface line
card. Valid slots are 5 to 8.
• subslot—Specifies the secondary slot number of the cable interface
line card. Valid subslots are 0 or 1.
• port—Specifies the downstream port number. Valid ports are 0 to
4, depending on the cable interface line card.
all Specifies removal of all CMs or all CMs associated with a specified
cable interface.
non-bonding-capable Specifies removal of all narrowband CMs that are not capable of
downstream channel bonding or all such CMs associated with a
specified interface.
legacy-ranging (Optional) Specifies removal of narrowband CMs that are accessed with
legacy initial ranging or all such CMs associated with a specified
interface.
offline Specifies removal of all offline CMs or all such CMs associated with a
specified interface.
Cisco IOS CMTS Cable Command Reference
CBL-758 OL-15510-15
Cable Commands: ca through cr
clear cable modem delete
oui string Specifies removal of all CMs that match the specified Organization
Unique Identifier (OUI) or all such CMs associated with a specified
interface. The string parameter can be either the three-byte hexadecimal
string (such as 00.00.0C) or a vendor name that has been defined using
the cable modem vendor command.
reject Specifies removal of all CMs that are currently in one of the reject states
or all such CMs associated with a specified interface. (See the show
cable modem command for a description of these states.)
wideband Specifies removal of all wideband CMs or or all such CMs associated
with a specified interface.
registered-traditional-docs (Optional) Specifies removal of all wideband CMs that are registered as
is traditional DOCSIS CMs or all such CMs associated with a specified
interface.
Command Default No default behavior or values
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(11)BC3 This command was introduced for the Cisco uBR7100 series,
Cisco uBR7200 series, and Cisco uBR10012 universal broadband routers.
12.2(15)BC1 The cable keyword option was added.
12.3(23)BC Support was added for the non-bonding-capable, legacy-ranging,
wideband, and registered-traditional-docsis keyword options.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA, with the
following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM was added.
Usage Guidelines This command removes one or more CMs from the CMTS router memory, which causes the CMTS
router to stop all DOCSIS station maintenance messages for the specified CMs until they time out and
reattempt initial ranging.
Caution The clear cable modem all delete command should normally be used only on a test or lab network. If
used on a large network, it could impact service for a significant period of time, as it would force all
CMs to simultaneously reset and reregister with the Cisco CMTS. In addition, if HCCP N+1 redundancy
has also been configured, using the clear cable modem delete command can trigger a switchover to one
or more Protect interfaces, unless no keepalive has also been configured on the cable interfaces.
Examples The following example shows how to delete the CM at IP address 172.23.45.67:
Router# clear cable modem 172.23.45.67 delete
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-759
Cable Commands: ca through cr
clear cable modem delete
The following example shows how to delete all CMs that have a OUI that has been defined as having
the vendor name of Cisco using the cable modem vendor command:
Router# clear cable modem oui Cisco delete
The following example shows how to delete all CMs that are currently in one of the reject states:
Router# clear cable modem reject delete
Related Commands Command Description
clear cable flap-list Resets the flap-list table for a specific CM or for all CMs.
clear cable modem flap -counters Resets the CM flap-list counters to zero.
clear cable modem lock Resets the lock on one or more CMs.
clear cable modem name Removes or resets CMs by domain name.
clear cable modem reset Removes one or more CMs from the Station Maintenance List
and resets them.
show cable modem Displays information for the registered and unregistered CMs.
Cisco IOS CMTS Cable Command Reference
CBL-760 OL-15510-15
Cable Commands: ca through cr
clear cable modem flap-counters
clear cable modem flap-counters
To reset the cable modem (CM) flap-list counters to zero, use the clear cable modem flap-counters
command in privileged EXEC mode.
clear cable modem {ip-addr | mac-addr} flap-counters
clear cable modem [cable {slot/port | slot/subslot/port}] {all | offline | oui string | reject}
flap-counters
Syntax Description ip-addr Resets the flap-list counters for an individual CM by its IPv4 or IPv6
address.
mac-addr Resets the flap-list counters for an individual CM by its 48-bit hardware
address (MAC address).
cable slot/port (Optional—Cisco uBR7100 and Cisco uBR7200 Series Routers) Resets
the flap-list counters for all CMs on the specified cable interface and
downstream port, where:
• slot—Specifies the chassis slot number of the cable interface line
card.
• port—Specifies the downstream port number.
Valid values for these arguments are dependent on your CMTS router
and cable interface line card. Refer to the hardware documentation for
your router chassis and cable interface line card for supported slot and
port numbering.
cable slot/subslot/port (Optional—Cisco uBR10012 Router) Resets the flap-list counters for
all CMs on the specified cable interface, where:
• slot—Specifies the chassis slot number of the cable interface line
card. Valid slots are 5 to 8.
• subslot—Specifies the secondary slot number of the cable interface
line card. Valid subslots are 0 or 1.
• port—Specifies the downstream port number. Valid ports are 0 to
4, depending on the cable interface line card.
all Resets the flap-list counters for all CMs or all CMs associated with a
specified cable interface.
offline Resets the flap-list counters for all offline CMs or for all such CMs
associated with a specified interface.
oui string Resets the flap-list counters for all CMs that match the specified
Organization Unique Identifier (OUI) or for all such CMs associated
with a specified interface. The string parameter can be either the three
byte hexadecimal string (such as 00.00.0C) or a vendor name that has
been defined using the cable modem vendor command.
reject Resets the flap-list counters for all CMs that are currently in one of the
reject states or for all such CMs associated with a specified interface.
(See the show cable modem command for a description of these states.)
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-761
Cable Commands: ca through cr
clear cable modem flap-counters
Command Default No default behavior or values
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(15)BC1 This command was introduced.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines Use the clear cable modem flap-counters command to reset the flap-list counters associated with the
show cable flap-list command.
This command only resets flap-list counters. To reset other cable interface counters and those counters
associated with the show cable modem counters command, use the clear counters command.
Examples The following example shows how to reset the flap-list counters for the CM at IP address 172.16.23.45:
Router# clear cable modem 172.16.23.45 flap-counters
The following example shows how to reset the flap-list counters for all CMs that have a OUI that has
been defined as having the vendor name of Cisco using the cable modem vendor command:
Router# clear cable modem oui Cisco flap-counters
The following example shows how to reset the flap-list counters for all CMs that are currently in one of
the reject states:
Router# clear cable modem reject flap-counters
Related Commands Command Description
clear cable flap-list Resets the flap-list table for a specific CM or for all CMs.
clear cable modem delete Removes one or more CMs from the internal address and routing tables
on a CMTS router and stops DOCSIS station maintenance messages.
clear cable modem lock Resets the lock on one or more CMs.
clear cable modem name Removes or resets CMs by domain name.
clear cable modem reset Removes one or more CMs from the Station Maintenance List and resets
them.
clear counters Resets interface counters and those counters associated with the show
cable modem counters command.
Cisco IOS CMTS Cable Command Reference
CBL-762 OL-15510-15
Cable Commands: ca through cr
clear cable modem lock
clear cable modem lock
To reset the lock on one or more cable modems (CMs), and to reinitialize them so that they can reregister
with a valid DOCSIS configuration file, use the clear cable modem lock command in privileged EXEC
mode.
clear cable modem {ip-addr | mac-addr} lock
clear cable modem [cable {slot/port | slot/subslot/port] {all | oui string} lock
Syntax Description ip-addr Resets the lock for an individual CM by its IPv4 or IPv6 address.
mac-addr Resets the lock for an individual CM by its 48-bit hardware address
(MAC address).
cable slot/port (Optional—Cisco uBR7100 and Cisco uBR7200 Series Routers) Resets
the lock for all CMs on the specified cable interface and downstream
port, where:
• slot—Specifies the chassis slot number of the cable interface line
card.
• port—Specifies the downstream port number.
Valid values for these arguments are dependent on your CMTS router
and cable interface line card. Refer to the hardware documentation for
your router chassis and cable interface line card for supported slot and
port numbering.
cable slot/subslot/port (Optional—Cisco uBR10012 Router) Resets the lock for all CMs on the
specified cable interface, where:
• slot—Specifies the chassis slot number of the cable interface line
card. Valid slots are 5 to 8.
• subslot—Specifies the secondary slot number of the cable interface
line card. Valid subslots are 0 or 1.
• port—Specifies the downstream port number. Valid ports are 0 to
4, depending on the cable interface line card.
all Resets the lock for all CMs or all CMs associated with a specified cable
interface.
oui string Resets the lock for all CMs that match the specified Organization
Unique Identifier (OUI) or for all such CMs associated with a specified
interface. The string parameter can be either the three-byte hexadecimal
string (such as 00.00.0C) or a vendor name that has been defined using
the cable modem vendor command.
Command Default No default behavior or values
Command Modes Privileged EXEC (#)
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-763
Cable Commands: ca through cr
clear cable modem lock
Command History Release Modification
12.2(15)BC1 This command was introduced.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines When you have configured the cable dynamic-secret lock command on a cable interface, the CMTS
“locks” CMs that use a DOCSIS configuration file that fails the CMTS verification check. These CMs
are allowed to come online, but with a restrictive QoS configuration that limits their service flows to
10 kbps.
Locked CMs are not allowed to reregister with a valid DOCSIS configuration file until they have been
offline, without attempting to reregister, for at least 24 hours. You can manually clear the lock on a CM
by using the clear cable modem lock command in privileged EXEC mode.
The clear cable modem lock command also automatically resets the CMs, so that they will reregister
with the CMTS. If the CMs then reregister with a valid DOCSIS configuration file, the CMTS allows
the CMs to come online with the requested QoS profiles. If the CMs violate the DOCSIS specifications
again, they will be locked again.
Note If a CM is not manually unlocked, it remains locked until it stays offline, without attempting to
reregister, for 24 hours. It can also be unlocked by using the clear cable modem delete command to
manually remove the CM from all of the CMTS internal databases.
Examples The following example shows how to reset the lock for the CM with the MAC address of
0000.0C01.0203:
Router# clear cable modem 0000.0C01.0203 lock
The following example shows how to reset the lock for the CM at IP address 172.16.23.45:
Router# clear cable modem 172.16.23.45 lock
The following example shows how to reset the locks for all CMs that have an OUI that has been defined
as having the vendor name of Cisco using the cable modem vendor command:
Router# clear cable modem oui Cisco lock
Related Commands Command Description
cable dynamic-secret Enables the dynamic shared secret feature, so that DOCSIS
configuration files are verified with a Message Integrity Check
(MIC) that has been created with a dynamically generated shared
secret.
clear cable flap-list Resets the flap-list table for a specific CM or for all CMs.
clear cable modem flap-counters Resets the CM flap-list counters to zero.
clear cable modem delete Removes one or more CMs from the internal address and routing
tables on a CMTS router and stops DOCSIS station maintenance
messages.
Cisco IOS CMTS Cable Command Reference
CBL-764 OL-15510-15
Cable Commands: ca through cr
clear cable modem lock
Command Description
clear cable modem name Removes or resets CMs by domain name.
clear cable modem reset Removes one or more CMs from the Station Maintenance List
and resets them.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-765
Cable Commands: ca through cr
clear cable modem name
clear cable modem name
To remove or reset cable modems (CMs) by domain name, use the clear cable modem name command
in privileged EXEC mode.
clear cable modem name fqdn {delete
Syntax Description fqdn Specifies the fully qualified domain name (FQDN) of the cable device
to be displayed. This option is only available if the show cable modem
domain-name command has been run for the first time to update the
cable Domain Name System (DNS) cache on the CMTS router.
delete Removes the CM with the specified domain name from the Station
Maintenance List.
reset Removes the CM with the specified domain name from the Station
Maintenance List and resets it.
Command Default No default behavior or values
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCA This command was introduced.
12.2(33)SCD This command was modified to remove flap-counters and lock keywords.
Usage Guidelines In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first
on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable
command.
Examples The following example shows how to delete a CM with the domain name “example”:
Router# clear cable modem name example delete
Related Commands Command Description
clear cable flap-list Resets the flap-list table for a specific CM or for all CMs.
clear cable modem flap -counters Resets the CM flap-list counters to zero.
clear cable modem delete Removes one or more CMs from the internal address and
routing tables on a CMTS router and stops DOCSIS station
maintenance messages.
clear cable modem lock Resets the lock on one or more CMs.
Cisco IOS CMTS Cable Command Reference
CBL-766 OL-15510-15
Cable Commands: ca through cr
clear cable modem name
Command Description
clear cable modem reset Removes one or more CMs from the Station Maintenance List
and resets them.
show cable modem Displays information for the registered and unregistered CMs.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-767
Cable Commands: ca through cr
clear cable modem rcs-counts
clear cable modem rcs-counts
To clear the following failure and recovery event counts for all or given RF channels of a CM, use the
clear cable modem rcs-counts command in privileged EXEC mode:
• MAC Domain Descriptor (MDD)
• QAM/forward error correction (FEC)
clear cable modem [cable if | mac_addr | ip_addr] rcs-counts [modular-cable slot/bay/port
nb-channel-number]
Syntax Description cable if (Optional) The name of the downstream interface.
mac-address (Optional) Identifies the MAC address of a CM to be displayed. If you
specify the MAC address for a CPE device behind a CM, information for that
CM is displayed.
ip-address (Optional) Identifies the IP address of a specific CM to be displayed. If you
specify the IP address for a CPE device behind a CM, information for that
CM is displayed.
slot The slot where a SIP resides. On the Cisco uBR10012 router, slots 1 and 3
can be used for SIPs.
bay The bay in a SIP where a SPA is located. Valid values are 0 (upper bay) and
1 (lower bay).
port Specifies the interface number on the SPA.
nb-channel-number Represents the narrowband channel number.
Command Default No default behavior or values.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCB This command was introduced.
Related Commands Command Description
clear cable flap-list Resets the flap-list table for a specific CM or for all CMs.
clear cable modem Removes one or more CMs from the internal address and routing tables on a
delete CMTS router and stops DOCSIS station maintenance messages.
clear cable modem Resets the lock on one or more CMs.
lock
Cisco IOS CMTS Cable Command Reference
CBL-768 OL-15510-15
Cable Commands: ca through cr
clear cable modem rcs-counts
Command Description
clear cable modem Removes or resets CMs by domain name.
name
clear cable modem Removes one or more CMs from the Station Maintenance List and resets
reset them.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-769
Cable Commands: ca through cr
clear cable modem reset
clear cable modem reset
To remove one or more cable modems (CMs) from the Station Maintenance List and reset them, use the
clear cable modem reset command in privileged EXEC mode.
clear cable modem {ip-addr | mac-addr} reset
clear cable modem [cable {slot/port | slot/subslot/port}] {all | non-bonding-capable
[legacy-ranging] | oui string | reject | wideband [registered-traditional-docsis]} reset
Syntax Description ip-addr Specifies removal of an individual CM by its IPv4 or IPv6 address.
mac-addr Specifies removal of an individual CM by its 48-bit hardware address
(MAC address).
cable slot/port (Optional—Cisco uBR7100 and Cisco uBR7200 Series Routers)
Specifies removal of all CMs on the specified cable interface and
downstream port, where:
• slot—Specifies the chassis slot number of the cable interface line
card.
• port—Specifies the downstream port number.
Valid values for these arguments are dependent on your CMTS router
and cable interface line card. Refer to the hardware documentation for
your router chassis and cable interface line card for supported slot and
port numbering.
cable slot/subslot/port (Optional—Cisco uBR10012 Router) Specifies removal of all CMs on
the specified cable interface, where:
• slot—Specifies the chassis slot number of the cable interface line
card. Valid slots are 5 to 8.
• subslot—Specifies the secondary slot number of the cable interface
line card. Valid subslots are 0 or 1.
• port—Specifies the downstream port number. Valid ports are 0 to
4, depending on the cable interface line card.
all Specifies removal of all CMs or all CMs associated with a specified
cable interface.
non-bonding-capable Specifies removal of all narrowband CMs that are not capable of
downstream channel bonding or all such CMs associated with a
specified interface.
legacy-ranging (Optional) Specifies removal of narrowband CMs that are accessed with
legacy initial ranging or all such CMs associated with a specified
interface.
oui string Specifies removal of all CMs that match the specified Organization
Unique Identifier (OUI) or all such CMs associated with a specified
interface. The string parameter can be either the three-byte hexadecimal
string (such as 00.00.0C) or a vendor name that has been defined using
the cable modem vendor command.
Cisco IOS CMTS Cable Command Reference
CBL-770 OL-15510-15
Cable Commands: ca through cr
clear cable modem reset
reject Specifies removal of all CMs that are currently in one of the reject states
or all such CMs associated with a specified interface. (See the show
cable modem command for a description of these states.)
wideband Specifies removal of all wideband CMs or all such CMs associated with
a specified interface.
registered-traditional-docs (Optional) Specifies removal of all wideband CMs that are registered as
is traditional DOCSIS CMs or all such CMs associated with a specified
interface.
Command Default No default behavior or values
Command Modes Privileged EXEC (#)
Command History Release Modification
12.1(2) EC This command was introduced.
12.2(4)BC1 Support was added to the Release 12.2 BC train.
12.2(11)BC2 Support was added for the oui and reject options.
12.2(15)BC1 The cable keyword option was added.
12.3(21)BC Support was added for the wideband and registered-traditional-docsis
keyword options.
12.3(23)BC Support was added for the non-bonding-capable and legacy-ranging
keyword options.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA, with the
following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM was added.
Usage Guidelines This command instructs the Cisco CMTS to stop sending DOCSIS station maintenance messages to one
or more CMs, which effectively terminates the link to those CMs until those CMs time out and reattempt
initial ranging. A CM responds to this by resetting itself. Depending on when the CM received the last
station maintenance message, it can take up to 30 seconds before the CM detects the missing station
maintenance messages and resets itself.
If the clear cable modem {ip-address | mac-address} reset form of the command is used to reset an
individual modem, the CMTS router sends a ranging abort message to the specified modem in order to
command the modem to reset itself and begin initial ranging more quickly without having to wait for up
to 30 seconds to realize it is no longer receiving station maintenance keep-alive opportunities. This
behavior is only seen when using the clear cable modem reset command for a specific CM.
Tip You can also specify the MAC address or IP address for a CPE device or host, and the Cisco CMTS
resets the CM that is associated with that CPE device in its internal database.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-771
Cable Commands: ca through cr
clear cable modem reset
In some circumstances, the customer premises equipment (CPE) device behind a CM stops receiving
traffic after the CM is reset. This is because the CMTS still has the CPE device listed in its address
tables, but the CM does not after being reset, so the traffic passes through the CMTS but is dropped by
the CM. To resolve this situation, the CPE device should simply send some type of traffic to the CM,
such as a ping packet. (You can also resolve this situation by using the clear arp-cache command on
the Cisco CMTS router to clear the router’s address table, but this is not recommended because it
temporarily interrupts all traffic on the router.)
Caution The clear cable modem all reset command should normally be used only on a test or lab network. If
used on a large network, it could impact service for a significant period of time, as it would force all
CMs to simultaneously reset and reregister with the Cisco CMTS.
Note The clear cable modem all reset command can result in the CPU utilization temporarily reaching
100 percent for a couple of minutes, as the CPU processes the command for all CMs. The CPU
utilization will return to normal within a couple of minutes.
Examples The following example shows how to reset the CM at IP address 172.23.45.67:
Router# clear cable modem 172.23.45.67 reset
The following example shows how to reset all CMs that have an OUI that has been defined as having
the vendor name of Cisco using the cable modem vendor command:
Router# clear cable modem oui Cisco reset
The following example shows how to reset all CMs that are currently in one of the reject states:
Router# clear cable modem reject reset
For the Cisco uBR10012 router, the following example shows how to reset all wideband CMs that are
registered as traditional DOCSIS modems:
Router# clear cable modem wideband registered-traditional-docsis reset
Related Commands Command Description
clear cable flap-list Resets the flap-list table for a specific CM or for all CMs.
clear cable modem flap-counters Resets the CM flap-list counters to zero.
clear cable modem delete Removes one or more CMs from the internal address and routing
tables on a CMTS router and stops DOCSIS station maintenance
messages.
clear cable modem lock Resets the lock on one or more CMs.
clear cable modem name Removes or resets CMs by domain name.
show cable modem Displays information for registered and unregistered CMs.
Cisco IOS CMTS Cable Command Reference
CBL-772 OL-15510-15
Cable Commands: ca through cr
clear cable modem rf-adapt
clear cable modem rf-adapt
To clear RF adaptation candidates or history information of the cable modems, use the clear cable
modem rf-adapt command in privileged EXEC mode.
clear cable modem {ip-addr | mac-addr | [cable {slot/cable-interface-index |
slot/subslot/cable-interface-index}] {all | offline | reject | oui string}} rf-adapt {candidates
[downgrade | upgrade] | history}
Syntax Description ip-addr IPv4 or IPv6 address of the cable modem.
mac-addr 48-bit MAC address of the cable modem.
cable Specifies the cable interface line card details.
• slot—Slot where the cable interface line card resides.
• subslot—(Cisco uBR10012 only) Secondary slot number of the
cable interface line card.
• cable-interface-index—Downstream port number or MAC domain
index of the cable interface line card.
Table 25 displays the valid values for these arguments.
all Clears the RF adaptation history or candidate status of all cable
modems.
offline Clears the RF adaptation history or candidate status of all offline cable
modems.
reject Clears the RF adaptation history or candidate status of all cable modems
in reject state.
oui string Clears the RF adaptation history or candidate status of the cable
modems that match the specified Organization Unique Identifier (OUI)
or for all cable modems associated with a specified interface. The string
parameter can be either the three byte hexadecimal string (such as
00.00.0C) or a vendor name that has been defined using the
cable modem vendor command.
candidates Clears RF adaptation candidates.
downgrade (Optional) Clears RF adaptation downgrade candidates.
upgrade (Optional) Clears RF adaptation upgrade candidates.
history Clears RF adaptation history.
Command Default None
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCF3 This command was introduced.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-773
Cable Commands: ca through cr
clear cable modem rf-adapt
Usage Guidelines Use the clear cable modem rf-adapt history command to remove the history of all RF adaptation
relocations for a given cable modem.
Use the clear cable modem rf-adapt candidates command to change the status of a cable modem or
group of cable modems that are RF adaptation relocation candidates.
Using the clear cable modem rf-adapt history and clear cable modem rf-adapt candidates
commands do not affect the MAC state of the cable modem.
Table 25 displays the interface density information.
Table 25 Interface Density Information
Cable
Interface
CMTS Router Line Card Slot Subslot Port Index
Cisco uBR10012 Cisco uBR-MC3GX60V 5 to 8 0 or 1 0 or 4 0 to 14
Cisco UBR-MC20X20V 0 to 4
Cisco uBR10-MC5X20
Cisco uBR7225VXR All 1 or 2 0 or 1 0 or 1 —
Cisco uBR7246VXR All 3 to 6 0 or 1 0 or 1 —
Examples The following example shows how to reset the RF adaptation history for the cable modem at IP address
192.0.2.255:
Router# clear cable modem 192.0.2.255 rf-adapt history
The following example shows how to reset the RF adaptation downgrade candidates for all cable
modems:
Router# clear cable modem all rf-adapt candidates downgrade
Associated Features The clear cable modem rf-adapt command is used to configure the
Cable Modem Upstream RF Adaptation feature.
Related Commands Command Description
show cable modem Displays the RF adaptation history.
rf-adapt
show cable rf-adapt Displays RF adaptation information of upgrade and downgrade
candidates.
Cisco IOS CMTS Cable Command Reference
CBL-774 OL-15510-15
Cable Commands: ca through cr
clear cable modem service-type-id
clear cable modem service-type-id
To clear the cable modem service type id, use the clear cable modem service-type-id command in
privileged EXEC mode.
clear cable modem {ip | mac | name domain name | [interface] {all | offline | oui oui | reject |
wideband | none-bounding-capable }} service-type-id
Syntax Description ip Specifies removal of an individual CM by its IPv4 or IPv6 address.
mac Specifies removal of an individual CM by its 48-bit hardware address (MAC
address).
name domain name Specifies the domain name of the cable modem.
interface (Optional) Resets the attribute masks of the offline CMs.
all Specifies removal of all CMs or all CMs associated with a specified cable
interface.
offline Specifies removal of all offline CMs or all such CMs associated with a
specified interface.
oui oui Specifies removal of all CMs that match the specified Organization Unique
Identifier (OUI) or all such CMs associated with a specified interface. The
string parameter can be either the three-byte hexadecimal string (such as
00.00.0C) or a vendor name.
reject Specifies removal of all CMs that are currently in one of the reject states or
all such CMs associated with a specified interface.
wideband Specifies removal of all wideband CMs or all such CMs associated with a
specified interface.
none-bounding-capabl Specifies removal of all narrowband CMs that are not capable of
e downstream channel bonding or all such CMs associated with a specified
interface.
service-type-id Specifies the service type identifier.
Command Default No default behavior or values for this command
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines This command clears the CM’s service type id.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-775
Cable Commands: ca through cr
clear cable modem service-type-id
Examples The following example shows how to clear cable modem service type id:
Router# clear cable modem all service-type-id
Router# clear cable modem oui SA service-type-id
Router# clear cable modem c5/0/0 offline service-type-id
Related Commands Command Description
clear cable modem This command clears the cable modem attribute masks.
attribute-masks
show cable modem Displays the modems having service type id.
service-type-id
Cisco IOS CMTS Cable Command Reference
CBL-776 OL-15510-15
Cable Commands: ca through cr
clear cable modem voice
clear cable modem voice
To clear the voice tag that is set for a cable modem (CM), use the clear cable modem voice command
in privileged EXEC mode.
clear cable modem {ip-addr | mac-addr} voice {retries | tag}
clear cable modem [cable slot/subslot/port] {all | offline | oui string | reject} voice{retries | tag}
Syntax Description ip-addr Specifies removal of an individual CM by its IPv4 or IPv6 address.
mac-addr Specifies removal of an individual CM by its 48-bit hardware address (MAC
address).
retries Clears the CM downstream retries record.
tag Clears the CM voice tag.
cable slot/subslot/port (Optional—Cisco uBR10012 Router) Specifies clearing of voice tags for
CMs on the specified cable interface, where:
• slot—Specifies the chassis slot number of the cable interface line card.
Valid slots are 5 to 8.
• subslot—Specifies the secondary slot number of the cable interface line
card. Valid subslots are 0 or 1.
• port—Specifies the downstream port number. Valid ports are 0 to 4,
depending on the cable interface line card.
all Specifies clearing of voice tags for all CMs or all CMs associated with a
specified cable interface.
offline Specifies clearing of voice tags for all offline CMs or all such CMs
associated with a specified interface.
oui string Specifies clearing of voice tags for all CMs that match the specified
Organization Unique Identifier (OUI) or all such CMs associated with a
specified interface. The string parameter can be either the three byte
hexadecimal string (such as 00.00.0C) or a vendor name that has been
defined using the cable modem vendor command.
reject Specifies clearing of voice tags for all CMs that are currently in one of the
reject states or all such CMs associated with a specified interface. (See the
show cable modem command for a description of these states).
Command Default No default behavior or values
Command Modes Privileged EXEC (#)
Command History Release Modification
12.3(23)BC This command was introduced for the Cisco uBR10012 router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-777
Cable Commands: ca through cr
clear cable modem voice
Examples The following example shows how to clear the voice tag and retries record for the CM at IP
address 172.16.23.45:
Router# clear cable modem 172.16.23.45 voice retries
Related Commands Commands Description
show cable modem voice Displays the detected voice-enabled modems.
test cable voice Allows you to manually set the voice tag of a cable modem.
Cisco IOS CMTS Cable Command Reference
CBL-778 OL-15510-15
Cable Commands: ca through cr
clear cable multicast statistics counter
clear cable multicast statistics counter
To reset all multicast statistics counters, use the clear cable multicast statistics counter command in
privileged EXEC mode.
clear cable multicast statistics counter
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCF This command was introduced.
Usage Guidelines The counters are also set to zero when a given multicast resource is reconfigured. Counters are displayed
using the show cable multicast statistics command.
Examples The following example shows how to reset configured multicast statistics index allocation details to
zero:
Router# clear cable multicast statistics counter
Router#
Related Commands Command Description
show cable multicast Displays the multicast statistics index allocation details.
statistics
show cable multicast Displays the contents of the multicast explicit tracking database.
db
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-779
Cable Commands: ca through cr
clear cable rf-status
clear cable rf-status
To reset flap counts and flap time for all or a given RF channel, use the clear cable rf-status command
in privileged EXEC mode.
clear cable rf-status [modular-cable slot/bay/port nb-channel-number]
Syntax Description slot The slot where a SIP resides. On the Cisco uBR10012 router, slots 1 and 3
can be used for SIPs.
bay The bay in a SIP where a SPA is located. Valid values are 0 (upper bay) and
1 (lower bay).
port Specifies the interface number on the SPA.
nb-channel-number Represents the narrowband channel number.
Command Default No default behavior or values.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCB This command was introduced.
Related
Commands Command Description
clear cable flap-list Resets the flap-list table for a specific CM or for all CMs.
clear cable modem Removes one or more CMs from the internal address and routing tables on a
delete CMTS router and stops DOCSIS station maintenance messages.
clear cable modem Resets the lock on one or more CMs.
lock
clear cable modem Removes or resets CMs by domain name.
name
clear cable modem Removes one or more CMs from the Station Maintenance List and resets
reset them.
Cisco IOS CMTS Cable Command Reference
CBL-780 OL-15510-15
Cable Commands: ca through cr
clear cable secondary-ip
clear cable secondary-ip
To clear the router’s table that links secondary IP addresses to the devices that use them, use the clear
cable secondary-ip command in privileged EXEC mode.
clear cable secondary-ip interface cable {slot/port | slot/subport/port}[all | sid sid [ip-address]]
Syntax Description slot/port (Cisco uBR7100 and Cisco uBR7200 Series Routers) Specifies the
cable interface and downstream port, where:
• slot—Specifies the chassis slot number of the cable interface
line card.
• port—Specifies the downstream port number.
Valid values for these arguments are dependent on your CMTS
router and cable interface line card. Refer to the hardware
documentation for your router chassis and cable interface line card
for supported slot and port numbering.
slot/subslot/port Cisco uBR10012 Router) Specifies the cable interface, where:
• slot—Specifies the chassis slot number of the cable interface
line card. Valid slots are 5 to 8.
• subslot—Specifies the secondary slot number of the cable
interface line card. Valid subslots are 0 or 1.
• port—Specifies the downstream port number. Valid ports are 0
to 4, depending on the cable interface line card.
all Specifies that all IP addresses in the secondary IP address table
should be cleared.
sid sid Specifies that all IP addresses for a particular Service ID (SID)
should be cleared. The valid range is 1 to 8191.
ip-address (Optional) Specifies that the IP address for a particular CM or CPE
device should be cleared.
Command Default No default behavior or values
Command Modes Privileged EXEC (#)
Command History Release Modification
12.1(13)EC This command was introduced for the Cisco uBR7100 series and
Cisco uBR7200 series universal broadband routers.
12.2(11)BC1 Support was added for the Cisco uBR10012 universal broadband router.
12.2(11)BC2 This command was removed because it is no longer needed, because of
database changes.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-781
Cable Commands: ca through cr
clear cable secondary-ip
Release Modification
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines To support BPI and BPI+ operations with CMs and CPE devices that use secondary IP addresses, the
CMTS maintains a database that links the known secondary IP addresses to the SIDs used by those
devices. When the CMTS and CM need to renew their public keys, the CMTS uses this database to
ensure that all IP addresses are sufficiently updated to allow proper routing and fast switching.
Tip You can display the list of known IP addresses per SID by using the show interface cable sid command.
If you encounter apparent problems with secondary IP addressing, or if you want to manually clear the
table of IP addresses for a particular SID, use the clear cable secondary-ip command.
Tip One possible situation that might occur is if a CM first assigns a secondary IP address to one CPE device,
but later that same IP address is assigned to another CPE device behind a different CM. If this happens,
the IP address will continue to show up as a secondary IP address for the original CM until that CM
renews its public keys. This will not affect network connectivity for either CPE or CM. You can,
however, clear the unneeded secondary IP address from the CMTS database using the clear cable
secondary-ip command.
Examples The following example shows how to clear all of the secondary IP addresses for a particular cable
interface:
Router# clear cable secondary-ip interface cable 3/0 all
The following example shows how to clear the secondary IP addresses for all CM and CPE devices on
cable interface 1/0 that are using SID 5:
Router# clear cable secondary-ip interface cable 1/0 sid 5
The following example shows how to clear the secondary IP addresses for the CM and CPE devices on
cable interface 5/0 that are using SID 113 and IP address 10.10.17.3:
Router# clear cable secondary-ip interface cable 5/0 sid 113 10.10.17.3
Related Commands Command Description
show interface cable sid Displays information for a particular SID, including the known secondary
IP addresses.
Cisco IOS CMTS Cable Command Reference
CBL-782 OL-15510-15
Cable Commands: ca through cr
clear cable modem service-type-id
clear cable modem service-type-id
To clear the cable modem service type id, use the clear cable modem service-type-id command in
privileged EXEC mode.
clear cable modem {ip | mac | name domain name | [interface] {all | offline | oui oui | reject |
wideband | none-bounding-capable }} service-type-id
Syntax Description ip Specifies removal of an individual CM by its IPv4 or IPv6 address.
mac Specifies removal of an individual CM by its 48-bit hardware address (MAC
address).
name domain name Specifies the domain name of the cable modem.
interface (Optional) Resets the attribute masks of the offline CMs.
all Specifies removal of all CMs or all CMs associated with a specified cable
interface.
offline Specifies removal of all offline CMs or all such CMs associated with a
specified interface.
oui oui Specifies removal of all CMs that match the specified Organization Unique
Identifier (OUI) or all such CMs associated with a specified interface. The
string parameter can be either the three-byte hexadecimal string (such as
00.00.0C) or a vendor name.
reject Specifies removal of all CMs that are currently in one of the reject states or
all such CMs associated with a specified interface.
wideband Specifies removal of all wideband CMs or all such CMs associated with a
specified interface.
none-bounding-capabl Specifies removal of all narrowband CMs that are not capable of
e downstream channel bonding or all such CMs associated with a specified
interface.
service-type-id Specifies the service type identifier.
Command Default No default behavior or values for this command
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines This command clears the CM’s service type id.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-783
Cable Commands: ca through cr
clear cable modem service-type-id
Examples The following example shows how to clear cable modem service type id:
Router# clear cable modem all service-type-id
Router# clear cable modem oui SA service-type-id
Router# clear cable modem c5/0/0 offline service-type-id
Related Commands Command Description
clear cable modem This command clears the cable modem attribute masks.
attribute-masks
show cable modem Displays the modems having service type id.
service-type-id
Cisco IOS CMTS Cable Command Reference
CBL-784 OL-15510-15
Cable Commands: ca through cr
clear facility-alarm
clear facility-alarm
To clear alarm conditions and rest the alarm contacts, use the clear facility-alarm command in
privileged EXEC mode.
clear facility-alarm [critical | major | minor | source pem {0 | 1}]
Syntax Description critical (Optional) Clears all critical alarms.
major (Optional) Clears all major alarms.
minor (Optional) Clears all minor alarms.
source pem {0 | 1} (Optional–Cisco uBR10012 only) Clears all alarms for either the first or
second Power Entry Module (PEM).
Defaults If specified without any options, clears all facility alarms.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.0(17)SL This command was introduced on the Cisco 10000 series router.
12.2(1)XF1 This command was introduced for the Cisco uBR10012 router.
12.2(16)BX This command was introduced on the PRE2.
12.2(31)SB2 This command was introduced on the PRE3 for the Cisco 10000 series
router.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
Usage Guidelines The clear facility-alarm command clears the contacts to an external alarm panel. Only a reoccurrence
of the original alarm source after the original alarm condition is removed can restart the audible alarm.
These alarms are displayed by the show facility-alarm status command.
The alarm LEDs remain lit on the Performance Routing Engine (PRE) as long as the alarm condition
continues and is not cleared by the clear facility-alarm command. An alarm can only be removed from
the list by correcting the issue that is triggering the alarm.
Examples The following example shows how to clear all facility alarms on the router:
Router# clear facility-alarm
Clearing all alarms
The following example shows how to clear all critical facility alarms on the router:
Router# clear facility-alarm critical
Clearing critical alarms
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-785
Cable Commands: ca through cr
clear facility-alarm
The following example shows how to clear minor facility alarms only:
Router# clear facility-alarm minor
Clearing minor alarms
Cisco uBR10012 Universal Broadband Router
The following example shows how to clear all alarms for both PEM modules on a Cisco uBR10012
universal broadband router:
Router# clear facility-alarm source pem 0
Router# clear facility-alarm source pem 1
Related Commands Command Description
facility-alarm Sets the temperature thresholds at which the processor generates a critical,
major, or minor alarm to warn of potential equipment damage.
show facility-alarm Displays the current temperature thresholds that will trigger a facility
status alarm.
Cisco IOS CMTS Cable Command Reference
CBL-786 OL-15510-15
Cable Commands: ca through cr
clear hccp counters
clear hccp counters
To reset the counters for one or all Hot Standby Connection-to-Connection Protocol (HCCP) groups, use
the clear hccp counters command in privileged EXEC mode.
clear hccp [group | all] counters
Syntax Description group Clears the counters for the specified group number. The valid range is 1 to
255.
all Clears the counters for all HCCP groups.
Command Default No default behavior or values.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.1(3a)EC This command was introduced for the Cisco uBR7200 series routers.
12.1(7)EC1 Support was added for the Cisco uBR-MC16S cable interface line card.
12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012
12.2(4)BC1 router and Cisco uBR-LCP-MC28C card.
12.2(8)BC2 Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012
router and Cisco uBR-LCP-MC16C, Cisco uBR-LCP-MC16E, and
Cisco uBR-LCP-MC16S cards.
12.2(11)BC1 Support was added for the N+1 (1:n) RF Switch with the
Cisco uBR7246VXR router and Cisco uBR-MC16C, Cisco uBR-MC16S,
and Cisco uBR-MC28C cards.
12.3(21)BC This command is obsolete on the Cisco uBR7246VXR router.
Usage Guidelines This command clears the counters that are displayed by the show hccp and show hccp interface
commands. You can clear the counters for a single HCCP group, or all HCCP groups.
Examples The following example shows the counters for group 1 being reset to 0:
Router# clear hccp 1 counters
The following example shows the counters for all groups being reset to 0:
Router# clear hccp all counters
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-787
Cable Commands: ca through cr
clear hccp counters
Related Commands Command Description
hccp working Designates a cable interface on a CMTS in the specified group to be a
Working CMTS.
show hccp Displays information for all cable interfaces on which one or more HCCP
groups and authentication modes have been configured.
show hccp interface Displays group information for a specific cable interface on which one or
more groups and authentication modes have been configured.
Cisco IOS CMTS Cable Command Reference
CBL-788 OL-15510-15
Cable Commands: ca through cr
clear hccp linecard
clear hccp linecard
To clear information about the Hot Standby Connection-to-Connection Protocol (HCCP) startup and
switchover flow and unused events associated with cable line cards, use the clear hccp linecard
command in privileged EXEC mode.
clear hccp linecard {fsm | nullfsm} buffer
Syntax Description fsm The HCCP state transition flow (startup and switchover flow). Each line
card member in an HCCP group is controlled by a state machine, which
controls the HCCP startup and switchover flow.
nullfsm The HCCP members that received unused or redundant events. This option
is used only for debugging.
buffer Buffer for saving HCCP state transition flow.
Command Default None
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCE This command was introduced.
Examples The following example shows how to clear entries for the HCCP startup and switchover flow using the
clear hccp linecard command on a Cisco CMTS router:
Router# clear hccp linecard fsm buffer
Related Commands Command Description
show hccp interface Displays group information for a specific cable interface on which one or
more groups and authentication modes have been configured.
show hccp linecard Displays line card level HCCP group information.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-789
Cable Commands: ca through cr
clear packetcable rks
clear packetcable rks
To clear the record keeping server (RKS) entries when there are no calls associated with the RKS server,
use the clear packetcable rks command in privileged EXEC mode.
clear packetcable rks {ip_addr ip_addr {port} | all}
Syntax Description ip_addr ip_addr Indicates the IP address of the RKS server to be cleared.
port Indicates the UDP port of the RKS server to be cleared.
all Indicates that information about all RKS servers will be cleared.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCD This command was introduced.
Usage Guidelines The clear packetcable rks command is used to clear the unwanted IP addresses of the RKS servers from
the RKS server group list.
Note This command clears the IP addresses of only those RKS servers that are currently not being used. In
other words, if the reference count of an RKS server is a non-zero value, that entry will not cleared from
the RKS server group list.
Tip You can verify the value of reference count (ref-cnt) by executing the show packetcable event
command with the rks-group keyword.
Examples The following sample shows how to clear the the RKS server with IP address 2.39.26.8 on port 1816:
router# clear packetcable rks ip_addr 2.39.26.8 1816
The following sample shows how to clear the entries of all RKS servers:
router# clear packetcable rks all
Related Commands Command Description
show packetcable Displays information about the servers that are configured on the Cisco
event CMTS router for PacketCable operations.
Cisco IOS CMTS Cable Command Reference
CBL-790 OL-15510-15
Cable Commands: ca through cr
clear packetcable gate counter commit
clear packetcable gate counter commit
To clear the specified gate counter for PacketCable Multimedia (PCMM) or Dynamic Quality of Service
(DQoS) for PC, use the clear packetcable gate counter commit command in Privileged EXEC mode.
clear packetcable gate counter commit [dqos | multimedia]
Syntax Description dqos Clears PC DQoS gate counters.
multimedia Clears PCMM gate counters.
Command Default The committed gate counter is reset to zero by default with router restart, and gates are not cleared
periodically by default.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(8)BC2 This command was introduced for the Cisco uBR7200 series universal
broadband router.
12.2(15)BC1 Support was added for the Cisco uBR10012 router.
12.3(13a)BC This command was modified to support PCMM on the Cisco uBR10012
router and the Cisco uBR7246VXR router. The dqos and multimedia
keywords were added.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines This command is used to reset the gate counter being used to track the total number of committed gates.
The CMTS router maintains a count of the total number of gates committed from the router’s last startup.
This command can be used to either clear all the gate commit counts, or to specifically clear the counts
for DQoS- or multimedia-based gates.
A show command is used to display the total number of gates committed on the CMTS.
Examples The following example shows the committed gate counter being reset to zero:
Router# clear packetcable gate counter commit
Related Commands Command Description
packetcable authorize Allows non-DQoS MTAs to send DOCSIS DSX messages.
vanilla-docsis-mta
packetcable gate maxcount Sets the maximum number of PCMM gates in the gate
database.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-791
Cable Commands: ca through cr
clear packetcable gate counter commit
Command Description
packetcable multimedia Enables and displays PacketCable Multimedia processing on
the Cisco CMTS.
packetcable timer multimedia T1 Sets the default timeout value for T1timer used in PCMM gate
processing.
Cisco IOS CMTS Cable Command Reference
CBL-792 OL-15510-15
Cable Commands: ca through cr
clear pxf
clear pxf
To clear Parallel eXpress Forwarding (PXF) counters and statistics, use the clear pxf command in
privileged EXEC mode.
clear pxf [dma counters | interface interface | statistics {context | diversion | drop | ip | ipv6} | xcm
counters]
Syntax Description dma counters (Optional) Clears the direct memory access (DMA) PXF counters.
interface interface (Optional) Clears the PXF counters on the specified interface.
statistics (Optional) Type of PXF statistics to clear. The options are:
• context—Current and historical loads on the PXF.
• diversion—Traffic diverted from the PXF.
• drop—Dropped packets and bytes.
• ip— IP and ICMP statistics.
• ipv6—IPv6 statistics.
xcm counters Clears the PXF Error Code Correction (ECC) counters.
Command Default No default behavior or values
Command Modes Privileged EXEC (#)
Command History Release Modification
12.0(22)S This command was introduced on the Cisco 10000 series router.
12.2(1)XF1 This command was introduced on the Cisco uBR10012 router.
12.2(4)XF1 The xcm counters option was introduced to support the Performance
Routing Engine (PRE1) module on the Cisco uBR10012 router.
12.3(7)XI1 This command was integrated into Cisco IOS Release 12.3(7)XI1.
12.3BC This command was integrated into Cisco IOS Release 12.3BC. The context
and ipv6 keyword options are not supported.
12.2(31)SB This command was integrated into Cisco IOS Release 12.2(31)SB.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. The
ipv6 keyword option is not supported.
Usage Guidelines If no interface is specified, the command clears PXF counters on all interfaces. The clear pxf command
clears counters associated with the show pxf dma, show pxf interface, show pxf statistics, and show
pxf xcm commands.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-793
Cable Commands: ca through cr
clear pxf
Cisco uBR10012 Universal Broadband Router
Not all keyword options are supported in the Cisco IOS software for the Cisco uBR10012 universal
broadband router. See the command history table for the unsupported keyword options by release.
The clear pxf xcm counters command is supported only on the PRE1 and later processors for the
Cisco uBR10012 router. This command is not supported on the PRE processor.
Examples The following example clears PXF statistics for serial interface 1/0/0:
Router# clear pxf interface serial 1/0/0
The following example clears PXF statistics on all interfaces:
Router# clear pxf interface
Related Commands Command Description
show pxf cpu statistics Displays PXF CPU statistics.
show pxf dma Displays the current state of DMA buffers, error counters, and registers on the
PXF engine.
show pxf interface Displays a summary of the statistics accumulated by column 0 of the PXF
for an interface.
show pxf statistics Displays chassis-wide, summary PXF statistics.
show pxf xcm Displays PXF XCM information.
Cisco IOS CMTS Cable Command Reference
CBL-794 OL-15510-15
Cable Commands: ca through cr
clear pxf statistics drl cable-wan-ip
clear pxf statistics drl cable-wan-ip
To clear the PXF DRL cable/wan-ip statistics table, use the clear pxf statistics drl cable-wan-ip
command in privileged EXEC mode.
clear pxf statistics drl cable-wan-ip
Syntax Description This command has no arguments or keywords.
Command Default No default behavior or values.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines This command sets the drop count to zero for all entries in the PXF DRL cable/wan-ip statistics table. It
does not change any other value.
Examples The following example shows how to clear cable-wan-ip statistics:
Router# clear pxf statistics drl cable-wan-ip
Related Commands Command Description
clear pxf statistics drl This command set the drop count to zero for all entries in the PXF DRL
wan-non-ip wan-non-ip statistics table.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-795
Cable Commands: ca through cr
clear pxf statistics drl wan-non-ip
clear pxf statistics drl wan-non-ip
To clear the PXF DRL wan-non-ip statistics, use the clear pxf statistics drl wan-non-ip command in
privileged EXEC mode.
clear pxf statistics drl wan-non-ip
Syntax Description This command has no arguments or keywords.
Command Default No default behavior or values.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines This command sets the drop count to zero for all entries in the PXF DRL wan-non-ip statistics table.
Examples The following example shows how to clear the PXF statistics in wan-non-ip:
Router# clear pxf statistics drl wan-non-ip
Related Commands Command Description
clear pxf statistics drl This command sets the drop count to zero for all entries in the cable or
cable-wan-ip wan-ip statistics table.
Cisco IOS CMTS Cable Command Reference
CBL-796 OL-15510-15
Cable Commands: ca through cr
clear redundancy
clear redundancy
To clear the counters and history information that are used by the Redundancy Facility (RF) subsystem,
use the clear redundancy command in privileged EXEC mode.
clear redundancy {counters | history}
Syntax Description counters Clears the RF counters that are maintained by the RF subsystem.
history Clears the history of RF activity that is maintained by the RF subsystem.
Defaults No default behavior or values
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(4)XF1 This command was introduced for the Cisco uBR10012 router.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
Usage Guidelines The clear redundancy command clears the following information, which is shown by the show
redundancy command:
• counters—Number of messages sent and received, buffers used, and synchronization errors.
• history—RF subsystem activity, such as checkpoint messages sent between RF clients.
Examples The following example shows how to clear the RF counters that are displayed by the show redundancy
command:
Router# clear redundancy counters
The following example shows how to clear the RF history information that is displayed by the show
redundancy command:
Router# clear redundancy history
Related Commands Command Description
show redundancy Displays the current redundancy state.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-797
Cable Commands: ca through cr
controller integrated-cable
controller integrated-cable
To enter controller configuration mode to configure the controller interface for an integrated
DOCSIS 3.0 cable interface line card, use the controller integrated-cable command in global
configuration mode.
Cisco uBR10012 Router
controller integrated-cable slot/subslot/port
Cisco uBR7225VXR and Cisco uBR7246VXR Routers
controller integrated-cable slot/port
Syntax Description integrated-cable Identifies the cable interface on the Cisco uBR10012 router.
slot/subslot/port
• slot—Slot where the line card resides. The valid range is from 5 to 8.
• subslot—Subslot where the line card resides. Available slots are 0 or 1.
• port—Downstream controller number on the line card. Valid port values
are from 0 to 4.
integrated-cable Identifies the cable interface on the Cisco uBR7246VXR or
slot/port Cisco uBR7225VXR router.
• slot—Slot where the 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.
• port—Downstream port number on the line card. The valid port value is
0 or 1.
Command Default None
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced.
12.2(33)SCD This command was modified to support configuration of the controller
interface on Cisco uBR7246VXR and Cisco uBR7225VXR universal
broadband routers.
Cisco IOS CMTS Cable Command Reference
CBL-798 OL-15510-15
Cable Commands: ca through cr
controller integrated-cable
Examples The following example shows how to enter controller configuration mode to configure the controller
interface in slot 5, subslot 1, and port 0 of the Cisco uBR10012 router:
Router# configure terminal
Router(config)# controller integrated-cable 5/1/0
Related Commands Command Description
annex modulation Sets the annex and modulation rates for each RF channel.
rf-channel cable downstream Assigns a downstream channel ID to an RF channel.
channel-id
rf-channel frequency Sets the frequency for each RF channel.
rf-channel rf-power Sets the RF power output level.
rf-channel rf-shutdown Enables or disables an RF channel.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-799
Cable Commands: ca through cr
controller modular-cable
controller modular-cable
To enter controller configuration mode to configure the wideband modular interface controller, use the
controller modular-cable command in global configuration mode.
Cisco IOS Releases 12.3(23)BC and 12.2(33)SCA
controller modular-cable slot/subslot/bay
Cisco IOS Release 12.2(33)SCB and later releases
controller modular-cable slot/bay/port | slot/subslot/controller
Syntax Description slot/subslot/bay or The Wideband SPA slot, subslot, bay, and port.
slot/bay/port
• slot—Slot where the Wideband SIP resides. The valid values are 1 and 3.
• subslot—Subslot where the Wideband SIP resides. The valid value is 0.
• bay—Wideband SIP bay where the SPA resides. The valid range is from
0 to 3.
• port—Port number on the SPA. The valid value is always 0.
slot/subslot/controller Modular cable line card slot, subslot, and controller.
• slot—Modular cable line card slot. The valid values are 5, 6, 7, and 8.
• subslot—Modular cable line card subslot. The valid values are 0 and 1.
• controller—Modular cable line card controller. The valid range is from
0 to 2.
Command Default The command mode is unchanged.
Command Modes Global configuration (config)
Command History Release Modification
12.3(21)BC This command was introduced for the Cisco uBR10012 router.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
12.2(33)SCB This command was modified. The addressing format for the modular cable
interface was changed from slot/subslot/bay to slot/bay/port.
12.2(33)SCE This command was modified. This command now supports the
Cisco uBR-MC3GX60V cable interface line card. The addressing format
slot/subslot/controller for the modular-cable line card was added.
Cisco IOS CMTS Cable Command Reference
CBL-800 OL-15510-15
Cable Commands: ca through cr
controller modular-cable
Usage Guidelines This command indicates where the wideband modular interface controller is located and enters
controller configuration mode. The modular interface controller could be either a SPA, or a
Cisco uBR-MC3GX60V cable interface line card.
Examples The following example shows how to enter the controller configuration mode for the Cisco Wideband
SPA in slot 1, subslot 0, and bay 0.
Router# configure terminal
Router(config)# controller modular-cable 1/0/0
The following example shows how to enter the controller configuration mode for the
Cisco uBR-MC3GX60V line card in slot 8, subslot 1, and controller-unit-number 1.
Router# configure terminal
Router(config)# controller modular-cable 8/1/1
Related Commands Command Description
annex modulation Sets the annex and modulation for the Cisco Wideband SPA.
cable rf-channel Associates an RF channel on a Cisco Wideband SPA with a
wideband channel.
ip-address (controller) Sets the IP address of the Cisco Wideband SPA FPGA.
modular-host subslot Specifies the modular-host line card for the Cisco Wideband SPA.
rf-channel cable downstream Assigns a downstream channel ID to an RF channel.
channel-id
rf-channel description Specifies the description for each RF channel.
rf-channel ip-address Sets the IP address, MAC address, and UDP port for each RF
mac-address udp-port channel.
rf-channel network delay Specifies the CIN delay for each RF channel.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-801
Cable Commands: ca through cr
cops ip dscp
cops ip dscp
To specify the Common Open Policy Service (COPS) Differentiated Services Code Point (DSCP)
markings for COPS messages that are transmitted by the Cisco router, use the cops ip dscp command in
global configuration mode. To remove this configuration, use the no form of this command.
cops ip dscp [0-63 | default | af11-af43 | cs1-cs7]
no cops ip dscp [0-63 | default | af11-af43 | cs1-cs7]
The values for this command specify the markings with which COPS messages are transmitted. The
following values are supported for the Cisco CMTS router.
Syntax Description 0-63 DSCP value ranging from 0-63.
af11 Use AF11 dscp (001010)
af12 Use AF12 dscp (001100)
af13 Use AF13 dscp (001110)
af21 Use AF21 dscp (010010)
af22 Use AF22 dscp (010100)
af23 Use AF23 dscp (010110)
af31 Use AF31 dscp (011010)
af32 Use AF32 dscp (011100)
af33 Use AF33 dscp (011110)
af41 Use AF41 dscp (100010)
af42 Use AF42 dscp (100100)
af43 Use AF43 dscp (100110)
cs1 Use CS1 dscp (001000) [precedence 1]
cs2 Use CS2 dscp (010000) [precedence 2]
cs3 Use CS3 dscp (011000) [precedence 3]
cs4 Use CS4 dscp (100000) [precedence 4]
cs5 Use CS5 dscp (101000) [precedence 5]
cs6 Use CS6 dscp (110000) [precedence 6]
cs7 Use CS7 dscp (111000) [precedence 7]
default Use default dscp (000000)
ef Use EF dscp (101110)
Defaults • This command is disabled by default.
• For messages transmitted by the Cisco router, the default DSCP value is 0.
• For incoming connections to the Cisco router, by default, the COPS engine takes the DSCP value
used by the COPS server that initiates the TCP connection.
Command Modes Global configuration (config)
Cisco IOS CMTS Cable Command Reference
CBL-802 OL-15510-15
Cable Commands: ca through cr
cops ip dscp
Command History Release Modification
12.3(13a)BC This command was introduced to the Cisco CMTS.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
Support for the Cisco uBR7225VXR router was added.
Usage Guidelines This feature allows you to change the Differentiated Services Code Point (DSCP) marking for COPS
messages that are transmitted or received by the Cisco router. Cisco IOS Release 12.3(13a)BC supports
this function with the cops ip dscp command. The cops ip dscp command changes the default IP
parameters for connections between the Cisco router and COPS servers in the cable network.
DSCP values are used in Quality of Service (QoS) configurations on a Cisco router to summarize the
relationship between DSCP and IP precedence. This command allows COPS to remark the packets for
either incoming or outbound connections.
The default setting is 0 for outbound connections. On default incoming connections, the COPS engine
takes the DSCP value from the COPS server initiating the TCP connection.
Note This feature affects all TCP connections with all COPS servers.
• The cops ip dscp command allows the Cisco router to re-mark the COPS packets for either incoming
or outbound connections.
• This command affects all TCP connections with all COPS servers.
• This command does not affect existing connections to COPS servers. Once you issue this command,
this function is supported only for new connections after that point in time.
• For messages transmitted by the Cisco router, the default DSCP value is 0.
• For incoming connections to the Cisco router, the COPS engine takes the DSCP value used by the
COPS server that initiates the TCP connection, by default.
For additional information about this feature and related commands, refer to the “COPS Engine
Operation on the Cisco CMTS Routers” feature document on Cisco.com.
Examples The following basic example illustrates the use of this command:
The following example illustrates the cops ip dscp command with supported command variations:
Router(config)# cops ip dscp ?
<0-63> DSCP value
af11 Use AF11 dscp (001010)
af12 Use AF12 dscp (001100)
af13 Use AF13 dscp (001110)
af21 Use AF21 dscp (010010)
af22 Use AF22 dscp (010100)
af23 Use AF23 dscp (010110)
af31 Use AF31 dscp (011010)
af32 Use AF32 dscp (011100)
af33 Use AF33 dscp (011110)
af41 Use AF41 dscp (100010)
af42 Use AF42 dscp (100100)
af43 Use AF43 dscp (100110)
cs1 Use CS1 dscp (001000) [precedence 1]
cs2 Use CS2 dscp (010000) [precedence 2]
cs3 Use CS3 dscp (011000) [precedence 3]
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-803
Cable Commands: ca through cr
cops ip dscp
cs4 Use CS4 dscp (100000) [precedence 4]
cs5 Use CS5 dscp (101000) [precedence 5]
cs6 Use CS6 dscp (110000) [precedence 6]
cs7 Use CS7 dscp (111000) [precedence 7]
default Use default dscp (000000)
ef Use EF dscp (101110)
Router(config)# cops ip dscp 0-63
The following example specifies the COPS server and enables COPS for RSVP on the server. Both of
these functions are accomplished by using the ip rsvp policy cops command. By implication, the default
settings for all remaining COPS for RSVP commands are accepted.
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# ip rsvp policy cops servers 161.44.130.168 161.44.129.6
Router(config)# exit
The following examples display three views of the COPS for RSVP configuration on the router, which
can be used to verify the COPS for RSVP configuration.
The following example displays the policy server address, state, keepalives, and policy client
information:
Router# show cops servers
COPS SERVER: Address: 161.44.135.172. Port: 3288. State: 0. Keepalive: 120 sec
Number of clients: 1. Number of sessions: 1.
COPS CLIENT: Client type: 1. State: 0.
The following example displays the policy server address, the ACL ID, and the client/server connection
status:
Router# show ip rsvp policy cops
COPS/RSVP entry. ACLs: 40 60
PDPs: 161.44.135.172
Current state: Connected
Currently connected to PDP 161.44.135.172, port 0
The following example displays the ACL ID numbers and the status for each ACL ID:
Router# show ip rsvp policy
Local policy: Currently unsupported
COPS:
ACLs: 40 60 . State: CONNECTED.
ACLs: 40 160 . State: CONNECTING.
Related Commands Command Description
cops listeners access-list Configures access control lists (ACLs) for inbound connections to
all COPS listener applications on the Cisco CMTS.
cops tcp window-size Overrides the default TCP receive window size that is used by
COPS processes.
debug packetcable cops Enables debugging processes for PacketCable with the COPS
engine.
debug packetcable gate Enables and displays debugging processes for PacketCable gate
control control.
Cisco IOS CMTS Cable Command Reference
CBL-804 OL-15510-15
Cable Commands: ca through cr
cops ip dscp
Command Description
debug packetcable subscriber Enables and displays debugging processes for PacketCable
subscribers.
show cops servers Displays COPS server addresses, port, state, keepalives, and policy
client information.
show debug Displays current debugging information that includes PacketCable
COPS messages on the Cisco CMTS.
show ip rsvp policy Displays policy server addresses, ACL IDs, and client/server
connection status.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-805
Cable Commands: ca through cr
cops listeners access-list
cops listeners access-list
To configure access control lists (ACLs) for inbound connections to all Common Open Policy Service
(COPS) listener applications on the Cisco CMTS router, user the cops listeners access-list command in
global configuration mode. To remove this setting from the Cisco CMTS router, us the no form of this
command.
cops listeners access-list {acl-num | acl-name}
no cops listeners access-list {acl-num | acl-name}
Syntax Description acl-num Alphanumeric identifier of up to 30 characters, beginning with a letter that
identifies the ACL to apply to the current interface.
acl-name Numeric identifier that identifies the access list to apply to the current
interface. For standard access lists, the valid range is 1 to 99; for extended
access lists, the valid range is 100 to 199.
Command Default Access lists are not configured by default on the Cisco router.
Command Modes Global configuration (config)
Command History Release Modification
12.3(13a)BC This command was introduced.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines When using ACLs with cable monitor and the Cisco uBR10012 router, combine multiple ACLs into one
ACL, and then configure cable monitor with the consolidated ACL. For more information about cable
monitor, refer to the “Cable Monitor and Intercept Features for the Cisco CMTS” documentation on
Cisco.com.
Examples The following example illustrates a short access list configuration for the COPS listener feature:
Router# cops listeners access-list 40
Related Commands Command Description
cops ip dscp Specifies the COPS DSCP markings for COPS messages that are
transmitted by the Cisco router
cops tcp window-size Overrides the default TCP receive window size that is used by
COPS processes.
debug packetcable cops Enables debugging processes for PacketCable with the COPS
engine.
Cisco IOS CMTS Cable Command Reference
CBL-806 OL-15510-15
Cable Commands: ca through cr
cops listeners access-list
Command Description
debug packetcable gate Enables and displays debugging processes for PacketCable gate
control control.
debug packetcable subscriber Enables and displays debugging processes for PacketCable
subscribers.
show cops servers Displays COPS server addresses, port, state, keepalives, and policy
client information.
show debug Displays current debugging information that includes PacketCable
COPS messages on the Cisco CMTS.
show ip rsvp policy Displays policy server addresses, ACL IDs, and client/server
connection status.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-807
Cable Commands: ca through cr
cops tcp window-size
cops tcp window-size
To override the default TCP receive window size on the Cisco CMTS router, use the cops tcp
window-size command in global configuration mode. This setting allows you to prevent the COPS
server from sending too much data at one time. To return the TCP window size to a default setting of
4K, use the no form of this command.
cops tcp window-size bytes
no cops tcp window-size
Syntax Description bytes This is the TCP window size setting in bytes. This value can range from 516
to 65535 bytes.
Defaults The default COPS TCP window size is 4000 bytes.
Command Modes Global configuration (config)
Command History Release Modification
12.3(13a)BC This command was introduced.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines This command does not affect existing connections to COPS servers. Once you issue this command, this
function is supported only for new connections after that point in time.
Examples The following example configures the TCP window size to be 64000 bytes.
Router(config)# cops tcp window-size 64000
Related Commands Command Description
cops ip dscp Specifies the Common Open Policy Service (COPS) Differentiated
Services Code Point (DSCP) markings for COPS messages that are
transmitted by the Cisco router
cops listeners access-list Configures access control lists (ACLs) for inbound connections to
all COPS listener applications on the Cisco CMTS.
debug packetcable cops Enables debugging processes for PacketCable with the COPS
engine.
debug packetcable gate Enables and displays debugging processes for PacketCable gate
control control.
Cisco IOS CMTS Cable Command Reference
CBL-808 OL-15510-15
Cable Commands: ca through cr
cops tcp window-size
Command Description
debug packetcable subscriber Enables and displays debugging processes for PacketCable
subscribers.
show cops servers Displays COPS server addresses, port, state, keepalives, and policy
client information.
show debug Displays current debugging information that includes PacketCable
COPS messages on the Cisco CMTS.
show ip rsvp policy Displays policy server addresses, ACL IDs, and client/server
connection status.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-809
Cable Commands: ca through cr
cpd
cpd
To enable the Control Point Discovery (CPD) feature, use the cpd command in global configuration
mode. To disable CPD, use the no form of this command.
cpd
no cpd
Syntax Description This command has no keywords or arguments.
Command Default CPD is enabled.
Command Modes Global configuration (config)
Command History Release Modification
12.3(21a)BC3 This command was introduced.
12.2(33)SCA This command was integrted into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Examples The following example shows the cpd enabled on a router:
Router(config)# cpd
Related Commands Command Description
cpd cr-id Configures a control relationship identifier.
Cisco IOS CMTS Cable Command Reference
CBL-810 OL-15510-15
Cable Commands: ca through cr
cpd cr-id
cpd cr-id
To configure a Control relationship identifier (CR ID), the the cpd cr-id command in global
configuration mode. To disable the CR ID, use the no form of this command.
cpd cr-id cr id number
no cpd cr-id
Syntax Description cr id number Control relationship identifier. The valid range is 1 to 65535.
Command Default The cr-id is configured as 1.
Command Modes Global configuration (config)
Command History Release Modification
12.3(21a)BC3 This command was introduced.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Examples The following example shows the control relationship identifier configured as 236:
Router(config)# cpd cr-id 236
Related Commands Command Description
cpd Enables CPD functionality.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-811
Cable Commands: ca through cr
cpe max
cpe max
To create a DOCSIS configuration file that specifies the maximum number of CPE devices that can use
the CM to connect to the cable network, use the cpe max command in cable config-file configuration
mode. To remove the CPE specification, use the no form of this command.
cpe max cpe-num
no cpe max
Syntax Description cpe-num Specifies the number of CPEs. Valid range is 1 to 254.
Command Default A maximum of one CPE device can use the CM to connect to the cable network.
Command Modes Cable config-file configuration (config-file)
Command History Release Modification
12.1(2)EC1 This command was introduced.
12.2(4)BC1 Support was added to the Release 12.2 BC train.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
Usage Guidelines The CM enforces the limitation imposed by the cpe max command, but the CMTS might enforce its own
lower number of CPE devices. On Cisco CMTS routers, a cpe-num value of 0 enables an unlimited
number of hosts, but on some CMs, this value provides only 0 hosts.
Examples The following example shows how to set the maximum CPE value for the configuration file:
Router(config)# cable config-file channeloverride.cm
Router(config-file)# cpe max 3
Router(config-file)# exit
Related Commands Command Description
cable config-file Creates a DOCSIS configuration file and enters configuration file
mode.
access-denied Disables access to the network.
channel-id Specifies upstream channel ID.
download Specifies download information for the configuration file.
frequency Specifies downstream frequency.
option Provides config-file options.
Cisco IOS CMTS Cable Command Reference
CBL-812 OL-15510-15
Cable Commands: ca through cr
cpe max
Command Description
privacy Specifies privacy options for baseline privacy images.
service-class Specifies service class definitions for the configuration file.
snmp manager Specifies Simple Network Management Protocol (SNMP) options.
timestamp Enables time-stamp generation.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-813
Cable Commands: ca through cr
cpe max
Cisco IOS CMTS Cable Command Reference
CBL-814 OL-15510-15
Cable Commands: d through h
Revised: July 2012, OL-15510-15
New Commands
Command Cisco IOS Software Release
downstream local upstream 12.3(23)BC
downstream modular-cable rf-channel (interface) 12.3(23)BC
downstream integrated-cable rf-channel (interface) 12.2(33)SCB
depi-class 12.2(33)SCC
depi-tunnel 12.2(33)SCC
dest-ip 12.2(33)SCC
docsis-policy 12.2(33)SCC
docsis-version 12.2(33)SCC
downstream 12.2(33)SCC
depi eqam-stats 12.2(33)SCE
depi cin-failover 12.2(33)SCF
description (bonding-group) 12.2(33)SCG
Modified Commands
Command Cisco IOS Software Release
downstream local upstream 12.2(33)SCB
downstream modular-cable rf-channel 12.2(33)SCB
downstream modular-cable rf-channel (interface) 12.2(33)SCB
flowcontrol 12.2(33)SCB
hold-queue 12.2(33)SCB
hw-module bay reload 12.2(33)SCB
duration 12.2(33)SCD2
downstream modular-cable rf-channel (interface) 12.2(33)SCE
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-815
Cable Commands: d through h
Replaced Commands
The following commands have been replaced by new commands beginning in the following Cisco IOS
software releases:
Command Replacement Command Beginning Cisco IOS Release
enforced qos-profile qos-profile enforced 12.3(9a)BC
Cisco IOS CMTS Cable Command Reference
CBL-816 OL-15510-15
Cable Commands: d through h
depi cin-failover
depi cin-failover
To enable a failover when Converged Interconnect Network (CIN) failure occurs on Downstream
External PHY Interface (DEPI), use the depi cin-failover command in global configuration mode. To
disable the failover when the CIN fails on the DEPI, use the no form of this command..
depi cin-failover
no depi cin-failover
Syntax Description This command has no arguments or keywords.
Command Default The DEPI CIN failover configuration is disabled by default.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCF This command was introduced.
Usage Guidelines The depi cin-failover command allows you to enable a line card switchover when a CIN failure occurs
on the DEPI on the control plane, and N + 1 redundancy is configured. For a line card switchover to
occur, when the CIN fails on the DEPI, this command must be enabled globally..
Note In Cisco IOS Release 12.2(33)SCE, DEPI CIN triggered failover is automatically enabled with control
plane DEPI. The depi cin-failover command is introduced in Cisco IOS Release 12.2(33)SCF and is
disabled by default.
Examples The following example shows how to configure a CIN failover:
Router(config)# depi
Router(config)# depi cin-failover
router(config)# exit
Related Commands Command Description
show depi tunnel Displays all active control connections.
show depi session Displays information about DEPI sessions.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-817
Cable Commands: d through h
depi-class
depi-class
To create a template of Downstream External PHY Interface (DEPI) control plane configuration
settings, which different pseudowire classes can inherit, and to enter the DEPI class configuration mode,
use the depi-class command in global configuration mode. To remove a specific DEPI class
configuration, use the no form of this command.
depi-class depi-class-name
no depi-class depi-class-name
Syntax Description depi-class-name Name of the DEPI class. The depi-class-name argument must be specified to
configure multiple sets of DEPI control parameters.
Command Default No DEPI classes are defined.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines The depi-class depi-class-name command allows you to configure a DEPI class template that consists
of configuration settings used by different pseudowire classes. The depi-class command enters DEPI
class configuration mode, where DEPI control plane parameters are configured.
You must use the same DEPI class in the pseudowire configuration at both ends of a Layer 2 control
channel.
Examples The following example shows how to enter DEPI class configuration mode to create a DEPI class
configuration template for the class named SPA0:
Router# configure terminal
Router(config)# depi-class SPA0
Router(config-depi-ctrl SPA0)#
Related Commands Command Description
l2tp-class Creates a template of Layer 2 Tunnel Protocol (L2TP) control plane
configuration settings that can be inherited by different pseudowire classes
and enters the L2TP class configuration mode.
depi-tunnel Creates a template of Downstream External PHY Interface (DEPI) tunnel
configuration settings, which different pseudowire classes can inherit, and
enters the DEPI data session configuration mode.
Cisco IOS CMTS Cable Command Reference
CBL-818 OL-15510-15
Cable Commands: d through h
depi-class
Command Description
show depi tunnel Displays all active control connections.
show depi session Displays established DEPI data sessions.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-819
Cable Commands: d through h
depi eqam-stats
depi eqam-stats
To enable debugging information for Downstream External PHY Interface (DEPI) EQAM statistics on
the Cisco CMTS router, use the depi eqam-stats command in global configuration mode. To disable
debugging information, use the no form of this command.
depi eqam-stats
no depi eqam-stats
Syntax Description This command has no arguments or keywords.
Command Default The DEPI EQAM statistics configuration is enabled by default.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCE This command was introduced.
Usage Guidelines Cisco RF Gateway 10 sends EQAM statistics to the Cisco CMTS router. No other EQAM supports the
EQAM statistics feature.
Examples The following example shows how to configure DEPI EQAM statistics on the Cisco CMTS router:
Router# configure terminal
Router(config)# depi eqam-stats
Related Commands Command Description
show depi session Displays information about DEPI sessions.
Cisco IOS CMTS Cable Command Reference
CBL-820 OL-15510-15
Cable Commands: d through h
depi-tunnel
depi-tunnel
To create a template of Downstream External PHY Interface (DEPI) tunnel configuration settings, which
different pseudowire classes can inherit, and to enter the DEPI data session configuration mode, use the
depi-tunnel command in the global configuration mode or subinterface configuration mode. To remove
a configured DEPI tunnel, use the no form of this command.
depi-tunnel depi-tunnel-name
no depi-tunnel depi-tunnel-name
Syntax Description depi-tunnel-name Name of the DEPI tunnel.
Command Default This command has no default behavior or values.
Command Modes Global configuration (config)
Subinterface configuration (config-subif)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines The depi-tunnel creates a template of DEPI tunnel configuration settings. The DEPI data session
inherits the control plane configuration settings of a depi-control template.
The following depi data session configuration options are available in this mode:
• l2tp-class
• depi-class
• dest-ip
• tos
Examples The following example shows how to create a template of DEPI tunnel configuration settings in the
global configuration mode and enter the DEPI data session configuration mode:
Router# configure terminal
Router(config)# depi-tunnel rf6
Router(config-depi-tunnel)#
The following example shows how to create a template of DEPI tunnel configuration settings in the
subinterface configuration mode:
Router(config)# interface qam 6/4.1
Router(config-subif)# depi-tunnel 0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-821
Cable Commands: d through h
depi-tunnel
Related Commands Command Description
l2tp-class Creates a template of Layer 2 Tunnel Protocol (L2TP) control plane
configuration settings, which different pseudowire classes can inherit, and
enters the L2TP class configuration mode.
depi-class Creates a template of Downstream External PHY Interface (DEPI) control
plane configuration settings, which different pseudowire classes can inherit,
and enters the DEPI class configuration mode.
dest-ip Assigns an IP address to the destination network.
tos Configures the Type of Service (ToS) byte in the header of Layer 2 tunneled
packets.
show depi tunnel Displays all active control connections.
show depi session Displays established DEPI data sessions.
Cisco IOS CMTS Cable Command Reference
CBL-822 OL-15510-15
Cable Commands: d through h
description (bonding-group)
description (bonding-group)
To add a description for a bonding group on the Cisco CMTS router, use the description command in
cable interface configuration mode. To remove a description for a bonding group, use the no form of this
command.
description description
no description
Syntax Description description Specifies a description for the bonding group. The character-string can be up
to 128 characters long.
Command Default By default, description for a bonding group does not exist.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCG This command was introduced.
Usage Guidelines The description command adds a comment to the configuration to provide information about the
bonding group.
Examples The following example shows how to specify a description for bonding group 1:
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# interface cable 8/0/0
Router(config-if)# cable upstream bonding-group 1
Router(config-upstream-bonding)# description UBG1
Router(config-upstream-bonding)# end
Router# show running interface cable 8/0/0
Building configuration...
Current configuration : 1443 bytes
!
interface Cable8/0/0
downstream Modular-Cable 8/0/0 rf-channel 0-3
cable ip-init apm
cable mtc-mode
no cable packet-cache
cable bundle 6
cable upstream max-ports 4
cable upstream bonding-group 1
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-823
Cable Commands: d through h
description (bonding-group)
description UBG1
upstream 0
upstream 1
upstream 2
upstream 3
attributes 80000000
Associated Features The description command is used to configure the Upstream Channel Bonding feature.
Related Commands Command Description
cable fiber-node Enters cable fiber-node configuration mode to configure a fiber node.
upstream cable connector Specifies the upstream channel ports for a fiber node.
Cisco IOS CMTS Cable Command Reference
CBL-824 OL-15510-15
Cable Commands: d through h
description (cable fiber-node)
description (cable fiber-node)
To specify a description for a fiber node, use the description command in cable fiber-node configuration
mode. To remove a description for a fiber node, use the no form of this command.
description description
no description
Syntax Description description Specifies a description for the cable fiber node. The character-string can be
up to 80 characters long.
Command Default If the description command is not issued, a description does not exist.
Command Modes Cable fiber-node configuration (config-fiber-node)
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.
Usage Guidelines The description command adds a comment to the configuration to provide information about the fiber
node.
Examples The following example shows how to specify a description for fiber node 5:
Router# configure terminal
Router(config)# cable fiber-node 5
Router(config-fiber-node)# description Branch office 5
Related Commands Command Description
cable fiber-node Enters cable fiber-node configuration mode to configure a fiber node.
downstream cable Assigns a primary downstream channel for a fiber node.
downstream modular-cable Specifies the RF channels that are available for wideband channels
rf-channel on a fiber node.
upstream cable connector Specifies the upstream channel ports for a fiber node.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-825
Cable Commands: d through h
dest-ip
dest-ip
To assign an IP address to the edge quadrature amplitude modulation (EQAM), use the dest-ip command
in DEPI tunnel configuration mode. To remove a specific destination IP address, use the no form of this
command.
dest-ip dest-ip-address
no dest-ip dest-ip-address
Syntax Description dest-ip-address IP address of the EQAM.
Command Default This command has no default behavior or values.
Command Modes DEPI tunnel configuration
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines The dest-ip dest-ip-address command allows you to configure the IP address of the EQAM.
Examples The following example shows how to assign 1.3.4.155 as the destination IP address:
Router# configure terminal
Router(config)# depi-tunnel rf6
Router(config-depi-tunnel)# dest-ip 1.3.4.155
Related Commands Command Description
l2tp-class Creates a template of Layer 2 Tunnel Protocol (L2TP) control plane
configuration settings, which different pseudowire classes can inherit, and
enters the L2TP class configuration mode.
depi-class Creates a template of Downstream External PHY Interface (DEPI) control
plane configuration settings, which different pseudowire classes can inherit,
and enters the DEPI class configuration mode.
depi-tunnel Specifies the name of the depi-tunnel and enters the DEPI tunnel
configuration mode.
tos Configures the Type of Service (ToS) byte in the header of Layer 2 tunneled
packets.
show depi tunnel Displays all active control connections.
show depi session Displays established DEPI data sessions.
Cisco IOS CMTS Cable Command Reference
CBL-826 OL-15510-15
Cable Commands: d through h
diagnostic load
diagnostic load
To load a Field Diagnostic image to the line card for field diagnostic testing, enter the diagnostic load
command.
diagnostic load {slot slot | subslot slot/subslot} image-url [autostart test {all [port port-number
| WORD]}| basic | default | per-port port-number}]
Syntax Description slot Specifies that the line card downloading the Field Diagnostic image is in a full slot
as opposed to a subslot.
subslot Specifies that the line card downloading the Field Diagnostic image is in a subslot
(in other words, a half-height line card) as opposed to a full slot.
slot Specifies the number of the slot where the line card downloading the Field
Diagnostic image is located on the router.
subslot Specifies the number of the subslot where the line card downloading the Field
Diagnostic image is located on the router.
image-url Specifies the path where the Field Diagnostic image is being downloaded from.
• If the Field Diagnostic image was saved to the router’s Flash file system, enter
the file system (such as disk0: or disk1:) as the image-url.
• If the Field Diagnostic image was saved to a server, the image-url will include
server-type://path, where server-type is the type of server (typically either
FTP or TFTP) and path is the path to the file on the TFTP server where the
Field Diagnostic image has been saved.
autostart If autostart is specified, the diagnostic testing process for the line card will begin
automatically once the Field Diagnostic image has been loaded onto the line card.
test The test option is used to specify which type of testing will occur. If the test
option is not entered, the default test is used.
all When used after the test option, specifies that all Field Diagnostic tests will be run
during the testing period, including the external loopback test.
When used after the port option, specifies that external loopback tests should be
run on all ports on the line card.
port port-number Specifies the port number on the interface that should perform the external
loopback test.
WORD Specifies a range of ports.
basic Specifies that the basic Field Diagnostic test suite will be run. The basic test suite
will catch most hardware problems but not run each individual test like the all test
suite option. The advantage of running the basic test suite is that it takes less time
to run than the other test suites.
default Specifies that the default test suite will be run. The default test suite will run all
Field Diagnostic tests for the particular line card with the exception of the external
loopback test.
If no test suite or test is specified when requesting a test, the default test suite is
run.
per-port Specifies that an external loopback test should be run on a specific port.
port-number
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-827
Cable Commands: d through h
diagnostic load
Command Default If the autostart option is entered but no test is specified, the default test suite is the suite used to test the
line card.
Command Modes Priviliged EXEC
Command History Release Modification
12.2(16)BX This command was introduced.
12.3(13)BC This command was integrated into Cisco IOS Release 12.3(13)BC.
Usage Guidelines Entering this command and successfully downloading the Field Diagnostic image will disrupt normal
line card operation. To remove the Field Diagnostic image from a line card and restore normal line card
operation, use the diagnostic unload command.
If the autostart option is not specified, diagnostic tests can be run on the line card after the Field
Diagnostic image has been loaded by entering the diagnostic start command.
Examples In the following example, the diagnostic load command is used to download the Field Diagnostic image
in TFTP server 127.1.1.1/mytftpfolder to the line card in slot 2. If yes is entered at the prompt below,
the router will be placed in Field Diagnostic mode.
Router# diagnostic load slot 2 tftp://127.1.1.1/mytftpfolder/c10k-fdiagslc-mz.1.1.bin
******************************************************************************
WARNING:The specified line card will be taken offline, please ensure that
all traffic has been redirected before executing this command.
NOTE:The "diagnostic unload <target>" command must be used after diagnostic
testing to resume normal line card operation.
******************************************************************************
Field Diagnostics Image Loading Parameters
==============================================================================
Slot:2 (6oc3pos-1)
Image URL:tftp://127.1.1.1/mytftpfolder/c10k-fdiagslc-mz.1.1.bin
Auto-Start:disabled
==============================================================================
% Are you sure that you want to perform this operation? [no]:
Cisco IOS CMTS Cable Command Reference
CBL-828 OL-15510-15
Cable Commands: d through h
diagnostic load
Related Commands Command Description
diagnostic event-log size Sets the size of the event table.
diagnostic ondemand Sets the number of errors allowed in the Field Diagnostic test
action-on-failure before the Field Diagnostic test is stopped.
diagnostic ondemand iterations Sets the number of times each specific Field Diagnostic test
will be run when a Field Diagnostic test is initiated.
diagnostic start Starts Field Diagnostic testing on the line card.
diagnostic stop Stops an in-progress Field Diagnostic test.
diagnostic unload Unloads the Field Diagnostic image from the line card and
restores normal line card operation.
show diagnostic content Shows the Field Diagnostic test list for a particular line card.
show diagnostic events Displays the history of Field Diagnostic events since the last
system reload.
show diagnostic ondemand settings Shows the diagnostic on-demand settings.
show diagnostic result Shows the results of the Field Diagnostic test.
show diagnostic ood-status Displays various status information, such as line card slot and
name, Field Diagnostic image status, and previous Field
Diagnostic test results.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-829
Cable Commands: d through h
diagnostic ondemand action-on-failure
diagnostic ondemand action-on-failure
To set an error count limit or to stop testing once a diagnostic error event is detected, use the diagnostic
ondemand action-on-failure command.
diagnostic ondemand action-on-failure [continue failure-limit | stop]
Syntax Description continue failure-limit Specifies that Field Diagnostic testing should continue on the line
card after a failed test occurs. The failure-limit specifies the number
of failed tests that can be detected before testing on the line card
should stop. A failure-limit of 0 means testing should continue
regardless of the number of failed tests.
Note The failure-limit is the number of failed tests, not errors
within a single test. For example, if four errors occur during
a single test, the failure-limit for that individual test would
be 1, not 4.
stop Specifies that Field Diagnostic testing should stop when an error
event occurs.
Command Default If this command is not entered, a default failure-limit of 0 is used. Therefore, testing will continue
regardless of the number of errors unless the diagnostic ondemand action-on-failure command is used
to change the default setting.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(16)BX This command was introduced.
12.3(13)BC This command was integrated into Cisco IOS Release 12.2(13)BC.
Usage Guidelines The diagnostic ondemand action-on-failure settings cannot be saved to a Cisco IOS configuration file.
Therefore, the diagnostic ondemand action-on-failure command will need to be re-entered each time
a router is reset or power cycled if the action-on-failure settings should be maintained.
The show diagnostic ondemand settings command can be used to verify the diagnostic ondemand
action-on-failure setting.
The show diagnostic events event-type error command can be used to gather additional information
about an error event.
Examples In the following example, the diagnostic on-demand iteration and action-on-failure settings are changed
using diagnostic ondemand iterations and diagnostic ondemand action-on-failure. The changed
settings are then confirmed using show diagnostic ondemand settings.
Router# diagnostic ondemand iterations 2
Cisco IOS CMTS Cable Command Reference
CBL-830 OL-15510-15
Cable Commands: d through h
diagnostic ondemand action-on-failure
Router# diagnostic ondemand action-on-failure stop
Router# show diagnostic ondemand settings
Test iterations = 2
Related CommandsA Command Description
diagnostic event-log size Sets the size of the event table.
diagnostic load Loads the Field Diagnostic image onto the line card.
diagnostic ondemand Sets the number of errors allowed in the Field Diagnostic test before the
action-on-failure Field Diagnostic test is stopped.
diagnostic ondemand Sets the number of times each specific Field Diagnostic test will be run
iterations when a Field Diagnostic test is initiated.
diagnostic start Starts Field Diagnostic testing on the line card.
diagnostic stop Stops an in-progress Field Diagnostic test.
show diagnostic content Shows the Field Diagnostic test list for a particular line card.
show diagnostic events Displays the history of Field Diagnostic events since the last system
reload.
show diagnostic Shows the diagnostic on-demand settings.
ondemand settings
show diagnostic result Shows the results of the Field Diagnostic test.
show diagnostic Displays various status information, such as line card slot and name,
ood-status Field Diagnostic image status, and previous Field Diagnostic test results.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-831
Cable Commands: d through h
diagnostic ondemand iterations
diagnostic ondemand iterations
To set the number of times a diagnostic test or set of tests will be run when the diagnostic start
command is entered, enter the diagnostic ondemand iterations command.
diagnostic ondemand iterations iteration-count
Syntax Description iteration-count The number of tests to be run each time a Field Diagnostic test is
started. For instance, if the iteration-count is set at 2 and the Field
Diagnostic test specifies that tests 1, 5, and 10 will be run, tests 1, 5,
and 10 will all be run twice. If basic or default testing is specified
and the iteration-count is 2, all basic or default tests will be run
twice.
Command Default The default iteration-count is 1.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(16)BX This command was introduced.
12.3(13)BC This command was integrated into Cisco IOS Release 12.3(13)BC.
Usage Guidelines The diagnostic ondemand iterations settings cannot be saved to a Cisco IOS configuration file.
Therefore, the diagnostic ondemand iterations command will need to be re-entered each time a router
is reset or power cycled if a nondefault setting needs to be maintained.
The show diagnostic ondemand settings command can be used to verify the diagnostic ondemand
iterations setting.
Examples In the following example, the diagnostic on-demand iteration and action-on-failure settings are changed
using diagnostic ondemand iterations and diagnostic ondemand action-on-failure. The changed
settings are then confirmed using show diagnostic ondemand settings.
Router# diagnostic ondemand iterations 2
Router# diagnostic ondemand action-on-failure stop
Router# show diagnostic ondemand settings
Test iterations = 2
Action on test failure = stop
In the following example, the diagnostic ondemand iterations command is first used to change the
number of iterations per test to 2. Therefore, a Field Diagnostic test is run twice (note that the output of
the diagnostic start command reflects the test being run twice).
Cisco IOS CMTS Cable Command Reference
CBL-832 OL-15510-15
Cable Commands: d through h
diagnostic ondemand iterations
After the initial test, the iteration-count is then changed to 3 and the same test is run. Note that the output
of diagnostic start shows each test being run three times as opposed to two after the iteration-count was
changed using the diagnostic ondemand iterations 3 command.
Router# diagnostic ondemand iterations 2
Router# diagnostic start slot 8 test 1
Slot 8: Running test(s) 1 may generate packets out of the card interface.
Do you want to run the selected test(s)? [no]: y
Router#
FDIAG [slot 8]> Running Field Diagnostics [Iteration #1] ...
FDIAG [slot 8]> Running MPC860 Register Test {ID=1} ...
FDIAG [slot 8]> MPC860 Register Test {ID=1} passed
FDIAG [slot 8]> Running Field Diagnostics [Iteration #2] ...
FDIAG [slot 8]> Running MPC860 Register Test {ID=1} ...
FDIAG [slot 8]> MPC860 Register Test {ID=1} passed
FDIAG [slot 8]> Total testing time = 00:00:00.500
FDIAG [slot 8]> Field Diagnostics passed with the selected test(s)
*Jun 13 16:05:48.987: %DIAG_C10K-5-TESTING_PASSED: Field Diagnostics passed with the
selected test(s) for card in slot 8
Router# diagnostic ondemand iterations 3
Router# diagnostic start slot 8 test 1
Slot 8: Running test(s) 1 may generate packets out of the card interface.
Do you want to run the selected test(s)? [no]: y
Router#
FDIAG [slot 8]> Running Field Diagnostics [Iteration #1] ...
FDIAG [slot 8]> Running MPC860 Register Test {ID=1} ...
FDIAG [slot 8]> MPC860 Register Test {ID=1} passed
FDIAG [slot 8]> Running Field Diagnostics [Iteration #2] ...
FDIAG [slot 8]> Running MPC860 Register Test {ID=1} ...
FDIAG [slot 8]> MPC860 Register Test {ID=1} passed
FDIAG [slot 8]> Running Field Diagnostics [Iteration #3] ...
FDIAG [slot 8]> Running MPC860 Register Test {ID=1} ...
FDIAG [slot 8]> MPC860 Register Test {ID=1} passed
FDIAG [slot 8]> Total testing time = 00:00:00.600
FDIAG [slot 8]> Field Diagnostics passed with the selected test(s)
*Jun 13 16:06:07.291: %DIAG_C10K-5-TESTING_PASSED: Field Diagnostics passed with the
selected test(s) for card in slot 8
Related CommandsA Command Description
diagnostic event-log size Sets the size of the event table.
diagnostic load Loads the Field Diagnostic image onto the line card.
diagnostic ondemand Sets the number of errors allowed in the Field Diagnostic test before the
action-on-failure Field Diagnostic test is stopped.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-833
Cable Commands: d through h
diagnostic ondemand iterations
Command Description
diagnostic ondemand Sets the number of times each specific Field Diagnostic test will be run
iterations when a Field Diagnostic test is initiated.
diagnostic start Starts Field Diagnostic testing on the line card.
diagnostic stop Stops an in-progress Field Diagnostic test.
show diagnostic content Shows the Field Diagnostic test list for a particular line card.
show diagnostic events Displays the history of Field Diagnostic events since the last system
reload.
show diagnostic Shows the diagnostic on-demand settings.
ondemand settings
show diagnostic result Shows the results of the Field Diagnostic test.
show diagnostic Displays various status information, such as line card slot and name,
ood-status Field Diagnostic image status, and previous Field Diagnostic test results.
Cisco IOS CMTS Cable Command Reference
CBL-834 OL-15510-15
Cable Commands: d through h
diagnostic unload
diagnostic unload
To unload the Field Diagnostic on the line card and resume normal line card operation, enter the
diagnostic unload command.
diagnostic unload {slot slot-number | subslot slot-number/subslot-number}
Syntax Description slot Specifies that the line card unloading the Field Diagnostic image is
in a full slot as opposed to a subslot.
subslot Specifies that the line card unloading the Field Diagnostic image is
in a subslot as opposed to a full slot.
slot-number Specifies the number of the slot where the line card unloading the
Field Diagnostic image is located on the router.
subslot-number Specifies the number of the subslot where the line card unloading the
Field Diagnostic image is located on the router.
Command Default No default behavior or values.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(16)BX This command was introduced.
12.3(13)BC This command was integrated into Cisco IOS Release 12.3(13)BC.
Usage Guidelines The show diagnostic result output will be lost once a Field Diagnostic image is successfully unloaded
off a line card. If you want to retain the results of the Field Diagnostic test, enter show diagnostic result
and copy the output into a separate file before entering diagnostic unload to unload the Field Diagnostic
image off the line card.
Entering this command successfully will resume normal line card operation.
If a line card needs to be placed back online immediately and a Field Diagnostic test is in progress, enter
diagnostic stop to stop the in-progress Field Diagnostic test before entering diagnostic unload to
unload the Field Diagnostic image off the line card.
Examples In the following example, the Field Diagnostic image is unloaded off of the line card in slot 2. Note that
the command is not successfully executed until confirmed at the screen prompt.
Router# diagnostic unload slot 2
******************************************************************************
WARNING:All Field Diagnostics test results and information will be
unavailable to both the "show diagnostic result <target>" and
"show diagnostic content <target>" commands.
To save the test results, cancel the unloading process and enter
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-835
Cable Commands: d through h
diagnostic unload
the "show diagnostic result <target>" command. Copy the output
into a file, then re-enter the "diagnostic unload <target>" command
to restore normal line card operation.
******************************************************************************
% Are you sure that you want to perform this operation? [no]:y
FDIAG [slot 2]> Unloading the Field Diagnostics image and restoring the original run-time
image, please wait ...
FDIAG [slot 2]> Field Diagnostics image was successfully unloaded
Related Commands Command Description
diagnostic event-log size Sets the size of the event table.
diagnostic load Loads the Field Diagnostic image onto the line card.
diagnostic ondemand Sets the number of errors allowed in the Field Diagnostic test before the
action-on-failure Field Diagnostic test is stopped.
diagnostic ondemand Sets the number of times each specific Field Diagnostic test will be run
iterations when a Field Diagnostic test is initiated.
diagnostic start Starts Field Diagnostic testing on the line card.
diagnostic stop Stops an in-progress Field Diagnostic test.
show diagnostic content Shows the Field Diagnostic test list for a particular line card.
show diagnostic events Displays the history of Field Diagnostic events since the last system
reload.
show diagnostic Shows the diagnostic on-demand settings.
ondemand settings
show diagnostic result Shows the results of the Field Diagnostic test.
show diagnostic Displays various status information, such as line card slot and name,
ood-status Field Diagnostic image status, and previous Field Diagnostic test results.
Cisco IOS CMTS Cable Command Reference
CBL-836 OL-15510-15
Cable Commands: d through h
docsis cvc mfg
docsis cvc mfg
To configure the access start times and organization name for the manufacturer’s code verification
certificate (CVC) to enable the DOCSIS 1.1 secure software download feature on the router, use the
docsis cvc mfg command in global configuration mode. To delete this information, use the no form of
this command.
Cisco uBR905 and Cisco uBR925 cable access routers, and Cisco CVA122 Cable Voice Adapter
docsis cvc mfg {codeAccessStart start-time | cvcAccessStart start-time | organization name}
no docsis cvc mfg {codeAccessStart start-time | cvcAccessStart start-time | organization name}
Syntax Description codeAccessStart start-time Specifies the code Access Start Time as a UTC time value
(YYMMDDhhmmssZ) in Greenwich Mean Time.
cvcAccessStart start-time Specifies the CVC Access Start Time as a UTC time value
(YYMMDDhhmmssZ) in Greenwich Mean Time.
organization name Specifies the name of the manufacturer of the code file. Use quotes if the
name value contains more than one word.
Command Default The codeAccessStart and cvcAccessStart times default to 011219000000Z (midnight on December 19,
2001 Greenwich Mean Time). The organization defaults to Cisco Systems.
Note Typically, the default values should not be changed unless you are instructed to do so by Cisco TAC or
field service engineers.
Command Modes Global configuration
Command History Release Modification
12.2(15)CZ This command was introduced on the Cisco uBR905 and Cisco uBR925
cable access routers, and the Cisco CVA122 Cable Voice Adapter.
Usage Guidelines This command configures the access start times and organization name that are required by Appendix D
in the DOCSIS BPI+ specification. The time values are specified as UTC time values in Greenwich
Mean Time, with a two-digit year. If the year is between 50 and 99, it is interpreted as 1950 to 1999. If
the year is between 00 and 49, it is interpreted as 2000 to 2049.
The router uses the codeAccessStart value to verify the Code Verification Signature (CVS) that is
affixed to the code file downloaded using the secure software download feature. The router uses the
ccvAccessStart value to verify the CVC for the code file. The router also uses the organization value
to verify that the code file has been created by the proper manufacturer.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-837
Cable Commands: d through h
docsis cvc mfg
Tip These values are the same that are set using the docsBpi2CodeMfgCodeAccessStart,
docsBpi2CodeMfgCvcAccessStart, and docsBpi2CodeMfgOrgName attributes in the BPI+ MIB
(DOCS-BPI2-MIB).
Examples The following example shows the default configuration for the docsis cvc mfg commands:
Router(config)# docsis cvc mfg organization "Cisco Systems"
Router(config)# docsis cvc mfg codeAccessStart 011219000000Z
Router(config)# docsis cvc mfg cvcAccessStart 011219000000Z
Router(config)#
Note You must set the organization name using the docsis cvc mfg organization command before you can
set either access start time.
Related Commands Command Description
docsis cvc mso Configures the access start times and organization name for the
optional MSO cosigned code verification certificate (CVC).
docsis cvc test Tests the root CA public key and CM private key that are installed
on the router.
Cisco IOS CMTS Cable Command Reference
CBL-838 OL-15510-15
Cable Commands: d through h
docsis cvc mso
docsis cvc mso
To configure the access start times and organization name for the optional Multi-Service Operator
(MSO) cosigned code verification certificate (CVC) for the DOCSIS 1.1 secure software download
feature, use the docsis cvc mso command in global configuration mode. To delete the information, use
the no form of this command.
Cisco uBR905 and Cisco uBR925 cable access routers, and Cisco CVA122 Cable Voice Adapter
docsis cvc mso {codeAccessStart start-time | cvcAccessStart start-time | organization name}
no docsis cvc mso {codeAccessStart start-time | cvcAccessStart start-time | organization name}
Syntax Description codeAccessStart start-time Specifies the code Access Start Time as a UTC time value
(YYMMDDhhmmssZ) in Greenwich Mean Time.
cvcAccessStart start-time Specifies the CVC Access Start Time as a UTC time value
(YYMMDDhhmmssZ) in Greenwich Mean Time.
organization name Specifies the name of the manufacturer of the code file. Use quotes if the
name value contains more than one word.
Command Default No default values or behavior (no cosigner is used).
Command Modes Global configuration
Command History Release Modification
12.2(15)CZ This command was introduced on the Cisco uBR905 and Cisco uBR925
cable access routers, and the Cisco CVA122 Cable Voice Adapter.
Usage Guidelines This command configures the optional cosigner access start times and organization name that are
specified by Appendix D in the DOCSIS BPI+ specification. The time values are specified as UTC time
values in Greenwich Mean Time, with a two-digit year. If the year is between 50 and 99, it is interpreted
as 1950 to 1999. If the year is between 00 and 49, it is interpreted as 2000 to 2049.
You do not need to use this command unless the MSO or service provider is digitally signing the
Cisco IOS software images that it plans to download to the Cisco cable modems. If so, then this
command must be used to set the appropriate access times and organization name, so that the cable
modem can properly authenticate the software images during a secure software download.
The router uses the codeAccessStart value to verify the cosigner’s Code Verification Signature (CVS)
that is affixed to the code file downloaded using the secure software download feature. The router uses
the ccvAccessStart value to verify the cosigner’s CVC that is affixed to the code file. The router also
uses the organization value to verify that the code file has been signed by the proper MSO or cable
operator.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-839
Cable Commands: d through h
docsis cvc mso
Tip These values are the same that are set using the docsdocsBpi2CodeCoSignerCodeAccessStart,
Bpi2CodeCoSignerCvcAccessStart, and docsBpi2CodeCoSignerOrgName attributes in the BPI+ MIB
(DOCS-BPI2-MIB).
Examples The following example shows the docsis cvc mso commands being used to configure the router for a
cosigned CVC from an organization named “MSO Organization” and with certificate access times of
midnight on March 1, 2002 Greenwich Mean Time:
Router(config)# docsis cvc mfg organization "MSO Organization"
Router(config)# docsis cvc mfg codeAccessStart 020301000000Z
Router(config)# docsis cvc mfg cvcAccessStart 020301000000Z
Router(config)#
Note You must set the organization name using the docsis cvc mso organization command before you can
set either access start time.
Related Commands Command Description
docsis cvc mfg Configures the access start times and organization name for the
manufacturer’s code verification certificate (CVC).
docsis cvc test Tests the root CA public key and CM private key that are installed
on the router.
Cisco IOS CMTS Cable Command Reference
CBL-840 OL-15510-15
Cable Commands: d through h
docsis cvc test
docsis cvc test
To test the root CA public key and CM private key that are installed on the router, use the docsis cvc
test command in global configuration mode.
Cisco uBR905 and Cisco uBR925 cable access routers, and Cisco CVA122 Cable Voice Adapter
docsis cvc test
Syntax Description This command has no arguments or keywords.
Command Default No default behavior or values.
Command Modes Global configuration
Command History Release Modification
12.2(15)CZ This command was introduced on the Cisco uBR905 and Cisco uBR925
cable access routers, and the Cisco CVA122 Cable Voice Adapter.
Usage Guidelines This command verifies that the root CA public key and the private key that are installed in the router at
the factory are valid. The command uses the root CA public key to encrypt a string, and then it uses the
router’s private key to decrypt the key.
Typically, the root CA public key and private key are installed at the factory and never need to be
updated. However, DOCSIS allows the keys to be updated as part of the secure software download
procedure. If this occurs, you can use the docsis cvc test command to verify that the keys are valid and
are properly installed.
Examples The following example shows a typical successful result of the docsis cvc test command:
Router# config terminal
Router(config)# docsis cvc test
Encrypted sting: This is a test
Encrypt result: xxxxxxxxxxxxxxxxxxxxxxxxxxx
Decrypt result: This is a test
Router(config)#
Note If the decrypt result is not “This is a test,” then the test failed, which indicates that either the public key
or the private key is not valid.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-841
Cable Commands: d through h
docsis cvc test
Related Commands Command Description
docsis cvc mfg Configures the manufacturer’s CVC access start time and
organization values.
docsis cvc mso Configures the MSO cosigned CVC access start time and
organization values.
Cisco IOS CMTS Cable Command Reference
CBL-842 OL-15510-15
Cable Commands: d through h
docsis-policy
docsis-policy
To assign a policy to a DOCSIS load balancing group, use the docsis-policy command in the
config-lb-group configuration mode. The policy becomes the default policy assigned to the CM, if the
CM does not choose a different policy. To remove the assigned policy, use the no form of this command.
docsis-policy n
no docsis-policy
Syntax Description n Load balancing group policy number. The policy number can range from 0
to 4294967295.
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.
Examples The following example shows how to assign a policy to a DOCSIS load balancing group on the CMTS,
using the docsis-policy 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)# docsis-policy 1
Config: Last Batch 0, 63 bytes
cable load-balance docsis-group 1 index 81
docsis-policy 1
end
Related Commands Command Description
cable load-balance Configures a DOCSIS load balancing group on the CMTS.
docsis-group
show cable Displays real-time configuration, statistical, and operational information
load-balance for load balancing operations on the router.
docsis-group
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-843
Cable Commands: d through h
docsis-version
docsis-version
To configure the DOCSIS version of the CM for the CMTS tag, use the docsis-version command in the
cmts-tag configuration mode. To remove the configured DOCSIS version from the CMTS tag, use the
no form of this command.
[exclude] docsis-version docsis-version
no docsis-version docsis-version
Syntax Description exclude (Optional) Configures the CMTS tag to exclude the specified DOCSIS
version.
docsis-version DOCSIS version for the CMTS tag. You can select one of the following
DOCSIS versions to match the DOCSIS modems:
• docsis10 - Matches DOCSIS 1.0 modems
• docsis11 - Matches DOCSIS 1.1 modems
• docsis20 - Matches DOCSIS 2.0 modems
• docsis30 - Matches DOCSIS 3.0 modems.
Command Default No default behavior or values.
Command Modes CMTS tag mode (cmts-tag)
Command History Release Modification
12.2(33)SCC This command was introduced.
Examples The following example shows how to configure the specified DOCSIS version for the CMTS tag using
the docsis-version command:
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# cable tag 1
Router(cmts-tag)# docsis-version docsis10
Related Commands Command Description
cable load-balance To configure a DOCSIS load balancing group on the CMTS.
docsis-group
show cable To display real-time configuration, statistical and operational information
load-balance for load balancing operations on the router.
docsis-group
cable tag To configure a tag for a DOCSIS load balancing group on the CMTS.
Cisco IOS CMTS Cable Command Reference
CBL-844 OL-15510-15
Cable Commands: d through h
download
download
To create a DOCSIS configuration file that instructs the CM to download a new software image, use the
download command in cable config-file configuration mode. To disable the specification, use the no
form of this command.
download {image filename [oui oui-list] | server ip-address}
no download {image filename [oui oui-list] | server ip-address}
Note Because of conflicts with other Cisco IOS commands, you cannot abbreviate the no form of this
command. You must specify the complete command name and option, such as no download image or
no download server.
Syntax Description image filename Specifies to download an image file.
oui oui-list Specifies the list of Organizational Unique Identifiers (OUIs), up to a
maximum of 8. (An OUI is the first 3 octets of the CM MAC address and
typically indicates the vendor for the CM.)
Tip The Institute of Electrical and Electronics Engineers (IEEE) is the
official issuer of OUI values. The IEEE OUI web site is at
http://standards.ieee.org/regauth/oui/index.shtml.
server ip-address Specifies the TFTP server IP address. If no IP address is specified, the CM
defaults to using the same TFTP server that provided the configuration file.
Command Default The CM does not download a new software image.
Command Modes Cable config-file configuration
Command History Release Modification
12.1(2)EC1 This command was introduced.
12.2(4)BC1 Support was added to the Release 12.2 BC train.
Usage Guidelines This command sets the Software Upgrade Filename and Software Upgrade TFTP Server fields in the
DOCSIS configuration file. The DOCSIS specification allows the DOCSIS configuration file to specify
that the CM must be running a particular software image. If the CM is not currently using that image, it
must then download the image before continuing the registration process. For security, performance, and
scalability reasons, a particular TFTP server can be specified from which the CM must download the
new software image.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-845
Cable Commands: d through h
download
The filename specified by download image command must be a fully qualified file and pathname that
exactly matches the file and pathname as they exist on the TFTP download server. For example, if the
software image is named ubr920-k1v4y556i-mz and is in a subdirectory named cisco_cms on the TFTP
server, the filename specified with this command should be cisco_cms/ubr920-k1v4y556i-mz.
If the oui-list parameter is specified, the download image filename is provided only to the CMs that
contain those particular OUIs. This helps ensure that the CM does not download a software image that
is intended for another vendor’s CMs.
Note For each configuration file, multiple download images can be specified. Because each filename can be
listed only once, entering a different list of OUIs for a single filename clears the old list. To support more
than eight OUIs with the same file, use a different download software image name, and create a duplicate
file or alias on the TFTP server.
The download server command is not required. If it is not specified, the CM uses the same server that
provided its DOCSIS configuration file. However, the download server command requires that the
image filename also be specified using the download image command.
Examples The following command shows how to setup a DOCSIS configuration file so that the cable modem will
upgrade its software image:
Router(config)# cable config-file upgrade.cm
Router(config-file)# download image ubr920-k1v4y556i-mz.121-3a.T1 oui 00.50.73 00.D0.BA
00.D0.58 00.01.96
Router(config-file)# download server 10.15.24.33
Router(config-file)# exit
Router(config)#
Related Commands Command Description
cable config-file Creates a DOCSIS configuration file and enters configuration file mode.
access-denied Disables access to the network.
channel-id Specifies upstream channel ID.
cpe max Specifies CPE information.
frequency Specifies downstream frequency.
option Provides config-file options.
privacy Specifies privacy options for baseline privacy images.
service-class Specifies service class definitions for the configuration file.
snmp manager Specifies Simple Network Management Protocol (SNMP) options.
timestamp Enables time-stamp generation.
Cisco IOS CMTS Cable Command Reference
CBL-846 OL-15510-15
Cable Commands: d through h
downstream
downstream
To set downstream radio frequency (RF) channels, use the downstream command in the
config-lb-group configuration mode. To reset the downstream RF channels, use the no form of this
command.
Cisco uBR7200 Series Routers
downstream cable {slot/port}
no downstream cable {slot/port}
Cisco uBR10012 Router
downstream {cable {slot/subslot/port} | Integrated-Cable {slot/subslot/bay} {rf-channel group
list}| Modular-Cable {slot/subslot/bay}{rf-channel group list}}
no downstream {cable {slot/subslot/port} | Integrated-Cable {slot/subslot/bay} {rf-channel
group list}| Modular-Cable {slot/subslot/bay}{rf-channel group list}}
Syntax Description cable {slot/port} Specifies the CMTS interface slot and port numbers.
cable Specifies the CMTS interface slot, subslot, and port numbers.
{slot/subslot/port}
Integrated-Cable Specifies the integrated cable interface with the list of port numbers that
{rf-channel group range in the associated RF channel. Slot, subslot, and bay numbers of the
list}{slot/subslot/bay} integrated cable interface is also specified.
Modular-Cable Specifies the modular cable interface with the list of port numbers that range
{rf-channel group in the associated RF channel. It also specifies slot, subslot, and bay numbers
list}} {slot/subslot/bay} of the modular cable interface.
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.
Examples The following example shows how to set downstream RF channels to a DOCSIS load balancing group
on the CMTS, using the downstream 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)# downstream cable 1/1
Router(config-lb-group)# downstream Integrated-Cable 5/0/0 rf-channel 2
Router(config-lb-group)# downstream Modular-Cable 1/0/0 rf-channel 4
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-847
Cable Commands: d through h
downstream
Related Commands Command Description
cable load-balance Configures a DOCSIS load balancing group on the CMTS.
docsis-group
show cable Displays real-time configuration, statistical, and operational information
load-balance for load balancing operations on the router.
docsis-group
Cisco IOS CMTS Cable Command Reference
CBL-848 OL-15510-15
Cable Commands: d through h
downstream cable
downstream cable
To assign a primary downstream channel for a fiber node, use the downstream cable command in cable
fiber-node configuration mode. To remove a primary downstream channel for a fiber node, use the no
form of the command.
downstream cable slot/subslot/port
no downstream cable slot/subslot/port
Syntax Description slot The slot used for the cable interface line card. Valid values are 5 to 8.
subslot The subslot used for the cable interface line card. Valid values are 0 or 1.
port The downstream port that can be used as a primary downstream channel.
Valid values are 0 to 4.
Command Default If the downstream cable command is not issued, no primary downstream channel is assigned to the fiber
node.
Command Modes Cable fiber-node configuration
Command History Release Modification
12.3(21)BC This command was introduced for the uBR10012 router.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
Usage Guidelines For each fiber node, a traditional DOCSIS downstream channel is used to carry MAC management and
signaling messages, and the associated traditional DOCSIS upstream channel is used for return data
traffic and signaling. The traditional DOCSIS downstream channel used in this way is called the primary
downstream channel.
The downstream cable command assigns a primary downstream channel for a fiber node. Each fiber
node must be assigned at least one primary downstream channel and can be assigned multiple primary
downstream channels. Cisco IOS software decides which primary downstream channel to use for the
fiber node from the set of channels assigned with downstream cable. Assigning more than one primary
channel to a fiber node with the downstream cable command can be useful for load-balancing purposes.
Note If the primary downstream channel for the fiber node is assigned from a SPA downstream, then the
downstream cable command is not required.
If a wideband-capable modem registers as a traditional DOCSIS 2.0 modem, it will register on a
downstream channel as follows:
• If the modem’s fiber node has been assigned a primary downstream channel with the downstream
cable command, the modem registers on that downstream channel.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-849
Cable Commands: d through h
downstream cable
If the modem’s fiber node has not been assigned a primary downstream channel with the downstream
cable command, the modem can register on any downstream channel that is visible to it.
For more information on using this command, refer to the Cisco uBR10012 Universal Broadband Router
SIP and SPA Software Configuration Guide.
Examples The following example shows how to assign a primary downstream channel for fiber node 5. The
primary downstream channel is the downstream port located on the cable interface line card at
slot/subslot/port 6/0/0.
Router# configure terminal
Router(config)# cable fiber-node 5
Router(config-fiber-node)# downstream cable 6/0/0
Related Commands Command Description
cable fiber-node Enters cable fiber-node configuration mode so that you can configure
a fiber node.
description (cable fiber-node) Specifies a description for a fiber node.
downstream modular-cable Specifies the RF channels that are available for wideband channels
rf-channel on a fiber node.
upstream cable connector Specifies the upstream channel ports for a fiber node.
Cisco IOS CMTS Cable Command Reference
CBL-850 OL-15510-15
Cable Commands: d through h
downstream integrated-cable rf-channel (interface)
downstream integrated-cable rf-channel (interface)
To associate a set of upstream channels to the integrated downstream channels, use the downstream
integrated-cable rf-channel command in interface configuration mode.
downstream integrated-cable slot/card/port rf-channel rf-channels [upstream grouplist]
Syntax Description slot Identifies the chassis slot where the Cisco 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.
card (Cisco uBR10012 only) Secondary slot number of the cable interface line
card. The valid subslots are 0 or 1.
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.
rf-channel rf-channel Specifies association of the downstream channels to the channel group
descriptor. The valid range is from 0 to 3.
upstream grouplist Specifies the logical identifier of upstream channels serving these
downstream RF channels. The valid range is from 0 to 7.
Command Default No default upstream channels are configured with the integrated downstream channels.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCB This command was introduced.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-851
Cable Commands: d through h
downstream integrated-cable rf-channel (interface)
Examples The following example shows how to use the downstream integrated-cable rf-channel command on
the Cisco uBR10012 router.
Router# configure terminal
Router(config)# interface cable 7/0/0
Router(config-if)# downstream integrated-Cable 7/0/0 rf-channel 1 upstream 1
Associated Features The downstream integrated-cable rf-channel command is used to configure the following:
• Configuring the Cisco UBR-MC20X20V Cable Interface Line Card
• Configuring the Cisco uBR-MC88V Cable Interface Line Card
Related Commands Command Description
cable upstream max-ports Configures the maximum number of upstreams on a MAC domain
on a line card.
Cisco IOS CMTS Cable Command Reference
CBL-852 OL-15510-15
Cable Commands: d through h
downstream local upstream
downstream local upstream
To restrict the set of Cisco uBR10-MC5X20 upstreams associated with the Cisco uBR10-MC5X20
downstreams, use the downstream local upstream command in interface configuration mode.
downstream local upstream grouplist
Syntax Description grouplist Specifies the number of upstreams associated with the
Cisco uBR10-MC5X20 downstream channels.
Command Default All upstreams under the cable interface are associated with the Cisco uBR10-MC5X20 downstreams.
Command Modes Interface configuration mode (config-if)
Command History Release Modification
12.3(23)BC This command was introduced for the Cisco uBR10012 router.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.2(33)SCB.
Usage Guidelines Use this command to restrict a set of Cisco uBR10-MC5X20 upstreams to Cisco uBR10-MC5X20
downstreams. This restricts MAC management messages (MMM) to be sent to the specified upstreams
only.
Examples The following example shows how the downstream local upstream command is used in the
Cisco uBR10012 router.
Router# configure terminal
Router (config)# interface cable 5/1/0
Router(config-if)# downstream local upstream 0-1
Related Commands Command Description
downstream cable Assigns a primary downstream channel for a fiber node.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-853
Cable Commands: d through h
downstream modular-cable rf-channel (interface)
downstream modular-cable rf-channel (interface)
To associate a set of Cisco uBR10-MC5X20 upstreams with individual modular downstream channels
from the SPA into a given cable MAC domain, use the downstream modular-cable rf-channel
command in interface configuration mode.
Cisco IOS Release 12.3(23)BC
downstream modular-cable slot/subslot/bay rf-channel rf channels [upstream grouplist]
Cisco IOS Release 12.2(33)SCB and later
downstream modular-cable slot/bay/port rf-channel rf channels [upstream grouplist]
Cisco IOS Release 12.2(33)SCE and later
downstream modular-cable slot/subslot/controller rf-channel rf channels [upstream grouplist]
Syntax Description slot Slot where a SIP resides. On the Cisco uBR10012 router, slots 1 and 3 can
be used for SIPs.
For the Cisco uBR-MC3GX60V cable interface line card, the cable interface
slot values range from 5 to 8.
subslot Subslot where a SIP resides. On the Cisco uBR10012 router, subslot 0 is
always specified.
bay Bay in a SIP where a SPA is located. The valid values are 0 (upper bay) and
1 (lower bay).
port Interface number on the SPA.
controller Modular-Cable controller number. The valid values are 0 to 2.
Note This option is available only on the Cisco uBR-MC3GX60V cable
interface line card and on the Cisco router running Cisco IOS
Release 12.2(33)SCE and later releases.
rf-channel Specifies the association of a continuous range of RF channels within the
SPA downstream.
rf channels Range of RF channel physical ports on the SPA FPGA.
upstream Specifies a set of ranges of upstream to allow association of a noncontiguous
list of upstreams to one or more SPA downstreams.
grouplist Number of upstreams with the modular cable downstream channel.
Command Default No default upstream channels are configured with the modular downstream channels.
Command Modes Interface configuration (config-if)
Cisco IOS CMTS Cable Command Reference
CBL-854 OL-15510-15
Cable Commands: d through h
downstream modular-cable rf-channel (interface)
Command History Release Modification
12.3(23)BC This command was introduced for the Cisco uBR10012 router.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.2(33)SCB. This
command was modified to change the addressing format for the modular
cable interface from slot/subslot/bay to slot/bay/port.
12.2(33)SCE This command was modified to change the valid range of slot.
Usage Guidelines Use this command to create primary-capable channels by associating a single or a set of
Cisco uBR10-MC 5X20 upstream channels with individual modular downstream channels on a fiber
node. When a primary-capable channel is created, the same modular downstream channel cannot be used
as a primary-capable channel in another MAC domain. However, it can be used as non-primary-capable
channel in another MAC domain.
Examples The following example shows how to use the downstream modular-cable rf-channel command on the
Cisco uBR10012 router.
Router# configure terminal
Router (config)# interface cable 5/1/0
Router(config-if)# downstream modular-cable 1/0/0 rf-channel 0-2 upstream 0-1 4-5
Related Commands Command Description
downstream modular-cable rf-channel Specifies the RF channels that are available for wideband
channels on a fiber node.
rf-channel cable downstream Assigns a downstream channel ID to an RF channel.
channel-id
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-855
Cable Commands: d through h
downstream modular-cable rf-channel
downstream modular-cable rf-channel
To specify the RF channels that are available for wideband channels on a fiber node, use the
downstream modular-cable rf-channel command in cable fiber-node configuration mode. To remove
RF channels that are available for wideband channels on a fiber node, use the no form of this command.
Cisco IOS Release 12.3(23)BC
downstream modular-cable slot/subslot/bay rf-channel {rf-port | low-high}
no downstream modular-cable slot/subslot/bay rf-channel {rf-port | low-high}
Cisco IOS Release 12.2(33)SCB
downstream modular-cable slot/bay/port rf-channel {rf-port | low-high}
no downstream modular-cable slot/bay/port rf-channel {rf-port | low-high}
Syntax Description slot The slot where a SIP resides. On the Cisco uBR10012 router, slots 1 and 3
can be used for SIPs.
subslot The subslot where a SIP resides. On the Cisco uBR10012 router, subslot 0 is
always specified.
bay The bay in a SIP where a SPA is located. Valid values are 0 (upper bay) and
1 (lower bay).
port Specifies the interface number on the SPA.
rf-port Specifies the RF channel physical port on the Wideband SPA FPGA. Valid
values for rf-port depend on the configuration set with the annex modulation
command.
low-high A range of RF channel physical ports on the Wideband SPA FPGA. The low
and high values are separated by a hyphen.
Command Default If the downstream modular-cable rf-channel command is not issued, no RF channels are configured
for wideband channels on the fiber node.
Command Modes Cable fiber-node configuration (fiber-node)
Command History Release Modification
12.3(21)BC This command was introduced for the Cisco uBR10012 router.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
12.2(33)SCB This command was modified to change the addressing format for the modular
cable interface from slot/subslot/bay to slot/bay/port.
Cisco IOS CMTS Cable Command Reference
CBL-856 OL-15510-15
Cable Commands: d through h
downstream modular-cable rf-channel
Usage Guidelines The downstream modular-cable rf-channel command makes RF channels available for use on a fiber
node. Fiber node software configuration mirrors the physical topology of the cable network. The cable
rf-channel command configures the RF channels that will be used for a wideband channel on a
Wideband SPA.
The Cisco uBR10012 router supports two Wideband SPAs. Each Wideband SPA supports up to 24 RF
channels depending on how the SPA is configured with the annex modulation command.
Note Effective with Cisco IOS Release 12.3(23)BC, the annex modulation command is obsolete and annex
and modulation are included as keyword options in the rf-channel frequency command.
• For annex A and 256 QAM, each Wideband SPA supports 18 RF channels. In this case, valid values
for the rf-port argument are 0 to 17.
• For all other cases, the SPA supports 24 RF channels. In these cases, valid values for the rf-port
argument are 0 to 23.
A fiber node can be configured to have RF channels from one or both Wideband SPAs. However, a
wideband channel cannot be comprised of RF channels from two different SPAs.
Each time the downstream modular-cable rf-channel command is issued for a fiber node, the set of
RF channels that are available for use on that fiber node is added to in a cumulative manner. For
example, if the following downstream modular-cable rf-channel commands were issued, the set of RF
channels available for fiber node 1 is RF channels 0 to 10 on the Wideband SPA in slot/subslot/bay 1/0/0.
Router# configure terminal
Router(config)# cable fiber-node 1
Router(config-fiber-node)# downstream modular-cable 1/0/0 rf-channel 0-5
Router(config-fiber-node)# downstream modular-cable 1/0/0 rf-channel 6-10
Examples The following example shows how to specify that RF channels 0 to 7 on a Wideband SPA will be
available for use on fiber node 5. The Wideband SPA is located in slot/subslot/bay 1/0/0.
Router# configure terminal
Router(config)# cable fiber-node 5
Router(config-fiber-node)# downstream modular-cable 1/0/0 rf-channel 0-7
Related Commands Command Description
cable fiber-node Enters cable fiber-node configuration mode to configure a fiber node.
description (cable fiber-node) Specifies a description for a fiber node.
downstream cable Assigns a primary downstream channel for a fiber node.
upstream cable connector Specifies the upstream channel ports for a fiber node.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-857
Cable Commands: d through h
duration
duration
To specify the time period and sample rate to be used for monitoring subscribers, use the duration
command in enforce-rule configuration mode. To reset an enforce-rule to its default values, use the no
form of this command.
duration minutes avg-rate rate sample-interval minutes [penalty minutes] {upstream |
downstream} [enforce]
no duration
Syntax Description minutes Specifies the size of the sliding window (in minutes) during which
subscriber usage is monitored. The valid range is 10 to 44640 with a
default of 360 (6 hours).
avg-rate rate Specifies the average sampling rate in kilobits per second for the
specified duration. The valid range is 1 to 400000 kilobits with no
default.
sample-interval minutes Specifies how often (in minutes) the CMTS router should sample a
service flow to get an estimate of subscriber usage. The valid range is 1
to 30, with a default value of 15.
penalty minutes (Optional) Specifies the period (in minutes) during which a cable
modem (CM) can be under penalty. The valid range is 1 to 10080.
upstream Specifies monitoring of traffic in the upstream direction.
downstream Specifies monitoring of traffic in the downstream direction.
enforce (Optional) Specifies that the enforce-rule QoS profile should be applied
automatically if a user violates their registered QoS profile.
Command Default The duration value defaults to 360 minutes (6 hours), and the sample-interval value defaults to 15
minutes.
Command Modes Enforce-rule configuration (enforce-rule)
Command History Release Modification
12.3(9a)BC This command was introduced. This command replaces the
monitoring-duration command.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
12.2(33)SCD2 The penalty keyword option was added.
Cisco IOS CMTS Cable Command Reference
CBL-858 OL-15510-15
Cable Commands: d through h
duration
Usage Guidelines
Note This command is applicable only after the monitoring-basics command is configured with the keyword
legacy.
When you enable an enforce-rule, the CMTS router periodically checks the bandwidth being used by
subscribers to determine whether any subscribers are consuming more bandwidth than that specified by
the avg-rate configured in enforce-rule. The CMTS router keeps track of subscribers using a sliding
window that begins at each sample interval and continues for the duration period and average rate.
For example, with the default sample interval of 15 minutes and the default sliding window period of
360 minutes, the CMTS router samples the bandwidth usage every 15 minutes and counts the total bytes
transmitted at the end of each 360-minute period. Each sample interval begins a new sliding window
period for which the CMTS router keeps track of the total bytes transmitted.
Note Changing the duration minutes, avg-rate rate, or sample-interval minutes values resets the byte
counters for that particular enforce-rule and begins a new sliding window period.
When you change the configuration of a currently active enforce-rule, that rule begins using the new
configuration immediately to manage the cable modems tracked by this enforce-rule.
The penalty duration, which is configured using this command, is unique to weekdays, and takes
precedence over the global penalty duration configured using the penalty-period command.
When you use the show running-configuration command to display the configuration, the keyword
options for the duration command are truncated. In the following example, “pen” represents penalty,
“do” represents downstream, and “enf” represents enforce:
Router# show running-configuration
.
.
.
duration 10 avg-rate 1 sample-interval 10 pen 11 do enf
For more information about the Subscriber Traffic Management feature and to see an illustration of a
sample monitoring window, refer to the Subscriber Traffic Management for the Cisco CMTS Routers
feature document on Cisco.com.
Examples The following example shows an enforce-rule being configured for a sliding window that is 20 minutes
in length, an avg-rate of 1 kilobit per second, and a sampling interval of every 10 minutes.
Router# configure terminal
Router(config)# cable qos enforce-rule residential
Router(enforce-rule)# duration 20 avg-rate 1 sample-interval 10 penalty 11 do enf
Related Commands Command Description
cable qos enforce-rule Creates an enforce-rule to enforce a particular QoS profile for
subscriber traffic management and enters enforce-rule
configuration mode.
enabled (enforce-rule) Activates an enforce-rule and begins subscriber traffic management
on a Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-859
Cable Commands: d through h
duration
Command Description
debug cable Displays enforce-rule debug messages for subscriber traffic
subscriber-monitoring management on the Cisco CMTS routers.
monitoring-basics Specifies the type of monitoring for subscriber traffic management
on a Cisco CMTS router.
peak-time1 Specifies peak and offpeak monitoring times on a Cisco CMTS
router.
penalty-period Specifies the period for which an enforced quality of service (QoS)
profile should be in force for subscribers who violate their
registered QoS profile.
qos-profile registered Specifies the registered QoS profile that should be used for this
enforce-rule. This command is applicable only for DOCSIS 1.0
cable modems.
qos-profile enforced Specifies a QoS profile that should be enforced when users violate
their registered QoS profile. This command is applicable only for
DOCSIS 1.0 cable modems.
service-class (enforce-rule) Specifies a service class (enforced or registered) that should be used
for cable modem monitoring in an enforce-rule. This command is
applicable for DOCSIS 1.1 or later cable modems.
show cable qos enforce-rule Displays the QoS enforce-rules that are currently defined.
show cable subscriber-usage Displays subscribers who are violating their registered QoS
profiles.
weekend duration Configures different subscriber monitoring options over weekends
on a Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
CBL-860 OL-15510-15
Cable Commands: d through h
enabled (enforce-rule)
enabled (enforce-rule)
To activate an enforce-rule and begin subscriber traffic management on a Cisco CMTS router, use the
enabled command in enforce-rule configuration mode. To disable the enforce-rule without deleting it,
use the no form of this command.
enabled
no enabled
Syntax Description This commands has no keywords or arguments.
Command Default Enforce-rules are disabled.
Command Modes Enforce-rule configuration (enforce-rule)
Command History Release Modification
12.2(15)BC1 This command was introduced.
12.3(9a)BC This command was integrated into Cisco IOS Release 12.3(9a)BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.2(33)SCB.
Usage Guidelines An enforce-rule is created and configured using the cable qos enforce-rule command, but it is not
activated until you run the enabled command. Use the no enabled command to disable an enforce-rule
without removing it from the CMTS configuration. When you disable an enforce-rule, all cable modems
with that rule’s registered QoS profile are no longer tracked by the Subscriber Traffic Management
feature and all cable modems in penalty are moved to their registered QoS profile.
Examples The following example shows an enforce-rule being enabled:
Router# configure terminal
Router(config)# cable qos enforce-rule residential
Router(enforce-rule)# enabled
The following example shows an enforce-rule being disabled. The rule remains in the CMTS
configuration file.
Router# configure terminal
Router(config)# cable qos enforce-rule residential
Router(enforce-rule)# no enabled
Related Commands
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-861
Cable Commands: d through h
enabled (enforce-rule)
Command Description
cable qos enforce-rule Creates an enforce-rule to enforce a particular QoS profile for subscriber
traffic management and enters enforce-rule configuration mode.
qos-profile enforced Specifies a QoS profile that should be enforced when users violate their
registered QoS profiles.
duration Specifies the time period and sample rate to be used for monitoring
subscribers.
penalty-period Specifies the time period that an enforced QoS profile should be in effect for
subscribers that violate their registered QoS profiles.
qos-profile registered Specifies the registered QoS profile that should be use for this enforce-rule.
show cable qos Displays the QoS enforce-rules that are currently defined.
enforce-rule
show cable Displays subscribers who are violating their registered QoS profiles.
subscriber-usage
Cisco IOS CMTS Cable Command Reference
CBL-862 OL-15510-15
Cable Commands: d through h
enforced qos-profile
enforced qos-profile
Note Effective with Cisco IOS Release 12.3(9a)BC, the enforced qos-profile command is replaced by the
qos-profile enforced command.
To specify a quality of service (QoS) profile that should be enforced when users violate their registered
QoS profiles, use the enforced qos-profile command in enforce-rule configuration mode. To delete the
enforced QoS profile from the enforce-rule, use the no form of this command.
enforced qos-profile profile-id [no-persistence]
no enforced qos-profile profile-id [no-persistence]
Syntax Description profile-id Specifies the QoS profile to be enforced. The valid range is 0 to 16383,
with a default of 0.
no-persistence (Optional) Specifies that the enforced QoS profile should not remain
in force when a cable modem reboots. Instead, when a cable modem
(CM) that is in the penalty period reboots, it is automatically removed
from the penalty period and assigned the QoS profile that is specified
in its DOCSIS configuration file.
The default is without this option, so that enforced QoS profiles remain
in effect for cable modems across reboots.
Command Default The profile ID defaults to 0, and enforced QoS profiles are persistent across cable modem reboots.
Command Modes Enforce-rule configuration (enforce-rule)
Command History Release Modification
12.2(15)BC1 This command was introduced.
12.3(9a)BC This command was replaced by the qos-profile enforced command.
Usage Guidelines Both the originally provisioned QoS profile and the enforced QoS profile must be created on the
Cisco CMTS router. This command does not support profiles that are created by the cable modem.
An enforce-rule can specify an enforced QoS profile, which is automatically applied to subscribers that
transmit more traffic than what is allowed by their registered QoS profile. The enforced QoS profile
remains in effect during the penalty time period (see the penalty-period command). At the end of the
penalty period, the subscriber returns to their registered QoS profile.
If a cable modem reboots while it is in its penalty time period, it continues using the enforced QoS
profile, unless the service provider has manually changed the cable modem’s registered QoS profile
using the cable modem qos profile command.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-863
Cable Commands: d through h
enforced qos-profile
When you change the enforced QoS profile for a currently active enforce-rule, any cable modems using
this rule that are currently in the penalty period continue using the previously configured enforced QoS
profile. Any cable modems that enter the penalty period after this configuration change, however, use
the new enforced QoS profile.
An enforced QoS profile must already have been created on the Cisco CMTS router before you can
assign it to an enforce-rule. If the rule does not exist, the system displays an error message.
When the no-persistence option is specified, the enforced QoS profile is still automatically applied to
subscribers that violate their bandwidth requirements. However, when the cable modem reboots, the
Cisco CMTS router allows the cable modem to use the QoS profile that is specified in its DOCSIS
configuration file.
The no-persistence option can be used when initially using subscriber traffic management to identify
potential problem applications and users. When repeat offenders are identified, they can then be assigned
enforce-rules that do not use the no-persistence option, so that they remain in the penalty period even
if they reboot their cable modems.
Note In software releases prior to Cisco IOS Release 12.3(9a)BC, the system automatically applies the
enforced QoS profile to violators only if the enforce keyword has been used with the activate-rule
at-byte-count command.
Examples The following example shows profile 12 being assigned as the enforced QoS profile to an enforce-rule:
Router# configure terminal
Router(config)# cable qos enforce-rule residential
Router(enforce-rule)# enforced qos-profile 12
The following example shows profile 12 being assigned as the enforced QoS profile to an enforce-rule,
but with the no-persistence option specified, so that the enforced QoS profile does not remain in force
if the cable modem reboots:
Router# configure terminal
Router(config)# cable qos enforce-rule residential
Router(enforce-rule)# enforced qos-profile 12 no-persistence
The following example shows the error message that is displayed when the specified QoS profile does
not exist on the CMTS:
Router# configure terminal
Router(config)# cable qos enforce-rule test
Router(enforce-rule)# enforced qos-profile 98
The qos profile 98 doesn't exist or it's a cm created QoS profile
Related Commands Command Description
activate-rule Specifies the number of bytes that a subscriber can transmit during the
at-byte-count monitoring period on a Cisco CMTS router.
cable qos enforce-rule Creates an enforce-rule to enforce a particular QoS profile for subscriber
traffic management and enters enforce-rule configuration mode.
enabled (enforce-rule) Activates an enforce-rule and begins subscriber traffic management on a
Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
CBL-864 OL-15510-15
Cable Commands: d through h
enforced qos-profile
Command Description
duration Specifies the time period and sample rate to be used for monitoring
subscribers.
penalty-period Specifies the time period that an enforced QoS profile should be in effect for
subscribers that violate their registered QoS profiles.
qos-profile registered Specifies the registered QoS profile that should be used for this enforce-rule.
show cable qos Displays the QoS enforce-rules that are currently defined.
enforce-rule
show cable Displays subscribers who are violating their registered QoS profiles.
subscriber-usage
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-865
Cable Commands: d through h
exception pxf
exception pxf
To control the core dumps that are generated when an exception occurs in one of the Parallel eXpress
Forwarding (PXF) columns, use the exception pxf command in global configuration mode. To disable
the creation of core dumps during PXF exceptions, use the no form of this command.
exception pxf {core-file filename | flash device | style {full | localized | minimal | smart} }
no exception pxf {core-file | flash | style }
Syntax Description core-file filename Sets the filename for the core-dump file generated during a PXF exception.
flash device Specifies the Flash memory device on which to save the core-dump file
generated during a PXF exception.
style Specifies the type of core-dump file to be generated during a PXF
exception.
full Creates a full core-dump file of all PXF columns.
localized Creates a core-dump file of the PXF column that failed, along with its
neighboring columns.
minimal Creates a minimal core-dump file of the PXF exception.
smart Creates a core-dump file that contains the data related to the PXF exception.
Defaults Core dumps are not generated during PXF exceptions.
Command Modes Global configuration
Command History Release Modification
12.2(4)XF1 This command was introduced for the Cisco uBR10012 router.
Usage Guidelines
Caution Use the exception pxf command only under the direction of a technical support representative. Creating
a core dump can disrupt network operations. The core dump is a large binary file that can be interpreted
only by technical personnel who have access to source code and detailed memory maps.
Examples The following example shows how to specify that the Cisco uBR10012 router should create a minimal
core-dump file for PXF exceptions, and that this file should be named ubr10k-pxf and be written to the
disk1 device:
Router# configure terminal
Router(config)# exception pxf style minimal
Router(config)# exception pxf core-file ubr10k-pxf
Cisco IOS CMTS Cable Command Reference
CBL-866 OL-15510-15
Cable Commands: d through h
exception pxf
Router(config)# exception pxf flash disk1:
Router(config)#
Related Commands Command Description
show pxf xcm Displays the current state of error checking and correcting (ECC) for the
External Column Memory (XCM) on the Parallel eXpress Forwarding
(PXF) processor.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-867
Cable Commands: d through h
facility-alarm (ubr10012)
facility-alarm (ubr10012)
To set the temperature thresholds at which the Performance Routing Engine (PRE) module generates a
critical, major, or minor alarm to warn of potential equipment damage, use the facility-alarm command
in global configuration mode. To disable the temperature alarms, use the no form of this command.
facility-alarm {core-temperature | intake-temperature}
{critical exceed-action shutdown | major [temp] | minor [temp]}
no facility-alarm {core-temperature | intake-temperature}
{critical exceed-action shutdown | major [temp] | minor [temp]}
Syntax Description core-temperature Specifies the temperature threshold for the temperature sensors near the
center of the PRE module.
intake-temperature Specifies the temperature threshold for the temperature sensors at the air
intake slots.
critical exceed-action In Cisco IOS Release 12.2(11)BC1 and later releases, specifies that a
shutdown critical temperature alarm should shut down the router after two minutes.
This was the default behavior in previous releases.
major [temp] Specifies the temperature, in degrees Centigrade, at which the PRE module
generates a major alarm to warn of potential damage from excessive
temperatures.
The valid range for temp is 20 to 67 degrees Centigrade, with a default of
58 for the core temperature threshold and 54 for the intake-temperature
threshold.
minor [temp] Specifies the temperature, in degrees Centigrade, at which the PRE module
generates a minor alarm to warn of potential damage from excessive
temperatures.
The valid range for temp is 20 to 67 degrees Centigrade, with a default of
50 for the core temperature threshold and 45 for the intake-temperature
threshold.
Defaults If no specific temperature is given, that particular facility alarm is reset to its default value. The default
core temperature thresholds are 85 (critical), 58 (major), and 50 (minor). The default intake-temperature
thresholds are 72 (critical), 54 (major), and 45 (minor) degrees Centigrade.
In Cisco IOS releases previous to Cisco IOS Release 12.2(11)BC1, a critical alarm automatically shuts
down the router after two minutes to prevent temperature damage. In Cisco IOS Release 12.2(11)BC1
and later, a critical alarm by default does not shut down the router.
Note The default temperature thresholds for the critical core and intake temperatures were changed in
Cisco IOS Release 12.2(11)BC1.
Command Modes Global configuration (config)
Cisco IOS CMTS Cable Command Reference
CBL-868 OL-15510-15
Cable Commands: d through h
facility-alarm (ubr10012)
Command History Release Modification
12.2(1)XF1 This command was introduced for the Cisco uBR10012 router.
12.2(11)BC1 The critical exceed-action shutdown option was added. In addition, the
default value for the core critical temperature threshold was raised from 57
to 67 degrees Centigrade, and the default value for the intake critical
temperature threshold was raised from 60 to 85 degrees Centigrade.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
Usage Guidelines
Note The facility-alarm core-temperature critical and facility-alarm intake-temperature critical
commands are available only if the service internal command is defined in the configuration.
The PRE module on the Cisco uBR10012 router contains temperature sensors that monitor the
temperature at the air intake slots and on the PRE module itself. The facility-alarm command configures
the router for the temperature thresholds that will generate a minor, major, or critical alarm, so as to
notify the system operators of the temperature problem before excessive heat can damage the router or
any of its components.
Before Cisco IOS Release 12.2(11)BC1, a critical alarm would also automatically shut down the router
after two minutes. Cisco IOS Release 12.2(11)BC1 made this automatic shutdown a configurable option,
so that the system operators can decide whether or not a critical alarm should power down the router.
As a general rule, do not disable the automatic shutdown of the router unless you have a systems operator
available to immediately respond to any critical temperature alarms, because this could result in system
damage. Typically, the primary reason to disable the automatic shutdown would be if you are replacing
the fan tray assembly and want to ensure that the router does not power down if the procedure takes
longer than expected.
Note A line card also automatically shuts itself down if the temperature exceeds operational levels. In
addition, the AC and DC PEMs also automatically power down if they exceed their operational
temperature. However, high temperatures could still cause damage to other components if the problem
is not quickly resolved.
Examples The following example shows how to configure the Cisco uBR10012 router so that it generates a minor
alarm when the intake temperature exceed 55°C:
Router# configure terminal
Router(config)# facility-alarm intake-temperature minor 55
The following example shows how to configure the Cisco uBR10012 router to automatically shut down
if the high temperature continues for more than two minutes:
Router# configure terminal
Router(config)# service internal
Router(config)# facility-alarm core-temperature critical exceed-action shutdown
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-869
Cable Commands: d through h
facility-alarm (ubr10012)
The following example shows how to disable the automatic shutdown feature for both the core and
intake temperatures. A critical alarm is still generated when the default critical temperatures are
exceeded, but the router does not automatically shut itself down:
Router# configure terminal
Router(config)# no facility-alarm core-temperature critical exceed-action shutdown
Router(config)# no facility-alarm intake-temperature critical exceed-action shutdown
The following commands disable major and minor alarms for both the core and intake temperature
thresholds (but critical alarms are still generated):
Router# configure terminal
Router(config)# no facility-alarm core-temperature major
Router(config)# no facility-alarm core-temperature minor
Router(config)# no facility-alarm intake-temperature major
Router(config)# no facility-alarm intake-temperature minor
Related Commands Command Description
clear facility-alarm Clears some or all of the facility alarms on the Cisco uBR10012 router.
show facility-alarm Displays the current temperature thresholds that will trigger a facility
status alarm.
Cisco IOS CMTS Cable Command Reference
CBL-870 OL-15510-15
Cable Commands: d through h
hccp authentication
hccp authentication
To specify the authentication algorithm on a working or protect cable interface, or both use the hccp
authentication command in cable interface configuration mode. To disable authentication on a Working
CMTS or Protect CMTS, use the no form of this command.
hccp group authentication {md5 | text}
no hccp group authentication {md5 | text}
Syntax Description group The group number for the specified interface. Valid values are any number
from 1 to 255, inclusive.
md5 Authentication algorithm. In Cisco IOS Release 12.1(3a)EC, MD5 is the
only authentication algorithm supported.
text Unencrypted text specification. Rather than automatically encrypting the
authentication key-chain when using the MD5 authentication algorithm,
Cisco IOS software simply passes the authentication key-chain as standard,
unencrypted text.
Command Default The default authentication algorithm is MD5.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.1(3a)EC This command was introduced for the Cisco uBR7200 series routers.
12.1(7)EC1 Support was added for the Cisco uBR-MC16S cable interface line card.
12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012
12.2(4)BC1 router and Cisco uBR-LCP-MC28C card.
12.2(8)BC2 Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012
router and Cisco uBR-LCP-MC16C, Cisco uBR-LCP-MC16E, and
Cisco uBR-LCP-MC16S cards.
12.2(11)BC1 Support was added for the N+1 (1:n) RF Switch with the
Cisco uBR7246VXR router and Cisco uBR-MC16C, Cisco uBR-MC16S,
and Cisco uBR-MC28C cards.
12.2(15)BC1 Support was added for the Cisco uBR-MC5X20U/S BPE on the
Cisco uBR10012 router.
12.3(17a)BC2 Support was added for the Cisco uBR-MC5X20H BPE on the
Cisco uBR10012 router.
12.3(21)BC This command is obsolete on the Cisco uBR7246VXR router.
Usage Guidelines Use this command together with the hccp authentication key-chain command to enable and specify the
type of N+1 redundancy authentication you will use in your protection scheme.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-871
Cable Commands: d through h
hccp authentication
Examples The following example shows how to specify MD5 as the authentication algorithm for group 1:
Router(config-if)# hccp 1 authentication md5
Related Commands Command Description
hccp authentication key-chain Enables authentication on a given interface and specifies one or more
keys that can be used to perform authentication for a specified group.
show hccp Displays information for all cable interfaces on which one or more
HCCP groups and authentication modes have been configured.
show hccp interface Displays group information for a specific cable interface on which
one or more groups and authentication modes have been configured.
Cisco IOS CMTS Cable Command Reference
CBL-872 OL-15510-15
Cable Commands: d through h
hccp authentication key-chain
hccp authentication key-chain
To enable authentication and define one or more authentication keys to use in a specified group, use the
hccp authentication key-chain command in cable interface configuration mode. To disable
authentication, use the no form of this command. The key chains you define must match one or more
key chains configured in the Working CMTS or Protect CMTS configuration file.
hccp group authentication key-chain key-chain
no hccp group authentication key-chain [key-chain]
Syntax Description group The group number for the specified interface. Valid values are any number
from 1 to 255, inclusive.
key-chain A text string matching a key chain in the Working CMTS or Protect CMTS
configuration file. A key chain must have at least one key and can have up to
2,147,483,647 keys.
Command Default No default behavior or values
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.1(3a)EC This command was introduced for the Cisco uBR7200 series routers.
12.1(7)EC1 Support was added for the Cisco uBR-MC16S cable interface line card.
12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012
12.2(4)BC1 router and Cisco uBR-LCP-MC28C card.
12.2(8)BC2 Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012
router and Cisco uBR-LCP-MC16C, Cisco uBR-LCP-MC16E, and
Cisco uBR-LCP-MC16S cards.
12.2(11)BC1 Support was added for the N+1 (1:n) RF Switch with the
Cisco uBR7246VXR router and Cisco uBR-MC16C, Cisco uBR-MC16S,
and Cisco uBR-MC28C cards.
12.2(15)BC1 Support was added for the Cisco uBR-MC5X20U/S BPE on the
Cisco uBR10012 router.
12.3(17a)BC2 Support was added for the Cisco uBR-MC5X20H BPE on the
Cisco uBR10012 router.
12.3(21)BC This command is obsolete on the Cisco uBR7246VXR router.
Usage Guidelines Use this command in conjunction with the hccp authentication command to enable and specify the type
of 1+1 redundancy authentication you will use in your protection scheme.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-873
Cable Commands: d through h
hccp authentication key-chain
Note You cannot perform authentication on a specified group until you have first defined at least one
authentication key chain in global configuration mode.
Examples The following excerpt from a configuration file enables authentication using the MD5 algorithm and
defines the authentication key “cisco1” for group 1:
!
key chain cisco1
key 1
key-string abcdefg
key 2
key-string 123456789
!
...
!
interface cable 3/0
hccp 1 authentication md5
hccp 1 authentication key-chain cisco1
!
Related Commands Command Description
hccp authentication Specifies the authentication algorithm for the Working CMTS or
Protect CMTS.
hccp authentication key-chain Enables authentication on a given interface and specifies one or more
keys that can be used to perform authentication for a specified group.
key-chain Defines one or more key chains for authentication between the
Working CMTS or Protect CMTS.
show hccp Displays information for all cable interfaces on which one or more
HCCP groups and authentication modes have been configured.
show hccp interface Displays group information for a specific cable interface on which
one or more groups and authentication modes have been configured.
Cisco IOS CMTS Cable Command Reference
CBL-874 OL-15510-15
Cable Commands: d through h
hccp bypass version
hccp bypass version
To enter bypass version mode for a specific Hot Standby Connection-to-Connection Protocol (HCCP)
group, in which the hardware and software version checks are not performed before switching over to a
protect interface, use the hccp bypass version command in privileged EXEC mode.
hccp group bypass version
Syntax Description group The group number for the specified interface. The valid range is 1 to 255.
Command Default Normal HCCP operations (hccp group check version), where hardware and software version checks are
made between the Working and Protect cable interface line cards.
Command Modes Privileged EXEC
Command History Release Modification
12.2(4)XF1, This command was introduced for the Cisco uBR10012 router and
12.2(4)BC1 Cisco uBR-LCP-MC28C card with the Cisco RF Switch.
12.2(8)BC2 Support was added for the Cisco uBR10012 router using the
Cisco uBR-LCP-MC16C, Cisco uBR-LCP-MC16E, and
Cisco uBR-LCP-MC16S cards with the Cisco RF Switch.
12.2(11)BC1 Support was added for the Cisco uBR7246VXR router and
Cisco uBR-MC16C, Cisco uBR-MC16S, and Cisco uBR-MC28C cards with
the Cisco RF Switch.
12.2(15)BC1 Support was added for the Cisco uBR-MC5X20U/S BPE on the
Cisco uBR10012 router.
12.3(17a)BC2 Support was added for the Cisco uBR-MC5X20H BPE on the
Cisco uBR10012 router.
12.3(21)BC This command is obsolete on the Cisco uBR7246VXR router.
Usage Guidelines By default, the Cisco CMTS verifies that the Working and Protect cable interfaces are using the same
versions of software and hardware, so as to avoid potential incompatibilities during a switchover. The
hardware check verifies that the Working and Protect cable interface line cards are compatible. The
software check verifies that the two cards are running the same major versions of software. If either of
these two conditions is not true, the CMTS by default does not perform the switchover.
You can override these version checks for a particular HCCP group by using the hccp bypass version
command. After you give this command, the Cisco CMTS does not check the hardware or software
versions of the two cable interfaces before performing a switchover. To return to normal HCCP
operations, so that version checks are made for a group, use the hccp check version command.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-875
Cable Commands: d through h
hccp bypass version
Note Two cable interface line cards are compatible when the Protect card has at least the same number of
upstreams or downstreams as the Working card. The exceptions to this are that the Cisco uBR-MC16E
card can be protected only by another Cisco uBR-MC16E card. Also, the DOCSIS versions of the
Cisco uBR-MC16 card can be protected only by another Cisco uBR-MC16C card. You cannot use the
Cisco uBR-MC28C card to protect a Cisco uBR-MC16B/C/S card.
Examples The following example shows how to disable the hardware and software version checks for HCCP group
number 20. After giving this command, the Cisco CMTS will switchover from the Working to Protect
interface in group 20 without first verifying the cards’ compatibility:
Router# hccp 20 bypass version
Router#
Related Commands Command Description
hccp check version Exits bypass version mode, and returns to normal HCCP operation.
show hccp Displays information for all cable interfaces on which one or more HCCP
groups and authentication modes have been configured.
show hccp interface Displays group information for a specific cable interface on which one or
more groups and authentication modes have been configured.
Cisco IOS CMTS Cable Command Reference
CBL-876 OL-15510-15
Cable Commands: d through h
hccp channel-switch
hccp channel-switch
To configure the Cisco CMTS so that a Cisco RF Switch or Vecima (Wavecom) upconverter becomes a
Hot Standby Connection-to-Connection Protocol (HCCP) member in a particular HCCP group, use the
hccp channel-switch command in cable interface configuration mode. To remove the configuration for
the Cisco RF Switch or upconverter, use the no form of this command.
hccp group channel-switch member-id switch-name rfswitch-group rfswitch-ip-address
module-bitmap position
hccp group channel-switch member-id switch-name rfswitch-module rfswitch-ip-address
module-number position
hccp group channel-switch member-id switch-name tty-switch [aux | console | vty] line-number
port
hccp group channel-switch member-id switch-name {wavecom-hd | wavecom-ma}
prot-ip-address protect-module work-ip-address work-module
no hccp group channel-switch member-id switch-name
Syntax Description group The group number for the specified interface. The valid range is 1 to 255.
member-id The member number within the specified group. The valid range is 1 to 255.
switch-name (Optional) Alpha-numeric string specifies the name of the
Cisco RF Switch.
rfswitch-group Specifies that this is the configuration for a Cisco RF Switch group.
rfswitch-module Specifies that this is the configuration for a Cisco RF Switch module.
rfswitch-ip-address Specifies the IP address of the Cisco RF Switch to which the CMTS is
connected.
module-bitmap Specifies the module-bitmap in hexadecimal. The valid range is 0 to
FFFFFFFF.
Tip See the TAC-authored N+1 Tips and Configuration document on
Cisco.com for more information on the format of the bitmap, and for
a worksheet that can be used to calculate the bitmap.
module-number Specifies the module number on the Cisco RF Switch. The valid range is 1
to 255.
Note This setting must be configured on the Cisco RF Switch as well as
the Cisco CMTS.
position Specifies the position for the Working channel on the Cisco RF Switch. The
valid range is 1 to 8.
tty-switch Specifies the configuration of a Cisco RF Switch that is controlled by its
TTY line. You can further specify the type of port being used to control the
switch. By default, one of the Cisco RF Switch’s serial ports is used, or you
can use the aux, console, or vty lines.
Note Ensure that the switch’s DIP switch is set to 00.
aux (Optional) Specifies that the auxiliary port is being used to control the
Cisco RF Switch.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-877
Cable Commands: d through h
hccp channel-switch
console (Optional) Specifies that the console port is being used to control the
Cisco RF Switch.
vty (Optional) Specifies that a Virtual Terminal connection (Telnet connection)
is being used to control the Cisco RF Switch.
line-number Specifies the line number on which the Cisco RF Switch is receiving control
information for this CMTS. The valid range is 0 to 17 for the default serial
port, 0 for the aux port, 0 for the console port, and 0 to 99 for the vty port.
port Specifies the port number being used on the Cisco RF Switch. The valid
range is 1 to 255.
wavecom-hd Specifies that this is the configuration for a Vecima (Wavecom) HD4040 and
QHD4040 upconverter.
wavecom-ma Specifies that this is the configuration for a Vecima (Wavecom)
DUAL4040D, MA4040D, or UC4040D upconverter.
prot-ip-address Specifies the IP address for the upconverter used for the Protect interface
used for this cable interface.
protect-module Specifies the module number on the upconverter used for the Protect
interface to be used for this cable interface. The valid range is 1 to 255.
work-ip-address Specifies the IP address for the upconverter used for the Working interface
used for this cable interface.
work-module Specifies the module number on the upconverter used for the Working
interface to be used for this cable interface. The valid range is 1 to 255.
Command Default The CMTS is not configured to use a Cisco RF Switch by default, and no cable interfaces are configured
for N+1 redundancy by default.
Command Modes Interface configuration—cable interface only (config-if)
Command History Release Modification
12.2(4)XF1, This command was introduced for the Cisco uBR10012 router, replacing the
12.2(4)BC1 hccp ds-switch command for use with the Cisco RF Switch.
12.2(8)BC2 Support was added for the Cisco uBR-LCP-MC16C,
Cisco uBR-LCP-MC16E, and Cisco uBR-LCP-MC16S cards on the
Cisco uBR10012 router.
12.2(11)BC1 Support was added for the Cisco uBR7246VXR router and
Cisco uBR-MC16C, Cisco uBR-MC16S, and Cisco uBR-MC28C cards.
12.3(21)BC This command is obsolete on the Cisco uBR7246VXR router.
Usage Guidelines You must configure each Working and Protect cable interface for use with the Cisco RF Switch,
typically specifying one hccp channel-switch command to configure the Cisco RF Switch information,
and another hccp channel-switch command to configure the upconverter.
Cisco IOS CMTS Cable Command Reference
CBL-878 OL-15510-15
Cable Commands: d through h
hccp channel-switch
The Protect interface is configured with the same hccp channel-switch commands as those that are used
on the Working interface. However, typically, the same Protect interface is configured with multiple
hccp channel-switch commands to protect multiple Working interfaces.
Examples The following example shows the cable interface 8/1/0 being configured as member 1 for the Working
interface of HCCP group 1. This interface is configured to use the Wavecom HD4040 upconverter with
the IP address of 10.97.1.21. The upconverter’s module number 2 (B) is used for the Protect interface,
and module number 16 (P) is used for the Working interface. The interface uses the Cisco RF Switch at
IP address 10.97.1.20, using a module bitmap of AA200000 in switch slot 1.
Router# configure terminal
Router(config)# interface cable8/1/0
Router(config-if)# hccp 1 working 1
Router(config-if)# hccp 1 channel-switch 1 uc wavecom-hd 10.97.1.21 2 10.97.1.21 16
Router(config-if)# hccp 1 channel-switch 1 rfswitch rfswitch-group 10.97.1.20 AA200000 1
The following example shows the corresponding configuration for the Protect interface for member 1 of
HCCP group 1, which is cable interface 5/1/0 on the same chassis. The hccp channel-switch commands
are identical to those used for cable interface 8/1/0.
Router# configure terminal
Router(config)# interface cable5/1/0
Router(config-if)# hccp 1 protect 1 10.97.1.8
Router(config-if)# hccp 1 channel-switch 1 uc wavecom-hd 10.97.1.21 2 10.97.1.21 16
Router(config-if)# hccp 1 channel-switch 1 rfswitch rfswitch-group 10.97.1.20 AA200000 1
Typically, the same Protect interface is used to protect multiple Working cable interfaces. For example,
this same interface could be configured as follows to protect a Working interface that is using module
number 14 (N) on the same Wavecom HD4040 upconverter, using slot 2 in the RF Switch.
Router# configure terminal
Router(config)# interface cable5/1/0
Router(config-if)# hccp 1 protect 2 10.97.1.8
Router(config-if)# hccp 1 channel-switch 2 uc wavecom-hd 10.97.1.21 2 10.97.1.21 14
Router(config-if)# hccp 1 channel-switch 2 rfswitch rfswitch-group 10.97.1.20 AA200000 2
Related Commands Command Description
hccp check version Exits bypass version mode, and returns to normal HCCP operation.
hccp ds-switch Specifies the downstream upconverter module for a Working CMTS or
Protect CMTS (deprecated command).
hccp protect Allows you to configure a Cisco CMTS to be a Protect CMTS for a specified
Working CMTS in a 1+1 redundancy environment.
hccp working Allows you to designate a Cisco CMTS to be a Working CMTS in a 1+1
redundancy environment.
show hccp Displays information for all cable interfaces on which one or more HCCP
groups and authentication modes have been configured.
show hccp interface Displays group information for a specific cable interface on which one or
more groups and authentication modes have been configured.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-879
Cable Commands: d through h
hccp check version
hccp check version
To exit bypass version mode and return to normal Hot Standby Connection-to-Connection Protocol
(HCCP) operations for a specific HCCP group, use the hccp check version command in privileged
EXEC mode.
hccp group check version
Syntax Description group The group number for the specified interface. The valid range is 1 to 255.
Command Default Normal HCCP operations (hccp group check version), where hardware and software version checks are
made between the Working and Protect cable interface line cards.
Command Modes Privileged EXEC
Command History Release Modification
12.2(4)XF1, This command was introduced for the Cisco uBR10012 router and
12.2(4)BC1 Cisco uBR-LCP-MC28C card with the Cisco RF Switch.
12.2(8)BC2 Support was added for the Cisco uBR10012 router using the
Cisco uBR-LCP-MC16C, Cisco uBR-LCP-MC16E, and
Cisco uBR-LCP-MC16S cards with the Cisco RF Switch.
12.2(11)BC1 Support was added for the Cisco uBR7246VXR router and
Cisco uBR-MC16C, Cisco uBR-MC16S, and Cisco uBR-MC28C cards with
the Cisco RF Switch.
Usage Guidelines By default, the Cisco CMTS verifies that the Working and Protect cable interfaces are using the same
versions of software and hardware, so as to avoid potential incompatibilities during a switchover. The
hardware check verifies that the Working and Protect cable interface line cards are compatible. The
software check verifies that the two cards are running the same major versions of software. If either of
these two conditions is not true, the CMTS by default does not perform the switchover.
You can override these version checks for a particular HCCP group by using the hccp bypass version
command. After you give this command, the Cisco CMTS does not check the hardware or software
versions of the two cable interfaces before performing a switchover. To return to normal HCCP
operations, so that version checks are made for a group, use the hccp check version command.
Note Two cable interface line cards are compatible when the Protect card has at least the same number of
upstreams or downstreams as the Working card. The exceptions to this are that the Cisco uBR-MC16E
card can be protected only by another Cisco uBR-MC16E card. Also, the DOCSIS versions of the
Cisco uBR-MC16 card can be protected only by another Cisco uBR-MC16C card. You cannot use the
Cisco uBR-MC28C card to protect a Cisco uBR-MC16B/C/S card.
Cisco IOS CMTS Cable Command Reference
CBL-880 OL-15510-15
Cable Commands: d through h
hccp check version
Examples The following example shows how to cancel a previous hccp bypass version command for HCCP
group 1 and to return to normal HCCP operations:
Router# hccp 1 check version
Router#
Related Commands Command Description
hccp bypass version Enters bypass version mode for a specific HCCP group, in which the
hardware and software version checks are not performed before switching
over to a protect interface.
show hccp Displays information for all cable interfaces on which one or more HCCP
groups and authentication modes have been configured.
show hccp interface Displays group information for a specific cable interface on which one or
more groups and authentication modes have been configured.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-881
Cable Commands: d through h
hccp ds-switch
hccp ds-switch
To specify the downstream upconverter module for a Working CMTS or Protect CMTS, use the hccp
ds-switch command in cable interface configuration mode. To negate a downstream upconverter
assignment, use the no form of this command.
hccp group ds-switch member make host-ipaddr host-module peer-ipaddr peer-module
no hccp group ds-switch member
Note This command has been deprecated in current Cisco IOS releases and has been replaced by the hccp
channel-switch command.
Syntax Description group The group number for the specified interface. Valid values are any number
from 1 to 255, inclusive.
member The member number within the specified group.
make The maker of the specified upconverter. Currently, only the Wavecom
upconverter is supported (wavecom).
host-ipaddr The IP address of the upconverter module1 to which the host CMTS is
connected.
host-module The upconverter module number to which the host CMTS is connected. This
location is expressed as a simple numeric designation.
peer-ipaddr The IP address of the upconverter module to which the peer (or remote)
CMTS is connected.
peer-module The upconverter module number1 to which the peer (or remote) CMTS is
connected. This location is expressed as a simple numeric designation.
1. The identification of the upconverter module is important to define when the host or peer CMTS is connected to a channel
switch housing multiple modules. For example, the Wavecom MA4040D upconverter chassis offers a maximum of 10
independent frequency agile upconverters.
Command Default Upconverter specification and activation is disabled by default and must be specified before switching
can take place.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.1(3a)EC This command was introduced for the Cisco uBR7200 series routers.
12.1(7)EC1 Support was added for the Cisco uBR-MC16S cable interface line card.
12.2(4)XF1, This command was deprecated and replaced by the hccp channel-switch
12.2(4)BC1 command.
Cisco IOS CMTS Cable Command Reference
CBL-882 OL-15510-15
Cable Commands: d through h
hccp ds-switch
Usage Guidelines It is necessary to configure the downstream upconverter module for all Protect CMTS and Working
CMTS systems. If you do not specify the downstream upconverter module for all Protect CMTS and
Working CMTS systems, you cannot switch between a Protect CMTS and Working CMTS.
Examples The following excerpt from a configuration file specifies module 2 on a Wavecom upconverter at IP
address 1.1.11.3 as the host switch module connected to Working CMTS 1 and module 1 on the same
Wavecom upconverter (with the same IP address location) as the peer or remote switch module
connected to the Protect CMTS:
hccp 1 working 1
hccp ds-switch 1 wavecom 1.1.11.3 2 1.1.11.3 1
Related Commands Command Description
hccp channel-switch (replaces the hccp ds-switch command).
hccp protect Allows you to configure a Cisco CMTS to be a Protect CMTS for a specified
Working CMTS in a 1+1 redundancy environment.
hccp working Allows you to designate a Cisco CMTS to be a Working CMTS in a 1+1
redundancy environment.
show hccp Displays information for all cable interfaces on which one or more HCCP
groups and authentication modes have been configured.
show hccp interface Displays group information for a specific cable interface on which one or
more groups and authentication modes have been configured.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-883
Cable Commands: d through h
hccp lockout
hccp lockout
To prevent a Working CMTS from automatically switching to a Protect CMTS in the same group, use
the hccp lockout command in privileged EXEC mode.
Note This command is applicable only to Working CMTS in a given group. Issuing this command on a Protect
CMTS has no effect.
hccp group lockout member
Syntax Description group The group number for the specified interface. Valid values are any number
from 1 to 255, inclusive.
member The member number within the specified group.
Command Default By default, the hccp lockout command is inactive.
Command Modes Privileged EXEC
Command History Release Modification
12.1(3a)EC This command was introduced for the Cisco uBR7200 series routers.
12.1(7)EC1 Support was added for the Cisco uBR-MC16S cable interface line card.
12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012
12.2(4)BC1 router and Cisco uBR-LCP-MC28C card.
12.2(8)BC2 Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012
router and Cisco uBR-LCP-MC16C, Cisco uBR-LCP-MC16E, and
Cisco uBR-LCP-MC16S cards.
12.2(11)BC1 Support was added for the N+1 (1:n) RF Switch with the
Cisco uBR7246VXR router and Cisco uBR-MC16C, Cisco uBR-MC16S,
and Cisco uBR-MC28C cards.
Usage Guidelines Typically the hccp lockout command is used to disable HCCP switchovers before removing the HCCP
configuration on the Working interface. Otherwise, when you remove the HCCP configuration from the
Working interface, the Protect interface assumes the Working interface has failed and switches over.
You might also want to prevent a Working CMTS from automatically switching back to a Protect CMTS
for testing or additional configuration purposes. For example, you might want to fully test protecting
cable interfaces on your Cisco CMTS before returning it to protect status.
Examples The following example shows how to activate the lockout feature of a Working CMTS in group 1:
Router# hccp 1 lockout
Cisco IOS CMTS Cable Command Reference
CBL-884 OL-15510-15
Cable Commands: d through h
hccp lockout
Related Commands Command Description
hccp unlockout Negates the effects of the hccp lockout EXEC command, making the CMTS
available for automatic switchover from a Working CMTS to a Protect
CMTS.
show hccp Displays information for all cable interfaces on which one or more HCCP
groups and authentication modes have been configured.
show hccp interface Displays group information for a specific cable interface on which one or
more groups and authentication modes have been configured.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-885
Cable Commands: d through h
hccp protect
hccp protect
To configure a particular cable interface to protect another cable interface in the same group, use the
hccp protect command in cable interface configuration mode. To undo a particular host cable interface
protection assignment, use the no form of this command.
hccp group protect member ipaddr
no hccp group protect member
Syntax Description group The group number of both the Working and Protect cable interfaces. Valid
values are any number from 1 to 255, inclusive.
member The member number of the specified Working cable interface. Valid values
are any number from 1 to 255, inclusive.
ipaddr An IP address for any working interface (other than protected cable
interfaces) installed in the Working CMTS that can transmit and receive
redundancy status messages.
Command Default No default behavior or values
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.1(3a)EC This command was introduced for the Cisco uBR7200 series routers.
12.1(7)EC1 Support was added for the Cisco uBR-MC16S cable interface line card.
12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012
12.2(4)BC1 router and Cisco uBR-LCP-MC28C card.
12.2(8)BC2 Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012
router and Cisco uBR-LCP-MC16C, Cisco uBR-LCP-MC16E, and
Cisco uBR-LCP-MC16S cards.
12.2(11)BC1 Support was added for the N+1 (1:n) RF Switch with the
Cisco uBR7246VXR router and Cisco uBR-MC16C, Cisco uBR-MC16S,
and Cisco uBR-MC28C cards.
Usage Guidelines The protect cable interface must be configured identically to the working cable interface, which typically
means the interfaces must be the same card type. However, when the Cisco uBR-MC16S card is used, it
can be used with either another Cisco uBR-MC16S card or a Cisco uBR-MC16C card.
Table 26 shows how a switchover affects the enhanced spectrum management features of the
Cisco uBR-MC16S card.
Cisco IOS CMTS Cable Command Reference
CBL-886 OL-15510-15
Cable Commands: d through h
hccp protect
Table 26 Switchover Operation for a Cisco uBR-MC16C/Cisco uBR-MC16S Configuration
Working Cable Protect Cable
Interface Interface Operation After Switchover
Cisco uBR-MC16C Cisco uBR-MC16S The protect card (Cisco uBR-MC16S) uses the same
upstream frequency as the working card, but after the
system stabilizes, the protect card begins using the
enhanced spectrum management features of the
Cisco uBR-MC16S card, as configured on the protect
CMTS.
Cisco uBR-MC16S Cisco uBR-MC16C The protect card (Cisco uBR-MC16C) uses the same
upstream frequency as the working card. If the upstream
becomes unstable, the Cisco uBR-MC16C performs only
blind frequency hopping.
Cisco uBR-MC16S Cisco uBR-MC16S The protect card initially uses the same upstream frequency
as the working card, but after the system stabilizes, the
protect card continues using the enhanced spectrum
management features of the Cisco uBR-MC16S card.
Examples The following example configures host cable interface 4/0 to protect member 2 of group 2 at
IP address 1.1.11.2:
Router(config)# interface cable 4/0
Router(config-if)# hccp 2 protect 2 1.1.11.2
Related Commands Command Description
cable downstream rf-power Sets the RF power output level on a cable interface line card with an
integrated upconverter (including the ability to specify an override or
delta power value for a Protect interface).
hccp working Configures a specified cable interface to be a working member of a
given group.
show hccp Displays information for all cable interfaces on which one or more
HCCP groups and authentication modes have been configured.
show hccp interface Displays group information for a specific cable interface on which one
or more groups and authentication modes have been configured.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-887
Cable Commands: d through h
hccp resync
hccp resync
To manually synchronize the Inter-database between the Working and Protect interfaces for a particular
member in an Hot Standby Connection-to-Connection Protocol (HCCP) group, use the hccp resync
command in privileged EXEC mode.
hccp group resync member
Syntax Description group The group number for the specified interface. The valid range is 1 to 255.
member The member ID to be resynchronized. The valid range is 1 to 255.
Command Default No default behavior or values.
Command Modes Privileged EXEC
Command History Release Modification
12.2(4)XF1, This command was introduced for the Cisco uBR10012 router and
12.2(4)BC1 Cisco uBR-LCP-MC28C card with the Cisco RF Switch.
12.2(8)BC2 Support was added for the Cisco uBR10012 router using the
Cisco uBR-LCP-MC16C, Cisco uBR-LCP-MC16E, and
Cisco uBR-LCP-MC16S cards with the Cisco RF Switch.
12.2(11)BC1 Support was added for the Cisco uBR7246VXR router and
Cisco uBR-MC16C, Cisco uBR-MC16S, and Cisco uBR-MC28C cards with
the Cisco RF Switch.
Usage Guidelines The Cisco CMTS automatically synchronizes the Working and Protect interfaces to ensure that when a
switchover occurs, the Protect interface will run with a configuration that is identical to that of the
Working interface. However, if you are troubleshooting HCCP problems, you can manually
resynchronize the databases using the hccp resync command before performing any switchover tests.
Note When a SYNC event command is occurring, CLI commands might be very slow to respond. In
particular, if you enter a show command at the same time a SYNC event is occurring, the command
might respond produce a blank display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Examples The following example shows how to manually resynchronize the Inter-database between the Working
and Protect interfaces for member 4 in HCCP group 13:
Router# hccp 13 resync 4
Cisco IOS CMTS Cable Command Reference
CBL-888 OL-15510-15
Cable Commands: d through h
hccp resync
Router#
Related Commands Command Description
show hccp Displays information for all cable interfaces on which one or more HCCP
groups and authentication modes have been configured.
show hccp interface Displays group information for a specific cable interface on which one or
more groups and authentication modes have been configured.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-889
Cable Commands: d through h
hccp revertive
hccp revertive
To configure a cable interface on a Protect CMTS that has assumed working capacity to automatically
revert back to the Working CMTS, use the hccp revertive command in cable interface configuration
mode. To disable the ability for the specified cable interface to automatically revert back to protect
status, use the no form of this command.
hccp group revertive
no hccp group revertive
Syntax Description group The group number for the specified interface. Valid values are any number
from 1 to 255, inclusive.
Command Default Enabled
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.1(3a)EC This command was introduced for the Cisco uBR7200 series routers.
12.1(7)EC1 Support was added for the Cisco uBR-MC16S cable interface line card.
12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012
12.2(4)BC1 router and Cisco uBR-LCP-MC28C card.
12.2(8)BC2 Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012
router and Cisco uBR-LCP-MC16C, Cisco uBR-LCP-MC16E, and
Cisco uBR-LCP-MC16S cards.
12.2(11)BC1 Support was added for the N+1 (1:n) RF Switch with the
Cisco uBR7246VXR router and Cisco uBR-MC16C, Cisco uBR-MC16S,
and Cisco uBR-MC28C cards.
12.3(21)BC This command is obsolete on the Cisco uBR7246VXR router.
Usage Guidelines Using this command in conjunction with the hccp reverttime command gives you the ability to set up
your protecting cable interfaces to automatically switch between working and protecting capacity
without your intervention. Otherwise, whenever a switchover has occurred, you must manually
reactivate the failed Working CMTS and manually return the Protect CMTS to protect status using the
hccp switch command.
Tip If you are using the hccp revertive command on a cable interface, do not also configure the hccp track
command. Configuring both commands on the same interface can cause multiple switchovers on the
same fault.
Cisco IOS CMTS Cable Command Reference
CBL-890 OL-15510-15
Cable Commands: d through h
hccp revertive
Using hccp track with hccp revertive
As a general rule, if you are using the hccp track command on a cable interface, do not also configure
the hccp revertive command without also configuring no keepalive on the cable interface. Configuring
both commands on the same interface, along with keepalives, can cause multiple switchovers on the
same fault.
If you want to use keepalives along with both the hccp track and hccp revertive commands,use the
hccp track command on both the Working and Protect interfaces, so that the Working interfaces on the
same card track each other and the Protect interfaces on the same card track each other. Table 27
summarizes the guidelines for using these three commands:
Table 27 Possible hccp track and hccp revertive Configurations
hccp track hccp track
(Working I/Fs) (Protect I/Fs) hccp revertive keepalive Configuration
Yes No No keepalive or no keepalive
Yes No Yes no keepalive
Yes Yes Yes keepalive or no keepalive
Examples The following example shows cable interface 4/0 on a Protect CMTS in group 2 being configured to
automatically revert to protect status after the Working CMTS peer has returned to active duty:
router(config)# interface cable 4/0
router(config-if)# hccp 2 revertive
Related Commands Command Description
hccp reverttime Specifies the time that the Working CMTS waits before automatically
switching back to a Working CMTS following system switchover.
show hccp Displays information for all cable interfaces on which one or more HCCP
groups and authentication modes have been configured.
show hccp interface Displays group information for a specific cable interface on which one or
more groups and authentication modes have been configured.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-891
Cable Commands: d through h
hccp reverttime
hccp reverttime
To specify the amount of time a Protect interface waits before automatically reverting back to a Working
interface following a system switchover, use the hccp reverttime command in cable interface
configuration mode on the Working CMTS. To set the revert-time back to its default value, use the no
form of this command.
hccp group reverttime revert-time
no hccp group reverttime
Syntax Description group The group number for the specified interface. Valid values are any number
from 1 to 255, inclusive.
revert-time The amount of time (in minutes) that a Protect interface waits before
automatically switching back to a Working interface following a system
switchover. The allowable range is 1 to 65,535 minutes, with a default of
30 minutes.
Command Default 30 minutes
Command Modes Interface configuration (cable interface only, on the Working CMTS)
Command History Release Modification
12.1(3a)EC This command was introduced for the Cisco uBR7200 series routers.
12.1(7)EC1 Support was added for the Cisco uBR-MC16S cable interface line card.
12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012
12.2(4)BC1 router and Cisco uBR-LCP-MC28C card.
12.2(8)BC2 Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012
router and Cisco uBR-LCP-MC16C, Cisco uBR-LCP-MC16E, and
Cisco uBR-LCP-MC16S cards.
12.2(11)BC1 Support was added for the N+1 (1:n) RF Switch with the
Cisco uBR7246VXR router and Cisco uBR-MC16C, Cisco uBR-MC16S,
and Cisco uBR-MC28C cards.
Usage Guidelines Use this command to configure the revert-time on the cable interfaces on the Working CMTS so that the
Working CMTS will automatically resume normal operations and the Protect CMTS will automatically
resume normal protect operations, in case an operator forgets to manually switch the Working CMTS
back into operation after fixing the original problem.
The Working CMTS first counts down two minutes of suspend time before starting to count down the
revert-time. Any failures that occur within this two-minute suspend time are considered part of the same
failure.
Cisco IOS CMTS Cable Command Reference
CBL-892 OL-15510-15
Cable Commands: d through h
hccp reverttime
This means that the actual time that the Working CMTS will attempt to switch back after a switchover
is two minutes plus the revert-time. For example, if the revert-time is set to its default of 30 minutes, the
Working CMTS will attempt to switch back into operation 32 minutes after the initial switchover to the
Protect CMTS.
After the suspend time has occurred, a failure in the Protect CMTS will cause a switchover to the
Working CMTS, regardless of whether the revert-time has expired or not. You can force such a failure
in the Protect CMTS, and restore the Working CMTS to operation without waiting for the revert-time,
by using the cable power off and cable power on commands to turn off and turn on the protect interface
on the Protect CMTS.
When choosing a revert-time, take into account all possible sources of failures, including third-party
equipment. For example, an upconverter failure can trigger a switchover to the Protect CMTS. You
should configure the revert-time so that the Working CMTS does not switch back into operation until
technicians have had sufficient time to fix the equipment failure.
Tip To disable the revert-time feature, use the no version of the hccp revertive command on the Protect
CMTS.
Examples The following example shows cable interface 3/0 on a Working CMTS in group 2 being configured to
wait 15 minutes before automatically reverting back to working status after a system switchover:
router(config)# interface cable 3/0
router(config-if)# hccp 2 reverttime 15
The following example shows how to give the no form of this command, which resets the interface back
to its default value of 30 minutes.
router(config)# interface cable 5/1/0
router(config-if)# no hccp 2 reverttime
Related Commands Command Description
hccp revertive Configures a cable interface on a Protect CMTS to automatically revert
back to a Working CMTS.
show hccp Displays information for all cable interfaces on which one or more HCCP
groups and authentication modes have been configured.
show hccp interface Displays group information for a specific cable interface on which one or
more groups and authentication modes have been configured.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-893
Cable Commands: d through h
hccp switch
hccp switch
To manually switch a Protect CMTS with its Working CMTS peer (or vice versa), use the hccp switch
command in privileged EXEC mode.
hccp group switch member
Syntax Description group The group number for the specified interface. Valid values are any number
from 1 to 255, inclusive.
member The member number for the specified interface. Valid values are any number
from 1 to 255, inclusive.
Command Default No default behavior or values
Command Modes Privileged EXEC
Command History Release Modification
12.1(3a)EC This command was introduced for the Cisco uBR7200 series routers.
12.1(7)EC1 Support was added for the Cisco uBR-MC16S cable interface line card.
12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012
12.2(4)BC1 router and Cisco uBR-LCP-MC28C card.
12.2(8)BC2 Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012
router and Cisco uBR-LCP-MC16C, Cisco uBR-LCP-MC16E, and
Cisco uBR-LCP-MC16S cards.
12.2(11)BC1 Support was added for the N+1 (1:n) RF Switch with the
Cisco uBR7246VXR router and Cisco uBR-MC16C, Cisco uBR-MC16S,
and Cisco uBR-MC28C cards.
12.2(11)BC3 This command is automatically disabled for approximately 2 to 3 seconds
after a PRE module switches over to allow the system to stabilize before
performing another switchover.
Usage Guidelines This command overrides any configuration you may have made on your Protect CMTS and Working
CMTS using the hccp revert and hccp reverttime commands. In addition, you can issue the hccp
switch command on either a Protect CMTS or a Working CMTS to force it to change places with its peer.
Examples The following example shows the host Protect CMTS being configured to assume traffic responsibility
for member 2 Working CMTS in group 2:
Router# hccp 2 switch 2R
Cisco IOS CMTS Cable Command Reference
CBL-894 OL-15510-15
Cable Commands: d through h
hccp switch
Related Commands Command Description
hccp lockout Prevents a Working CMTS from automatically switching to a Protect CMTS
in the same group.
hccp unlockout Negates the effects of the hccp lockout command, making the CMTS
available for automatic switchover from a Working CMTS to a Protect
CMTS.
show hccp Displays information for all cable interfaces on which one or more HCCP
groups and authentication modes have been configured.
show hccp interface Displays group information for a specific cable interface on which one or
more groups and authentication modes have been configured.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-895
Cable Commands: d through h
hccp timers
hccp timers
To configure HELLO packet interval and hold time for a specified group on a Protect CMTS, use the
hccp timers command in cable interface configuration mode. To erase the HELLO interval and hold
time configuration and to assume the default values for each parameter, use the no form of this
command.
hccp group timers hello-time hold-time
no hccp group timers [hello-time hold-time]
Note Issuing the no form of this command erases any manual HELLO interval and hold time values and
automatically resets them to their default values.
Syntax Description group The group number for the specified interface. Valid values are any number
from 1 to 255, inclusive.
hello-time The HELLO packet interval (in milliseconds) between subsequent HELLO
packet transmissions. The acceptable range is 1666 to 5,000 milliseconds,
inclusive.
hold-time The time (in milliseconds) that a Protect CMTS will wait before assuming
control of voice traffic for a Working CMTS that has failed to acknowledge
a series of HELLO packets. The acceptable range is 5,000 to 25,000
milliseconds, inclusive.
Command Default The default HELLO interval is 2,000 milliseconds, and the default hold time is 6,000 milliseconds.
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.1(3a)EC This command was introduced for the Cisco uBR7200 series routers.
12.1(7)EC1 Support was added for the Cisco uBR-MC16S cable interface line card.
12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012
12.2(4)BC1 router and Cisco uBR-LCP-MC28C card.
12.2(8)BC2 Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012
router and Cisco uBR-LCP-MC16C, Cisco uBR-LCP-MC16E, and
Cisco uBR-LCP-MC16S cards.
12.2(11)BC1 Support was added for the N+1 (1:n) RF Switch with the
Cisco uBR7246VXR router and Cisco uBR-MC16C, Cisco uBR-MC16S,
and Cisco uBR-MC28C cards.
Cisco IOS CMTS Cable Command Reference
CBL-896 OL-15510-15
Cable Commands: d through h
hccp timers
Examples The following example shows the HELLO interval and hold time on a Protect CMTS in group 2 being
configured to 1,750 and 3,000 milliseconds, respectively:
Router(config)# interval c4/0
Router(config-if)# hccp 2 timers 1750 3000
Related Commands Command Description
hccp protect Configures a particular cable interface to protect another peer cable interface
in the same group.
hccp working Configures a specified cable interface to be a working member of a given
group.
show hccp Displays information for all cable interfaces on which one or more HCCP
groups and authentication modes have been configured.
show hccp interface Displays group information for a specific cable interface on which one or
more groups and authentication modes have been configured.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-897
Cable Commands: d through h
hccp track
hccp track
To configure a cable interface on a Working CMTS or Protect CMTS to enable automatic switchover
based on the interface state, use the hccp track command in cable interface configuration mode. To
disable the automatic switchover based on interface state, use the no form of this command.
hccp group track [interface]
no hccp group track [interface]
Syntax Description group The group number for the specified interface. Valid values are any number
from 1 to 255, inclusive.
interface Specifies another cable interface (the default is the current cable interface).
Command Default Enabled for the current interface
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.1(3a)EC This command was introduced for the Cisco uBR7200 series routers.
12.1(7)EC1 Support was added for the Cisco uBR-MC16S cable interface line card.
12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012
12.2(4)BC1 router and Cisco uBR-LCP-MC28C card.
12.2(8)BC2 Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012
router and Cisco uBR-LCP-MC16C, Cisco uBR-LCP-MC16E, and
Cisco uBR-LCP-MC16S cards.
12.2(11)BC1 Support was added for the N+1 (1:n) RF Switch with the
Cisco uBR7246VXR router and Cisco uBR-MC16C, Cisco uBR-MC16S,
and Cisco uBR-MC28C cards.
Usage Guidelines This command enables automatic switchover of one interface when a tracked interface switches over
from “up” to “down.”
Typically, this command is used to allow all interfaces on one card to track one another, so that if one
interface goes down and switches over to the Protect, all other interfaces can also switch over, allowing
the Protect card to assume full operation for these interfaces. This allows support engineers to
troubleshoot the problem on the Working interface, or to remove and replace the Working card, if
necessary, without interfering with traffic.
Cisco IOS CMTS Cable Command Reference
CBL-898 OL-15510-15
Cable Commands: d through h
hccp track
Using hccp track with hccp revertive
As a general rule, if you are using the hccp track command on a cable interface, do not also configure
the hccp revertive command without also configuring no keepalive on the cable interface. Configuring
both commands on the same interface, along with keepalives, can cause multiple switchovers on the
same fault.
If you want to use keepalives along with both the hccp track and hccp revertive commands,use the
hccp track command on both the Working and Protect interfaces, so that the Working interfaces on the
same card track each other and the Protect interfaces on the same card track each other. Table 28
summarizes the guidelines for using these three commands:
Table 28 Possible hccp track and hccp revertive Configurations
hccp track hccp track
(Working I/Fs) (Protect I/Fs) hccp revertive keepalive Configuration
Yes No No keepalive or no keepalive
Yes No Yes no keepalive
Yes Yes Yes keepalive or no keepalive
Examples The following example shows switchover behavior being enabled on a Cisco CMTS in group 2:
Router(config)# interface c3/0
Router(config-if)# hccp 2 track
Router(config-if)# keepalive
Router(config-if)#
The following example shows two Cisco uBR-LCP2-MC28C cards being used in a Cisco uBR10012
router, with each downstream being configured for a separate HCCP group. The card in slot 5/1 is being
configured as the Working interfaces and the card in slot 6/1 is being configured as the Protect
interfaces.
The two downstreams on each card track each other, so if one downstream fails and switches over, the
other can do so as well, allowing the Protect card to assume full control of both interfaces. Similarly,
when the Working interfaces come back into service, both Protect interfaces switch back at the same
time.
Router(config)# interface cable c5/1/0
Router(config-if)# hccp 1 working 1
Router(config-if)# hccp 1 track c5/1/1
Router(config-if)# keepalive 3
Router(config-if)# exit
Router(config)# interface cable c5/1/1
Router(config-if)# hccp 2 working 1
Router(config-if)# hccp 2 track c5/1/0
Router(config-if)# keepalive 3
Router(config-if)# exit
Router(config)# interface cable c6/1/0
Router(config-if)# hccp 1 protect 1 ip-address-of-mgmt-lan
Router(config-if)# hccp 1 track c6/1/1
Router(config-if)# keepalive 3
Router(config-if)# exit
Router(config)# interface cable c6/1/1
Router(config-if)# hccp 2 protect 1 ip-address-of-mgmt-lan
Router(config-if)# hccp 2 track c6/1/0
Router(config-if)# keepalive 3
Router(config-if)#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-899
Cable Commands: d through h
hccp track
Related Commands Command Description
keepalive A global configuration command that allows you to specify the keepalive
message transmission interval on a Working CMTS or Protect CMTS. For
more specific information, see the Cisco IOS Interface Command Reference
on Cisco.com.
show hccp Displays information for all cable interfaces on which one or more HCCP
groups and authentication modes have been configured.
show hccp interface Displays group information for a specific cable interface on which one or
more groups and authentication modes have been configured.
Cisco IOS CMTS Cable Command Reference
CBL-900 OL-15510-15
Cable Commands: d through h
hccp unlockout
hccp unlockout
To reverse the effects of the hccp lockout command—that is, to make a Working CMTS available for
automatic switchover to Protect CMTS, use the hccp unlockout command in privileged EXEC mode.
hccp group unlockout member
Syntax Description group The group number for the specified interface. Valid values are any number
from 1 to 255, inclusive.
member The member number within the specified group.
Command Default By default, the hccp unlockout command is active for all groups and members.
Command Modes Privileged EXEC
Command History Release Modification
12.1(3a)EC This command was introduced for the Cisco uBR7200 series routers.
12.1(7)EC1 Support was added for the Cisco uBR-MC16S cable interface line card.
12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012
12.2(4)BC1 router and Cisco uBR-LCP-MC28C card.
12.2(8)BC2 Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012
router and Cisco uBR-LCP-MC16C, Cisco uBR-LCP-MC16E, and
Cisco uBR-LCP-MC16S cards.
12.2(11)BC1 Support was added for the N+1 (1:n) RF Switch with the
Cisco uBR7246VXR router and Cisco uBR-MC16C, Cisco uBR-MC16S,
and Cisco uBR-MC28C cards.
Usage Guidelines This command reverses the effect of the hccp lockout command. Once you have reconfigured or tested
your Protect CMTS, issuing this command manually reintroduces the CMTS back into your 1+1
redundancy protection scheme.
Note This command is applicable only on a Working CMTS in a given group. Issuing this command on a
Protect CMTS has no effect.
Examples The following example shows the lockout feature of a Working CMTS in group 1 being deactivated:
hccp 1 unlockout
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-901
Cable Commands: d through h
hccp unlockout
Related Commands Command Description
hccp lockout Prevents a Working CMTS from automatically switching to a Protect CMTS
in the same group.
show hccp Displays information for all cable interfaces on which one or more HCCP
groups and authentication modes have been configured.
show hccp interface Displays group information for a specific cable interface on which one or
more groups and authentication modes have been configured.
Cisco IOS CMTS Cable Command Reference
CBL-902 OL-15510-15
Cable Commands: d through h
hccp working
hccp working
To designate a cable interface on a CMTS in the specified group to be a Working CMTS, use the hccp
working command in cable interface configuration mode. To remove a Working CMTS assignment, use
the no form of this command.
hccp group working member
no hccp group working member
Syntax Description group The group number for the specified interface. Valid values are any number
from 1 to 255, inclusive.
member The member number for the specified interface. Valid values are any number
from 1 to 255, inclusive.
Command Default No default behavior or values
Command Modes Interface configuration (cable interface only)
Command History Release Modification
12.1(3a)EC This command was introduced for the Cisco uBR7200 series routers.
12.1(7)EC1 Support was added for the Cisco uBR-MC16S cable interface line card.
12.2(4)XF1, Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012
12.2(4)BC1 router and Cisco uBR-LCP-MC28C card.
12.2(8)BC2 Support was added for the N+1 (1:n) RF Switch with the Cisco uBR10012
router and Cisco uBR-LCP-MC16C, Cisco uBR-LCP-MC16E, and
Cisco uBR-LCP-MC16S cards.
12.2(11)BC1 Support was added for the N+1 (1:n) RF Switch with the
Cisco uBR7246VXR router and Cisco uBR-MC16C, Cisco uBR-MC16S,
and Cisco uBR-MC28C cards.
Usage Guidelines When N+1 HCCP redundancy is configured, the Protect interface switches over and becomes the active
interface when it detects a situation similar to the following:
• The Working interface is removed from the chassis, is powered down, or is reset
• The Working interface crashes
• The Working interface no longer sends out regular keepalive messages
• The Working interface loses connectivity with the cable network
The Protect cable interface must be configured identically to the Working cable interface, which
typically means the interfaces should be the same card type. However, when the Cisco uBR-MC16S is
used, it can be used with either another Cisco uBR-MC16S card or a Cisco uBR-MC16C card.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-903
Cable Commands: d through h
hccp working
Table 29 shows how a switchover affects the enhanced spectrum management features of the
Cisco uBR-MC16S card.
Table 29 Switchover Operation for a Cisco uBR-MC16C/Cisco uBR-MC16S Configuration
Working Cable Protect Cable
Interface Interface Operation After Switchover
Cisco uBR-MC16C Cisco uBR-MC16S The protect card (Cisco uBR-MC16S) uses the same
upstream frequency as the working card, but after the
system stabilizes, the protect card begins using the
enhanced spectrum management features of the
Cisco uBR-MC16S card, as configured on the protect
CMTS.
Cisco uBR-MC16S Cisco uBR-MC16C The protect card (Cisco uBR-MC16C) uses the same
upstream frequency as the working card. If the upstream
becomes unstable, the Cisco uBR-MC16C performs only
blind frequency hopping.
Cisco uBR-MC16S Cisco uBR-MC16S The protect card initially uses the same upstream frequency
as the working card, but after the system stabilizes, the
protect card continues using the enhanced spectrum
management features of the Cisco uBR-MC16S card.
Examples The following example shows cable interface 4/0 being designated as a Working CMTS interface as
member number 2 of group 2:
Router(config)# interface cable 4/0
Router(config-if)# hccp 2 working 2
Related Commands Command Description
hccp protect Configures a particular cable interface to protect another cable interface in
the same group.
show hccp Displays information for all cable interfaces on which one or more HCCP
groups and authentication modes have been configured.
show hccp interface Displays group information for a specific cable interface on which one or
more groups and authentication modes have been configured.
Cisco IOS CMTS Cable Command Reference
CBL-904 OL-15510-15
Cable Commands: d through h
hold-queue
hold-queue
To limit the size of the IP output queue on an interface, use the hold-queue command in interface
configuration mode. To restore the default values, use the no form of this command.
hold-queue length {in | out}
no hold-queue {in | out}
Syntax Description length Integer that specifies the maximum number of packets in the queue. The range of
valid values is from 0 to 65535.
in Specifies the input queue. The default is 75 packets. For asynchronous interfaces,
the default is 10 packets.
out Specifies the output queue. The default is 40 packets. For asynchronous interfaces,
the default is 10 packets.
Defaults Input hold-queue limit is 75 packets.
Output hold-queue limit is 40 packets.
Asynchronous interfaces default is 10 packets.
Command Modes Interface configuration (config-if)
Command History Release Modification
10.0 This command was introduced.
11.1 The no hold-queue command was added.
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Cisco IOS
Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.2(33)SCB.
Usage Guidelines Defaults
The default limits or this command prevent a malfunctioning interface from consuming an excessive
amount of memory. There is no fixed upper limit to a queue size.
Back-to-Back Routing Updates
The default of 10 packets allows the Cisco IOS software to queue a number of back-to-back routing
updates. This is the default for asynchronous interfaces only; other media types have different defaults.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-905
Cable Commands: d through h
hold-queue
Hold Queues and Priority Queueing
• The hold queue stores packets received from the network that are waiting to be sent to the client.
Cisco recommends that the queue size not exceed10 packets on asynchronous interfaces. For most
other interfaces, queue length should not exceed 100.
• The input hold queue prevents a single interface from flooding the network server with too many
input packets. Further input packets are discarded if the interface has too many input packets
outstanding in the system.
• If you are using priority output queueing, the length of the four output queues is set using the
priority-list global configuration command. The hold-queue command cannot be used to set an
output hold queue length in this situation.
• For slow links, use a small output hold-queue limit to prevent storing packets at a rate that exceeds
the transmission capability of the link.
• For fast links, use a large output hold-queue limit. A fast link may be busy for a short time (and
require the hold queue) but can empty the output hold queue quickly when capacity returns.
• You can display the current hold-queue setting and the number of packets that are discarded because
of hold-queue overflows by using the show interfaces command in user EXEC mode.
Caution Increasing the hold queue can have detrimental effects on network routing and response times. For
protocols that use seq/ack packets to determine round-trip times, do not increase the output queue.
Dropping packets instead informs hosts to slow down transmissions to match available bandwidth.
This is generally better than having duplicate copies of the same packet within the network (which can
happen with large hold queues).
Examples The following example shows how to set a small input queue on a slow serial line:
Router(config)# interface serial 0
Router(config-if)# hold-queue 30 in
Cisco uBR10012 Universal Broadband Router
The following example shows how to modify the input hold queue on a Gigabit Ethernet SPA:
Router# configure terminal
Router(config)#interface GigabitEthernet3/0/0
Router(config-if)#hold-queue 30 in
Related Commands Command Description
priority-list Establishes queueing priorities based on the protocol type.
show interfaces Displays statistics for all interfaces configured on the router or access server.
Cisco IOS CMTS Cable Command Reference
CBL-906 OL-15510-15
Cable Commands: d through h
hw-module bay reload
hw-module bay reload
To reload the software and restart a SPA, use the hw-module bay reload command in privileged EXEC
mode.
Cisco IOS Releases 12.3(23)BC and 12.2(33)SCA
hw-module bay slot/subslot/bay reload
Cisco IOS Release 12.2(33)SCB
hw-module bay slot/bay/port reload
Syntax Description slot The slot where a SIP resides. On the Cisco uBR10012 router, slots 1 and 3
can be used for SIPs.
subslot The subslot where a SIP resides. On the Cisco uBR10012 router, subslot 0
is always specified.
bay The bay in a SIP where a SPA is located. Valid values are 0 (upper bay) and
1 (lower bay).
port Specifies the interface number on the SPA.
Command Default No default behavior or values
Command Modes Privileged EXEC (#)
Command History Release Modification
12.3(21)BC This command was introduced for the Cisco uBR10012 router.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
12.2(33)SCB This command was modified to change the addressing format for a SPA
from slot/subslot/bay to slot/bay/port.
Usage Guidelines The hw-module bay reload command reloads the software and restarts a SPA.
Examples The following example shows how to reload the software for the Cisco Wideband SPA in slot 1, subslot
0, and bay 1.
Router# hw-module bay 1/0/1 reload
Router#
Related Commands Command Description
hw-module shutdown Shuts down a PRE1 module, line card, SIP, or SPA.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-907
Cable Commands: d through h
hw-module shutdown (ubr10012)
hw-module shutdown (ubr10012)
To shut down a particular Performance Routing Engine (PRE1) module, line card, Wideband SIP or
Wideband SPA, use the hw-module shutdown (ubr10012) command in global configuration mode. To
activate a specific PRE1, line card, Wideband SIP or Wideband SPA, use the no form of this command.
hw-module {main-cpu | pre {A|B} | sec-cpu | slot slot-number | subslot slot/subslot|
bay slot/subslot/bay} shutdown [unpowered]
no hw-module {main-cpu | pre {A|B} | sec-cpu | slot slot-number | subslot slot/subslot |
bay slot/subslot/bay} shutdown
Syntax Description main-cpu Shuts down the PRE1 module that is currently acting as the active PRE1
module.
pre {A|B} Shuts down the PRE1 module that is physically in either PRE slot A (left
slot) or PRE slot B (right slot).
sec-cpu Shuts down the PRE1 module that is currently acting as the standby PRE1
module.
slot slot-number Shuts down the line cards that are physically present in the specified
slot-number (valid range is 1 to 8).
subslot slot/subslot Shuts down the line card or SIP that is physically present in the slot with the
specified slot and subslot numbers. The following are the valid values:
• slot = 1 to 8
• subslot = 0 or 1
bay slot/subslot/bay Shuts down the SPA in the location specified by the slot/subslot/bay
argument. The following are the valid values:
• slot = 1 to 3
• subslot = 0 or 1 (0 is always specified)
• bay = 0 (upper bay) or 1 (lower bay)
unpowered Used with the Wideband SPA, shuts down the SPA and its interfaces, and
leaves them in an administratively down state without power.
Command Default No default behavior or values
Command Modes Global configuration
Command History Release Modification
12.2(4)XF This command was introduced for the Cisco uBR10012 router.
12.3(21)BC Support was added for the Cisco Wideband SIP and Cisco 1-Gbps
Wideband SPA.
Cisco IOS CMTS Cable Command Reference
CBL-908 OL-15510-15
Cable Commands: d through h
hw-module shutdown (ubr10012)
Usage Guidelines The hw-module shutdown (ubr10012) command shuts down in a controlled manner a particular
Performance Routing Engine (PRE1) module, line card, Wideband SIP or Wideband SPA. To activate a
specific PRE1, line card, Wideband SIP, or Wideband SPA, use the no form of this command.
Caution Shutting down the active PRE1 module will trigger a switchover, so that the standby PRE1 module
becomes the active PRE1 module.
Examples The following example shows the standby PRE1 module being shut down:
Router(config)# hw-module sec-cpu shutdown
Router(config)#
The following example shows the active PRE1 module being shut down (which will trigger a switchover
to the standby PRE1 module):
Router(config)# hw-module main-cpu shutdown
Router(config)#
The following example shows the PRE1 module in PRE1 slot B being shut down:
Router(config)# hw-module pre B shutdown
Router(config)#
Note The hw-module pre B shutdown command shuts down the PRE1 module that is physically present in
slot B, regardless of whether the module is the active or standby PRE1 module.
The following example shows how to deactivate and verify deactivation for the Cisco Wideband SPA
located in slot 1, subslot 0, bay 0. In the output of the show hw-module bay oir command, notice the
“admin down” in the Operational Status field.
Router# configure terminal
Router(config)# hw-module bay 1/0/0 shutdown unpowered
%SPAWBCMTS-4-SFP_MISSING: Wideband-Cable 1/0/0, 1000BASE-SX SFP missing from port 0
%LINK-3-UPDOWN: Interface Wideband-Cable1/0/0:1, changed state to down
%LINK-3-UPDOWN: Interface Wideband-Cable1/0/0:2, changed state to down
%LINK-3-UPDOWN: Interface Wideband-Cable1/0/0:3, changed state to down
%LINK-3-UPDOWN: Interface Wideband-Cable1/0/0:4, changed state to down
%LINK-3-UPDOWN: Interface Wideband-Cable1/0/0:5, changed state to down
%LINK-3-UPDOWN: Interface Wideband-Cable1/0/0:6, changed state to down
%LINK-3-UPDOWN: Interface Wideband-Cable1/0/0:7, changed state to down
%LINK-3-UPDOWN: Interface Wideband-Cable1/0/0:8, changed state to down
%LINK-3-UPDOWN: Interface Wideband-Cable1/0/0:9, changed state to down
%LINK-3-UPDOWN: Interface Wideband-Cable1/0/0:10, changed state to down
%LINK-3-UPDOWN: Interface Wideband-Cable1/0/0:11, changed state to down
...
Router# show hw-module bay 1/0/0 oir
Module Model Operational Status
-------------- ------------------ -------------------------
bay 1/0/0 SPA-24XDS-SFP admin down
The following example shows how to activate and verify activation for the Cisco Wideband SPA located
in slot 1, subslot 0, bay 0. In the output of the show hw-module bay oir command, notice the “ok” in
the Operational Status field.
Router# configure terminal
Router(config)# no hw-module bay 1/0/0 shutdown
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-909
Cable Commands: d through h
hw-module shutdown (ubr10012)
%SPAWBCMTS-4-SFP_OK: Wideband-Cable 1/0/0, 1000BASE-SX SFP inserted in port 0
%SPAWBCMTS-4-SFP_LINK_OK: Wideband-Cable 1/0/0, port 0 link changed state to up
%SNMP-5-LINK_UP: LinkUp:Interface Wideband-Cable1/0/0:0 changed state to up
%LINK-3-UPDOWN: Interface Cable1/0/0:0, changed state to up
%LINK-3-UPDOWN: Interface Wideband-Cable1/0/0:1, changed state to up
%LINK-3-UPDOWN: Interface Wideband-Cable1/0/0:2, changed state to up
%LINK-3-UPDOWN: Interface Wideband-Cable1/0/0:3, changed state to up
%LINK-3-UPDOWN: Interface Wideband-Cable1/0/0:4, changed state to up
%LINK-3-UPDOWN: Interface Wideband-Cable1/0/0:5, changed state to up
%LINK-3-UPDOWN: Interface Wideband-Cable1/0/0:6, changed state to up
%LINK-3-UPDOWN: Interface Wideband-Cable1/0/0:7, changed state to up
%LINK-3-UPDOWN: Interface Wideband-Cable1/0/0:8, changed state to up
%LINK-3-UPDOWN: Interface Wideband-Cable1/0/0:9, changed state to up
%LINK-3-UPDOWN: Interface Wideband-Cable1/0/0:10, changed state to up
%LINK-3-UPDOWN: Interface Wideband-Cable1/0/0:11, changed state to up
%LINEPROTO-5-UPDOWN: Line protocol on Interface Wideband-Cable1/0/0:0, changed state to up
...
Router# show hw-module bay 1/0/0 oir
Module Model Operational Status
-------------- ------------------ -------------------------
bay 1/0/0 SPA-24XDS-SFP ok
Related Commands Command Description
hw-module reset Resets a PRE1 module or line card.
hw-module reload Reloads the software in and restarts a Cisco 1-Gbps Wideband SPA.
redundancy Forces a manual switchover between the active and standby PRE1 modules.
force-failover
main-cpu
Cisco IOS CMTS Cable Command Reference
CBL-910 OL-15510-15
Cable Commands: d through h
hw-module slot pos
hw-module slot pos
To configure a line card slot for Packet over SONET (POS) operation, use the hw-module slot pos
command in privileged EXEC mode. To remove the configuration for a line card slot, use the no form
of this command.
hw-module slot slot-number pos
no hw-module slot slot-number pos
Syntax Description slot-number Resets the line cards that are physically present in the specified slot-number
(valid range is 1 to 8).
Defaults No default behavior or values
Command Modes Privileged EXEC
Command History Release Modification
12.2(11)BC3 This command was introduced for the Cisco uBR10012 OC-48 Dynamic
Packet Transport (DPT) Interface Module for the Cisco uBR10012 router.
Usage Guidelines You must first use the hw-module slot pos command to preconfigure a line card slot for POS operation
of the Cisco uBR10012 OC-48 DPT card before you can configure the card with any further commands.
You must also use the card 1oc48dpt/pos-1 command to configure the card slot for the proper card type.
Note If you have previously used the hw-module slot srp command to configure line card slots for Spatial
Reuse Protocol (SRP) operation, you must first cancel that configuration using the no hw-module slot
srp command before you can configure the slots for POS operation using the hw-module slot pos
command.
Examples The following example shows the Cisco uBR10012 OC-48 DPT line card in slot 3 being configured for
POS operation:
Router# hw-module slot 3 pos
Router# card 3/0 1oc48dpt/pos-1
The following example shows the Cisco uBR10012 OC-48 DPT line cards in slots 3 and 4 being
reconfigured from SRP operation to POS operation:
Router# no hw-module slot 3 srp
Router# no hw-module slot 4 srp
Router# hw-module slot 3 pos
Router# card 3/0 1oc48dpt/pos-1
Router# hw-module slot 4 pos
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-911
Cable Commands: d through h
hw-module slot pos
Router# card 4/0 1oc48dpt/pos-1
Related Commands Command Description
hw-module reset Resets a PRE1 module or line card.
hw-module shutdown (ubr10012) Shuts down a PRE1 module or line card.
hw-module slot srp Configures a line card slot for SRP operation.
Cisco IOS CMTS Cable Command Reference
CBL-912 OL-15510-15
Cable Commands: d through h
hw-module slot srp
hw-module slot srp
To configure a line card slot for Spatial Reuse Protocol (SRP) operation, use the hw-module slot srp
command in privileged EXEC mode. To remove the configuration for a line card slot, use the no form
of this command.
hw-module slot slot-number srp
no hw-module slot slot-number srp
Syntax Description slot-number Resets the line cards that are physically present in the specified slot-number
(valid range is 1 to 8).
Defaults No default behavior or values
Command Modes Privileged EXEC
Command History Release Modification
12.2(11)BC3 This command was introduced for the Cisco uBR10012 OC-48 Dynamic
Packet Transport (DPT) Interface Module for the Cisco uBR10012 router.
12.2(33)SCB This command is obsolete.
Usage Guidelines You must first use the hw-module slot srp command to preconfigure a line card slot for SRP operation
of a pair of Cisco uBR10012 OC-48 DPT cards before you can configure the cards with any further
commands. You must also use the card 1oc48dpt/pos-1 command to configure each card slot for the
proper card type.
Tip The Cisco uBR10012 OC-48 DPT line cards support SRP operation only when installed in adjacent odd-
and even-numbered slots (such as slots 1 and 2 or 3 and 4). You need to use the hw-module slot srp
command only for the lower-numbered (odd-numbered) slot to preconfigure both slots of the SRP pair.
Note If you have previously used the hw-module slot pos command to configure line card slots for Packet
over SONET (POS) operation, you must first cancel that configuration using the no hw-module slot pos
command before you can configure the slots for POS operation using the hw-module slot srp command.
Examples The following example shows the Cisco uBR10012 OC-48 DPT line cards in slots 1 and 2 being
configured for POS operation:
Router# hw-module slot 1 srp
Router# card 1/0 1oc48dpt/pos-1
Router# card 2/0 1oc48dpt/pos-1
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-913
Cable Commands: d through h
hw-module slot srp
The following example shows the Cisco uBR10012 OC-48 DPT line cards in slots 3 and 4 being
reconfigured from POS operation to SRP operation:
Router# no hw-module slot 3 pos
Router# no hw-module slot 4 pos
Router# hw-module slot 3 srp
Router# card 3/0 1oc48dpt/pos-1
Router# card 4/0 1oc48dpt/pos-1
Related Commands Command Description
hw-module reset Resets a PRE1 module or line card.
hw-module shutdown (ubr10012) Shuts down a PRE1 module or line card.
hw-module slot pos Configures a line card slot for POS operation.
Cisco IOS CMTS Cable Command Reference
CBL-914 OL-15510-15
Cable Commands: i through p
Revised: July 2012, OL-15510-15
New Commands
Command Cisco IOS Software Release
packetcable gate send-subscriberID 12.3(23)BC1
ipdr associate 12.2(33)SCB
ipdr collector 12.2(33)SCB
ipdr explorer start 12.2(33)SCB
ipdr session 12.2(33)SCB
ipdr session (global configuration) 12.2(33)SCB
ipdr template 12.2(33)SCB
issu linecard abortversion 12.2(33)SCB
issu linecard acceptversion 12.2(33)SCB
issu linecard changeversion 12.2(33)SCB
issu linecard loadversion 12.2(33)SCB
issu linecard prepareversion 12.2(33)SCB
issu linecard reloadversion 12.2(33)SCB
issu linecard runversion 12.2(33)SCB
match-rule 12.2(33)SCB
init-tech-list 12.2(33)SCC
init-tech-ovr 12.2(33)SCC
interface integrated-cable 12.2(33)SCC
interval 12.2(33)SCC
logging cmts sea 12.2(33)SCC
method 12.2(33)SCC
name 12.2(33)SCC
oui 12.2(33)SCC
output-rate 12.2(33)SCC
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-915
Cable Commands: i through p
Command Cisco IOS Software Release
override 12.2(33)SCC
policy 12.2(33)SCC
ipdr type 12.2(33)SCD2
prefix 12.2(33)SCC
license feature evaluation disable 12.2(33)SCE
license feature evaluation enable 12.2(33)SCE
protect-tunnel 12.2(33)SCE
logging cmts ipc-cable 12.2(33)SCF
ipdr exporter ack-timeout 12.2(33)SCG
ipdr exporter keepalive 12.2(33)SCG
ipdr exporter max-unacked 12.2(33)SCG
Modified Commands
Command Cisco IOS Software Release
member subslot 12.2(33)SCA
mode (redundancy) 12.2(33)SCA
ping docsis 12.2(33)SCA
interface cable 12.2(33)SCA
interface modular-cable 12.2(33)SCB
interface wideband-cable 12.2(33)SCB
ip accounting mac-address 12.2(33)SCB
mac-address 12.2(33)SCB
mtu 12.2(33)SCB
negotiation 12.2(33)SCB
packetcable gate send-subscriberID 12.2(33)SCB
penalty-period 12.2(33)SCB
plim qos input map 12.2(33)SCB
ping docsis 12.2(33)SCC
interface cable 12.2(33)SCD
interface wideband-cable 12.2(33)SCD
peak-time1 12.2(33)SCD2
penalty-period 12.2(33)SCD2
member subslot 12.2(33)SCC4
interface cable 12.2(33)SCE
interface modular-cable 12.2(33)SCE
interface Wideband-Cable 12.2(33)SCE
Cisco IOS CMTS Cable Command Reference
CBL-916 OL-15510-15
Cable Commands: i through p
Command Cisco IOS Software Release
mode (redundancy) 12.2(33)SCE
interval 12.2(33)SCE1
ipdr template 12.2(33)SCG
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-917
Cable Commands: i through p
init-tech-list
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.
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 Configures a DOCSIS load balancing group on the CMTS.
docsis-group
show cable Displays real-time configuration, statistical, and operational information
load-balance for load balancing operations on the router.
docsis-group
Cisco IOS CMTS Cable Command Reference
CBL-918 OL-15510-15
Cable Commands: i through p
init-tech-ovr
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 0-4 [ucc]
Cisco uBR7225VXR and Cisco uBR7246VXR Routers
init-tech-ovr cable slot/port upstream cable slot/port upstream init-tech-list 0-4 [ucc]
Syntax Description cable slot/subslot/port Specifies the CMTS interface slot, subslot, port number, and upstream
upstream parameters that are to be overridden.
• slot—Slot where the line card resides. Ther 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 Specifies the CMTS interface slot, subslot, port number, and upstream
upstream channel ID parameters that will override the CMTS interface and upstream
channel.
cable slot/port Specifies the CMTS interface slot, port number, and upstream parameters
upstream 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 Specifies the CMTS interface slot, port number, and upstream parameters
upstream 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)
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-919
Cable Commands: i through p
init-tech-ovr
Command History Release Modification
12.2(33)SCC This command was introduced.
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 Configures a DOCSIS load balancing group on the CMTS.
docsis-group
show cable Displays real-time configuration, statistical, and operational information
load-balance for load balancing operations on the router.
docsis-group
Cisco IOS CMTS Cable Command Reference
CBL-920 OL-15510-15
Cable Commands: i through p
interface cable
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.
subslot (Cisco uBR10012 only) Secondary slot number of the cable interface line
card. The valid subslots are 0 or 1.
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.
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.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-921
Cable Commands: i through p
interface cable
Release Modification
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.
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
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.
Cisco IOS CMTS Cable Command Reference
CBL-922 OL-15510-15
Cable Commands: i through p
interface cable-modem
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.
Usage Guidelines When this command is entered, 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 Modifies the saved downstream channel setting and upstream
saved channel power value on the cable interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-923
Cable Commands: i through p
interface cable-modem
cable-modem upstream Enables the QPSK modulation scheme in the upstream direction
preamble qpsk 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.
Cisco IOS CMTS Cable Command Reference
CBL-924 OL-15510-15
Cable Commands: i through p
interface gigabitethernet
interface gigabitethernet
The interface gigabitethernet command is now documented as the gigabitethernet keyword of the
interface command. For more information, see the interface command.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-925
Cable Commands: i through p
interface integrated-cable
interface integrated-cable
To configure integrated cable interface, 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/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.
subslot (Cisco uBR10012 only) Secondary slot number of the cable interface line
card. The valid subslots are 0 or 1.
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.
rf-channel RF channel number. The valid range is from 0 to 3.
Command Default None
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines The interface integrated-cable command is supported only 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
Cisco IOS CMTS Cable Command Reference
CBL-926 OL-15510-15
Cable Commands: i through p
interface integrated-cable
Associated Features The interface integrated-cable command is used to configure the following:
• Configuring the Cisco UBR-MC20X20V Cable Interface Line Card
• Configuring the Cisco uBR-MC88V Cable Interface Line Card
Related Commands Command Description
show interface integrated-cable Displays the current configuration and status for an integrated
channel.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-927
Cable Commands: i through p
interface modular-cable
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/bay/port:nb-channel-number
Cisco IOS Release 12.2(33)SCE
interface modular-cable slot/{subslot | bay}/port:interface-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.
Cisco IOS CMTS Cable Command Reference
CBL-928 OL-15510-15
Cable Commands: i through p
interface modular-cable
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.
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 Specifies a wideband cable interface.
wideband-cable
interface cable Specifies a cable interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-929
Cable Commands: i through p
interface port-channel
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 (off mode) configured.
Command Modes Global configuration
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.
Usage Guidelines The first EtherChannel interface configured becomes the bundle master 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 master by default.
Repeat this configuration on every EtherChannel port to be bundled into a FastEtherChannel (FEC) or
GigabitEtherChannel (GEC) group. This configuration must be present on all EtherChannel interfaces
before the EtherChannel group can be configured.
For additional information about using the EtherChannel feature on the Cisco CMTS, refer to the
following document on Cisco.com:
• EtherChannel for the Cisco CMTS
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.
Cisco IOS CMTS Cable Command Reference
CBL-930 OL-15510-15
Cable Commands: i through p
interface usb
interface usb
To enter the interface configuration mode for the Universal Serial Bus (USB) interface, use the interface
usb command in global configuration mode.
Cisco uBR925 cable access router, Cisco CVA122 Cable Voice Adapter
interface usb number
Syntax Description number Identifies the USB interface (always 0).
Command Default Disabled
Command Modes Global configuration
Command History Release Modification
12.1(5) XU1 This command was introduced for the Cisco CVA122 Cable Voice Adapter.
12.2(2)XA Support was added for the Cisco uBR925 cable access router.
Usage Guidelines When this command is entered, the router switches from global configuration mode to interface
configuration mode for the USB interface.
Examples The following example shows how to enter interface configuration mode for the USB interface and then
to display the available commands:
Router(config)# interface usb 0
Router(config-if)#?
Interface configuration commands:
access-expression Build a bridge boolean access expression
arp Set arp type (arpa, probe, snap) or timeout
bandwidth Set bandwidth informational parameter
bridge-group Transparent bridging interface parameters
carrier-delay Specify delay for interface transitions
cdp CDP interface subcommands
crypto Encryption/Decryption commands
custom-queue-list Assign a custom queue list to an interface
default Set a command to its defaults
delay Specify interface throughput delay
description Interface specific description
exit Exit from interface configuration mode
fair-queue Enable Fair Queuing on an Interface
h323-gateway Configure H323 Gateway
help Description of the interactive help system
hold-queue Set hold queue depth
ip Interface Internet Protocol config commands
keepalive Enable keepalive
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-931
Cable Commands: i through p
interface usb
load-interval Specify interval for load calculation for an
interface
logging Configure logging for interface
mac-address Manually set interface MAC address
max-reserved-bandwidth Maximum Reservable Bandwidth on an Interface
mtu Set the interface Maximum Transmission Unit (MTU)
no Negate a command or set its defaults
ntp Configure NTP
priority-group Assign a priority group to an interface
random-detect Enable Weighted Random Early Detection (WRED) on an
Interface
service-policy Configure QoS Service Policy
shutdown Shutdown the selected interface
snmp Modify SNMP interface parameters
standby Interface HSRP configuration commands
timeout Define timeout values for this interface
traffic-shape Enable Traffic Shaping on an Interface or
Sub-Interface
transmit-interface Assign a transmit interface to a receive-only
interface
tx-ring-limit Configure PA level transmit ring limit
Router(config-if)#
Related Commands Command Description
show controllers usb Displays the high-level controller information for the USB
interface.
show interfaces usb Displays configuration information about the USB interface.
Cisco IOS CMTS Cable Command Reference
CBL-932 OL-15510-15
Cable Commands: i through p
interface wideband-cable
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 Release 12.2(33)SCB
interface wideband-cable slot/bay/port:wideband-channel
Cisco IOS Release 12.2(33)SCC
interface wideband-cable slot/{subslot | bay}/port:wideband-channel
Cisco uBR7225VXR and Cisco uBR7246VXR Universal Broadband Routers
Cisco IOS Release 12.2(33)SCD
interface wideband-cable slot/port: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
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.
bay The bay in a SIP where a SPA is located. The valid range is from 0 to 3.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-933
Cable Commands: i through p
interface wideband-cable
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.
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.
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
Cisco IOS CMTS Cable Command Reference
CBL-934 OL-15510-15
Cable Commands: i through p
interface wideband-cable
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 Specifies an attribute mask value for a wideband cable interface.
attribute-mask
interface Specifies a modular cable interface.
modular-cable
interface cable Specifies a cable interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-935
Cable Commands: i through p
interval
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.
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 Configures a DOCSIS load balancing group on the CMTS.
docsis-group
show cable Displays real time configuration, statistical, and operational information for
load-balance load balancing operations on the router.
docsis-group
Cisco IOS CMTS Cable Command Reference
CBL-936 OL-15510-15
Cable Commands: i through p
ip-address (controller)
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.
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 Sets the IP address, MAC address and UDP port for each
udp-port RF channel.
rf-channel network delay Specifies the CIN delay for each RF channel.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-937
Cable Commands: i through p
ip-address (controller)
Command Description
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.
Cisco IOS CMTS Cable Command Reference
CBL-938 OL-15510-15
Cable Commands: i through p
ip address docsis
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.
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.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-939
Cable Commands: i through p
ip address docsis
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
Cisco IOS CMTS Cable Command Reference
CBL-940 OL-15510-15
Cable Commands: i through p
ip http cable-monitor
ip http cable-monitor
To enable the cable access router’s onboard Cable Monitor web server, use the ip http cable-monitor
command in global configuration mode. To disable the Cable Monitor and turn off all access to the
onboard Cisco web server, use the no form of this command.
Cisco uBR905, uBR924, uBR925 cable access routers, Cisco CVA122 Cable Voice Adapter
ip http cable-monitor {basic | advance} [url-ip-address url-mask]
no ip http cable-monitor
Syntax Description basic Displays only the basic status and performance pages.
advance Displays all status and diagnostic pages.
Note The Cable Monitor should not be used in advanced mode without
first implementing a secure password strategy on the cable access
router. Enabling the Cable Monitor in advanced mode without
setting an encrypted enabled password could provide information
that would allow remote users to change the router’s configuration.
url-ip-address (Optional) Specifies the IP address for the Cable Monitor. This argument,
along with the url-mask argument, also defines the network that provides
the IP address pool used by the temporary DHCP server when the cable
interface goes down.
url-mask (Optional) Specifies the subnet mask for the Cable Monitor. This argument,
along with the url-ip-address argument, also defines the network that
provides the IP address pool used by the temporary DHCP server when the
cable interface goes down.
Command Default For url-ip-address, 192.168.100.1
For url-mask, 255.255.255.0
Command Modes Global configuration
Command History Release Modification
12.1(1)T This command is introduced 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.
Usage Guidelines This command enables the Cable Monitor, an onboard web server that displays current status,
troubleshooting, and performance information. The Cable Monitor can be accessed in two ways:
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-941
Cable Commands: i through p
ip http cable-monitor
• When the cable access router has established connectivity with the CMTS over the cable interface,
a service technician can use a web browser to remotely access the router and display the desired
information.
• When the cable network is not operational and the cable access router is not online, the subscriber
can access the tool with a PC connected to the router’s Ethernet ports. Technicians can then prompt
the user for the information they need to determine the source of the problem.
Enabling the Cable Monitor also enables the Cisco web server that is onboard the cable access router,
which is the equivalent to entering the ip http server command. However, when the Cable Monitor is
enabled, all other access, including CLI access, to the onboard web server is automatically disabled.
Note When the Cable Monitor is enabled in the startup configuration file, the messages “Starting DNS
process” and “Terminating DNS process” can appear in the messages displayed during boot-up on the
console. These messages are normal and can be ignored.
Disabling the Cable Monitor using the no ip http cable-monitor command also automatically disables
the Cisco web server, which is the equivalent of giving the no ip http server command. When disabling
the Cable Monitor, the console might display warning messages similar to the following:
% monitor-209.165.202.131 is not in the database.
% monitor-192.168.100.1 is not in the database.
% Range [209.165.202.131, 209.165.202.131] is not in the database.
% Range [192.168.100.1, 192.168.100.1] is not in the database.
These messages can be ignored because they are simply confirming that the IP addresses used for the
Cable Monitor are no longer being used for that purpose.
The URL-IP-address and URL-mask arguments also specify that the class C private network
192.168.100.0 is the default address pool for the temporary DHCP server that activates when the cable
interface goes down.
Note The Cable Monitor web interface does not work with the Cisco Easy VPN Remote web interface. To
access the Cable Monitor web interface, you must first disable the Cisco Easy VPN Remote web
interface with the no ip http ezvpn command, and then enable the Cable Monitor with the ip http
cable-monitor command.
Examples The following example shows how to enable the Cable Monitor for advanced mode, in which all status
and diagnostic pages are displayed:
Router(config)# ip http cable-monitor advance
Router(config)#
The following example shows how to disable both the Cable Monitor and the Cisco web server,
preventing all web server access to the Cisco uBR924 cable access router:
Router(config)# no ip http cable-monitor
Router(config)#
Cisco IOS CMTS Cable Command Reference
CBL-942 OL-15510-15
Cable Commands: i through p
ip http cable-monitor
Related Commands Command Description
ip http ezvpn Enables the enable the Cisco Easy VPN Remote web server
interface.
ip http port Configures the TCP port number for the router’s HTTP web server.
The default is the well-known web server port of 80.
ip http server Enables and disables the router’s HTTP web server.
Note The ip http command also supports two options, access-class and authentication, that should not be
used when the Cable Monitor is enabled.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-943
Cable Commands: i through p
ip http ezvpn
ip http ezvpn
To enable the Cisco Easy VPN Remote web server interface, use the ip http ezvpn command in global
configuration mode. To disable the Cisco Easy VPN Remote web interface, use the no form of this
command.
Cisco uBR905 and BR925 cable access routers
ip http ezvpn
no ip http ezvpn
Syntax Description This command has no keywords or arguments.
Command Default The Cisco Easy VPN Remote web interface is disabled by default.
Command Modes Global configuration
Command History Release Modification
12.2(8)YJ, 12.2(15)T This command was introduced for the Cisco uBR905 and Cisco uBR925
cable access routers.
Usage Guidelines This command enables the Cisco Easy VPN Remote web server, an onboard web server that allows users
to connect an IPSec Easy VPN tunnel and to provide the required authentication information. This
allows the user to perform these functions without having to use the Cisco command-line interface.
Before using this command, you must first enable the Cisco web server that is onboard the cable access
router by entering the ip http server command. Then use the ip http ezvpn command to enable the Cisco
Easy VPN Remote web server. You can then access the web server by entering the IP address for the
router’s Ethernet interface in your web browser.
Note The Cisco Easy VPN Remote web interface does not work with the Cable Monitor web interface in
Cisco IOS Release 12.2(8)YJ. To access the Cable Monitor web interface, you must first disable the
Cisco Easy VPN Remote web interface with the no ip http ezvpn command, and then enable the Cable
Monitor with the ip http cable-monitor command.
Examples The following example shows how to enable the Cisco Easy VPN Remote web server interface:
Router# configure terminal
Router(config)# ip http server
Router(config)# ip http ezvpn
Router(config)# exit
Router# copy running-config startup-config
Cisco IOS CMTS Cable Command Reference
CBL-944 OL-15510-15
Cable Commands: i through p
ip http ezvpn
Related Commands Command Description
clear crypto ipsec client ezvpn Resets the Cisco Easy VPN Remote state machine and bring down
the Cisco Easy VPN Remote connection.
crypto ipsec client ezvpn xauth Responds to a pending VPN authorization request.
crypto ipsec client ezvpn (Global configuration mode) Creates a Cisco Easy VPN Remote
(global configuration) configuration.
crypto ipsec client ezvpn (Interface configuration mode) Assigns a Cisco Easy VPN Remote
(interface configuration) configuration to an interface.
crypto ipsec client ezvpn Manually connects to a specified IPSec VPN tunnel.
connect
ip http cable-monitor Enables and disables the Cable Monitor web server feature.
ip http port Configures the TCP port number for the router’s HTTP web server.
The default is the well-known web server port of 80.
ip http server Enables and disables the router’s HTTP web server.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-945
Cable Commands: i through p
ip-address (controller)
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.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.2(33)SCB.
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 Sets the IP address, MAC address and UDP port for each
udp-port RF channel.
Cisco IOS CMTS Cable Command Reference
CBL-946 OL-15510-15
Cable Commands: i through p
ip-address (controller)
Command Description
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.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-947
Cable Commands: i through p
ipdr associate
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.
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.
Cisco IOS CMTS Cable Command Reference
CBL-948 OL-15510-15
Cable Commands: i through p
ipdr collector
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
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.
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.
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.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-949
Cable Commands: i through p
ipdr exporter ack-timeout
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.
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.
Cisco IOS CMTS Cable Command Reference
CBL-950 OL-15510-15
Cable Commands: i through p
ipdr exporter keepalive
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.
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.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-951
Cable Commands: i through p
ipdr exporter max-unacked
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.
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.
Cisco IOS CMTS Cable Command Reference
CBL-952 OL-15510-15
Cable Commands: i through p
ipdr exporter start
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
no ipdr exporter start
Syntax Description This command has no arguments or keywords.
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.
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.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-953
Cable Commands: i through p
ipdr session
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.
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.
Cisco IOS CMTS Cable Command Reference
CBL-954 OL-15510-15
Cable Commands: i through p
ipdr session (global configuration)
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.
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.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-955
Cable Commands: i through p
ipdr template
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.
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
Cisco IOS CMTS Cable Command Reference
CBL-956 OL-15510-15
Cable Commands: i through p
ipdr template
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
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.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-957
Cable Commands: i through p
ipdr type
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.
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
Cisco IOS CMTS Cable Command Reference
CBL-958 OL-15510-15
Cable Commands: i through p
ipdr type
Command Description
cable ipdr Displays a cable modem’s upstream channel status information.
cm-us-status interval
cable ipdr Sets the interval between different spectrum measurements’ data for a
docs-spectrum CMTS.
interval
cable ipdr diaglog Sets the time interval between different diagnostic logs’ data for a CMTS.
interval
cable ipdr cm-status Displays the CMTS and cable modem registration status information.
interval
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-959
Cable Commands: i through p
issu linecard abortversion
issu linecard abortversion
To abort or 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 abort or roll back the versions on redundant line cards only.
issu linecard abortversion all | lc_slot[/subslot] [forced]
Syntax
Description all All redundant line cards.
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 abortversion instead of stopping and
error handling.
Command Default No default behavior or values.
Command Modes Privileged EXEC mode
Command History Release Modification
12.2(33)SCB This command was introduced.
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 aborts 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.
Cisco IOS CMTS Cable Command Reference
CBL-960 OL-15510-15
Cable Commands: i through p
issu linecard abortversion
Command Description
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.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-961
Cable Commands: i through p
issu linecard acceptversion
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 No default behavior or values.
Command Modes Privileged EXEC mode
Command History Release Modification
12.2(33)SCB This command was introduced.
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.
Cisco IOS CMTS Cable Command Reference
CBL-962 OL-15510-15
Cable Commands: i through p
issu linecard changeversion
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.
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 nth line card.
subslot_n The sub slot number for the nth 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 No default behavior or values.
Command Modes Privileged EXEC mode
Command History Release Modification
12.2(33)SCB This command was introduced.
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 abort or 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
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-963
Cable Commands: i through p
issu linecard changeversion
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.
Cisco IOS CMTS Cable Command Reference
CBL-964 OL-15510-15
Cable Commands: i through p
issu linecard loadversion
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 No default behavior or values.
Command Modes Privileged EXEC mode
Command History Release Modification
12.2(33)SCB This command was introduced.
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.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-965
Cable Commands: i through p
issu linecard prepareversion
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 No default behavior or values.
Command Modes Privileged EXEC mode
Command History Release Modification
12.2(33)SCB This command was introduced.
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.
Cisco IOS CMTS Cable Command Reference
CBL-966 OL-15510-15
Cable Commands: i through p
issu linecard prepareversion
Command Description
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.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-967
Cable Commands: i through p
issu linecard reloadversion
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 reloadversion {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 nth line card.
subslot_n The sub slot number for the nth line card.
Command Default No default behavior or values.
Command Modes Privileged EXEC mode
Command History Release Modification
12.2(33)SCB This command was introduced.
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
Cisco IOS CMTS Cable Command Reference
CBL-968 OL-15510-15
Cable Commands: i through p
issu linecard reloadversion
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.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-969
Cable Commands: i through p
issu linecard runversion
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 No default behavior or values.
Command Modes Privileged EXEC mode
Command History Release Modification
12.2(33)SCB This command was introduced.
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.
Cisco IOS CMTS Cable Command Reference
CBL-970 OL-15510-15
Cable Commands: i through p
license feature evaluation disable
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.
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/Licensing/PrivateRegistrationServlet?DemoKeys=Y
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
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-971
Cable Commands: i through p
license feature evaluation disable
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 Enables an evaluation license for Cisco uBR-MC3GX60V and
evaluation enable Cisco UBR-MC20X20V cable interface line cards.
Cisco IOS CMTS Cable Command Reference
CBL-972 OL-15510-15
Cable Commands: i through p
license feature evaluation enable
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.
Usage Guidelines Evaluation licenses are temporary and used to evaluate a feature set on a new cable interface line card.
Ensure that an equivalent permanent license is installed on the Cisco CMTS router 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/Licensing/PrivateRegistrationServlet?DemoKeys=Y
Examples The following example shows how to enable 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 enable all subslot 5/0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-973
Cable Commands: i through p
license feature evaluation enable
The following example shows how to enable a downstream evaluation license for a cable interface line
card on the Cisco uBR10012 router:
Router# configure terminal
Router(config)# license feature evaluation enable DS_License subslot 6/0
The following example shows how to enable an upstream evaluation license for a cable interface line
card on the Cisco uBR10012 router:
Router# configure terminal
Router(config)# license feature evaluation enable US_License subslot 6/1
Related Commands Command Description
license feature Disables an evaluation license for Cisco uBR-MC3GX60V and
evaluation disable Cisco UBR-MC20X20V cable interface line cards.
Cisco IOS CMTS Cable Command Reference
CBL-974 OL-15510-15
Cable Commands: i through p
logging cmts sea
logging cmts sea
To enable the logging of syslog messages to System Event Archive (SEA), use the logging cmts sea
command from global configuration mode. To disable logging of syslog messages to SEA, use the no
form of the command.
logging cmts sea [syslog-level [level]]
no logging cmts sea
Syntax Description syslog-level level (Optional) Configures the level of syslog messages inclusive of and above
the specified level which will be stored in the SEA log file.
Possible values for level Emergency security level indicates system is unusable. The default severity
are: level for emergency syslog messages is 0.
level=emergencies
level=alerts Alerts severity level indicates that immediate action is needed. The default
severity level for alerts syslog messages is 1.
level=critical Critical severity level indicates the critical condition of the system. The
default severity level for critical syslog messages is 2.
level=errors Errors severity level indicates the error conditions. The default severity
level for errors syslog messages is 3.
level=warnings Warning severity level warns the network administrator. The severity level
for warning syslog messages is 4.
level=notifications Notification severity level indicates normal but significant condition of the
system. By default severity level for syslog messages is configured as
‘normal’. The default severity level for notification syslog messages is 5.
level=informational Informational severity level provides additional information about the
system. The default severity level for informational syslog messages is 6.
level=debugging Debugging severity level provides debugging messages. The default
severity level for debugging syslog messages is 7.
Command Default By default, storing of syslog messages to SEA log file is enabled, with the severity-level of syslog
messages being set to ‘notification’.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines Use the logging cmts sea command is used to enable the logging of syslog messages to SEA log file. To
change the severity-level of syslog messages inclusive of and above the level to be stored in SEA log
file, specify the command logging cmts sea [syslog-level level].
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-975
Cable Commands: i through p
logging cmts sea
Examples The following example shows how to enable logging of syslog messages to SEA log file on the Cisco
uBR10012 router:
Router(config)# logging cmts sea
The following example shows how to disable logging of syslog messages to SEA log file on the Cisco
uBR10012 router:
Router(config)# no logging cmts sea
The following example shows how to change the severity-level of syslog messages inclusive of and
above the level being stored in the SEA log file:
Router(config)# logging cmts sea syslog-level warning
Related Commands clear logging system Clears the event records stored in the SEA.
copy logging system Copies the archived system events to another location.
logging system Enables or disables the SEA logging system.
Cisco IOS CMTS Cable Command Reference
CBL-976 OL-15510-15
Cable Commands: i through p
mac-address
mac-address
To modify the default MAC address of an interface to some user-defined address, use the mac-address
command in interface configuration mode. To return to the default MAC address on the interface, use
the no form of this command.
mac-address ieee-address
no mac-address ieee-address
Syntax Description ieee-address 48-bit IEEE MAC address written as a dotted triple of four-digit
hexadecimal numbers.
Defaults The interface uses a default MAC address that is derived from the base address stored in the electrically
erasable programmable read-only memory (EEPROM).
Command Modes Interface configuration
Usage Guidelines Be sure that no other interface on the network is using the MAC address that you assign.
There is a known defect in earlier forms of this command when the Texas Instruments Token Ring MAC
firmware is used. This implementation is used by Proteon, Apollo, and IBM RTs. A host using a MAC
address whose first two bytes are zeros (such as a Cisco router) will not properly communicate with
hosts using that form of this command of TI firmware.
There are two solutions. The first involves installing a static Routing Information Field (RIF) entry for
every faulty node with which the router communicates. If there are many such nodes on the ring, this
may not be practical. The second solution involves setting the MAC address of the Cisco Token Ring to
a value that works around the problem.
This command forces the use of a different MAC address on the specified interface, thereby avoiding
the Texas Instrument MAC firmware problem. It is up to the network administrator to ensure that no
other host on the network is using that MAC address.
Examples The following example sets the MAC layer address, where xx.xxxx is an appropriate second half of the
MAC address to use:
interface tokenring 0
mac-address 5000.5axx.xxxx
The following example changes the default MAC address on the interface to 1111.2222.3333:
Router# configure terminal
Router(config)# interface fastethernet 2/1/1
Router(config-if)# mac-address 1111.2222.3333
Related Commands
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-977
Cable Commands: i through p
mac-address
Command Description
show interfaces fastethernet Displays information about the Fast Ethernet interfaces.
show interfaces Displays information about the Gigabit Ethernet interfaces.
gigabitethernet
Cisco IOS CMTS Cable Command Reference
CBL-978 OL-15510-15
Cable Commands: i through p
main-cpu
main-cpu
To enter main-CPU redundancy configuration mode, so that you can configure the synchronization of
the active and standby Performance Routing Engine (PRE1) modules, use the main-cpu command in
redundancy configuration mode.
main-cpu
Syntax Description This command has no keywords or arguments.
Defaults No default behavior or values
Command Modes Redundancy configuration (config-r)
Command History Release Modification
12.2(4)XF This command was introduced for the Cisco uBR10012 router.
12.2(11)BC3 Support for the switchover timeout command was added.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
Usage Guidelines When you enter main-CPU redundancy configuration mode, the prompt changes to the following:
Router(config-r-mc)#
After you enter main-CPU redundancy configuration mode, you can use the auto-sync command to
specify which files are synchronized between the active and standby PRE1 modules. In Cisco IOS
Release 12.2(11)BC3 and later releases, you can also use the switchover timeout command to specify
the amount of time that the standby PRE1 module should wait when it first detects that the active PRE1
module is not active and when it initiates a switchover and becomes the active PRE1 module.
To leave main-CPU redundancy configuration mode and to return to redundancy configuration mode,
use the exit command.
Examples The following example shows how to enter main-CPU redundancy mode and the commands that are
available there:
Router# config t
Router(config)# redundancy
Router(config-r)# main-cpu
Router(config-r-mc)# ?
Main Cpu redundancy configuration commands:
auto-sync Sync elements
exit Exit from main-cpu configuration mode
no Negate a command or set its defaults
switchover Configuration of switchover
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-979
Cable Commands: i through p
main-cpu
Router(config-r-mc)#
Related Commands Command Description
associate slot Logically associate slots for APS processor redundancy
auto-sync Configures which files are synchronized between the active and standby
PRE1 modules.
redundancy Enters redundancy configuration mode.
switchover timeout Configures the switchover timeout period of the PRE1 module.
Cisco IOS CMTS Cable Command Reference
CBL-980 OL-15510-15
Cable Commands: i through p
maintenance-mode
maintenance-mode
To configure the PRE1 modules on the router for maintenance mode, use the maintenance-mode
command in redundancy configuration mode. To return to normal operations, use the no form of this
command.
maintenance-mode
no maintenance-mode
Syntax Description This command has no keywords or arguments.
Command Default Normal operations (no maintenance-mode)
Command Modes Redundancy configuration
Command History Release Modification
12.2(4)XF This command was introduced for the Cisco uBR10012 router.
Usage Guidelines When the Cisco uBR10012 router is configured with redundant PRE1 modules, the active PRE1 module
automatically synchronizes the configuration, network state information, and other information with the
standby PRE1 module, so that if a switchover occurs, the standby module can restore normal operations
quickly. You can use the maintenance-mode command to disable this automatic synchronization of the
PRE1 modules, and to disable the reporting of any faults on the standby module to the active module.
Note The maintenance-mode command disables the ability of the Cisco uBR10012 router to switchover
PRE1 modules and should be used only while upgrading the router or troubleshooting network problems.
Examples The following example shows how to disable the automatic PRE1 module synchronization on the
Cisco uBR10012 router and enter maintenance mode:
Router# config t
Router(config)# redundancy
Router(config-r)# maintenance-mode
Router(config-r)# exit
Router(config)#
The following example shows how to leave maintenance mode and return to normal operations, which
includes the automatic synchronization of the PRE1 modules:
Router# config t
Router(config)# redundancy
Router(config-r)# no maintenance-mode
Router(config-r)# exit
Router(config)#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-981
Cable Commands: i through p
maintenance-mode
Related Commands Command Description
auto-sync Configures which files are synchronized between the active and standby
PRE1 modules.
redundancy Enters redundancy configuration mode.
Cisco IOS CMTS Cable Command Reference
CBL-982 OL-15510-15
Cable Commands: i through p
match rule
match rule
To configure the match rule, rule priority and related action in the selected cable multicast authorization
profile, use the match rule command in interface configuration mode. To disable a cable multicast
authorization profile match, use the no form of this command.
match rule [ipv4 | ipv6] [source-prefix] [group-prefix] priority [priority-value] [permit | deny]
no match rule [ipv4/ipv6] [source-prefix] [group-prefix] priority [priority-value] [permit/deny]
Syntax Description match rule [ipv4 | ipv6] Specifies the matching source rule.
Note Though CLI allows IPv6 to be configured, only IPv4 is supported in
the CMTS.
source-prefix (Optional) Specifies the matching source address prefix.
Example: 223.1.1.1/16
group-prefix (Optional) Specifies the matching group address prefix.
Example: 223.1.1.1/16
priority Specifies the priority of the cable multicast authorization profile.
[priority-value] Priority value range is: 0-255.
permit The argument permit allows specified packets to be forwarded.
deny The argument deny allows to specified packets to be rejected.
Command Default Cable multicast authorization is disabled.
Command Modes Interface configuration—cable interface only (config-mauth)
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines This command specifies the cable multicast authorization profile match to be used.
Examples The following example shows how to use the selected multicast authorization profile match:
Router(config-mauth)# match rule rule1
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-983
Cable Commands: i through p
match rule
Related Commands Command Description
cable multicast This command enables the cable multicast authorization features. If the
authorization enable multicast authorization feature is disabled, all defined authorization profiles
default-action are ineffective.
cable multicast Defines the cable multicast authorization profile.
authorization
profile-name
show cable multicast Displays the list of defined multicast authorization profiles and all CMs
authorization associated with corresponding profiles.
Cisco IOS CMTS Cable Command Reference
CBL-984 OL-15510-15
Cable Commands: i through p
member subslot
member subslot
To configure the redundancy role of a line card, use the member subslot command in line card
redundancy group mode.
member subslot slot/subslot {primary | secondary}
no member subslot slot/subslot {primary | secondary}
uBR10012 Universal Broadband Routers
member subslot slot/subslot {protect [config slot/subslot | rf-power [rf-connector
rfconnector-value] {hccp-delta diff-pwr | hccp-override override-pwr}] | working [rfsw-slot
slot-value] | revertive | reverttime value}
no member subslot slot/subslot {protect [config slot/subslot | rf-power [rf-connector
rfconnector-value] {hccp-delta diff-pwr | hccp-override override-pwr}] | working [rfsw-slot
slot-value] | revertive | reverttime value}
Syntax Description slot Slot number of the line card in the chassis.
subslot Slot number of the line card in the chassis.
primary | secondary Configures the redundancy role of the line card.
• primary—Active line card.
• secondary—Standby line card.
protect Specifies the protect slot in the line card group.
config slot/subslot (Optional) Specifies the appropriate working interface configuration that is
used for the protect interface when a switchover occurs.
rf-power (Optional) Specifies the RF power output level on an integrated upconverter.
rf-connector (Optional) Specifies the RF connector in the protect line card. The default
rfconnector-value value is all.
hccp-delta diff-pwr When using N+1 Hotstandby Connection-to-Connection Protocol (HCCP)
redundancy, the protect interface adds the diff-pwr value to the current power
value of the working interface when a switchover occurs. This allows the
router to accommodate relative differences between the RF power levels in
working and protect interfaces. The valid value for diff-pwr ranges from –12
to +12 dBmV.
hccp-override When using N+1 HCCP redundancy, the protect interface uses the override
override-pwr power value instead of the power value of the working interface when a
switchover occurs. This allows the router to accommodate absolute
differences between the RF power levels in working and protect interfaces.
The valid value for override-pwr ranges from 45 to 63 dBmV.
Note The official range for acceptable power levels in the DOCSIS
specification is 50 to 61 dBmV. Cisco cable interfaces exceed the
DOCSIS standard, but power levels outside the DOCSIS standards
should be used only in lab and test environments.
working Specifies the working slot in the line card group.
rfsw-slot slot-value (Optional) Specifies the RF switch slot for the working line card.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-985
Cable Commands: i through p
member subslot
revertive Specifies the revert operation on the protect card.
reverttime value Specifies the time interval for the revert operation in minutes. If you specify
the time interval as 30 minutes, the protect card switches back to the protect
mode after 30 minutes.
Command Default None
Command Modes Line card redundancy group
Command History Release Modification
12.2(28)SB This command was introduced for the Cisco 10000 series routers.
12.3(23)BC This command was integrated into Cisco IOS Release 12.3(23)BC.
12.2(33)SCA Support for the following keywords was removed in
Cisco IOS Release 12.2(33)SCA and later releases:
• revertive
• reverttime
Note Use the revertive command in line card redundancy group mode to
enable the revert operation on a protect card in
Cisco IOS Release 12.2(33)SCA and later releases.
12.2(33)SCC4 Support for the following keywords was added in Cisco
IOS Release 12.2(33)SCC4 for Cisco uBR10012 routers:
• rf-power
• rf-connector
• hccp-delta
• hccp-override
12.2(33)SCE The config option of the command was made the default. When more than
one working line cards are configured, the config option is automatically
applied to the first working card.
Usage Guidelines The primary line card must be the first line card configured and must occupy subslot 1. The secondary
line card must be the second line card configured and must occupy subslot 0. Only one primary line card
and one secondary line card can be configured.
Examples The following example shows how to create a line card group number 1 for one-to-one line card
redundancy. It also specifies the line card in subslot 1 as the primary (active) line card, and the line card
in subslot 0 as the secondary (standby) line card.
Router# configure terminal
Router(config)# redundancy
Router(config-red)# linecard-group 1 y-cable
Router(config-red-lc)# member subslot 2/1 primary
Router(config-red-lc)# member subslot 2/0 secondary
Cisco IOS CMTS Cable Command Reference
CBL-986 OL-15510-15
Cable Commands: i through p
member subslot
Note The rest of the examples listed here are only applicable to Cisco uBR10012 routers.
The following example shows how to configure a protect interface to add 3 dBmV to the current working
RF power level when a switchover occurs:
Router# configure terminal
Router(config)# redundancy
Router(config-red)# linecard-group 1 cable
Router(config-red-lc)# member subslot 5/1 protect rf-power hccp-delta 3
The following example shows how to configure a protect interface to use an RF power level of 48 dBmV
instead of the current working RF power level when a switchover occurs:
Router# configure terminal
Router(config)# redundancy
Router(config-red)# linecard-group 1 cable
Router(config-red-lc)# member subslot 5/1 protect rf-power hccp-override 48
The following example shows how to configure a rf-connector 3 on a protect interface to add 5 dBmV
to the current working RF power level when a switchover occurs:
Router# configure terminal
Router(config)# redundancy
Router(config-red)# linecard-group 1 cable
Router(config-red-lc)# member subslot 5/1 protect rf-power rf-connector 3 hccp-delta 5
Related Commands Command Description
linecard-group Creates a line card group for one-to-one line card redundancy.
redundancy Enters redundancy mode.
show redundancy Displays information about a redundant line card or line card group.
linecard
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-987
Cable Commands: i through p
method
method
To select the method the CMTS uses to determine the load, use the method command in the
config-lb-group configuration mode. To reset the method, use the no form of this command.
method {modems | service-flows | utilization} {us-method {modems | service-flows |
utilization}
no method
Syntax Description modems Specifies the load balancing method for the number of modems on the
CMTS.
service-flows Specifies the load balancing method for the number of service flows on the
CMTS.
utilization Specifies the load balancing method for the interface utilization on the
CMTS.
us-method {modems | Specifies the load balancing method for upstream (US) channels on modems,
service-flows | service-flows, or utilization.
utilization}
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.
Usage Guidelines The upstream channel uses the same method as the downstream channel. Change the method of the
upstream channel using the method command.
Examples The following example shows how to select the method the CMTS uses to determine the load, using the
method 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)# method modems us-method service-flows
Router(config-lb-group)#
Related Commands
Cisco IOS CMTS Cable Command Reference
CBL-988 OL-15510-15
Cable Commands: i through p
method
Command Description
cable load-balance Configures a DOCSIS load balancing group on the CMTS.
docsis-group
show cable Displays real-time configuration, statistical, and operational information
load-balance for load balancing operations on the router.
docsis-group
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-989
Cable Commands: i through p
microcode (uBR10012)
microcode (uBR10012)
To reload the microcode software images on a Parallel eXpress Forwarding (PXF) processor or on all
line cards that support downloadable microcode, use the microcode command in global configuration
mode.
microcode {pxf filename | reload}
Syntax Description pxf Reloads the microcode for the PXF processors on the Performance Routing
Engine (PRE1) module.
filename Specifies the microcode software image for the PXF processors by device
name and filename.
reload Reloads the microcode for all PRE1 modules and other line cards that
support downloadable microcode software images.
Command Default No default behavior or values
Command Modes Global configuration
Command History Release Modification
12.2(1)XF1 This command was introduced for the Cisco uBR10012 router.
Usage Guidelines By default, the Cisco uBR10012 router automatically loads all required microcode on to the PXF
processors and other line cards when it loads the Cisco IOS software image. Also, the PRE1 module
automatically reloads the microcode on a card when certain faults occur, allowing the card to recover
from the fault.
You can reload the microcode on the PRE1 module or on all line cards that support downloadable
microcode by using the microcode command. Typically, this is not needed and should be done only
upon the advice of Cisco TAC or field service engineers.
Tip You can also reload the microcode on the PXF processors or on all cards using the microcode reload
command in privileged EXEC mode. In particular, use the microcode reload command to reload the
PXF processors with the default microcode that was loaded along with the Cisco IOS software image.
Examples The following example shows how to reload the microcode on all PRE processors and line cards that
support downloadable microcode:
Router# configure terminal
Router(config)# microcode reload
Reload microcode? [confirm] yes
00:49:41: Downloading Microcode: file=system:pxf/ubr10k-ucode.1.2.3,
Cisco IOS CMTS Cable Command Reference
CBL-990 OL-15510-15
Cable Commands: i through p
microcode (uBR10012)
version=1.1.0, description=Release Software created Wed 17-Jul-02 16:58
<<list of interfaces going down or coming up>>
00:49:42: !!pxf clients started, forwarding code operational!!
Router(config)#
The following example shows how to reload the microcode on the PXF processors on the PRE1 module,
using a specific image that is stored in the Flash memory:
Router# configure terminal
Router(config)# microcode pxf flash:pxf/ubr10k-ucode.122.1.2.3
Reload microcode? [confirm] yes
1d04h: Downloading Microcode: file=flash:pxf/ubr10k-ucode.122.1.2.3, version=122.1.2.3,
description=Release Software created Thu 17-Oct-02 11:33
<<list of interfaces going down or coming up>>
1d04h: !!pxf clients started, forwarding code operational!!
Router(config)#
Related Commands Command Description
hw-module reset Resets a particular PRE1 module or a particular line card.
microcode reload Reloads the microcode software images on one or all line cards that support
downloadable microcode.
show pxf microcode Displays display identifying information for the microcode being used on
the PXF processors.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-991
Cable Commands: i through p
microcode reload (uBR10012)
microcode reload (uBR10012)
To reload the microcode software images on one or all line cards that support downloadable microcode,
use the microcode reload command in privileged EXEC mode.
microcode reload {all | pxf [device:[filename]]}
Syntax Description all Reloads the microcode for all Performance Routing Engine (PRE1)
modules and other line cards that support downloadable microcode
software images.
pxf Reloads the microcode for the Parallel eXpress Forwarding (PXF)
processors on the PRE1 module.
device:[filename] (Optional) Loads the PXF processors with the microcode software image
that has the specific filename on the specific device. If no filename is
specified, the first image found on the device is loaded by default.
Command Default For microcode reload pxf, defaults to loading the microcode image that was originally loaded when the
Cisco IOS software image was loaded.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(1)XF1 This command was introduced for the Cisco uBR10012 router.
Usage Guidelines By default, the Cisco uBR10012 router automatically loads all required microcode on to the PXF
processors and other line cards when it loads the Cisco IOS software image. Also, the PRE1 module
automatically reloads the microcode on a card when certain faults occur, allowing the card to recover
from the fault.
You can reload the microcode on the PRE1 module or on all line cards that support downloadable
microcode by using the microcode reload command. Typically, this is not needed and should be done
only upon the advice of Cisco TAC or field service engineers.
Tip You can also reload the microcode on the PXF processors or on all cards using the microcode command
in global configuration mode.
Examples The following example shows how to reload the microcode on all PRE processors and line cards that
support downloadable microcode:
Router# microcode reload all
Reload microcode? [confirm] yes
Cisco IOS CMTS Cable Command Reference
CBL-992 OL-15510-15
Cable Commands: i through p
microcode reload (uBR10012)
00:49:41: Downloading Microcode: file=system:pxf/ubr10k-1-ucode.122.1.0, version=122.1.0,
description=Release Software created Wed 17-Jul-02 16:58
<<list of interfaces going down or coming up>>
00:49:42: !!pxf clients started, forwarding code operational!!
Router#
The following example shows a typical list of devices that you can use when loading microcode for the
PXF processors. This list might vary, depending on whether a standby PRE1 module is installed and
depending on the version of Cisco IOS software being used.
Router# microcode reload pxf ?
bootflash: location of microcode
disk0: location of microcode
disk1: location of microcode
flash: location of microcode
ftp: location of microcode
null: location of microcode
nvram: location of microcode
rcp: location of microcode
scp: location of microcode
sec-bootflash: location of microcode
sec-disk0: location of microcode
sec-disk1: location of microcode
sec-nvram: location of microcode
sec-slot0: location of microcode
sec-slot1: location of microcode
slot0: location of microcode
slot1: location of microcode
system: location of microcode
tftp: location of microcode
<cr>
Router#
The following example shows how to reload the microcode on the PXF processors on the PRE1 module,
using a specific image that is stored in the Flash memory:
Router# microcode reload pxf flash:pxf/ubr10k-1-ucode.122.1.0.4
Reload microcode? [confirm] yes
3d00h: Downloading Microcode: file=flash:pxf/ubr10k-1-ucode.122.1.0.4, version=122.1.0.4,
description=Release Software created Thu 27-Jun-02 16:05
<<list of interfaces going down or coming up>>
3d00h: !!pxf clients started, forwarding code operational!!
Router#
Related Commands Command Description
hw-module reset Resets a particular PRE1 module or a particular line card.
microcode Reloads the microcode software images on one or all line cards that support
downloadable microcode.
show pxf microcode Displays display identifying information for the microcode being used on
the PXF processors.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-993
Cable Commands: i through p
mode (redundancy)
mode (redundancy)
To configure the redundancy mode of operation, use the mode command in redundancy configuration
mode.
Cisco 7304 Router
mode {rpr | rpr-plus | sso}
Cisco 7500 Series Routers
mode {hsa | rpr | rpr-plus | sso}
Cisco 10000 Series Routers
mode {rpr-plus | sso}
Cisco 12000 Series Routers
mode {rpr | rpr-plus | sso}
Cisco uBR10012 Universal Broadband Router
mode {rpr-plus | sso}
Syntax Description rpr Route Processor Redundancy (RPR) redundancy mode.
rpr-plus Route Processor Redundancy Plus (RPR+) redundancy mode.
sso Stateful Switchover (SSO) redundancy mode.
hsa High System Availability (HSA) redundancy mode.
Command Default The default mode for the Cisco 7500 series routers is HSA.
The default mode for the Cisco 7304 router and Cisco 10000 series routers is SSO.
The default mode for the Cisco 12000 series routers is RPR.
The default mode for the Cisco uBR10012 universal broadband router is SSO.
Command Modes Redundancy configuration (config-red)
Command History Release Modification
12.0(16)ST This command was introduced.
12.0(22)S SSO support was added.
12.2(18)S This command was integrated into Cisco IOS Release 12.2(18)S.
12.2(20)S Support was added for the Cisco 7304 router. The Cisco 7500 series router
is not supported in Cisco IOS Release 12.2(20)S.
12.2(28)SB This command was integrated into Cisco IOS Release 12.2(28)SB.
Cisco IOS CMTS Cable Command Reference
CBL-994 OL-15510-15
Cable Commands: i through p
mode (redundancy)
Release Modification
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SXH This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
12.2(33)SCE This command was modified in Cisco IOS Release 12.2(33)SCE. The
rpr-plus keyword was removed.
Usage Guidelines The mode selected by the mode command in redundancy configuration mode must be fully supported
by the image that has been set into both the active and standby Route Processors (RPs). A high
availability image must be installed into the RPs before RPR can be configured. Use the hw-module slot
image command to specify a high availability image to run on the standby RP.
For Cisco IOS Release 12.2(33)SCA on the Cisco 10000 series routers and the Cisco uBR10012
universal broadband router, the use of SSO redundancy mode is recommended because RPR+
redundancy mode is being removed. If you enable RPR+ redundancy mode, you may see the following
message:
*********************************************************
* Warning, The redundancy mode RPR+ is being deprecated *
* and will be removed in future releases. Please change *
* mode to SSO: *
* redundancy *
* mode sso *
********************************************************
Examples The following example configures RPR+ redundancy mode on a Cisco 12000 series or Cisco 1000 series
router:
Router# mode rpr-plus
The following example sets the mode to HSA on a Cisco 7500 series router:
Router# mode hsa
Related Commands Command Description
clear redundancy Clears the redundancy event history log.
history
hw-module slot image Specifies a high availability Cisco IOS image to run on an active or standby
Route Processor (RP).
redundancy Enters redundancy configuration mode.
redundancy Forces the standby Route Processor (RP) to assume the role of the active
force-switchover RP.
show redundancy Displays current active and standby Performance Routing Engine (PRE)
redundancy status.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-995
Cable Commands: i through p
modular-host subslot
modular-host subslot
To specify the modular-host line card that will be used for DOCSIS 3.0 downstream or downstream
channel bonding operations, use the modular-host subslot command in controller configuration mode.
To remove the modular-host line card used for DOCSIS 3.0 downstream or downstream channel bonding
operations, use the no form of this command.
modular-host subslot slot/subslot
no modular-host subslot slot/subslot
Syntax Description slot/subslot The location of the modular-host line card.
Command Default No modular-host line card is configured for DOCSIS 3.0 downstream or downstream channel bonding
operations.
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.
Usage Guidelines This command specifies the modular-host line card for DOCSIS 3.0 downstream or downstream channel
bonding operations. This applies to the cable interface line card (for example, the Cisco
uBR10-MC5X20S-D line card) that is used for these operations. The Wideband SPA itself does not
support DOCSIS 3.0 downstream channel bonding operations.
Note A maximum of 3 SPA controllers can be hosted on a single cable interface line card.
Examples The following example shows how to configure the modular-host line card for DOCSIS 3.0 downstream
channel bonding operations for the Wideband SPA located in slot/subslot/bay 1/0/0:
Router(config)# controller modular-cable 1/0/0
Router(config-controller)# modular-host subslot 7/0
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.
Cisco IOS CMTS Cable Command Reference
CBL-996 OL-15510-15
Cable Commands: i through p
modular-host subslot
Command Description
controller modular-cable Enters controller configuration mode to configure the Wideband SPA
controller.
ip-address (controller) Sets the IP address of the Wideband SPA FPGA.
rf-channel frequency Sets the frequency for each RF channel.
rf-channel ip-address Sets the IP address, MAC address and UDP port for each RF channel.
mac-address udp-port
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 Assigns a downstream channel ID to an RF channel.
channel-id
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-997
Cable Commands: i through p
monitoring-basics
monitoring-basics
To specify the type of monitoring for subscriber traffic management on a Cisco CMTS router, use the
monitoring-basics command in enforce-rule configuration mode. To disable the selected monitoring,
use the no form of this command.
monitoring-basics {legacy | peak-offpeak} {docsis10 | docsis11}
no monitoring-basics {legacy | peak-offpeak} {docsis10 | docsis11}
Syntax Description legacy Provides only one threshold and one monitoring duration.
peak-offpeak Allows the selection of two peak durations within a day.
docsis10 Specifies application of the enforce-rule to DOCSIS 1.0 cable modems.
docsis11 Specifies application of the enforce-rule to DOCSIS 1.1 cable modems.
Command Default The default for this command is legacy and docsis10.
Command Modes Enforce-rule configuration (enforce-rule)
Command History Release Modification
12.3(9a)BC This command was introduced.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines Legacy monitoring (using the legacy keyword) occurs 24 hours a day, with no distinction between peak
and offpeak hours. The available monitoring duration is between 10 minutes and 31 days.
Use the peak-offpeak keyword to set up monitoring duration and threshold for first peak, second peak,
and offpeak monitoring. Each one can be different. After setting up first peak and second peak durations,
the remaining hours are treated as offpeak. Monitoring happens during offpeak hours if the offpeak
duration and threshold are defined. Monitoring duration is between 60 minutes and 23 hours.
Examples The following example shows configuration of peak-offpeak monitoring for DOCSIS 1.1 cable modems:
Router(enforce-rule)# monitoring-basics peak-offpeak docsis11
Related Commands Command Description
cable qos enforce-rule Creates an enforce-rule to enforce a particular QoS profile for subscriber
traffic management and enters enforce-rule configuration mode.
debug cable Displays enforce-rule debug messages for subscriber traffic management on
subscriber-monitoring the Cisco CMTS routers.
Cisco IOS CMTS Cable Command Reference
CBL-998 OL-15510-15
Cable Commands: i through p
monitoring-basics
Command Description
duration Specifies the time period and sample rate to be used for monitoring
subscribers.
peak-time1 Specifies peak and offpeak monitoring times.
qos-profile registered Specifies the registered QoS profile that should be used for this enforce-rule.
qos-profile enforced Specifies a QoS profile that should be enforced when users violate the
registered QoS profiles.
service-class Identifies a particular service class for cable modem monitoring in an
(enforce-rule) enforce-rule.
show cable qos Displays the QoS enforce-rules that are currently defined.
enforce-rule
show cable Displays subscribers who are violating their registered QoS profiles.
subscriber-usage
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-999
Cable Commands: i through p
monitoring-duration
monitoring-duration
Note Effective with Cisco IOS Release 12.3(9a)BC, the monitoring-duration command is replaced by the
duration command.
To specify the time period and sample rate to be used for monitoring subscribers, use the
monitoring-duration command in enforce-rule configuration mode. To reset an enforce-rule to its
default values, use the no form of this command.
monitoring-duration minutes [sample-rate minutes]
no monitoring-duration
Syntax Description minutes Specifies the time (in minutes). The valid range is 10 to 10080, with a
default of 360 (6 hours).
sample-rate minutes (Optional) Rate of sampling, in minutes. The valid range is 1 to 30,
with a default value of 15.
Defaults The monitoring-duration value defaults to 360 minutes (6 hours), and the sample-rate value defaults
to 15 minutes.
Command Modes Enforce-rule configuration (enforce-rule)
Command History Release Modification
12.2(15)BC1 This command was introduced.
12.2(15)BC2 The minimum sample-rate was reduced to 1 minute. Also, the sample-rate
is not allowed to be set to a value greater than the monitoring-duration
period. If you attempt to do so, the command is ignored and both parameters
remain set to their current values.
12.3(9a)BC This command was replaced by the duration command.
Usage Guidelines The sample-rate minutes must be less than or equal to the monitoring-duration minutes period.
When you enable an enforce-rule, the Cisco CMTS router periodically checks the bandwidth being used
by subscribers, to determine whether any subscribers are consuming more bandwidth than that specified
by their registered QoS profile. The Cisco CMTS router keeps track of the subscribers using a sliding
window that begins at each sample-rate interval and continues for the monitoring-duration period.
For example, with the default sample-rate interval of 15 minutes and the default monitoring-duration
window of 360 minutes, the Cisco CMTS router samples the bandwidth usage every 15 minutes and
determines the total bytes transmitted at the end of each 360-minute period. Each sample-rate interval
begins a new sliding window period for which the Cisco CMTS router keeps track of the total bytes
transmitted.
Cisco IOS CMTS Cable Command Reference
CBL-1000 OL-15510-15
Cable Commands: i through p
monitoring-duration
Note The sample-rate interval must be less than or equal to the monitoring-duration period. If you attempt
to set the sample-rate interval to a value greater than the monitor-duration period, the command is
ignored and the parameters are unchanged.
When you change the configuration of a currently active enforce-rule, that rule begins using the new
configuration immediately to manage the cable modems tracked by this enforce-rule.
For more information about the Subscriber Traffic Management feature and to see an illustration of a
sample monitoring window, refer to the Subscriber Traffic Management for the Cisco CMTS Routers
feature document on Cisco.com.
Examples The following example shows an enforce-rule being configured for a monitoring-duration period that is
20 minutes in length, with a sampling rate of every 10 minutes:
Router# configure terminal
Router(config)# cable qos enforce-rule residential
Router(enforce-rule)# monitoring-duration 20 sample-interval 10
The following example shows the error message that is displayed when the sample-rate interval is
configured to be greater than the monitoring-duration period. In this situation, the command is ignored
and the parameters remain unchanged.
Router# configure terminal
Router(config)# cable qos enforce-rule residential
Router(enforce-rule)# monitoring-duration 20 sample-interval 30
Monitoring duration cannot be less than the Sampling interval -- so the values
would remain unchanged
Related Commands Command Description
activate-rule Specifies the number of bytes that a subscriber can transmit during the
at-byte-count monitoring period on a Cisco CMTS router.
cable qos enforce-rule Creates an enforce-rule to enforce a particular QoS profile for subscriber
traffic management and enters enforce-rule configuration mode.
enabled (enforce-rule) Activates an enforce-rule and begins subscriber traffic management on a
Cisco CMTS router.
penalty-period Specifies the time period that an enforced QoS profile should be in effect for
subscribers that violate their registered QoS profiles.
qos-profile enforced Specifies a QoS profile that should be enforced when users violate their
registered QoS profiles.
qos-profile registered Specifies the registered QoS profile that should be used for this enforce-rule.
show cable qos Displays the QoS enforce-rules that are currently defined.
enforce-rule
show cable Displays subscribers who are violating their registered QoS profiles.
subscriber-usage
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1001
Cable Commands: i through p
name
name
To specify the name of the CMTS tag, use the name command in the cmts-tag configuration mode. To
remove the name, use the no form of this command.
name tag-name
no name tag-name
Syntax Description tag-name Name of the CMTS tag. The configured name is added to the DOCSIS load
balancing group and policies.
Command Default No default behavior or values.
Command Modes CMTS tag mode (cmts-tag)
Command History Release Modification
12.2(33)SCC This command was introduced.
Examples The following example shows how to give name to a CMTS tag using the name command:
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# cable tag 1
Router(cmts-tag)# name cisco
Related Commands Command Description
cable load-balance To configure a DOCSIS load balancing group on the CMTS.
docsis-group
show cable To display real-time configuration, statistical and operational information
load-balance for load balancing operations on the router.
docsis-group
cable tag To configure a tag for a DOCSIS load balancing group on the CMTS.
Cisco IOS CMTS Cable Command Reference
CBL-1002 OL-15510-15
Cable Commands: i through p
network
network
To configure the DHCP address pool with the specified network-number and subnet mask, which are the
DHCP yiaddr field and Subnet Mask (DHCP option 1) field, use the network command in global
configuration mode. To remove this configuration, use the no form of this command.
network network-number [mask]
no network network-number [mask]
Syntax Description network-number The DHCP yiaddr field.
mask Subnet Mask (DHCP option 1). If you do not specify the mask value, it is
supported to 255.255.255.255.
Command Default DHCP settings are not configured by default.
Command Modes DHCP configuration
Command History Release Modification
Release 12.2(4)BC1 Supoported on the Cisco uBR7100 series, Cisco uBR7200 series, and
Cisco uBR10012 routers.
Usage Guidelines This command requires that you first use the dhcp ip dhcp pool name command in global configuration
mode to enter DHCP configuration mode.
Note To create an address pool with a single IP address, use the host command instead of network.
For additional information about DHCP support on the Cisco CMTS, refer to the following document
on Cisco.com:
• DHCP and ToD Servers on the Cisco CMTS
Examples The following example illustrates use of the network command with the ip dhcp pool name command.
Router# configure terminal
Router(config)# ip dhcp pool name platinum
Router(dhcp-config)# network 10.10.10.0 255.255.0.0
Router(dhcp-config)#
Related Commands ip dhcp pool name Creates a DHCP address pool and enters DHCP pool configuration file mode.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1003
Cable Commands: i through p
nls
nls
To enable Network Layer signaliing (NLS) functionality, use the nls command in global configuration
mode. To disable NLS functionality, use the no form of this command.
nls [authentication]
no nls [authentication]
Syntax Description authentication (Optional) Enables NLS protocol security authentication.
Command Default Disabled.
Command Modes Global configuaration
Command History Release Modification
12.3(21a)BC3 This command was introduced.
Usage Guidelines It is recommended that NLS message authentication is enabled all the time.
Examples The following example shows nls enabled on a router:
router (config)# nls
Related Commands Command Description
cpd Enables the CPD feature.
nls ag-id auth-key Configures an Authorization Group Identifier (AG ID) for CMTS.
nls resp-timeout Configures NLS response timeout.
Cisco IOS CMTS Cable Command Reference
CBL-1004 OL-15510-15
Cable Commands: i through p
nls ag-id auth-key
nls ag-id auth-key
To configure an Authorization Group Identifier (AG ID) for CMTS, use the nls ag-id auth-key
command in global configuration mode. To disable the AG ID, use the no form of this command.
nls ag-id auth-key
no nls ag-id auth-key
Syntax Description ag-id number Authorization Group Identifier. The valid range is 1-4294967294.
auth-key char Authentication key provisioned on CMTS. The valid range is 20-64.
Command Default Disabled
Command Modes Global configuaration
Command History Release Modification
12.3(21a)BC3 This command was introduced.
Examples The following example shows configuring the AG ID:
Router(config) # nls ag-id 345 auth-key 54
Related Commands Command Description
cpd Enables CPD.
nls Enables Network Layer signaliing (NLS) functionality.
nls resp-timeout Configures NLS response timeout.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1005
Cable Commands: i through p
nls resp-timeout
nls resp-timeout
To configure the NLS response timeout, use the nls resp-timeout command in global configuration
mode. To disable CPD, use the no form of this command.
nls resp-timeout timeout number
no nls resp-timeout timeout number
Syntax Description timeout number Controls the time CTMS will wait before getting a response for an NLS
information request. The valid range is 1-60 seconds. Upon a response
timeout, the CPD message is dropped.
Command Default The default timeout is 1 second.
Command Modes Global configuration
Command History Release Modification
12.3(21a)BC3 This command was introduced.
Examples The following example shows configuring the NLS response timeout:
Router(config)#nls rssp-timeout 35
Related Commands Command Description
cpd Enables CPD.
nls Enables Network Layer signalling (NLS) functionality.
nls ag-id auth-key Configures an Authorization Group Identifier (AG ID) for CMTS.
Cisco IOS CMTS Cable Command Reference
CBL-1006 OL-15510-15
Cable Commands: i through p
oui
oui
To configure the Organizational Unique Identifier (OUI) of the CM for the CMTS tag, use the oui
command in the cmts-tag configuration mode. To remove the configured OUI from the CMTS tag, use
the no form of this command.
[exclude] oui oui-of-CM
no oui oui-of-CM
Syntax Description exclude (Optional) Configures the tag to exclude the specified OUI.
oui-of-CM MAC address prefix of the vendor.
Command Default No default behavior or values.
Command Modes CMTS tag mode (cmts-tag)
Command History Release Modification
12.2(33)SCC This command was introduced.
Examples The following example shows how to configure the OUI for the CMTS tag using the oui command:
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# cable tag 1
Router(cmts-tag)# oui 00.1a.c3
Related Commands Command Description
cable load-balance To configure a DOCSIS load balancing group on the CMTS.
docsis-group
show cable To display real-time configuration, statistical and operational information
load-balance for load balancing operations on the router.
docsis-group
cable tag To configure a tag for a DOCSIS load balancing group on the CMTS.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1007
Cable Commands: i through p
output-rate
output-rate
To specify a custom-defined output line rate to a WAN interface instead of the default output line rate,
use the output-rate command in interface configuration mode. Use the no form of this command to use
the default output line rate.
output-rate rate
no output-rate
Syntax Description rate Output rate to the WAN interface, in kilobits per second. Valid values range
from 1 to 1,000,000.
Command Default Gigabit Ethernet output line rate is 1,000,000 kpbs.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines This command specifies a custom-defined output line rate for the WAN interface.
Examples The following example shows how to specify a custom-defined output line rate for the WAN interface:
Router# configure terminal
Router(config)# interface gigabitethernet 1/0/0
Router(config-if)# output-rate 100
Related Commands Command Description
show running-config Displays the configuration settings for the specified Gigabit Ethernet
interface interface.
gigabitethernet
show interfaces Displays the status and configuration settings for Gigabit Ethernet
gigabitethernet interfaces.
Cisco IOS CMTS Cable Command Reference
CBL-1008 OL-15510-15
Cable Commands: i through p
override
override
To override the Type/Length/Value (TLV) or SNMP when assigning a restricted load balancing group
(RLBG) to CM, use the override command in the cmts-tag configuration mode. To reenable the TLV or
SNMP when assigning a RLBG to CM, use the no form of this command.
override
no override
Command Default TLV or SNMP are effective when assigning a RLBG to CM.
Command Modes CMTS tag mode (cmts-tag)
Command History Release Modification
12.2(33)SCC This command was introduced.
Examples The following example shows how to override the TLV or SNMP when assigning a RLBG using the
override command:
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# cable tag 1
Router(cmts-tag)# override
Related Commands Command Description
cable load-balance Configures a DOCSIS load balancing group on the CMTS.
docsis-group
show cable Displays real-time configuration, statistical, and operational information
load-balance for load balancing operations on the router.
docsis-group
cable tag Configures a tag for a DOCSIS load balancing group on the CMTS.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1009
Cable Commands: i through p
option
option
To create a DOCSIS configuration file that specifies vendor-specific information fields, or other options
that are not available through the other cable config-file commands, use the option command in cable
config-file configuration mode. To remove the entry for this option, use the no form of this command.
option n [instance inst-num] {ascii string | hex hexstring | ip ip-address}
no option n
Syntax Description n Specifies the configuration file option code. Valid range is 5 to 254.
Note Certain values between 5 and 254 are not allowed. See Table 0-30
for more information.
instance inst-num (Optional) Specifies the instance of this option, so that you can give the same
option multiple times. Valid range is 0 to 255.
ascii string Specifies that the data is a network verification tool (NVT) ASCII string. If
the string contains white space, you must surround it with quotation marks.
hex hexstring Specifies the data as a raw hexadecimal string. Each byte in the hexadecimal
string is two hexadecimal digits—each byte can be separated by a period,
colon, or white space. A maximum of 254 bytes can be specified.
Note The hex option must be used to specify the data in the DOCSIS
Type/Length/Value (TLV) format when using the vendor-specific
option (option 43).
ip ip-address Specifies an IP address.
Command Default No default behaviors or values
Command Modes Cable config-file configuration
Command History Release Modification
12.1(2)EC1 This command was introduced.
12.2(4)BC1 Support was added to the Release 12.2 BC train.
Usage Guidelines The DOCSIS specification provides for a great many options and parameters in the DOCSIS
configuration files. In particular, it allows unspecified vendor-specific options that can vary from vendor
to vendor and from model to model. To create a DOCSIS configuration file that references these options,
use the option command.
The option command allows you to specify configuration file parameters that are not defined by the
other cable config-file options. These options are defined in the DOCSIS Radio Frequency (RF)
Interface Specification. However, certain options are not allowed because they are either reserved for
DOCSIS use or because they are specified using other cable config-file commands.
Cisco IOS CMTS Cable Command Reference
CBL-1010 OL-15510-15
Cable Commands: i through p
option
Table 0-30 lists the options that cannot be specified by the cable config-file option command. Where
applicable, the table shows the cable config-file command you can use to specify that option.
Table 0-30 Invalid Option Codes for the cable config-file option Command
Option Description Cable Config-File Command
5, 6, 7, 20 Internal Configuration File Options N/A
9 Software Upgrade Filename download
12 Modem IP Address N/A
13 Service Not Available Response N/A
17 Baseline Privacy Interface Configuration privacy
18 Maximum Number of CPE devices cpe max
19 TFTP Server Timestamp timestamp
21 Software Upgrade TFTP Server download
Note For complete information on the other parameters and fields in DOCSIS configuration files, see
Appendix C in the DOCSIS 1.1 Radio Frequency (RF) Interface Specification, available on the DOCSIS
Cable Labs official web site at http://www.cablemodem.com/
Using Option 43 (Vendor-Specific Information Fields)
The most common use of the cable config-file option command is to specify vendor-specific
information field values, which vendors use to implement features that are unique to their products. In
this case, the value for n must be 43.When you use the vendor-specific option (option 43), you must
specify the data using the hex option.
The hexadecimal data must be presented in the DOCSIS Type/Length/Value (TLV) format, where the
first byte specifies the suboption type, the second byte specifies the length of the data, and the remaining
bytes specify the data itself. The exact meaning of the suboption type and data values is defined by each
vendor.
For example, Cisco CMs support a vendor-specific suboption (128) that instructs the CM to download
and execute a Cisco IOS configuration file. The data for this suboption is the fully qualified path name
of the Cisco IOS configuration file on the TFTP server. Other vendors, however, could define
vendor-specific suboption 128 to have a totally different function.
To ensure that a vendor-specific option is executed only by equipment that supports that option, the
vendor ID must always be the first part of the data in an option 43 command. The suboption number for
the vendor ID function is 08, and the data is the three byte Organization Unique Identifier (OUI) for that
vendor, as issued by the Institute of Electrical and Electronics Engineers (IEEE).
The vendor could have defined a global OUI for all of their equipment, or they could have requested a
separate OUI ID for different products or family of products. For example, the global OUI for Cisco
equipment is 00 00 0C.
Note Each option 43 command must specify one and only one vendor ID, and the vendor ID must be the first
TLV in the hex data string.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1011
Cable Commands: i through p
option
Example of Constructing an Option 43 Command
For example, to create a vendor-specific option that downloads a Cisco IOS configuration file, you
would create a hexadecimal data string that first contains suboption 8, to specify the vendor ID in TLV
format. You would then add the hexadecimal string that contains suboption 128, to specify the filename
for the configuration file to be downloaded, in TLV format.
The TLV for the Cisco vendor ID would be 08:03:00:00:0C, where 08 is the suboption type, 03 is the
length, and 00:00:0C is the Cisco OUI vendor ID. If the Cisco IOS filename is ios.cfg, the second TLV
would be 80:07:69:6F:73:2E:63:66:67, where 80 is the suboption type (128 decimal), 07 is the length
of the data, and the data is the filename expressed in hexadecimal ASCII values.
The complete hex data string would be 08:03:00:00:0C:80:07:69:6F:73:2E:63:66:67. The complete
command would be option 43 hex 08:03:00:00:0C:80:07:69:6F:73:2E:63:66:67.
Note When using the option 43 command, you must manually calculate the length value for each TLV that
you specify in the hex data string. However, you do not have to calculate the length for entire option 43
command, because that is calculated automatically by the CMTS.
Caution Be certain that you have correctly entered the TLV data when using the hex option. Incorrectly entered
data could cause CMs to reset, go offline, or hang, requiring a power cycle before being able to continue.
The following example shows how to specify a static downstream frequency for a Cisco uBR905,
Cisco uBR924, Cisco uBR925, or Cisco CVA, using the option 43 command to specify Cisco
vendor-specific option 1.
router(config)# cable config-file statfreq.cm
router(config-file)# option 43 hex 08:03:00:00:0C:01:04:05:7F:9F:90
router(config-file)# exit
router(config)#
The hexadecimal data shown in this command consists of the two TLVs shown in Table 0-31:
Table 0-31 TLV Values for Sample Option 43 Command
Type Length Value
TLV 1—Vendor ID, Suboption 8
08 03 00:00:0C (the ID for Cisco cable equipment)
TLV2—Static Downstream Frequency, Suboption 1
1 04 05:7F:9F:90 (sets the downstream for the static frequency of
92,250,000 Hz)
Note Both the Cisco vendor-specific option for a static downstream frequency and the frequency command
instruct the CM to move to a specific downstream frequency, overriding the frequency the CM found
during its initial downstream scanning. However, the vendor-specific option requires the CM to use the
specified frequency—if the CM loses its lock on that frequency or can never lock on to that specific
frequency, the CM cannot go online. In contrast, the frequency command allows the CM to scan the
downstream for the next available frequency if the CM loses its lock on the originally specified
frequency.
Cisco IOS CMTS Cable Command Reference
CBL-1012 OL-15510-15
Cable Commands: i through p
option
The following example shows how to configure a Cisco uBR924, Cisco uBR925, or Cisco CVA122 so
that it downloads a Cisco IOS configuration file named ios.cfg and configures the router for two voice
ports. Three vendor-specific options are included: suboption 8, which specifies the vendor ID, suboption
128, which specifies the configuration file name, and suboption 10, which specifies the number of active
voice ports.
router(config)# cable config-file iosfile.cm
router(config-file)# option 43 hex 08:03:00:00:0C:80:07:69:6F:73:2E:63:66:67:0A:01:02
router(config-file)# exit
router(config)#
The hexadecimal data shown in this command consists of the three TLVs shown in Table 0-32:
Table 0-32 TLV Values for Sample Option 43 Command
Type Length Value
TLV 1—Vendor ID, Suboption 8
08 03 00:00:0C (the ID for Cisco cable equipment)
TLV2—Cisco IOS Configuration File, Suboption 128
80 07 69:6F:73:2E:63:66:67 (ASCII hexadecimal bytes for ios.cfg)
TLV3—Number of Active Voice Ports, Suboption 10
0A 1 02 (two voice ports)
Cisco CMs also support giving a limited number of Cisco IOS configuration mode commands in the
DOCSIS configuration file, using vendor-specific suboption 131. The following example shows how to
use the option 43 command to specify that the Cisco CM should execute the ip http cable-monitor
advance command to enable its onboard Cable Monitor web server.
router(config-file)# option 43 hex 08:03:00:00:0C:83:1D:69:70:20:68:74:74:70:20:63:61:62:
6C:65:2D:6D:6F:6E:69:74:6F:72:20:61:64:76:61:6E:63:65
router(config-file)#
Table 0-33 lists the two TLVs shown in this example:
Table 0-33 TLV Values to Enable the Cisco Cable Monitor
Type Length Value
TLV 1—Vendor ID, Suboption 8
08 03 00:00:0C (the ID for Cisco cable equipment)
TLV2—Cisco IOS Command, Suboption 131
83 1D 69:70:20:68:74:74:70:20:63:61:62:6C:65:2D:6D:6F:6E:69:74:6F:
72:20:61:64:76:61:6E:63:65 (ASCII hexadecimal bytes for ip http
cable-monitor advance)
The following example shows the instance keyword being used to give multiple option 43 commands.
This example uses the same commands shown in the previous three examples.
router(config-file)# option 43 instance 1 hex 08:03:00:00:0C:01:04:05:7F:9F:90
router(config-file)# option 43 instance 2 hex 08:03:00:00:0C:80:07:69:6F:73:2E:63:66:67:
0A:01:02
router(config-file)# option 43 instance 3 hex
08:03:00:00:0C:83:1D:69:70:20:68:74:74:70:20:63:61:62:6C:65:2D:6D:6F:6E:69:74:6F:72:20:61:
64:76:61:6E:63:65
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1013
Cable Commands: i through p
option
router(config-file)#
The following example shows an attempt to specify two options that cannot be specified through the
DOCSIS configuration file. Option 12 is reserved for the DOCSIS registration process, and Option 9
must be specified using the download command.
router(config-file)# option 12 ip 10.11.12.13
%Option 12 must not be specified manually
router(config-file)# option 9 ascii newsoftware.file
%Option 9 must be specified directly (not as raw option)
router(config-file)#
Related Commands Command Description
cable config-file Creates a DOCSIS configuration file and enters configuration file
mode.
access-denied Disables access to the network.
channel-id Specifies upstream channel ID.
cpe max Specifies CPE information.
download Specifies download information for the configuration file.
frequency Specifies downstream frequency.
privacy Specifies privacy options for baseline privacy images.
service-class Specifies service class definitions for the configuration file.
snmp manager Specifies Simple Network Management Protocol (SNMP) options.
timestamp Enables time-stamp generation.
Cisco IOS CMTS Cable Command Reference
CBL-1014 OL-15510-15
Cable Commands: i through p
packetcable
packetcable
To enable PacketCable operations on the Cisco CMTS, use the packetcable command in global
configuration mode. To disable PacketCable operations, use the no form of this command.
packetcable
no packetcable
Syntax Description This command has no keywords or arguments.
Command Default PacketCable operation is disabled.
Command Modes Global Configuration
Command History Release Modification
12.2(8)BC2 This command was introduced for the Cisco uBR7200 series universal
broadband router.
12.2(11)BC1 Support was added for automatically creating a random Element ID when
PacketCable operations are enabled.
12.2(15)BC1 Support was added for the Cisco uBR10012 router.
Usage Guidelines This command enables PacketCable operations on all cable interfaces and takes effect immediately. If
you do not need to change any parameters from their default values, this is the only command needed to
enable PacketCable operations.
In Cisco IOS Release 12.2(11)BC1 and later releases, this command also automatically creates a random
Element ID for the CMTS that is in the range of 0 and 99,999. To ensure that this Element ID is unique
across the entire PacketCable domain, you should use the packetcable element-id command.
Note PacketCable operations can be configured together with HCCP N+1 redundancy, but the PacketCable
states are not synchronized between the Working and Protect interfaces. If a switchover occurs, existing
voice calls continue, but when the user hangs up, PacketCable event messages are not generated because
the Protect interface is not aware of the previous call states. However, new voice calls can be made and
proceed in the normal fashion.
Channel Width Limitations
The 200,000 Hz channel width cannot be used on upstreams that support PacketCable voice calls, or on
any upstreams that use Unsolicited Grant Service (UGS) or UGS with Activity Detection (UGS-AD)
service flows. Using this small a channel width with voice and other UGS/UGS-AD service flows results
in calls being rejected because of “DSA MULTIPLE ERRORS”.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1015
Cable Commands: i through p
packetcable
Examples The following example shows PacketCable operation being enabled:
Router# configure terminal
Router(config)# packetcable
Router(config)#
The following example shows PacketCable operation being disabled (default):
Router# configure terminal
Router(config)# no packetcable
Router(config)#
Related Commands Command Description
clear packetcable gate Resets the counters that track the total number of committed gates.
counter commit
packetcable authorize Allows Unsolicited Grant Service (UGS) service flows without a proper
vanilla-docsis-mta PacketCable gate ID when PacketCable operations are enabled on the
Cisco CMTS.
packetcable Configures the PacketCable Event Message Element ID.
element-id
packetcable gate Changes the maximum number of PacketCable gate IDs in the gate database
maxcount on the Cisco CMTS.
packetcable timer Changes the value of the different PacketCable DQoS timers.
show packetcable gate Displays information about one or more gates in the gate database.
show packetcable gate Displays the total number of committed gates since system reset or since the
counter commit counter was last cleared.
show packetcable Displays the current PacketCable configuration.
global
Cisco IOS CMTS Cable Command Reference
CBL-1016 OL-15510-15
Cable Commands: i through p
packetcable authorize vanilla-docsis-mta
packetcable authorize vanilla-docsis-mta
To allow Unsolicited Grant Service (UGS) service flows without a proper PacketCable gate ID when
PacketCable operations are enabled on the Cisco CMTS, use the packetcable authorize
vanilla-docsis-mta command in global configuration mode. To prevent CMs from requesting
non-PacketCable UGS service flows when PacketCable operations are enabled, use the no form of this
command.
packetcable authorize vanilla-docsis-mta
no packetcable authorize vanilla-docsis-mta
Syntax Description This command has no keywords or arguments.
Command Default Non-PacketCable UGS service flows are not allowed when PacketCable operations are enabled.
Command Modes Global Configuration
Command History Release Modification
12.2(11)BC2 This command was introduced for the Cisco uBR7200 series universal
broadband router.
12.2(15)BC1 Support was added for the Cisco uBR10012 router.
Usage Guidelines By default, when PacketCable operations are enabled (using the packetcable ccommand), CMs must
follow the PacketCable protocol when requesting UGS service flows. This prevents DOCSIS CMs that
do not support PacketCable operations from using DOCSIS-style UGS service flows.
If you have a mixed network that contains both PacketCable and non-PacketCable DOCSIS CMs, you
can allow DOCSIS CMs to request UGS service flows by using the packetcable authorize
vanilla-docsis-mta command. If, however, your CMTS is providing PacketCable services, use the no
packetcable authorize vanilla-docsis-mta command to disable DOCSIS-style service flows. This is the
default configuration when PacketCable operations are enabled, and it requires that CMs must provide
a validly authorized gate ID before being granted a UGS service flow.
Examples The following example shows PacketCable operation being enabled, while still allowing DOCSIS-style
UGS service flows:
Router# configure terminal
Router(config)# packetcable
Router(config)# packetcable authorize vanilla-docsis-mta
Router(config)#
The show packetcable global command has also been enhanced to display whether non-PacketCable
DOCSIS-style UGS service flows are allowed:
Router# show packetcable global
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1017
Cable Commands: i through p
packetcable authorize vanilla-docsis-mta
Packet Cable Global configuration:
Enabled : Yes
Element ID: 12456
Max Gates : 1048576
Allow non-PacketCable UGS
Default Timer value -
T0 : 30000 msec
T1 : 300000 msec
T2 : 2000 msec
T5 : 500 msec
Router#
Related Commands Command Description
clear packetcable gate Resets the counters that track the total number of committed gates.
counter commit
packetcable Enables PacketCable operations on the Cisco CMTS.
packetcable Configures the PacketCable Event Message Element ID.
element-id
packetcable gate Changes the maximum number of PacketCable gate IDs in the gate database
maxcount on the Cisco CMTS.
packetcable timer Changes the value of the different PacketCable DQoS timers.
show packetcable gate Displays information about one or more gates in the gate database.
show packetcable gate Displays the total number of committed gates since system reset or since the
counter commit counter was last cleared.
show packetcable Displays the current PacketCable configuration.
global
Cisco IOS CMTS Cable Command Reference
CBL-1018 OL-15510-15
Cable Commands: i through p
packetcable element-id
packetcable element-id
To configure the PacketCable Event Message Element ID on the Cisco CMTS, use the packetcable
element-id command in global configuration mode. To reset the counter to its default value, use the no
form of this command.
packetcable element-id n
no packetcable element-id
Syntax Description n PacketCable Event Message Element ID for the Cisco CMTS. The valid
range is 0 through 99999, with a default that is a random number in that
range.
Command Default A random value between 0 and 99,999.
Command Modes Global Configuration
Command History Release Modification
12.2(11)BC1 This command was introduced for the Cisco uBR7200 series universal
broadband router.
12.2(15)BC1 Support was added for the Cisco uBR10012 router.
Usage Guidelines The PacketCable Event Message specification (PKT-SP-EM-I03-011221) requires that each trusted
PacketCable network element that generates an Event Message MUST identify itself with a static
Element ID that is unique across an entire PacketCable domain. This command allows you to configure
the CMTS with an Element ID that is unique for your particular network. If you do not manually
configure this parameter with the packetcable element-id command, it defaults to a random value
between 0 and 99,999 when PacketCable operations is enabled.
The CMTS includes the Element ID in its Event Messages, along with its timezone information. You
can display the current value using the show packetcable global command.
Examples The following example shows the Event Message Element ID for this particular CMTS being set to
12456:
Router# configure terminal
Router(config)# packetcable element-id 12456
Pktcbl: Configured element ID 12456
Router(config)#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1019
Cable Commands: i through p
packetcable element-id
Related Commands Command Description
packetcable Enables PacketCable operations on the Cisco CMTS.
packetcable authorize Allows Unsolicited Grant Service (UGS) service flows without a proper
vanilla-docsis-mta PacketCable gate ID when PacketCable operations are enabled on the
Cisco CMTS.
packetcable gate Changes the maximum number of PacketCable gate IDs in the gate database
maxcount on the Cisco CMTS.
packetcable timer Changes the value of the different PacketCable DQoS timers.
show packetcable Displays the current PacketCable configuration, including the Element ID.
global
Cisco IOS CMTS Cable Command Reference
CBL-1020 OL-15510-15
Cable Commands: i through p
packetcable gate maxcount
packetcable gate maxcount
To change the maximum number of PacketCable gate IDs in the gate database on the Cisco CMTS, use
the packetcable gate maxcount command in global configuration mode. To reset the counter to its
default value, use the no form of this command.
packetcable gate maxcount n
no packetcable gate maxcount
Syntax Description n Maximum number of gate IDs to be allocated in the gate database on the
CMTS. The valid range is 512 through 2097152, with a default value of
2097152 (8 * 512 * 512), which is sufficient to support 8 cable interface line
cards.
Defaults 2097152 gate IDs
Command Modes Global Configuration
Command History Release Modification
12.2(8)BC2 This command was introduced for the Cisco uBR7200 series universal
broadband router.
12.2(11)BC2 The maximum number of possible gates and the default number of gates
were doubled from 1,048,576 to 2,097,152 to accommodate a maximum of
eight cable interface line cards (where each cable interface line card can use
a maximum of 512*512, or 262,144, gates).
12.2(15)BC1 Support was added for the Cisco uBR10012 router.
Usage Guidelines This command configures the number of gate IDs that the Cisco CMTS can store in its gate database.
Because each PacketCable gate ID typically refers to both an upstream gate and a downstream gate,
multiple this number by 2 to get the maximum number of gates that can be created on the CMTS.
Note Each cable interface line card supports a maximum of 512*512 (262,144) PacketCable gates, so ensure
that you set the maximum number of gates to accommodate all installed cable interface line cards.
Examples The following example shows the maximum number of gate IDs being set to 524288, which is sufficient
for two cable interface line cards:
Router# configure terminal
Router(config)# packetcable gate maxcount 524288
Router(config)#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1021
Cable Commands: i through p
packetcable gate maxcount
Related Commands Command Description
packetcable Enables PacketCable operations on the Cisco CMTS.
packetcable authorize Allows Unsolicited Grant Service (UGS) service flows without a proper
vanilla-docsis-mta PacketCable gate ID when PacketCable operations are enabled on the
Cisco CMTS.
packetcable Configures the PacketCable Event Message Element ID.
element-id
packetcable timer Changes the value of the different PacketCable DQoS timers.
show packetcable Displays the current PacketCable configuration.
global
Cisco IOS CMTS Cable Command Reference
CBL-1022 OL-15510-15
Cable Commands: i through p
packetcable gate send-subscriberID
packetcable gate send-subscriberID
To include subscriber identification in GATE-OPEN and GATE-CLOSE gate control messages, use the
packetcable gate send-subscriberID command in global configuration mode. To remove subscriber
identification information from the gate control messages, use the no form of this command.
packetcable gate send-subscriberID
no packetcable gate send-subscriberID
Syntax Description This command has no arguments or keywords.
Command Default No subscriber identification information is provided in the GATE-OPEN and GATE-CLOSE gate
control messages.
Command Modes Global configuration (config)
Command History Release Modification
12.3(23)BC1 This command was introduced.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.2(33)SCB. Support
for the Cisco uBR7225VXR router was added.
Examples The following example enables gate control subscriber identification information using the packetcable
gate send-subscriberID command:
Router(config)# packetcable gate send-subscriberID
Related Commands Command Description
packetcable Enables PacketCable operation.
show packetcable gate Displays information about one or more gates in the gate database.
show packetcable Displays the current PacketCable configuration.
global
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1023
Cable Commands: i through p
packetcable timer
packetcable timer
To change the value of the different PacketCable Dynamic Quality of Service (DQoS) timers, use the
packetcable timer command in global configuration mode. To reset a timer to its default value, use the
no form of this command.
packetcable timer {T0 timer-value | T1 timer-value | multimedia T1 timer-value}
no packetcable timer {T0 timer-value | T1 timer-value | multimedia T1 timer-value}
Syntax Description T0 timer-value Sets the T0 timer in milliseconds. The valid range is from 1 to
1,000,000,000 milliseconds, with a default value of 30000 milliseconds (30
seconds).
T1 timer-value Sets the T1 timer in milliseconds. The valid range is from1 to 1,000,000,000
milliseconds, with a default value of 200000 milliseconds (200 seconds).
multimedia T1 Sets the PacketCable multimedia T1 timer in milliseconds. The valid range
timer-value is 1 to 1,000,000,000 milliseconds, with a default value of 200000
milliseconds (200 seconds).
Command Default None
Command Modes Global Configuration (config)
Command History Release Modification
12.2(8)BC2 This command was introduced for the Cisco uBR7200 series universal
broadband router.
12.2(11)BC2 The T2 and T5 timers were removed to conform to the requirements of the
PacketCable DQoS Engineering Change Notice (ECN) 02148.
12.2(15)BC1 Support was added for the Cisco uBR10012 router.
Usage Guidelines This command sets the following timers, which are defined in the PacketCable™ Dynamic
Quality-of-Service Specification (PKT-SP-DQOS-I03-020116):
• T0 specifies the amount of time that a gate ID can remain allocated without any specified gate
parameters. The timer begins counting when a gate is allocated with a Gate-Alloc command. The
timer stops when a Gate-Set command marks the gate as Authorized. If the timer expires without a
Gate-Set command being received, the gate is deleted.
• T1 specifies the amount of time that an authorization for a gate can remain valid. It begins counting
when the CMTS creates a gate with a Gate-Set command and puts the gate in the Authorized state.
The timer stops when the gate is put into the committed state. If the timer expires without the gate
being committed, the CMTS must close the gate and release all associated resources.
Cisco IOS CMTS Cable Command Reference
CBL-1024 OL-15510-15
Cable Commands: i through p
packetcable timer
Note The new timer values apply to all gates that are created after giving the command. Existing gates are not
affected.
Examples The following example shows the T0 timer being set to 20 seconds (20,000 milliseconds):
Router# configure terminal
Router(config)# packetcable timer T0 20000
Router(config)#
Related Commands Command Description
packetcable Enables PacketCable operations on the Cisco CMTS.
packetcable authorize Allows Unsolicited Grant Service (UGS) service flows without a proper
vanilla-docsis-mta PacketCable gate ID when PacketCable operations are enabled on the
Cisco CMTS.
packetcable Configures the PacketCable Event Message Element ID.
element-id
packetcable gate Changes the maximum number of PacketCable gate IDs in the gate database
maxcount on the Cisco CMTS.
show packetcable Displays the current PacketCable configuration.show packetcable global
global
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1025
Cable Commands: i through p
peak-time1
peak-time1
To specify peak and offpeak monitoring times on a Cisco CMTS router, use the peak-time1 command
in enforce-rule configuration mode. To disable configuration of peak monitoring times, use the no form
of this command.
peak-time1 {hour| hour:minutes} duration minutes avg-rate rate [peak-time2 {hour |
hour:minutes} duration minutes avg-rate rate] [duration offpeak-minutes avg-rate
offpeak-rate] sample-interval minutes [penalty minutes] {downstream | upstream}[enforce]
no peak-time1 {hour| hour:minutes} duration minutes avg-rate rate [peak-time2 {hour|
hour:minutes} duration minutes avg-rate rate] [duration offpeak-minutes avg-rate
offpeak-rate] sample-interval minutes [penalty minutes] {downstream | upstream}[enforce]
Syntax Description hour | hour:minutes Specifies the time of day, in either hh or hh:mm format, during which
monitoring occurs for the peak time.
If the time is specified in hour (hh), the valid range is 1 to 23 using a 24-hour
clock.
If the time is specified in hour:minutes (hh:mm), the valid range for hour is
1 to 23 using a 24-hour clock, and the valid range for minutes is 0 to 59.
duration minutes Specifies the size of the sliding window (in minutes) during which the
subscriber usage is monitored for the first peak time, and optionally for a
second peak time when used with the peak-time2 keyword. The valid range
is 60 to 1440.
avg-rate rate Specifies the average sampling rate in kilobits per second for the specified
duration. The valid range is 1 to 400000 kilobits with no default.
duration (Optional) Specifies the size of the sliding window (in minutes) during
offpeak-minutes which the subscriber usage is monitored for the remaining offpeak time
(time not specified for peak monitoring). The valid range is 60 to 1440.
avg-rate offpeak-rate Specifies the average sampling rate in kilobits per second for the specified
offpeak duration. The valid range is 1 to 400000 kilobits with no default.
peak-time2 hour | (Optional) Specifies the time of day during which monitoring occurs for a
hour:minutes second peak time. The time can be specified either in hour or hour:minutes
format. The valid range for hour is 1 to 23 using a 24-hour clock, and the
valid range for minutes is 0 to 59.
sample-interval Specifies how often (in minutes) the CMTS router should sample a service
minutes flow to get an estimate of subscriber usage. The valid range is 1 to 30, with
a default value of 15.
penalty minutes (Optional) Specifies the period (in minutes) during which a cable modem
can be under penalty. The valid range is 1 to 10080.
downstream Specifies monitoring of traffic in the downstream direction.
upstream Specifies monitoring of traffic in the upstream direction.
enforce (Optional) Specifies that the enforce-rule QoS profile should be applied
automatically if a user violates their registered QoS profile.
Cisco IOS CMTS Cable Command Reference
CBL-1026 OL-15510-15
Cable Commands: i through p
peak-time1
Command Default Peak and offpeak monitoring is disabled. The only default value for the peak-time1 command is the
15-minute sample interval.
Command Modes Enforce-rule configuration (enforce-rule)
Command History Release Modification
12.3(9a)BC This command was introduced.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
12.2(33)SCD2 The minute-level granularity (hh:mm) for peak-time1and peak-time2
duration, and the penalty keyword option were added.
Usage Guidelines
Note This command is applicable only after the monitoring-basics command is configured with the keyword
peak-offpeak.
You can monitor two peak monitoring periods using the initial peak-time1 command and its options,
followed by the peak-time2 keyword and the corresponding options. The remaining hours are
considered offpeak and can be monitored by configuring the optional duration keyword and the
corresponding options.
The penalty duration, which is configured using the peak-time1 command, is unique to weekdays, and
takes precedence over the global penalty duration configured using the penalty-period command.
When you use the show running-configuration command to display the configuration, the keyword
options for the peak-time1 command are truncated. In the following example, “d” represents duration
(a single peak and offpeak duration are configured), “avg” represents avg-rate, “sa” represents
sample-interval, “pen” represents penalty, “do” represents downstream, and “enf” represents enforce:
Router# show running-configuration
.
.
.
peak-time1 1 d 60 avg 2 d 60 avg 40 sa 10 pen 11 do enf
Examples The following example shows an enforce-rule that defines two peak monitoring periods for upstream
traffic:
Router(enforce-rule)# peak-time1 10:30 duration 120 avg-rate 10 peak-time2 23 duration 60
avg-rate 10 sample-interval 10 penalty 11 upstream enforce
Related Commands
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1027
Cable Commands: i through p
peak-time1
Command Description
cable qos enforce-rule Creates an enforce-rule to enforce a particular QoS profile for subscriber
traffic management and enters enforce-rule configuration mode.
debug cable Displays enforce-rule debug messages for subscriber traffic management on
subscriber-monitoring the Cisco CMTS routers.
duration Specifies the time period and sample rate to be used for monitoring
subscribers.
monitoring-basics Specifies the type of monitoring for subscriber traffic management on a
Cisco CMTS router.
penalty-period Specifies the period during which an enforced quality of service (QoS)
profile should be in force for subscribers who violate their registered QoS
profile.
qos-profile enforced Specifies a QoS profile that should be enforced when users violate their
registered QoS profiles. This command is applicable for DOCSIS 1.0 cable
modems
qos-profile registered Specifies the registered QoS profile that should be used for this enforce-rule.
This command is applicable for DOCSIS 1.0 cable modems
service-class Identifies a particular service class for cable modem monitoring in an
(enforce-rule) enforce-rule. This command is applicable for DOCSIS 1.1 or later cable
modems.
show cable qos Displays the QoS enforce-rules that are currently defined.
enforce-rule
show cable Displays subscribers who are violating their registered QoS profiles.
subscriber-usage
weekend peak-time1 Configures peak and offpeak subscriber monitoring over weekends on a
Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
CBL-1028 OL-15510-15
Cable Commands: i through p
penalty-period
penalty-period
To specify the time period that an enforced quality of service (QoS) profile should be in force for
subscribers that violate their registered QoS profile, use the penalty-period command in enforce-rule
configuration mode. To reset an enforce-rule to its default penalty period, use the no form of this
command.
penalty-period minutes [time-of-day {hour | hour:minutes}] [monitoring-on]
no penalty-period
Syntax Description minutes Specifies a time period (in minutes) during which a cable modem (CM)
can be under penalty. The range is 1 to 10080, with a default value of
10080 (7 days).
time-of-day {hour | (Optional) Specifies the time of day (in hh or hh:mm format) when:
hour:minutes}
• A CM that is under penalty is released from the penalty period.
• A CM that is not under penalty has its subscriber monitoring
counters reset.
If the time of day is specified in hour (hh), the valid range is 1 to 23
using a 24-hour clock.
If the time of day is specified in hour:minutes (hh:mm), the valid range
for hour is 1 to 23 using a 24-hour clock, and the valid range for
minutes is 0 to 59.
monitoring-on (Optional) Specifies that monitoring should be turned on after the
penalty release time. If this keyword is not specified, by default,
monitoring is turned off after the release time, until the end of the day,
that is 00:00 hrs.
Command Default The default time period is 10080 minutes (7 days).
Command Modes Enforce-rule configuration (enforce-rule)
Command History Release Modification
12.2(15)BC1 This command was introduced.
12.3(9a)BC This command was integrated into Cisco IOS Release 12.3(9a)BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
12.3(23)BC2 The time-of-day keyword option was added.
12.3(23)SCD2 The minute-level granuality for the time-of-day duration, and the
monitoring-on keyword option were added.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1029
Cable Commands: i through p
penalty-period
Usage Guidelines When a subscriber overconsumes the maximum bandwidth that is specified in the enforce-rule, the Cisco
CMTS router can automatically switch the subscriber to an enforced QoS profile for the time duration
configured with the penalty-period command. When the penalty period expires, the Cisco CMTS router
restores the subscriber to their registered QoS profile.
The penalty duration specified in the penalty-period command is a global configuration. This penalty
duration is overridden if the individual penalty duration is already configured using the duration,
weekend duration, peaktime1 or weekend peaktime1 commands. Similarly, if the individual penalty
duration is not configured, the global penalty duration is used. Table 34 explains in detail the criteria for
choosing the penalty duration:
Table 34 Criteria for Choosing Penalty Duration
Weekend
Penalty-Period
Weekday Configuration
Penalty-Period (CLI: weekend
Global Penalty- Configuration duration, or Applied Penalty
Period (CLI: duration or weekend Duration for Applied Penalty
Configured peaktime1) peaktime1) Weekdays Duration for Weekends
Yes Yes Yes Weekday Penalty Weekend Penalty
Configuration Configuration
Yes Yes No Weekday Penalty Global Penalty
Configuration Configuration
Yes No Yes Global Penalty Weekend Penalty
Configuration Configuration
Yes No No Global Penalty Global Penalty
Configuration Configuration
If the keyword monitoring-on is specified, monitoring starts immediately after the cable modems are
released from penalty. However if this keyword is not specified, by default, all the cable modems using
the enforce-rule are not monitored until the end of day, that is, 00:00 hrs.
The penalty period continues across reboots of the cable modem, so a user cannot avoid the enforced
QoS profile by trying to reset their modem and reregister on the cable network. This allows service
providers to set an appropriate penalty for users who consistently exceed the allocated maximum
bandwidth.
Note To manually move a DOCSIS 1.0 cable modem back to its registered profile before the end of the penalty
period, use the cable modem qos profile command. To manually move a DOCSIS 1.1(or later) cable
modem back to its registered profile before the end of the penalty period, use the cable modem
{ip-address | mac-address} service-class-name command.
When you change the configuration of a currently active enforce-rule, that rule begins using the new
configuration immediately to manage the cable modems tracked by this enforce-rule.
Note Before making any changes to an active enforce-rule, we recommend that you first disable the enforce
rule using the no enabled command.
Cisco IOS CMTS Cable Command Reference
CBL-1030 OL-15510-15
Cable Commands: i through p
penalty-period
A cable modem consists of two service flows, Primary upstream and Primary downstream. If a DOCSIS
1.0 cable modem enters the penalty period because one of its service flows has exceeded its allowed
bandwidth, the QoS profile of the entire modem is changed. However, if a DOCSIS 1.1 or later cable
modem enters the penalty period because its upstream or downstream service flow has exceeded the
allowed bandwidth threshold, the service class name is changed only for the upstream or downstream
service flow.
Examples The following example shows an enforce-rule named “test”, which is configured with a penalty period
of 1440 minutes (1 day):
Router# configure terminal
Router(config)# cable qos enforce-rule test
Router(enforce-rule)# penalty-period 1440
The following example shows an enforce-rule named “test”, which is configured with a penalty period
of 1440 minutes (1 day), but allowing the removal of the cable modems in penalty at 23:00. Monitoring
will be turned off by default at 23:00, to 00:00 (1 hour):
Router# configure terminal
Router(config)# cable qos enforce-rule test
Router(enforce-rule)# penalty-period 1440 time-of-day 23
The following example shows an enforce-rule named “test”, which is configured with a penalty period
of 1440 minutes (1 day), allowing the removal of the cable modems in penalty at 23:00. However, after
the cable modems are released from penalty, fresh monitoring starts, with all the subscriber monitoring
counters reset to 0:
Router# configure terminal
Router(config)# cable qos enforce-rule test
Router(enforce-rule)# penalty-period 1440 time-of-day 23 monitoring-on
Related Commands Command Description
cable qos enforce-rule Creates an enforce-rule to enforce a particular QoS profile for subscriber
traffic monitoring, and enters the enforce-rule configuration mode.
duration Specifies the time period and sample rate to be used for monitoring
subscribers.
enabled (enforce-rule) Activates an enforce-rule and begins subscriber traffic management on a
Cisco CMTS router.
qos-profile enforced Specifies a QoS profile that should be enforced when users violate their
registered QoS profiles. This command is applicable for only DOCSIS 1.0
cable modems.
qos-profile registered Specifies the registered QoS profile that should be used for this enforce-rule.
This command is applicable for only DOCSIS 1.0 cable modems.
service-class Specifies a service class (enforced or registered) that should be used for the
(enforce-rule) cable modem monitoring in an enforce-rule. This command is applicable for
DOCSIS 1.1 or later cable modems.
show cable qos Displays the QoS enforce-rules that are defined.
enforce-rule
show cable Displays subscribers who are violating their registered QoS profiles.
subscriber-usage
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1031
Cable Commands: i through p
ping docsis
ping docsis
To determine whether a specific cable modem (CM) is reachable from the CMTS at the DOCSIS MAC
layer, use the ping docsis command in privileged EXEC mode.
ping docsis {mac-addr | ip-addr | name fqdn} [count] [repeat queue-intervals] [verbose]
Syntax Description mac-addr The 48-bit hardware (MAC) address of the CM. If you specify the MAC address
of a CPE device, the command will resolve it to the MAC address of the CM
servicing that CPE device and send the DOCSIS ping to the CM.
ip-addr IPv4 or IPv6 address of the CM. If you specify the IP address of a CPE device,
the command will resolve it to the IP address of the CM servicing that CPE
device and send the DOCSIS ping to the CM.
name fqdn Specifies the fully qualified domain name (FQDN) of the cable device to be
displayed. This option is only available if the show cable modem domain-name
command has been run for the first time to update the cable DNS cache on the
CMTS router.
repeat (Optional) Specifies the number of maintenance intervals for a queue. Valid
queue-intervals values are from 1 to 2147483647.
verbose (Optional) Specifies verbose mode for the output, giving additional details about
the packets transmitted and received.
Command Default If no count is specified, five DOCSIS ping packets are sent.
Command Modes Privileged EXEC (#)
Command History Release Modification
11.3 NA This command was introduced for the Cisco uBR7200 series 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.1(1a)T1 The command output was enhanced.
12.1(3)XQ1 Support was added for wireless radio modems.
12.1(5)EC Support was added for the Cisco uBR7100 series routers.
12.2(2)XA Support was added for the Cisco uBR925 cable access router.
12.2(1)XF1 Support was added for the Cisco uBR10012 router.
12.2(4)BC1 This command was integrated into Cisco IOS Release 12.2(4)BC1.
Cisco IOS CMTS Cable Command Reference
CBL-1032 OL-15510-15
Cable Commands: i through p
ping docsis
Release Modification
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA, with the
following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was added.
• The name keyword option was added for specifying the fully-qualified
domain name of a CM.
12.2(33)SCC The repeat keyword was added to specify maintenance intervals for queues.
Usage Guidelines The DOCSIS ping is a unique Cisco patented technology that allows a cable operator to quickly diagnose
the health of a channel between the CMTS router and any particular DOCSIS cable CPE device. The
DOCSIS ping is similar in concept to the IP ping but uses the lower MAC layer instead of the datalink
or transport layers. Using the MAC layer has two major advantages:
• A DOCSIS ping uses only 1/64 of the bandwidth of an IP ping.
• A DOCSIS ping can be used with CMs that have not yet acquired an IP address. This allows cable
operators to ping CMs that were not able to complete registration or that were improperly configured
at the IP layer.
In addition to providing connectivity information, the ping docsis command provides a real-time view
and plot of requested power adjustments, frequency, timing offset adjustments, and a measure of optimal
headend reception power.
If a CM responds to the ping docsis command, but does not respond to an IP ping, the problem could be
one of the following:
• The CM is still in the registration process and has not yet come completely online. In particular, the
CM could be waiting for the DHCP server to assign it an IP address.
• Severe interference or other faults on the physical layer (either the upstream or downstream).
• Significant upstream signal error, distortion, or amplitude errors, often resulting in frequent power
adjustments (which are shown in the cable flap list).
• A non-DOCSIS compliant upstream carrier-to-noise power ratio (C/N) that is between 14 and
21 dB, along with a mixed modulation profile, such as ranging request/response messages being sent
in QPSK mode and short and long data grants in 16-QAM mode.
Note The ping docsis command is a DOCSIS-compliant process that can be used with any two-way
DOCSIS-compliant CM; the CM does not require any special features or code. The ping docsis
command cannot be used with telco-return CMs.
Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first
on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable
command.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1033
Cable Commands: i through p
ping docsis
Table 35 explains the different characters that can appear in the output for the ping docsis command:
Table 35 ping docsis Command Output Characters
Output Character Description
! Indicates that a successful response was received from the ping request. This
indicates that the CM is reachable from the CMTS and can respond to CMTS
requests at the DOCSIS MAC layer.
. Indicates that a DOCSIS ping request was sent out but that the ping request timed
out without receiving a response. This indicates that the CM is having difficulties
maintaining DOCSIS MAC layer connectivity to the CMTS.
Note If the ping docsis command displays a number of periods (.) along with
exclamation points (!), it strongly indicates the presence of RF noise or
physical cable and plant issues that is causing a loss of MAC layer
connectivity.
a Indicates that a response was received but that an adjustment of frequency, power,
or timing was also made in the response. This indicates that, although the upstream
channel is functional, some sort of problem is forcing power averaging and other
misreads of the upstream received power signals.
f Indicates that the CMTS failed to send the DOCSIS ping request because the CM is
offline, and therefore MAC-layer communication is not possible. This indicates that
the CM had previously registered with the CMTS, but that at some point it stopped
responding to the DOCSIS station maintenance messages and that the CMTS
eventually marked the CM as offline. The CM might have lost power or might have
been disconnected from the coaxial cable.
Tip Use the show cable modem command with the same MAC or IP address as
you used with the ping docsis command to show the current status of this
CM.
Note If a CM is already in the flap list, the ping docsis command increments the hit, miss, and
power-adjustment fields for it in the cable flap list.
Examples The following example shows a default ping docsis command that sends five packets to the CM with
the MAC address of 00d0.ba77.7595, with a response being received for each:
Router# ping docsis 00d0.ba77.7595
Queueing 5 MAC-layer station maintenance intervals, timeout is 25 msec:
!!!!!
Success rate is 100 percent (5/5)
Router#
Cisco IOS CMTS Cable Command Reference
CBL-1034 OL-15510-15
Cable Commands: i through p
ping docsis
The following example shows the verbose output for the same command:
Router# ping docsis 00d0.ba77.7595 verbose
Queueing 5 MAC-layer station maintenance intervals, timeout is 25 msec:
Reply from 00d0.ba77.7595: 2 ms, tadj=-1, padj=0.50, fadj=0
Reply from 00d0.ba77.7595: 2 ms, tadj=-1, padj=0.50, fadj=0
Reply from 00d0.ba77.7595: 2 ms, tadj=-1, padj=0.50, fadj=0
Reply from 00d0.ba77.7595: 98 ms, tadj=-1, padj=0.25, fadj=0
Reply from 00d0.ba77.7595: 2 ms, tadj=-1, padj=0.25, fadj=0
Success rate is 100 percent (5/5)
Router#
The following example shows that the CM at 192.168.100.10 is connected to the network and is
operational, but that one ping packet was lost and that several power adjustments were made during the
ping process:
router# ping docsis 192.168.100.10
Queueing 100 MAC-layer station maintenance intervals, timeout is 25 msec:
!!!!!a!!!!!!!a!a!!!!!!!!!!!!!!!!!!!!!aa!!!!!!!!!!a!!!a!a!!!aa!!!!!!.!!a!!!a!
a!a!!!!!!!!aa!!!!!!!aa!a
Success rate is 99 percent (99/100)
A CM that displays output such as that above (a higher percentage of successful pings but with a number
of power-adjustment readings) is most likely experiencing a problem that is not bad enough to force the
modem offline but that should be addressed.
If this problem is consistent for just a small number of CMs on an upstream receiver (such as a fiber
node within a combining group), then the problem is likely related to in-home wiring at those modem
locations. It could also be due to a cable TV network element that is on the same HFC segment.
If the problem occurs for all CMs on a single fiber node, then changing the upstream frequency or
reducing the number of homes passed per combining group might improve conditions. If this does not
help the situation, the problem could be due to a faulty cable drop, dirty optical connector on the node,
or other physical plant problem.
The ping docsis command cannot be used with a CM that has not yet registered with the CMTS. The
following example shows the responses for a CM that has not yet registered with the CMTS.
router# ping docsis 192.168.100.111
Cable modem with IP address 192.168.100.111 not registered.
Please try using MAC address instead.
router# ping docsis 0123.4567.89ab
Cable modem with MAC address 0123.4567.89ab not registered.
router#
The following example shows the output of the ping docsis command with the repeat keyword:
router# ping docsis 192.168.100.10 repeat 22
Queueing 22 MAC-layer station maintenance intervals, timeout is 25 msec:
!!!!!!!!!!!!!!!!!!!!!!
Success rate is 100 percent (22/22)
Related Commands
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1035
Cable Commands: i through p
ping docsis
Command Description
cable flap-list aging Specifies the number of days to keep a CM in the flap-list table before
aging it out of the table.
cable flap-list insertion-time Sets the insertion time interval that determines whether a CM is
placed in the flap list.
cable flap-list Specifies miss threshold for recording a flap-list event.
miss-threshold
cable flap-list power-adjust Specifies the power-adjust threshold for recording a CM flap-list
threshold event.
cable flap-list size Specifies the maximum number of CMs that can be listed in the
flap-list table.
clear cable flap-list Clears all the entries in the flap-list table.
ping Outputs one or more IP ping requests to a particular IP address.
show cable flap-list Displays the current contents of the flap list.
Cisco IOS CMTS Cable Command Reference
CBL-1036 OL-15510-15
Cable Commands: i through p
plim qos input map
plim qos input map
To configure a priority queue on Gigabit Ethernet SPAs, use the plim qos input map command in
interface or subinterface configuration mode. To remove a priority queue, use the no form of this
command.
plim qos input map {cos {enable | cos-value queue low-latency} | ip {dscp-based | dscp
dscp-value queue low-latency} | ip {precedence-based | precedence precedence-value queue
low-latency} | ipv6 tc tc-value queue low-latency | mpls exp exp-value queue low-latency
Syntax Description cos enable Enables classification of ingress VLAN traffic according to the 802.1Q
priority bits.
Note This command can only be applied to VLAN interfaces.
cos cos-value queue Classifies incoming VLAN traffic on a subinterface according to the
low-latency 802.1Q priority bits and places the traffic into the appropriate queue. By
default, traffic with 802.1Q priority bits set to 6 or 7 are placed in the
high-priority queue and all other traffic is placed in the low-priority queue.
cos-value specifies the IEEE 802.1Q/ISL CoS value from 0 to 7.
Note When you configure a class of service (CoS) value on a QinQ
subinterface, the CoS value applies to all QinQ subinterfaces with
the same outer VLAN ID.
low-latency specifies the high priority queue.
ip dscp-based Enables the classification of incoming IP traffic according to the value of
the DSCP bits.
Note This command only applies to physical interfaces.
ip dscp dscp-value Classifies incoming IP traffic according to the value of the DSCP bits and
queue low-latency places the traffic into the appropriate queue. By default, IP traffic with the
DSCP bits equal to EF will use the low-latency queue, and traffic with any
other DSCP value will use the low-priority queue.
dscp-value is the value of the DSCP bits. You can specify a range of values
separated by a dash or a list of value. For a list of valid values, see the Usage
Guidelines.
low-latency specifies the high priority queue.
ip precedence-based Enables the classification of incoming IP traffic according to the IP
precedence value.
Note This command applies only to physical interfaces.
ip precedence Classifies incoming IP traffic according to the value of the IP precedence
precedence-value bits and places the traffic into the appropriate queue. IP traffic with the IP
queue low-latency precedence bits set to 6 or 7 uses the low-latency queue; all other traffic
uses the low-priority queue.
precedence-value is the value of the IP precedence bits (0 to 7). You can
specify a range of values separated by a dash or a list of values.
low-latency specifies the high priority queue.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1037
Cable Commands: i through p
plim qos input map
ipv6 tc tc-value queue Classifies ingress IPv6 traffic based on the value of the traffic-class bits and
low-latency places the traffic into the appropriate queue. By default, IPv6 traffic with a
traffic-class value equal to ef uses the high-priority queue and all other
traffic uses the low-priority queue. Only the most significant six bits of the
traffic-class octet is used for the classification.
Note This command applies only to physical interfaces.
tc-value is the value of the traffic class bits. You can specify a range of
values separated by a dash or a list of values. For a list of valid values, see
the Usage Guidelines.
low-latency specifies the high priority queue.
mpls exp exp-value Classifies incoming MPLS traffic according to the value of the EXP bits and
queue low-latency places the traffic into the appropriate queue. By default, traffic with the
EXP bits set to 6 or 7 uses the high-priority queue and all other traffic uses
the low-priority queue.
Note This command applies only to physical interfaces.
exp-value is the value of the EXP bits (0 to 7). You can specify a range of
values separated by a dash or a list of values.
low-latency specifies the high priority queue.
Defaults Disabled
Command Modes Interface or subinterface configuration
Command History Cisco IOS Release Modification
12.2(33)SB This command was introduced on the Cisco 10000 series router for the
PRE3 and PRE4.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.2(33)SCB.
Usage Guidelines The plim qos input map command separates high-priority traffic from low-priority traffic and places
the traffic in the appropriate interface queue. The command separates priority and non-priority traffic at
the SPA interface processor (SIP) to prevent the dropping of high priority traffic in an oversubscription
case. Each shared port adaptor (SPA) supports one priority queue.
The router supports the following classification types for the prioritization of ingress traffic on the
Gigabit Ethernet SPAs:
• VLAN 802.1Q priority bits
• IP DSCP bits
• IP precedence bits
• IPv6 traffic class bits
• MPLS experimental (EXP) bits
Cisco IOS CMTS Cable Command Reference
CBL-1038 OL-15510-15
Cable Commands: i through p
plim qos input map
For the plim qos input map ip dscp dscp-value queue low-latency command, valid values for
dscp-value are one of the following:
• 0 to 63—Differentiated services codepoint value
• af11—001010
• af12—001100
• af13—001110
• af21—010010
• af22—010100
• af23—010110
• af31—011010
• af32—011100
• af33—011110
• af41—100010
• af42—100100
• af43—100110
• cs1—Precedence 1 (001000)
• cs2—Precedence 2 (010000)
• cs3—Precedence 3 (011000)
• cs4—Precedence 4 (100000)
• cs5—Precedence 5 (101000)
• cs6—Precedence 6 (110000)
• cs7—Precedence 7 (111000)
• default—000000
• ef—101110
For the plim qos input map ipv6 tc tc-value queue low-latency command, valid values for tc-value are
one of the following:
• 0 to 63—Differentiated services codepoint value
• af11—001010
• af12—001100
• af13—001110
• af21—010010
• af22—010100
• af23—010110
• af31—011010
• af32—011100
• af33—011110
• af41—100010
• af42—100100
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1039
Cable Commands: i through p
plim qos input map
• af43—100110
• cs1—Precedence 1 (001000)
• cs2—Precedence 2 (010000)
• cs3—Precedence 3 (011000)
• cs4—Precedence 4 (100000)
• cs5—Precedence 5 (101000)
• cs6—Precedence 6 (110000)
• cs7—Precedence 7 (111000)
• default—000000
• ef—101110
Examples The following example enables DSCP-based classification on the SPA that is located in subslot 0 of the
SIP in slot 1 of the Cisco 10000 series router:
Router(config)# interface gigabitethernet 3/0/1
Router(config-if)# plim qos input map ip dscp-based
Related Commands Command Description
card Preprovisions the SIP-600 and SPAs.
negotiation auto Enables autonegotiation on a Gigabit Ethernet SPA interfaces on the
Cisco 10000 SIP-600.
mtu Configures the maximum packet size for an interface. The default is 1500
bytes. The maximum configurable MTU is 9129 bytes.
Cisco IOS CMTS Cable Command Reference
CBL-1040 OL-15510-15
Cable Commands: i through p
policy
policy
To select modems based on the type of service flow that is balanced, use the policy command in the
config-lb-group configuration mode. To reset the selection, use the no form of this command.
policy {pcmm | ugs | us-across-ds | pure-ds-load}
no policy {pcmm | ugs | us-across-ds | pure-ds-load}
Syntax Description pcmm Enables balancing of modems with active PCMM service flows.
ugs Enables balancing of modems with active UGS service flows.
us-across-ds Sets load balancing on upstream (US) groups across downstream (DS) and
DS group methods are ignored.
pure-ds-load Considers DS load and not US load when calculating DS utilization.
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.
Examples The following example shows how to select the modems on the CMTS based on the type of service flow
that is balanced using the policy 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)# policy pure-ds-load
Router(config-lb-group)#
Related Commands Command Description
cable load-balance Configures a DOCSIS load balancing group on the CMTS.
docsis-group
show cable Displays real-time configuration, statistical, and operational information
load-balance for load balancing operations on the router.
docsis-group
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1041
Cable Commands: i through p
prefix
prefix
To configure an IPv4 or IPv6 prefix in a source address verification (SAV) group, use the prefix
command in SAV configuration mode. To disable the use of a configured prefix in a SAV group, use the
no form of this command.
prefix {ipv4_prefix/ipv4_prefix_length | ipv6_prefix/ipv6_prefix_length}
no prefix {ipv4_prefix/ipv4_prefix_length | ipv6_prefix/ipv6_prefix_length}
Syntax Description ipv4_prefix IPv4 prefix associated with a particular SAV group, specified in the
X.X.X.X/X format.
ipv4_prefix_length Length of the IPv4 prefix. The valid range is from 0 to 32.
ipv6_prefix IPv6 prefix associated with a particular SAV group, specified in the
X:X:X:X::/X format.
ipv6_prefix_length Length of the IPv6 prefix. The valid range is from 0 to 128.
Command Default None
Command Modes SAV Configuration (config-sav)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines The prefix command is used to configure IPv4 or IPv6 prefixes within a particular SAV groups. The
Cisco CMTS uses these prefixes to authenticate a cable modem (CM). A CM may be configured with an
IPv4 or IPv6 prefix belonging to a particular SAV group. The time, length, value (TLV) 43.7.2 specifies
the prefix associated with the CM. The Cisco CMTS considers a packet from a CM authorized if that
packet is sourced with an IP address that belongs to the configured prefix in a SAV group.
A maximum of four prefixes are supported on one SAV group. These prefixes can be either IPv4s, IPv6s,
or a combination of both prefixes (maximum up to four)
Examples The following example shows how to configure a SAV group with one IPv4 prefixes and one IPv6
prefixes:
Router(config)# cable source-verify group sav1
Router(config)# prefix 10.16.0.0/12
Router(config)# prefix 10::/12
Router(config)# exit
Cisco IOS CMTS Cable Command Reference
CBL-1042 OL-15510-15
Cable Commands: i through p
prefix
Command Description
cable source-verify enable-sav-static Enables SAV prefix processing.
cable source-verify group Configures SAV groups.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1043
Cable Commands: i through p
profile-description
profile-description
To provide a profile description for each profile in the selected cable multicast authorization profile, use
the profile-description command in multicast authorization profile configuration mode. To remove the
profile description, use the no form of this command.
profile-description profile-description
no profile-description profile-description
Syntax Description profile-description Specifies profile description for the selected profile. You can use up to 128
characters to describe the profile.
Command Default Profile description is empty.
Command Modes Multicast authorization configuration—(config-mauth)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines This command is available only from the cable multicast authorization profile mode.
Examples The following example shows how to enter a profile description for a multicast authorization profile
name:
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# cable multicast auth profile-name
Router(config)# cable multicast auth profile-name gold
Router(config-mauth)# profile-description gold-configured-may
Related Commands Command Description
cable multicast Enables the cable multicast authorization features.
authorization enable
default-action
cable multicast Defines the cable multicast authorization profile.
authorization
profile-name
Cisco IOS CMTS Cable Command Reference
CBL-1044 OL-15510-15
Cable Commands: i through p
profile-description
Command Description
show cable multicast Displays the list of defined multicast authorization profiles and all CMs
authorization associated with corresponding profiles.
show running-config Displays the running configuration for each of the cable interfaces.
interface cable
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1045
Cable Commands: i through p
protect-tunnel
protect-tunnel
To configure a Downstream External PHY Interface (DEPI) tunnel for the protect cable interface line
card on a Cisco CMTS router, use the protect-tunnel command in global configuration mode. To
disable this configuration, use the no form of this command.
protect-tunnel protect-depi-tunnel-name
no protect-tunnel protect-depi-tunnel-name
Syntax Description protect-tunnel-name DEPI tunnel name for the protect cable interface line card.
Command Default The N+1 DEPI redundancy feature is disabled.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCE This command was introduced.
Usage Guidelines The protect tunnel must be explicitly configured. The working tunnel and the protect tunnel are
configured using the same depi-tunnel command. The protect tunnel inherits L2TP class and DEPI class
parameters from the working tunnel. When you configure the protect tunnel and specify the destination
IP address for the protect tunnel, the protect tunnel inherits the QAM channel parameters specified for
the working tunnel.
Examples The following example shows how to configure a DEPI tunnel for the protect cable interface line card
on the Cisco uBR10012 router:
Router> enable
Router# configure terminal
Router(config)# depi-tunnel protect1
Router(config-depi-tunnel)# dest-ip 192.0.2.103
Router(config-depi-tunnel)# exit
Router(config)# depi-tunnel depi-tunnel working1
Router(config-depi-tunnel)# protect-tunnel protect1
Router(config-depi-tunnel)# end
Related Commands Command Description
depi-tunnel Specifies a template for DEPI tunnel configuration settings.
Cisco IOS CMTS Cable Command Reference
CBL-1046 OL-15510-15
Cable Commands: i through p
privacy
privacy
To create a DOCSIS configuration file that enables and configures the DOCSIS Baseline Privacy
Interface (BPI) option, use the privacy command in cable config-file configuration mode. To disable
BPI for the CM, use the no form of this command.
privacy grace-time {authorization value | tek value}
privacy timeout {authorize value| operational value| re-authorize value| reject value| rekey
value}
no privacy grace-time {authorization | tek}
no privacy timeout {authorize | operate | re-authorize | reject | rekey}
Syntax Description authorization value Authorization grace time in seconds. Valid values are 1 to 1800 seconds.
Default value is 600 seconds.
tek value TEK grace time in seconds. Valid range is 1 to 1800 seconds. Default is 600
seconds.
authorize value Authorize wait timeout in seconds. Valid range is 1 to 30 seconds. Default
value is 10 seconds.
operational value Operational Wait timeout in seconds. Valid range is 1 to 10 seconds. Default
is 1 second.
re-authorize value Re-authorize wait timeout in seconds. Valid range is 1 to 20 seconds.
reject value Authorize reject wait timeout in seconds. Valid range is 1 to 600 seconds.
Default is 60 seconds.
rekey value Rekey wait timeout in seconds. Valid range is 1 to 10 seconds. Default is 1
second.
Command Default No default behaviors or values
Command Modes Cable config-file configuration
Command History Release Modification
12.1(2)EC1 This command was introduced.
12.2(11)BC2 This command was supported on the Release 12.2 BC train.
Usage Guidelines Specifying the privacy command without any of the keywords and arguments enables BPI encryption
and decryption for the CM. In addition to this command, you must also specify the service-class privacy
command to enable BPI operations on the cable modem.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1047
Cable Commands: i through p
privacy
Note The privacy command appears and is supported only in images with support for BPI or BPI+ encryption.
This option configures the CM for BPI or BPI+ encryption. To use BPI encryption, the Cisco CMTS
must also be configured for BPI or BPI+ encryption, using the cable privacy command.
Examples The following example shows how to set the CM privacy TEK gracetime to 1200 seconds and enables
BPI operations for the cable modem.
router(config)# cable config-file bpi.cm
router(config-file)# privacy grace-time tek 1200
router(config-file)# service-class 1 privacy
router(config-file)# exit
router(config)#
Related Commands Command Description
access-denied Disables access to the network.
cable config-file Creates a DOCSIS configuration file and enters configuration file
mode.
cable privacy Enables BPI or BPI+ encryption on the Cisco CMTS.
channel-id Specifies upstream channel ID.
cpe max Specifies CPE information.
download Specifies download information for the configuration file.
frequency Specifies downstream frequency.
option Provides config-file options.
service-class Specifies service class definitions for the configuration file.
snmp manager Specifies Simple Network Management Protocol (SNMP) options.
timestamp Enables time-stamp generation.
Cisco IOS CMTS Cable Command Reference
CBL-1048 OL-15510-15
Cable Commands: q through sg
Revised: July 2012, OL-15510-15
New Commands
Command Cisco IOS Software Release
rf-channel network-delay 12.3(23)BC
session-range 12.2(33)SCA
rcp id 12.2(33)SCB
receive channel 12.2(33)SCB
receive module 12.2(33)SCB
revertive 12.2(33)SCA
service divert-rate-limit ip 12.2(33)SCB
service divert-rate-limit ip trusted-site 12.2(33)SCB
service divert-rate-limit non-ip 12.2(33)SCB
service divert-rate-limit trusted-site 12.2(33)SCB
restricted 12.2(33)SCC
rf-channel depi-tunnel 12.2(33)SCC
rf-channel rf-power 12.2(33)SCC
rf-channel rf-shutdown 12.2(33)SCC
service class(cmts-tag) 12.2(33)SCC
service-type-id 12.2(33)SCC
service-type-id(cmts-tag) 12.2(33)SCC
service instance 12.2(33)SCC
rf-channel stacking 12.2(33)SCD
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1049
Cable Commands: q through sg
Modified Commands
Command Cisco IOS Software Release
redundancy force-switchover 12.2(33)SCA
service class 12.2(33)SCA
rf-channel frequency 12.3(23)BC
rf-channel ip-address mac-address udp-port 12.3(23)BC
rf-channel frequency 12.2(33)SCB
rf-channel ip-address mac-address udp-port 12.2(33)SCB
rf-channel network-delay 12.2(33)SCB
rf-channel network-delay 12.2(33)SCC
rf-channel rf-power 12.2(33)SCD
service divert-rate-limit ipv6 12.2(33)SCE
service divert-rate-limit trusted-site-ipv6 12.2(33)SCE
Removed Commands
Command Cisco IOS Software Release
service divert-rate-limit 12.2(33)SCB
redundancy linecard-group 12.2(33)SCE
Cisco IOS CMTS Cable Command Reference
CBL-1050 OL-15510-15
Cable Commands: q through sg
qos-profile enforced
qos-profile enforced
To specify a quality-of-service (QoS) profile that should be enforced when users violate their registered
QoS profiles, use the qos-profile enforced command in enforce-rule configuration mode. To delete the
enforced QoS profile from the enforce-rule, use the no form of this command.
qos-profile enforced profile-id [no-persistence]
no qos-profile enforced profile-id [no-persistence]
Syntax Description profile-id Specifies the QoS profile to be enforced. The valid range is 0 to 16383,
with a default of 0.
no-persistence (Optional) Specifies that the enforced QoS profile should not remain
in force when a cable modem reboots. Instead, when a cable modem
that is in the penalty period reboots, it is automatically removed from
the penalty period and assigned the QoS profile that is specified in its
DOCSIS configuration file.
The default behavior is that enforced QoS profiles remain in force for
cable modems across reboots.
Command Default The value of profile-id defaults to 0, and enforced QoS profiles are persistent across cable modem
reboots.
Command Modes Enforce-rule configuration (enforce-rule)
Command History Release Modification
12.3(9a)BC This command was introduced. This command replaces the enforced
qos-profile command.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines Both the originally provisioned QoS profile and the enforced QoS profile must be created on the
Cisco CMTS router. The profile-id does not support QoS profiles that are created by the cable modem.
An enforce-rule can specify an enforced QoS profile, which is automatically applied to subscribers who
transmit more traffic than allowed by their registered QoS profile. The enforced QoS profile remains in
effect during the penalty time period (see the penalty-period command). At the end of the penalty
period, the subscriber returns to the registered QoS profile.
If a cable modem reboots while it is in its penalty time period, it continues using the enforced QoS
profile, unless the service provider has manually changed the cable modem’s registered QoS profile
using the cable modem qos profile command.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1051
Cable Commands: q through sg
qos-profile enforced
When you change the enforced QoS profile for a currently active enforce-rule, any cable modems using
this rule that are currently in the penalty period continue using the previously configured enforced QoS
profile. Any cable modems that enter the penalty period after this configuration change, however, use
the new enforced QoS profile.
An enforced QoS profile must already have been created on the Cisco CMTS router before you can
assign it to an enforce-rule. If the rule does not exist, the system displays an error message.
When the no-persistence option is specified, the enforced QoS profile is still automatically applied to
subscribers who violate their bandwidth requirements. However, when the cable modem reboots, the
Cisco CMTS router allows the cable modem to use the QoS profile that is specified in its DOCSIS
configuration file.
The no-persistence option can be used when initially using the Subscriber Traffic Management feature
to identify potential problem applications and users. When repeat offenders are identified, they can then
be assigned enforce-rules that do not use the no-persistence option, so that they remain in the penalty
period even if they reboot their cable modems.
Note The system automatically applies the enforced QoS profile to violators only if the enforce keyword has
been used with the activate-rule-at-byte-count command.
Examples The following example shows profile 12 being assigned as the enforced QoS profile to an enforce-rule:
Router# configure terminal
Router(config)# cable qos enforce-rule residential
Router(enforce-rule)# qos-profile enforced 12
The following example shows profile 12 being assigned as the enforced QoS profile to an enforce-rule,
but with the no-persistence option specified, so that the enforced QoS profile does not remain in force
if the cable modem reboots:
Router# configure terminal
Router(config)# cable qos enforce-rule residential
Router(enforce-rule)# qos-profile enforced 12 no-persistence
The following example shows the error message that is displayed when the specified QoS profile does
not exist on the CMTS:
Router# configure terminal
Router(config)# cable qos enforce-rule test
Router(enforce-rule)# qos-profile enforced 98
The qos profile 98 doesn't exist or it's a cm created QoS profile
Related Commands Command Description
cable qos enforce-rule Creates an enforce-rule to enforce a particular QoS profile for
subscriber traffic management and enters enforce-rule configuration
mode.
debug cable Displays enforce-rule debug messages for subscriber traffic
subscriber-monitoring management on the Cisco CMTS routers.
duration Specifies the time period and sample rate to be used for monitoring
subscribers.
Cisco IOS CMTS Cable Command Reference
CBL-1052 OL-15510-15
Cable Commands: q through sg
qos-profile enforced
Command Description
enabled (enforce-rule) Activates an enforce-rule and begins subscriber traffic management
on a Cisco CMTS router.
monitoring-basics Specifies the type of monitoring for subscriber traffic management on
a Cisco CMTS router.
peak-time1 Specifies peak and offpeak monitoring times on a Cisco CMTS router.
qos-profile registered Specifies the registered QoS profile that should be used for this
enforce-rule.
service-class (enforce-rule) Identifies a particular service class for cable modem monitoring in an
enforce-rule.
show cable qos enforce-rule Displays the QoS enforce-rules that are currently defined.
show cable subscriber-usage Displays subscribers who are violating their registered QoS profiles.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1053
Cable Commands: q through sg
qos-profile registered
qos-profile registered
To specify the registered quality of service (QoS) profile that should be used for this enforce-rule, use
the qos-profile registered command in enforce-rule configuration mode. To remove the registered QoS
profile from the enforce-rule, use the no form of this command.
qos-profile registered profile-id
no qos-profile registered profile-id
Syntax Description profile-id Specifies the QoS profile to be monitored. This profile must be created
on the Cisco CMTS router. If you want to manage a cable modem that
uses a modem-created QoS profile, you must first create that exact QoS
profile on the CMTS router before using this command. The valid
range is 0 to 16383, with a default of 0.
Command Default The default profile ID is 0.
Command Modes Enforce-rule configuration (enforce-rule)
Command History Release Modification
12.3(9a)BC This command was introduced. This command replaces the registered
qos-profile command.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines You must specify a registered QoS profile for each enforce-rule. The Cisco CMTS router then uses the
registered profile ID to match subscribers’ service flows to the proper enforce-rules.
When you change the registered QoS profile for an active rule, the cable modems that had been using
the previous registered QoS profile are no longer managed by the Cable ARP Filtering feature. Instead,
the rule begins managing those cable modems that use the new registered QoS profile.
Note The registered QoS profile must be created on the Cisco CMTS router before you can assign it to an
enforce-rule. If the rule does not exist, the system displays an error message. If you want to manage a
cable modem that is currently using a modem-created QoS profile, you must first manually create a new
QoS profile on the CMTS router that has the same QoS parameters as the modem-created profile. Then
allow the modem to come online using the manually created profile, before using the qos-profile
registered command.
Cisco IOS CMTS Cable Command Reference
CBL-1054 OL-15510-15
Cable Commands: q through sg
qos-profile registered
Examples The following example shows profile 50 being assigned as the registered QoS profile to an enforce-rule:
Router# configure terminal
Router(config)# cable qos enforce-rule enforce-rule
Router(enforce-rule)# qos-profile registered 50
The following example shows the error message that is displayed when the specified QoS profile does
not exist on the CMTS:
Router# configure terminal
Router(config)# cable qos enforce-rule test
Router(enforce-rule)# qos-profile registered 99
The qos profile 99 doesn't exist or it's a cm created QoS profile
Related Commands Command Description
cable qos enforce-rule Creates an enforce-rule to to enforce a particular QoS profile for
subscriber traffic management and enters enforce-rule configuration
mode.
debug cable Displays enforce-rule debug messages for subscriber traffic
subscriber-monitoring management on the Cisco CMTS routers.
duration Specifies the time period and sample rate to be used for monitoring
subscribers.
enabled (enforce-rule) Activates an enforce-rule and begins subscriber traffic management on
a Cisco CMTS router.
monitoring-basics Specifies the type of monitoring for subscriber traffic management on a
Cisco CMTS router.
peak-time1 Specifies peak and offpeak monitoring times on a Cisco CMTS router.
qos-profile enforced Specifies a QoS profile that should be enforced when users violate their
registered QoS profiles.
service-class (enforce-rule) Enables the enforcing of QOS profiles according to service class.
show cable qos Displays the QoS enforce-rules that are currently defined.
enforce-rule
show cable Displays subscribers who are violating their registered QoS profiles.
subscriber-usage
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1055
Cable Commands: q through sg
rcp-id
rcp-id
To assign a receive channel profile (RCP) ID to a receive channel configuration (RCC) template, use the
rcp-id command in RCC template configuration mode. To remove the RCP ID, use the no form of this
command.
rcp-id rcp-id
no rcp-id rcp-id
Syntax Description rcp-id Specifies an RCP ID for the RCC template. The valid range is from 00 00 00
00 00 to FF FF FF FF FF.
Command Default By default the RCP ID is set to 00 00 00 00 00. However, you must change the default value to a non-zero
RCP ID.
Command Modes RCC template configuration (config-rcc-template)
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines A valid RCC template consists of a configured RCP ID, a receive module (RM) entry, and a receive
channel (RC) entry.
First, you define an RCC template for an RCP, and then assign the template to a cable interface to
generate RCCs based on the actual DS channel configuration.
Examples The following example shows how to assign an RCP ID to an RCC template:
Router# configure terminal
Router(config)# cable rcc-template 1
Router(config-rcc-template)# rcp-id 00 10 00 00 03
Related Commands Command Description
rcp-id Specifies an ID for the receive channel profile.
receive-module Specifies a receive module entry in the form of a numeric value.
receive-channel Specifies a receive channel entry in the form of a numeric value.
Cisco IOS CMTS Cable Command Reference
CBL-1056 OL-15510-15
Cable Commands: q through sg
receive-channel
receive-channel
To associate a receive channel to a receive module (RC), use the receive-channel command in RCC
template configuration mode. To restore the default value, use the no form of this command.
receive-channel index center-frequency Hz connected-receive-module index [primary]
no receive-channel index center-frequency Hz connected-receive-module index
Syntax Description index Specifies the index value for the receive channel. The valid range is 1 to 10.
center-frequency Specifies the center frequency for the receive channel.
Hz Specifies the center frequency value in Hz. The valid range is
55000000-858000000.
connected-receive-mo Specifies a nested receive module in the RCC template.
dule
Generally, only one receive module is configured for an RCC template.
index Specifies the index value for the connected receive module. The valid range
is 1 to 10.
Primary (Optional) Indicates that it is a CM primary channel and an RCC can be
derived from this channel.
Command Default .No default behavior or values.
Command Modes RCC template configuration (config-rcc-template)
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines A valid RCC template consists of a configured RCP ID, a receive module (RM) entry, and a receive
channel (RC) entry. First, you define an RCC template for an RCP, and then assign the template to a
cable interface to generate RCCs based on the actual DS channel configuration.
An RCC template configures the physical layer components described by an RCP, including receive
modules and receive channels to specific downstream frequencies, and specifies the interconnections
among receive modules or between receive modules and receive channels.
A receive module can include multiple receive channels. So we need to specify which receive channel
belongs to which receive module.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1057
Cable Commands: q through sg
receive-channel
Examples The following example shows how to associate a receive channel to a receive module:
Router# configure terminal
Router(config)# cable rcc-template 1
Router(config-rcc-template)# rcp-id 00 10 00 00 03
Router(config-rcc-template)# receive-module 1 first-channel-center-frequency 555000000
Router(config-rcc-template)# receive-channel 1 center-frequency 555000000
connected-receive-module 1 primary
Router(config-rcc-template)# receive-channel 2 center-frequency 561000000
connected-receive-module 1
Related Commands Command Description
cable rcc-template Defines a receive channel configuration (RCC) template for an RCP.
rcp-id Specifies an ID for the receive channel profile.
receive-module Specifies a receive module entry in the form of a numeric value.
Cisco IOS CMTS Cable Command Reference
CBL-1058 OL-15510-15
Cable Commands: q through sg
receive-module
receive-module
To associate a receive module (RC) to a Receive Channel Configuration (RCC) template, use the
receive-module command in RCC template configuration mode. To restore the default value, use the no
form of this command.
receive-module index first-channel-center-frequency Hz [connected-receive-module index]
no receive-module index first-channel-center-frequency Hz [connected-receive-module index]
Syntax Description index Specifies the index value for the receive module. The valid index range is 1
to 10.
first-channel-center-fr Specifies the center frequency of the first channel of the receive module
equency channel block.
Hz Specifies the center frequency value in Hz. The valid range is 55000000 to
858000000.
connected-receive-mo (Optional) Specifies a nested receive module in the RCC template.
dule
Generally, only one receive module is configured for an RCC template.
index (Optional) Specifies the index value for the connected receive module. The
valid range is 1 to 10.
Command Default .No default behavior or values.
Command Modes RCC template configuration (config-rcc-template)
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines A valid RCC template consists of a configured RCP ID, a receive module (RM) entry, and a receive
channel (RC) entry. First, you define an RCC template for an RCP, and then assign the template to a
cable interface to generate RCCs based on the actual DS channel configuration.
An RCC template configures the physical layer components described by an RCP, including receive
modules and receive channels to specific downstream frequencies, and specifies the interconnections
among receive modules or between receive modules and receive channels.
A receive module can include multiple receive channels. So we need to specify which receive channel
belongs to which receive module.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1059
Cable Commands: q through sg
receive-module
Examples The following example shows how to associate a receive module to an RCC template:
Router# configure terminal
Router(config)# cable rcc-template 1
Router(config-rcc-template)# rcp-id 00 10 00 00 03
Router(config-rcc-template)# receive-module 1 first-channel-center-frequency 555000000
Router(config-rcc-template)# receive-channel 1 center-frequency 555000000
connected-receive-module 1 primary
Router(config-rcc-template)# receive-channel 2 center-frequency 561000000
connected-receive-module 1
Related Commands Command Description
cable rcc-template Defines a receive channel configuration (RCC) template for an RCP.
rcp-id Specifies an ID for the receive channel profile.
receive-channel Specifies a receive channel entry in the form of a numeric value.
Cisco IOS CMTS Cable Command Reference
CBL-1060 OL-15510-15
Cable Commands: q through sg
redundancy force-failover main-cpu
redundancy force-failover main-cpu
To force a switchover, so that the standby Performance Routing Engine (PRE1) module becomes the
active PRE1 module, use the redundancy force-failover main-cpu command in privileged EXEC
mode.
redundancy force-failover main-cpu
Syntax Description This command has no keywords or arguments.
Defaults No default behavior or values
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(4)XF1 This command was introduced for the Cisco uBR10012 router.
12.2(11)BC3 The active PRE1 module checks to see if a switchover is currently in
progress before implementing this command.
12.3(21)BC This command is replaced by the redundancy switch-activity command.
Usage Guidelines The redundancy force-failover main-cpu command initiates a manual switchover, so that the standby
PRE1 module becomes the active PRE1 module and assumes full responsibilities for router operations.
This command requires that both PRE1 modules are running a Cisco IOS software image that supports
the Route Processor Redundancy (RPR) feature.
Note The terms failover and switchover are interchangeable, but switchover is the term used across all Cisco
platforms capable of high-availability operation.
A manual switchover is typically done for one of the following reasons:
• You want to upgrade or replace the active PRE1 module.
• You have upgraded the Cisco IOS software on the standby PRE1 module and want the standby PRE1
module to begin using the new software image. This also allows you to upgrade the software on the
former active PRE1 module without interrupting systems operations.
• You want to test switchover operation on the system.
A switchover can also be manually initiated by removing the active PRE1 module from the chassis, but
using the redundancy force-failover main-cpu command provides a more graceful switchover, without
generating hardware alarms.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1061
Cable Commands: q through sg
redundancy force-failover main-cpu
Tip Do not perform a switchover immediately after you change the configuration and save it to the NVRAM.
Instead, wait a few minutes to allow the two PRE1 modules to synchronize the new configuration, and
then perform the switchover.
Tip Wait two to three minutes after a switchover before switching the system back to the original PRE1
module, so as to allow the system to stabilize and so that both PRE1 modules are ready for the switch.
In Cisco IOS Release 12.2(11)BC3 and later releases, the active PRE1 module will not initiate a new
switchover until a current switchover is complete and the system has stabilized.
Examples The following example shows a switchover being manually initiated:
Router# redundancy force-failover main-cpu
Proceed with switchover to standby PRE? [confirm] y
Note Pressing enter or y confirms the action and begins the switchover. Pressing any other key aborts the
switchover and returns control to the current active PRE1 module.
The following example shows a switchover being attempted but failing because the standby PRE1
module is either not ready, not available, or not installed:
Router# redundancy force-failover main-cpu
Proceed with switchover to standby PRE? [confirm]
Standby PRE not ready, switchover aborted.
Router#
Note In some versions of Cisco IOS software, a failed software switchover will show the following message:
Unable to communicate with standby PRE, switchover aborted.
Related Commands Command Description
associate Associates two line cards for Automatic Protection Switching (APS)
redundancy protection.
redundancy Enters redundancy configuration mode so that the synchronization
parameters can be configured.
redundancy reload Resets the standby PRE1 module or to reset both the active and standby
PRE1 modules.
redundancy Forces a switchover to the standby PRE module.
switch-activity
Cisco IOS CMTS Cable Command Reference
CBL-1062 OL-15510-15
Cable Commands: q through sg
redundancy linecard-group
redundancy linecard-group
To trigger a switchover from the working line card to the protect line card, or to revert from the protect
line card to the working line card on the Cisco uBR10012 router, use the redundancy linecard-group
command in privileged EXEC mode.
redundancy linecard-group {lockout | resync | revertback | switchover from | unlockout}
slot/subslot
Syntax Description lockout Locks a line card switchover from the specified working slot and subslot.
resync Specifies static synchronization from the working line card to the protect
line card.
revertback Reverts from the protect line card to the working line card.
switchover from Triggers a switchover from the working line card to the protect line card.
unlockout Removes the switchover lockout from the specified working slot and
subslot.
slot/subslot Specifies the cable interface line card on the Cisco uBR10012 router.
• slot—Chassis slot number of the cable interface line card. The valid
range is from 5 to 8.
• subslot—(Cisco uBR10012 router only) Secondary slot number of the
cable interface line card. Valid subslots are 0 and 1.
Command Default None
Command Modes Privileged EXEC (#)
Command History Release Modification
12.3(13a)BC This command was introduced.
12.2(33)SCE This command was modified. A new keyword, resync, was added to enable
the Cisco uBR10012 router to perform a manual synchronization from the
working line card to the protect line card.
Usage Guidelines The redundancy linecard-group command is supported only on the Cisco uBR10012 router. When the
normal (system initiated) static line card synchronization fails, use the redundancy linecard-group
command with the resync keyword to enable the Cisco uBR10012 router to perform a manual
synchronization from the working line card to the protect line card.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1063
Cable Commands: q through sg
redundancy linecard-group
Examples The following example shows how to lock a line card switchover from slot 5 and subslot 0 on the
Cisco uBR10012 router using the redundancy linecard-group command with the lockout keyword:
Router# redundancy linecard-group lockout 5/0
HCCP LC: 5/0 Working will be locked out, this operation will prevent all kinds of
switchover.
The following example shows how to remove the switchover lockout from slot 5 and subslot 0 on the
Cisco uBR10012 router using the redundancy linecard-group command with the unlockout keyword:
Router# redundancy linecard-group unlockout 5/0
The following example shows how to enable the Cisco uBR10012 router to perform a manual
synchronization from the working line card to the protect line card using the
redundancy linecard-group command with the resync keyword:
Router# redundancy linecard-group resync 5/0
*Nov 9 23:09:09.049: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U2, changed state to
administratively down
*Nov 9 23:09:09.049: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U1, changed state to
administratively down
*Nov 9 23:09:09.049: %SNMP-5-LINK_DOWN: LinkDown:Interface Cable5/1/1-upstream2 changed
state to down
*Nov 9 23:09:09.049: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U0, changed state to
administratively down
*Nov 9 23:09:09.057: %SNMP-5-LINK_DOWN: LinkDown:Interface Cable5/1/1-upstream1 changed
state to down
*Nov 9 23:09:09.057: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U0, changed state to up
*Nov 9 23:09:09.057: %SNMP-5-LINK_DOWN: LinkDown:Interface Cable5/1/1-upstream0 changed
state to down
*Nov 9 23:09:09.061: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U1, changed state to up
*Nov 9 23:09:09.061: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U2, changed state to up
*Nov 9 23:09:09.173: %SNMP-5-LINK_UP: LinkUp:Interface Cable5/1/1-upstream0 changed state
to up
SLOT 5/1: Nov 9 23:09:09.057: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U2, changed state
to administratively down
SLOT 5/1: Nov 9 23:09:09.057: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U1, changed state
to administratively down
SLOT 5/1: Nov 9 23:09:09.057: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U0, changed state
to administratively down
SLOT 5/1: Nov 9 23:09:09.173: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U0, changed state
to up
SLOT 5/1: Nov 9 23:09:09.177: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U1, changed state
to up
SLOT 5/1: Nov 9 23:09:09.177: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U2, changed state
to up
*Nov 9 23:09:19.457: %HCCP-5-SWITCHOVERREADY: HCCP card 5/1 Mbr 50 Protect: ready to
switchover.
*Nov 9 23:09:19.457: %HCCP-5-SWITCHOVERREADY: HCCP card 5/0 Mbr 50 Working: ready to
switchover.
The following example shows how to enable the Cisco uBR10012 router to perform a switchover from
the working line card to the protect line card using the redundancy linecard-group command with the
switchover from keyword:
Router# redundancy linecard-group switchover from 5/0
*Nov 9 23:17:27.489: %HCCP-5-LC_ACTIVE: HCCP card 5/1 Mbr 50 Protect: change state to
active due to: CLI Switch.
*Nov 9 23:17:27.525: %HCCP-5-LC_STANDBY: HCCP card 5/0 Mbr 50 Working: change state to
standby due to: CLI Switch.
Cisco IOS CMTS Cable Command Reference
CBL-1064 OL-15510-15
Cable Commands: q through sg
redundancy linecard-group
*Nov 9 23:17:27.525: %HCCP-5-CHANON: HCCP card 5/1 Mbr 50 Protect: turning on channel.
*Nov 9 23:17:27.525: %HCCP-6-HCCP_CHAN_RFSW_SNMP_INFO: HCCP_LC_CHAN: waits forsnmp
response asynchronously.
*Nov 9 23:17:27.541: %SNMP-5-LINK_UP: LinkUp:Interface Wideband-Cable5/1/1:0 changed
state to up
*Nov 9 23:17:27.541: %LINEPROTO-5-UPDOWN: Line protocol on Interface
Wideband-Cable5/1/1:0, changed state to up
*Nov 9 23:17:27.541: %SNMP-5-LINK_UP: LinkUp:Interface Wideband-Cable5/1/1:2 changed
state to up
*Nov 9 23:17:27.541: %LINEPROTO-5-UPDOWN: Line protocol on Interface
Wideband-Cable5/1/1:2, changed state to up
*Nov 9 23:17:27.541: %SNMP-5-LINK_UP: LinkUp:Interface Wideband-Cable5/1/1:4 changed
state to up
*Nov 9 23:17:27.541: %LINEPROTO-5-UPDOWN: Line protocol on Interface
Wideband-Cable5/1/1:4, changed state to up
*Nov 9 23:17:27.905: %HCCP-6-HCCP_CHAN_RFSW_SNMP_INFO: HCCP_LC_CHAN: snmp set to rf
switch is successful.
SLOT 5/1: Nov 9 23:17:27.597: %HCCP-6-LC_RPLC_CFGSYNC_CONFIG_RECOVER: HCCP 14 50 Protect:
LC critical rplc_cfgsync configuration recover is succeed.
SLOT 5/1: Nov 9 23:17:27.601: %HCCP-6-LC_RPLC_CFGSYNC_CONFIG_RECOVER: HCCP 15 50 Protect:
LC critical rplc_cfgsync configuration recover is succeed.
*Nov 9 23:17:28.121: %HCCP-3-DATA_PLANE_READY: HCCP data plane for card 5/1 member 50 is
ready.
*Nov 9 23:17:28.493: %LINEPROTO-5-UPDOWN: Line protocol on Interface Cable5/1/0, changed
state to up
*Nov 9 23:17:28.493: %SNMP-5-LINK_UP: LinkUp:Interface Cable5/1/0 changed state to up
*Nov 9 23:17:28.497: %LINEPROTO-5-UPDOWN: Line protocol on Interface Cable5/1/1, changed
state to up
*Nov 9 23:17:28.497: %SNMP-5-LINK_UP: LinkUp:Interface Cable5/1/1 changed state to up
*Nov 9 23:17:28.497: %LINEPROTO-5-UPDOWN: Line protocol on Interface Cable5/1/2, changed
state to up
*Nov 9 23:17:28.497: %SNMP-5-LINK_UP: LinkUp:Interface Cable5/1/2 changed state to up
*Nov 9 23:17:37.801: %LINK-3-UPDOWN: Interface Modular-Cable5/1/1:0, changed state to up
*Nov 9 23:17:38.513: %HCCP-6-STATICSYNC_COMPLETED: HCCP static sync for card 5/1 member
50 is completed in 56 ms.
*Nov 9 23:17:38.801: %LINEPROTO-5-UPDOWN: Line protocol on Interface
Modular-Cable5/1/1:0, changed state to up
*Nov 9 23:17:48.513: %HCCP-5-SWITCHOVERREADY: HCCP card 5/0 Mbr 50 Working: ready to
switchover.
*Nov 9 23:17:48.513: %HCCP-5-SWITCHOVERREADY: HCCP card 5/1 Mbr 50 Protect: ready to
switchover.
The following example shows how to revert from the protect line card to the working line card using the
redundancy linecard-group command with the revertback keyword:
Router# redundancy linecard-group revertback 5/0
*Nov 9 23:21:33.277: %HCCP-5-LC_ACTIVE: HCCP card 5/0 Mbr 50 Working: change state to
active due to: CLI Switch.
*Nov 9 23:21:33.285: %HCCP-5-LC_STANDBY: HCCP card 5/1 Mbr 50 Protect: change state to
standby due to: CLI Switch.
*Nov 9 23:21:33.297: %HCCP-5-CHANON: HCCP card 5/0 Mbr 50 Working: turning on channel.
*Nov 9 23:21:33.301: %HCCP-5-CHANOFF: HCCP card 5/1 Mbr 50 Protect: turning off channel.
*Nov 9 23:21:33.301: %HCCP-6-HCCP_CHAN_RFSW_SNMP_INFO: HCCP_LC_CHAN: waits for snmp
response asynchronously.
*Nov 9 23:21:33.433: %UBR10000-5-UPDOWN: Interface Cable5/1/0 U2, changed state to
administratively down
*Nov 9 23:21:33.437: %UBR10000-5-UPDOWN: Interface Cable5/1/0 U1, changed state to
administratively down
*Nov 9 23:21:33.441: %UBR10000-5-UPDOWN: Interface Cable5/1/0 U0, changed state to
administratively down
*Nov 9 23:21:33.481: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U2, changed state to
administratively down
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1065
Cable Commands: q through sg
redundancy linecard-group
*Nov 9 23:21:33.481: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U2, changed state to
administratively down
Nov 9 23:21:33.585: %interface Cable5/1/0 U0 Docsis mode set to DOCSIS 1.x-only Nov 9
23:21:33.585: %Modulation profile set to 21
*Nov 9 23:21:34.277: %LINEPROTO-5-UPDOWN: Line protocol on Interface Cable5/0/0, changed
state to up
*Nov 9 23:21:34.277: %SNMP-5-LINK_UP: LinkUp:Interface Cable5/0/0 changed state to up
*Nov 9 23:21:34.277: %LINEPROTO-5-UPDOWN: Line protocol on Interface Cable5/0/1, changed
state to up
*Nov 9 23:21:34.277: %SNMP-5-LINK_UP: LinkUp:Interface Cable5/0/1 changed state to up
*Nov 9 23:21:34.277: %LINEPROTO-5-UPDOWN: Line protocol on Interface Cable5/0/2, changed
state to up
*Nov 9 23:21:34.277: %SNMP-5-LINK_UP: LinkUp:Interface Cable5/0/2 changed state to up
*Nov 9 23:21:34.309: %LINEPROTO-5-UPDOWN: Line protocol on Interface Cable5/0/3, changed
state to up
*Nov 9 23:21:34.309: %SNMP-5-LINK_UP: LinkUp:Interface Cable5/0/3 changed state to up
*Nov 9 23:21:34.309: %LINEPROTO-5-UPDOWN: Line protocol on Interface Cable5/0/4, changed
state to up
*Nov 9 23:21:34.309: %SNMP-5-LINK_UP: LinkUp:Interface Cable5/0/4 changed state to up
*Nov 9 23:21:35.513: %LINK-3-UPDOWN: Interface Modular-Cable5/1/1:0, changed state to
down
*Nov 9 23:21:36.513: %LINEPROTO-5-UPDOWN: Line protocol on Interface
Modular-Cable5/1/1:0, changed state to down
*Nov 9 23:21:46.537: %UBR10000-5-USFREQCHG: Interface Cable5/1/0 U0, changed to Freq
10.000 MHz
*Nov 9 23:21:46.545: %UBR10000-5-USFREQCHG: Interface Cable5/1/0 U1, changed to Freq
30.000 MHz
*Nov 9 23:21:46.549: %UBR10000-5-USFREQCHG: Interface Cable5/1/0 U2, changed to Freq
20.000 MHz
*Nov 9 23:21:46.581: %UBR10000-5-USFREQCHG: Interface Cable5/1/1 U0, changed to Freq
25.000 MHz
*Nov 9 23:21:46.585: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U0, changed state to up
*Nov 9 23:21:46.585: %UBR10000-5-USFREQCHG: Interface Cable5/1/1 U1, changed to Freq
15.000 MHz
*Nov 9 23:21:46.585: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U1, changed state to up
*Nov 9 23:21:46.589: %UBR10000-5-USFREQCHG: Interface Cable5/1/1 U2, changed to Freq
35.000 MHz
*Nov 9 23:21:46.589: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U2, changed state to up
*Nov 9 23:21:46.657: %SNMP-5-LINK_UP: LinkUp:Interface Cable5/1/1-upstream0 changed state
to up
Nov 9 23:21:46.669: %interface Cable5/1/0 U0 Docsis mode set to ATDMA-only (1.x CMs will
go offline)
Nov 9 23:21:46.669: %Modulation profile set to 221
SLOT 5/1: Nov 9 23:21:46.689: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U0, changed state
to up
SLOT 5/1: Nov 9 23:21:46.693: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U1, changed state
to up
SLOT 5/1: Nov 9 23:21:46.693: %UBR10000-5-UPDOWN: Interface Cable5/1/1 U2, changed state
to up
*Nov 9 23:21:57.033: %HCCP-5-SWITCHOVERREADY: HCCP card 5/1 Mbr 50 Protect: ready to
switchover.
*Nov 9 23:21:57.033: %HCCP-5-SWITCHOVERREADY: HCCP card 5/0 Mbr 50 Working: ready to
switchover.
Cisco IOS CMTS Cable Command Reference
CBL-1066 OL-15510-15
Cable Commands: q through sg
redundancy linecard-group
Related Commands Command Description
show hccp Displays Hot Standby Connection-to-Connection Protocol (HCCP) group
information for a specific cable interface.
show hccp interface Displays group information for a specific cable interface on which one or
more groups and authentication modes have been configured.
show hccp linecard Displays information about HCCP groups associated with a line card.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1067
Cable Commands: q through sg
redundancy reload
redundancy reload
To reset the standby PRE module or to reset both the active and standby PRE modules, use the
redundancy reload command in privileged EXEC mode.
redundancy reload {peer | shelf}
Syntax Description peer Reloads only the standby PRE1 module.
shelf Reloads both the active and standby PRE1 module.
Defaults No default behavior or values
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(4)XF1 This command was introduced for the Cisco uBR10012 router.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was removed from Cisco IOS Release 12.2(33)SCA. It is
replaced by the hw-module standby-cpu reset command.
Usage Guidelines The redundancy reload peer command reloads the Cisco IOS software on the standby PRE1 module,
which does not have an impact on router operations, assuming a switchover is not required while the
standby module is resetting. The redundancy reload shelf command reloads the Cisco IOS software on
both the active and standby PRE1 modules, which will interrupt services on the router until all PRE1
modules and line cards initialize and come back online.
Examples The following example shows a switchover being manually initiated, overriding any checks that might
prevent or delay the switchover:
Router# redundancy reload peer
Reload peer? [confirm] y
Preparing to reload peer
Note Pressing enter or y confirms the action and begins the reload. Pressing any other key aborts the reload
and returns control to the current active PRE1 module.
The following example shows the system’s response when a standby PRE1 module is not installed in the
router:
Router# redundancy reload peer
System is running in SIMPLEX mode, reload anyway? [confirm] n
Peer reload not performed.
Cisco IOS CMTS Cable Command Reference
CBL-1068 OL-15510-15
Cable Commands: q through sg
redundancy reload
The following example shows how to reload both PRE1 modules:
Router# redundancy reload shelf
Reload the entire shelf [confirm] y
Preparing to reload entire shelf
Note Pressing enter or y confirms the action and begins the reload of both modules. Pressing any other key
aborts the reload and returns control to the current active PRE1 module.
Related Commands Command Description
associate slot Associates slots for APS processor redundancy.
redundancy Enters redundancy configuration mode so that the synchronization
parameters can be configured.
redundancy Forces a switchover, so that the standby PRE module becomes the active
force-failover PRE module.
main-cpu
redundancy Forces a switchover to the standby PRE module.
switch-activity
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1069
Cable Commands: q through sg
redundancy switch-activity
redundancy switch-activity
To force a switchover to the standby PRE module, use the redundancy switch-activity command in
privileged EXEC mode.
redundancy switch-activity [force]
Note The terms failover and switchover are interchangeable, but switchover is the term used across all
Cisco platforms capable of high-availability operation.
Syntax Description force (Optional) Forces a switchover immediately, overriding any checks in the
code or configuration that might prevent or delay a switchover.
Command Default No default behavior or values
Command Modes Privileged EXEC
Command History Release Modification
12.2(4)XF1 This command was introduced for the Cisco uBR10012 router.
Usage Guidelines The redundancy switch-activity command is similar to the redundancy force-failover main-cpu
command, except that it includes an option to force the switchover, overriding any configuration checks
or other checks in the software that could prevent the switchover. In all cases, this command verifies that
the standby PRE module is available and capable of performing the switchover before it transfers control
to that PRE module. This command also synchronizes the current running-config and client data before
initiating the switchover.
Examples The following example shows a switchover being manually initiated, overriding any checks that might
prevent or delay the switchover:
Router# redundancy switch-activity force
Proceed with switchover to standby PRE? [confirm] y
Note Pressing enter or y confirms the action and begins the switchover. Pressing any other key aborts the
switchover and returns control to the current active PRE1 module.
Cisco IOS CMTS Cable Command Reference
CBL-1070 OL-15510-15
Cable Commands: q through sg
redundancy switch-activity
Related Commands Command Description
associate Associates two line cards for Automatic Protection Switching (APS)
redundancy protection.
redundancy Enters redundancy configuration mode so that the synchronization
parameters can be configured.
redundancy reload Resets the standby PRE1 module or to reset both the active and standby
PRE1 modules.
redundancy Forces a switchover, so that the standby Performance Routing Engine
force-failover (PRE1) module becomes the active PRE1 module.
main-cpu
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1071
Cable Commands: q through sg
registered qos-profile
registered qos-profile
Note Effective with Cisco IOS Release 12.3(9a)BC, the registered qos-profile command is replaced by the
qos-profile registered command.
To specify the registered quality of service (QoS) profile that should be used for this enforce-rule, use
the registered qos-profile command in enforce-rule configuration mode. To remove the registered QoS
profile from the enforce-rule, use the no form of this command.
registered qos-profile profile-id
no registered qos-profile profile-id
Syntax Description profile-id Specifies the QoS profile to be monitored. This profile must be created
on the Cisco CMTS router. If you want to manage a cable modem that
uses a modem-created QoS profile, you must first create that exact QoS
profile on the CMTS router before using this command. The valid
range is 0 to 16383, with a default of 0.
Command Default The default profile ID is 0.
Command Modes Enforce-rule configuration (enforce-rule)
Command History Release Modification
12.2(15)BC1 This command was introduced.
12.3(9a)BC This command was replaced by the qos-profile registered command.
Usage Guidelines You must specify a registered QoS profile for each enforce-rule. The Cisco CMTS router then uses the
registered profile ID to match subscribers’ service flows to the proper enforce-rules.
When you change the registered QoS profile for an active rule, the cable modems that had been using
the previous registered QoS profile are no longer managed by the Subscriber Traffic Management
feature. Instead, the rule begins managing those cable modems that use the new registered QoS profile.
Note The registered QoS profile must be created on the Cisco CMTS router before you can assign it to an
enforce-rule. If the rule does not exist, the system displays an error message. If you want to manage a
CM that is using a CM-created QoS profile, you must first create a QoS profile on the Cisco CMTS
router that matches the CM-created profile exactly. Then use the registered qos-profile command to
assign that profile to this enforce-rule.
Cisco IOS CMTS Cable Command Reference
CBL-1072 OL-15510-15
Cable Commands: q through sg
registered qos-profile
Examples The following example shows profile 50 being assigned as the registered QoS profile to an enforce-rule:
Router# configure terminal
Router(config)# cable qos enforce-rule enforce-rule
Router(enforce-rule)# registered qos-profile 50
The following example shows the error message that is displayed when the specified QoS profile does
not exist on the CMTS:
Router# configure terminal
Router(config)# cable qos enforce-rule test
Router(enforce-rule)# registered qos-profile 99
The qos profile 99 doesn't exist or it's a cm created QoS profile
Related Commands Command Description
activate-rule Specifies the number of bytes that a subscriber can transmit during the
at-byte-count monitoring period on a Cisco CMTS router.
cable qos enforce-rule Creates an enforce-rule to enforce a particular QoS profile for subscriber
traffic management and enters enforce-rule configuration mode.
duration Specifies the time period and sample rate to be used for monitoring
subscribers.
enabled (enforce-rule) Activates an enforce-rule and begins subscriber traffic management on a
Cisco CMTS router.
penalty-period Specifies the time period that an enforced QoS profile should be in effect for
subscribers that violate their registered QoS profiles.
qos-profile enforced Specifies a QoS profile that should be enforced when users violate their
registered QoS profiles.
show cable qos Displays the QoS enforce-rules that are currently defined.
enforce-rule
show cable Displays subscribers who are violating their registered QoS profiles.
subscriber-usage
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1073
Cable Commands: q through sg
restricted
restricted
To convert a general load balancing group (GLBG) to a restricted load balancing group (RLBG) for
DOCSIS load balancing, use the restricted command in the config-lb-group configuration mode. To
revert to the general group type for DOCSIS load balancing, use the no form of this command.
restricted
no restricted
Command Default By default, the general group type is selected for load balancing.
Command Modes DOCSIS load balancing group mode (config-lb-group)
Command History Release Modification
12.2(33)SCC This command was introduced.
Examples The following example shows how to convert a GLBG to a RLBG using the restricted command.
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# cable load-balance docsis-group 1
Router(config-lb-group)# restricted
Router(config-lb-group)#
Related Commands Command Description
cable load-balance Configures a DOCSIS load balancing group on the CMTS.
docsis-group
show cable Displays real-time configuration, statistical, and operational information
load-balance for load balancing operations on the router.
docsis-group
Cisco IOS CMTS Cable Command Reference
CBL-1074 OL-15510-15
Cable Commands: q through sg
revertive
revertive
To enable the revert operation on a protect card, use the revertive command in line card redundancy
group mode.
revertive time
no revertive time
Syntax Description time Specifies the revert operation time in minutes. The valid values are 1 to
35791.
Command Default None
Command Modes Line card redundancy group (config-red-lc)
Command History Release Modification
12.2(33)SCA This command was introduced in Cisco IOS Release 12.2(33)SCA.
Examples The following example shows how to specify the revert operation time for a protect card on a uBR10012
router:
Router# configure terminal
Router(config)# redundancy
Router(config-red)# linecard-group 1 cable
Router(config-red-lc)# revertive 30
Related Commands Command Description
linecard-group Creates a line card group for one-to-one line card redundancy.
redundancy Enters redundancy mode.
member subslot Enables the redundancy role of a line card.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1075
Cable Commands: q through sg
rf-channel cable downstream channel-id
rf-channel cable downstream channel-id
To assign a downstream channel ID to an RF channel, use the rf-channel cable downstream channel-id
command in controller configuration mode. To remove a downstream channel ID for an RF channel, use
the no form of this command.
rf-channel rf-port cable downstream channel-id channel-id
no rf-channel rf-port cable downstream channel-id channel-id
Syntax Description rf-port Specifies the RF channel physical port on the Wideband SPA FPGA. Valid
values for rf-port depend on the configuration set with the annex
modulation command.
channel-id A unique channel ID. Valid values for releases prior to Cisco IOS Release
12.2(33)SCB are from 0 to 255 and the valid values for Cisco IOS Release
12.2(33)SCB and later are from 1 to 255 as 0 is reserved for network
management.
Command Default If the rf-channel cable downstream channel-id command is not issued, Cisco IOS software assigns a
unique downstream channel ID to the RF channel.
Command Modes Controller configuration (config-controller)
Command History Release Modification
12.3(21)BC This command was introduced for the Cisco uBR10012 router.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
12.2(33)SCB1 The downstream channel ID scheme was changed.
Usage Guidelines For the wideband channel to work correctly, each RF channel on the fiber node that the wideband
channel uses must have a unique downstream channel ID. By default, Cisco IOS software assigns a
unique downstream channel ID to the RF channel. Use the rf-channel cable downstream channel-id
command to change the default channel ID.
The downstream channel ID that is assigned to the RF channel must be unique on the fiber node.
• The ID cannot be the same ID as is used for another RF channel on the fiber node.
• The ID cannot be the same ID as is used for a primary downstream channel on the fiber node.
You can check downstream channel IDs that are being used by examining the CMTS router
configuration file.
Refer to cable downstream channel-id id command for the updated downstream channel ID scheme
table.
Cisco IOS CMTS Cable Command Reference
CBL-1076 OL-15510-15
Cable Commands: q through sg
rf-channel cable downstream channel-id
Note If you assign a downstream channel ID that is not unique on the fiber node, the rf-channel cable
downstream channel-id command displays an error message. The command does assign the channel
ID, but the status of the fiber node becomes invalid.
The Cisco uBR10012 router supports two Wideband SPAs. Each Wideband SPA supports up to 24 RF
channels depending on how the SPA is configured with the annex modulation command.
• For annex A and 256 QAM, each Wideband SPA supports 18 RF channels. In this case, valid values
for the rf-port argument are 0 to 17.
• For all other cases, the SPA supports 24 RF channels. In these cases, valid values for the rf-port
argument are 0 to 23.
Note Effective with Cisco IOS Release 12.3(23)BC, the annex modulation command is obsolete and annex
and modulation are included as keyword options in the rf-channel frequency command. Also, for
annex A and 256 QAM, each Wideband SPA supports up to 18 RF channels at full rate or up to 24 RF
channels at less than full rate.
Examples The following example shows how to assign a downstream channel ID of 123 to RF channel 3 on the
Wideband SPA located in slot/subslot/bay 1/0/1.
Router# configure terminal
Router(config)# controller modular-cable 1/0/1
Router(config-controller)# rf-channel 3 cable downstream channel-id 123
Related Commands Command Description
annex modulation Sets the annex and modulation for the Wideband SPA.
cable primary Specifies that a wideband channel is a primary wideband channel.
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.
ip-address (controller) Sets the IP address of the Wideband SPA FPGA.
modular-host subslot Specifies the modular-host line card.
rf-channel frequency Sets the frequency for each RF channel.
rf-channel ip-address Sets the IP address, MAC address and UDP port for each RF channel.
mac-address udp-port
rf-channel network delay Specifies the CIN delay for each RF channel.
rf-channel description Specifies the description for each RF channel.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1077
Cable Commands: q through sg
rf-channel depi-tunnel
rf-channel depi-tunnel
To bind the depi-tunnel, which inherits the configuration of the specified l2tp-class and depi-class, to an
rf-channel on a shared port adapter (SPA), use the rf-channel depi-tunnel command in controller
configuration mode. The tsid keyword is used to associate the logical rf-channel of the SPA to a physical
quadrature amplitude modulation (QAM) on the radio frequency gateway (RFGW-10). To unbind the
depi-tunnel, use the no form of this command.
rf-channel rf-channel depi-tunnel depi-tunnel-name tsid id
no rf-channel rf-channel depi-tunnel depi-tunnel-name [tsid id]
Syntax Description rf-channel RF channel physical port on the Wideband SPA. The allowed range is from
0 to 3.
depi-tunnel-name Name of the DEPI tunnel.
tsid id TS ID value.
Command Default This command has no default behavior or values.
Command Modes Global configuration (config)
Subinterface configuration (config-subif)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines To configure DEPI on the M-CMTS, bind the depi-tunnel to an rf-channel on a SPA using the rf-channel
depi-tunnel command in controller configuration mode. To associate the logical rf-channel on the SPA
to a QAM on the RFGW, use the tsid keyword.
Examples The following example shows how to bind the depi-tunnel SPA0 to rf-channel 0 on a SPA and associate
tsid 100 to the QAM:
Router# configure terminal
Router(config)# controller modular-cable 1/0/0
Router(config-controller)# rf-channel 0 depi-tunnel SPA0 tsid 100
Cisco IOS CMTS Cable Command Reference
CBL-1078 OL-15510-15
Cable Commands: q through sg
rf-channel depi-tunnel
Related Commands Command Description
controller Specifies the slot, bay, and port to be configured.
modular-cable
show interface Displays the DEPI information for the modular cable.
modular-cable
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1079
Cable Commands: q through sg
rf-channel description
rf-channel description
To configure the description of an RF channel on a Wideband SPA, use the rf-channel description
command in controller configuration mode. To remove an RF channel configuration, use the no form of
this command.
rf-channel rf-port description description
no rf-channel rf-port description description
Syntax Description rf-port Specifies the RF channel physical port on the Wideband SPA FPGA.
Allowed range is 0 to 23. Valid values for rf-port depend on the
configuration set with the annex modulation command (see the Usage
Guidelines section).
description Specifies a description for the RF channel.
Command Default No default RF channel configuration values are set for the description.
Command Modes Controller configuration (config-controller)
Command History Release Modification
12.3(21)BC This command was introduced for the Cisco uBR10012 router.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
Usage Guidelines The Cisco uBR10012 router supports two Wideband SPAs. Each Wideband SPA supports up to 24 RF
channels depending on how the SPA is configured with the annex modulation command. For annex A
and 256 QAM, each Wideband SPA supports up to 18 RF channels at full rate and up to 24 RF channels
at less than full rate. For all other cases, the SPA supports 24 RF channels.
Note In Cisco IOS Release 12.3(21)BC, annex and modulation parameters were set globally for each SPA
using the annex modulation command.
Beginning in Cisco IOS Release 12.3(23)BC, annex and modulation values are set for each RF channel
using the rf-channel frequency command. The annex modulation command is obsolete.
Examples The following example shows how to configure the description of the RF channel characteristics for RF
port 0:
Router# configure terminal
Router(config)# controller modular-cable 1/0/0
Router(config-controller)# rf-channel 0 description Primary downstream channel
Cisco IOS CMTS Cable Command Reference
CBL-1080 OL-15510-15
Cable Commands: q through sg
rf-channel description
Related Commands Command Description
cable primary Specifies that a wideband channel is a primary
wideband channel.
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.
ip-address (controller) Sets the IP address of the Wideband SPA FPGA.
modular-host subslot Specifies the modular-host line card for Wideband
protocol operations.
rf-channel cable downstream channel-id Assigns a downstream channel ID to an RF channel.
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 Configures the network delay for an RF channel.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1081
Cable Commands: q through sg
rf-channel frequency
rf-channel frequency
To configure the frequency of an RF channel on a wideband interface, use the rf-channel frequency
command in controller configuration mode. To remove the frequency of an RF channel configuration,
use the no form of this command.
Cisco IOS Releases 12.3(21)BC and 12.2(33)SCA
rf-channel rf-port frequency freq
no rf-channel rf-port frequency
Cisco IOS Releases 12.3(23)BC and 12.2(33)SCB
rf-channel rf-port frequency freq [annex {A | B} modulation {64 | 256}
[interleave-depth {8 | 12 | 16 | 32 | 64 | 128}]]
no rf-channel rf-port frequency
Syntax Description rf-port Specifies the RF channel physical port on the Wideband SPA FPGA.
Allowed range is 0 to 23. Valid values for rf-port depend on the
configuration set with the annex modulation command (see the
Usage Guidelines section).
freq Sets the center frequency for the RF channel. Allowed range is
55000000 to 1050000000 MHz.
annex {A|B} Specifies the MPEG framing format for each RF channel:
• A–Annex A. The downstream is compatible with the European
MPEG framing format specified in ITU-TJ.83 Annex A.
• B–Annex B. The downstream is compatible with the North
American MPEG framing format specified in ITU-TJ.83 Annex
B.
modulation {64|256} Specifies the modulation rate for each RF channel:
• 64–64-QAM
• 256–256-QAM
interleave-depth{8 | 12 | 16 | Indicates the downstream interleave depth. The default value is 32.
32 | 64 |128}
Command Default No default RF channel configuration values are set for frequency, annex, and modulation.
Command Modes Controller configuration (config-controller)
Cisco IOS CMTS Cable Command Reference
CBL-1082 OL-15510-15
Cable Commands: q through sg
rf-channel frequency
Command History Release Modification
12.3(21)BC This command was introduced for the Cisco uBR10012 router.
12.3(23)BC The following keyword options were added:
• annex
• modulation
• interleave-depth
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. The annex,
modulation, and interleave-depth keyword options are not supported.
12.2(33)SCB The annex, modulation, and interleave-depth keyword options are supported.
Usage Guidelines Cisco IOS Release 12.3(21)BC and Cisco IOS Release 12.2(33)SCA
This command configures the frequency for an RF channel on a Wideband SPA.
The Cisco uBR10012 router supports two Wideband SPAs. Each Wideband SPA supports up to 24 RF
channels depending on how the SPA is configured with the annex modulation command. For annex A
and 256 QAM, each Wideband SPA supports up to 18 RF channels. For all other cases, the SPA supports
up to 24 RF channels.
Note In Cisco IOS 12.3(21)BC and 12.3(21a)BC3 releases, annex and modulation parameters were set
globally for each SPA using the annex modulation command.
Beginning in Cisco IOS Release 12.3(23)BC, annex and modulation values are set for each RF channel
using the rf-channel frequency command. The annex modulation command is obsolete.
Cisco IOS Releases 12.3(23)BC and 12.2(33)SCB
This command configures the frequency for an RF channel on a Wideband SPA. The Cisco uBR10012
router supports two Wideband SPAs. Each Wideband SPA supports up to 24 RF channels. For annex A
and 256 QAM, each Wideband SPA supports up to 18 RF channels at full rate. For all other cases, the
SPA supports up to 24 RF channels.
For each RF channel, use the rf-channel frequency command in controller configuration mode to
configure RF-channel characteristics. For Cisco IOS Release 12.3(21)BC, for each RF channel (rf-port),
the frequency option must be configured with the rf-channel frequency command.
Uniqueness of frequency is required for all cable downstream channels on all cable interfaces and all
Wideband SPAs on the CMTS.
Note Be certain to verify that the RF channel values set with rf-channel frequency match the values
configured for the QAM outputs on the edge QAM device.The frequency value must match. If the value
does not match, the Wideband SPA will not successfully communicate with the edge QAM device.
Cisco IOS Release 12.2(33)SCE
In Cisco IOS Release 12.2(33)SCE and later, changing the frequency of a single RF channel in a
controller will change the frequency of all RF channels in that controller. In the event of the frequency
change, all DOCSIS 3.0 cable modems will start re-registering in downstream partial service mode
(p-online).
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1083
Cable Commands: q through sg
rf-channel frequency
Examples The following example shows how to configure RF channel frequency for RF port 0:
Router# configure terminal
Router(config)# controller modular-cable 1/0/0
Router(config-controller)# rf-channel 0 frequency 699000000 annex A modulation 256
interleave-depth 64
Related Commands Command Description
cable primary Specifies that a wideband channel is a primary wideband channel.
controller modular-cable Enters controller configuration mode to configure the Wideband
SPA controller.
rf-channel description Specifies the description for each RF channel.
rf-channel ip-address Sets the IP address, MAC address and UDP port for each RF
mac-address udp-port channel.
rf-channel network-delay Configure the network delay for an RF channel.
Cisco IOS CMTS Cable Command Reference
CBL-1084 OL-15510-15
Cable Commands: q through sg
rf-channel ip-address mac-address udp-port
rf-channel ip-address mac-address udp-port
To configure the IP address, MAC address, UDP port and DEPI remote ID of an RF channel on a
Wideband SPA, use the rf-channel ip-address mac-address udp-port command in controller
configuration mode. To remove the IP address, MAC address, UDP port and DEPI remote ID
configuration of an RF channel, use the no form of this command.
Cisco IOS Releases 12.3(21)BC and 12.2(33)SCA
rf-channel rf-port ip-address ip-address mac-address mac-address udp-port portnum
no rf-channel rf-port ip-address ip-address mac-address mac-address udp-port portnum
Cisco IOS Releases 12.3(23)BC and 12.2(33)SCB
rf-channel rf-port ip-address ip-address mac-address mac-address {udp-port portnum |
depi-remote-id session-id}
no rf-channel rf-port ip-address ip-address mac-address mac-address {udp-port portnum |
depi-remote-id session-id}
Syntax Description rf-port Specifies the RF channel physical port on the Wideband SPA FPGA.
Allowed range is 0 to 23. Valid values for rf-port depend on the
configuration set with the annex modulation command (see the
Usage Guidelines section).
ip-address Specifies the IP address of the Gigabit Ethernet interface on the edge
QAM device for this RF channel.
mac-address Specifies the MAC address of the next-hop interface or of the edge
QAM device for this RF channel.
portnum Specifies the UDP port number for the edge QAM device that will be
used for this RF channel. Allowed range is 0 to 65535.
session-id Specifies the DEPI remote session ID to be used for encapsulation of
frames in DOCSIS-MPT mode.
Command Default No default RF channel configuration values are set.
Command Modes Controller configuration (config-controller)
Command History Release Modification
12.3(21)BC This command was introduced for the Cisco uBR10012 router.
12.3(23)BC The depi-remote-id keyword option was added.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. The
depi-remote-id keyword option is not supported.
12.2(33)SCB The depi-remote-id keyword option is supported.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1085
Cable Commands: q through sg
rf-channel ip-address mac-address udp-port
Usage Guidelines For each RF channel, use the rf-channel ip-address mac-address udp-port command in controller
configuration mode to configure RF-channel characteristics.
The Cisco uBR10012 router supports two Wideband SPAs. Each Wideband SPA supports up to 24 RF
channels depending on how the SPA is configured with the annex modulation command. For annex A
and 256 QAM, each Wideband SPA supports up to18 RF channels. For all other cases, the SPA supports
up to 24 RF channels.
Note In the Cisco IOS Release 12.3(21)BC and 12.3(21a)BC3 releases, annex and modulation parameters
were set globally for each SPA using the annex modulation command.
Beginning in Cisco IOS Release 12.3(23)BC, annex and modulation values are set for each RF channel
using the rf-channel frequency command. The annex modulation command is obsolete.
For each RF channel (rf-port), the following items must be configured with rf-channel ip-address
mac-address udp-port command:
Cisco IOS Release 12.3(21)BC and Cisco IOS Release 12.2(33)SCA
• IP address
• MAC address
• UDP port
• Associated wideband channel (see the cable rf-channel command)
Cisco IOS Releases 12.3(23)BC and 12.2(33)SCB
• IP address
• MAC address
• UDP port or DEPI remote ID
• Associated wideband channel (see the cable rf-channel command)
The value used for mac-address in the mac-address argument is as follows:
• If a Gigabit Ethernet router or Layer 3 switch is used between the Wideband SPA and the edge QAM
device, the value specified for mac-address is the MAC address for the next-hop interface on the
router or Layer 3 switch.
• If a Gigabit Ethernet router or Layer 3 switch is not used, the value specified for mac-address is the
MAC address for the Gigabit Ethernet interface on the edge QAM device.
The UDP port number set for the RF channel allows mapping an input UDP session to a specific QAM
output port. Wideband traffic from different Wideband SPAs cannot be mixed on the same QAM output
ports.
Note Be certain to verify that the RF channel values set with rf-channel frequency match the values
configured for the QAM outputs on the edge QAM device. IP address, MAC address, UDP port, and
DEPI remote ID must match. If any of these values do not match, the Wideband SPA will not
successfully communicate with the edge QAM device.
Examples The following example shows how to configure the RF channel IP address, MAC address UDP port and
DEPI remote ID characteristics for RF port 0:
Router# configure terminal
Router(config)# controller modular-cable 1/0/0
Cisco IOS CMTS Cable Command Reference
CBL-1086 OL-15510-15
Cable Commands: q through sg
rf-channel ip-address mac-address udp-port
Router(config-controller)# rf-channel 0 ip-address 192.168.200.30 mac-address
0011-920e-a9ff udp-port 49152
Related Commands Command Description
cable primary Specifies that a wideband channel is a primary wideband channel.
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.
ip-address (controller) Sets the IP address of the Wideband SPA FPGA.
modular-host sub-slot Specifies the modular-host line card for Wideband protocol
operations.
rf-channel cable downstream Assigns a downstream channel ID to an RF channel.
channel-id
rf-channel description Specifies the description for each RF channel.
rf-channel frequency Sets the frequency for each RF channel.
rf-channel network delay Configures the network delay for an RF channel.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1087
Cable Commands: q through sg
rf-channel network-delay
rf-channel network-delay
To configure the network delay for an RF channel on a Wideband SPA, use the rf-channel network
delay command in controller configuration mode. To remove the network delay configuration for an RF
channel, use the no form of this command.
rf-channel rf-port network-delay delay [sampling-rate rate]
no rf-channel rf-port network-delay delay [sampling-rate rate]
Syntax Description rf-port RF channel physical port on the Wideband SPA FPGA.
The allowed range is from 0 to 23. The valid values for
rf-port depend on the configuration set with the annex
modulation command (see the Usage Guidelines section).
delay Converged Interconnect Network (CIN) delay. The default
value is 550 us. The allowed range is from 0 to 3000 us.
The delay value auto determines the delay through DEPI
Latency Measurement (DLM) packets.
sampling-rate (Optional) Specifies how often the DLM is sent. The
allowed range is from 1 to 500 sec. The default value is 10
sec. This option is available only when the delay value is
set to auto.
rate Sampling-rate value.
Command Default No default RF channel network delay configuration values are set.
Command Modes Controller configuration (config-controller)
Command History Release Modification
12.3(23)BC This command was introduced for the Cisco uBR10012 universal broadband router.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.2(33)SCB.
12.2(33)SCC This command was modified to include sampling-rate rate to specify how often the
DLM is sent.
Usage Guidelines The Cisco uBR10012 universal broadband router supports two Wideband SPAs. Each Wideband SPA
supports up to 24 RF channels depending on how the SPA is configured with the annex modulation
command. For annex A and 256 QAM, each Wideband SPA supports up to18 RF channels. For all other
cases, the SPA supports up to 24 RF channels.
Cisco IOS CMTS Cable Command Reference
CBL-1088 OL-15510-15
Cable Commands: q through sg
rf-channel network-delay
Note In Cisco IOS releases 12.3(21) BC and 12.3(21a)BC3, annex and modulation parameters were set
globally for each SPA using the annex modulation command.
From Cisco IOS Release 12.3(23)BC onwards, annex and modulation values are set for each RF channel
using the rf-channel frequency command. The annex modulation command is obsolete.
Examples The following example shows how to configure the RF channel network delay characteristics for RF port
0:
Router# configure terminal
Router(config)# controller modular-cable 1/0/0
Router(config-controller)# rf-channel 0 network-delay 1000
The following example shows how to configure the RF channel network delay characteristics for RF port
0 with a sampling-rate of 1sec:
Router# configure terminal
Router(config)# controller modular-cable 1/0/0
Router(config-controller)# rf-channel 0 network-delay auto sampling-rate 1
Related Commands Command Description
cable primary Specifies that a wideband channel is a primary
wideband channel.
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.
ip-address (controller) Sets the IP address of the Wideband SPA FPGA.
modular-host subslot Specifies the modular-host line card for Wideband
protocol operations.
rf-channel cable downstream channel-id Assigns a downstream channel ID to an RF channel.
rf-channel description Specifies the description for each RF channel.
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.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1089
Cable Commands: q through sg
rf-channel rf-power
rf-channel rf-power
To set the RF power output level on Cisco UBR-MC20X20V and Cisco uBR-MC88V cable interface
line cards, use the rf-channel rf-power command in controller configuration mode. To reset the RF
output power level to its default value, use the no form of this command.
rf-channel rf-port rf-power power-level
no rf-channel rf-port rf-power power-level
Syntax Description rf-port RF channel physical port on the Wideband SPA FPGA. The valid
range is from 0 to 3. Valid values for rf-port depend on the
configuration set with the annex modulation command.
power-level Desired RF output power level in dBmV. The valid range is
dependent on the cable interface line card. The format is XY.Z. By
default, .Z is added as .0.
Command Default None
Command Modes Controller configuration (config-controller)
Command History Release Modification
12.2(33)SCC This command was introduced.
12.2(33)SCD This command was modified to support configuration of the controller interface on
Cisco uBR7246VXR and Cisco uBR7225VXR universal broadband routers.
Usage Guidelines For the Cisco UBR-MC20X20V cable interface line card, all the channels within a controller must have
the same RF power value. When the RF power value is changed on any one channel, the same value is
applied to all the channels within the controller. The recommended RF power range depends on the mode
of the upconverter. The mode of the upconverter is decided by the highest numbered channel that is
enabled.
Note RF power value outside the recommended RF power range is accepted but is automatically adjusted. If
the input value exceeds the recommended RF power range, it is adjusted to a value lower than the upper
limit of the range and if it is less than the recommended range, it is adjusted to a value higher than the
lower limit of the range. The RF power level can be configured in decimals too.
Table 36 lists the recommended RF power range for different channel settings on the
Cisco UBR-MC20X20V line card.
Cisco IOS CMTS Cable Command Reference
CBL-1090 OL-15510-15
Cable Commands: q through sg
rf-channel rf-power
Table 36 RF Power Range on the Cisco UBR-MC20X20V Line Card
Upconverter Mode Channel Setting Recommended RF Power Range
Single Only channel 0 is enabled 60.0 to 52.0 dBmV
Dual Channel 0 is either enabled or 56.0 to 48.0 dBmV
disabled. Channel 1 is enabled.
Channel 2 and channel 3 are
disabled.
Triple Channel 0, and channel 1 are 54.0 to 46.0 dBmV
either enabled or disabled.
Channel 2 is enabled and
channel 3 is disabled.
Quad Channels 0, 1, and 2 are either 52.0 to 44.0 dBmV
enabled or disabled. Channel 3 is
enabled.
Table 37 lists the recommended RF power range for different channel settings on the
Cisco uBR-MC88V line card.
Table 37 RF Power Range on the Cisco uBR-MC88V Line Card
Upconverter Mode Channel Setting Recommended RF Power Range
Single The RF channel stacking number 45 to 63 dBmV
equals to 1 in this mode. Channel
0 is enabled while the other
channels are disabled.
Dual The RF channel stacking number 48 to 56 dBmV
equals to 2 in this mode.
Channels 0 and 1 are enabled;
channels 2 and 3 are disabled.
Triple The RF channel stacking number 46 to 54 dBmV
equals to 3 in this mode.
Channels 0, 1, and 2 are enabled;
channel 3 is disabled.
Quad The RF channel stacking number 44 to 52 dBmV
equals to 4. Channels 0, 1, 2, and
3 are enabled.
Examples The following example shows how to configure RF power for RF port 0 in modular-cable controller
mode:
Router# configure terminal
Router(config)# controller modular-cable 1/0/0
Router(config-controller)# rf-channel 0 rf-power 50.6
The following example shows how to configure RF power for RF port 0 in integrated-cable controller
mode:
Router# configure terminal
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1091
Cable Commands: q through sg
rf-channel rf-power
Router(config)# controller integrated-cable 1/0/0
Router(config-controller)# rf-channel 0 rf-power 50.6
Related Commands Command Description
cable primary Specifies that a wideband channel is a primary wideband channel.
controller modular-cable Enters controller configuration mode to configure the Wideband
SPA controller.
controller integrated-cable Enters integrated-cable controller configuration mode.
rf-channel description Specifies the description for each RF channel.
rf-channel ip-address Sets the IP address, MAC address and UDP port for each RF
mac-address udp-port channel.
rf-channel frequency Configures the frequency for the RF channel.
rf-channel network-delay Configure the network delay for an RF channel.
rf-channel rf-shutdown Enables or disables RF output on a Wideband SPA.
Cisco IOS CMTS Cable Command Reference
CBL-1092 OL-15510-15
Cable Commands: q through sg
rf-channel rf-shutdown
rf-channel rf-shutdown
To disable the RF output on a wideband interface, use the rf-channel rf-shutdown command in
controller configuration mode. To enable the RF output, use the no form of this command.
rf-channel rf-port rf-shutdown
no rf-channel rf-port rf-shutdown
Syntax Description rf-port Specifies the RF channel physical port. Allowed range is from 0 to 3.
Valid values for rf-port depend on the configuration set with the
annex modulation command.
Command Default RF output is disabled.
Command Modes Controller configuration (config-controller)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines Starting with Cisco IOS Release 12.2(33)SCE, when you use the rf-channel rf-shutdown command, all
DOCSIS 3.0 cable modems associated with the RF channel on a particular wideband interface will go
offline and start re-registering in downstream partial service mode (p-online). In Cisco IOS Release
12.2(33)SCD and earlier, cable modems do not go offline while using the rf-channel rf-shutdown
command.
For muting and unmuting the QAM on the Cisco RFGW-10, use the rf-channel rf-shutdown command
in the M-CMTS.
Examples The following example enables RF output on the Cisco wideband SPA:
Router# enable
Router# configure terminal
Router(config)# controller integrated-cable 7/1/0
Router(config-controller)# no rf-channel 0 rf-shutdown
Related Commands Command Description
controller modular-cable Enters controller configuration mode to configure the Wideband SPA
controller.
controller integrated-cable Enters integrated-cable controller configuration mode.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1093
Cable Commands: q through sg
rf-channel rf-shutdown
Command Description
rf-channel network-delay Configure the network delay for an RF channel.
rf-channel rf-power Sets the RF power output level on the Cisco UBR-MC20X20V cable
interface line card.
Cisco IOS CMTS Cable Command Reference
CBL-1094 OL-15510-15
Cable Commands: q through sg
rf-channel stacking
rf-channel stacking
To suppress a carrier or mute a radio frequency (RF) channel on the Cisco uBR-MC88V cable interface
line card, use the rf-channel stacking command in controller configuration mode. To remove the
configuration, use the no form of this command.
rf-channel stacking stacking-number
no rf-channel stacking stacking-number
Syntax Description stacking-number RF channel stacking number. The valid range is from 1 to 4. The default value
is 4.
Command Default The RF channel stacking number is set to 4.
Command Modes Controller configuration (config-controller)
Command History Release Modification
12.2(33)SCD This command was introduced.
Usage Guidelines If you change the default stacking number configuration, traffic loss may occur on the active channels.
For example, if you change the stacking number from 4 to 2, traffic is interrupted on the RF channels 0
and 1. However, traffic loss does not occur if you do not change the stacking number configuration when
shutting down an RF channel using the rf-channel rf-shutdown command.
Note We recommend that you do not change the default stacking number configuration. You can change the
default configuration when you want RF diagnostics performed on a particular channel. For example, if
you want to perform RF diagnostics on RF channel 2, you need to change the default stacking number
configuration to 2 to completely mute this channel.
Examples The following example shows how to configure the RF channel stacking number for the
Cisco uBR-MC88V cable interface line card:
Router# configure terminal
Router(config)# controller integrated-cable 5/1
Router(config-controller)# rf-channel stacking 3
Related Commands Command Description
rf-channel rf-shutdown Disables the RF output on a Cisco Wideband SPA, or a cable
interface line card.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1095
Cable Commands: q through sg
secondary aux
secondary aux
To enable the auxiliary port on the standby PRE1 module, use the secondary aux command in
redundancy configuration (main-cpu) mode. To disable the auxiliary port, use the no form of this
command.
secondary aux
no secondary aux
Syntax Description This command has no keywords or arguments.
Command Default The auxiliary port on the standby PRE1 module is disabled.
Command Modes Redundancy configuration, main-cpu mode
Command History Release Modification
12.2(11)BC3 This command was introduced for the Cisco uBR10012 router.
Examples The following example shows how to enable the auxiliary port on the standby PRE1 module.
Router# config t
Router(config)# redundancy
Router(config-r)# main-cpu
Router(config-r-mc)# secondary aux
Router(config-r-mc)# exit
Router(config-f)# exit
Router(config)#
Related Commands Command Description
main-cpu Enters main-CPU redundancy configuration mode, so that you can
configure the synchronization of the active and standby Performance
Routing Engine (PRE1) modules.
redundancy Configures the synchronization of system files between the active and
standby PRE1 modules.
redundancy Forces a manual switchover between the active and standby PRE1 modules.
force-failover
main-cpu
Cisco IOS CMTS Cable Command Reference
CBL-1096 OL-15510-15
Cable Commands: q through sg
service-class (cmts-tag)
service-class (cmts-tag)
To configure the specified service class name for the CMTS tag, use the service-class command in the
cmts-tag configuration mode. To remove the configured service class name from the CMTS tag, use the
no form of this command.
[exclude] service-class service-class-name
no service-class service-class-name
Syntax Description exclude (Optional) Configures the CMTS tag to exclude the specified service class
name.
service-class-name Service class name with matching rule
Command Default No default behavior or values.
Command Modes CMTS tag mode (cmts-tag)
Command History Release Modification
12.2(33)SCC This command was introduced.
Examples The following example shows how to configure the specified service class name for the CMTS tag using
the service-class command:
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# cable tag 1
Router(cmts-tag)# service-class uBR
Related Commands Command Description
cable load-balance To configure a DOCSIS load balancing group on the CMTS.
docsis-group
show cable To display real-time configuration, statistical and operational information
load-balance for load balancing operations on the router.
docsis-group
cable tag To configure a tag for a DOCSIS load balancing group on the CMTS.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1097
Cable Commands: q through sg
service-class (enforce-rule)
service-class (enforce-rule)
To identify a particular service class for cable modem monitoring in an enforce-rule, use the
service-class (enforce-rule) command in enforce-rule configuration mode. To remove the service class
from the enforce-rule, use the no form of this command.
service-class {enforced | registered} name
no service-class {enforced | registered} name
Syntax Description enforced Specifies an enforced service class.
registered Specifies enforcing of QoS profiles for the registered service class.
name Specifies the name of the service class.
Command Default No default behavior or values
Command Modes Enforce-rule configuration (enforce-rule)
Command History Release Modification
12.3(9a)BC This command was introduced.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines The service-class (enforce-rule) command allows operators to identify the name of the initial registered
service class for a CM in an enforce-rule, and also the name of a new service class to be enforced if the
CM violates its registered service parameters.
Examples The following example shows specification of the enforced service class called “test” in an enforce-rule:
Router(enforce-rule)# service-class enforced test
Related Commands Command Description
cable qos enforce-rule Creates an enforce-rule to enforce a particular QoS profile for subscriber
traffic management and enters enforce-rule configuration mode.
debug cable Displays enforce-rule debug messages for subscriber traffic management on
subscriber-monitoring the Cisco CMTS routers.
duration Specifies the time period and sample rate to be used for monitoring
subscribers.
enabled (enforce-rule) Activates an enforce-rule and begins subscriber traffic management on a
Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
CBL-1098 OL-15510-15
Cable Commands: q through sg
service-class (enforce-rule)
Command Description
monitoring-basics Specifies the type of monitoring desired for subscriber traffic management
on a Cisco CMTS router.
peak-time1 Specifies peak and offpeak monitoring times on a Cisco CMTS router.
qos-profile registered Specifies the registered QoS profile that should be used for this enforce-rule.
show cable qos Displays the QoS enforce-rules that are currently defined.
enforce-rule
show cable Displays subscribers who are violating their registered QoS profiles.
subscriber-usage
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1099
Cable Commands: q through sg
service divert-rate-limit
service divert-rate-limit
Note Effective with Cisco IOS Release 12.2(33)SCB, the service divert-rate-limit fib-rp-glean command is
replaced on the WAN-side by the service divert-rate-limit ip fib-rp-glean command. See the
service divert-rate-limit ip command for more information. The service divert-rate-limit fib-rp-glean
command is replaced on the WAN-side non-IP by service divert-rate-limit non-ip fib-rpf-glean
command. See the service divert-rate-limit non-ip command for more information. For cable-side
DRL configuration, see the cable divert-rate-limit command.
To configure PXF Divert-Rate-Limit, use the service divert-rate-limit command in interface
configuration mode. To reset this feature to the default parameters, use the no form of this command.
service divert-rate-limit divert-code rate [limit limit]
no service divert-rate-limit divert-code
Syntax Description divert-code rate Configures the PXF Divert-Rate-Limit for the any of the following packets:
• fwd-glean—Packets that hit a glean adjacency in the FIB.
• rpf-glean—Packets that hit a glean adjacency during the RPF check.
The minimum rate is 1 packet-per-second and the maximum rate is 255
packets-per-second.
The default rate is 20 packets-per-second.
limit limit (Optional) Sets the limit for the number of packets that will be diverted in an
initial burst of packets.
The minimum limit is 4 packets and the maximum limit is 255 packets.
The default limit is 5 packets.
Note Setting the limit has a limited effect on the behavior of the
algorithm, so this part of the CLI is hidden.
Defaults Divert-Rate-Limit contains the following default behavior and values:
• Divert-Rate-Limit is always active.
• The default rate is 20 packets-per-second.
• The default limit is 5 packets.
Command Modes Interface configuration—cable interface only (config-if)
Cisco IOS CMTS Cable Command Reference
CBL-1100 OL-15510-15
Cable Commands: q through sg
service divert-rate-limit
Command History 12.3(17a)BC The command was introduced for the Cisco uBR7246VXR and
Cisco uBR10012 universal broadband routers.
12.2(33)SCA This command was integrated into Cisco IOS release 12.2(33)SCA.
Support for the Cisco uBR7225VXR router was added.
12.2(33)SCB This command was replaced by the service divert-rate-limit ip
fib-rp-glean command and service divert-rate-limit non-ip fib-rpf-glean
command.
Usage Guidelines The service divert-rate-limit command is used to configure the PXF Divert-Rate-Limit for fwd-glean
and rpf-glean packets in order to identify packet streams that will cause congestion of the FP-to-RP
interface.
Examples The following example shows how to configure rate-limiting for fib-rp-glean, with a rate of 10
packets-per-second and a limit of 20 packets:
Router(config-if)# service divert-rate-limit fib-rp-glean 10 limit 20
The following example shows how to return rate-limiting for fib-rp-glean to the default values:
Router(config-if)# no service divert-rate-limit fib-rp-glean
Pass and fail counters are kept for fwd-glean, rpf-glean, and cable-ARP packets. To show the statistics
for the pass and fail counter, use the show pxf cpu statistics drl command:
Router(config-if)# show pxf cpu statistics drl
Divert-Rate-Limit statistics
code total diverted dropped
fib_rpf_glean 500 59 441
fib_rp_glean 500 54 446
arp_filter 0 0 0
Note The arp_filter stats shown above are global stats for PXF ARP Filtering. These stats cannot be cleared
by the CLI. However, they will reset to zero upon reload.
Packets dropped by Divert-Rate-Limit and the ARP Filter will be recorded in the regular PXF drop
statistics:
Router(config-if)# show pxf cpu statistics drop c5/0/0
FP drop statistics for Cable5/0/0
packets bytes
vcci undefined 0 0
vcci C
...
divert_rate_limit 441 28224
arp_filter_reply 0 0
arp_filter_request 0 0
Related Commands Command Description
show cable arp-filter Displays the total number of Address Resolution Protocol (ARP)
offenders.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1101
Cable Commands: q through sg
service divert-rate-limit ip
service divert-rate-limit ip
To set DRL rate and limit for WAN-side IP packet streams, use the service divert-rate-limit ip
command in global configuration mode. To reset the rate and limit to the default values for all IP
divert-codes, use the no form of this command. Using no service divert-rate-limit ip divert-code will
reset rate and limit to the default values for the specified divert code.
service divert-rate-limit ip divert-code rate rate limit limit
no service divert-rate-limit ip
Syntax Description divert code Specifies the applicable divert code.
rate Specifies the divert rate in packets per second. Minimum rate is 1 packet per
second. Maximum rate is 65535 packets per second.
For WAN-side IP packets, the default rate is 4000 packets per second
limit Specifies the number of packets to be diverted in an initial burst of packets.
Minimum limit is 4 packets. Maximum limit is 4194 packets.
For WAN-side IP packets, the default limit is 4000 packets.
Command Default For WAN-side IP packet streams, the default rate is 4000 packets per second and default limit is 4000
packets. These defaults apply to each uniquely identified IP packet stream.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCB This command was introduced.
The service divert-rate-limit ip fib-rp-glean command is the WAN-side
replacement for the service divert-rate limit fib-rp-glean command.
Usage Guidelines You can configure a rate and limit for a particular IP divert-code for WAN-side IP packets. However,
each IP packet-stream is uniquely identified (using a hash of the VRF, the IP source address, and the
divert-code), and then packets in that stream are sent through a rate-limiter with the configured rate and
limit.
Examples The following example shows how to set the rate and limit for the specified divert code:
Router(config)# service divert-rate-limit ip fib-rp-glean rate 1 limit 4
Related Commands
Cisco IOS CMTS Cable Command Reference
CBL-1102 OL-15510-15
Cable Commands: q through sg
service divert-rate-limit ip
Command Description
service This command configures DRL for WAN-side non-IP packet streams.
divert-rate-limit
non-ip
service This command adds entries to the trusted site list.
divert-rate-limit
trusted-site
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1103
Cable Commands: q through sg
service divert-rate-limit ipv6
service divert-rate-limit ipv6
To set the divert rate limit (DRL) rate and limit for WAN-side IPv6 packet streams, use the service
divert-rate-limit ipv6 command in global configuration mode.
service divert-rate-limit ipv6 divert-code rate rate limit limit
no service divert-rate-limit ipv6
Syntax Description divert-code Specifies the applicable divert code.
rate Specifies the divert rate in packets per second. Minimum rate is 1 packet
per second. Maximum rate is 65535 packets per second.
For WAN-side IPv6 packets, the default rate is 4000 packets per second.
limit Specifies the number of packets to be diverted in an initial burst of packets.
Minimum limit is 4 packets. Maximum limit is 4194 packets.
For WAN-side IPv6 packets, the default limit is 4000 packets.
Command Default For WAN-side IPv6 packet streams, the default rate is 4000 packets per second and default limit is 4000
packets.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCE This command was introduced.
Usage Guidelines You can configure rate and limit for a particular IPv6 divert-code for WAN-side IP packets. However,
each IP packet-stream is uniquely identified (using a hash of the VRF, the IP source address, and the
divert-code), and then packets in that stream are sent through a rate-limiter with the configured rate and
limit.
Note To reset the rate and limit to the default values for all IPv6 divert-codes, use the no form of this
command. Using no service divert-rate-limit ipv6 divert-code will reset rate and limit to the default
values for the specified divert code.
Examples The following example shows how to set the rate and limit for the specified divert code:
Router(config)# service divert-rate-limit ipv6 ipv6_rp_glean rate 20 limit 10
Router(config)#
Related Commands
Cisco IOS CMTS Cable Command Reference
CBL-1104 OL-15510-15
Cable Commands: q through sg
service divert-rate-limit ipv6
Command Description
service divert-rate-limit Adds IPv4-specific entries to the trusted site list.
trusted-site
service divert-rate-limit Configures DRL for WAN-side non-IP packet streams.
non-ip
service divert-rate-limit Adds IPv6-specific entries to the trusted site list.
trusted-site-ipv6
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1105
Cable Commands: q through sg
service divert-rate-limit ip trusted-site
service divert-rate-limit ip trusted-site
To add entries to the trusted site list, use the service divert-rate-limit ip trusted-site command in the
global configuration mode. To remove all entries from the trusted site list, use the no form of this
command.
service divert-rate-limit ip trusted-site ip-address mask ip-address tos tos-value mask tos-mask
vrf vrf-name
no service divert-rate-limit ip trusted-site ip-address mask ip-address tos tos-value mask
tos-mask vrf vrf-name
Syntax Description ip-address Specifies the source IP address that should be matched.
Example: 64.12.13.0
mask ip-address The mask to apply to the source IP address of the packet before testing if it
matches. There are no restrictions on the mask value.
Example: 255.255.0.255
tos tos-value The ToS value of the trusted site. There are no restrictions on the tos_value.
Example: 0xD0
mask tos-mask The mask to apply to the IP ToS value and the trusted-site tos_value before
testing if it matches. There are no restrictions on the tos_mask value.
Example: 0xF3
Note The ToS value can be wild-carded by setting the tos_mask to 0x00
vrf vrf-name The VRF that this trusted site applies to.
For the global VRF, use the global keyword. To apply the trusted-site to all
VRFs (including the global VRF), hit enter after specifying the tos-mask.
If a non-existent VRF is specified, the table entry is filled, but the
information is not written to toaster memory. If the specified VRF is
subsequently created, the information is written to toaster at that time.
Command Default No default behavior or values.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCB This command was introduced.
Cisco IOS CMTS Cable Command Reference
CBL-1106 OL-15510-15
Cable Commands: q through sg
service divert-rate-limit ip trusted-site
Usage Guidelines The service divert-rate-limit ip trusted-site command is used to configure trusted site list that contains
a source IP address and mask, IP ToS value and mask, and a VRF. If no IP address is specified, the entire
trusted site list is cleared. The trusted site list contains a source IP address and mask, IP ToS value and
mask, and a VRF. The trusted site list applies only to WAN-IP IPv4 packets. There is a limitation of four
trusted sites.
Examples The following example shows how to configure trusted site list:
Router(config)# service divert-rate-limit trusted-site 64.12.13.0 255.255.0.255
tos 0xD0 mask 0xF3 vrf name1
Related Commands Command Description
service This command sets and limit default values for the specified divert code.
divert-rate-limit
non-ip
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1107
Cable Commands: q through sg
service divert-rate-limit trusted-site-ipv6
service divert-rate-limit trusted-site-ipv6
To add IPv6-specific entries to the trusted site list, use the service divert-rate-limit trusted-site-ipv6
command in the global configuration mode. To remove all entries from the trusted site list, use the no
form of this command.
service divert-rate-limit trusted-site-ipv6 ip-address traffic-class tc_value mask tc-mask [global
| vrf vrf-name]
no service divert-rate-limit trusted-site-ipv6
Syntax Description ip-address The source IPv6 address that should be matched.
traffic-class tc_value The 8-bit traffic-class of the trusted site. There are no restrictions on the
tc_value. Example: 0xD0
mask tc-mask The mask to apply to the packet traffic-class and the trusted-site tc_value
before testing if it matches. There are no restrictions on the tc_mask value.
Example: 0xF3
vrf vrf-name The virtual route forwarding (VRF) instance to which this trusted site is
being applied.
For the global VRF, use the global keyword. To apply the trusted-site to all
VRFs (including the global VRF), hit enter after specifying the tc-mask.
Command Default Disabled
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCE This command was introduced.
Usage Guidelines This command is used to configure trusted site list that contains an IPv6 source-address/prefix-length, a
traffic-class value & mask, and a VRF. There is a limitation of four trusted sites.
Note The no form of the command is used to remove all entries from the trusted site list. To remove a specific
entry you should specify the matching source IP address. For example: no service divert-rate-limit
trusted-site-ipv6 ip-address traffic-class tc_value mask tc-mask [global | vrf vrf-name].
Examples The following example shows how to configure IPv6 trusted site list:
Router(config)# service divert-rate-limit trusted-site-ipv6
2001:420:3800:800:21F:29FF::1/128 traffic-class 0x3 mask 0xFF global
Router(config)#
Cisco IOS CMTS Cable Command Reference
CBL-1108 OL-15510-15
Cable Commands: q through sg
service divert-rate-limit trusted-site-ipv6
Related Commands Command Description
show pxf cpu statistics Displays the number of upstream cable packets that are dropped from the
drl us-cable CMTS.
show pxf cpu statistics Verifies the drop counters for WAN-IPv6 packets.
drl ipv6
show pxf cpu statistics Verifies the drop counters for WAN-IPv4 packets.
drl ipv4
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1109
Cable Commands: q through sg
service divert-rate-limit non-ip
service divert-rate-limit non-ip
To set DRL for WAN-side non-IP packet streams, use the service divert-rate-limit non-ip command in
global configuration mode. To reset the rate and limit to the default values for all non-IP divert-codes,
use the no form of this command. Using no service divert-rate-limit non-ip divert-code will reset rate
and limit to the default values for the specified divert-code.
service divert-rate-limit non-ip divert-code rate rate limit limit
no service divert-rate-limit non-ip
Syntax Description divert-code Specifies the applicable divert code.
rate Specifies the rate in packets per second. Minimum rate is one packet per
second. Maximum rate is 65535 packets per second.
For WAN-side non-IP packets, the default rate is 2000 packets per second.
limit Specifies the number of packets to be diverted in an initial burst of packets.
Minimum limit is 4 packets. Maximum limit is 4194 packets.
For WAN-side non-IP packets, the default limit is 2000 packets.
Command Default For WAN-side non-IP packets, the default rate is 2000 packets per second and default limit is 2000
packets.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCB This command was introduced.
The service divert-rate-limit non-ip fib-rpf-glean command is the
WAN-side non-IP replacement for the service divert-rate limit
fib-rpf-glean command.
Usage Guidelines You can configure a rate and limit for a particular non-IP divert-code, and all packets arriving with that
divert-code are sent through a single rate-limiter with the configured rate and limit. but the explanation
is fairly straightforward: there is a single rate-limiter for each non-IP divert-code. No attempt is made
to uniquely identify the source of the attacking packet stream.
Examples The following example shows how to set and limit default values for the specified divert code:
Router(config)# service divert-rate-limit non-ip fib-rpf-glean rate 5 limit 25
Related Commands
Cisco IOS CMTS Cable Command Reference
CBL-1110 OL-15510-15
Cable Commands: q through sg
service divert-rate-limit non-ip
Command Description
service This command configures DRL rate and limit for WAN-side IP packet
divert-rate-limit ip streams.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1111
Cable Commands: q through sg
service divert-rate-limit trusted-site
service divert-rate-limit trusted-site
To add entries to the trusted site list, use the service divert-rate-limit trusted-site command in the
global configuration mode. To remove all entries from the trusted site list, use the no form of this
command.
service divert-rate-limit trusted-site ip-address mask-ip-address tos tos-value mask tos-mask
[global | vrf vrf-name]
no service divert-rate-limit trusted-site
Syntax Description ip-address Specifies the source IP address that should be matched.
Example: 64.12.13.0
mask ip-address The mask to apply to the source IP address of the packet before testing if it
matches. There are no restrictions on the mask value.
Example: 255.255.0.255
tos tos-value The ToS value of the trusted site. There are no restrictions on the tos_value.
Example: 0xD0
mask tos-mask The mask to apply to the IP ToS value and the trusted-site tos_value before
testing if it matches. There are no restrictions on the tos_mask value.
Example: 0xF3
Note The ToS value can be wild-carded by setting the tos_mask to 0x00
vrf vrf-name The VRF that this trusted site applies to.
For the global VRF, use the global keyword. To apply the trusted-site to all
VRFs (including the global VRF), hit enter after specifying the tos-mask.
If a non-existent VRF is specified, the table entry is filled, but the
information is not written to toaster memory. If the specified VRF is
subsequently created, the information is written to toaster at that time.
Command Default No default behavior or values.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SCB This command was introduced.
Cisco IOS CMTS Cable Command Reference
CBL-1112 OL-15510-15
Cable Commands: q through sg
service divert-rate-limit trusted-site
Usage Guidelines The service divert-rate-limit ip trusted-site command is used to configure trusted site list that contains
a source IP address and mask, IP ToS value and mask, and a VRF. The trusted site list contains a source
IP address and mask, IP ToS value and mask, and a VRF. The trusted site list applies only to WAN-IP
IPv4 packets. There is a limitation of four trusted sites.
To remove specified entry from the trusted site list, use no service divert-rate-limit trusted-site
ip-address mask ip-address tos tos-value mask tos-mask [global | vrf vrf-name]. If no IP address is
specified, the entire trusted site list is cleared.
Examples The following example shows how to configure trusted site list:
Router(config)# service divert-rate-limit trusted-site 64.12.13.0 255.255.0.255
tos 0xD0 mask 0xF3 vrf name1
Related Commands Command Description
service This command sets and limit default values for the specified divert code.
divert-rate-limit
non-ip
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1113
Cable Commands: q through sg
service instance
service instance
To configure an Ethernet service instance, use the service instance command in Layer 2 VPN
configuration mode. To disable this configuration, use the no form of this command.
service instance id service-type
no service instance id service-type
Syntax Description id Service instance ID.
service-type Service type for the instance.
Command Default None
Command Modes Layer 2 VPN configuration (config-l2vpn)
Command History Release Modification
12.2(33)SCC This command was introduced in Cisco IOS Release 12.2(33)SCC.
Usage Guidelines You must provision a Multiprotocol Label Switching (MPLS) pseudowire before configuring an
Ethernet service instance in Layer 2 VPN configuration mode.
Examples The following example shows how to configure an Ethernet service instance on a Cisco uBR10012
router:
Router # configure terminal
Router(config) # cable l2vpn 001e.6bfb.0f9e customer2
Router(config-l2vpn) # service instance 7000 ethernet
Related Commands Command Description
cable l2-vpn-service Enables the use of Layer 2 tunnels based on an MPLS pseudowire.
xconnect
Cisco IOS CMTS Cable Command Reference
CBL-1114 OL-15510-15
Cable Commands: q through sg
service udp-small-servers max-servers no-limit
service udp-small-servers max-servers no-limit
To enable use of minor servers that use the UDP protocol (such as ToD, echo, chargen, and discard), use
the service udp-small-servers max-servers no-limit command in global configuration mode. To
remove this configuration, use the no form of this command.
service udp-small-servers max-servers no-limit
no service udp-small-servers max-servers no-limit
Command Default DHCP or ToD servers 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.
Examples The following example illustrates configuration of this command:
Router# configure terminal
Router(config)# service udp-small-servers max-servers no-limit
Router(config)#
The following example shows a typical ToD server configuration:
service udp-small-servers max-servers no-limit
cable time-server
These are the only commands required to enable the ToD server.
Usage Guidelines The max-servers no-limit option allows a large number of cable modems to obtain the ToD server at
one time, in the event that a cable or power failure forces many cable modems offline. When the problem
has been resolved, the cable modems can quickly reconnect.
Note Do not disable the minor UDP servers if you are also enabling the other DHCP or TFTP servers.
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
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1115
Cable Commands: q through sg
service udp-small-servers max-servers no-limit
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 Configures the DHCP server to validate the relay agent information option
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.
Cisco IOS CMTS Cable Command Reference
CBL-1116 OL-15510-15
Cable Commands: q through sg
service-class
service-class
To create a DOCSIS configuration file that specifies the quality-of-service (QoS) service-class options
for the CM configuration file, use the service-class command in cable config-file configuration mode.
To disable the specification, use the no form of this command.
service-class class {guaranteed-upstream us-bandwidth max-burst burst-size max-downstream
max-dsbandwidth max-upstream max-usbandwidth priority priority-num privacy}
no service-class
Syntax Description class Specifies service class number. Valid range is 1 to 16. Default value is 1.
guaranteed-upstream Specifies the guaranteed upstream bandwidth in kbps. Valid range for
us-bandwidth us-bandwidth is 0 to 100000 kbps. Default value is 0.
max-burst burst-size Specifies the maximum upstream burst size in bytes. Valid range for
burst-size is 0 to 65535. Default value is 0, unlimited burst length.
Recommended value range is 1600 to 1800 bytes. Using a value of 0 or greater
than 1800 bytes can cause latency issues for Voice-over-IP. A value of less than
1500 bytes prevents upstream transmission of large Ethernet frames for any
modem or CMTS not implementing fragmentation (an optional feature in
DOCSIS 1.0).
max-downstream Specifies the downstream bandwidth in kbps. Valid range for
max-dsbandwidth max-dsbandwidth is 0 to 100000 kbps. Default value is 0.
max-upstream Specifies the upstream bandwidth in kbps. Valid range for max-usbandwidth
max-usbandwidth is 0 to 100000 kbps. Default value is 0.
priority priority-num Specifies the service class priority. Valid range for priority-num is 0 to 7,
where 7 is the highest-priority service-class setting.
privacy Enables baseline privacy interface (BPI).
Command Default Service-class is not set by default. A CM cannot register on a Cisco CMTS unless at least one parameter in
a service class is specified.
Command Modes Cable config-file (config-file)
Command History Release Modification
12.1(2)EC1 This command was introduced.
12.2(4)BC1 This command was integrated into Cisco IOS Release 12.2(4)BC1.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
Support for the Cisco uBR7225VXR router was added.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1117
Cable Commands: q through sg
service-class
Usage Guidelines Default values can be used only if service-class class is specified. A single configuration file should not
contain multiple service-class ID numbers. Thus, all parameters should be set using a single service-class ID.
However, different configuration files can reuse the same service-class ID.
Note To enable Baseline Privacy Interface (BPI) operations on the cable command, you must specify both the
service-class privacy and privacy commands for the cable modem’s DOCSIS configuration file.
Examples The following example shows how to specify the service-class command for a DOCSIS configuration
file:
router(config)# cable config-file upgrade.cm
router(config-file)# service-class 1 priority 0
router(config-file)# service-class 1 max-upstream 3247
router(config-file)# service-class 1 max-downstream 10000
router(config-file)# service-class 1 max-burst 1600
router(config-file)# service-class 1 privacy
router(config-file)# privacy
router(config-file)# exit
Related Commands Command Description
cable config-file Creates a DOCSIS configuration file and enters configuration file
mode.
access-denied Disables access to the network.
channel-id Specifies upstream channel ID.
cpe max Specifies CPE information.
download Specifies download information for the configuration file.
frequency Specifies downstream frequency.
option Specifies vendor-specific information fields and other config-file
options.
privacy Specifies privacy options for baseline privacy images.
snmp manager Specifies SNMP options.
timestamp Enables time-stamp generation.
Cisco IOS CMTS Cable Command Reference
CBL-1118 OL-15510-15
Cable Commands: q through sg
service-type-id
service-type-id
To add a service type ID that is compared against the cable modem provisioned service type ID, to
determine an appropriate restricted load balancing group (RLBG), use the service-type-id command in
the config-lb-group configuration mode. To remove the service type ID, use the no form of this
command.
service-type-id string
no service-type-id string
Syntax Description string Identifier of the service type that gets added to the load balancing group.
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.
Usage Guidelines You can use the service-type-id command to add a service type ID only to a RLBG.
Examples The following example shows how to add a service type ID on the CMTS, using the service-type-id
command.
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# cable load-balance docsis-group 1
Router(config-lb-group)# restricted
Router(config-lb-group)# service-type-id commercial
Router(config-lb-group)# no service-type-id commercial
Router(config-lb-group)#
Related Commands Command Description
cable load-balance Configures a DOCSIS load balancing group on the CMTS.
docsis-group
show cable Displays real-time configuration, statistical, and operational information
load-balance for load balancing operations on the router.
docsis-group
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1119
Cable Commands: q through sg
service-type-id (cmts-tag)
service-type-id (cmts-tag)
To configure the specified service type ID for the CMTS tag, use the service-type-id command in the
cmts-tag configuration mode. To remove the service type ID, use the no form of this command.
[exclude] service-type-id service-type-id
no service-type-id service-type-id
Syntax Description exclude (Optional) Configures the CMTS tag to exclude the specified service type
ID.
service-type-id Sets a matching rule with the specified service type ID.
Command Default No default behavior or values.
Command Modes CMTS tag mode (cmts-tag)
Command History Release Modification
12.2(33)SCC This command was introduced.
Examples The following example shows how to configure the specified service type ID for the CMTS tag using
the service-type-id command:
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# cable tag 1
Router(cmts-tag)# service-type-id commercial
Related Commands Command Description
cable load-balance To configure a DOCSIS load balancing group on the CMTS.
docsis-group
show cable To display real-time configuration, statistical and operational information
load-balance for load balancing operations on the router.
docsis-group
cable tag To configure a tag for a DOCSIS load balancing group on the CMTS.
Cisco IOS CMTS Cable Command Reference
CBL-1120 OL-15510-15
Cable Commands: q through sg
session-range
session-range
To identify the multicast QoS group session range, use the session-range command in multicast QoS
configuration mode. To disable the QoS group session range, use the no form of this command.
session-range ip-address ip-mask
no session-range ip-address ip-mask
Syntax Description ip-address Specifies the IP address of the multicast QoS group.
ip-mask Specifies the IP mask of the multicast QoS group.
Command Default A session range IP address and IP mask are not defined for a specific multicast QoS group.
Command Modes Multicast QoS configuration (config-mqos)
Command History Release Modification
12.2(33)SCA This command was introduced.
Usage Guidelines Use the session-range command to configure the session range to specify the number of multicast
sessions to be admitted on a particular service flow. CMTS does not admit new sessions (no forwarding)
if the current number of sessions has reached the defined limit, and waits until a session ends to free up
a slot for new sessions. You can configure multiple session ranges.
Examples The following example defines a session range IP address and IP mask using the session-range
command:
Router(config)# cable multicast qos group 20 priority 55 global
Router(config-mqos)# session-range 224.10.10.01 255.255.255.254
Related Commands Command Description
cable multicast qos Specifies and configures a cable multicast QoS group.
group
show interface bundle Displays multicast session information for a specific virtual cable bundle.
multicast-sessions
show interface cable Displays multicast session information for a specific cable interface.
multicast-sessions
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1121
Cable Commands: q through sg
set clock
set clock
To set the system clock on the Cisco CMTS, use the set clock command in global configuration mode.
set clock time-date
Syntax Description time-date Time and date for which to set the clock on the Cisco CMTS.
Command Default Time-of-Day, DHCP, and TFTP server configuration not defined on the Cisco CMTS by default.
Command Modes Global configuration
Command History Release Modification
12.0(4)XI This feature was introduced for the Cisco uBR7200 series routers.
12.1(5)EC This feature was supported on the Cisco uBR7100 series routers.
12.2(4)BC1 This feature was supported on the Release 12.2 BC train for all Cisco CMTS
platforms.
Usage Guidelines To supply an accurate clock, the system clock on the Cisco CMTS should be configured for the correct
time, either by using the set clock command or by configuring the Cisco CMTS to act as a Network Time
Protocol (NTP) or Simple Network Time Protocol (SNTP) client.
For proper operation of the DOCSIS network, especially a DOCSIS 1.1 network using BPI+ encryption
and authentication, the system clock on the Cisco CMTS must be set accurately. You can achieve this
by manually using the set clock command, or by configuring the CMTS to use either the Network Time
Protocol (NTP) or the Simple Network Time Protocol (SNTP).
For additional information about the set clock command, refer to the following documents on
Cisco.com:
• Time-of-Day Server for the Cisco CMTS
• DHCP, ToD, and TFTP Services for the Cisco Cable Modem Termination System
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.
Cisco IOS CMTS Cable Command Reference
CBL-1122 OL-15510-15
Cable Commands: q through sg
set clock
Command Description
ip dhcp relay information Configures the DHCP server to validate the relay agent information option
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.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1123
Cable Commands: q through sg
set clock
Cisco IOS CMTS Cable Command Reference
CBL-1124 OL-15510-15
Cable Commands: show a through show cable l
Revised: July 2012, OL-15510-15
New Commands
Command Cisco IOS Software Release
show cable clock dti counters 12.3(23)BC
show cable clock dti status, 12.3(23)BC
show cable ib-ipc 12.3(23)BC
show cable flap-list wb-rf 12.2(33)SCB
show cable fiber-node 12.2(33)SCC
show cable ipc-stats 12.2(33)SCC
show cable load-balance docsis-group 12.2(33)SCC
show cable l2-vpn xconnect 12.2(33)SCC
show cable dsg tg 12.2(33)SCD5
show cable licenses all 12.2(33)SCE
show cable acfe controller 12.2(33)SCF
show cable acfe interface 12.2(33)SCF
show cable acfe summary 12.2(33)SCF
show cable active-reman 12.2(33)SCF
show cable dynamic-qos trace 12.2(33)SCF
show cable bgsync 12.2(33)SCG
show cable cgd-associations 12.2(33)SCG
show cable dsg cfr 12.2(33)SCG
show cable dsg host 12.2(33)SCG
show cable dsg static-group bundle 12.2(33)SCG
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1125
Cable Commands: show a through show cable l
Modified Commands
Command Cisco IOS Software Release
show cable admission-control 12.3(23)BC
show cable clock 12.3(23)BC
show cable filter 12.2(33)SCA
show cable l2-vpn dot1q-vc-map 12.2(33)SCA
show cable logging 12.3(23)BC5
show cable logging 12.2(33)SCB
show cable hop 12.3(23)BC7
show cable admission-control 12.2(33)SCC
show cable flap-list 12.2(33)SCC
show cable load-balance 12.2(33)SCC
show cable hop 12.2(33)SCC
show cable admission-control 12.2(33)SCF
show cable ipc-stats 12.2(33)SCF
show cable l2-vpn xconnect 12.2(33)SCF
show cable load-balance 12.2(33)SCF
show cable load-balance docsis-group 12.2(33)SCF
show cable load-balance 12.2(33)SCE4
show cable leasequery-filter 12.2(33)SCF1
show cable dsg tg 12.2(33)SCG
show cable load-balance 12.2(33)SCG
show cable logging 12.2(33)SCG
Replaced Commands
Command Replacement Command Effective Cisco IOS Release
show cable dsg show cable dsg tunnel 12.3(13a)BC
Cisco IOS CMTS Cable Command Reference
CBL-1126 OL-15510-15
Cable Commands: show a through show cable l
show application-buckets
show application-buckets
To displays rules for any or all buckets supporting Service Flow Admission Control on the Cisco CMTS,
use the show application-buckets command in privileged EXEC mode. The configured rules for any
given bucket are displayed in order of precedence in the Rule field.
show application-buckets [ bucket-no n ]
Syntax Description bucket-no n You may specify a specific bucket number on the Cisco CMTS to display
parameters for that bucket and no others. Valid range is 1 to 8, or all buckets if
no specific bucket is designated.
Command Default No default behavior or values for this command. However, Cisco IOS Release 12.3(21)BC supports
default operation and non-default configuration for feature on the Cisco CMTS.
Command Modes Privileged EXEC
Command History Release Modification
12.3(21)BC This command was introduced for the Cisco uBR10012 router and the
Cisco uBR7246VXR router.
Usage Guidelines For additional information for Service Flow Admission Control, commencing in Cisco IOS Release
12.3(21)BC, refer to the following document on Cisco.com:
• Service Flow Admission Control for the Cisco Cable Modem Termination System
Examples The following example illustrates sample output of the show application-buckets command.
Router# show cable application-type
For bucket 1, Name PktCable
Packetcable normal priority gates
Packetcable high priority gates
For bucket 2, Name PCMM-Vid
PCMM gate app-id = 30
For bucket 3, Name Gaming
PCMM gate app-id = 40
For bucket 4, Name
For bucket 5, Name
For bucket 6, Name
For bucket 7, Name
For bucket 8, Name HSD
Best-effort (CIR) flows
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1127
Cable Commands: show a through show cable l
show application-buckets
Related Commands Command Description
cable admission-control Sets minor, major and exclusive thresholds for downstream
ds-bandwidth voice or data bandwidth for each or all interfaces on the Cisco
CMTS
cable admission-control preempt Changes the default PacketCable Emergency 911 call
priority-voice preemption functions on the Cisco CMTS, supporting
throughput and bandwidth requirements for Emergency 911
calls above all other buckets on the Cisco CMTS.
cable admission-control Configures global or interface-level upstream bandwidth
us-bandwidth thresholds and exclusive or non-exclusive resources on the
Cisco CMTS.
cable application-type include Associates an application type with a specific and prioritized
bucket on the Cisco CMTS.
cable application-type name Assigns an alpha-numeric name for the specified bucket.
debug cable admission-control Displays service flow categorization results, enabled when a
flow-categorization service flow is classified.
show application-buckets Displays rules for any or all buckets supporting Service Flow
Admission Control on the Cisco CMTS.
show interface cable Displays service flows, categorizations, and bandwidth
admission-control reservation consumption on the Cisco CMTS, for the specified interface,
and the specified service flow direction.
Cisco IOS CMTS Cable Command Reference
CBL-1128 OL-15510-15
Cable Commands: show a through show cable l
show bridge cable-modem
show bridge cable-modem
To display bridging information for the router’s cable interface, use the show bridge cable-modem
command in privileged EXEC mode.
Cisco uBR904, uBR905, uBR924, uBR925 cable access routers, Cisco CVA122 Cable Voice Adapter
show bridge cable-modem number
Syntax Description number Identifies the cable interface (always 0).
Command Default No default behavior or values.
Command Modes Privileged EXEC
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.
Examples The following example shows sample output for this show bridge cable-modem command:
Router# show bridge cable-modem 0
Total of 300 station blocks, 298 free
Codes: P - permanent, S - self
Bridge Group 59:
Table 0-38 describes the significant fields shown in the display.
Table 0-38 show bridge cable-modem Field Descriptions
Field Description
Total of 300 station blocks Total number of forwarding database elements in the system. The
memory to hold bridge entries is allocated in blocks of memory
sufficient to hold 300 individual entries. When the number of free
entries falls below 25, another block of memory sufficient to hold
another 300 entries is allocated. Thus, the total number of forwarding
elements in the system is expanded dynamically, as needed, limited by
the amount of free memory in the router.
Bridge Group The number of the bridge group to which this interface is assigned.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1129
Cable Commands: show a through show cable l
show bridge cable-modem
Tip In Cisco IOS Release 12.2(8)T and later releases, you can add a timestamp to show commands using the
exec prompt timestamp command in line configuration mode.
Related Commands Command Description
show dhcp Displays the current DHCP settings on point-to-point interfaces.
show interfaces cable-modem Displays information about the cable interface.
Cisco IOS CMTS Cable Command Reference
CBL-1130 OL-15510-15
Cable Commands: show a through show cable l
show cable acfe controller
show cable acfe controller
To display fairness across DOCSIS interfaces controller statistics, use the show cable acfe controller
command in privileged EXEC mode.
show cable acfe controller modular-cable slot/subslot/unit [cluster cluster-index]
Syntax Description modular-cable Displays information for all controllers on the specified modular cable
interface on a Cisco uBR10012 router, where:
• slot—Controller slot number. The valid values range from 0 to 8.
• subslot—Controller subslot number. The valid values range from 0 to 3.
• unit—Controller unit number. The valid value is 0.
cluster Displays information at the cluster level.
• cluster-index—Cluster index. The valid values range from 0 to 253.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCF This command was introduced.
Usage Guidelines Use the show cable acfe controller command to show fairness across DOCSIS interfaces status and
statistics for each controller interface.
Examples The following example shows a sample output of the show cable acfe controller command:
Router# show cable acfe controller modular-Cable 1/0/0
EIR Rebalance invoked: 76476
Adaptive CIR granted: 0
Adaptive CIR rejected: 0
Total clusters: 2
RF FlexBW
0 28687
1 28687
RF FlexBW
2 28687
3 28687
The following example shows a sample output of the show cable acfe controller command with the
cluster keyword:
Router# show cable acfe controller modular-Cable 1/0/0 cluster 1
EIR Rebalance invoked: 1810
Adaptive CIR granted: 0
Adaptive CIR rejected: 0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1131
Cable Commands: show a through show cable l
show cable acfe controller
Total clusters: 2
RF FlexBW
2 28687
3 28687
Table 39 describes the significant fields shown in the display.
Table 39 show cable acfe controller Field Descriptions
Field Description
EIR Rebalance invoked Number of EIR rebalance invoked.
Adaptive CIR granted Number of CIRs granted.
Adaptive CIR rejected Number of CIRs rejected.
Total Clusters Cluster numbers.
RF RF channel number.
FlexBW Flexible bandwidth.
Related Commands Command Description
show cable acfe Displays fairness across DOCSIS interfaces statistics of a specific interface.
interface
show cable acfe Displays fairness across DOCSIS interfaces status and statistics.
summary
Cisco IOS CMTS Cable Command Reference
CBL-1132 OL-15510-15
Cable Commands: show a through show cable l
show cable acfe interface
show cable acfe interface
To display the fairness across DOCSIS interfaces statistics of a specific interface, use the show cable
acfe interface command in privileged EXEC mode.
show cable acfe interface {modular-cable | wideband-cable | integrated-cable}
slot/subslot/port:interface-num [verbose]
Syntax Description interface Specifies the cable interface.
• modular-cable—Specifies the modular cable interface.
• wideband-cable—Specifies the wideband cable interface.
• integrated-cable—Specifies the integrated cable interface.
• slot—Slot number of the cable interface. The valid range is from 5 to 8.
• subslot—Subslot number of the cable interface. The valid values are 0
or 1.
• port—Port number. The valid values are 0 or 1.
• interface-num—Interface number. The valid range is from 0 to 23 for
modular interface, 0 to 31 for the wideband interface, and 0 to 3 for the
integrated interface.
verbose (Optional) Enables verbose mode for the output, giving additional details
about the modular, wideband or integrated interfaces.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCF This command was introduced.
Usage Guidelines Use the show cable acfe interface command to display the fairness across DOCSIS interfaces statistics
on a specific interface. The command output also displays the route processor Service Flow Admission
Control (SFAC) shadow with thresholds and reservations.
The integrated-cable option works only on the Cisco UBR-MC20X20V cable interface line cards.
Examples The following examples show sample outputs of the show cable acfe interface command:
Router# show cable acfe interface modular-Cable 1/0/0:1
Adaptive CIR granted: 0
Adaptive CIR rejected: 0
EIR Demand (raw/scale): 0/1
EIR Per-Flow BW (kbps): 18991
Guar Bonus BW (kbps): 18991
Non-guar Bonus BW (kbps): 9696
Reserved Bonus BW (kbps): 0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1133
Cable Commands: show a through show cable l
show cable acfe interface
Router# show cable acfe interface wideband-Cable 1/0/0:1
Adaptive CIR granted: 0
Adaptive CIR rejected: 0
EIR Demand (raw/scale): 0/1
EIR Per-Flow BW (kbps): 18991
Guar Bonus BW (kbps): 19391
Non-guar Bonus BW (kbps): 37983
Reserved Bonus BW (kbps): 400
Router# show cable acfe interface integrated-Cable 6/1/0:0
Adaptive CIR granted: 0
Adaptive CIR rejected: 0
EIR Demand (raw/scale): 0/1
EIR Per-Flow BW (kbps): 20028
Guar Bonus BW (kbps): 20028
Non-guar Bonus BW (kbps): 10009
Reserved Bonus BW (kbps): 0
Table 39 describes the significant fields shown in the display.
Table 40 show cable acfe interface Field Descriptions
Field Description
Adaptive CIR granted Number of adaptive CIRs granted.
Adaptive CIR rejected Number of adaptive CIRs rejected.
EIR Demand (raw/scale) Total EIR demand.
EIR Per-Flow BW (kbps) Expected saturated throughput of a priority 0 BE flow on this
interface.
Guar Bonus BW (kbps) Guaranteed bonus bandwidth, in kilobytes per second.
Non-guar Bonus BW (kbps) Non-guaranteed bonus bandwidth, in kilobytes per second.
Reserved Bonus BW (kbps) Reserved bonus bandwidth, in kilobytes per second.
Related Commands Command Description
show cable acfe Displays fairness across DOCSIS interfaces controller statistics.
controller
show cable acfe Displays fairness across DOCSIS interfaces status and statistics.
summary
Cisco IOS CMTS Cable Command Reference
CBL-1134 OL-15510-15
Cable Commands: show a through show cable l
show cable acfe summary
show cable acfe summary
To display the fairness across DOCSIS interfaces status and statistics, use the show cable acfe summary
command in privileged EXEC mode.
show cable acfe summary
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCF This command was introduced.
Usage Guidelines The show cable acfe summary command displays the global fairness across DOCSIS interfaces status
and statistics.
Examples The following example shows a sample output of the show cable acfe summary command:
Router# show cable acfe summary
ACFE state: Enabled
EIR Rebalance period (secs): 5
EIR Rebalance invocations: 32416
CIR Acquire invocations: 1
CIR Acquire rate/limit: 100/100
CIR Acquire throttled: 0
Maximal EIR ratio: 16
Table 39 describes the significant fields shown in the display.
Table 41 show cable acfe summary Field Descriptions
Field Description
ACFE state Fairness across DOCSIS interfaces state, enabled or disabled.
EIR Rebalance period (secs) EIR rebalance period, in seconds.
EIR Rebalance invocations Number of EIR rebalance invocations.
CIR Acquire invocations Number of CIR acquire invocations.
CIR Acquire rate/limit CIR acquire rate and limit.
CIR Acquire throttled Number of CIR acquisitions that failed because they reached
the rate limit.
Maximal EIR ratio Maximum EIR ratio.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1135
Cable Commands: show a through show cable l
show cable acfe summary
Related Commands Command Description
cable acfe enable Enables Fairness Across DOCSIS Interfaces feature on the CMTS router.
Cisco IOS CMTS Cable Command Reference
CBL-1136 OL-15510-15
Cable Commands: show a through show cable l
show cable active-reman
show cable active-reman
To display the line card high availability information, use the show cable active-reman command in
privileged EXEC mode.
show cable active-reman {all | slot/subslot}
Syntax Description all Displays high availability information for all line card interfaces.
slot Cable interface line card slot. The valid range is from 5 to 8.
subslot Cable interface line card subslot. The valid range is 0 and 1.
Command Default None
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCF This command was introduced in Cisco IOS Release 12.2(33)SCF.
Examples The following is a sample output of the show cable active-reman command that shows high availability
information for all cable interfaces on the Cisco uBR10012 router:
Router# show cable active-reman all
-------------------------------------------------------------
Active Reman info on LC 5/0:
[slot_index 0]: work_slot:1/0, active_slot:1/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 1]: work_slot:3/0, active_slot:3/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 2]: work_slot:5/0, active_slot:5/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 3]: work_slot:5/1, active_slot:5/1, is_protect:TRUE , is_standby
:TRUE
[slot_index 4]: work_slot:6/0, active_slot:6/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 5]: work_slot:6/1, active_slot:6/1, is_protect:FALSE, is_standby
:FALSE
[slot_index 6]: work_slot:7/0, active_slot:7/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 7]: work_slot:7/1, active_slot:7/1, is_protect:FALSE, is_standby
:FALSE
[slot_index 8]: work_slot:8/0, active_slot:8/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 9]: work_slot:8/1, active_slot:8/1, is_protect:FALSE, is_standby
:FALSE
-------------------------------------------------------------
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1137
Cable Commands: show a through show cable l
show cable active-reman
Active Reman info on LC 5/1:
[slot_index 0]: work_slot:1/0, active_slot:1/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 1]: work_slot:3/0, active_slot:3/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 2]: work_slot:5/0, active_slot:5/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 3]: work_slot:5/1, active_slot:5/1, is_protect:TRUE , is_standby
:TRUE
[slot_index 4]: work_slot:6/0, active_slot:6/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 5]: work_slot:6/1, active_slot:6/1, is_protect:FALSE, is_standby
:FALSE
[slot_index 6]: work_slot:7/0, active_slot:7/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 7]: work_slot:7/1, active_slot:7/1, is_protect:FALSE, is_standby
:FALSE
[slot_index 8]: work_slot:8/0, active_slot:8/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 9]: work_slot:8/1, active_slot:8/1, is_protect:FALSE, is_standby
:FALSE
-------------------------------------------------------------
Active Reman info on LC 6/0:
[slot_index 0]: work_slot:1/0, active_slot:1/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 1]: work_slot:3/0, active_slot:3/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 2]: work_slot:5/0, active_slot:5/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 3]: work_slot:5/1, active_slot:5/1, is_protect:TRUE , is_standby
:TRUE
[slot_index 4]: work_slot:6/0, active_slot:6/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 5]: work_slot:6/1, active_slot:6/1, is_protect:FALSE, is_standby
:FALSE
[slot_index 6]: work_slot:7/0, active_slot:7/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 7]: work_slot:7/1, active_slot:7/1, is_protect:FALSE, is_standby
:FALSE
[slot_index 8]: work_slot:8/0, active_slot:8/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 9]: work_slot:8/1, active_slot:8/1, is_protect:FALSE, is_standby
:FALSE
-------------------------------------------------------------
Active Reman info on LC 7/0:
[slot_index 0]: work_slot:1/0, active_slot:1/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 1]: work_slot:3/0, active_slot:3/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 2]: work_slot:5/0, active_slot:5/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 3]: work_slot:5/1, active_slot:5/1, is_protect:TRUE , is_standby
:TRUE
[slot_index 4]: work_slot:6/0, active_slot:6/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 5]: work_slot:6/1, active_slot:6/1, is_protect:FALSE, is_standby
:FALSE
[slot_index 6]: work_slot:7/0, active_slot:7/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 7]: work_slot:7/1, active_slot:7/1, is_protect:FALSE, is_standby
:FALSE
Cisco IOS CMTS Cable Command Reference
CBL-1138 OL-15510-15
Cable Commands: show a through show cable l
show cable active-reman
[slot_index 8]: work_slot:8/0, active_slot:8/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 9]: work_slot:8/1, active_slot:8/1, is_protect:FALSE, is_standby
:FALSE
-------------------------------------------------------------
Active Reman info on LC 8/0:
[slot_index 0]: work_slot:1/0, active_slot:1/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 1]: work_slot:3/0, active_slot:3/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 2]: work_slot:5/0, active_slot:5/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 3]: work_slot:5/1, active_slot:5/1, is_protect:TRUE , is_standby
:TRUE
[slot_index 4]: work_slot:6/0, active_slot:6/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 5]: work_slot:6/1, active_slot:6/1, is_protect:FALSE, is_standby
:FALSE
[slot_index 6]: work_slot:7/0, active_slot:7/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 7]: work_slot:7/1, active_slot:7/1, is_protect:FALSE, is_standby
:FALSE
[slot_index 8]: work_slot:8/0, active_slot:8/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 9]: work_slot:8/1, active_slot:8/1, is_protect:FALSE, is_standby
The following is a sample output of the show cable active-reman command that shows high availability
information for slot 5 and subslot 0 on the Cisco uBR10012 router:
Router# show cable active-reman 5/0
-------------------------------------------------------------
Active Reman info on LC 5/0:
[slot_index 0]: work_slot:1/0, active_slot:1/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 1]: work_slot:3/0, active_slot:3/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 2]: work_slot:5/0, active_slot:5/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 3]: work_slot:5/1, active_slot:5/1, is_protect:TRUE , is_standby
:TRUE
[slot_index 4]: work_slot:6/0, active_slot:6/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 5]: work_slot:6/1, active_slot:6/1, is_protect:FALSE, is_standby
:FALSE
[slot_index 6]: work_slot:7/0, active_slot:7/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 7]: work_slot:7/1, active_slot:7/1, is_protect:FALSE, is_standby
:FALSE
[slot_index 8]: work_slot:8/0, active_slot:8/0, is_protect:FALSE, is_standby
:FALSE
[slot_index 9]: work_slot:8/1, active_slot:8/1, is_protect:FALSE, is_standby
:FALSE
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1139
Cable Commands: show a through show cable l
show cable admission-control
show cable admission-control
To display the current admission control (AC) configuration and status on a Cisco CMTS router, or on
a specified interface, use the show cable admission-control command in privileged EXEC mode.
show cable admission-control [global] interface slot/port | slot/subslot/port] [all | verbose]
Cisco IOS Release 12.2(33)SCE and later
show cable admission-control {global | interface {cable slot/subslot/cable-interface-index |
{integrated-cable | modular-cable | wideband-cable} slot/subslot/port:interface-num
[verbose] | all}}
Syntax Description global Displays the following information:
• Parameters configured for AC.
• Number of requests that crossed minor, major, and critical levels for
each resource.
interface slot/port | Displays admission control information for the specified interface. This
slot/subslot/port includes the following:
• slot—Slot on the interface. The valid range is from 5 to 8 for the Cisco
uBR10012 router and from 3 to 6 for the Cisco uBR7200 series routers.
• subslot—Subslot on the interface. The valid values are 0 or 1.
• port—Port on the interface. The valid range is from 0 to 4 for the Cisco
uBR10012 router and 0 or 1 for the Cisco uBR7200 series routers.
• cable-interface-index
– Cisco uBR7200 series routers—The valid values are 0 or 1.
– Cisco uBR10012 router—The valid range is from 0 to 4 for the
Cisco uBR-MC20X20V and Cisco uBR-MC5X20 line cards, and
0 to 14 for the Cisco uBR-MC3GX60V line card.
• interface-num—Interface number. The valid range is from 0 to 23 for
the modular interface, 0 to 31 for the wideband interface, and 0 to 3 for
the integrated interface.
all (Optional) Displays information for all interfaces configured for AC on the
Cisco CMTS.
verbose (Optional) Displays detailed information for the wideband interface
configured for AC on the Cisco CMTS.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.3(13a)BC This command was introduced on the Cisco uBR10012 router and the
Cisco uBR7246VXR router.
12.3(23)BC This command was modified; new fields were added to the output.
Cisco IOS CMTS Cable Command Reference
CBL-1140 OL-15510-15
Cable Commands: show a through show cable l
show cable admission-control
Release Modification
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
12.2(33)SCC This command was modified to display DS threshold values and reservations
per bucket on a modular cable, interface cable, or DS channel bonding.
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.
12.2(33)SCF This command was modified to display guaranteed and non-guaranteed
bonus bandwidth from the ACFE functionality.
Usage Guidelines The show cable admission-control command offers flexible syntax that enables display of the AC as
specifically configured on the Cisco CMTS. See the examples for additional information.
The verbose keyword is not applicable to integrated-cable and modular-cable interfaces.
Examples The following example displays upstream and downstream AC information for the specified cable
interface:
Router# show cable admission-control interface cable 7/0/0
Interface Cable7/0/0
Resource - Upstream Bandwidth
-----------------------------
Thresholds applicable to upstream ports with no interface level
configurations in place
Bucket Minor Major Exclusive Non-Excls
No Level Level Level Level
1 0 0 0 0
2 0 0 0 0
3 0 0 0 0
4 0 0 0 0
5 0 0 0 0
6 0 0 0 0
7 0 0 0 0
8 0 0 0 0
Downstream Bit Rate (bits per second) = 24273316
Resource - Downstream Bandwidth
-------------------------------
Bkt Name Minor # of Major # of Excls # of Non-Ex Curr. Curr. Conf # of
No Level Times Level Times Level Times Level Resv Ovrsb Level Rej
1 0 0 0 0 0 0 100* 0.0 0.0 G 0
2 0 0 0 0 0 0 100* 0.0 0.0 G 0
3 0 0 0 0 0 0 100* 0.0 0.0 G 0
4 0 0 0 0 0 0 100* 0.0 0.0 G 0
5 0 0 0 0 0 0 100* 0.0 0.0 G 0
6 0 0 0 0 0 0 100* 0.0 0.0 G 0
7 0 0 0 0 0 0 100* 0.0 0.0 G 0
8 0 0 0 0 0 0 100* 12.3 0.0 G 0
Note: * indicates that the thresholds are implicit
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1141
Cable Commands: show a through show cable l
show cable admission-control
Resource - Modular Downstream Bandwidth
-------------------------------
Interface Total(Kbps) Reservable(Kbps) Allocated(Kbps)
Mo1/0/0:0 19405 12424 3100
Example of the Updated show cable admission-control Command Output for a Wideband Cable Interface in
Cisco IOS Release 12.2(33)SCF
The following example displays the upstream and downstream AC information for the wideband-cable
interface:
Router# show cable admission-control interface wideband-Cable 1/0/0:1
Interface Wideband-Cable1/0/0:1
Configured AC Max Reservable Bandwidth = 600000 bps
Resource - Downstream Bandwidth
-------------------------------
Bkt Name Minor # of Major # of Excls # of Non-Ex Curr. Curr. Conf # of
No Level Times Level Times Level Times Level Resv Ovrsb Level Rej
1 0 0 0 0 0 0 0 * 0.0 0.0 G 0
2 0 0 0 0 0 0 0 * 0.0 0.0 G 0
3 0 0 0 0 0 0 0 * 0.0 0.0 G 0
4 0 0 0 0 0 0 0 * 0.0 0.0 G 0
5 0 0 0 0 0 0 0 * 0.0 0.0 G 0
6 0 0 0 0 0 0 0 * 0.0 0.0 G 0
7 0 0 0 0 0 0 0 * 0.0 0.0 G 0
8 0 0 0 0 0 0 100* 1333.31233.3 G 0
Note: * indicates that the thresholds are implicit
Example of the Updated show cable admission-control verbose Command Output for a Wideband Cable Interface
in Cisco IOS Release 12.2(33)SCF
The following example displays the detailed upstream and downstream AC information for the
wideband-cable interface with the verbose keyword:
Router# show cable admission-control interface wideband-Cable 1/0/0:1 verbose
Interface Wideband-Cable1/0/0:0
Configured AC Max Reservable Bandwidth = 72000000 bps
Resource - Downstream Bandwidth
-------------------------------
Bkt Name Minor # of Major # of Excls # of Non-Ex Curr. Curr. Conf # of
No Level Times Level Times Level Times Level Resv Ovrsb Level Rej
1 DEF_MULTI 10 0 20 0 25 0 0 0.0 0.0 I 0
2 PKTCBL_N 2 0 3 0 5 0 0 0.0 0.0 I 0
3 PCMM_1 1 0 2 0 3 0 0 0.0 0.0 I 0
4 0 0 0 0 0 0 0 * 0.0 0.0 I 0
5 0 0 0 0 0 0 0 * 0.0 0.0 I 0
6 0 0 0 0 0 0 0 * 0.0 0.0 I 0
7 0 0 0 0 0 0 0 * 0.0 0.0 I 0
8 0 0 0 0 0 0 67 * 27.7 0.0 I 0
Note: * indicates that the thresholds are implicit
WB-NB CIR for Wideband-Cable1/0/0:0
CIR Values for Cable6/1/0
Bkt SFAC BW Rsvd CIR Reject #
1 4499750 0 0
2 1800000 0 0
3 540000 0 0
4 0 0 0
Cisco IOS CMTS Cable Command Reference
CBL-1142 OL-15510-15
Cable Commands: show a through show cable l
show cable admission-control
5 0 0 0
6 0 0 0
7 0 0 0
8 34120000 20000000 0
Available Guaranteed Bonus BW (bps): 2531250
Available Non-guaranteed Bonus BW (bps): 10125000
CIR Values for Cable6/1/1
Bkt SFAC BW Rsvd CIR Reject #
1 4499750 0 0
2 1800000 0 0
3 540000 0 0
4 0 0 0
5 0 0 0
6 0 0 0
7 0 0 0
8 14120000 0 0
Available Guaranteed Bonus BW (bps): 2531250
Available Non-guaranteed Bonus BW (bps): 10125000
WB Multicast CIR Utilization
Bkt SFAC BW Rsvd CIR Reject #
1 9000500 1000 0
2 0 0 0
3 1080000 0 0
4 0 0 0
5 0 0 0
6 0 0 0
7 0 0 0
8 0 0 0
Available Guaranteed Bonus BW (bps):
5062500 Available Non-guaranteed Bonus BW (bps): 10125000
Example of the Updated show cable admission-control Command Output for a Modular Cable Interface in
Cisco IOS Release 12.2(33)SCF
The following example displays upstream and downstream AC information for the specified modular
cable interface:
Router# show cable admission-control interface modular-Cable 1/0/0:1
Interface Mo1/0/0:1
Configured AC Max Reservable Bandwidth = 3000000 bps
Resource - Downstream Bandwidth
-------------------------------
Bkt Name Minor # of Major # of Excls # of Non-Ex Curr. Curr. Conf # of
No Level Times Level Times Level Times Level Resv Ovrsb Level Rej
1 0 0 0 0 0 0 100* 0.0 0.0 G 0
2 0 0 0 0 0 0 100* 0.0 0.0 G 0
3 0 0 0 0 0 0 100* 0.0 0.0 G 0
4 0 0 0 0 0 0 100* 0.0 0.0 G 0
5 0 0 0 0 0 0 100* 0.0 0.0 G 0
6 0 0 0 0 0 0 100* 0.0 0.0 G 0
7 0 0 0 0 0 0 100* 0.0 0.0 G 0
8 0 0 0 0 0 0 100* 0.0 0.0 G 0
Note: * indicates that the thresholds are implicit
Total Current Reservation = 0 bps
Guaranteed Bonus available/total = 13657000/13657000 bps
Non-guaranteed Bonus available/total = 13658000/13658000 bps
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1143
Cable Commands: show a through show cable l
show cable admission-control
Example of the Updated show cable admission-control Command Output for an Integrated Cable Interface in
Cisco IOS Release 12.2(33)SCF
The following example displays upstream and downstream AC information for the specified integrated
cable interface:
Router# show cable admission-control interface integrated-Cable 6/1/0:0
Interface In6/1/0:0
Configured AC Max Reservable Bandwidth = 300000 bps
Resource - Downstream Bandwidth
-------------------------------
Bkt Name Minor # of Major # of Excls # of Non-Ex Curr. Curr. Conf # of
No Level Times Level Times Level Times Level Resv Ovrsb Level Rej
1 0 0 0 0 0 0 100* 0.0 0.0 G 0
2 0 0 0 0 0 0 100* 0.0 0.0 G 0
3 0 0 0 0 0 0 100* 0.0 0.0 G 0
4 0 0 0 0 0 0 100* 0.0 0.0 G 0
5 ACFE 0 0 0 0 0 0 100* 0.0 0.0 G 0
6 0 0 0 0 0 0 100* 0.0 0.0 G 0
7 0 0 0 0 0 0 100* 0.0 0.0 G 0
8 0 0 0 0 0 0 100* 0.0 0.0 G 0
Note: * indicates that the thresholds are implicit
Total Current Reservation = 0 bps
Guaranteed Bonus available/total = 20028000/20028000 bps
Non-guaranteed Bonus available/total = 10009000/10009000 bps
The following example displays upstream and downstream AC information for the specified cable
interface:
Router# show cable admission-control interface cable 6/1/0
Interface Cable6/1/0
Resource - Upstream Bandwidth
-----------------------------
Thresholds applicable to upstream ports with no interface level configurations in place
Bucket Name Minor Major Exclusive Non-Excls Config
No Level Level Level Level Level
1 DEF_MULTI 15 20 25 10 I
2 UGS 15 20 25 10 I
3 PCMM_1 0 0 0 0* I
4 0 0 0 0* I
5 0 0 0 0* I
6 0 0 0 0* I
7 0 0 0 0* I
8 10 15 20 15 I
Downstream Bit Rate (bits per second) = 34307436
Resource - Downstream Bandwidth
-------------------------------
Bkt Name Minor # of Major # of Excls # of Non-Ex Curr. Curr. Conf # of
No Level Times Level Times Level Times Level Resv Ovrsb Level Rej
1 DEF_MULTI 1 0 3 0 10 0 0 0.0 0.0 I 0
2 UGS 10 0 15 0 20 0 5 0.2 0.0 I 0
3 PCMM_1 0 0 0 0 0 0 70 * 0.0 0.0 I 0
4 0 0 0 0 0 0 70 * 0.0 0.0 I 0
5 0 0 0 0 0 0 70 * 0.0 0.0 I 0
6 0 0 0 0 0 0 70 * 0.0 0.0 I 0
7 0 0 0 0 0 0 70 * 0.0 0.0 I 0
8 0 0 0 0 0 0 70 * 58.7 0.0 I 0
Cisco IOS CMTS Cable Command Reference
CBL-1144 OL-15510-15
Cable Commands: show a through show cable l
show cable admission-control
The following example displays upstream and downstream AC information with the global keyword:
Router# show cable admission-control global
CM registration event enabled
Dynamic service event enabled
Call preemption due to priority call enabled
Resource Minor #times Major #times Critical #times Current
cpu-5sec 50% 7 70% 0 99% 0 2
proc-mem 50% 0 80% 0 90% 0 11
io-mem 50% 1 60% 1 90% 0 75
total-mem 50% 0 80% 0 90% 0 36
Number of Packetcable voice calls = 80/100 (maximum)
Number of times voice count exceeded = 1
Resource - Upstream Bandwidth
-----------------------------
Thresholds applicable to upstream ports with no interface or port level configurations in
place
Bucket Name Minor Major Exclusive Non-Excls
No Level Level Level Level
1 DEF_MULTI 5 8 20 10
2 UGS 5 10 15 5
3 PCMM_1 0 0 0 0
4 0 0 0 0
5 0 0 0 0
6 40 45 50 5
7 0 0 0 0
8 0 0 0 0
Resource - Downstream Bandwidth
-------------------------------
Thresholds applicable to interfaces with no interface level configurations in place
Bucket Name Minor Major Exclusive Non-Excls
No Level Level Level Level
1 DEF_MULTI 0 0 0 0
2 UGS 0 0 0 0
3 PCMM_1 0 0 0 0
4 0 0 0 0
5 0 0 0 0
6 0 0 0 0
7 0 0 0 0
8 0 0 0 0
Table 42 describes the significant fields for the show cable admission-control command for upstream
and downstream throughput.
Table 42 show cable admission-control Field Descriptions
Field Description
Bucket No Specific bucket number.
Names Bucket name.
Minor Level Minor threshold as currently defined in a percentage on the Cisco CMTS.
# of Times Number of times traffic has crossed this threshold since the counters on the
Cisco CMTS were last cleared.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1145
Cable Commands: show a through show cable l
show cable admission-control
Table 42 show cable admission-control Field Descriptions (continued)
Field Description
Major Level Major threshold as currently defined in a percentage on the Cisco CMTS.
Excls Level Percentage of exclusive throughput that is reserved for the corresponding
traffic type on the Cisco CMTS. Applies to downstream or upstream traffic.
Non-Ex Level Percentage of non-exclusive throughput configured on the Cisco CMTS.
Commonly used with Best Effort (lowest priority) traffic.
Curr Resv Percentage of throughput reserved exclusively for the corresponding flow
type.
Conf Level Configuration level that indicates the scope of configuration is actually applied
for that US/ DS (whether the global, interface, or the upstream level is
applied). The values in this field can be as follows:
• U—Upstream
• I—Interface
• G—Global
# of Rejec Number of rejections.
Sched Type Available for upstream only. This field displays the following information:
• UGS—UGS thresholds configured and traffic rates.
• RTPS—RTPS thresholds configured and traffic rates.
• BE—Best Effort thresholds configured and traffic rates.
Flow Type Available for Downstream only. This field displays voice and data
information:
• voice—Voice thresholds configured and traffic rates.
• data—Data thresholds configured and traffic rates.
Class Name Available for upstream only.
CM-Registration Counter increments once for every cable modem that crosses a threshold
event during its registration. For example, if the minor, major, and critical thresholds
on the Cisco CMTS are 60%, 70%, and 80% respectively, and a cable modem
tries to register when the current value is 80%, then the cable modem is
allowed to register, but the counters for minor, major and critical thresholds are
each incremented by one.
Voice-Call event Counter increments if the resource check fails when a voice-call is made. For
example, assume both the MTAs are on the same Cisco CMTS, and minor,
major, and critical thresholds for I/O memory are 50%, 60%, and 70%,
respectively. Then assume the current I/O memory value is 75%. In this
scenario, before the gate creation, AC performs an I/O memory check. This
results in the counters for minor, major, and critical thresholds each being
incremented by one, and the voice call fails. No packetcable gates are created
because the voice calls fail.
Related Commands Command Description
cable admission-control Configures the CPU and memory thresholds for the Cisco CMTS and
supporting broadband processing engines.
cable admission-control Configures and enables AC event types.
event
Cisco IOS CMTS Cable Command Reference
CBL-1146 OL-15510-15
Cable Commands: show a through show cable l
show cable admission-control
Command Description
cable admission-control Configures AC downstream bandwidth thresholds.
ds-bandwidth
cable admission-control Defines the maximum reserved bandwidth per bonding group for all
max-reserved-bandwidth service flows that are allowed by the Cisco CMTS.
cable admission-control Configures AC upstream bandwidth thresholds.
us-bandwidth
clear cable admission Clears all AC resource counters.
control counters
debug cable Enables automatic AC troubleshooting processes.
admission-control
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1147
Cable Commands: show a through show cable l
show cable arp-filter
show cable arp-filter
To display the total number of Address Resolution Protocol (ARP) replies and requests that have been
sent and received, including the number of requests that have been filtered, use the show cable arp-filter
command in privileged EXEC mode.
show cable arp-filter cable slot/port [ip-requests-filtered number] [requests-filtered number |
replies-filtered number]
show cable arp-filter cable slot/subslot/port [ip-requests-filtered number] [requests-filtered
number | replies-filtered number]
Syntax Description cable slot/port Displays information for all CMs on the specified cable interface and
downstream port on the Cisco uBR7246VXR router.
On the Cisco uBR7246VXR router, slot can range from 3 to 6, and port can
be 0 or 1, depending on the cable interface.
cable slot/subslot/port Displays information for all CMs on the specified cable interface on the
Cisco uBR10012 router. The following are the valid values:
• slot = 5 to 8
• subslot = 0 or 1
• port = 0 to 4 (depending on the cable interface)
[ip-requests-filtered (Optional) Displays the Service IDs (SIDs) that are generating or forwarding
number] more filtered ARP requests for IP packets than the specified minimum
number of packets. The valid range for number is 1 to 65535, with no
default.
Note This field shows the modems that are forwarding IP traffic that could
be an part of an attack, such as TCP SYN floods, ping scans, and so
forth.
[requests-filtered (Optional) Displays the Service IDs (SIDs) that are generating or forwarding
number] more filtered ARP requests than the specified minimum number of packets.
The valid range for number is 1 to 65535, with no default.
[replies-filtered (Optional) Displays the Service IDs (SIDs) that are generating or filtering
number] more filtered ARP replies than the specified minimum number of packets.
The valid range for number is 1 to 65535, with no default.
Command Modes Privileged EXEC
Command History Release Modification
12.2(15)BC2 This command was introduced for the Cisco uBR7246VXR and
Cisco uBR10012 universal broadband routers.
12.2(15)BC2b The ip-requests-filtered option was added to display the specific Service
IDs (SIDs) that are generating or forwarding a minimum number of ARP
packets.
Cisco IOS CMTS Cable Command Reference
CBL-1148 OL-15510-15
Cable Commands: show a through show cable l
show cable arp-filter
Usage Guidelines The cable arp filter command enables the filtering of ARP request and reply packets on a cable
interface. ARP packets might need to be filtered when a user on the cable network generates a large
volume of ARP traffic as part of a theft-of-service or denial-of-service attack, or when a virus is using
ARP requests to find other computers that it might infect.
The show cable arp-filter command displays the total number of ARP reply packets that have been
received and the number of ARP request packets that have been sent on the cable interface, as well as
the number of such packets that have been filtered.
Tip To clear the counters on all interfaces, use the clear counters command. To clear the counters on a
specific interface, use the clear counters cable interface command.
Examples The following example shows the typical output from the show cable arp-filter command on a
Cisco uBR10012 router. The displays for other Cisco CMTS platforms are similar.
Router# show cable arp-filter Cable5/0/0
ARP Filter statistics for Cable5/0/0:
Replies Rcvd: 177387 total, 1869 unfiltered, 8824 filtered
Requests Sent For IP: 68625 total, 964 unfiltered, 36062 filtered
Requests Forwarded: 7969175 total, 7213 unfiltered, 366167 filtered
Router#
Table 0-43 describes the fields shown in the display.
Table 0-43 show cable arp-filter Field Descriptions
Field Description
Replies Rcvd
Total Total number of ARP reply packets received on the cable interface since
power-on.
Unfiltered Number of ARP reply packets that the cable interface received and accepted
while filtering was enabled using the cable arp filter reply-accept
command.
Filtered Number of ARP reply packets that the cable interface dropped while filtering
was enabled, because they would have otherwise exceeded the allowable
threshold value that was configured for the interface using the cable arp
filter reply-accept command.
Requests Sent For IP
Total Total number of ARP request packets that the cable interface was asked to
forward since power-on.
Unfiltered Number of ARP request packets that the cable interface sent while filtering
was enabled using the cable arp filter request-send command.
Filtered Number of ARP request packets that the cable interface dropped, because
they would have otherwise exceeded the allowable threshold value that was
configured for the interface using the cable arp filter request-send
command.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1149
Cable Commands: show a through show cable l
show cable arp-filter
Table 0-43 show cable arp-filter Field Descriptions (continued)
Field Description
Requests Forwarded
Total Total number of ARP request packets that the cable interface was asked to
forward to the ARP proxy since power-on.
Unfiltered Number of ARP request packets that the cable interface sent to the ARP
proxy while filtering was enabled using the cable arp filter request-send
command.
Filtered Number of ARP request packets for the ARP proxy that the cable interface
dropped, because they would have otherwise exceeded the allowable
threshold value that was configured for the interface using the cable arp
filter request-send command.
Note All counters are 16-bit counters, with a maximum value of 65,535 packets. If the number of
packets exceeds this amount, the counter wraps back to zero and begins incrementing again.
Note The Total counts in the show cable arp-filter command continue to increment, regardless of whether
ARP filtering has been enabled. The Unfiltered and Filtered counts increment only when ARP filtering
has been enabled using the cable arp filter command. When cable ARP filtering is disabled, these
counters retain their current values until manually reset, using the clear counters command.
The following example shows how to display the devices that are generating or filtering more than 100
ARP requests per reporting period. Repeat the command to see how quickly the device is generating
ARP packets.
Router# show cable arp-filter c7/0/0 requests-filtered 100
Sid MAC Address IP Address Req-Filtered Req-For-IP-Filtered Rep-Filtered
1 0006.2854.72d7 50.3.81.4 12407 0 0
Router# show cable arp-filter c7/0/0 requests-filtered 100
Sid MAC Address IP Address Req-Filtered Req-For-IP-Filtered Rep-Filtered
1 0006.2854.72d7 50.3.81.4 14597 0 0
Router#
The following example shows how to display the devices that are generating or filtering more than 200
ARP replies per reporting period. Repeat the command to see how quickly the device is generating ARP
packets.
Router# show cable arp-filter c5/0/0 replies-filtered 200
Sid MAC Address IP Address Req-Filtered Req-For-IP-Filtered Rep-Filtered
2 0006.53b6.562f 50.3.81.6 0 0 2358
Router# show cable arp-filter c5/0/0 replies-filtered 200
Sid MAC Address IP Address Req-Filtered Req-For-IP-Filtered Rep-Filtered
2 0006.53b6.562f 50.3.81.6 0 0 4016
Router#
Cisco IOS CMTS Cable Command Reference
CBL-1150 OL-15510-15
Cable Commands: show a through show cable l
show cable arp-filter
The following example shows how to display the devices that are generating or filtering more than 10
ARP requests for IP packets per reporting period. Repeat the command to see how quickly the device is
generating ARP packets.
Router# show cable arp-filter c3/0 ip-requests-filtered 10
Sid MAC Address IP Address Req-Filtered Req-For-IP-Filtered Rep-Filtered
2 0006.2854.71e7 50.3.72.4 0 1926 0
Router#
Table 0-44 describes the fields shown in the display.
Table 0-44 show cable arp-filter Detail Field Descriptions
Field Description
SID Service ID (SID) of the device.
MAC Address Hardware (MAC-layer) address of the cable modem or CPE device.
IP Address IP address of the cable modem or CPE device.
Req-Filtered Total number of ARP requests that the device has generated or forwarded.
Req-For-IP-Filtered Total number of ARP requests that the device has generated or forwarded for
IP packets.
Rep-Filtered Total number of ARP replies that the device has generated or forwarded.
Note The Req-Filter and Rep-Filtered counters are 16-bit counters, with a maximum value of 65,535
packets. If the number of packets exceeds this amount, the counter wraps back to zero and
begins incrementing again.
Clearing the ARP Packet Counters
The following example shows the cable ARP counters being cleared by the clear counters cable
interface command. This can be useful because the ARP counters are 16-bit counters that can wrap
around to zero relatively quickly when large amounts of ARP traffic is being generated. Also, the ARP
packet counters could include SIDs that had forwarded large amounts of ARP traffic in the past, but that
are not currently forwarding such traffic. Clearing the counters allows you to clearly see the SIDS that
are currently forwarding the ARP traffic that is triggering the ARP filters.
Router# show cable arp cable 3/0
ARP Filter statistics for Cable3/0:
Replies Rcvd: 3278 total. 84 unfiltered, 3194 filtered
Requests Sent For IP: 941 total. 30 unfiltered, 911 filtered
Requests Forwarded: 941 total. 37 unfiltered, 904 filtered
Router# show cable arp-filter cable 5/1/0 requests-filtered 10
Sid MAC Address IP Address Req-Filtered Req-For-IP-Filtered Rep-Filtered
1 0006.2854.72d7 10.3.81.4 8 0 0
23 0007.0e02.b747 10.3.81.31 32 0 0
57 0007.0e03.2c51 10.3.81.31 12407 0 0
...
81 00C0.c726.6b14 10.3.81.31 23 0 0
Router# clear counter cable 5/1/0
Clear "show interface" counters on this interface [confirm] y
08:17:53.968: %CLEAR-5-COUNTERS: Clear counter on interface Cable5/1/0 by console
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1151
Cable Commands: show a through show cable l
show cable arp-filter
Router# show cable arp cable 5/1/0
ARP Filter statistics for Cable3/0:
Replies Rcvd: 0 total. 0 unfiltered, 0 filtered
Requests Sent For IP: 0 total. 0 unfiltered, 0 filtered
Requests Forwarded: 0 total. 0 unfiltered, 0 filtered
Router# show cable arp-filter cable 5/1/0 requests-filtered 10
Sid MAC Address IP Address Req-Filtered Req-For-IP-Filtered Rep-Filtered
Router# show cable arp-filter cable 5/1/0 requests-filtered 10
Sid MAC Address IP Address Req-Filtered Req-For-IP-Filtered Rep-Filtered
57 0007.0e03.2c51 10.3.81.31 20 0 0
81 00C0.c726.6b14 10.3.81.31 12 0 0
Router# show cable arp-filter cable 5/1/0 requests-filtered 10
Sid MAC Address IP Address Req-Filtered Req-For-IP-Filtered Rep-Filtered
57 0007.0e03.2c51 10.3.81.31 31 0 0
81 00C0.c726.6b14 10.3.81.31 18 0 0
Router#
Note The clear counters command clears all of the packet counters on an interface, not just the ARP packet
counters.
Related Commands Command Description
cable arp Activates cable Address Resolution Protocol (ARP).
cable arp filter Controls the number of ARP packets that are allowable for each Service ID
(SID) on a cable interface.
cable proxy-arp Activates cable proxy ARP on the cable interface.
clear arp Clears the ARP table on the router.
clear counters Clears the packet counters on all interfaces or on a specific interface.
debug cable arp filter Displays debugging messages about the filtering of ARP broadcasts.
Cisco IOS CMTS Cable Command Reference
CBL-1152 OL-15510-15
Cable Commands: show a through show cable l
show cable bgsync
show cable bgsync
To display the statistics when SNMP background synchronization occurs on the Cisco CMTS, use the
show cable bgsync command in privileged EXEC mode.
show cable bgsync
Syntax Description This command has no keywords or arguments.
Command Default None.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.3(33)SCG This command was introduced.
Usage Guidelines Use the show cable bgsync command to view the SNMP synchronization information.
Examples The following is sample output of the show cable bgsync command on the cable interface at 8/0/0:
Router# show cable bgsync
Background Sync is active, uptime is 28 minutes, 59 seconds.
Background Sync last active time is 200 seconds since CMTS bootup.
I-packet interval time is 1 day, P-packet interval time is 5 seconds.
Line Card with bg-sync: 5/0 6/0 7/1 8/0
Line Card working on I syncing:
Last clear cable bg sync counters Time:
Total bytes: 446239
Total background sync packets: 3584
Ack packets: 2215
Run Ctrl Msg packets: 4
Data packets: 1365
Interval packets: 7377
I Type packets: 794
P Type packets: 6583
Mismatched packets: 0
Bg sync data IPC lost packets: 0
Router#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1153
Cable Commands: show a through show cable l
show cable bgsync
Table 72 describes the significant fields shown in the display.
Table 45 show cable bgsync Field Descriptions
Field Description
I-packet interval Time interval of the packets sent from line card to the route
processor (RP).
P-packet interval Time interval of the incremental packets sent from line card
to the RP.
Line Card with bgsync Line card where the background synchronization is active
Mismatched Packets Packets that are of a different IPC version.
Related Commands Command Description
cable bgsync Sets the data intervals for background synchronization on the Cisco CMTS.
cable bgsync active Activates background synchronization process on the Cisco CMTS.
clear bgsync counters Clears the background synchronization counters on the Cisco CMTS.
Cisco IOS CMTS Cable Command Reference
CBL-1154 OL-15510-15
Cable Commands: show a through show cable l
show cable bundle
show cable bundle
To display the forwarding table for the specified interface, use the show cable bundle in user EXEC or
privileged EXEC mode.
show cable bundle n forwarding-table
Syntax Description n Specifies the bundle identifier. Valid range is from 1 to 255.
forwarding-table Displays the forwarding table for the specified interface.
Command Modes User EXEC or Privileged EXEC
Command History Release Modification
12.0(7)XR2 This command was introduced.
12.0(8) SC This command was supported.
12.1(2) EC1 This command was supported.
12.2(4)BC1 Support was added to the Release 12.2 BC train.
12.1(13)EC, 12.2(11)BC1 The Flags, Location, link, and sublink fields were added to the display
to aid in debugging.
12.3(21)BC All cable bundles are now automatically converted and configured to be in
a virtual bundle, and standalone cable interfaces must be manually
configured to be in a virtual bundle to operate properly. Previously, new
virtual interface bundles and bundle members required reconfiguration, and
there could also be standalone interfaces not part of a bundle at all.
Usage Guidelines • Beginning with Cisco IOS Release 12.3(21)BC, all cable bundles are automatically converted and
configured to be in a virtual bundle after loading the software image.
• In releases prior to Cisco IOS Release 12.3(21)BC, if you delete the virtual bundle interface, the
virtual bundle disappears.
• Beginning with Cisco IOS Release 12.3(21)BC, standalone cable interfaces must be manually
configured to be in a virtual bundle to operate properly.
• The virtual bundle interface accumulates the counters from members; counters on member links are
not cleared when they are added to the bundle. If a bundle-only counter is desired, clear the bundle
counter on the members before adding them to the bundle, or before loading the image (for
Cisco IOS Release 12.3(21)BC and later).
Refer to the following document on Cisco.com for additional information about cable interface bundling
and virtual interface bundling on the Cisco CMTS:
• Cable Interface Bundling and Virtual Interface Bundling on the Cisco CMTS
Examples The following is a typical example of the show cable bundle command:
Router# show cable bundle 1 forwarding-table
MAC address Interface Flags Location link sublink
00c0.5e01.0203 Cable8/0/0 3 64E5BF60 0 64E5BE00
00c0.5e01.0203 Cable7/0/0 3 64E5BE00 0 0
00c0.5e01.0101 Cable8/0/0 3 64E5BEE0 0 64E5BE40
00c0.5e01.0101 Cable7/0/0 3 64E5BE40 0 0
00c0.a375.cc1c Cable8/0/0 1 64E5BEC0 0 0
00c0.0e01.a835 Cable8/0/0 1 64E5BEA0 0 0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1155
Cable Commands: show a through show cable l
show cable bundle
00c0.0e01.a799 Cable8/0/0 1 64E5BDE0 0 0
00c0.0e01.a405 Cable8/0/0 1 64E5BF00 0 0
00c0.0e01.a5d1 Cable7/0/0 1 64E5BE20 0 0
00c0.0e01.a5d9 Cable8/0/0 1 64E5BE60 0 0
00c0.0e01.a5e1 Cable7/0/0 1 64E5BF40 0 0
00c0.0e01.a5f1 Cable7/0/0 1 64E5BE80 0 0
00c0.0eb4.0a41 Cable5/0/0 1 63704D1C 0 0
00c0.f03b.ed59 Cable6/1/0 1 6370427C 0 0
00c0.f03b.ed97 Cable6/1/0 1 63703F3C 0 0
00c0.0eb4.1373 Cable5/0/0 1 6370479C 0 0
00c0.f03b.edd3 Cable6/1/0 1 637042BC 0 0
00c0.7371.6df6 Cable5/0/0 1 63703DFC 0 0
Table 0-46 describes the fields shown in the show cable bundle command display.
Table 0-46 show cable bundle Command Field Descriptions
Field Description
MAC address Identifies the MAC (hardware) address for each interface in the bundle.
Interface Identifies the cable interface slot and port number.
Flag The current value of the flag byte for this bundle entry. The following bits can
be set:
• Bit 0 (0x01) = Bundle is active.
• Bit 1 (0x02) = Bundle is a static multicast group.
Note If more than one bit is set, add the values together. For example, 3
indicates an active, static multicast group.
Location The location in the router’s memory for the flags byte for this bundle entry. This
value is useful only to TAC engineers during debugging.
link The value of the link pointer for this bundle entry. This value is useful only to
TAC engineers during debugging.
sublink The value of the sublink pointer for this bundle entry. This value is useful only
to TAC engineers during debugging.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
The following example shows typical output for the show cable bundle fowarding-table command,
supporting virtual interface bundling on the Cisco CMTS in later 12.3 BC Cisco IOS releases:
Router# show cable bundle 1 forwarding-table
MAC address Interface Flags Location link sublink
00c0.5e01.0203 Cable8/0/0 3 64E5BF60 0 64E5BE00
00c0.5e01.0203 Cable7/0/0 3 64E5BE00 0 0
00c0.5e01.0101 Cable8/0/0 3 64E5BEE0 0 64E5BE40
00c0.5e01.0101 Cable7/0/0 3 64E5BE40 0 0
00c0.a375.cc1c Cable8/0/0 1 64E5BEC0 0 0
00c0.0e01.a835 Cable8/0/0 1 64E5BEA0 0 0
00c0.0e01.a799 Cable8/0/0 1 64E5BDE0 0 0
00c0.0e01.a405 Cable8/0/0 1 64E5BF00 0 0
00c0.0e01.a5d1 Cable7/0/0 1 64E5BE20 0 0
00c0.0e01.a5d9 Cable8/0/0 1 64E5BE60 0 0
00c0.0e01.a5e1 Cable7/0/0 1 64E5BF40 0 0
00c0.0e01.a5f1 Cable7/0/0 1 64E5BE80 0 0
Cisco IOS CMTS Cable Command Reference
CBL-1156 OL-15510-15
Cable Commands: show a through show cable l
show cable bundle
00c0.0eb4.0a41 Cable5/0/0 1 63704D1C 0 0
00c0.f03b.ed59 Cable6/1/0 1 6370427C 0 0
00c0.f03b.ed97 Cable6/1/0 1 63703F3C 0 0
00c0.0eb4.1373 Cable5/0/0 1 6370479C 0 0
00c0.f03b.edd3 Cable6/1/0 1 637042BC 0 0
00c0.7371.6df6 Cable5/0/0 1 63703DFC 0 0
Total = 18, sublink total = 2
Free = 1016, low_mark = 1016
Related Commands Command Description
cable bundle Creates an interface bundle.
show ip interface brief Displays a brief summary of an interface's IP information and status,
to include virtual interface bundle information.
show pxf cable Displays multicast echo, packet intercept, or source-verify features
for one or all cable interfaces, to include information for virtual
interface bundles.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1157
Cable Commands: show a through show cable l
show cable bundle multicast
show cable bundle multicast
To display Multicast information for the specified virtual interface bundle, based on IGMPv3, use the
show cable bundle multicast command in privileged EXEC mode:
show cable bundle bundle# multicast group
show cable bundle bundle# multicast [ MAC addr | IP addr ]
Syntax Description bundle# The alphanumeric identifier for the virtual interface bundle.
group Multicast group membership identifier.
MAC addr Optional parameter specifies the MAC address for which to return
information.
IP addr Optional parameter specifies the IP address for which to return information.
Command Modes User EXEC or Privileged EXEC
Command History Release Modification
12.3(21)BC This command was introduced to support virtual interface bundling on the
Cisco CMTS. All cable bundles are now automatically converted and
configured to be in a virtual bundle, and standalone cable interfaces must be
manually configured to be in a virtual bundle to operate properly.
Previously, new virtual interface bundles and bundle members required
reconfiguration, and there could also be standalone interfaces not part of a
bundle at all.
Usage Guidelines • Beginning with Cisco IOS Release 12.3(21)BC, all cable bundles are automatically converted and
configured to be in a virtual bundle after loading the software image.
• In releases prior to Cisco IOS Release 12.3(21)BC, if you delete the virtual bundle interface, the
virtual bundle disappears.
• Beginning with Cisco IOS Release 12.3(21)BC, standalone cable interfaces must be manually
configured to be in a virtual bundle to operate properly.
• The virtual bundle interface accumulates the counters from members; counters on member links are
not cleared when they are added to the bundle. If a bundle-only counter is desired, clear the bundle
counter on the members before adding them to the bundle, or before loading the image (for
Cisco IOS Release 12.3(21)BC and later).
Refer to the following document on Cisco.com for additional information about cable interface bundling
and virtual interface bundling on the Cisco CMTS:
• Cable Interface Bundling and Virtual Interface Bundling on the Cisco CMTS
Examples The following example illustrates this new command. This command translates the bundle’s multicast
MAC address to Multicast IP address information, including the associated multicast source.
Router# show cable bundle bundle1.1 multicast
CableBundle Interface Source IP Multicast IP MAC Address
1 Bundle1.1 * 230.1.1.1 0100.5e00.0001
Cisco IOS CMTS Cable Command Reference
CBL-1158 OL-15510-15
Cable Commands: show a through show cable l
show cable bundle multicast
The following example illustrates multicast information for the specified virtual bundle:
Router# sh cable bundle 1 multicast
CableBundle Interface Source IP Multicast IP MAC Address
1 Bundle1 * 239.0.0.100 0100.5e00.0001
To translate a MAC address back to Multicast IP address, use the following optional syntax:
show cable bundle bundle# multicast [ <MAC addr | IP addr >]
The following example illustrates this enhanced show command:
Router# show cable bundle bundleID multicast 0100.5e00.0001
MAC address Interface Flags Location link sublink
0100.5e00.0001 Bundle1 1 646FE4D8 0 646FE4EC
0100.5e00.0001 Cable6/0/0 1 646FE4EC 0 0
^^^^^^^^^^^^^^
Related Commands Command Description
cable bundle Creates an interface bundle.
show ip interface brief Displays a brief summary of an interface's IP information and status,
to include virtual interface bundle information.
show pxf cable Displays multicast echo, packet intercept, or source-verify features
for one or all cable interfaces, to include information for virtual
interface bundles.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1159
Cable Commands: show a through show cable l
show cable burst-profile
show cable burst-profile
To display the upstream data burst profiles used to configure the upstream PHY, use the show cable
burst-profile command in privileged EXEC mode.
show cable burst-profile
Note This command has been deprecated and removed in the current versions of the Cisco IOS software for
all Cisco CMTS routers.
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC
Command History Release Modification
11.3 NA This command was introduced.
11.3(5)NA, 12.0(5)T1, This command was removed and replaced with the show cable
12.0(6)SC, 12.1(2)EC1 modulation-profile command.
Usage Guidelines This command displayed configuration of the cable burst profiles, which were what DOCSIS initially
used to control the data, ranging, and station maintenance bursts. The Cisco CMTS routers now support
a more comprehensive set of modulation profiles, which are displayed by the show cable
modulation-profilecommand.
Note The show cable burst-profile command displayed fields and values that were supported only in the
initial versions of the DOCSIS specification. The current DOCSIS 1.0 and 1.1 specifications use
different parameters and values, as shown by the show cable modulation-profile command.
Examples The following example shows typical output from the show cable burst-profile command:
Router# show cable burst-profile
Burst Type Preamb Diff FEC err FEC Scrambl Max Guard Last Scrambl profile
number length size size shortened
1 1 48 no 0x0 0x6 0x152 1 16 1 yes
2 1 48 no 0x0 0x6 0x152 1 12 1 no
3 1 48 no 0x5 0x2C 0x152 0 48 1 yes
4 1 48 no 0x5 0x2C 0x152 0 48 1 yes
5 1 48 no 0x5 0x32 0x152 0 20 1 yes
6 1 48 no 0x0 0x32 0x152 0 20 1 no
Router#
Cisco IOS CMTS Cable Command Reference
CBL-1160 OL-15510-15
Cable Commands: show a through show cable l
show cable burst-profile
Table 0-47 describes the fields shown in the show cable burst-profile command display.
Table 0-47 show cable burst-profile Field Descriptions
Field Description
Burst profile number The number of the burst profile.
Type Type of burst profile.
Preamb length Length of the preamble.
Diff encode Shows if there is a diff encode.
FEC err correct Shows the forward error correction.
FEC codeword length Shows the length of the forward error correction codeword.
Scrambl seed Shows the seed of the scrambler.
Max size Designates the maximum burst size.
Guard size Indicates the guard time size.
Last codeword shortened Shows the last codeword shortened.
Scrambl Indicates whether scramble is enabled (yes) or not (no).
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Related Commands Command Description
cable upstream Configures a spectrum group to use a specified frequency.
modulation-profile
show cable hop Displays CM configuration settings.
show cable Displays the currently defined modulation profiles.
modulation-profile
show interface cable sid Displays cable interface information.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1161
Cable Commands: show a through show cable l
show cable calls
show cable calls
To display voice call history information and status for PacketCable Emergency 911 Services Listing
and History, use the show cable calls command in privileged EXEC mode. This command displays
voice call history information that is enabled with the cable high-priority-call-window command in
global configuration mode.
show cable calls show cable calls [ interface cslot | slot/subslot ]
Syntax Description interface Selects the interface for which to enable PacketCable E911 call history.
slot | slot/subslot Designates the slot or slot and port for a particular cable interface on the
Cisco router.
The following are the valid values for the Cisco uBR7246VXR router:
• slot can range from 3 to 6
The following are the valid values for the Cisco uBR10012 router:
• slot = 5 to 8
• subslot = 0 or 1
Command Modes Privileged EXEC
Command History Release Modification
12.3(13a)BC This command was introduced supporting PacketCable Emergency 911
Services Listing and History on the Cisco CMTS:
• Cisco uBR7246VXR router
• Cisco uBR10012 router
Usage Guidelines This command supports the PacketCable Emergency 911 Services Listing and History feature on the
Cisco CMTS. Cisco IOS release 12.3(13a)BC introduces enhanced informational support for
PacketCable Emergency 911 calls on the Cisco CMTS, to include the following information and related
history:
• active Emergency 911 calls
• recent Emergency 911 calls
• regular voice calls
• voice calls made after recent Emergency 911 calls
To set the call window (in minutes) during which the Cisco CMTS maintains records of Emergency 911
calls, use the cable high-priority-call-window command in global configuration mode. To remove the
call window configuration from the Cisco CMTS, use the no form of this command:
cable high-priority-call-window minutes
no cable high-priority-call-window
Cisco IOS CMTS Cable Command Reference
CBL-1162 OL-15510-15
Cable Commands: show a through show cable l
show cable calls
The following command example configures the call window on the Cisco uBR10012 router to be one
minute in length:
Router(config)# cable high-priority-call-window 1
Additional information for voice call support with PacketCable and PacketCable MultiMedia (PCMM)
is available in the following document on Cisco.com:
• PacketCable and PacketCable Multimedia for the Cisco CMTS
Examples The following example illustrates call status on the Cisco CMTS:
Router# show cable calls
Interface ActiveHiPriCalls ActiveAllCalls PostHiPriCallCMs RecentHiPriCMs
Cable3/0 0 0 0 1
Cable3/1 0 0 0 0
Cable4/0 0 0 0 1
Cable4/1 0 0 0 0
Total 0 0 0 2
Router #
The following command example illustrates that one Emergency 911 call was made on the Cable8/1/1
interface on the Cisco uBR10012 router during the window set for high priority calls:
Router# show cable calls
Interface ActiveHiPriCalls ActiveAllCalls PostHiPriCallCMs RecentHiPriCMs
Cable5/0/0 0 0 0 0
Cable5/0/1 0 0 0 0
Cable5/1/0 0 0 0 0
Cable5/1/1 0 0 0 0
Cable5/1/2 0 0 0 0
Cable5/1/3 0 0 0 0
Cable5/1/4 0 0 0 0
Cable6/0/0 0 0 0 0
Cable6/0/1 0 0 0 0
Cable7/0/0 0 0 0 0
Cable7/0/1 0 0 0 0
Cable8/1/0 0 0 0 0
Cable8/1/1 1 1 0 0
Cable8/1/2 0 0 0 0
Cable8/1/3 0 0 0 0
Cable8/1/4 0 0 0 0
Total 1 1 0 0
Related Commands Command Description
cable Sets the call window (in minutes) during which the Cisco CMTS maintains
high-priority-call-win records of Emergency 911 calls.
dow
show cable modem Displays voice call information for a particular cable modem.
calls
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1163
Cable Commands: show a through show cable l
show cable cgd-associations
show cable cgd-associations
To display the Channel Group Domain (CGD) downstream associations on the Cisco CMTS, use the
show cable cgd-associations command in privileged EXEC mode.
show cable cgd-associations
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC(#)
Command History Release Modification
12.2(33)SCG This command was introduced.
Examples The following is a sample output of the show cable cgd-associations command displaying the
Cisco Wideband SPA downstream association with Cisco uBR-MC3GX60V line card:
Router# show cable cgd-associations
CGD Host Resource DS Channels Upstreams (AllUS) Active Remote DS
Ca7/0/0 7/0/0 0-3 0-1
Ca7/0/1 7/0/1 0 0 Yes
Ca7/0/2 7/0/2 0 0 Yes
Ca7/0/3 7/0/3 0 0 Yes
Ca7/0/4 7/0/4 0 -- Yes
!Cisco Wideband SPA Downstream associated with Cisco uBR-MC3GX60V MAC-Domain
Ca8/0/0 1/1/0 0 0-3 Yes 0
Ca8/0/1 8/0/0 0-3 0
Ca8/0/4 8/0/2 4 0-3
Ca8/0/5 8/0/2 5 0-3
Ca8/0/6 8/0/2 6 0-3
Ca8/0/7 8/0/2 7 0-3
Ca8/0/8 8/0/0 8 -- Yes
23 -- Yes
8/0/1 8 -- Yes
23 -- Yes
8/0/2 8 -- Yes
23 -- Yes
Ca8/0/9 8/0/0 9 -- Yes
8/0/1 9 -- Yes
8/0/2 9 -- Yes
Ca8/0/10 8/0/0 10 0-3 Yes
8/0/1 10 0-3 Yes
8/0/2 10 0-3 Yes
Ca8/0/11 8/0/0 11 -- Yes
Cisco IOS CMTS Cable Command Reference
CBL-1164 OL-15510-15
Cable Commands: show a through show cable l
show cable cgd-associations
8/0/1 11 -- Yes
8/0/2 11 -- Yes
Ca8/0/12 8/0/0 12 0-3 Yes
8/0/1 12 0-3 Yes
8/0/2 12 0-3 Yes
Ca8/0/13 8/0/0 13 0-3 Yes
8/0/1 13 0-3 Yes
8/0/2 13 0-3 Yes
Ca8/0/14 8/0/0 14 0-3 Yes
8/0/1 14 0-3 Yes
8/0/2 14 0-3 Yes
Table 48 describes the fields shown in the show cable cgd-associations command display.
Table 48 show cable cgd-associations Field Descriptions
Field Description
CGD Host MAC Domain interface for CGD.
Resource Downstream cable interface line card.
DS Channels Downstream RF channels.
Upstreams (AllUS) Upstream channels in the MAC domain.
Active Remote DS Active downstream channels.
Related Commands Command Description
show cable mac-domain cable cgd-associations Displays the summary of the CGD associations for
all cable MAC domains.
show cable mac-domain cable slot/port Displays the MAC Domain Downstream Service
downstream-service-group Group information for a primary downstream
channel.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1165
Cable Commands: show a through show cable l
show cable clock
show cable clock
To display clock reference status information for the clock card and to display information about
displaying Timing, Communicaton and Control (TCC) card DOCSIS Timimg Interface (DTI) client and
server statistic counts, use the show cable clock command in user EXEC or privileged EXEC mode.
show cable clock [slot] {client port id | server port id | counters}
Syntax Description slot (Optional) Identifies a TCC interface on the Cisco RF Gateway 10. Valid
TCC slots are 13 and 14.
client port id Specifies the DTI client port ID. Valid port values are 1 and 2.
server port id Specifies the DTI server port ID. Valid port values are 1 and 2.
counters Specifies the DTI client counters.
Command Default Information on the TCC DTI client and server is displayed. Counters are not displayed.
Command Modes User EXEC or Privileged EXEC
Command History Release Modification
12.1(1a)T1 This command was introduced.
12.1(2)EC1 This command was supported on the EC train.
12.2(1)XF1, This command was supported for the Cisco uBR10012 universal broadband
12.2(4)BC1 router.
12.3(23)BC This command was supported for DTI mode.
12.2(44)SQ This command was modified in Cisco IOS Release 12.2(44)SQ to support
the Cisco RF Gateway 10. The slot, client, server, and counters options
were added.
Usage Guidelines This command supports the Cisco CMTS clock feature set, which provides a synchronized clock for
improved Voice-over-IP (VoIP) operations. The clock feature set requires one of the following
configurations:
• A Cisco uBR10012 router with one or two TCC+ cards that are connected to an external national
clock source.
Note Beginning in Cisco IOS Release 12.3(23)BC, TCC+ is replaced with DOCSIS Timing and
Control Card (DTCC).
• A Cisco uBR7246 VXR router using a Cisco uBR-MC16S, Cisco uBR-MC16E,
Cisco uBR-MC28C, or Cisco uBR-MC28C-BNC cable interface line card. The router must also be
equipped with a Cisco cable clock card and be running Cisco IOS 12.1(1a)T1, 12.1(2)EC1, or a later
release. The Cisco cable clock card should be connected to an external national clock source.
Cisco IOS CMTS Cable Command Reference
CBL-1166 OL-15510-15
Cable Commands: show a through show cable l
show cable clock
Only these cable interface cards support the external clock card reference from a clock card to distribute
that signal to CMs or set-top boxes (STBs) attached to the specific network segments. You can use other
cable interface cards, such as the Cisco uBR-MC16C, with the clock card, but these other cable
interfaces will not synchronize their downstream SYNC messages with the external clock source.
Each CM or STB must also support VoIP applications and the clock feature set. For example, the
Cisco uBR924, running Cisco IOS Release 12.0(7)T or later, supports clock card feature automatically.
Note This command does not appear if a clock card is not installed in the system.
Examples The following sample output from the show cable clock command on a Cisco uBR7246VXR router
shows that both external sources are available and the clock card is providing the clock reference:
Router# show cable clock
Clockcard primary input is present
Clockcard secondary input is present
Cable clock reference is clockcard primary input
Cable3/0 Timestamp clock reference is from Clockcard
Cable4/0 Timestamp clock reference is from Clockcard
The following sample output from the show cable clock command on a Cisco uBR10012 router shows
that both external sources are available and that the TCC+ card in slot 1/1 is providing the clock
reference:
Router# show cable clock
Number of TCCplus Cards in the Chassis: 2
Active TCCplus Card is in slot: 1 subslot: 1
Backup TCCplus Card is in slot: 2 subslot: 1
Clock reference used by the active card is Primary T1
External T1 References:
Card: 1/1
Primary T1 : Available
Secondary T1: Available
Card: 2/1
Primary T1 : Available
Secondary T1: Available
The following sample output from the show cable clock command on a Cisco uBR10012 router shows
that the TCC+ card in slot 1/1 is in maintenance mode, and that the TCC+ card in slot 2/1 is providing
the clock reference:
Router# show cable clock
Number of TCCplus Cards in the Chassis: 2
TCCplus card in 1/1 under maintenance
Active TCCplus Card is in slot: 2 subslot: 1
Clock reference used by the active card is Primary T1
External T1 References:
Card: 2/1
Primary T1 : Available
Secondary T1: Available
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1167
Cable Commands: show a through show cable l
show cable clock
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
The following sample output from the show cable clock command on a Cisco uBR10012 router shows
that the DTCC card in slot 1/1 is in DTI mode.
Router# show cable clock
Number of TCC Cards in the Chassis: 1
Active TCC Card is in slot: 1 subslot: 1,(DTCC Eightbells card)
Clock reference used by the active card is DTI
Active TCC card in slot 1/1
TCC Card 1/1 DTI status:
-------------------------------------------
Active Client port : 2
Active Client status : normal
Active Client Server status : freerun
Active Client frame error rate : < 2%
Active Client CRC error count : 0xAD
Standby Client Signal detected : yes
No card in slot 2/1
Cisco RF Gateway 10
The following example shows the TCC DTI client and server statistic counts information:
Router# show cable clock
DTI Client status: TCC 13
-----------------
Client status : normal
Client clock type : ITU type 1
Client firmware version : 7
Client dti version : 0
Client timestamp : 657519453
Client phase correction : 65535
Client normal time : 65535
Client holdover time : 0
Client transition t3 count : 0
Client transition t4 count : 1
Client transition t6 count : 0
Client transition t7 count : 0
Client port switch count : 1
Client Integral Frequency Term : 64518
Client EFC Value : 63282
DTI Client Port 1 Status:
-------------------------
Port Status : Active
Signal detected : yes
CRC error count : 2
Frame error rate : < 2%
Cable advance : 2560
-- Connected server information ---
Server status : Active free-run
Root Server clock type : ITU type 3
Root Server source : none
Server Type : Root
Client Performance Stable : yes
Client Cable advance Valid : yes
Cisco IOS CMTS Cable Command Reference
CBL-1168 OL-15510-15
Cable Commands: show a through show cable l
show cable clock
DTI Client Port 2 Status:
-------------------------
Port Status : Inactive
Signal detected : no
CRC error count : 66
Frame error rate : > 5%
Cable advance : 0
DTI Client status: TCC 14
-----------------
Client status : normal
Client clock type : ITU type 1
Client firmware version : 7
Client dti version : 0
Client timestamp : 672169320
Client phase correction : 65535
Client normal time : 65535
Client holdover time : 0
Client transition t3 count : 0
Client transition t4 count : 1
Client transition t6 count : 0
Client transition t7 count : 0
Client port switch count : 1
Client Integral Frequency Term : 64760
Client EFC Value : 63832
DTI Client Port 1 Status:
-------------------------
Port Status : Inactive
Signal detected : no
CRC error count : 26
Frame error rate : > 5%
Cable advance : 0
DTI Client Port 2 Status:
-------------------------
Port Status : Active
Signal detected : yes
CRC error count : 2
Frame error rate : < 2%
Cable advance : 1792
-- Connected server information ---
Server status : Active free-run
Root Server clock type : ITU type 3
Root Server source : none
Server Type : Root
Client Performance Stable : yes
Client Cable advance Valid : yes
The following is sample output of a TCC card in slot 13 on a Cisco RF Gateway 10:
Router#show cable clock 13 client 1
DTI Client Port 1 Status:
-------------------------
Port Status : Inactive
Signal detected : no
CRC error count : 63006
Frame error rate : > 5%
Cable advance : 0x0000
Table 49 describes the significant fields shown in the display.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1169
Cable Commands: show a through show cable l
show cable clock
Table 49 show cable clock client Field Descriptions
Field Description
Port status Indicates the current status of the DTI port on the TCC card.
Signal detected Indicates whether the DTI signal was detected.
CRC error count The number of cyclic redundancy check (CRC) errors. It can
indicate intermittent upstream, laser clipping, or
common-path distortion.
The following example shows the server status of the TCC card in slot 13 on a Cisco RFGW-10:
Router#show cable clock 13 server 2
TCC Card 13 port 2 DTI Server status:
--------------------------------------
Server signal detected : yes
Server status : free-run
Root Server clock type : ITU type 3
Root Server source : none
Server Type : Root
Client Performance Stable : yes
Client Cable advance Valid : yes
TOD Setting Mode : Short
TOD gpssec : 902825745
TOD leap seconds : 14
Table 50 describes the significant fields shown in the display.
Table 50 show cable clock server Field Descriptions
Field Description
Server signal detected Indicates whether the server was detected.
Server status Indicates the state in which the serer is functioning. The
states are warm-up, free-run state, fast mode, normal,
holdover, or bridge mode.
Root server source The server source such as internal, external, GPSor none.
Root server clock type The clock type. The types are 1, 2, 3 or ITU Stratum 3 or DTI
Min. clock.
TOD setting mode Displays the time (user time, NTP, GPS) mode such as short
or long.
The following is a sample output showing the counters on TCC card 13 on Cisco RFGW-10:
Router#show cable clock 13 counters
TCC Card 13 DTI counters:
-------------------------
Client Normal time : 0x1EB6
Client Holdover time : 0x0000
Client Phase Correction : 0
Client Freq Correction : 63213
Client EFC Correction : 61039
Client transition count t3 : 0
Client transition count t4 : 1
Cisco IOS CMTS Cable Command Reference
CBL-1170 OL-15510-15
Cable Commands: show a through show cable l
show cable clock
Client transition count t6 : 0
Client transition count t7 : 0
Client port switch count : 1
Related Commands Command Description
show controllers clock-reference Displays hardware information, register values, and current
counters for the cable clock card.
show cable clock dti status Displays information on the DOCSIS Timing Interface (DTI)
Client status.
cable clock free-run Allows the clock to be in free-run mode.
clear cable clock counters Clears DTI client transition counters of a TCC DTI client and
server.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1171
Cable Commands: show a through show cable l
show cable clock dti counters
show cable clock dti counters
To display DTI counters for the clock card, use the show cable clock dti counters command in user
EXEC or privileged EXEC mode.
show cable clock dti counters slot/subslot
Syntax Description slot/subslot Specifies the slot and subslot location of the DTCC ports. Valid values are 1/1 or
2/1.
Command Modes. User EXEC or Privileged EXEC
Command History Release Modification
12.3(23)BC This command was supported for DTI mode.
Examples The following is a sample output from the show cable clock dti counters command in user EXEC mode:
Router> show cable clock dti counters 1/1
TCC Card 1/1 DTI counters:
-------------------------------------------
Client Normal time : 0xFFFF
Client Holdover time : 0x0000
Client Phase Correction : 0x0000
Client Freq Correction : 0xFBD7
Client EFC Correction : 0xF7AD
Client transition count t3 : 0x00
Client transition count t4 : 0x01
Client transition count t6 : 0x00
Client transition count t7 : 0x00
Related Commands Command Description
cable clock dti clear-counters Resets the counters that are displayed with the show cable
clock dti counters command.
show cable clock dti status Displays information on the DOCSIS Timing Interface (DTI)
Client status.
Cisco IOS CMTS Cable Command Reference
CBL-1172 OL-15510-15
Cable Commands: show a through show cable l
show cable clock dti status
show cable clock dti status
To display information on the DOCSIS Timing Interface (DTI) Client status, use the show cable clock
dti status command in privileged EXEC mode.
show cable clock dti status
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC
Command History Release Modification
12.3(23)BC This command was introduced for the Cisco uBR10012 router.
Usage Guidelines Use this command to display information on the DTI Client status.
Examples The following is a sample output from the show cable clock dti command:
Router# show cable clock dti status
Status of DTI component:
Active TCC card in slot 1/1
TCC Card 1/1 DTI status:
-------------------------------------------
Active Client port : 2
Active Client status : normal
Active Client Server status : freerun
Active Client frame error rate : < 2%
Active Client CRC error count : 0x06
Standby Client Signal detected : no
No card in slot 2/1
Related Commands Command Description
show cable clock Displays clock reference status information for the clock card.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1173
Cable Commands: show a through show cable l
show cable device access-group
show cable device access-group
To display a list of CMs and their customer premises equipment (CPE) devices, along with their access
groups, use the show cable device access group command in privileged EXEC mode.
show cable device [ip-address] access-group
Note The show cable device access-group command is not supported on the Cisco uBR10012 universal
broadband router.
Syntax Description ip-addr (Optional) Specifies the IP address for a particular CM or host.
Command Modes Privileged EXEC
Command History Release Modification
11.NA This command was introduced.
12.1(3a)EC1 Support was added to the Release 12.1 EC train.
12.2(4)BC1 Support was added to the Release 12.2 BC train for the Cisco uBR7100
series and Cisco uBR7200 series routers. (This command might appear in
the CLI for the Cisco uBR10012 router but is not functional.)
Usage Guidelines This command displays information about both CMs and their associated CPE devices. To display
information only for hosts and other CPE devices, use the show cable host access-group command. To
display information only for CMs, use the show cable modem access-group command.
If an SNMP manager is requesting information about CM or CPE devices at the same time that this
command is given, the command displays the following error message:
No information is available, please try later.
Wait until the SNMP retrieval is done and retry the CLI command.
Examples The following example shows how to display a list of the CMs and their hosts:
Router# show cable device access-group
MAC address IP address Type Access-group
00d0.ba77.7595 10.20.114.34 modem resident
0020.4065.828c 10.27.29.128 modem resident
0080.c6f9.b42e 24.168.220.52 host
0020.7806.defe 192.168.28.134 host
0020.4066.5c5c 10.27.33.128 modem resident
0050.baa0.5ccd 24.168.223.251 host
0020.4070.56d8 10.27.29.129 modem resident
0050.046f.f4cf 192.168.33.25 host
0020.40b4.0c80 10.27.33.129 modem resident
Cisco IOS CMTS Cable Command Reference
CBL-1174 OL-15510-15
Cable Commands: show a through show cable l
show cable device access-group
0050.bacf.5d89 192.168.37.113 host
0020.4071.698e 10.27.29.130 modem resident
0050.1800.a8cb 192.168.33.90 host
0020.407a.c196 10.27.33.130 modem resident
0040.d00f.44f0 192.168.34.128 host
0020.407f.0c2c 10.27.33.131 modem resident
0050.e456.9641 192.168.39.66 host
0020.4071.65de 10.27.29.131 modem resident
0050.badd.2883 192.168.32.230 host
0020.4071.64b4 10.27.29.132 modem resident
0050.badd.3b12 192.168.33.246 host
00D0.ba41.41fc 10.27.33.132 modem resident
0020.78c7.f887 192.168.32.32 host
00D0.ba3d.871e 10.27.29.133 modem resident
00e0.2969.a1a5 192.168.36.246 host
00D0.ba40.fff3 10.27.29.135 modem resident
0020.78d5.ddf0 192.168.32.107 host
00001.02c5.9936 192.168.38.233 host
00D0.ba40.fe30 10.27.33.157 modem resident
0020.78d0.fb32 192.168.28.45 host
00D0.ba3b.e08d 10.27.33.158 modem resident
0050.1800.f458 192.168.36.209 host
0002.e301.df8f 192.168.30.191 host
00D0.ba3e.7b9c 10.27.29.158 modem resident
00a0.2451.b7eb 24.168.223.41 host
00D0.ba3c.3ff2 10.27.29.160 modem resident
0080.c7db.afba 192.168.33.153 host
00D0.2717.1899 192.168.39.189 host
00D0.ba33.a164 10.27.33.161 modem resident
Router#
Table 0-51 describes the fields that are shown in the show cable device access-group display:
Table 0-51 Descriptions for the show cable device access-group Fields
Field Description
MAC Address The MAC address for the CM or CPE device.
IP Address The IP address that the DHCP server has assigned to the CM or CPE device.
Type Identifies the type of device:
• host = CPE device
• modem = cable modem
Access-group Displays the access group name or number in use (if any) for this CM or CPE
device.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Related Commands Command Description
cable device Configures the access list for a CM device or host.
cable host access-group Configures the access list for the specified hosts.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1175
Cable Commands: show a through show cable l
show cable device access-group
Command Description
clear cable host Clears the host from the table.
show cable host access-group Displays the hosts behind the CMs in the network, along with
their access groups.
show cable modem access-group Displays the access groups for the CMs on a particular cable
interface.
Cisco IOS CMTS Cable Command Reference
CBL-1176 OL-15510-15
Cable Commands: show a through show cable l
show cable dsg
show cable dsg
To display the current DOCSIS Set-Top Gateway (DSG) tunneling parameters, use the show cable dsg
command in privileged EXEC mode.
show cable dsg {stats | tunnel} [vendor CA-vendor-name | tunnel-mac-address]
Syntax Description stats Displays configuration and run-time statistics about the
currently-defined DSG tunnels.
tunnel Displays the mapping of DSG tunnels to vendors or well-known MAC
addresses.
vendor CA-vendor-name (Optional) Displays information about a specific Conditional Access
(CA) vendor. This parameter can be any arbitrary string up to 8
characters in length.
tunnel-MAC-address (Optional) Displays information for the specified well-known MAC
address for the DSG tunnel. If you specify a MAC address of
0000.0000.0000, the command displays information for all DSG
tunnels, which is the default display.
Defaults Displays information for all DSG tunnels.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(15)BC2 This command was introduced for the Cisco uBR7100 series and
Cisco uBR7246VXR routers.
12.3(9a)BC This command was introduced on the Cisco uBR10012 router.
12.3(13a)BC This command is obsolete and replaced by the show cable dsg tunnel
command.
Examples The following example shows a typical display for the show cable dsg tunnel form of the command:
Router# show cable dsg tunnel
Group-ip Src-ip Tunnel-MAC Interface Packets CA-vendor
225.2.2.2 * 0001.0002.0003 Cable3/0 1589 BBB
230.6.6.6 * 000d.000d.000d Cable3/0 12868464 abc
230.7.7.7 * 000e.000e.000e Cable3/0 24330138 abc
230.4.4.4 * 000b.000b.000b Cable3/0 22008648 cisco
230.5.5.5 * 000c.000c.000c Cable3/0 6424012 abc
229.1.1.1 * 0009.0009.0009 Cable3/0 12868440 cisco
228.1.1.1 * 0008.0008.0008 Cable3/0 6424012 cisco
230.1.1.1 * 000a.000a.000a Cable3/0 24370812 cisco
230.8.8.8 * 000f.000f.000f Cable3/0 23035116 abc
Router#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1177
Cable Commands: show a through show cable l
show cable dsg
The following example shows a typical display for the show cable dsg stats command:
Router# show cable dsg stats
DSG statistics information
DSG keepalive is set
Vendor: DDD, Tunnel count: 1
Vendor: BBB, Tunnel count: 2
Vendor name is DDD, tunnel MAC is 0001.0002.0003
Group address is 226.2.2.2, source address is *
Interface is Cable5/1, mapping entry is used 1
Received 5968 packets, forwarded 5289 packets
Dropped 679 packets, last second rate 16878 bits/sec
Vendor name is BBB, tunnel MAC is 0009.0010.0011
Group address is 227.2.2.2, source address is *
Interface is Cable3/0, interface Cable3/0 is bundle master
mapping entry is used 2
Received 0 packets, forwarded 0 packets
Dropped 0 packets, last second rate 0 bits/sec
Vendor name is CCC, tunnel MAC is 0005.0006.0007
Group address is 228.3.3.3, source address is *
Interface is Cable5/1, mapping entry is used 2
Received 5970056 packets, forwarded 400333 packets
Dropped 5569723 packets, last second rate 96768 bits/sec
Router#
The following example shows a typical display for the show cable dsg stats command for an individual
vendor:
Router# show cable dsg stats vendor CCC
DSG statistics information
DSG keepalive is set
Vendor: CCC, Tunnel count: 1
Vendor name is CCC, tunnel MAC is 0005.0006.0007
Group address is 228.3.3.3, source address is *
Interface is Cable5/1, mapping entry is used 2
Received 5970056 packets, forwarded 400333 packets
Dropped 5569723 packets, last second rate 96768 bits/sec
Router#
Note The packet counters for both the stats and tunnel options for a particular DSG tunnel continue to
increase as long as traffic is received over that tunnel. If the tunnel does not receive any traffic for three
minutes or more, the counters are automatically reset to 0.
The following example shows a typical display for the show cable dsg stats command for an individual
vendor when the associated cable interface is shut down. The Received, Forwarded, and Dropped
counters are not displayed when an interface is shut down.
Router(config)# interface c5/1
Router(config-if)# shutdown
Cisco IOS CMTS Cable Command Reference
CBL-1178 OL-15510-15
Cable Commands: show a through show cable l
show cable dsg
Router(config-if)# exit
Router(config)# exit
Router# show cable dsg stats vendor CCC
DSG statistics information
DSG keepalive is set
Vendor: CCC, Tunnel count: 1
Vendor name is CCC, tunnel MAC is 0005.0006.0007
Group address is 228.3.3.3, source address is *
Interface is Cable5/1, mapping entry is used 2
Router#
Table 52 describes the major fields shown in the show cable dsg command:
Table 52 show cable dsg Field Descriptions
Field Description
DSG keepalive is set If keepalive messages have been enabled for an IP multicast group,
using the cable dsg keepalive command, this message is displayed.
Dest-ip, Group address Multicast group IP address for the DSG stream.
Src-ip, Source address Source IP address for the DSG stream. If an asterisk (*) appears as
the source IP address, it indicates that the source IP address is
0.0.0.0, which allows any IP address as the source IP address.
Mapped-MAC, Tunnel-MAC Well-known MAC address used for the DSG tunnel. If you
configured the DSG tunnel with a MAC address of 0000.0000.0000
using the cable dsg command, this field shows the MAC address
that the CMTS derived using the MAC to IP multicast addressing
mapping that is specified in RFC 1112.
Interface Cable interface on which this DSG tunnel is configured.
mapping entry is used Number of times that this particular DSG tunnel mapping has been
used to resolve the well-known MAC address from the tunnel’s
group address. This can be used as a very rough approximation of
the number set-top boxes (STBs) that have been mapped to this
DSG tunnel since the last time the counter was cleared.
Note Use the clear cable dsg command to clear this counter.
Packets Number of packets transmitted over the DSG tunnel.
CA-vendor Name for the Conditional Access (CA) vendor that owns this tunnel.
Received Number of packets received by the multicast group. This counter
includes all interfaces that are receiving traffic for the multicast
group. The field is not shown when an interface is shut down, but
the counter continues to increase as long as the multicast group is
receiving traffic. When the interface is reenabled, the counter shows
the latest number of packets received.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1179
Cable Commands: show a through show cable l
show cable dsg
Table 52 show cable dsg Field Descriptions (continued)
Field Description
Forwarded Number of packets forwarded on the cable interface for the
multicast group. This counter is reset to 0 whenever an interface is
shut down and reenabled. The field is not shown when an interface
is shut down.
Dropped Number of packets that were dropped that were for the multicast
group. This counter includes all interfaces that are receiving traffic
for the multicast group. The field is not shown when an interface is
shut down, but the counter continues to increase as long as the
multicast group is receiving traffic and dropping packets. When the
interface is reenabled, the counter shows the latest number of
packets dropped.
Note The Received and Dropped counters reflect activity for the multicast group and are not affected when a
cable interface is shut down and reenabled, as long as the multicast group continues to receive traffic.
The Forwarded counter reflects activity for the particular cable interface and is reset to zero whenever
the interface is shut down and reenabled. All packet counters are also automatically reset to zero if the
DSG tunnel does not receive traffic for three minutes or more.
Related Commands Command Description
cable dsg Enables the DOCSIS Set-Top Gateway (DSG) on a cable interface, and
configures its tunnel-mapping parameters.
cable dsg keepalive Enables keepalive messages over DOCSIS Set-Top Gateway (DSG) tunnels
on a cable interface.
clear cable dsg Resets counters related to DOCSIS Set-Top Gateway (DSG) tunnels.
debug cable dsg Enables the display of debugging messages for the operation of the DOCSIS
Set-Top Gateway (DSG) feature.
Cisco IOS CMTS Cable Command Reference
CBL-1180 OL-15510-15
Cable Commands: show a through show cable l
show cable dsg cfr
show cable dsg cfr
To display DOCSIS Set-Top Gateway (DSG) classifier details, such as the classifier state, source, and
destination IP addresses, use the show cable dsg cfr command in privileged EXEC mode.
show cable dsg cfr [index] [verbose]
Syntax Description index DSG classifier identification. The valid range is from 1 to 65535.
verbose Provides detailed output for DSG classifiers.
Command Default Displays details of all DSG classifiers.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCG This command was introduced.
Examples The following is a sample output of the show cable dsg cfr command that shows details of all DSG
classifiers:
Router# show cable dsg cfr
cfr id state resolved applied conflict dest-ip src-ip
-------------------------------------- ----------------- -----------------
1000 en yes yes no 232.10.10.0 dsg-server-a
(40.0.0.30)
1010 en yes yes no 232.10.10.10 dsg-server-b
(40.0.0.40)
2000 en yes yes no 232.10.11.0 dsg-server-c
(40.0.0.50)
2010 en no no no 232.10.11.10 non-exist-hostnam
(----)
The following is a sample output of the show cable dsg cfr command that shows details of a specified
DSG classifier:
Router# show cable dsg cfr 1010
cfr id state resolved applied conflict dest-ip src-ip
-------------------------------------- ----------------- ---------------
1010 en yes yes no 232.10.10.10 dsg-server-b
(40.0.0.40)
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1181
Cable Commands: show a through show cable l
show cable dsg cfr
The following is a sample output of the show cable dsg cfr command with the verbose keyword that
shows detailed output for all DSG classifiers:
Router# show cable dsg cfr verbose
Cfr Id : 1000
State : enable
Resolved : yes
Applied : yes
Conflict : no
Conflict Cfr Id : --
Error Code : 0(DSG_CFR_ERR_NONE)
Tunnel Id : 1000
Dest Hostname : ----
Dest Hostname IP : ----
Dest IP : 232.10.10.0
Src Hostname : dsg-server-a
Src Hostname IP : 40.0.0.30
Src IP : 40.0.0.30
Src Prefix Length : 32
Dest Port Start : 2000
Dest Port End : 13821
Priority : 1
In DCD : yes
Forwarded : 0
Received : 0
Cfr Id : 1010
State : enable
Resolved : yes
Applied : yes
Conflict : no
Conflict Cfr Id : --
Error Code : 0(DSG_CFR_ERR_NONE)
Tunnel Id : 1010
Dest Hostname : ----
Dest Hostname IP : ----
Dest IP : 232.10.10.10
Src Hostname : dsg-server-b
Src Hostname IP : 40.0.0.40
Src IP : 40.0.0.40
Src Prefix Length : 32
Dest Port Start : 2000
Dest Port End : 13821
Priority : 1
In DCD : yes
Forwarded : 0
Received : 0
Cfr Id : 2000
State : enable
Resolved : yes
Applied : yes
Conflict : no
Conflict Cfr Id : --
Error Code : 0(DSG_CFR_ERR_NONE)
Tunnel Id : 2000
Dest Hostname : ----
Dest Hostname IP : ----
Dest IP : 232.10.11.0
Src Hostname : dsg-server-c
Src Hostname IP : 40.0.0.50
Src IP : 40.0.0.50
Cisco IOS CMTS Cable Command Reference
CBL-1182 OL-15510-15
Cable Commands: show a through show cable l
show cable dsg cfr
Src Prefix Length : 32
Dest Port Start : 13822
Dest Port End : 13822
Priority : 1
In DCD : yes
Forwarded : 0
Received : 0
Cfr Id : 2010
State : enable
Resolved : no
Applied : no
Conflict : no
Conflict Cfr Id : --
Error Code : 0(DSG_CFR_ERR_NONE)
Tunnel Id : 2010
Dest Hostname : ----
Dest Hostname IP : ----
Dest IP : 232.10.11.10
Src Hostname : non-exist-hostname
Src Hostname IP : ----
Src IP : 0.0.0.0
Src Prefix Length : 32
Dest Port Start : 2000
Dest Port End : 13821
Priority : 1
In DCD : yes
Forwarded : 0
Received : 0
Cfr Id : 3000
State : enable
Resolved : yes
Applied : yes
Conflict : no
Conflict Cfr Id : --
Error Code : 0(DSG_CFR_ERR_NONE)
Tunnel Id : 3000
Dest Hostname : ----
Dest Hostname IP : ----
Dest IP : 239.10.11.11
Src Hostname : ----
Src Hostname IP : ----
Src IP : 0.0.0.0
Src Prefix Length : 32
Dest Port Start : 2000
Dest Port End : 13821
Priority : 1
In DCD : yes
Forwarded : 0
Received : 0
The following is a sample output of the show cable dsg cfr command with the verbose keyword that
shows detailed output for a single DSG classifier:
Router# show cable dsg cfr 1010 verbose
Cfr Id : 1010
State : enable
Resolved : yes
Applied : yes
Conflict : no
Conflict Cfr Id : --
Error Code : 0(DSG_CFR_ERR_NONE)
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1183
Cable Commands: show a through show cable l
show cable dsg cfr
Tunnel Id : 1010
Dest Hostname : ----
Dest Hostname IP : ----
Dest IP : 232.10.10.10
Src Hostname : dsg-server-b
Src Hostname IP : 40.0.0.40
Src IP : 40.0.0.40
Src Prefix Length : 32
Dest Port Start : 2000
Dest Port End : 13821
Priority : 1
In DCD : yes
Forwarded : 0
Received : 0
Table 53 describes the significant fields shown in the show cable dsg cfr command display:
Table 53 show cable dsg cfr Field Description
Field Description
cfr id DSG classifier ID.
state DSG classifier state shown either as “enable” or “disable.”
resolved Indicates whether the destination and source IP addresses of a hostname are
resolved or not.
applied Indicates that a hostname is configured without any error.
conflict Indicates that the IP address of the hostname is changed after the hostname is
configured, and the DSG classifier cannot be updated due to an error.
dest-ip IP address configured as the destination IP address or the resolved hostname
IP address. This IP address might differ from the destination hostname IP
address if the classifier is not applied or in a conflict state.
src-ip IP address configured as the source IP address or the resolved hostname IP
address. This IP address might differ from the source hostname IP address if
the classifier is not applied or in a conflict state.
Conflict Cfr Id Indicates the classifier ID that conflicts with the new classifier due to an
identical MAC address or classifier ID.
Error Code Indicates why the classifier is resolved but cannot be applied.
Tunnel Id DSG tunnel ID.
Dest Hostname The hostname configured as the destination IP address.
Dest Hostname IP Resolved IP address of the destination hostname.
Src Hostname The hostname configured as the source IP address.
Src Hostname IP Resolved IP address of the source hostname.
Src Prefix Length Source prefix length of the source IP address.
Dest Port Start Start range for the Destination TCP/UDP port.
Dest Port End End range for the Destination TCP/UDP port.
Priority DSG classifier priority.
In DCD Indicates whether the DSG classifier is included or excluded from the
downstream channel descriptor (DCD) message.
Cisco IOS CMTS Cable Command Reference
CBL-1184 OL-15510-15
Cable Commands: show a through show cable l
show cable dsg cfr
Table 53 show cable dsg cfr Field Description (continued)
Field Description
Forwarded Forwarded statistics.
Received Received statistics.
Related CommandsR Command Description
show cable dsg host Displays the mapping of the DSG host names and IP addresses on the
Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1185
Cable Commands: show a through show cable l
show cable dsg host
show cable dsg host
To display the mapping of the hostnames and IP addresses on a Cisco CMTS router, use the
show cable dsg host command in privileged EXEC mode.
show cable dsg host [verbose]
Syntax Description verbose Provides verbose description on the mapping of the hostnames and IP
addresses.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCG This command was introduced.
Usage Guidelines The show cable dsg host command is used for debugging of host IP addresses.
Examples The following is a sample output of the show cable dsg host command that shows the mapping of the
host names and IP addresses on a Cisco CMTS router:
Router# show cable dsg host
Host IP Address Reference Last Update Time
dsgserver1 232.1.1.10 2 21:41 08/01/2011
dsgserver2 234.3.2.1 1 21:41 08/01/2011
dsgserver3 ---- 1 never
dsgserver4 ---- 1 never
dsgserver5 ---- 1 never
dsgserver6 235.5.5.5 1 21:41 08/01/2011
dsgserver7 235.0.0.2 1 21:41 08/01/2011
Cisco IOS CMTS Cable Command Reference
CBL-1186 OL-15510-15
Cable Commands: show a through show cable l
show cable dsg host
The following is a sample output of the show cable dsg host command with the verbose keyword on a
Cisco CMTS router:
Router# show cable dsg host verbose
Host IP Address Reference Last Update Time
dsgserver1 232.1.1.10 2 21:41 08/01/2011
Cfrs:
cable dsg cfr 2 dest-ip 232.1.1.125 tunnel 1 priority 0 src-ip a.b.c.d d...
cable dsg cfr 3 dest-ip 232.1.1.125 tunnel 1 priority 10 src-ip a.b.c.d ...
dsgserver2 234.3.2.1 1 21:41 08/01/2011
Cfrs:
cable dsg cfr 4 dest-ip aaabbccc priority 0 src-ip cccdddeee disable
dsgserver3 ---- 1 never
Cfrs:
cable dsg cfr 4 dest-ip aaabbccc priority 0 src-ip cccdddeee disable
dsgserver4 235.0.0.2 1 21:41 08/01/2011
Cfrs:
cable dsg cfr 24 dest-ip g2 priority 0 disable
dsgserver5 235.0.0.3 1 21:41 08/01/2011
Cfrs:
cable dsg cfr 30 dest-ip g3 tunnel 1 priority 0 disable
Table 53 describes the significant fields shown in the show cable dsg host command display:
Table 54 show cable dsg host Field Description
Field Description
Host Hostname of the DSG classifier.
IP Address IP address that is mapped to the hostname.
Reference DSG classifiers that use the host as a fully-qualified domain name (FQDN).
Last Update Time Last updated time of the DSG server.
Related Commands Command Description
show cable dsg cfr Displays DSG classifier details.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1187
Cable Commands: show a through show cable l
show cable dsg static-group bundle
show cable dsg static-group bundle
To display details of the DOCSIS Set-Top Gateway (DSG) static groups configured under a bundle
interface, use the show cable dsg static-group bundle command in privileged EXEC mode.
show cable dsg static-group bundle index
Syntax Description index Bundle interface number. The valid range is from 1 to 255.
Command Default None
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCG This command was introduced.
Usage Guidelines The IGMP static group IP address created automatically under a bundle interface at the time of DSG
configuration is not displayed in the show running-config interface command output in
Cisco IOS Release 12.2(33)SCG and later. To display the DSG static groups configured under a bundle
interface, use the show cable dsg static-group bundle command in privileged EXEC mode in
Cisco IOS Release 12.2(33)SCG and later.
Examples The following is a sample output of the show cable dsg static-group bundle command that lists the
DSG static groups configured under a bundle interface on the Cisco uBR10012 router:
Router# show cable dsg static-group bundle 2
Bundle Interface Group Source
Bundle2 228.0.0.1 0.0.0.0
Bundle2 228.0.0.1 1.2.3.4
Bundle2 232.1.1.1 2.3.4.5
Table 55 describes the significant fields shown in the show cable dsg static-group bundle command
display:
Table 55 show cable dsg static-group bundle Command Field Description
Field Description
Bundle Interface Bundle interface number.
Group DSG static group configured under the specified bundle interface.
Source SSM source address.
Cisco IOS CMTS Cable Command Reference
CBL-1188 OL-15510-15
Cable Commands: show a through show cable l
show cable dsg static-group bundle
Related Commands Command Description
cable dsg cfr Enables Advanced-mode DOCSIS Set-Top Gateway (A-DSG) classifiers on
the Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1189
Cable Commands: show a through show cable l
show cable dsg tg
show cable dsg tg
To display information about the Advanced-mode DOCSIS Set-top Gateway (A-DSG) tunnel group
configuration on a Cisco CMTS router, use the show cable dsg tg command in privileged EXEC mode.
show cable dsg tg [tunnel-group-id {channel channel-id} [verbose]]
Syntax Description tunnel-group-id (Optional) Alphanumeric identifier for a specified tunnel group.
channel channel-id Specifies the DSG tunnel group channel identifier.
verbose (Optional) Displays DSG tunnel group detail information.
Command Default None
Command Modes Privileged EXEC (#)
Command History Release Modification
12.3(17a)BC This command was introduced to support A-DSG on the Cisco uBR10012
router and Cisco uBR7200 series routers.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
12.2(33)SCD5 This command was modified. The output of the show cable dsg tg command
was changed.
12.2(33)SCG The command output was changed.
Usage Guidelines This command displays information about all DSG tunnel groups. Beginning with Cisco IOS Release
12.2(33)SCG, the “TG state” field in the show cable dsg tg command output was replaced by “Channel
state” to indicate that a channel belonging to a tunnel group is either enabled or disabled. It is possible
that a tunnel group is enabled but a particular channel in that tunnel group is disabled.
Examples The following is a sample output from the show cable dsg tg command with the configured parameters
for all DSG tunnel groups in Cisco IOS Release 12.2(33)SCG and later:
Router# show cable dsg tg
TG Chan Chan Rule Vendor UCID
id id state I/F pri Param list
----- ----- ----- ------ ---- ------ ---------------
10 1 en C6/0 0
10 2 en C6/0 0
10 3 en C6/1 0
10 4 en 0
10 5 en 0
10 6 en 0
Cisco IOS CMTS Cable Command Reference
CBL-1190 OL-15510-15
Cable Commands: show a through show cable l
show cable dsg tg
The following is a sample output from the show cable dsg tg command with the configured parameters
for all DSG tunnel groups in Cisco IOS Release 12.2(33)SCE and earlier:
Router# show cable dsg tg
TG Chan TG Rule Vendor UCID
id id state I/F pri Param list
1 1 en C5/0 16 1 1 2 3 4
1 2 en 0
2 1 en C5/0 11 2
C5/1
2 2 en 0
The following is a sample output from the show cable dsg tg 1 channel 1 command with the configured
parameters for all DSG tunnel groups for the specified tunnel group and channel.
Router# show cable dsg tg 1 channel 1
TG Chan Chan Rule Vendor UCID
id id state I/F pri Param list
1 1 en C5/0 16 1 1 2 3 4
The following is a sample output from the show cable dsg tg 1 channel 1 verbose command with the
detailed information for the specified tunnel group.
Router# show cable dsg tg 1 channel 1 verbose
TG: 1 Chan: 1 state: en pri: 16 Vendor: 1 UCID: 1 2 3 4
rule tunnel cfr clients
I/F id state id state mac-addr id state dest-ip In-DCD listId
C7/0/0 1 en 1 en 0101.5e01.0001 1 en 230.1.0.1 yes 1
6 en 231.1.1.6 no
7 en 231.1.1.7 no
8 en 231.1.1.8 no
2 en 2 en 0101.5e01.0002 2 en 230.1.0.2 yes 2
3 en 3 en 0101.5e01.0003 3 en 230.1.0.3 yes 3
The following is sample output of the show cable dsg tg command that displays the ignore option,
introduced in Cisco IOS Release 12.2(33)SCD5, under the ‘In DCD’ column.
Router# show cable dsg tg 1 channel 1 verbose
TG: 1 Chan: 1 state: en pri: 16 Vendor: 1 UCID: 1 2 3 4
rule tunnel cfr clients
I/F id state id state mac-addr id state dest-ip In-DCD listId
------ -------- ------------------------ ------------------------- --- -------
C7/0/0 1 en 1 en 0101.5e01.0001 1 en 230.1.0.1 ign 1
6 en 231.1.1.6 no
7 en 231.1.1.7 no
8 en 231.1.1.8 no
2 en 2 en 0101.5e01.0002 2 en 230.1.0.2 yes 2
3 en 3 en 0101.5e01.0003 3 en 230.1.0.3 yes 3
Table 1 describes the significant fields shown in the output.
Table 56 show cable dsg tg Field Descriptions
Field Description
TG id Tunnel group identifier.
Chan id Channel identifier.
TG state Current state of the cable interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1191
Cable Commands: show a through show cable l
show cable dsg tg
Table 56 show cable dsg tg Field Descriptions (continued)
Field Description
Chan state Current state of the channel (enabled or disabled).
pri Traffic priority parameter.
Vendor Vendor name.
UCID Upstream channel identifier.
I/F Interface.
rule id Rule identifier.
tunnel state Tunnel state.
mac-addr MAC address.
cfr state Classifier state.
dest-ip Destination IP address.
In-DCD Downstream channel descriptor.
clients listId Client list identifier.
Related Commands Command Description
debug cable dsg Enables general, DCD, or packet-related debugging.
show cable dsg tunnel Displays information about A-DSG tunnel configuration on a Cisco CMTS
router.
show interface Displays general interface information for the specified or all interfaces.
show interface cable Displays A-DSG configuration and status information for downstream
dsg downstream interfaces.
Cisco IOS CMTS Cable Command Reference
CBL-1192 OL-15510-15
Cable Commands: show a through show cable l
show cable dsg tunnel
show cable dsg tunnel
To display information about Advanced-mode DOCSIS Set-top Gateway (A-DSG) tunnel configuration
on a Cisco CMTS router, use the show cable dsg tunnel command in privileged EXEC mode.
show cable dsg tunnel tunnel-id [cfrs | clients | interfaces | statistics | verbose]
Syntax Description tunnel-id (Optional) Alphanumeric identifier for a specified tunnel.
cfrs Show DSG tunnel classifiers.
clients Show DSG tunnel clients.
interfaces Show DSG tunnel interfaces.
stats Show DSG tunnel statistics.
verbose Show DSG tunnel detail information.
Defaults No default behaviors or values
Command Modes Privileged EXEC (#)
Command History Release Modification
12.3(13a)BC This command was introduced to support A-DSG 1.1 on the
Cisco uBR10012 router and Cisco uBR7200 series routers.
12.3(17a)BC The output was modified to support A-DSG 1.2.
• The “TG id” field was added to the show cable dsg tunnel and verbose
forms of the command.
• The “State” and “MAC Addr” fields switched places in the show cable
dsg tunnel verbose form of the command.
• The “vendor group” field was added to the show cable dsg tunnel
clients form of the command.
12.2SB This command was integrated into Cisco IOS Release 12.2SB. Support for
the Cisco uBR7225VXR router was added.
Usage Guidelines This command replaces the show cable dsg form of command available in Cisco IOS
Release 12.3(9a)BC.
Examples The following example displays CLI help for show cable dsg tunnel command syntax.
Router# show cable dsg tunnel 1 ?
cfrs Show DSG tunnel classifiers
clients Show DSG tunnel clients
interfaces Show DSG tunnel interfaces
statistics Show DSG tunnel statistics
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1193
Cable Commands: show a through show cable l
show cable dsg tunnel
verbose Show DSG tunnel detail information
| Output modifiers
<cr>
Examples: Displaying information about all A-DSG Tunnels
The following command displays tunnel MAC address, state, associated classifiers, and state information
for Advanced-mode DSG version 1.1 tunnels on a Cisco CMTS router. This output was changed in Cisco
IOS Release 12.3(17a)BC for A-DSG version 1.2 (see following example).
Router# show cable dsg tunnel
tunnel tunnel tunnel cfr cfr tunnel in rule rule client service
id state mac-addr id state interface id state listId class
1 en 0100.5e01.0114 1 en Cable6/0 1 en 2 SI
5 en 7 en 10
11 en 8 en 2
14 en 20 en 2
Cable6/1 1 en 4
3 en 3
4 en 4
11 en 2
2 en 0100.5e01.011e 2 en Cable6/0 2 en 2 NDS-CA
10 en
3 en 0100.5e01.0128 3 en Cable6/0 3 en 3 NDS-APP
4 en 0100.5e01.0132 4 en Cable6/0 4 en 4 MOTO-CA
5 en 0100.5e01.013c 9 en Cable6/0 5 en 5 MOTO-APP
Cable6/1 5 en 5
6 dis 0100.5e01.0146 Cable6/0 6 en 6 SA-CA
Cable6/1 6 en 6
7 dis 0100.5e01.0150 7 en Cable6/1 8 en 7 SA-APP
13 dis
8 en 0100.5e01.0119 8 en NDS-DNLD
9 en 0100.5e01.0133 MOTO-DNLD
10 en 0100.5e01.0147 SA-DNLD
11 en 2222.2222.2222
12 en 3333.3333.3333 12 en
Beginning in Cisco IOS Release 12.3(17a)BC, this output was modified to add the tunnel group ID (“TG
id”) field in support of A-DSG version 1.2 as shown below:
Router# show cable dsg tunnel
tunnel TG cfr tunnel rule client service
id state mac-addr id id state I/F id state listId class
1 en 0100.5e01.0001 1 1 en C5/0 1 en 1 DSG-Rate1
6 en
7 en
8 en
2 en 0100.5e01.0002 1 2 en C5/0 2 en 2
3 en 0100.5e01.0003 1 3 en C5/0 3 en 3
4 en 0002.0002.0001 2 4 en C5/0 4 en 1
C5/1 1 en 1
5 en 0002.0002.0002 2 5 en C5/0 5 en 2 DSG-Rate2
C5/1 2 en 2
6 en 0002.0002.0003 2 9 en C5/0 6 en 21
C5/1 3 en 21
Examples: Displaying Information for a Specified A-DSG Tunnel
The following example displays the same information as the show cable dsg tunnel command, but for
a specified tunnel. The following example shows sample output for A-DSG version 1.1. This output was
changed in Cisco IOS Release 12.3(17a)BC for A-DSG version 1.2 (see following example).
Router# show cable dsg tunnel 1
tunnel tunnel tunnel cfr cfr tunnel in rule rule client service
id state mac-addr id state interface id state listId class
1 en 0100.5e01.0114 1 en Cable6/0 1 en 2 SI
5 en 7 en 10
11 en 8 en 2
Cisco IOS CMTS Cable Command Reference
CBL-1194 OL-15510-15
Cable Commands: show a through show cable l
show cable dsg tunnel
14 en 20 en 2
Cable6/1 1 en 4
3 en 3
4 en 4
11 en 2
Beginning in Cisco IOS Release 12.3(17a)BC, this output was modified to add the tunnel group ID (“TG
id”) field in support of A-DSG version 1.2 as shown below:
Router# show cable dsg tunnel 1
tunnel TG cfr tunnel rule client service
id state mac-addr id id state I/F id state listId class
1 en 0100.5e01.0001 1 1 en C5/0 1 en 1 DSG-Rate1
6 en
7 en
8 en
Examples: Displaying Information for A-DSG Tunnel Classifiers
The following example displays detailed information about all A-DSG classifiers associated with the
specified tunnel.
Router# show cable dsg tunnel 1 cfrs
tunnel cfr cfr cfr destination ip source ip srcPre d_port d_port
id id state pri address address length start end
1 1 en 1 230.1.1.20 0.0.0.0 32 0 65535
5 en 1 230.1.1.60 0.0.0.0 32 0 65535
11 en 1 224.25.25.134 0.0.0.0 32 0 65535
14 en 0 230.1.1.20 0.0.0.0 32 1000 2000
Examples: Displaying Information for A-DSG Tunnel Clients
The following example displays detailed information about all the clients associated with the specified
tunnel for A-DSG version 1.1. This output was changed in Cisco IOS Release 12.3(17a)BC for A-DSG
version 1.2 (see following example).
Router# show cable dsg tunnel 1 clients
tunnel client client client client
id listId id id type address
1 2 1 CA System ID 0X951
3 Broadcast
8 MAC Addr 1111.1111.1111
3 1 Application ID 0X1
4 1 CA System ID 0X701
10 1 Application ID 0X6
Beginning in Cisco IOS Release 12.3(17a)BC, this output was modified to add the “vendor group” field
in support of A-DSG version 1.2 as shown below:
Router# show cable dsg tunnel 1 clients
tunnel client client client client vendor
id listId id id type address group
1 1 1 MAC Addr 0100.5e00.0001
2 Application ID 0x0951
3 Broadcast Unspecified
4 Broadcast 4
Examples: Displaying Information for A-DSG Tunnel Interfaces
The following example displays all the interfaces and rules associated with a specified tunnel.
Router# show cable dsg tunnel 1 interfaces
tunnel downstream rule
id interface id
1 Cable6/0 1 7 8 20
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1195
Cable Commands: show a through show cable l
show cable dsg tunnel
Cable6/1 1 3 4 11
Examples: Displaying Information for A-DSG Tunnel Statistics
The following example displays the packets statistics information about the specified tunnel.
Router# sh cab dsg tunnel 1 statistics
tunnel cfr cfr destination ip source ip total total
id id state address address forwarded received
1 1 en 230.1.1.20 0.0.0.0 0 0
5 en 230.1.1.60 0.0.0.0 0 0
11 en 224.25.25.134 0.0.0.0 0 0
14 en 230.1.1.20 0.0.0.0 0 0
Examples: Displaying Detailed Information for a Specified A-DSG Tunnel
The following example shows all the detailed information about a specified tunnel for A-DSG
version 1.1. This output was changed in Cisco IOS Release 12.3(17a)BC for A-DSG version 1.2 (see
following example).
Router# show cable dsg tunnel 1 verbose
Tunnel ID : 1
MAC Addr : 0100.5e01.0114
State : enable
Cfr Id : 1
State : enable
Priority : 1
Dest IP : 230.1.1.20
Src IP : 0.0.0.0
Src Prefix Length : 32
Dest Port Start : 0
Dest Port End : 65535
Forwarded : 0
Received : 0
Cfr Id : 5
State : enable
Priority : 1
Dest IP : 230.1.1.60
Src IP : 0.0.0.0
Src Prefix Length : 32
Dest Port Start : 0
Dest Port End : 65535
Forwarded : 0
Received : 0
Cfr Id : 11
State : enable
Priority : 1
Dest IP : 224.25.25.134
Src IP : 0.0.0.0
Src Prefix Length : 32
Dest Port Start : 0
Dest Port End : 65535
Forwarded : 0
Received : 0
Cfr Id : 14
State : enable
Priority : 0
Dest IP : 230.1.1.20
Src IP : 0.0.0.0
Src Prefix Length : 32
Dest Port Start : 1000
Dest Port End : 2000
Forwarded : 0
Received : 0
Client List Id : 2
Client Id : 1
Cisco IOS CMTS Cable Command Reference
CBL-1196 OL-15510-15
Cable Commands: show a through show cable l
show cable dsg tunnel
Client Id Type : CA System ID: 0951
Client Id : 3
Client Id Type : Broadcast
Client Id : 8
Client Id Type : MAC Addr: 1111.1111.1111
Client List Id : 3
Client Id : 1
Client Id Type : Application ID: 0001
Client List Id : 4
Client Id : 1
Client Id Type : CA System ID: 0701
Client List Id : 10
Client Id : 1
Client Id Type : Application ID: 0006
Interface : Cable6/0
Rule Id : 1
Rule Id : 7
Rule Id : 8
Rule Id : 20
Interface : Cable6/1
Rule Id : 1
Rule Id : 3
Rule Id : 4
Rule Id : 11
Beginning in Cisco IOS Release 12.3(17a)BC, this output was modified to add the “TG id” field in
support of A-DSG version 1.2. The “State” and “MAC Addr” fields also switched positions in the output.
Router# show cable dsg tunnel 1 verbose
Tunnel ID : 1
State : enable
MAC Addr : 0100.5e01.0001
TG Id : 1
Cfr Id : 1
State : enable
Priority : 0
Dest IP : 230.1.0.1
Src IP : 0.0.0.0
Src Prefix Length : 32
Dest Port Start : 0
Dest Port End : 65535
Forwarded : 0
Received : 0
Cfr Id : 6
State : enable
Priority : 0
Dest IP : 231.1.1.6
Src IP : 0.0.0.0
Src Prefix Length : 32
Dest Port Start : 0
Dest Port End : 65535
Forwarded : 0
Received : 0
Cfr Id : 7
State : enable
Priority : 0
Dest IP : 231.1.1.7
Src IP : 0.0.0.0
Src Prefix Length : 32
Dest Port Start : 0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1197
Cable Commands: show a through show cable l
show cable dsg tunnel
Dest Port End : 65535
Forwarded : 0
Received : 0
Cfr Id : 8
State : enable
Priority : 0
Dest IP : 231.1.1.8
Src IP : 0.0.0.0
Src Prefix Length : 32
Dest Port Start : 0
Dest Port End : 65535
Forwarded : 0
Received : 0
Client List Id : 1
Client Id : 1
Client Id Type : MAC Addr 0100.5e00.0001
Client Id : 2
Client Id Type : Application ID 0x0951
Client Id : 3
Client Id Type : Broadcast Unspecified
Client Id : 4
Client Id Type : Broadcast 4
Interface : Cable5/0
Rule Id : 1
Related Commands Command Description
debug cable dsg Enables general, DCD or packet-related debugging.
show cable dsg tg Displays information about A-DSG tunnel groups on a Cisco CMTS router.
show interface Displays general interface information for the specified or all interfaces.
show interface cable Displays A-DSG configuration and status information for downstream
dsg downstream interfaces.
Cisco IOS CMTS Cable Command Reference
CBL-1198 OL-15510-15
Cable Commands: show a through show cable l
show cable dsg tg
show cable dsg tg
To display information about the Advanced-mode DOCSIS Set-top Gateway (A-DSG) tunnel group
configuration on a Cisco CMTS router, use the show cable dsg tg command in privileged EXEC mode.
show cable dsg tg [tunnel-group-id {channel channel-id} [verbose]]
Syntax Description tunnel-group-id (Optional) Alphanumeric identifier for a specified tunnel group.
channel channel-id Specifies the DSG tunnel group channel identifier.
verbose (Optional) Displays DSG tunnel group detail information.
Command Default None
Command Modes Privileged EXEC (#)
Command History Release Modification
12.3(17a)BC This command was introduced to support A-DSG on the Cisco uBR10012
router and Cisco uBR7200 series routers.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
12.2(33)SCD5 This command was modified. The output of the show cable dsg tg command
was changed.
Usage Guidelines This command displays information for all DSG tunnel groups.
Examples The following is a sample output from the show cable dsg tg command with the configured parameters
for all DSG tunnel groups:
Router# show cable dsg tg
TG Chan TG Rule Vendor UCID
id id state I/F pri Param list
1 1 en C5/0 16 1 1 2 3 4
1 2 en 0
2 1 en C5/0 11 2
C5/1
2 2 en 0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1199
Cable Commands: show a through show cable l
show cable dsg tg
The following is a sample output from the show cable dsg tg 1 channel 1 command with the configured
parameters for all DSG tunnel groups for the specified tunnel group and channel.
Router# show cable dsg tg 1 channel 1
TG Chan TG Rule Vendor UCID
id id state I/F pri Param list
1 1 en C5/0 16 1 1 2 3 4
The following is a sample output from the show cable dsg tg 1 channel 1 verbose command with the
detailed information for the specified tunnel group.
Router# show cable dsg tg 1 channel 1 verbose
TG: 1 Chan: 1 state: en pri: 16 Vendor: 1 UCID: 1 2 3 4
rule tunnel cfr clients
I/F id state id state mac-addr id state dest-ip In-DCD listId
C7/0/0 1 en 1 en 0101.5e01.0001 1 en 230.1.0.1 yes 1
6 en 231.1.1.6 no
7 en 231.1.1.7 no
8 en 231.1.1.8 no
2 en 2 en 0101.5e01.0002 2 en 230.1.0.2 yes 2
3 en 3 en 0101.5e01.0003 3 en 230.1.0.3 yes 3
The following is sample output of the show cable dsg tg command that displays the ignore option,
introduced in Cisco IOS Release 12.2(33)SCD5, under the ‘In DCD’ column.
Router# show cable dsg tg 1 channel 1 verbose
TG: 1 Chan: 1 state: en pri: 16 Vendor: 1 UCID: 1 2 3 4
rule tunnel cfr clients
I/F id state id state mac-addr id state dest-ip In-DCD listId
------ -------- ------------------------ ------------------------- --- -------
C7/0/0 1 en 1 en 0101.5e01.0001 1 en 230.1.0.1 ign 1
6 en 231.1.1.6 no
7 en 231.1.1.7 no
8 en 231.1.1.8 no
2 en 2 en 0101.5e01.0002 2 en 230.1.0.2 yes 2
3 en 3 en 0101.5e01.0003 3 en 230.1.0.3 yes 3
Table 1 describes the significant fields shown in the output.
Table 57 show cable dsg tg Field Descriptions
Field Description
TG Tunnel group identifier.
Chan Channel identifier.
state Current state of the cable interface.
pri Traffic priority parameter.
Vendor Vendor name.
UCID Upstream channel identifier.
I/F Interface.
rule id Rule identifier.
tunnel state Tunnel state.
mac-addr MAC address.
cfr state Classifier state.
Cisco IOS CMTS Cable Command Reference
CBL-1200 OL-15510-15
Cable Commands: show a through show cable l
show cable dsg tg
Table 57 show cable dsg tg Field Descriptions (continued)
Field Description
dest-ip Destination IP address.
In-DCD Downstream channel descriptor.
clients listId Client list identifier.
Related Commands Command Description
debug cable dsg Enables general, DCD, or packet-related debugging.
show cable dsg tunnel Displays information about A-DSG tunnel configuration on a Cisco CMTS
router.
show interface Displays general interface information for the specified or all interfaces.
show interface cable Displays A-DSG configuration and status information for downstream
dsg downstream interfaces.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1201
Cable Commands: show a through show cable l
show cable dsg tunnel
show cable dsg tunnel
To display information about Advanced-mode DOCSIS Set-top Gateway (A-DSG) tunnel configuration
on a Cisco CMTS router, use the show cable dsg tunnel command in privileged EXEC mode.
show cable dsg tunnel tunnel-id [cfrs | clients | interfaces | statistics | verbose]
Syntax Description tunnel-id (Optional) Alphanumeric identifier for a specified tunnel.
cfrs Show DSG tunnel classifiers.
clients Show DSG tunnel clients.
interfaces Show DSG tunnel interfaces.
statistics Show DSG tunnel statistics.
verbose Show DSG tunnel detail information.
Defaults No default behaviors or values
Command Modes Privileged EXEC (#)
Command History Release Modification
12.3(13a)BC This command was introduced to support A-DSG 1.1 on the
Cisco uBR10012 router and Cisco uBR7200 series routers.
12.3(17a)BC The output was modified to support A-DSG 1.2.
• The “TG id” field was added to the show cable dsg tunnel and verbose
forms of the command.
• The “State” and “MAC Addr” fields switched places in the show cable
dsg tunnel verbose form of the command.
• The “vendor group” field was added to the show cable dsg tunnel
clients form of the command.
12.2SB This command was integrated into Cisco IOS Release 12.2SB. Support for
the Cisco uBR7225VXR router was added.
12.2(33)SCC The command output was modified to display the cable interfaces in the
MAC domain, and their SF ID values and dropped packet count for the show
cable dsg tunnel statistics form of the command.
Usage Guidelines This command replaces the show cable dsg form of command available in Cisco IOS
Release 12.3(9a)BC.
Examples The following example displays CLI help for show cable dsg tunnel command syntax.
Router# show cable dsg tunnel 1 ?
Cisco IOS CMTS Cable Command Reference
CBL-1202 OL-15510-15
Cable Commands: show a through show cable l
show cable dsg tunnel
cfrs Show DSG tunnel classifiers
clients Show DSG tunnel clients
interfaces Show DSG tunnel interfaces
statistics Show DSG tunnel statistics
verbose Show DSG tunnel detail information
| Output modifiers
<cr>
Examples: Displaying information about all A-DSG Tunnels
The following command displays tunnel MAC address, state, associated classifiers, and state information
for Advanced-mode DSG version 1.1 tunnels on a Cisco CMTS router. This output was changed in Cisco
IOS Release 12.3(17a)BC for A-DSG version 1.2 (see following example).
Router# show cable dsg tunnel
tunnel tunnel tunnel cfr cfr tunnel in rule rule client service
id state mac-addr id state interface id state listId class
1 en 0100.5e01.0114 1 en Cable6/0 1 en 2 SI
5 en 7 en 10
11 en 8 en 2
14 en 20 en 2
Cable6/1 1 en 4
3 en 3
4 en 4
11 en 2
2 en 0100.5e01.011e 2 en Cable6/0 2 en 2 NDS-CA
10 en
3 en 0100.5e01.0128 3 en Cable6/0 3 en 3 NDS-APP
4 en 0100.5e01.0132 4 en Cable6/0 4 en 4 MOTO-CA
5 en 0100.5e01.013c 9 en Cable6/0 5 en 5 MOTO-APP
Cable6/1 5 en 5
6 dis 0100.5e01.0146 Cable6/0 6 en 6 SA-CA
Cable6/1 6 en 6
7 dis 0100.5e01.0150 7 en Cable6/1 8 en 7 SA-APP
13 dis
8 en 0100.5e01.0119 8 en NDS-DNLD
9 en 0100.5e01.0133 MOTO-DNLD
10 en 0100.5e01.0147 SA-DNLD
11 en 2222.2222.2222
12 en 3333.3333.3333 12 en
Beginning in Cisco IOS Release 12.3(17a)BC, this output was modified to add the tunnel group ID (“TG
id”) field in support of A-DSG version 1.2 as shown below:
Router# show cable dsg tunnel
tunnel TG cfr tunnel rule client service
id state mac-addr id id state I/F id state listId class
1 en 0100.5e01.0001 1 1 en C5/0 1 en 1 DSG-Rate1
6 en
7 en
8 en
2 en 0100.5e01.0002 1 2 en C5/0 2 en 2
3 en 0100.5e01.0003 1 3 en C5/0 3 en 3
4 en 0002.0002.0001 2 4 en C5/0 4 en 1
C5/1 1 en 1
5 en 0002.0002.0002 2 5 en C5/0 5 en 2 DSG-Rate2
C5/1 2 en 2
6 en 0002.0002.0003 2 9 en C5/0 6 en 21
C5/1 3 en 21
Examples: Displaying Information for a Specified A-DSG Tunnel
The following example displays the same information as the show cable dsg tunnel command, but for
a specified tunnel. The following example shows sample output for A-DSG version 1.1. This output was
changed in Cisco IOS Release 12.3(17a)BC for A-DSG version 1.2 (see following example).
Router# show cable dsg tunnel 1
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1203
Cable Commands: show a through show cable l
show cable dsg tunnel
tunnel tunnel tunnel cfr cfr tunnel in rule rule client service
id state mac-addr id state interface id state listId class
1 en 0100.5e01.0114 1 en Cable6/0 1 en 2 SI
5 en 7 en 10
11 en 8 en 2
14 en 20 en 2
Cable6/1 1 en 4
3 en 3
4 en 4
11 en 2
Beginning in Cisco IOS Release 12.3(17a)BC, this output was modified to add the tunnel group ID (“TG
id”) field in support of A-DSG version 1.2 as shown below:
Router# show cable dsg tunnel 1
tunnel TG cfr tunnel rule client service
id state mac-addr id id state I/F id state listId class
1 en 0100.5e01.0001 1 1 en C5/0 1 en 1 DSG-Rate1
6 en
7 en
8 en
Examples: Displaying Information for A-DSG Tunnel Classifiers
The following example displays detailed information about all A-DSG classifiers associated with the
specified tunnel.
Router# show cable dsg tunnel 1 cfrs
tunnel cfr cfr cfr destination ip source ip srcPre d_port d_port
id id state pri address address length start end
1 1 en 1 230.1.1.20 0.0.0.0 32 0 65535
5 en 1 230.1.1.60 0.0.0.0 32 0 65535
11 en 1 224.25.25.134 0.0.0.0 32 0 65535
14 en 0 230.1.1.20 0.0.0.0 32 1000 2000
Examples: Displaying Information for A-DSG Tunnel Clients
The following example displays detailed information about all the clients associated with the specified
tunnel for A-DSG version 1.1. This output was changed in Cisco IOS Release 12.3(17a)BC for A-DSG
version 1.2 (see following example).
Router# show cable dsg tunnel 1 clients
tunnel client client client client
id listId id id type address
1 2 1 CA System ID 0X951
3 Broadcast
8 MAC Addr 1111.1111.1111
3 1 Application ID 0X1
4 1 CA System ID 0X701
10 1 Application ID 0X6
Beginning in Cisco IOS Release 12.3(17a)BC, this output was modified to add the “vendor group” field
in support of A-DSG version 1.2 as shown below:
Router# show cable dsg tunnel 1 clients
tunnel client client client client vendor
id listId id id type address group
1 1 1 MAC Addr 0100.5e00.0001
2 Application ID 0x0951
3 Broadcast Unspecified
4 Broadcast 4
Cisco IOS CMTS Cable Command Reference
CBL-1204 OL-15510-15
Cable Commands: show a through show cable l
show cable dsg tunnel
Examples: Displaying Information for A-DSG Tunnel Interfaces
The following example displays all the interfaces and rules associated with a specified tunnel.
Router# show cable dsg tunnel 1 interfaces
tunnel downstream rule
id interface id
1 Cable6/0 1 7 8 20
Cable6/1 1 3 4 11
Examples: Displaying Information for A-DSG Tunnel Statistics
The following example displays the packets statistics information about the specified tunnel. This output
was changed in Cisco IOS Release 12.2(33)SCC (see following example).
Router# show cable dsg tunnel 1 statistics
tunnel cfr cfr destination ip source ip total total
id id state address address forwarded received
1 1 en 230.1.1.20 0.0.0.0 0 0
5 en 230.1.1.60 0.0.0.0 0 0
11 en 224.25.25.134 0.0.0.0 0 0
14 en 230.1.1.20 0.0.0.0 0 0
Beginning in Cisco IOS Release 12.2(33)SCC, this output was modified to display the cable interfaces
in the MAC domain, and their SF ID values and dropped packet count.
Router# show cable dsg tunnel 1 statistics
Load for five secs: 1%/0%; one minute: 2%; five minutes: 1%
Time source is hardware calendar, *20:07:32.543 UTC Wed Sep 14 2009
tunnel cfr cfr destination ip source ip total total
id id state address address forwarded received
------ ----- ----- --------------- --------------- -------------- --------------
1 1 en 230.1.1.20 0.0.0.0 178025 178033
2 en 230.1.2.20 0.0.0.0 0 0
service class interface SFid dropped packets
--------------- ----------- ------ ---------------
dsg-tunnel1 Mo1/0/0:0 54 64695
Mo1/0/0:1 56 64717
Mo1/0/0:2 58 64731
Mo1/0/0:3 60 64754
Mo1/0/0:4 62 64774
Mo1/0/0:5 64 64790
Mo1/0/0:6 66 64812
Mo1/0/0:7 68 64824
Mo1/0/0:8 70 64845
Mo1/0/0:9 72 64864
Mo1/0/0:10 74 64880
Mo1/0/0:11 76 64900
Mo1/0/0:12 78 64921
Mo1/0/0:13 80 64932
Mo1/0/0:14 82 78249
Mo1/0/0:15 84 78276
Mo1/0/0:16 86 78290
Mo1/0/0:17 88 78311
Mo1/0/0:18 90 78330
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1205
Cable Commands: show a through show cable l
show cable dsg tunnel
Examples: Displaying Detailed Information for a Specified A-DSG Tunnel
The following example shows all the detailed information about a specified tunnel for A-DSG
version 1.1. This output was changed in Cisco IOS Release 12.3(17a)BC for A-DSG version 1.2 (see
following example).
Router# show cable dsg tunnel 1 verbose
Tunnel ID : 1
MAC Addr : 0100.5e01.0114
State : enable
Cfr Id : 1
State : enable
Priority : 1
Dest IP : 230.1.1.20
Src IP : 0.0.0.0
Src Prefix Length : 32
Dest Port Start : 0
Dest Port End : 65535
Forwarded : 0
Received : 0
Cfr Id : 5
State : enable
Priority : 1
Dest IP : 230.1.1.60
Src IP : 0.0.0.0
Src Prefix Length : 32
Dest Port Start : 0
Dest Port End : 65535
Forwarded : 0
Received : 0
Cfr Id : 11
State : enable
Priority : 1
Dest IP : 224.25.25.134
Src IP : 0.0.0.0
Src Prefix Length : 32
Dest Port Start : 0
Dest Port End : 65535
Forwarded : 0
Received : 0
Cfr Id : 14
State : enable
Priority : 0
Dest IP : 230.1.1.20
Src IP : 0.0.0.0
Src Prefix Length : 32
Dest Port Start : 1000
Dest Port End : 2000
Forwarded : 0
Received : 0
Client List Id : 2
Client Id : 1
Client Id Type : CA System ID: 0951
Client Id : 3
Client Id Type : Broadcast
Client Id : 8
Client Id Type : MAC Addr: 1111.1111.1111
Client List Id : 3
Client Id : 1
Client Id Type : Application ID: 0001
Client List Id : 4
Client Id : 1
Client Id Type : CA System ID: 0701
Client List Id : 10
Client Id : 1
Cisco IOS CMTS Cable Command Reference
CBL-1206 OL-15510-15
Cable Commands: show a through show cable l
show cable dsg tunnel
Client Id Type : Application ID: 0006
Interface : Cable6/0
Rule Id : 1
Rule Id : 7
Rule Id : 8
Rule Id : 20
Interface : Cable6/1
Rule Id : 1
Rule Id : 3
Rule Id : 4
Rule Id : 11
Beginning in Cisco IOS Release 12.3(17a)BC, this output was modified to add the “TG id” field in
support of A-DSG version 1.2. The “State” and “MAC Addr” fields also switched positions in the output.
Router# show cable dsg tunnel 1 verbose
Tunnel ID : 1
State : enable
MAC Addr : 0100.5e01.0001
TG Id : 1
Cfr Id : 1
State : enable
Priority : 0
Dest IP : 230.1.0.1
Src IP : 0.0.0.0
Src Prefix Length : 32
Dest Port Start : 0
Dest Port End : 65535
Forwarded : 0
Received : 0
Cfr Id : 6
State : enable
Priority : 0
Dest IP : 231.1.1.6
Src IP : 0.0.0.0
Src Prefix Length : 32
Dest Port Start : 0
Dest Port End : 65535
Forwarded : 0
Received : 0
Cfr Id : 7
State : enable
Priority : 0
Dest IP : 231.1.1.7
Src IP : 0.0.0.0
Src Prefix Length : 32
Dest Port Start : 0
Dest Port End : 65535
Forwarded : 0
Received : 0
Cfr Id : 8
State : enable
Priority : 0
Dest IP : 231.1.1.8
Src IP : 0.0.0.0
Src Prefix Length : 32
Dest Port Start : 0
Dest Port End : 65535
Forwarded : 0
Received : 0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1207
Cable Commands: show a through show cable l
show cable dsg tunnel
Client List Id : 1
Client Id : 1
Client Id Type : MAC Addr 0100.5e00.0001
Client Id : 2
Client Id Type : Application ID 0x0951
Client Id : 3
Client Id Type : Broadcast Unspecified
Client Id : 4
Client Id Type : Broadcast 4
Interface : Cable5/0
Rule Id : 1
Related Commands Command Description
debug cable dsg Enables general, DCD or packet-related debugging.
show cable dsg tg Displays information about A-DSG tunnel groups on a Cisco CMTS router.
show interface Displays general interface information for the specified or all interfaces.
show interface cable Displays A-DSG configuration and status information for downstream
dsg downstream interfaces.
Cisco IOS CMTS Cable Command Reference
CBL-1208 OL-15510-15
Cable Commands: show a through show cable l
show cable dynamic-qos trace
show cable dynamic-qos trace
To display the number of subscribers for whom call trace is enabled on the Cisco CMTS router, use the
show cable dynamic-qos trace command in privileged EXEC mode.
show cable dynamic-qos trace
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC (#)
Command History Release Modification
Cisco IOS Release 12.2(33)SCF This command was introduced.
Usage Guidelines Use the show cable dynamic-qos trace command after enabling the call trace functionality for
PacketCable or PacketCable Multimedia (PCMM) service subscribers using the cable dynamic-qos
trace command.
Examples The following is a sample output of the show cable dynamic-qos trace command that shows the number
of subscribers for whom call trace is enabled on the Cisco uBR10012 router in
Cisco IOS Release 12.2(33)SCF:
Router# show cable dynamic-qos trace
Total number of subscribers: 0
Max configured number of subscribers: 12
Table 58 describes the significant fields shown in the show packetcable cms command display.
Table 58 show packetcable cms Field Descriptions
Field Description
Total number of subscribers Number of subscribers for whom call trace is enabled. The
number ranges from 0 to the maximum configured number of
subscribers.
Max configured number of subscribers Maximum number of subscribers for whom call trace can be
enabled at any point of time.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1209
Cable Commands: show a through show cable l
show cable dynamic-qos trace
Related Commands Command Description
cable dynamic-qos trace Enables the call trace functionality on the
Cisco CMTS router for PacketCable or PCMM service
subscribers.
debug cable dynamic-qos subscriber Enables debugging of the call trace functionality on the
Cisco CMTS router for a particular subscriber.
debug cable dynamic-qos trace Enables call trace debugging on the Cisco CMTS router for
all the subscribers for whom call trace is configured.
Cisco IOS CMTS Cable Command Reference
CBL-1210 OL-15510-15
Cable Commands: show a through show cable l
show cable fiber-node
show cable fiber-node
To display information about a fiber node, use the show cable fiber-node command in privileged EXEC
mode.
show cable fiber-node fiber-node-id [spectrum]
Syntax Description fiber-node-id Specifies a fiber node ID. Valid values range from 1 to 256.
spectrum Displays upstream channel frequency assignment information and the
spectrum group number.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.3BC This command was introduced
12.2(33)SCC This command was integrated into Cisco IOS Release 12.2(33)SCC.
Usage Guidelines Use the show cable fiber-node command to display information about a fiber node, such as the fiber
node status. If you specify the spectrum parameter, the command displays upstream channel frequency
assignment information and the spectrum group number.
For each fiber node, a traditional DOCSIS downstream channel on a Cisco uBR10-MC5X20 cable
interface line card is used to carry MAC management and signaling messages. This traditional DOCSIS
downstream channel used for a MAC domain is called the primary downstream channel. The associated
traditional DOCSIS upstream channel is used for return data traffic and signaling.
Examples The following is a sample output of the show cable fiber-node command:
Router# show cable fiber-node 2
Fiber-Node Config Status
Fiber-Node 2
downstream Modular-Cable 1/0/0: 0-3
downstream Cable 7/1/0
upstream Cable 7/1: 10-19
FN Config Status: Configured (status flags = 0x01)
MDD Status: Valid
Router#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1211
Cable Commands: show a through show cable l
show cable fiber-node
Table 59 describes the fields shown in the show cable fiber-node command display.
Table 59 show cable fiber-node Field Descriptions
Field Description
Fiber-Node Displays the fiber nodes configured on the CM.
Config Status Displays the configuration status of the fiber node. Status flags are as
follows:
• 0x01 - CMTS_FN_CONFIG
• 0x02 - CMTS_FN_FREQ_INVALID
• 0x04 - CMTS_FN_CHID_INVALID
• 0x08 - CMTS_FN_BUNDLE_INVALID
• 0x10 - CMTS_FN_BOND_CHID_INVALID
• 0x20 - CMTS_FN_US_FREQ_INVALID
• 0x40 - CMTS_FN_NO_US_CONFIGURED
MDD Status Displays the MAC Domain Descriptor (MDD) status. MDD status of a fiber
node is set as invalid in the following cases:
• Frequency is not unique.
• Channel ID is not unique.
• Bonding group ID is not unique.
• Bundle is mismatched.
Router# show cable fiber-node 2 spectrum
Fiber Upstream Physical Frequency Spectrum
Node No. Port Port (MHz) Group No.
2 Cable7/1/0 U0 10 21.939 [1.6] 1
2 Cable7/1/0 U1 11 10.695 [1.6] 1
2 Cable7/1/0 U2 12 5.834 [1.6] 1
2 Cable7/1/0 U3 13 9.055 [1.6] 1
2 Cable7/1/4 U0 16 unassigned No
2 Cable7/1/4 U1 17 unassigned No
2 Cable7/1/4 U2 18 unassigned No
2 Cable7/1/4 U3 19 unassigned No
Table 60 describes the fields shown in the show cable load-balance command display when the
spectrum keyword is used.
Table 60 show cable fiber-node Field Descriptions
Field Description
Upstream Port Displays the upstream port associated with the fiber node.
Physical Port Displays the physical port of the upstream channel.
Frequency Displays the upstream channel frequency of the CM.
Spectrum Group No. Displays the spectrum group number of the fiber node. A spectrum group is
a list of upstream frequencies and nominal power levels. Spectrum groups
ranging from 1 to 32 can be created for each cable modem upstream port.
Cisco IOS CMTS Cable Command Reference
CBL-1212 OL-15510-15
Cable Commands: show a through show cable l
show cable fiber-node
Related Commands Command Description
show cable modem Displays information for registered and unregistered cable
modems (including wideband cable modems).
show cable modem wideband Displays information for registered and unregistered wideband
cable modems.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1213
Cable Commands: show a through show cable l
show cable filter
show cable filter
To display the DOCSIS 1.1 filter groups that are currently defined, use the show cable filter command
in user EXEC or privileged EXEC mode.
show cable filter [group group-index [index index-num]] [verbose]
Syntax Description group group-id (Optional) Specifies the filter group to be displayed. The valid range is
1 to 256.
index index-num (Optional) Specifies the index of the particular filter within a group to
be displayed. The valid range is 1 to 128 on a uBR7200 series router
and 1 to 255 on a uBR10012 router.
verbose (Optional) Displays complete information about the filter groups in a
format that is easier to read than the default display.
Command Modes User EXEC, Privileged EXEC (#)
Command History Release Modification
12.1(6)EC1 This command was introduced on the Cisco uBR7100 series and
Cisco uBR7200 series routers.
12.2(2)XF, 12.2(4)BC1 This command was supported on the Cisco uBR10012 routers.
12.2(8)BC2 An option was added to the cable filter group command to allow filter
groups to be activated and deactivated without removing the filter group’s
configuration.
12.2(33)SCA The output was changed to add fields for IPv6 information, including the
“v6” field in the show cable filter command, and the “Source IPv6
Address,” and “Destination IPv6 Address” fields of the show cable filter
verbose command.
Examples The following example shows a typical display of the show cable filter command:
Router# show cable filter
Filter SrcAddr/Mask DestAddr/Mask Prot ToS SPort DPort TCP Action Status
Grp Id Flags
1 1 256 137 0,0 drop active
1 2 10.37.11.151/24 6 23 2,0 drop active
1 3 17 68 67 0,0 drop active
1 4 256 161 0,0 drop active
1 5 256 53 0,0 drop active
1 6 10.37.11.151/29 256 accept active
1 7 10.37.11.196/29 10.11.0.98/32 256 accept active
1 8 10.37.11.195/32 10.11.0.98/32 6 drop active
1 9 10.37.11.195/32 10.11.0.98/32 256 accept active
1 10 10.37.11.194/32 10.11.0.98/16 6 accept active
1 11 10.37.11.193/32 10.11.0.98/8 17 drop active
1 12 10.37.11.192/32 10.11.0.98/32 6 F,F accept active
Cisco IOS CMTS Cable Command Reference
CBL-1214 OL-15510-15
Cable Commands: show a through show cable l
show cable filter
1 13 10.37.11.191/32 10.11.0.98/32 17 F,F accept active
1 14 10.37.11.190/32 10.11.0.98/24 17 8,F accept active
1 15 10.37.11.189/32 10.11.0.98/32 256 F,8 drop active
1 16 10.37.11.189/32 10.11.0.98/32 256 F,8 accept active
1 17 10.37.11.188/32 10.11.0.98/8 17 accept active
1 18 10.37.11.188/32 10.11.0.98/32 6 drop active
1 19 10.37.11.187/32 10.11.0.98/30 256 accept active
1 20 10.11.0.98/0 256 drop active
Router#
The following shows typical output for the verbose form of this command:
Router# show cable filter group 10 index 10 verbose
Filter Group : 1
Filter Index : 1
Matches : 0
Match action : accept
Status : active
Filter Group : 10
Filter Index : 10
Matches : 0
Source IP Address : 10.7.7.7/16
Destination IP Address : 10.8.8.8/16
IP Protocol type : 256
IP ToS (Mask, Value) : 1, 2
TCP/UDP Source Port : 2000
TCP/UDP Destination Port : 3000
TCP Flags (mask, value) : 0, 0
Match action : accept
Status : active
Router#
IPv6 Examples
The following examples show examples of output for the show cable filter commands with changes
beginning in Cisco IOS Release 12.2(33)SCA in support of IPv6 cable filter groups. Table 61 describes
the output fields.
Router# show cable filter
Filter SrcAddr/Mask DestAddr/Mask Prot ToS SPort DPort TCP Action Status
Grp Id v6 Flags
254 128Y Use Verbose Use Verbose drop active
Router# show cable filter group 254
Filter SrcAddr/Mask DestAddr/Mask Prot ToS SPort DPort TCP Action Status
Grp Id v6 Flags
254 128Y Use Verbose Use Verbose drop active
Router# show cable filter group 254 index 128
Filter SrcAddr/Mask DestAddr/Mask Prot ToS SPort DPort TCP Action Status
Grp Id v6 Flags
254 128Y Use Verbose Use Verbose drop active
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1215
Cable Commands: show a through show cable l
show cable filter
Table 61 show cable filter Field Descriptions
Field Description
Filter Gp ID number of the filter group. Defined by the group-id argument of the cable
filter group command.
Filter Id Index number of the filter group. Defined by the index-num argument of the
cable filter group command.
v6 IP version 6 filter group type indicator. Defined by the ip-version keyword
of the cable filter group command. Possible values are Y or N.
SrcAddr/Mask • IP version 4—Filter source IP address and mask to be matched by the
filter. Defined by the src-ip and src-mask keywords of the cable filter
group command..
• IP version 6—“Use Verbose” appears because IPv6 addresses will not fit
in the output display area; need to use the show cable filter group
verbose command to view IPv6 addresses.
DestAddr/Mask • IP version 4—Filter destination IP address and mask to be matched by
the filter. Defined by the dest-ip and dest-mask keywords of the cable
filter group command.
• IP version 6—“Use Verbose” appears because IPv6 addresses will not fit
in the output display area; need to use the show cable filter group
verbose command to view IPv6 addresses.
Prot IP protocol number(s) to be matched by the filter. Defined by the ip-proto
keyword of the cable filter group command.
ToS Type of Service mask and value to be matched by the filter. Defined by the
ip-tos keyword of the cable filter group command.
SPort TCP/UDP source port number to be matched by the filter. Defined by the
src-port keyword of the cable filter group command.
DPort TCP/UDP destination port number to be matched by the filter. Defined by the
dest-port keyword of the cable filter group command.
TCP Flags TCP flag mask and value to be matched by the filter. Defined by the tcp-flags
keyword of the cable filter group command.
Action Action to be taken on packet (accept or drop) when filter match occurs.
Defined by the match-action keyword of the cable filter group command.
Status Filter group status (active or inactive). Defined by the status keyword of the
cable filter group command.
Router# show cable filter group 254 index 128 verbose
Filter Group : 254
Filter Index : 128
Filter Version : IPv6
Matches : 0
Source IPv6 address : 2001:33::20B:BFFF:FEA9:741F/128
Destination IPv6 address : 2001:1::224/128
Match action : drop
Status : active
Table 62 describes the output fields.
Cisco IOS CMTS Cable Command Reference
CBL-1216 OL-15510-15
Cable Commands: show a through show cable l
show cable filter
Table 62 show cable filter verbose Field Descriptions
Field Description
Filter Group ID number of the filter group. Defined by the
group-id argument of the cable filter group
command.
Filter Index Index number of the filter group. Defined by the
index-num argument of the cable filter group
command.
Filter Version IP version of the filter group. Defined by the
ip-version keyword of the cable filter group
command. Possible values are IPv4 or IPv6.
Matches: Source IP address or • Source IP address—IPv4 source IP address
Matches: Source IPv6 address and mask to be matched by the filter. Defined
by the src-ip and src-mask keywords of the
cable filter group command.
• Source IPv6 address—IPv6 source IP address
and prefix to be matched by the filter. Defined
by the v6-src-address and v6-src-pfxlen
keywords of the cable filter group command.
Matches: Destination IP address or • Destination IP address—IPv4 destination IP
address and mask to be matched by the filter.
Matches: Destination IPv6 address
Defined by the dest-ip and dest-mask
keywords of the cable filter group command.
• Destination IPv6 address—IPv6 destination
IP address and prefix to be matched by the
filter. Defined by the v6-dest-address and
v6-dest-pfxlen keywords of the cable filter
group command.
Matches: IP Protocol type IP protocol number(s) to be matched by the filter.
Defined by the ip-proto keyword of the cable
filter group command.
Matches: IP ToS (Mask, Value) Type of Service mask and value to be matched by
the filter. Defined by the ip-tos keyword of the
cable filter group command.
Matches: TCP/UDP Source Port TCP/UDP source port number to be matched by
the filter. Defined by the src-port keyword of the
cable filter group command.
Matches: TCP/UDP Destination Port TCP/UDP destination port number to be matched
by the filter. Defined by the dest-port keyword of
the cable filter group command.
Matches: TCP Flags (mask, value) TCP flag mask and value to be matched by the
filter. Defined by the tcp-flags keyword of the
cable filter group command.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1217
Cable Commands: show a through show cable l
show cable filter
Table 62 show cable filter verbose Field Descriptions
Field Description
Matches: Match action Action to be taken on packet (accept or drop) when
filter match occurs. Defined by the match-action
keyword of the cable filter group command.
Matches: Status Filter group status (active or inactive). Defined by
the status keyword of the cable filter group
command.
Related Commands Command Description
cable filter group Creates, configures, and activates a DOCSIS 1.1 filter group
that filters packets on the basis of the TCP/IP and UDP/IP
headers.
Cisco IOS CMTS Cable Command Reference
CBL-1218 OL-15510-15
Cable Commands: show a through show cable l
show cable flap-list
show cable flap-list
To display the cable flap-list on a Cisco CMTS, use the show cable flap-list command in user EXEC or
privileged EXEC mode.
show cable flap-list
show cable flap-list [cable slot/port | cable slot/subslot/port] [upstream port] [sort-flap |
sort-time]
show cable flap-list sort-interface [sort-flap | sort-time]
Syntax Description cable slot/port (Optional) Displays information for all CMs on the specified cable
interface and downstream port on the Cisco uBR7100 series and
Cisco uBR7200 series routers:
• slot—Chassis slot number of the cable interface line card.
• port—Downstream port number.
Valid values for these arguments are dependent on your CMTS router
and cable interface line card. Refer to the hardware documentation for
your router chassis and cable interface line card for supported slot and
port numbering.
cable slot/subslot/port (Optional) Displays information for all CMs on the specified cable
interface on a Cisco uBR10012 router:
• slot—Chassis slot number of the cable interface line card. Valid
slots are from 5 to 8.
• subslot—Secondary slot number of the cable interface line card.
Valid subslots are 0 or 1.
• port—Downstream port number. Valid ports are 0 to 4, depending
on the cable interface line card.
upstream port (Optional) Displays the flap list for a particular upstream on the
selected cable interface.
sort-interface (Optional) Displays the flap list for all cable interfaces, sorted by
interface.
sort-flap (Optional) Sorts the list by the number of times the CM has flapped.
sort-time (Optional) Sorts the list by the most recent time the CM is detected to
have flapped.
Command Modes User EXEC (>), Privileged EXEC (#)
Command History Release Modification
11.3 NA This command was introduced.
12.0(3)T This command was supported on the Cisco mainline release.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1219
Cable Commands: show a through show cable l
show cable flap-list
Release Modification
12.0(7)XR and The output of this command was enhanced to show that the Cisco CMTS has
12.1(1a)T1 detected an unstable return path for a particular CM and has compensated
with a power adjustment. An asterisk (*) appears in the power adjustment
field for a modem when a power adjustment has been made; an exclamation
point (!) appears when the CM has reached its maximum power transmit
level and cannot increase its power level further.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
12.2(33)SCC The output of this command was modified to show the aggregated data
across all upstream channels for each flap detector for CMs in the Multiple
Transmit Channel (MTC) mode on a Cisco uBR10012 router.
Usage Guidelines The sort options operate differently on the different Cisco CMTS routers. On the Cisco uBR7100 series
and Cisco uBR7200 series routers, the sort options apply to all cable interface line cards and merge the
output into a single display.
On the Cisco uBR10012 router, the sort options apply to individual cable interfaces. For example, the
sort-time option sorts all of the flap entries on the first cable interface (c5/0/0), then the entries on the
second cable interface (c5/0/1), and so forth.
Note Occasionally, the show cable flap-list command might temporarily show duplicate entries for the same
cable modem. This can occur after a cable modem has gone offline and before it has completed the
registration process and come back online. When the cable modem does reach the online state, the
duplicate entries disappear.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Examples The following example shows the output of the show cable flap-list command:
router# show cable flap-list
MAC Address Upstream Ins Hit Miss CRC P-Adj Flap Time
0010.7bb3.fd19 Cable5/0/U1 0 2792 281 0 *45 58 Jul 27 16:54:50
0010.7bb3.fcfc Cable5/0/U1 0 19 4 0 !43 43 Jul 27 16:55:01
0010.7bb3.fcdd Cable5/0/U1 0 19 4 0 *3 3 Jul 27 16:55:01
Note The asterisk (*) in the P-Adj field indicates that a power adjustment has been made for that CM. The
exclamation point (!) indicates that the CM has reached its maximum power transmit level and cannot
increase its power level further.
The following example shows the display of flap-list tables sorted by MAC address:
router# show cable flap-list sort-flap
Mac Addr CableIF Ins Hit Miss CRC P-Adj Flap Time
0010.1eab.2c0b C6/0 U0 108 318 27 0 0 108 Sep 10 15:26:56
0010.1eb2.bb07 C6/0 U0 0 293 31 1 1 1 Sep 10 15:15:49
Cisco IOS CMTS Cable Command Reference
CBL-1220 OL-15510-15
Cable Commands: show a through show cable l
show cable flap-list
0010.7b6b.71cd C6/0 U0 1 288 32 0 0 1 Sep 10 15:12:13
0010.1eb2.bb8f C6/0 U0 1 295 30 0 0 1 Sep 10 15:11:44
The following example shows the display of flap-list tables sorted by time:
Router# show cable flap-list sort-time
Mac Addr CableIF Ins Hit Miss CRC P-Adj Flap Time
00e0.2222.2202 C4/0 U0 464 2069 242 0 421 885 Oct 16 22:47:23
0010.7b6b.57e1 C4/0 U0 0 2475 43 0 1041 1041 Oct 16 22:47:04
The following sample output of the show cable flap-list command provides the aggregated data across
all upstream channels for CMs in the MTC mode on a uBR10012 router in Cisco IOS Release
12.2(33)SCC:
router# show cable flap-list
MAC Address Upstream Ins Hit Miss CRC P-Adj Flap Time
001e.6bfb.0f9e C5/0/0/UB 0 62539 0 0 2 2 Apr 18 03:53:00
0050.f110.b277 C5/0/0/UB 0 10965 211 0 0 9 Apr 18 03:53:00
Table 1 describes the significant fields shown in the display.
Table 63 show cable flap-list Command Field Descriptions
Field Description
Mac Addr The MAC address for the CM.
CableIF The cable interface line card, including upstream, for this CM.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1221
Cable Commands: show a through show cable l
show cable flap-list
Table 63 show cable flap-list Command Field Descriptions (continued)
Field Description
Ins The number of times the CM comes up and inserts itself into the network. This
counter is indicates the number of times the RF link was abnormally reestablished
into the network. This counter is increased when the time between initial link
establishment and a reestablishment was less than the threshold parameter
configured using the cable flap-list insertion-time command.
Normal modem activity uses the following sequence:
• Initial link insertion is followed by a station maintenance message between the
CMTS and cable modem.
• Power on
• Initial maintenance
• Station maintenance
• Power off
When the link is broken, initial maintenance is repeated to reestablish the link.
• Initial maintenance @ Time T1
• Station maintenance
• Initial maintenance @ Time T2
The Ins and Flap counters in the flap list are incremented whenever T2 – T1 < N
where N is the insertion-time parameter configured in the cable flap-list
insertion-time command.
This count may indicate intermittent downstream synchronization loss or DHCP or
modem registration problems. In the latter case, the Ins count tends to track the
Flap count. If the downstream is unstable (levels move outside the modem’s range
occasionally), insertions can occur. If the modem cannot provision correctly, many
insertions occur.
If link reestablishment happens too frequently, the modem usually has a
registration problem. To check for this potential problem, check to see if the
insertion counter is the same order of magnitude as the Flap counter.
Hit The number of times the CM responds to MAC-layer station maintenance
(keepalive) messages. (The minimum hit rate is once per 30 seconds. It can
indicate intermittent upstream, laser clipping, or common-path distortion.
Miss The number of times the CM misses and does not respond to a MAC-layer station
maintenance (keepalive) message. An 8 percent miss rate is normal for the
Cisco cable interface line cards. It can indicate intermittent upstream, laser
clipping, or common-path distortion.
Cisco IOS CMTS Cable Command Reference
CBL-1222 OL-15510-15
Cable Commands: show a through show cable l
show cable flap-list
Table 63 show cable flap-list Command Field Descriptions (continued)
Field Description
Note The Hit and Miss columns are keepalive polling statistics between the CMTS and the cable
modem. The station maintenance process occurs for every modem approximately every 25
seconds. When the CMTS receives a response from the modem, the event is counted as a hit.
If the CMTS does not receive a response from the cable modem, the event is counted as a miss.
Ideally, the hit count should be much greater than the miss count. If a modem has a hit count
much less than its miss count, then registration is failing. Noisy links cause the miss or hit ratio
to deviate from a nominal 10 percent or less. High miss counts can indicate:
– Intermittent upstream possibly due to noise
– Laser clipping
– Common-path distortion
– Ingress or interference
– Too much or too little upstream attenuation
A cable modem fails to respond either because of noise or if it is down. Modems that log only
misses and zero hits are assumed to be powered off. If noise caused a poll to be missed, then
the transition from miss to hit is detected as a flap condition. The poll rate is increased to 1 per
second whenever the modem misses a poll. This is used to accelerate the offline state detection
and decrease station maintenance overhead.
Misses are not desirable, because they usually indicate a return path problem; however, having
a small number of misses is normal. After 16 misses, the modem is assumed to have powered
off and the link is broken.
The flap count is incremented if there are M consecutive misses, where M is configured in the
cable flap miss-threshold command. The parameter value ranges from 1 to 12, with a default
of 6.
Hit and miss analysis could be done after the Ins count stops incrementing. In general, if the
hit and miss counts are about the same order of magnitude, and the CRC count is low or
nonexistent, then the upstream is experiencing noise.
If the miss count is greater, then the modem is probably experiencing common-path distortion
and is dropping out frequently or not completing registration. Check grounding connections
and if you see noise disappear after breaking a cable connection, but build back up again later,
check the end-of-line terminators. You may be using a substandard frequency translator
instead of a Digital Signal Processor. If the line is simply noisy, but not too noisy, you see an
increase in the percentage of misses. If it is very noisy, then more than 80% of the ranging
responses (RNG-RSP) are missed and the modem has many insertions.
CRC The number of cyclic redundancy check (CRC) errors for this cable modem. CRC
errors are calculated on per modem basis and refer to upstream impairments. Cable
modems with high CRC errors either have bad upstream paths, or have in-home
wiring problems.
The CRC counter field indicates:
• Intermittent upstream
• Laser clipping
• Common-path distortion
• Impulsive noise or interference
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1223
Cable Commands: show a through show cable l
show cable flap-list
Table 63 show cable flap-list Command Field Descriptions (continued)
Field Description
P-Adj The number of times the headend instructed the CM to adjust transmit (TX) power
more than 3 dB. It can indicate amplifier degradation, poor connections, or thermal
sensitivity.
* means the noise power-adjustment method is active for this modem.
! means the modem has reached its maximum transmit power.
The station maintenance poll in the CMTS constantly adjusts the modem transmit
power, frequency, and timing. The power-adjustment (P-Adj) column indicates the
number of times the modem’s power adjustment exceeded the threshold value. The
power adjustment threshold may be set using the cable flap-list power-adjust
threshold command with a value range of 0 to 10 dB and a default value of 2 dB.
Tuning this threshold is recommended to decrease irrelevant entries in the flap list.
Power-adjustment values of 2 dB and below continuously increment the P-Adj
counter. The modem transmitter step size is 1.5 dB, whereas the headend may
command 0.25 dB step sizes.
Power-adjustment flap strongly suggests upstream plant problems such as:
• Amplifier degradation
• Poor connections
• Thermal sensitivity
• Attenuation problem
The P-Adj column is often watched as an indicator of plant stability. It may give a
forewarning of a future plant outage. If the upstream path contains too much or too
little loss, the modem is undergoing many power adjustments.
Flap The total number of times a modem has flapped, which is the sum of P-Adj and Ins
values. This counter is incremented when one of the following events is detected:
• Unusual modem insertion or re-registration attempts. The Flap and the Ins
counters are incremented when the modem tries to reestablish the RF link with
the CMTS within a period of time that is less than the user-configured
insertion interval value.
• Abnormal miss or hit ratio. The Flap counter is incremented when N
consecutive misses are detected after a hit where N can be user-configured
with a default value of 6.
• Unusual power adjustment. The Flap and P-Adj counters are incremented
when the modem’s upstream power is adjusted beyond a user-configured
power level.
Time Time is the most recent time that the modem dropped the connection or flapped.
The value is based on the clock configured on the local CMTS. If no time is
configured, this value is based on the current uptime of the CMTS. When a cable
modem meets one of the three flap list criteria, the Flap counter is incremental and
Time is set to the current time.
Note This field displays a value in brackets in the output of the show cable
modem flap command to indicate the duration (milliseconds) between the
cable interface to become active and the first ranging success after a line
card switchover (cable modem recovery time).
Cisco IOS CMTS Cable Command Reference
CBL-1224 OL-15510-15
Cable Commands: show a through show cable l
show cable flap-list
Related Commands Command Description
cable flap-list aging Specifies the number of days to keep a CM in the flap-list table before aging
it out of the table.
cable flap-list Sets the insertion time interval that determines whether a CM is placed in the
insertion-time flap list.
cable flap-list Specifies the miss threshold for recording a flap-list event.
miss-threshold
cable flap-list Specifies the power-adjust threshold for recording a CM flap-list event.
power-adjust
threshold
cable flap-list size Specifies the maximum number of CMs that can be listed in the flap-list
table.
clear cable flap-list Clears all the entries in the flap-list table.
debug cable flap Displays information about the operation of the CM flap list that is
maintained for the cable interfaces.
ping docsis Sends a DOCSIS ping to a CM and increments the flap-list counters as
appropriate.
show cable modem Displays information about all CMs on an interface or about a particular CM.
show cable modem Displays flap list statistics for one or more cable modems.
flap
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1225
Cable Commands: show a through show cable l
show cable flap-list wb-rf
show cable flap-list wb-rf
To display the wideband RF related data for all w-online cable modems, use the show cable flap-list
wb-rf command in privileged EXEC mode.
show cable flap-list [cable slot/subslot/port] wb-rf [modular-cable slot/bay/port WB RF channel
number] [QAM | MDD]
Syntax Description cable slot/subslot/port (Optional) Displays information for all CMs on the specified cable
interface on a Cisco uBR10012 router, where:
• slot—Specifies the chassis slot number of the cable interface line
card. Valid slots are 5 to 8.
• subslot—Specifies the secondary slot number of the cable
interface line card. Valid subslots are 0 or 1.
• port—Specifies the downstream port number. Valid ports are 0 to
4, depending on the cable interface line card.
modular-cable slot/bay/port (Optional) Displays information for all CMs on the specified modular
cable interface on a Cisco uBR10012 router, where
• slot—The slot where a SIP resides. On the Cisco uBR10012
router, slots 1 and 3 can be used for SIPs.
• bay—The bay in a SIP where a SPA is located. Valid values are 0
(upper bay) and 1 (lower bay).
• port—Specifies the interface number on the SPA.
WB RF channel number (Optional) Specifies the wideband RF channel number.
QAM (Optional) Specifies the number of QAM flaps.
MDD (Optional) Specifies the number of MDD flaps.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines None
Cisco IOS CMTS Cable Command Reference
CBL-1226 OL-15510-15
Cable Commands: show a through show cable l
show cable flap-list wb-rf
Examples The following is a sample output of the show cable flap-list wb-rf command:
router# show cable flap-list wb-rf
RF Timeout Recover Failure Recover Flaps CM Percent
-------- ------- ------- ------- ------- ----- ------- -------
3/0/0 1 1 1 0 0 1 3 33
2 0 0 1 0 1 3 33
Related CommandsR Command Description
show cable flap-list Displays the cable flap-list on a Cisco CMTS.
clear cable flap-list Clears all the entries in the flap-list table.
debug cable flap Displays information about the operation of the CM flap list that is
maintained for the cable interfaces.
show cable modem Displays flap list statistics for one or more cable modems.
flap
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1227
Cable Commands: show a through show cable l
show cable hop
show cable hop
To display cable-hop statistics on a Cisco CMTS, use the show cable hop command in privileged EXEC
mode.
show cable hop [cable slot/port] [upstream uport] [history] [threshold]
show cable hop [cable slot/subslot/port ] [upstream uport] [history] [threshold]
Syntax Description cable slot/port (Optional) Specifies a cable interface on the Cisco uBR7100 series
and Cisco uBR7200 series routers.
On the Cisco uBR7100 series router, the only valid value is 1/0. On
the Cisco uBR7200 series router, slot can range from 3 to 6, and port
can be 0 or 1, depending on the cable interface.
cable slot/subslot/port (Optional) Specifies a cable interface on the Cisco uBR10012 router.
The following are the valid values:
• slot—Chassis slot number of the cable interface line card. Valid
slots are from 5 to 8.
• subslot—Secondary slot number of the cable interface line card.
Valid subslots are 0 or 1.
• port—Downstream port number. Valid ports are from 0 to 4,
depending on the cable interface line card.
upstream uport (Optional) Specifies an upstream port for which to display the
frequency hop status.
history (Optional) Displays changes from one state to another, at any time
and for any reason, for frequency, modulation, and channel width.
threshold (Optional) Displays the user defined thresholds and current
carrier-to-noise ratio (CNR), signal-to-noise ratio (SNR), correctable
forward error correction (FEC) percentage, uncorrectable FEC
percentage, and missed station maintenances percentage values of
the upstreams.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.0(4)XI This command was introduced.
12.3(13a)BC This command was enhanced with the addition of two new keywords,
history and threshold.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Cisco IOS CMTS Cable Command Reference
CBL-1228 OL-15510-15
Cable Commands: show a through show cable l
show cable hop
Release Modification
12.3(23)BC7 The output of the show cable hop history command is modified to include
more information in the ‘change from’ and ‘change to’ fields of the output.
Now, the modulation profile number is displayed when a change occurs,
instead of the modulation order.
12.2(33)SCC This command was integrated into Cisco IOS Release 12.2(33)SCC.
Examples The following example shows typical output from the show cable hop command:
Router# show cable hop
Upstream Port Poll Missed Min Missed Hop Hop Corr Uncorr
Port Status Rate Poll Poll Poll Thres Period FEC FEC
(ms) Count Sample Pcnt Pcnt (sec) Errors Errors
Cable4/0/U0 down 1000 * * * frequency not set * * * 0 0
Cable4/0/U1 down 1000 * * * frequency not set * * * 0 0
Cable4/0/U2 down 1000 * * * frequency not set * * * 0 0
Cable4/0/U3 down 1000 * * * frequency not set * * * 0 0
Cable4/0/U4 down 1000 * * * frequency not set * * * 0 0
Cable4/0/U5 down 1000 * * * frequency not set * * * 0 0
Cable5/0/U0 down 1000 * * * interface is down * * * 0 0
Cable5/0/U1 down 1000 * * * frequency not set * * * 0 0
Cable5/0/U2 down 1000 * * * interface is down * * * 0 0
Cable5/0/U3 down 1000 * * * interface is down * * * 0 0
Cable5/0/U4 down 1000 * * * interface is down * * * 0 0
Cable5/0/U5 down 1000 * * * interface is down * * * 0 0
Cable6/0/U0 down 1000 * * * interface is down * * * 0 0
Cable6/0/U1 22.000 Mhz 1000 * * *set to fixed frequency * * * 31375 1912
Cable6/0/U2 26.000 Mhz 1000 * * *set to fixed frequency * * * 0 0
Cable6/0/U3 admindown 1000 * * * frequency not set * * * 0 0
The following example shows typical output from the show cable hop upstream command:
Router# show cable hop c2/0 upstream 2
Upstream Port Poll Missed Min Missed Hop Hop Corr Uncorr
Port Status Rate Poll Poll Poll Thres Period FEC FEC
(ms) Count Sample Pcnt Pcnt (sec) Errors Errors
Cable2/0/U2 admindown 1000 * * * frequency not set * * * 0 0
Router#
Table 64 describes the fields displayed by the show cable hop and show cable hop upstream
commands.
Table 64 show cable hop Command Field Descriptions
Field Description
Upstream Port The upstream port for this information line.
Port Status Lists the status of the port. Valid states are down if frequency is
unassigned or admindown if the port is shut down. If the port is up,
this column shows the center frequency of the channel.
Poll Rate The rate that station maintenance polls are generated (in
milliseconds).
Missed Poll Count The number of missing polls, per codeword/FEC block.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1229
Cable Commands: show a through show cable l
show cable hop
Table 64 show cable hop Command Field Descriptions (continued)
Field Description
Min Poll Sample The number of polls in the sample, per codeword/FEC block.
Missed PollPcnt The ratio of missing polls to the number of polls, expressed as a
percentage.
Hop Thres Pcnt The level that the missed poll percentage must exceed to trigger a
frequency hop, expressed as a percentage.
Hop Period The maximum rate that frequency hopping will occur (in seconds).
Corr FEC Errors The number of correctable forward error corrections (FEC) errors
on this upstream port, per codeword/FEC block.
Uncorr FEC Errors The number of uncorrectable FEC errors on this upstream port, per
codeword/FEC block.
Note The show cable hop and show controllers cable commands display FEC errors per
codewords, while the show interface cable upstream command displays FEC errors per
packets, where a packet could contain multiple codewords.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
The following example shows typical output from the show cable hop threshold command:
Router# show cable hop c6/0/0 threshold
Upstream SNR(dB) CNR(dB) CorrFEC% UncorrFEC% MissedSM%
Port Val Thre1 Thre2 Val Thre1 Thre2 Pcnt Thre Pcnt Thre Pcnt Thre
Ca6/0/0/U0 27 25 15 39 35 25 0 3 0 1 75 75
Ca6/0/0/U1 31 25 15 51 35 25 0 3 0 1 90 75
Ca6/0/0/U2 -- 35 25 -- 35 25 0 3 0 1 0 75
Ca6/0/0/U3 -- 35 25 -- 35 25 0 3 0 1 0 75
Table 65 describes the fields displayed by the show cable hop threeshold command.
Table 65 show cable hop threshold Command Field Descriptions
Field Description
Upstream Port The upstream port for this information line.
SNR (dB) The signal-to-noise ratio (SNR) for a particular cable modem
(CM), in decibels (dB).
CNR (dB) The current upstream carrier-to-noise ratio (CNR) for a particular
cable modem (CM), in decibels (dB).
Corr FEC Errors The number of correctable forward error corrections (FEC) errors
on this upstream port, per codeword/FEC block.
Uncorr FEC Errors The number of uncorrectable FEC errors on this upstream port, per
codeword/FEC block.
Missed SM The number of missing station maintenance polls, per
codeword/FEC block.
Cisco IOS CMTS Cable Command Reference
CBL-1230 OL-15510-15
Cable Commands: show a through show cable l
show cable hop
The following example shows typical output from the show cable hop history command:
Router# show cable hop c8/1/1 upstream 0 history
F = Frequency Hop, M = Modulation Change, C = Channel Width Change
Upstream Action Chg Chg Action
Port Time Code From To Reason
C8/1/1 U0 Feb 20 12:21:29 M 142 141 SNR 28>=28 CFEC 0<=3 UnCFEC 0<=1
Feb 20 12:09:08 F 0.000 24.000 Configuration changed
Table 66 describes the fields displayed by the show cable hop history command.
Table 66 show cable hop history Command Field Descriptions
Field Description
Upstream Port The upstream port for this information line.
Action Time The time of the spectrum management action.
Code The code associated with the type of hop.
Chg From The previous state of the spectrum management action.
Chg To The current state of the spectrum management action.
Action Reason The reason for changing the frequency.
Related Commands Command Description
cable spectrum-group Changes the minimum time between frequency hops.
hop period
cable spectrum-group Specifies a frequency hop threshold for a spectrum group.
hop threshold
cable upstream Configures the priority of the corrective actions to be taken when a
hop-priority frequency hop is necessary due to ingress noise on the upstream.
cable upstream Configures up to three modulation profiles to an upstream port to activate
modulation-profile Dynamic Upstream Modulation.
cable upstream Configures the upstream for the CNR and FEC threshold values to be used
threshold in determining the allowable noise levels.
cable upstream Configures a hysteresis value to be used in conjunction with the dynamic
threshold hysteresis modulation upgrade thresholds.
clear cable hop Clears the forward error corrections (FEC) hop counters on one or all cable
interfaces on a Cisco CMTS.
show cable host Displays the statistics for the host behind the CM.
access-group
show cable modem Displays CM configuration settings.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1231
Cable Commands: show a through show cable l
show cable host access-group
show cable host access-group
To display the hosts and other customer premises equipment (CPE) devices behind the CMs in the
network, along with their access groups, use the show cable host access-group command in privileged
EXEC mode.
show cable host [ip-address | mac-address] access-group
Note The show cable host command is not supported on the Cisco uBR10012 universal broadband router.
Syntax Description mac-addr (Optional) Specifies the 48-bit hardware address for a particular CM or host.
ip-addr (Optional) Specifies the IP address for a particular CM or host.
Command Modes Privileged EXEC
Command History Release Modification
11.NA This command was introduced.
12.1(3a)EC1 Support was added to the Release 12.1 EC train.
12.2(4)BC1 Support was added to the Release 12.2 BC train for the Cisco uBR7100
series and Cisco uBR7200 series routers. (This command also appears in
the CLI for the Cisco uBR10012 router but is not functional.)
Usage Guidelines This command displays information only for hosts and other CPE devices. To display information for
CMs and their associated CPE devices, use the show cable device access-group command. To display
information only for CMs, use the show cable device access-group command.
If an SNMP manager is requesting information about CM or CPE devices at the same time that this
command is given, the command displays the following error message:
No information is available, please try later.
Wait until the SNMP retrieval is done and retry the CLI command.
Examples The following example shows how to display all the hosts behind the CMs in the network:
router# show cable host access-group
MAC address IP address Type Access-group
0080.c6f9.b42e 24.168.220.52 host
0020.7806.defe 192.168.28.134 host
0050.baa0.5ccd 24.168.223.251 host
0050.046f.f4cf 192.168.33.25 host
0050.bacf.5d89 192.168.37.113 host
0050.1800.a8cb 192.168.33.90 host
0040.d00f.44f0 192.168.34.128 host
0050.e456.9641 192.168.39.66 host
Cisco IOS CMTS Cable Command Reference
CBL-1232 OL-15510-15
Cable Commands: show a through show cable l
show cable host access-group
0050.badd.2883 192.168.32.230 host
0050.badd.3b12 192.168.33.246 host
0020.78c7.f887 192.168.32.32 host
00e0.2969.a1a5 192.168.36.246 host
0020.78d5.ddf0 192.168.32.107 host
00001.02c5.9936 192.168.38.233 host
0020.78d0.fb32 192.168.28.45 host
0050.1800.f458 192.168.36.209 host
0002.e301.df8f 192.168.30.191 host
00a0.2451.b7eb 24.168.223.41 host
0080.c7db.afba 192.168.33.153 host
00D0.2717.1899 192.168.39.189 host
Router#
Table 0-67 describes the fields that are shown in the show cable host access-group display:
Table 0-67 show cable host access-group Field Descriptions
Field Description
MAC Address The MAC address for the CPE device.
IP Address The IP address that the DHCP server has assigned to the CPE device.
Type Identifies the type of device. With this command, this field should always be
host to indicate a CPE device. Use the show cable device access-group or
show cable modem access-group command to display information for CMs.
Access-group Displays the access group name or number in use (if any) for this CPE device.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Related Commands Command Description
cable device Configures the access list for a CM device or host.
cable host access-group Configures the access list for the specified hosts.
clear cable host Clears the host from the table.
show cable device access-group Displays a list of CMs and their CPE devices, along with their
access groups.
show cable modem access-group Displays the access groups for the CMs on a particular cable
interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1233
Cable Commands: show a through show cable l
show cable ib-ipc
show cable ib-ipc
To display the status of local IB IPC server and information on participating line cards, use the show
cable ib-ipc command in privileged EXEC mode.
show cable ib-ipc {status | ports}
Syntax Description status Displays status of local IB IPC server.
ports Displays information on participating line cards.
Command Modes Privileged EXEC
Command History Release Modification
12.3(23)BC This command was introduced for the Cisco uBR10012 router.
Examples The following is sample output from the show cable ib-ipc command. The command show cable ib-ipc
ports displays the internal virtual channel identifiers and internal service flows for Ironbus based IPC.
Router# show cable ib-ipc ports
6/0: LCP High Priority VCCI 135, SFID 32891
LCP Normal Priority VCCI 135, SFID 135
8/0: LCP High Priority VCCI 153, SFID 32909
LCP Normal Priority VCCI 153, SFID 153
Cisco IOS CMTS Cable Command Reference
CBL-1234 OL-15510-15
Cable Commands: show a through show cable l
show cable ipc-stats
show cable ipc-stats
To display statistics of all IPC messages on a Cisco CMTS router, use the show cable ipc-stats
command in privileged EXEC mode.
show cable ipc-stats
Syntax Description This command has no arguments or keywords.
Command Default None
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCC This command was introduced in Cisco IOS Release 12.2(33)SCC.
12.2(33)SCF The command output displays the IPC port information such as service type
of the IPC messages.
Usage Guidelines You must enable the Cable IPC Statistics Collection tool using the cable ipc-stats command before
using the show cable ipc-stats command. When you use this show command, a separate shadow
database buffer is allocated, and the contents of the active database are copied into the shadow database
to display the IPC statistics. This ensures that all the statistics are frozen at the same time for easy
comparison and analysis.
Examples The following is a sample output of the show cable ipc-stats command that shows statistics of all IPC
messages on a Cisco CMTS router:
Router# show cable ipc-stats
--- TIME ---
Start: 05:25:22 UTC Tue May 24 2011
End : 05:26:39 UTC Tue May 24 2011
Total: 0 days 00 hrs 01 mins 17 secs (77 seconds)
size : 2186112 bytes
--- CMTS MSG ---
entity app io s/s reqid idx dbg : pkts bytes lastEvt totalDur maxDur
lastMax
(sec) (msec) (msec) (sec)
rp-lc c10k TxReq 1/0 10241 1 off : 2 48 58
rp-lc c10k TxReq 1/0 10 14 off : 15 960 4
rp-lc c10k TxReq 1/1 10 14 off : 15 960 4
rp-lc c10k TxReq 2/1 10 14 off : 16 1024 2
rp-lc c10k TxReq 4/1 10 14 off : 15 960 4
rp-lc c10k TxReq 5/1 10252 2 off : 24 1840 3
rp-lc c10k TxReq 5/1 10 14 off : 16 1024 0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1235
Cable Commands: show a through show cable l
show cable ipc-stats
rp-lc c10k TxReq 7/0 10252 2 off : 17 1112 4
rp-lc c10k TxReq 7/0 10 14 off : 15 960 4
rp-lc c10k TxReq 8/1 10252 2 off : 22 6080 2
rp-lc c10k TxReq 8/1 10 14 off : 15 960 2
rp-lc c10k RxRsp 1/0 10241 1 off : 2 8 58 4 4
58
rp-lc c10k RxRsp 8/1 10252 2 off : 1 72 2 0 0
2
rp-lc c10k RxReq 1/0 10241 1 off : 2 64 58 0 0
58
rp-lc c10k RxReq 1/0 10 14 off : 15 960 4 0 0
4
rp-lc c10k RxReq 1/1 10241 1 off : 38 19684 1 0 0
1
rp-lc c10k RxReq 1/1 10 14 off : 15 960 4 0 0
4
rp-lc c10k RxReq 2/1 10241 1 off : 37 19166 1 0 0
1
rp-lc c10k RxReq 2/1 10 14 off : 16 1024 2 0 0
2
rp-lc c10k RxReq 4/1 10241 1 off : 32 2144 0 0 0
0
rp-lc c10k RxReq 4/1 10 14 off : 15 960 4 0 0
4
rp-lc c10k RxReq 5/1 10252 2 off : 242 733456 2 0 0
2
rp-lc c10k RxReq 5/1 10 14 off : 16 1088 0 0 0
0
rp-lc c10k RxReq 7/0 10252 2 off : 257 783364 1 0 0
1
rp-lc c10k RxReq 7/0 10 14 off : 15 1020 4 0 0
4
rp-lc c10k RxReq 8/1 10252 2 off : 241 714668 4 0 0
4
rp-lc c10k RxReq 8/1 10 14 off : 15 1020 2 0 0
2
rp-lc pnego TxReq 5/1 14 6 off : 1 30 77
entity app io s/s reqid idx dbg : pkts bytes lastEvt totalDur maxDur
lastMax
(sec) (msec) (msec) (sec)
rp-lc pnego TxReq 7/0 14 6 off : 1 30 77
rp-lc pnego TxReq 8/1 14 6 off : 1 30 77
rp-lc plfm RxReq 5/1 24 17 off : 2 24 12 0 0
12
rp-lc plfm RxReq 5/1 27 20 off : 225 23400 2 36 4
12
rp-lc plfm RxReq 5/1 28 21 off : 9900 554400 2 1584 4
12
rp-lc plfm RxReq 7/0 24 17 off : 1 12 21 0 0
21
rp-lc plfm RxReq 7/0 27 20 off : 240 24960 1 72 4
1
rp-lc plfm RxReq 7/0 28 21 off : 10560 591360 1 3168 4
1
rp-lc plfm RxReq 8/1 24 17 off : 1 12 28 0 0
28
rp-lc plfm RxReq 8/1 27 20 off : 225 23400 4 32 4
4
rp-lc plfm RxReq 8/1 28 21 off : 9900 554400 4 1408 4
4
rp-lc docsis TxReq 5/1 118 109 off : 30 240 3
rp-lc docsis TxReq 7/0 118 109 off : 16 128 4
rp-lc docsis TxReq 8/1 118 109 off : 16 128 3
Cisco IOS CMTS Cable Command Reference
CBL-1236 OL-15510-15
Cable Commands: show a through show cable l
show cable ipc-stats
rp-lc docsis RxReq 5/1 153 144 off : 345 19320 2 184 4
7
rp-lc docsis RxReq 7/0 153 144 off : 384 21504 1 192 4
66
rp-lc docsis RxReq 8/1 153 144 off : 60 3360 4 80 4
9
rp-lc docsis RxReq 8/1 154 145 off : 15 480 4 20 4
9
rp-lc snmp RxReq 5/1 42 42 off : 2 32 5 4 4
5
rp-lc test TxReq 8/1 10 3 off : 1 16 2
rp-lc test TxReq 8/1 20 13 off : 100 1600 2
rp-lc test RxRsp 8/1 10 3 off : 1 16 2 0 0
2
--- CMTS TXQ ---
TXQ_5_1_default
enQ: 24 pkts max Q size 1 at 3 sec ago
deQ: 24 pkts max delay 0 msec at 3 sec ago
delay between ( 0, 10) msec: 24 pkts
delay between ( 0, 1) sec : 24 pkts
flush: 0 ptks 0 times
TXQ_7_0_default
enQ: 17 pkts max Q size 1 at 4 sec ago
deQ: 17 pkts max delay 0 msec at 4 sec ago
delay between ( 0, 10) msec: 17 pkts
delay between ( 0, 1) sec : 17 pkts
flush: 0 ptks 0 times
TXQ_8_1_default
enQ: 17 pkts max Q size 1 at 3 sec ago
deQ: 17 pkts max delay 0 msec at 3 sec ago
delay between ( 0, 10) msec: 17 pkts
delay between ( 0, 1) sec : 17 pkts
flush: 0 ptks 0 times
TXQ_8_1_inband
enQ: 5 pkts max Q size 5 at 2 sec ago
deQ: 5 pkts max delay 4 msec at 2 sec ago
delay between ( 0, 10) msec: 5 pkts
delay between ( 0, 1) sec : 5 pkts
flush: 0 ptks 0 times
--- CMTS WATERMARK ---
--- CMTS RXQ ---
CMTS rxq
enQ: 956 pkts max Q size 6 at 41 sec ago
deQ: 956 pkts max delay 4 msec at 69 sec ago
delay between ( 0, 10) msec: 956 pkts
delay between ( 0, 1) sec : 956 pkts
flush: 0 ptks 0 times
CMTS LP rxq
enQ: 742 pkts max Q size 6 at 41 sec ago
deQ: 742 pkts max delay 8 msec at 64 sec ago
delay between ( 0, 10) msec: 742 pkts
delay between ( 0, 1) sec : 742 pkts
flush: 0 ptks 0 times
Table 1 describes the fields displayed by the show cable ipc-stats command.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1237
Cable Commands: show a through show cable l
show cable ipc-stats
Table 68 show cable ipc-stats Command Field Descriptions
Field Description
entity Route processor-to-line card connection or a line
card-to-line card connection.
app Message group.
io Send request or a send response, or a receiver
request or a receiver response.
s/s Slot/subslot
reqid Nonsequential message ID for the original
request.
idx Sequential message index for the original request.
pkts Number of messages.
bytes Number of bytes.
lastEvt (sec) Seconds since the last send or receive event.
totalDur (msec) Total time in milliseconds for the blocked send
wait or received request process.
maxDur (msec) Maximum time in milliseconds for the blocked
send wait or received request process.
lastMax (sec) Seconds since the last maxDur is recorded.
Related Commands Command Description
cable ipc-stats Enables the Cable IPC Statistics Collection tool on a Cisco CMTS router.
clear cable ipc-stats Clears the active database and resets all IPC statistics in the active database
to zero.
Cisco IOS CMTS Cable Command Reference
CBL-1238 OL-15510-15
Cable Commands: show a through show cable l
show cable l2-vpn dot1q-vc-map
show cable l2-vpn dot1q-vc-map
To display the mapping of one or all cable modems to IEEE 802.1Q Virtual Local Area Networks
(VLANs) on the router’s Ethernet interfaces, use the show cable l2-vpn dot1q-vc-map command in
privileged EXEC mode.
show cable l2-vpn dot1q-vc-map [mac-address [vpn vpnid][verbose]] [customer cust-name][vpn
vpnid]
Syntax Description mac-address (Optional) Displays the mapping for the cable modem with the specified
hardware MAC address.
vpn vpnid (Optional) Displays Layer 2 VPN information on a cable modem with the
specified MAC address, or for the specified VPN ID across all cable
modems.
verbose (Optional) Displays additional information about the Layer 2 mapping,
including the number of packets and bytes received on the upstream and
downstream.
customer cust-name (Optional) Displays the VLAN mappings for this particular customer name.
Defaults Displays information for all cable modems that have a defined IEEE 802.1Q VLAN mapping.
Command Modes Privileged EXEC
Command History Release Modification
12.2(15)BC2 This command was introduced for Cisco uBR7246VXR universal
broadband routers.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA on the
Cisco uBR7246VXR and Cisco uBR10012 universal broadband routers.
Support for the Cisco uBR7225VXR router was added. The vpn keyword
was added and the output fields were modified to display L2VPN
information.
Usage Guidelines This command displays the cable modem to VLAN mappings that have been defined using the cable
dot1q-vc-map command. It displays the MAC address, service ID (SID), and cable interface being used
by the cable modem, and the interface and VLAN ID to which it has been mapped.
Tip The customer option displays only those VLAN mappings that have been configured with a particular
customer name, using the cable dot1q-vc-map command.
The command also displays L2VPN information for cable modem traffic and service flows on CMTS
router Ethernet interfaces that have been defined using the cable l2-vpn-service default-nsi command.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1239
Cable Commands: show a through show cable l
show cable l2-vpn dot1q-vc-map
Examples TLS in Cisco IOS Release 12.2BC Examples
The following example shows typical output for the show cable l2-vpn dot1q-vc-map command for all
cable modems that are mapped to IEEE 802.1Q VLANs:
Router# show cable l2-vpn dot1q-vc-map
MAC Address Ethernet Interface VLAN ID Cable Intf SID Priv Bits
0010.7bed.9c95 FE0/0.2 3 Cable4/0 3 0
0007.0e03.69f9 FE0/0.1 4 Cable4/0 1 0
Router#
The following example shows typical output for a particular cable modem with the MAC address of
0001.0203.0405:
Router# show cable l2-vpn dot1q-vc-map 0001.0203.0405
MAC Address Ethernet Interface VLAN ID Cable Intf SID Priv Bits
0010.7bed.9c91 GE2/0 5 Cable5/0 7 0
Router#
The following example shows a typical example for the verbose option:
Router# show cable l2-vpn dot1q-vc-map 0001.0203.0405 verbose
MAC Address : 0010.7bed.9c91
Prim Sid : 7
Cable Interface : Cable5/0
Ethernet Interface : GigabitEthernet2/0
DOT1Q VLAN ID : 5
Total US pkts : 6
Total US bytes : 1402
Total DS pkts : 71
Total DS bytes : 21975
Table 69 describes the fields shown in the display.
Table 69 show cable l2-vpn dot1q-vc-map Field Descriptions
Field Description
MAC Address Hardware (MAC) address for the CM being mapped.
Ethernet Interface Destination interface (Ethernet, Fast Ethernet, or Gigabit Ethernet) for the
VLAN being used for the mapping.
VLAN ID Destination VLAN on the Ethernet, Fast Ethernet, or Gigabit Ethernet interface
for the traffic coming from the CM.
Cable Intf Cable interface to which the CM is connected.
SID Primary service ID (SID) for this cable modem.
Cisco IOS CMTS Cable Command Reference
CBL-1240 OL-15510-15
Cable Commands: show a through show cable l
show cable l2-vpn dot1q-vc-map
Table 69 show cable l2-vpn dot1q-vc-map Field Descriptions (continued)
Field Description
Priv Bits Identifies the current settings of the two privacy bits in the extended header (EH)
that is used for BPI-encrypted packets.
• First bit = Enable bit. Set to 1 when BPI or BPI+ is enabled.
• Second bit = Toggle bit. Matches the least-significant bit (LSB) of the key
sequence number (KSN) in the EH.
For example, a value of “0” indicates that BPI is not enabled. A value of “10”
indicates that BPI is enabled and that the KSN is an even number. A value of “11”
indicates that BPI is enabled and that the KSN is an odd number.
Note For more information on these bits, see the DOCSIS Baseline Privacy
Interface Plus Interface Specification (SP-BPI+-I08-020301 or later).
Total US pkts/bytes Total number of packets and bytes sent on the upstream to the Layer 2 tunnel by
this cable modem.
Total DS pkts/bytes Total number of packets and bytes received on the downstream from the Layer 2
tunnel by this cable modem.
L2VPN over Cable in Cisco IOS Release 12.2SB Examples
The following example shows sample output of VLAN information for all cable modems configured for
L2VPN support:
Router# show cable l2-vpn dot1q-vc-map
MAC Address Ethernet Interface VLAN ID Cable Intf SID Customer Name/VPN ID
0014.f8c1.fd66 GigabitEthernet4/0/0 68 Cable6/0/0 3 0234560001
The following example shows sample output of VLAN information for a VPN with ID 0234560001:
Router# show cable l2 dot1q-vc-map vpn 0234560001
MAC Address Ethernet Interface VLAN ID Cable Intf SID Customer Name/VPNID
0014.f8c1.fd66 GigabitEthernet4/0/0 68 Cable6/0/0 3 0234560001
The following example shows sample output of VLAN information for a VPN with ID 0234560001 on
the cable modem with MAC address 0014.f8c1.fd66:
Router# show cable l2-vpn dot1q-vc-map 0014.f8c1.fd66 vpn 0234560001
MAC Address Ethernet Interface VLAN ID Cable Intf SID Customer Name/VPNID
0014.f8c1.fd66 GigabitEthernet4/0/0 68 Cable6/0/0 3 0234560001
The following example shows sample output of detailed VLAN information for a VPN with ID
0234560001 on the cable modem with MAC address 0014.f8c1.fd66:
Router# show cable l2-vpn dot1q-vc-map 0014.f8c1.fd66 vpn 0234560001 verbose
MAC Address : 0014.f8c1.fd66
Prim Sid : 3
Cable Interface : Cable6/0/0
VPN ID : 0234560001
L2VPN SAID : 12294
Upstream SFID : 23
Downstream CFRID[SFID] : 2[24]
CMIM : 0x60
Ethernet Interface : GigabitEthernet4/0/0
DOT1Q VLAN ID : 68
Total US pkts : 1372
Total US bytes : 500226
Total US pkt Discards : 0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1241
Cable Commands: show a through show cable l
show cable l2-vpn dot1q-vc-map
Total US byte Discards : 0
Total DS pkts : 1248
Total DS bytes : 415584
Total DS pkt Discards : 0
Total DS byte Discards : 0
The following example shows sample output of detailed VLAN information for a cable modem with
MAC address 0014.f8c1.fd66:
Router# show cable l2-vpn dot1q-vc-map 0014.f8c1.fd66 verbose
MAC Address : 0014.f8c1.fd66
Prim Sid : 3
Cable Interface : Cable6/0/0
L2VPNs provisioned : 1
DUT Control/CMIM : Enable/0xFFFFFFFF
VPN ID : 0234560001
L2VPN SAID : 12294
Upstream SFID : 23
Downstream CFRID[SFID] : 2[24]
CMIM : 0x60
Ethernet Interface : GigabitEthernet4/0/0
DOT1Q VLAN ID : 68
Total US pkts : 1374
Total US bytes : 501012
Total US pkt Discards : 0
Total US byte Discards : 0
Total DS pkts : 1250
Total DS bytes : 416250
Total DS pkt Discards : 0
Total DS byte Discards : 0
Table 70 describes the fields shown in the display.
Table 70 show cable l2-vpn dot1q-vc-map with L2VPN Field Descriptions
Field Description
MAC Address Hardware (MAC) address for the CM being mapped.
Prim Sid Primary service ID for the CM.
Cable Interface Cable interface to which the CM is connected.
L2VPNs provisioned Number of L2VPNs supported by the CM.
DUT Control/CMIM State of Downstream Unencrypted Traffic (DUT) filtering and Cable
Modem Interface Mask (CMIM).
VPN ID Identification number of the Layer 2 VPN tunnel.
L2VPN SAID Layer 2 VPN Security Association Identifier (SAID).
Upstream SFID Upstream Service Flow Identifier (SFID).
Downstream CFRID Downstream classifiers (classifier identifiers) and corresponding
[SFID] downstream service flows identifiers for this L2VPN.
CMIM Cable Modem Interface Mask.
Ethernet Interface Ethernet Network System Interface (NSI).
DOT1Q VLAN ID Destination VLAN on the Ethernet, Fast Ethernet, or Gigabit Ethernet
interface for the traffic coming from the CM.
Cisco IOS CMTS Cable Command Reference
CBL-1242 OL-15510-15
Cable Commands: show a through show cable l
show cable l2-vpn dot1q-vc-map
Table 70 show cable l2-vpn dot1q-vc-map with L2VPN Field Descriptions (continued)
Field Description
Total US pkts/bytes Total number of packets and bytes sent on the upstream to the Layer 2
tunnel by this CM.
Total US pkt/byte Total number of packets and bytes dropped on the upstream to the Layer 2
Discards tunnel by this CM.
Total DS pkts/bytes Total number of packets and bytes received on the downstream from the
Layer 2 tunnel by this CM.
Total DS pkt/byte Total number of packets and bytes dropped on the downstream from the
Discards Layer 2 tunnel by this CM.
Related Commands Command Description
cable l2-vpn-service Enables the use of Layer 2 tunnels for the Customer Premises Equipment
dot1q (CPE) traffic that is behind cable modems so that individual CPE traffic can
be routed over a particular Virtual Local Area Network (VLAN).
cable dot1q-vc-map Maps a cable modem to a particular VLAN on a local outbound Ethernet
interface.
cable l2-vpn-service Configures an Ethernet Network System Interface for Layer 2 VPN support
default-nsi over cable.
debug cable l2-vpn Displays debugging messages for the Layer 2 mapping of cable modems to
particular PVCs or VLANs.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1243
Cable Commands: show a through show cable l
show cable l2-vpn vc-map
show cable l2-vpn vc-map
To display the mapping of one or all cable modems to permanent virtual connections (PVC) on
Asynchronous Transfer Mode (ATM) interfaces, use the show cable l2-vpn vc-map command in
privileged EXEC mode.
show cable l2-vpn vc-map [mac-address] [customer cust-name]
Syntax Description mac-address (Optional) Displays the mapping for the cable modem with the specified
hardware (MAC).
customer cust-name (Optional) Displays the PVC mappings for this particular customer name.
Defaults Displays information for all cable modems that have a defined ATM PVC mapping.
Command Modes Privileged EXEC
Command History Release Modification
12.2(11)BC3 This command was introduced for Cisco uBR7100 series and
Cisco uBR7246VXR universal broadband routers.
12.2(15)BC2 Support was added for the customer option.
Usage Guidelines This command displays the cable modem to ATM PVC mappings that have been defined using the cable
vc-map command. It displays the MAC address, service ID (SID), and cable interface being used by the
cable modem, and the ATM interface and PVC/PVI to which it has been mapped.
Tip The customer option displays only those PVC mappings that have been configured with a particular
customer name, using the cable vc-map command.
Examples The following example shows typical output for the show cable l2-vpn vc-map command for all cable
modems that are mapped to ATM PVCs:
Router# show cable l2-vpn vc-map
MAC Address ATM Intf VPI/VCI Cable Intf SID Priv Bits
0010.7bed.9c95 ATM2/0.2 1/2 Cable4/0 3 0
0007.0e03.69f9 ATM2/0.1 1/1 Cable4/0 1 0
Router#
The following example shows typical output for a particular cable modem with the MAC address of
0001.0203.0405:
Router# show cable l2-vpn vc-map 0001.0203.0405
MAC Address ATM Intf VPI/VCI Cable Intf SID Priv Bits
Cisco IOS CMTS Cable Command Reference
CBL-1244 OL-15510-15
Cable Commands: show a through show cable l
show cable l2-vpn vc-map
0001.0203.0405 ATM3/0.2 1/2 Cable5/0 3 0
Router#
Table 0-71 describes the fields shown in the display.
Table 0-71 show cable l2-vpn vc-map Field Descriptions
Field Description
MAC Address Hardware (MAC) address for the CM being mapped.
ATM Intf Destination ATM interface that contains the VPI/VCI being used for the
mapping.
VPI/VCI Destination VPI/VCI on the ATM interface for the traffic coming from the CM.
Cable Intf Cable interface to which the CM is connected.
SID Primary service ID (SID) for this cable modem.
Priv Bits Identifies the current settings of the two privacy bits in the extended header (EH)
that is used for BPI-encrypted packets.
• First bit = Enable bit. Set to 1 when BPI or BPI+ is enabled.
• Second bit = Toggle bit. Matches the least-significant bit (LSB) of the key
sequence number (KSN) in the EH.
For example, a value of “0” indicates that BPI is not enabled. A value of “10”
indicates that BPI is enabled and that the KSN is an even number. A value of “11”
indicates that BPI is enabled and that the KSN is an odd number.
Note For more information on these bits, see the DOCSIS Baseline Privacy
Interface Plus Interface Specification (SP-BPI+-I08-020301 or later).
Related Commands Command Description
cable l2-vpn-service Enables the use of Layer 2 tunnels for the Customer Premises Equipment
atm-vc (CPE) traffic that is behind cable modems, so that individual CPE traffic
can be routed to a particular PVC on an ATM interface.
cable vc-map Maps a cable modem to a particular PVC on an ATM interface.
debug cable l2-vpn Displays debugging messages for the Layer 2 mapping of cable modems to
particular PVC on an ATM interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1245
Cable Commands: show a through show cable l
show cable l2-vpn xconnect
show cable l2-vpn xconnect
To display details about the mapping between a Multiprotocol Label Switching (MPLS) pseudowire and
its virtual circuits, use the show cable l2-vpn xconnect command in privileged EXEC mode.
show cable l2-vpn xconnect {dot1q-vc-map | mpls-vc-map} [mac-address | customer
customer-name | state] [verbose]
Syntax Description dot1q-vc-map Specifies the mapping of one or all cable modems to IEEE 802.1Q Virtual
Local Area Networks (VLANs) on the Ethernet interfaces of a router.
mpls-vc-map Specifies the mapping between an MPLS pseudowire and its virtual circuits.
mac-address (Optional) MAC address for a cable modem.
customer (Optional) Specifies the customer name.
customer-name
state (Optional) Specifies the state of all virtual circuits.
verbose (Optional) Specifies verbose mode for the output, giving additional details
about the mapping between an MPLS pseudowire and its virtual circuits.
Command Default None
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCC This command was introduced in Cisco IOS Release 12.2(33)SCC.
12.2(33)SCF This command was modified. The verbose keyword option was added.
Examples Example of the show cable l2-vpn xconnect Command for the Mapping Between an MPLS Pseudowire and All
Virtual Circuits
The following is a sample output of the show cable l2-vpn xconnect command that shows the mapping
between an MPLS pseudowire and all virtual circuits on a Cisco uBR10012 router:
Router# show cable l2-vpn xconnect mpls-vc-map
MAC Address Peer IP Address VCID CktID Cable Intf SID Customer
Name/VPNID
0000.396e.6a68 101.1.0.2 221 Bu254:221 Cable7/0/0 1 customer1
0014.f8c1.fd66 10.76.1.1 2004 Bu254:5121 Cable7/0/0 8
0019.474a.d566 10.76.1.1 2001 Bu254:5122 Cable7/0/0 4 0234560002
0019.474a.d42e 10.76.1.1 2002 Bu254:2003 Cable7/0/0 5 0234560003
Cisco IOS CMTS Cable Command Reference
CBL-1246 OL-15510-15
Cable Commands: show a through show cable l
show cable l2-vpn xconnect
Example of the show cable l2-vpn xconnect Command for a Particular MAC Address
The following sample output displays the mapping between an MPLS pseudowire and the virtual circuit
for a particular MAC address of a cable modem on a Cisco uBR10012 router:
Router# show cable l2-vpn xconnect mpls-vc-map 0000.396e.6a68
MAC Address Peer IP Address VCID CktID Cable Intf SID Customer
Name/VPNID
0000.396e.6a68 101.1.0.2 221 Bu254:221 Cable7/0/0 1 customer1
Example of the show cable l2-vpn xconnect Command for a Particular Customer
The following sample output displays the mapping between an MPLS pseudowire and all virtual circuits
configured for a particular customer on a Cisco uBR10012 router:
Router# show cable l2-vpn xconnect mpls-vc-map customer1
MAC Address Peer IP Address VCID CktID Cable Intf SID Customer
Name/VPNID
0000.396e.6a68 101.1.0.2 221 Bu254:221 Cable7/0/0 1 customer1
Example of the show cable l2-vpn xconnect Command that Shows Information About the State of All Virtual
Circuits
The following sample output displays the state of all virtual circuits associated with an MPLS
pseudowire on a Cisco uBR10012 router:
Router# show cable l2-vpn xconnect mpls-vc-map state
Peer IP Address VCID STATE MAC Address Customer Name/VPNID STATE
101.1.0.2 22 DOWN 0000.396e.6a68 customer1 UP
10.76.1.1 2004 UP 0014.f8c1.fd66 UP
10.76.1.1 2001 UP 0019.474a.d566 0234560002 UP
10.76.1.1 2002 UP 0019.474a.d42e 0234560003 UP
Example of the show cable l2-vpn xconnect Command for the Mapping Between an MPLS Pseudowire and All
Virtual Circuits in Cisco IOS Release 12.2(33)SCF
The following is a sample output of the show cable l2-vpn xconnect command that shows the details of
the mapping between an MPLS pseudowire and all virtual circuits on a Cisco uBR10012 router:
Router# show cable l2-vpn xconnect mpls-vc-map 54d4.6f88.7362 verbose
Load for five secs: 2%/0%; one minute: 1%; five minutes: 2%
Time source is hardware calendar, *16:46:29.139 pst Thu Mar 3 2011
MAC Address : 54d4.6f88.7362
Customer Name :
Prim Sid : 18
Cable Interface : Cable5/0/1
MPLS-EXP : 0
PW TYPE : Ethernet
Backup enable delay : 0 seconds
Backup disable delay : 0 seconds
Primary peer
Peer IP Address (Active) : 10.8.8.8
XConnect VCID : 97
Circuit ID : Bu254:97
Local State : UP
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1247
Cable Commands: show a through show cable l
show cable l2-vpn xconnect
Remote State : UP
Total US pkts : 418756
Total US bytes : 586227332
Total US pkts discards : 0
Total US bytes discards : 0
Total DS pkts : 417347
Total DS bytes : 591773612
Total DS pkts discards : 0
Total DS bytes discards : 0
Table 72 describes the fields shown in the show cable l2-vpn xconnect command display.
Table 72 show cable l2-vpn xconnect Field Descriptions
Field Description
MAC Address MAC address of a cable modem.
Peer IP Address IP address of the remote provider edge router.
VCID Virtual circuit ID.
CktID Circuit ID.
Cable Intf/Interface Cable interface for the MPLS pseudowire.
SID Service ID.
STATE State of all virtual circuits.
Customer Name Customer name.
Prim Sid Primary service ID.
MPLS-EXP Multiprotocol Label Switching experimental bit value.
PW TYPE Pseudowire type.
Backup enable delay Interval to enable backup.
Backup disable delay Interval to disable backup.
Peer IP Adress (Active) IP address of the active peer router.
XConnect VCID Xconnect virtual circuit ID.
Circuit ID Circuit ID.
Local State Local state.
Remote State Remote state.
Total US pkts Total number of packets sent on the upstream.
Total US bytes Total number of bytes sent on the upstream.
Total US pkts discards Total number of packets discarded on the upstream.
Total US bytes discards Total number of bytes discarded on the upstream.
Total DS pkts Total number of packets received on the downstream.
Total DS bytes Total number of bytes received on the downstream.
Total DS pkts discards Total number of packets discarded on the downstream.
Total DS bytes discards Total number of bytes discarded on the downstream.
Cisco IOS CMTS Cable Command Reference
CBL-1248 OL-15510-15
Cable Commands: show a through show cable l
show cable l2-vpn xconnect
Related Commands Command Description
show xconnect Displays information about attachment circuits and pseudowires.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1249
Cable Commands: show a through show cable l
show cable leasequery-filter
show cable leasequery-filter
To display the number of Dynamic Host Configuration Protocol (DHCP) LEASEQUERY request
messages that have been filtered for all cable modems (CMs) or for a particular cable interface, use the
show cable leasequery-filter command in privileged EXEC mode.
show cable leasequery-filter [cable {slot/port | slot/subslot/port}[requests-filtered
[minimum-requests]]]
Syntax Description cable slot/port (Optional) Displays information for all CMs on the specified cable interface
and downstream port on the Cisco uBR7200 series routers.
• slot—3 to 6
• port—0 or 1 (depending on the cable interface)
cable slot/subslot/port (Optional) Displays information for all CMs on the specified cable interface
on the Cisco uBR10012 router. The following are the valid values:
• slot—5 to 8
• subslot—0 or 1
• port—0 to 4 (depending on the cable interface)
requests-filtered (Optional) Displays the number of DHCP LEASEQUERY requests that have
been filtered for each particular cable modem on a cable interface.
• minimum-requests—(Optional) Displays only those cable modems for
which the router has filtered at least this minimum number of lease
queries. The valid range is from 1 to 65535, with a default of 1.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(15)BC1d, This command was introduced.
12.2(15)BC2b
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
12.2(33)SCF1 This command was modified. The command output has been augmented to
display IPv6 data.
Usage Guidelines The show cable leasequery-filter command displays the total number of DHCP LEASEQUERY
requests that have been filtered on a Cisco Cable Modem Termination System (CMTS) router and on a
particular cable interface. This command can also optionally display details for each particular cable
modem on an interface that has had DHCP lease queries filtered.
Cisco IOS CMTS Cable Command Reference
CBL-1250 OL-15510-15
Cable Commands: show a through show cable l
show cable leasequery-filter
Examples The following examples show how to display the total number of DHCP LEASEQUERY requests that
have been filtered on the router and on a particular cable interface:
Router# show cable leasequery-filter
Lease Query Filter statistics for Unknown Sid
Requests Sent : 138 total. 41 unfiltered, 97 filtered
Router# show cable leasequery-filter cable 8/1/0
Lease Query Filter statistics for Cable8/1/0:
Requests Sent : 35 total. 25 unfiltered, 10 filtered
The following examples show how to display the total number of DHCP LEASEQUERY requests that
have been filtered on the router and on a particular cable interface in Cisco IOS Release 12.2(33)SCF1:
Router# show cable leasequery-filter
IPv4 Lease Query Filter statistics for Unknown Sid
Requests Sent : 0 total. 0 unfiltered, 0 filtered
IPv6 Lease Query Filter statistics for Unknown Sid
Requests Sent : 0 total. 0 unfiltered, 0 filtered
Router# show cable leasequery-filter cable 7/0/0
IPv4 Lease Query Filter statistics for Cable7/0/0:
Requests Sent : 0 total. 0 unfiltered, 0 filtered
IPv6 Lease Query Filter statistics for Cable7/0/0:
Requests Sent : 0 total. 0 unfiltered, 0 filtered
The following example shows how to display a list of cable modems on a cable interface and the number
of DHCP LEASEQUERY messages that have been filtered for each interface:
Router# show cable leasequery-filter cable 8/1/0 requests-filtered
Sid MAC Address IP Address Req-Filtered
1 0050.7366.1243 92.1.1.20 0
2 0007.0e06.953b 95.1.1.24 0
3 0007.0e06.97b5 93.1.1.24 2
4 00d0.ba45.4bd5 91.1.1.35 0
5 0007.0e06.9773 95.1.1.23 12
6 0001.42aa.737d 94.1.1.23 645
7 0001.42aa.738b 95.1.1.22 0
8 00d0.ba45.4955 92.1.1.23 0
9 0007.0e06.51ef 94.1.1.25 0
10 00d0.ba77.743b 91.1.1.36 3
11 0001.42aa.6e6f 93.1.1.22 2
12 0007.0e06.512f 91.1.1.23 2
13 0007.0e06.5137 92.1.1.25 0
14 0007.0e06.9be7 92.1.1.24 0
15 0002.b970.0027 92.1.1.22 1
16 0001.42aa.738d 91.1.1.21 10
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1251
Cable Commands: show a through show cable l
show cable leasequery-filter
The following example shows how to display a list of cable modems on a cable interface and the number
of DHCP LEASEQUERY messages that have been filtered for each interface in
Cisco IOS Release 12.2(33)SCF1:
Router# show cable leasequery-filter cable 8/1/0 requests-filtered
Sid MAC Address IP Address Req-Filtered
1 0018.6835.2756 0.0.0.0 0
2 0025.2e2d.7440 0.0.0.0 0
Sid MAC Address IP Address Req-Filtered
1 0018.6835.2756 2001:DB8:1::1 0
2 0025.2e2d.7440 2001:DB8:1::2 0
The following example shows how to display a list of cable modems on a cable interface that have had
ten or more DHCP LEASEQUERY messages that have been filtered:
Router# show cable leasequery-filter cable 8/1/0 requests-filtered 10
Sid MAC Address IP Address Req-Filtered
5 0007.0e06.9773 95.1.1.23 12
6 0001.42aa.737d 94.1.1.23 645
16 0001.42aa.738d 91.1.1.21 10
Table 73 describes the fields shown in the show cable leasequery-filter display.
Table 73 show cable leasequery-filter Field Descriptions
Field Description
Sid Service ID (SID) of the device.
MAC Address Hardware (MAC-layer) address of the cable
modem or CPE device.
IP Address IP address of the cable modem (CMs) or customer
premises equipment (CPE).
Req-Filtered Total number of Address Resolution Protocol
(ARP) requests that the device has generated or
forwarded.
Related Commands Command Description
cable arp Activates the cable ARP.
cable arp filter Controls the number of ARP requests and replies that are forwarded on a
cable interface.
cable source-verify Enables verification of IP addresses for CMs and CPE devices on the
upstream.
cable source-verify Controls the number of DHCP lease query messages that are sent for
leasequery-filter unknown IP addresses on all cable downstream interfaces on the
downstream Cisco CMTS router.
cable source-verify Controls the number of DHCP lease query messages that are sent for
leasequery-filter unknown IP addresses for each SID on an upstream.
upstream
Cisco IOS CMTS Cable Command Reference
CBL-1252 OL-15510-15
Cable Commands: show a through show cable l
show cable licenses all
show cable licenses all
To view license information as applied to RF channels on the CMTS chassis, use the show cable licenses
all command in the privileged EXEC mode.
show cable licenses all
Syntax Description This command has no arguments or keywords.
Command Default Disabled
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCE This command was introduced.
Examples The following example indicates information about licenses applied to RF channels on the CMTS
chassis.
Router# show cable licenses all
Load for five secs: 0%/0%; one minute: 1%; five minutes: 1%
Time source is hardware calendar, *05:40:06.005 UTC Mon May 3 2010
Subslot 6/0 : License Configuration : 20X20
Subslot 7/0 : Downstream Licenses : Installed : 72 Consumed : 8 Available : 64
Subslot 7/0 : Upstream Licenses : Installed : 60 Consumed : 52 Available : 8
Subslot 7/1 : Downstream Licenses : Installed : 72 Consumed : 0 Available : 72
Subslot 7/1 : Upstream Licenses : Installed : 60 Consumed : 0 Available : 60
Subslot 8/0 : Downstream Licenses : Installed : 72 Consumed : 8 Available : 64
Subslot 8/0 : Upstream Licenses : Installed : 60 Consumed : 52 Available : 8
Subslot 8/1 : Downstream Licenses : Installed : 0 Consumed : 0 Available : 0
Subslot 8/1 : Upstream Licenses : Installed : 0 Consumed : 0 Available : 0
Router#
The following example indicates information about licenses that are loaded on the slot/subslot.
Router# show cable licenses 8/0
Load for five secs: 1%/0%; one minute: 1%; five minutes: 1%
Time source is hardware calendar, *05:59:18.633 UTC Mon May 3 2010
Subslot 8/0 : Downstream Licenses : Installed : 72 Consumed : 8 Available : 64
Subslot 8/0 : Upstream Licenses : Installed : 60 Consumed : 52 Available : 8
Router#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1253
Cable Commands: show a through show cable l
show cable licenses all
Related Commands Command Description
show license call-home pak Displays the stock keeping unit (SKU) list and features
available in a product authorization key (PAK).
license call-home install pak Installs a license by using the Cisco License Call Home feature.
Cisco IOS CMTS Cable Command Reference
CBL-1254 OL-15510-15
Cable Commands: show a through show cable l
show cable load-balance
show cable load-balance
To display real-time configuration, statistical and operational information for load balancing operations
on the router, use the show cable load-balance command in privileged EXEC mode.
show cable load-balance [[group n] | [all | load | pending | statistics | target |
fiber-node-validation | vdoc]]
Syntax Description group n (Optional) Specifies the number of the load balancing group to be
displayed.
In Cisco IOS Release 12.2(33)SCE3 and earlier, the valid range is from 1
to 336. The range from 1 to 80 is reserved for legacy load balancing groups
(LBG). The range from 81 to 336 is reserved for DOCSIS LBGs.
In Cisco IOS Release 12.2(33)SCE4 and later, the valid range is from
1 to 256. This range is reserved for legacy LBGs only.
all (Optional) Displays all information about the LBG.
load (Optional) Displays the current interface load and load balancing group
assignments.
pending (Optional) Displays the list of cable modems that are moved from one
downstream or upstream to another.
statistics (Optional) Displays cumulative statistics for load balancing operations.
target (Optional) Displays the current and target interfaces (upstreams and
downstreams) used for load balancing.
fiber-node-validation (Optional) Displays DOCSIS LBG and channel information after checking
if the channel configuration in load balancing fits in the fiber node
configuration.
vdoc (Optional) Displays information about all LBGs that have the rule
"video-over-DOCSIS (vdoc)-enabled" configured.
Defaults Displays information for all load balancing groups for each cable interface and its current load and load
balancing status. Starting with Cisco IOS Release 12.2(33)SCE4, the show cable load-balance
command supports only the legacy LBGs.
Command Modes Privileged EXEC
Command History Release Modification
12.2(15)BC1 This command was introduced for the Cisco uBR7246VXR and
Cisco uBR10012 routers.
12.2(33)SCC This command was modified. The fiber-node-validation parameter was
added to the command.
12.2(33)SCF This command was modified. The vdoc keyword was added to the
command.
12.2(33)SCE4 The valid range for the load balance group was changed.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1255
Cable Commands: show a through show cable l
show cable load-balance
Usage Guidelines Use the show cable load-balance command to display the current, real-time statistics for load balancing
operations.
Examples The following is a sample output from the show cable load-balance command:
Router# show cable load-balance
Group Interval Method DCC Init Threshold
Technique Minimum Static Enforce Ugs PCMM
1 10 service-flows 1 1 2% 2% --- ---
2 10 modems 0 5 10% --- --- ---
DOCSIS LB Enabled: No
Starting with Cisco IOS Release 12.2(33)SCG, a new column in the output for the show cable
load-balance command also displays the group index for the legacy load balance group. The
Group Index column identifies the mapping between the legacy load balance group ID and the internal
group index of the legacy LBG.
Router# show cable load-balance
Legacy Group Interval Method DCC Init Threshold
Group Index Technique Minimum Static Enforce Ugs PCMM
1 513 30 modems 0 5 10% --- --- ---
2 514 30 modems 0 5 10% --- --- ---
DOCSIS 2.0 LB Enabled: Yes DOCSIS 3.0 LB Enabled: No
DOCSIS Group Status Interval DCC mask Policy Method Threshold
Group Index /UCC DS/US M/E/U/P/S
2 1 GE 30 0xF8(0)/N 0 m/m 5/10/70/70/50
70 2 RE 30 0xF8(0)/N 0 m/m 1/1/70/70/50
The following is a sample output from the all option of the show cable load-balance command. The all
option displays information of all options available for this command except the fiber-node-validation
option.
Router# show cable load-balance all
Group Interval Method DCC Init Threshold
Technique Minimum Static Enforce Ugs PCMM
1 10 service-flows 1 1 2% 2% --- ---
2 10 modems 0 5 10% --- --- ---
DOCSIS LB Enabled: No
Current load:
Interface State Group Utilization Reserved Modems Flows Weight
Index
Cable5/0/3 (459 MHz) up 1 0%(0%/0%) 0% 7 7 37
Cable5/0/3/U0 up 1 0% 0% 2 2 1.2
Cable5/0/3/U1 up 1 0% 0% 3 3 1.2
Cable5/0/3/U2 up 1 0% 0% 1 1 1.2
Cable5/0/3/U3 up 1 0% 0% 1 1 1.2
Cable5/0/4 (465 MHz) up 1 0%(0%/0%) 0% 7 7 37
Cable5/0/4/U0 up 1 0% 0% 2 2 1.2
Cable5/0/4/U1 up 1 0% 0% 2 2 1.2
Cable5/0/4/U2 up 1 0% 0% 1 1 1.2
Cable5/0/4/U3 up 1 0% 0% 2 2 1.2
Mo1/0/0:0 (555 MHz) down 1 0%(0%/0%) 0% 0 0 0
Cisco IOS CMTS Cable Command Reference
CBL-1256 OL-15510-15
Cable Commands: show a through show cable l
show cable load-balance
Target assignments:
Interface State Group Target
Index
Cable5/0/3 (459 MHz) up 1 Cable5/0/4 (465 MHz) [enforce]
Cable5/0/3/U0 up 1 Cable5/0/3/U2
Cable5/0/3/U1 up 1 Cable5/0/3/U2 [enforce]
Cable5/0/3/U2 up 1
Cable5/0/3/U3 up 1
Cable5/0/4 (465 MHz) up 1
Cable5/0/4/U0 up 1 Cable5/0/4/U2
Cable5/0/4/U1 up 1 Cable5/0/4/U2 [enforce]
Cable5/0/4/U2 up 1
Cable5/0/4/U3 up 1 Cable5/0/4/U2
Mo1/0/0:0 (555 MHz) down 1
Statistics:
Target interface State Transfers
Complete Pending Retries Failures
Cable5/0/3 (459 MHz) up 3 1 0 0
Cable5/0/3/U0 up 0 0 0 0
Cable5/0/3/U1 up 0 0 0 0
Cable5/0/3/U2 up 0 0 0 0
Cable5/0/3/U3 up 0 0 0 0
Cable5/0/4 (465 MHz) up 0 0 0 0
Cable5/0/4/U0 up 0 0 0 0
Cable5/0/4/U1 up 0 1 0 0
Cable5/0/4/U2 up 0 0 0 0
Cable5/0/4/U3 up 0 0 0 0
Mo1/0/0:0 (555 MHz) down 0 0 0 0
Pending:
Modem Grp Idx Source interface Target interface Retries
001a.c30c.7e74 1 Cable5/0/4 Cable5/0/3 (459 MHz) 0
0000.ca45.9886 1 Cable5/0/4/U2 U1 0
Router#
Starting with Cisco IOS Release 12.2(33)SCG, a new column in the output for the show cable
load-balance all command also displays the group index for the legacy load balance group.
The following is a sample output from the all option of the show cable load-balance command:
Router# show cable load-balance all
Legacy Group Interval Method DCC Init Threshold
Group Index Technique Minimum Static Enforce Ugs PCMM
1 513 30 modems 0 5 10% --- --- ---
2 514 30 modems 0 5 10% --- --- ---
DOCSIS 2.0 LB Enabled: Yes DOCSIS 3.0 LB Enabled: No
DOCSIS Group Status Interval DCC mask Policy Method Threshold
Group Index /UCC DS/US M/E/U/P/S
2 1 GE 30 0xF8(0)/N 0 m/m 5/10/70/70/50
70 2 RE 30 0xF8(0)/N 0 m/m 1/1/70/70/50
Current load:
DOCSIS load-balancing load
Interface State Group Utilization Rsvd NBCM WB/UB Flows Weight
Index Total Total
In7/0/0:0 (573 MHz) up 2 0%(0%/0%) 0% 9 1 41 37
In7/0/0:0/U0 up 2 0% 0% 1 0 1 2.5
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1257
Cable Commands: show a through show cable l
show cable load-balance
In7/0/0:0/U1 up 2 0% 0% 2 0 10 2.5
In7/0/0:0/U2 up 2 0% 0% 2 0 10 2.5
In7/0/0:0/U3 up 2 0% 0% 2 0 10 2.5
In7/0/0:0/U4 up 2 0% 0% 2 0 10 2.5
In7/0/0:0/U5 up 2 0% 0% 2 0 6 2.5
In7/0/0:1 (579 MHz) down 2 0%(0%/0%) 0% 0 0 0
In7/0/0:2 (585 MHz) up 2 0%(0%/0%) 0% 1 0 1 37
In7/0/0:2/U0 up 2 0% 0% 1 0 1 2.5
In7/0/0:2/U1 up 2 0% 0% 2 0 10 2.5
In7/0/0:2/U2 up 2 0% 0% 2 0 10 2.5
In7/0/0:2/U3 up 2 0% 0% 2 0 10 2.5
In7/0/0:2/U4 up 2 0% 0% 2 0 10 2.5
In7/0/0:2/U5 up 2 0% 0% 2 0 6 2.5
In7/0/0:3 (591 MHz) down 2 0%(0%/0%) 0% 0 0 0
LEGACY load-balancing load
Interface State Group Utilization Rsvd Modem Flows Weight
Index Total
Cable7/1/0 (0 MHz) down 513 0%(0%/0%) 0% 0 0 0
Cable7/1/0/U0 down 513 0% 0% 0 0 0.0
Cable7/1/0/U1 down 513 0% 0% 0 0 0.0
Cable7/1/0/U2 down 513 0% 0% 0 0 0.0
Cable7/1/0/U3 down 513 0% 0% 0 0 0.0
Cable7/1/1 (0 MHz) down 514 0%(0%/0%) 0% 0 0 0
Cable7/1/1/U0 down 514 0% 0% 0 0 0.0
Cable7/1/1/U1 down 514 0% 0% 0 0 0.0
Cable7/1/1/U2 down 514 0% 0% 0 0 0.0
Cable7/1/1/U3 down 514 0% 0% 0 0 0.0
Target assignments:
Interface State Group Target
Index
In7/0/0:0 (573 MHz) up 2 In7/0/0:2 (585 MHz) [enforce]
In7/0/0:0/U0 up 2
In7/0/0:0/U1 up 2 In7/0/0:0/U0
In7/0/0:0/U2 up 2 In7/0/0:0/U0
In7/0/0:0/U3 up 2 In7/0/0:0/U0
In7/0/0:0/U4 up 2 In7/0/0:0/U0
In7/0/0:0/U5 up 2 In7/0/0:0/U0
In7/0/0:1 (579 MHz) down 2
In7/0/0:2 (585 MHz) up 2
In7/0/0:2/U0 up 2
In7/0/0:2/U1 up 2 In7/0/0:2/U0
In7/0/0:2/U2 up 2 In7/0/0:2/U0
In7/0/0:2/U3 up 2 In7/0/0:2/U0
In7/0/0:2/U4 up 2 In7/0/0:2/U0
In7/0/0:2/U5 up 2 In7/0/0:2/U0
In7/0/0:3 (591 MHz) down 2
Cable7/1/0 (0 MHz) down 513
Cable7/1/0/U0 down 513
Cable7/1/0/U1 down 513
Cable7/1/0/U2 down 513
Cable7/1/0/U3 down 513
Cable7/1/1 (0 MHz) down 514
Cable7/1/1/U0 down 514
Cable7/1/1/U1 down 514
Cable7/1/1/U2 down 514
Cable7/1/1/U3 down 514
Statistics:
Target interface State Transfers
Complete Pending Retries Failures
In7/0/0:0 (573 MHz) up 1 0 0 0
Cisco IOS CMTS Cable Command Reference
CBL-1258 OL-15510-15
Cable Commands: show a through show cable l
show cable load-balance
In7/0/0:0/U0 up 0 0 0 0
In7/0/0:0/U1 up 0 0 0 0
In7/0/0:0/U2 up 0 0 0 0
In7/0/0:0/U3 up 0 0 0 0
In7/0/0:0/U4 up 0 0 0 0
In7/0/0:0/U5 up 0 0 0 0
In7/0/0:1 (579 MHz) down 0 0 0 0
In7/0/0:2 (585 MHz) up 14 1 0 0
In7/0/0:2/U0 up 0 0 0 0
In7/0/0:2/U1 up 0 0 0 0
In7/0/0:2/U2 up 0 0 0 0
In7/0/0:2/U3 up 0 0 0 0
In7/0/0:2/U4 up 0 0 0 0
In7/0/0:2/U5 up 0 0 0 0
In7/0/0:3 (591 MHz) down 0 0 0 0
Cable7/1/0 (0 MHz) down 0 0 0 0
Cable7/1/0/U0 down 0 0 0 0
Cable7/1/0/U1 down 0 0 0 0
Cable7/1/0/U2 down 0 0 0 0
Cable7/1/0/U3 down 0 0 0 0
Cable7/1/1 (0 MHz) down 0 0 0 0
Cable7/1/1/U0 down 0 0 0 0
Cable7/1/1/U1 down 0 0 0 0
Cable7/1/1/U2 down 0 0 0 0
Cable7/1/1/U3 down 0 0 0 0
Pending:
Modem Grp Idx Primary RF/RCC MD/TCS Action Active Retries
Src Target Src Target Time
54d4.6f88.659c 2 In7/0/0:0 In7/0/0:2 (585 MHz) 0
The following is a sample output from the fiber-node-validation option of the show cable load-balance
command:
Router# show cable load-balance fiber-node-validation
DOCSIS LBG ID Match Channel Fiber-node list
1 match Ca5/0/0/U0 {1}
Ca5/0/0/U1 {1}
Ca5/0/0/U2 {1}
Ca5/0/0/U3 {1}
Mo1/0/0:0 {1}
2 match Ca5/0/0/U0 {1}
Ca5/0/0/U1 {1}
Ca5/0/0/U2 {1}
Mo1/0/0:0 {1}
Table 74 describes the fields shown in the show cable load-balance command displays.
Table 74 show cable load-balance Field Descriptions (default display)
Field Description
Fields for the Default Displays and load Option
Group Index Identifies the mapping between the legacy load balance group ID and the internal group index
of the legacy LBG.
Interface Cable interface (downstream or upstream) that belongs to a load balancing group.
Group Number of the load balancing group to which the cable interface has been assigned.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1259
Cable Commands: show a through show cable l
show cable load-balance
Table 74 show cable load-balance Field Descriptions (default display) (continued)
Field Description
Utilization This field is a long-term average of the upstream utilization and displays current load usage of
the cable interface expressed as a percentage of the total bandwidth. For upstreams, this field
shows a single percentage value, which is the average percentage of bandwidth being used on
the upstream.
For downstreams, this field shows a set of three percentage values:
• The percentage shows the load usage for the entire interface.
• The first percentage, within the parentheses, shows the load for the downstream.
• The second percentage, within the parentheses, shows the average load for all upstreams
on the downstream.
For example, if this field shows 18%(18%/12%), it indicates that downstream and upstream
channels on the interface are running on an average load of 18 percent. The downstream is
running on an average load of 18 percent and all upstreams for this downstream are running on
an average load of 12 percent.
Note To view the short-term average of the utilization, use the show interface cable
mac-scheduler command.
State Current state of the cable interface.
The following states indicate normal operational states, depending on the configuration:
• down—Interface is shut down. The CMTS cannot use the interface for load balancing in
this state.
• initial—Interface is currently in the initialization phase. The CMTS uses the interface for
load balancing after the initialization completes.
• up—Interface is up and passing traffic. The CMTS actively uses the interface for load
balancing.
• testing—Interface is currently under a load balancing test. The CMTS is unable to use the
interface for normal load balancing operations until the test completes.
The following states indicate abnormal states. The CMTS does not use interfaces in these states
for load balancing operations, but continues to monitor and update the status every time the
CMTS polls the interfaces for their current load usage:
• suspicious—Interface is in an unknown state. The interface might be up and passing
traffic, but is not consistent enough to support load balancing operations. The CMTS
attempts to reinitialize the interface after a timeout period. If the interface has failed
initialization more than 10 times, the CMTS moves the interface to the disabled state.
• disabled—Interface has been disabled because a load balancing test is in-progress or
because the interface reinitialization failed after 10 attempts.
• unstable—Interface has failed repeated initialization attempts. The CMTS will attempt to
reinitialize the interface after a timeout period. If a load balance test is not in-progress and
if reinitialization fails, the CMTS moves it to the unstable state.
Reserved Percentage of bandwidth that is currently reserved by unsolicited grant service (UGS) service
flows.
Modems Number of cable modems currently online on this cable interface.
Flows Number of service flows currently active on the cable interface.
Cisco IOS CMTS Cable Command Reference
CBL-1260 OL-15510-15
Cable Commands: show a through show cable l
show cable load-balance
Table 74 show cable load-balance Field Descriptions (default display) (continued)
Field Description
Weight Interface bandwidth, in megabits per second (mbps), for the downstream or upstream. The
system uses this value in calculating whether the loads on the interfaces are balanced.
Changing a channel parameter, such as modulation profile or channel width, affects the
channel bandwidth and weight value.
Additional Fields When Displaying Load Balancing Groups
Interval Indicates in seconds, the current load on each cable interface in the load balancing group as
configured using the cable load-balance group interval command.
Method Load balancing method used for the load balancing group as configured using the cable
load-balance group (global configuration) command.
Threshold Thresholds configured for this load balancing group:
• M = Minimum
Minimum difference in the number of cable modems or service flows that can exist on two
interfaces in the group before cable modems are moved between the interfaces. If the
imbalance between interfaces is below this value, cable modems are not moved. This field
contains a value only when the group is configured for the modems or service flows
method of load balancing. (This value is configured using the load minimum option of the
cable load-balance group threshold command.)
• S = Static
Minimum difference in the percentage of total load that must exist between interfaces in a
load balancing group before the Cisco CMTS performs static load balancing. When the
load between interfaces is greater than this value, cable modems that are in the process of
registering with the CMTS are moved between interfaces until the load difference is again
below this value. (This value is configured using the load option of the cable load-balance
group threshold command.)
• E = Enforce
Minimum difference in the percentage of total load that must exist between interfaces in a
load balancing group before the Cisco CMTS performs dynamic load balancing and begins
moving cable modems that are currently online. When the difference in load between two
interfaces falls below this value, the CMTS stops dynamic load balancing and performs
static load balancing. (This value is configured using the enforce option of the cable
load-balance group threshold command.)
• U = Ugs
Percentage of the bandwidth that is allocated for Unsolicited Grant Services (UGS) traffic,
such as Voice-over-IP (VoIP), that is in use on an interface because the CMTS moves
cable modems that are online with active UGS service flows. (This value is configured
using the ugs option of the cable load-balance group threshold command.)
• P = PacketCable MultiMedia (PCMM)
• Percentage of the reserved bandwidth threshold. Above this level, cable modems with
active PCMM service flows participate in load balancing. The default threshold is 70%.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1261
Cable Commands: show a through show cable l
show cable load-balance
Table 74 show cable load-balance Field Descriptions (default display) (continued)
Field Description
Additional Fields for the target Option
Interface Source downstream or upstream interface that is part of a cable load balancing group. If the
Target field contains a value, it indicates that the source interface is currently oversubscribed.
To reduce the cable load, the CMTS moves cable modems from the source interface to the
target interface.
Target Downstream or upstream interface to which cable modems on the source interface are being
moved as part of load balancing operations. This field indicates the following:
• If it is a downstream interface, the display shows the center frequency of the downstream
within parentheses.
• If only a frequency is shown, it indicates that the CMTS is moving cable modems to a
different center frequency on the same downstream interface.
• When the display includes the words “enforce”, it indicates that the CMTS is performing
dynamic load balancing on the interfaces.
• If this field is blank, it indicates that the source interface is not oversubscribed.
Additional Fields for the statistics Option
Target interface Downstream or upstream interface. If this is a downstream interface, the display shows the
center frequency of the downstream within parentheses.
Transfers The following information is tracked for the indicated target interface:
• complete—Number of cable modems successfully moved to the target interface.
• pending—Number of cable modems in the process of being moved to the target interface.
• retries—Number of times that the CMTS unsuccessfully tried to move the same cable
modem to the target interface. This occurs when one or more MAC layer messages to the
cable modem are dropped due to radio frequency (RF) noise or because the modem is not
DOCSIS-compliant. If the number of retries exceeds five for a particular cable modem, the
CMTS counts this as a failure.
• failures—Number of times that the CMTS exceeded the maximum number of allowable
retries (5) when trying to move a particular cable modem to the target interface. A large
number of failures could indicate one or more possible problems:
– The specific cable modems are not DOCSIS-compliant.
– One or both interfaces are having problems passing traffic.
– One or both interfaces are having persistent RF noise problems.
– The source and target interfaces are not combined in the same node and do not share
the same physical connectivity (which is required when interfaces are part the same
load balancing group).
Additional Fields for the pending Option
Modem Hardware (MAC) address of the cable modem that is moved as part of load balancing
operations.
Source interface Downstream or upstream cable interface on which the cable modem is currently online.
Cisco IOS CMTS Cable Command Reference
CBL-1262 OL-15510-15
Cable Commands: show a through show cable l
show cable load-balance
Table 74 show cable load-balance Field Descriptions (default display) (continued)
Field Description
Target interface Downstream or upstream cable interface to which the CMTS is trying to move the cable
modem to load balance the interfaces in this load balancing group. If the CMTS is moving the
cable modem to a different frequency on the same downstream interface, this field shows only
the new center frequency.
Retries Number of times that the CMTS has attempted to move this cable modem to the target
interface. The CMTS attempts to move the cable modem 5 times before counting this load
balancing move as a failure.
Additional Fields for the fiber-node-validation Option
DOCSIS LBG ID The DOCSIS LBG ID.
Channel The upstream or downstream channel that is associated with the DOCSIS LBG.
Fiber-node list The list of all fiber nodes that include the channel.
The following is a sample output from the vdoc keyword of the show cable load-balance command:
Router# show cable load-balance vdoc
Target interface State Group Util Total IGMP CIR High Low
Index Targeted Rep Init Util CIR
Cable7/0/0 (531 MHz) down 81 0 0(0) 0(0) 0(0) 0 0
Mo3/0/0:0 (453 MHz) up 81 0 9(5) 7(5) 2(0) 0 0
Mo3/0/0:1 (459 MHz) initi 81 0 0(0) 0(0) 0(0) 0 0
Mo3/0/0:10 (513 MHz) initi 81 0 0(0) 0(0) 0(0) 0 0
Mo3/0/0:11 (519 MHz) initi 81 0 0(0) 0(0) 0(0) 0 0
Mo3/0/0:2 (465 MHz) initi 81 0 0(0) 0(0) 0(0) 0 0
Mo3/0/0:3 (471 MHz) initi 81 0 0(0) 0(0) 0(0) 0 0
Mo3/0/0:4 (477 MHz) initi 81 0 5(0) 0(0) 5(0) 0 0
Mo3/0/0:5 (483 MHz) up 81 0 7(7) 7(7) 0(0) 0 0
Mo3/0/0:6 (489 MHz) initi 81 0 0(0) 0(0) 0(0) 0 0
Mo3/0/0:7 (495 MHz) initi 81 0 0(0) 0(0) 0(0) 0 0
Mo3/0/0:8 (501 MHz) initi 81 0 0(0) 0(0) 0(0) 0 0
Mo3/0/0:9 (507 MHz) initi 81 0 0(0) 0(0) 0(0) 0 0
Related Commands Command Description
cable load-balance Configures how the Cisco CMTS should load balance cable modems with
group policy ugs active unsolicited grant service (UGS) service flows.
cable load-balance Configures the threshold values that a load balancing group should use for
group threshold load balancing operations.
show cable Displays real time configurational, statistical, and operational information
load-balance of the load balancing operations on the router.
docsis-group
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1263
Cable Commands: show a through show cable l
show cable load-balance docsis-group
show cable load-balance docsis-group
To display real-time configurational, statistical, and operational information of the load balancing (LB)
operations on the router, use the show cable load-balance docsis-group command in privileged EXEC
mode.
Cisco uBR10012 Router
show cable load-balance docsis-group {docsis-group-id | FN fn-id MD cable
slot/subslot/{controller-interface-index}} [all | load | pending | restrict | statistics | target |
modem-list]
Cisco uBR7225VXR and Cisco uBR7246VXR Routers
show cable load-balance docsis-group {docsis-group-id | {FN fn-id MD cable slot/port}} [all |
init-tech-ovr | load | modem-list | pending | service-type-id | statistics | tag | target | vdoc]
Syntax Description docsis-group-id DOCSIS load balancing group ID. The group ID is in the range of
1 to 2147483647.
FN fn-id Specifies the fiber node (FN) where certain DOCSIS 3.0 GLBG
parameters, such as disable, docsis-policy, init-tech-list, interval,
method, policy, and threshold, can be configured.
MD cable Specifies the MAC domain interface of the fiber node.
slot/subslot/cable-interface
• slot—Slot where the line card resides. The permitted range is from
-index
5 to 8.
• subslot—Subslot where the line card resides. The available slots are
0 or 1.
• cable-interface-index—Downstream controller number on the line
card. The permitted range is from 0 to 4.
MD cable slot/port Specifies the MAC domain interface of the fiber node on the
Cisco uBR7246VXR or Cisco uBR7225VXR routers.
• 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—The downstream controller port on the line card. The
permitted values are 0 or 1.
all (Optional) Displays all load balancing group information.
init-tech-ovr (Optional) Displays the initialization technique override rules
associated with this DOCSIS load balancing group (LBG).
load (Optional) Displays current interface load and LBG assignments.
modem-list (Optional) Displays cable modems assigned to the specified DOCSIS
LBG.
pending (Optional) Displays a list of cable modems that are pending movement
from one downstream or upstream to another.
restrict (Optional) Displays the restricted cable modem list associated with this
DOCSIS LBG.
Cisco IOS CMTS Cable Command Reference
CBL-1264 OL-15510-15
Cable Commands: show a through show cable l
show cable load-balance docsis-group
service-type-id (Optional) Displays information about the service type ID list associated
with this DOCSIS LBG.
statistics (Optional) Displays cumulative statistics of load balancing operations
for one group.
tag (Optional) Displays the tag list associated with this DOCSIS LBG.
target (Optional) Displays current and target interfaces (upstream and
downstream) used for load balancing.
vdoc (Optional) Displays information about the state of the
video-over-DOCSIS (vdoc) LB for the particular LBG.
Command Default Displays information of all load balancing groups for each cable interface with its current load and load
balancing status.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCC This command was introduced.
12.2(33)SCF The output for this command is enhanced to include more load balancing
statistics for cable modems (CMs) provisioned in the multiple receive
channel (MRC) and multiple transmit channel (MTC) mode.
The output for the load keyword includes information about narrowband and
wideband CMs.
Usage Guidelines Use the show cable load-balance docsis-group command to display the current, real-time statistics for
load balancing operations.
Examples The following is a sample output of the show cable load-balance docsis-group command:
Router# show cable load-balance docsis-group 1
DOCSIS 2.0 LB Enabled: Yes DOCSIS 3.0 LB Enabled: No
DOCSIS Group Status Interval DCC mask Policy Method Threshold
Group Index /UCC DS/US M/E/U/P/S
1 82 RE 10 0x40(1)/Y 0 m/m 5/10/70/70/50
The following is a sample output of the show cable load-balance docsis-group load command:
Router# show cable load-balance docsis-group 1 load
DOCSIS load-balancing load
Interface State Group Utilization Rsvd NBCM WB/UB Flows Weight
Index Total Total
Cable7/0/0 (333 MHz) up 81 1%(0%/1%) 0% 3 8 7 37
Cable7/0/0/U0 up 81 1% 0% 21 2 23 7.6
Cable7/0/0/U1 up 81 1% 0% 19 3 22 7.6
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1265
Cable Commands: show a through show cable l
show cable load-balance docsis-group
Cable7/0/0/U2 up 81 1% 0% 20 1 23 7.6
Cable7/0/0/U3 up 81 1% 0% 21 1 24 7.6
Mo1/0/0:0 (501 MHz) up 81 1%(0%/1%) 0% 2 48 2 36
Mo1/0/0:0/U0 up 81 1% 0% 21 2 23 7.6
Mo1/0/0:0/U1 up 81 1% 0% 19 3 22 7.6
Mo1/0/0:0/U2 up 81 1% 0% 20 1 23 7.6
Mo1/0/0:0/U3 up 81 1% 0% 21 1 24 7.6
Mo1/0/0:1 (507 MHz) up 81 1%(0%/1%) 0% 2 47 2 36
Mo1/0/0:1/U0 up 81 1% 0% 21 2 23 7.6
Mo1/0/0:1/U1 up 81 1% 0% 19 3 22 7.6
Mo1/0/0:1/U2 up 81 1% 0% 20 1 23 7.6
Mo1/0/0:1/U3 up 81 1% 0% 21 1 24 7.6
Mo1/0/0:2 (513 MHz) up 81 1%(0%/1%) 0% 3 40 3 36
Mo1/0/0:2/U0 up 81 1% 0% 21 2 23 7.6
Mo1/0/0:2/U1 up 81 1% 0% 19 3 22 7.6
Mo1/0/0:2/U2 up 81 1% 0% 20 1 23 7.6
Mo1/0/0:2/U3 up 81 1% 0% 21 1 24 7.6
Mo1/0/0:3 (519 MHz) up 81 1%(0%/1%) 0% 2 47 2 36
Mo1/0/0:3/U0 up 81 1% 0% 21 2 23 7.6
Mo1/0/0:3/U1 up 81 1% 0% 19 3 22 7.6
Mo1/0/0:3/U2 up 81 1% 0% 20 1 23 7.6
Mo1/0/0:3/U3 up 81 1% 0% 21 1 24 7.6
The following is a sample output of the show cable load-balance docsis-group load command in
Cisco IOS Release 12.2(33)SCF and later releases displaying sample wideband (WB), narrowband
(NB), or mixed cable modem details. The NBCM and WB/upstream bonding (UB) columns display
information about DOCSIS 3.0 MRC-only and MTC CMs for DOCSIS static modem-count based load
balancing:
Router# show cable load-balance docsis-group 60 load
DOCSIS load-balancing load
Interface State Group Utilization Rsvd NBCM WB/UB Flows Weight
Index Total Total
Mo1/0/0:0 (423 MHz) initial 81 0%(0%/0%) 0% 0 7 0 36
Mo1/0/0:0/U0 up 81 0% 0% 2 0 10 5.1
Mo1/0/0:0/U1 up 81 0% 0% 3 0 15 5.1
Mo1/0/0:0/U2 up 81 0% 0% 2 0 10 5.1
Mo1/0/0:0/U3 up 81 0% 0% 3 0 15 5.1
Mo1/0/0:4 (447 MHz) initial 81 0%(0%/0%) 0% 0 3 0 36
Mo1/0/0:4/U0 up 81 0% 0% 2 0 10 5.1
Mo1/0/0:4/U1 up 81 0% 0% 3 0 15 5.1
Mo1/0/0:4/U2 up 81 0% 0% 2 0 10 5.1
Mo1/0/0:4/U3 up 81 0% 0% 3 0 15 5.1
Cisco IOS CMTS Cable Command Reference
CBL-1266 OL-15510-15
Cable Commands: show a through show cable l
show cable load-balance docsis-group
Table 75 describes the DOCSIS 3.0 load balancing counter definition in Cisco IOS Release 12.2
(33)SCF:
Table 75 DOCSIS 3.0 Load Balancing Counter Definition
Modem NBCM Total WB/UB Total Flows
Operating Downstream Upstream
Mode (DS) (US) DS US DS US
Non-MRC Count Count Not counted Not counted Count service Count SF of
mode primary single US flow (SF) of single US
(online, NB primary
CM)
MRC mode Not counted Count Count Count Not counted Count SF of
only single US primary and single US single US
(w-online, secondary
WB CM)
MTC mode Not counted Not counted Count Count all Not counted Not counted
(UB online, primary and TCS on upstream
UB CM) secondary channels TCS
channels
The following is a sample output of the show cable load-balance docsis-group pending command in
Cisco IOS Release 12.2(33)SCE and earlier releases.
Router# show cable load-balance docsis-group 70 pending
Modem Grp Idx Primary RF/RCC MD/TCS Action Active Retries
Src Target Src Target Time
001c.ea37.9bda 81 Mo1/0/0:2/1 Mo1/0/0:3/0 60/4 60/4 REINIT 00:44 0 DOCSIS
3.0 LB
001c.ea37.9ab0 81 Mo1/0/0:1/2 Mo1/0/0:2/0 60/4 60/2 REINIT 00:41 0 DOCSIS
3.0 LB
001c.ea37.9aa6 81 Mo1/0/0:0/1 Mo1/0/0:1/0 60/1 60/4 REINIT 00:50 0 DOCSIS
3.0 LB
001c.ea37.9b1e 81 Mo1/0/0:1/1 Mo1/0/0:0/0 60/2 60/2 REINIT 00:44 0 DOCSIS
3.0 LB
001c.ea37.9a8c 81 Mo1/0/0:3/2 Mo1/0/0:2/0 60/4 60/2 REINIT 00:41 0 DOCSIS
3.0 LB
001c.ea37.9aee 81 Mo1/0/0:3/2 Mo1/0/0:2/0 60/8 60/4 REINIT 00:52 0 DOCSIS
3.0 LB
001c.ea37.9a8a 81 Mo1/0/0:0/1 Mo1/0/0:3/0 60/8 60/1 REINIT 00:55 0 DOCSIS
3.0 LB
The following is a sample output of the show cable load-balance docsis-group pending command
for DOCSIS 3.0 cable modems with MTC mode in Cisco IOS Release 12.2(33)SCF and later releases:
Router# show cable load-balance docsis-group 81 pending
Modem GrpIdx Primary RF/RCC MD/TCS Action Active Retries
Src Target Src Target Time
0000.cad6.eece 81 In6/0/2:3/0 In6/0/0:0/0 DCC 00:01 0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1267
Cable Commands: show a through show cable l
show cable load-balance docsis-group
The following is a sample output of the show cable load-balance docsis-group statistics command.
Router# show cable load-balance docsis-group 1 statistics
Target interface State Transfers
Complete Pending Retries Failures
Cable1/0 (453 MHz) up 0 0 0 0
Cable1/0/U2 down 0 0 0 0
Cable1/1 (459 MHz) initial 0 0 0 0
Cable1/1/U0 initial 0 0 0 0
Cable1/1/U1 initial 0 0 0 0
Cable1/1/U2 initial 0 0 0 0
Cable1/1/U3 initial 0 0 0 0
The following is a sample output of the show cable load-balance docsis-group target command.
Router# show cable load-balance docsis-group 1 target
Interface State Group Target
Index
Cable1/0 (453 MHz) up 82 Cable1/1 (459 MHz) [enforce]
Cable1/0/U2 down 82
Cable1/1 (459 MHz) initial 82
Cable1/1/U0 initial 82
Cable1/1/U1 initial 82
Cable1/1/U2 initial 82
Cable1/1/U3 initial 82
The following is a sample output of the show cable load-balance docsis-group modem-list command
on the integrated cable configuration:
Router# show cable load-balance docsis-group 1 modem-list
Primary DS Grp Idx MAC Address RCC-ID Bad RfId Priority
Cable7/0/0/U0 81 (1)
001c.ea37.9b3e 2 0
Cable7/0/0/U1 81 (1)
001c.ea37.9b28 2 0
Cable7/0/0/U2 81 (1)
001c.ea37.9bf4 2 0
Cable7/0/0/U3 81 (1)
001c.ea37.9b5e 2 0
In8/1/0:0/U0 81 (2)
0014.f82f.74f6 !
Note The priority for an excluded modem is displayed as "!".
Cisco IOS CMTS Cable Command Reference
CBL-1268 OL-15510-15
Cable Commands: show a through show cable l
show cable load-balance docsis-group
The following is a sample output of the show cable load-balance docsis-group modem-list command
on the modular cable configuration:
Router# show cable load-balance docsis-group 23 modem-list
Primary DS Grp Idx MAC Address RCC-ID Bad RfId Priority
Mo6/1/0:0/U0 81 (0)
Mo6/1/0:0/U8 81 (0)
Mo6/1/0:0/U1 81 (0)
Mo6/1/0:0/U2 81 (0)
Mo6/1/0:0/U3 81 (0)
Mo6/1/0:0/U4 81 (0)
Mo6/1/0:0/U5 81 (0)
Mo6/1/0:0/U6 81 (0)
Mo6/1/0:0/U7 81 (0)
Mo6/1/0:1/U0 81 (0)
Mo6/1/0:1/U8 81 (0)
Mo6/1/0:1/U1 81 (0)
Mo6/1/0:1/U2 81 (1)
001a.c30c.7e9a 5 0
Mo6/1/0:1/U3 81 (0)
Mo6/1/0:1/U4 81 (0)
Mo6/1/0:1/U5 81 (0)
Mo6/1/0:1/U6 81 (0)
Mo6/1/0:1/U7 81 (0)
The following is a sample output of the show cable load-balance docsis-group modem-list command
on a fiber node topology configuration:
Router# show cable load-balance docsis-group fn 2 md cable 6/0/0 modem-list
CM List - LBG : 40449
Primary DS MAC Address RCC-ID
In6/0/0:2/UB (0)
In6/0/0:3/UB (1)
0025.2e2d.7322 2
In6/0/1:0/UB (2)
0025.2e2d.7326 1
0025.2e2d.7338 1
The following is a sample output for the show cable load-balance docsis-group modem-list command
for the DOCSIS 3.0 GLBG:
Router# show cable load-balance docsis-group fn 2 md cable 7/0/0 modem-list
Primary DS Grp Idx MAC Address RCC-ID Bad RfId Priority
Cable7/0/0/U0 48129 (0)
Cable7/0/0/U1 48129 (0)
Cable7/0/0/U2 48129 (0)
Cable7/0/0/U3 48129 (0)
Mo1/0/0:0/UB 48129 (6)
0025.2eaf.6bbc 1 0
001e.6bfb.000c 1 0
001a.c3ff.d354 1 0
0023.be50.e5aa 1 0
001e.6bfb.1a3a 1 0
Mo1/0/0:0/U0 48129 (0)
Mo1/0/0:0/U1 48129 (0)
Mo1/0/0:0/U2 48129 (0)
Mo1/0/0:0/U3 48129 (0)
Mo1/0/0:1/U0 48129 (0)
Mo1/0/0:1/U1 48129 (0)
Mo1/0/0:1/U2 48129 (0)
Mo1/0/0:1/U3 48129 (0)
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1269
Cable Commands: show a through show cable l
show cable load-balance docsis-group
Mo1/0/0:2/UB 48129 (2)
001a.c3ff.d87a 1 0
001e.6bfb.71b0 2 0
Mo1/0/0:2/U0 48129 (0)
Mo1/0/0:2/U1 48129 (0)
Mo1/0/0:2/U2 48129 (0)
Mo1/0/0:2/U3 48129 (0)
Mo1/0/0:3/UB 48129 (1)
001e.6bff.8af2 1 0
Mo1/0/0:3/U0 48129 (0)
Mo1/0/0:3/U1 48129 (0)
Mo1/0/0:3/U2 48129 (0)
Mo1/0/0:3/U3 48129 (0)
The following is a sample output for the show cable load-balance docsis-group pending command:
Router# show cable load-balance docsis-group fn 2 md cable 7/0/0 pending
Modem Grp Idx Primary RF/RCC MD/TCS Action Active Retries
Src Target Src Target Time
001e.6bfb.000c 48129 Mo1/0/0:0/1 Mo1/0/0:3/2 60/12 60/12 REINIT 00:20 0
DOCSIS 3.0 LB
001e.6bfb.71b0 48129 Mo1/0/0:2/2 Mo1/0/0:2/1 60/12 60/5 REINIT 00:22 0
DOCSIS 3.0 LB
001e.6bfc.d030 48129 Mo1/0/0:0/1 Mo1/0/0:3/2 60/3 60/3 REINIT 00:03 0
DOCSIS 3.0 LB
The following is a sample output of the show cable load-balance docsis-group all command. This
command displays information of all options in this command.
Router# show cable load-balance docsis-group 1 all
DOCSIS LB Enabled: Yes
DOCSIS Group Status Interval DCC mask Policy Method Threshold
Group Index /UCC DS/US M/E/U/P/S
1 82 RE 10 0x40(1)/Y 0 m/m 5/10/70/70/50
Current load:
Interface State Group Utilization Reserved Modems Flows Weight
Index
Cable1/0 (453 MHz) up 82 0%(0%/0%) 0% 13 26 26
Cable1/0/U2 down 82 0% 0% 0 0 0.0
Cable1/1 (459 MHz) initial 82 0%(0%/0%) 0% 0 0 26
Cable1/1/U0 initial 82 0% 0% 0 0 2.5
Cable1/1/U1 initial 82 0% 0% 0 0 2.5
Cable1/1/U2 initial 82 0% 0% 0 0 2.5
Cable1/1/U3 initial 82 0% 0% 0 0 2.5
Target assignments:
Interface State Group Target
Index
Cable1/0 (453 MHz) up 82 Cable1/1 (459 MHz) [enforce]
Cable1/0/U2 down 82
Cable1/1 (459 MHz) initial 82
Cable1/1/U0 initial 82
Cable1/1/U1 initial 82
Cable1/1/U2 initial 82
Cable1/1/U3 initial 82
Statistics:
Target interface State Transfers
Cisco IOS CMTS Cable Command Reference
CBL-1270 OL-15510-15
Cable Commands: show a through show cable l
show cable load-balance docsis-group
Complete Pending Retries Failures
Cable1/0 (453 MHz) up 0 0 0 0
Cable1/0/U2 down 0 0 0 0
Cable1/1 (459 MHz) initial 0 0 0 0
Cable1/1/U0 initial 0 0 0 0
Cable1/1/U1 initial 0 0 0 0
Cable1/1/U2 initial 0 0 0 0
Cable1/1/U3 initial 0 0 0 0
Pending:
Modem Grp Idx Source interface Target interface Retries
The following is a sample output of the show cable load-balance docsis-group all command in Cisco
IOS Release 12.2(33)SCF and later releases:
Router# show cable load balance docsis-group 70 all
DOCSIS LB Enabled: Yes
DOCSIS Group Status Interval DCC mask Policy Method Threshold
Group Index /UCC DS/US M/E/U/P/S
1 81 RE 30 0x78(1)/N 0 m/m 1/1/70/70/50
Current load:
DOCSIS load-balancing load
Interface State Group Utilization Rsvd NBCM WB/UB Flows Weight
Index Total Total
Cable7/0/0 (333 MHz) up 81 0%(0%/0%) 0% 3 8 7 37
Cable7/0/0/U0 up 81 0% 0% 22 10 32 7.6
Cable7/0/0/U1 up 81 0% 0% 19 13 32 7.6
Cable7/0/0/U2 up 81 0% 0% 22 8 31 7.6
Cable7/0/0/U3 up 81 0% 0% 22 7 30 7.6
Mo1/0/0:0 (501 MHz) up 81 0%(0%/0%) 0% 3 61 3 36
Mo1/0/0:0/U0 up 81 0% 0% 22 10 32 7.6
Mo1/0/0:0/U1 up 81 0% 0% 19 13 32 7.6
Mo1/0/0:0/U2 up 81 0% 0% 22 8 31 7.6
Mo1/0/0:0/U3 up 81 0% 0% 22 7 30 7.6
Mo1/0/0:1 (507 MHz) up 81 0%(0%/0%) 0% 1 59 1 36
Mo1/0/0:1/U0 up 81 0% 0% 22 10 32 7.6
Mo1/0/0:1/U1 up 81 0% 0% 19 13 32 7.6
Mo1/0/0:1/U2 up 81 0% 0% 22 8 31 7.6
Mo1/0/0:1/U3 up 81 0% 0% 22 7 30 7.6
Mo1/0/0:2 (513 MHz) up 81 0%(0%/0%) 0% 2 57 2 36
Mo1/0/0:2/U0 up 81 0% 0% 22 10 32 7.6
Mo1/0/0:2/U1 up 81 0% 0% 19 13 32 7.6
Mo1/0/0:2/U2 up 81 0% 0% 22 8 31 7.6
Mo1/0/0:2/U3 up 81 0% 0% 22 7 30 7.6
Mo1/0/0:3 (519 MHz) up 81 0%(0%/0%) 0% 1 60 1 36
Mo1/0/0:3/U0 up 81 0% 0% 22 10 32 7.6
Mo1/0/0:3/U1 up 81 0% 0% 19 13 32 7.6
Mo1/0/0:3/U2 up 81 0% 0% 22 8 31 7.6
Mo1/0/0:3/U3 up 81 0% 0% 22 7 30 7.6
Target assignments:
Interface State Group Target
Index
Cable7/0/0 (333 MHz) up 81 Mo1/0/0:1 (507 MHz) [enforce]
Cable7/0/0/U0 up 81 Cable7/0/0/U1 [enforce]
Cable7/0/0/U1 up 81
Cable7/0/0/U2 up 81 Cable7/0/0/U1 [enforce]
Cable7/0/0/U3 up 81 Cable7/0/0/U1 [enforce]
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1271
Cable Commands: show a through show cable l
show cable load-balance docsis-group
Mo1/0/0:0 (501 MHz) up 81 Mo1/0/0:1 (507 MHz) [enforce]
Mo1/0/0:0/U0 up 81 Mo1/0/0:0/U1 [enforce]
Mo1/0/0:0/U1 up 81
Mo1/0/0:0/U2 up 81 Mo1/0/0:0/U1 [enforce]
Mo1/0/0:0/U3 up 81 Mo1/0/0:0/U1 [enforce]
Mo1/0/0:1 (507 MHz) up 81
Mo1/0/0:1/U0 up 81 Mo1/0/0:1/U1 [enforce]
Mo1/0/0:1/U1 up 81
Mo1/0/0:1/U2 up 81 Mo1/0/0:1/U1 [enforce]
Mo1/0/0:1/U3 up 81 Mo1/0/0:1/U1 [enforce]
Mo1/0/0:2 (513 MHz) up 81
Mo1/0/0:2/U0 up 81 Mo1/0/0:2/U1 [enforce]
Mo1/0/0:2/U1 up 81
Mo1/0/0:2/U2 up 81 Mo1/0/0:2/U1 [enforce]
Mo1/0/0:2/U3 up 81 Mo1/0/0:2/U1 [enforce]
Mo1/0/0:3 (519 MHz) up 81
Mo1/0/0:3/U0 up 81 Mo1/0/0:3/U1 [enforce]
Mo1/0/0:3/U1 up 81
Mo1/0/0:3/U2 up 81 Mo1/0/0:3/U1 [enforce]
Mo1/0/0:3/U3 up 81 Mo1/0/0:3/U1 [enforce]
Statistics:
Target interface State Transfers
Complete Pending Retries Failures
Cable7/0/0 (333 MHz) up 6 0 0 0
Cable7/0/0/U0 up 29 0 0 0
Cable7/0/0/U1 up 76 0 0 0
Cable7/0/0/U2 up 43 0 0 0
Cable7/0/0/U3 up 31 0 0 0
Mo1/0/0:0 (501 MHz) up 18 0 0 0
Mo1/0/0:0/U0 up 30 0 0 0
Mo1/0/0:0/U1 up 42 0 0 0
Mo1/0/0:0/U2 up 21 0 0 0
Mo1/0/0:0/U3 up 21 0 0 0
Mo1/0/0:1 (507 MHz) up 17 0 0 0
Mo1/0/0:1/U0 up 9 0 0 0
Mo1/0/0:1/U1 up 18 0 0 0
Mo1/0/0:1/U2 up 15 0 0 0
Mo1/0/0:1/U3 up 20 0 0 0
Mo1/0/0:2 (513 MHz) up 19 0 0 0
Mo1/0/0:2/U0 up 4 0 0 0
Mo1/0/0:2/U1 up 3 0 0 0
Mo1/0/0:2/U2 up 6 0 0 0
Mo1/0/0:2/U3 up 6 0 0 0
Mo1/0/0:3 (519 MHz) up 9 0 0 0
Mo1/0/0:3/U0 up 1 0 0 0
Mo1/0/0:3/U1 up 2 0 0 0
Mo1/0/0:3/U2 up 4 0 0 0
Mo1/0/0:3/U3 up 4 0 0 0
Pending:
Modem Grp Idx Primary RF/RCC MD/TCS Action Active Retries
Src Target Src Target Time
The following is a sample output of the show cable load-balance all command for load balancing
groups that belong to different cable line cards:
Router# show cable load-balance all
Group Interval Method DCC Init Threshold
Cisco IOS CMTS Cable Command Reference
CBL-1272 OL-15510-15
Cable Commands: show a through show cable l
show cable load-balance docsis-group
Technique Minimum Static Enforce Ugs PCMM
1 30 modems 0 5 10% --- --- ---
41 30 utilization 4 --- 10% 20% --- ---
DOCSIS 2.0 LB Enabled: Yes DOCSIS 3.0 LB Enabled: No
DOCSIS Group Status Interval DCC mask Policy Method Threshold
Group Index /UCC DS/US M/E/U/P/S
1 81 RE 30 0x78(1)/N 0 m/m 1/1/70/70/50
3 82 RE 30 0x78(1)/N 0 m/m 1/1/70/70/50
5 83 RE 30 0x78(1)/N 0 m/m 1/1/70/70/50
23 84 GE 30 0xF8(0)/N 0 m/m 5/10/70/70/50
DOCSIS 2.0 LB Enabled: Yes DOCSIS 3.0 LB Enabled: No
MD FN Group S Intv DCC mask Policy Mtd MD-CM-SG Threshold
Index /UCC D/U M/E/U/P/S
Ca6/1/0 3 44290 E 30 0xF8(0)/N 0 m/m 0x2D0101 5/10/70/70/50
Ca7/0/0 2 48129 E 20 0xF8(0)/N 0 m/m 0x3C0101 5/10/70/70/50
Ca8/0/0 1 55808 E 30 0xF8(0)/N 0 m/m 0x5A0101 5/10/70/70/50
Current load:
DOCSIS load-balancing load
Interface State Group Utilization Rsvd NBCM WB/UB Flows Weight
Index Total Total
Mo6/1/0:0 (405 MHz) initial 82 0%(0%/0%) 0% 0 0 0 36
Mo6/1/0:0 (405 MHz) initial 44290 0%(0%/0%) 0% 0 0 0 36
Mo6/1/0:0/U0 initial 82 0% 0% 0 0 0 7.6
Mo6/1/0:0/U0 initial 44290 0% 0% 0 0 0 7.6
Mo6/1/0:0/U1 initial 82 0% 0% 0 0 0 7.6
Mo6/1/0:0/U1 initial 44290 0% 0% 0 0 0 7.6
Mo6/1/0:0/U2 initial 82 0% 0% 0 0 0 7.6
Mo6/1/0:0/U2 initial 44290 0% 0% 0 0 0 7.6
Mo6/1/0:0/U3 initial 82 0% 0% 0 0 0 7.6
Mo6/1/0:0/U3 initial 44290 0% 0% 0 0 0 7.6
Mo6/1/0:1 (411 MHz) down 82 0%(0%/0%) 0% 0 0 0
Mo6/1/0:1 (411 MHz) down 44290 0%(0%/0%) 0% 0 0 0
Mo6/1/0:2 (417 MHz) down 82 0%(0%/0%) 0% 0 0 0
Mo6/1/0:2 (417 MHz) down 44290 0%(0%/0%) 0% 0 0 0
Mo6/1/0:3 (423 MHz) down 82 0%(0%/0%) 0% 0 0 0
Mo6/1/0:3 (423 MHz) down 44290 0%(0%/0%) 0% 0 0 0
Mo6/1/0:4 (429 MHz) down 82 0%(0%/0%) 0% 0 0 0
Mo6/1/0:4 (429 MHz) down 44290 0%(0%/0%) 0% 0 0 0
Mo6/1/0:5 (435 MHz) down 82 0%(0%/0%) 0% 0 0 0
Mo6/1/0:5 (435 MHz) down 44290 0%(0%/0%) 0% 0 0 0
Mo6/1/0:6 (441 MHz) down 82 0%(0%/0%) 0% 0 0 0
Mo6/1/0:6 (441 MHz) down 44290 0%(0%/0%) 0% 0 0 0
Mo6/1/0:7 (447 MHz) down 82 0%(0%/0%) 0% 0 0 0
Mo6/1/0:7 (447 MHz) down 44290 0%(0%/0%) 0% 0 0 0
Mo6/1/1:0 (453 MHz) down 82 0%(0%/0%) 0% 0 0 0
Mo6/1/1:0 (453 MHz) down 83 0%(0%/0%) 0% 0 0 0
Mo6/1/1:1 (459 MHz) down 82 0%(0%/0%) 0% 0 0 0
Mo6/1/1:1 (459 MHz) down 83 0%(0%/0%) 0% 0 0 0
Mo6/1/1:2 (465 MHz) down 82 0%(0%/0%) 0% 0 0 0
Mo6/1/1:2 (465 MHz) down 83 0%(0%/0%) 0% 0 0 0
Mo6/1/1:3 (471 MHz) down 82 0%(0%/0%) 0% 0 0 0
Mo6/1/1:3 (471 MHz) down 83 0%(0%/0%) 0% 0 0 0
Mo6/1/1:4 (477 MHz) down 82 0%(0%/0%) 0% 0 0 0
Mo6/1/1:4 (477 MHz) down 83 0%(0%/0%) 0% 0 0 0
Mo6/1/1:5 (483 MHz) down 82 0%(0%/0%) 0% 0 0 0
Mo6/1/1:5 (483 MHz) down 83 0%(0%/0%) 0% 0 0 0
Mo6/1/1:6 (489 MHz) down 82 0%(0%/0%) 0% 0 0 0
Mo6/1/1:6 (489 MHz) down 83 0%(0%/0%) 0% 0 0 0
Mo6/1/1:7 (495 MHz) down 82 0%(0%/0%) 0% 0 0 0
Mo6/1/1:7 (495 MHz) down 83 0%(0%/0%) 0% 0 0 0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1273
Cable Commands: show a through show cable l
show cable load-balance docsis-group
DOCSIS load-balancing load
Interface State Group Utilization Rsvd NBCM WB/UB Flows Weight
Index Total Total
Cable7/0/0 (333 MHz) up 81 0%(0%/0%) 0% 2 6 7 37
Cable7/0/0 (333 MHz) up 48129 0%(0%/0%) 0% 2 6 7 37
Cable7/0/0/U0 up 81 0% 0% 21 12 33 7.6
Cable7/0/0/U0 up 48129 0% 0% 21 12 33 7.6
Cable7/0/0/U1 up 81 0% 0% 21 11 32 7.6
Cable7/0/0/U1 up 48129 0% 0% 21 11 32 7.6
Cable7/0/0/U2 up 81 0% 0% 21 10 30 7.6
Cable7/0/0/U2 up 48129 0% 0% 21 10 30 7.6
Cable7/0/0/U3 up 81 0% 0% 21 9 30 7.6
Cable7/0/0/U3 up 48129 0% 0% 21 9 30 7.6
Mo1/0/0:0 (501 MHz) up 81 0%(0%/0%) 0% 2 62 2 36
Mo1/0/0:0 (501 MHz) up 48129 0%(0%/0%) 0% 2 62 2 36
Mo1/0/0:0/U0 up 81 0% 0% 21 12 33 7.6
Mo1/0/0:0/U0 up 48129 0% 0% 21 12 33 7.6
Mo1/0/0:0/U1 up 81 0% 0% 21 11 32 7.6
Mo1/0/0:0/U1 up 48129 0% 0% 21 11 32 7.6
Mo1/0/0:0/U2 up 81 0% 0% 21 10 30 7.6
Mo1/0/0:0/U2 up 48129 0% 0% 21 10 30 7.6
Mo1/0/0:0/U3 up 81 0% 0% 21 9 30 7.6
Mo1/0/0:0/U3 up 48129 0% 0% 21 9 30 7.6
Mo1/0/0:1 (507 MHz) up 81 0%(0%/0%) 0% 1 57 1 36
Mo1/0/0:1 (507 MHz) up 48129 0%(0%/0%) 0% 1 57 1 36
Mo1/0/0:1/U0 up 81 0% 0% 21 12 33 7.6
Mo1/0/0:1/U0 up 48129 0% 0% 21 12 33 7.6
Mo1/0/0:1/U1 up 81 0% 0% 21 11 32 7.6
Mo1/0/0:1/U1 up 48129 0% 0% 21 11 32 7.6
Mo1/0/0:1/U2 up 81 0% 0% 21 10 30 7.6
Mo1/0/0:1/U2 up 48129 0% 0% 21 10 30 7.6
Mo1/0/0:1/U3 up 81 0% 0% 21 9 30 7.6
Mo1/0/0:1/U3 up 48129 0% 0% 21 9 30 7.6
Mo1/0/0:2 (513 MHz) up 81 0%(0%/0%) 0% 1 56 1 36
Mo1/0/0:2 (513 MHz) up 48129 0%(0%/0%) 0% 1 56 1 36
Mo1/0/0:2/U0 up 81 0% 0% 21 12 33 7.6
Mo1/0/0:2/U0 up 48129 0% 0% 21 12 33 7.6
Mo1/0/0:2/U1 up 81 0% 0% 21 11 32 7.6
Mo1/0/0:2/U1 up 48129 0% 0% 21 11 32 7.6
Mo1/0/0:2/U2 up 81 0% 0% 21 10 30 7.6
Mo1/0/0:2/U2 up 48129 0% 0% 21 10 30 7.6
Mo1/0/0:2/U3 up 81 0% 0% 21 9 30 7.6
Mo1/0/0:2/U3 up 48129 0% 0% 21 9 30 7.6
Mo1/0/0:3 (519 MHz) up 81 0%(0%/0%) 0% 2 62 2 36
Mo1/0/0:3 (519 MHz) up 48129 0%(0%/0%) 0% 2 62 2 36
Mo1/0/0:3/U0 up 81 0% 0% 21 12 33 7.6
Mo1/0/0:3/U0 up 48129 0% 0% 21 12 33 7.6
Mo1/0/0:3/U1 up 81 0% 0% 21 11 32 7.6
Mo1/0/0:3/U1 up 48129 0% 0% 21 11 32 7.6
Mo1/0/0:3/U2 up 81 0% 0% 21 10 30 7.6
Mo1/0/0:3/U2 up 48129 0% 0% 21 10 30 7.6
Mo1/0/0:3/U3 up 81 0% 0% 21 9 30 7.6
Mo1/0/0:3/U3 up 48129 0% 0% 21 9 30 7.6
DOCSIS load-balancing load
Interface State Group Utilization Rsvd NBCM WB/UB Flows Weight
Index Total Total
In8/0/0:0 (555 MHz) initial 55808 0%(0%/0%) 0% 0 0 0 37
In8/0/0:0/U0 initial 55808 0% 0% 0 0 0 7.6
In8/0/0:0/U1 initial 55808 0% 0% 0 0 0 7.6
In8/0/0:0/U2 initial 55808 0% 0% 0 0 0 7.6
In8/0/0:0/U3 initial 55808 0% 0% 0 0 0 7.6
In8/0/0:1 (561 MHz) initial 55808 0%(0%/0%) 0% 0 0 0 37
In8/0/0:1/U0 initial 55808 0% 0% 0 0 0 7.6
In8/0/0:1/U1 initial 55808 0% 0% 0 0 0 7.6
Cisco IOS CMTS Cable Command Reference
CBL-1274 OL-15510-15
Cable Commands: show a through show cable l
show cable load-balance docsis-group
In8/0/0:1/U2 initial 55808 0% 0% 0 0 0 7.6
In8/0/0:1/U3 initial 55808 0% 0% 0 0 0 7.6
In8/0/0:2 (567 MHz) initial 55808 0%(0%/0%) 0% 0 0 0 37
In8/0/0:2/U0 initial 55808 0% 0% 0 0 0 7.6
In8/0/0:2/U1 initial 55808 0% 0% 0 0 0 7.6
In8/0/0:2/U2 initial 55808 0% 0% 0 0 0 7.6
In8/0/0:2/U3 initial 55808 0% 0% 0 0 0 7.6
In8/0/0:3 (573 MHz) initial 55808 0%(0%/0%) 0% 0 0 0 37
In8/0/0:3/U0 initial 55808 0% 0% 0 0 0 7.6
In8/0/0:3/U1 initial 55808 0% 0% 0 0 0 7.6
In8/0/0:3/U2 initial 55808 0% 0% 0 0 0 7.6
In8/0/0:3/U3 initial 55808 0% 0% 0 0 0 7.6
In8/0/1:0 (579 MHz) initial 55808 0%(0%/0%) 0% 0 0 0 37
In8/0/1:0/U0 initial 55808 0% 0% 0 0 0 7.6
In8/0/1:0/U1 initial 55808 0% 0% 0 0 0 7.6
In8/0/1:0/U2 initial 55808 0% 0% 0 0 0 7.6
In8/0/1:0/U3 initial 55808 0% 0% 0 0 0 7.6
In8/0/1:1 (585 MHz) initial 55808 0%(0%/0%) 0% 0 0 0 37
In8/0/1:1/U0 initial 55808 0% 0% 0 0 0 7.6
In8/0/1:1/U1 initial 55808 0% 0% 0 0 0 7.6
In8/0/1:1/U2 initial 55808 0% 0% 0 0 0 7.6
In8/0/1:1/U3 initial 55808 0% 0% 0 0 0 7.6
In8/0/1:2 (591 MHz) initial 55808 0%(0%/0%) 0% 0 0 0 37
In8/0/1:2/U0 initial 55808 0% 0% 0 0 0 7.6
In8/0/1:2/U1 initial 55808 0% 0% 0 0 0 7.6
In8/0/1:2/U2 initial 55808 0% 0% 0 0 0 7.6
In8/0/1:2/U3 initial 55808 0% 0% 0 0 0 7.6
In8/0/1:3 (597 MHz) initial 55808 0%(0%/0%) 0% 0 0 0 37
In8/0/1:3/U0 initial 55808 0% 0% 0 0 0 7.6
In8/0/1:3/U1 initial 55808 0% 0% 0 0 0 7.6
In8/0/1:3/U2 initial 55808 0% 0% 0 0 0 7.6
In8/0/1:3/U3 initial 55808 0% 0% 0 0 0 7.6
Mo1/0/0:4 (525 MHz) up 55808 0%(0%/0%) 0% 2 0 2 36
Mo1/0/0:4/U4 up 55808 0% 0% 1 0 1 7.6
Mo1/0/0:4/U5 up 55808 0% 0% 2 0 2 7.6
Mo1/0/0:4/U6 up 55808 0% 0% 1 0 1 7.6
Mo1/0/0:4/U7 initial 55808 0% 0% 0 0 0 7.6
Mo1/0/0:5 (531 MHz) initial 55808 0%(0%/0%) 0% 0 0 0 36
Mo1/0/0:5/U4 up 55808 0% 0% 1 0 1 7.6
Mo1/0/0:5/U5 up 55808 0% 0% 2 0 2 7.6
Mo1/0/0:5/U6 up 55808 0% 0% 1 0 1 7.6
Mo1/0/0:5/U7 initial 55808 0% 0% 0 0 0 7.6
Mo1/0/0:6 (537 MHz) up 55808 0%(0%/0%) 0% 1 0 1 36
Mo1/0/0:6/U4 up 55808 0% 0% 1 0 1 7.6
Mo1/0/0:6/U5 up 55808 0% 0% 2 0 2 7.6
Mo1/0/0:6/U6 up 55808 0% 0% 1 0 1 7.6
Mo1/0/0:6/U7 initial 55808 0% 0% 0 0 0 7.6
Mo1/0/0:7 (543 MHz) up 55808 0%(0%/0%) 0% 1 0 1 36
Mo1/0/0:7/U4 up 55808 0% 0% 1 0 1 7.6
Mo1/0/0:7/U5 up 55808 0% 0% 2 0 2 7.6
Mo1/0/0:7/U6 up 55808 0% 0% 1 0 1 7.6
Mo1/0/0:7/U7 initial 55808 0% 0% 0 0 0 7.6
Target assignments:
Interface State Group Target
Index
Mo6/1/0:0 (405 MHz) initial 82
Mo6/1/0:0 (405 MHz) initial 44290
Mo6/1/0:0/U0 initial 82
Mo6/1/0:0/U0 initial 44290
Mo6/1/0:0/U1 initial 82
Mo6/1/0:0/U1 initial 44290
Mo6/1/0:0/U2 initial 82
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1275
Cable Commands: show a through show cable l
show cable load-balance docsis-group
Mo6/1/0:0/U2 initial 44290
Mo6/1/0:0/U3 initial 82
Mo6/1/0:0/U3 initial 44290
Mo6/1/0:1 (411 MHz) down 82
Mo6/1/0:1 (411 MHz) down 44290
Mo6/1/0:2 (417 MHz) down 82
Mo6/1/0:2 (417 MHz) down 44290
Mo6/1/0:3 (423 MHz) down 82
Mo6/1/0:3 (423 MHz) down 44290
Mo6/1/0:4 (429 MHz) down 82
Mo6/1/0:4 (429 MHz) down 44290
Mo6/1/0:5 (435 MHz) down 82
Mo6/1/0:5 (435 MHz) down 44290
Mo6/1/0:6 (441 MHz) down 82
Mo6/1/0:6 (441 MHz) down 44290
Mo6/1/0:7 (447 MHz) down 82
Mo6/1/0:7 (447 MHz) down 44290
Mo6/1/1:0 (453 MHz) down 82
Mo6/1/1:0 (453 MHz) down 83
Mo6/1/1:1 (459 MHz) down 82
Mo6/1/1:1 (459 MHz) down 83
Mo6/1/1:2 (465 MHz) down 82
Mo6/1/1:2 (465 MHz) down 83
Mo6/1/1:3 (471 MHz) down 82
Mo6/1/1:3 (471 MHz) down 83
Mo6/1/1:4 (477 MHz) down 82
Mo6/1/1:4 (477 MHz) down 83
Mo6/1/1:5 (483 MHz) down 82
Mo6/1/1:5 (483 MHz) down 83
Mo6/1/1:6 (489 MHz) down 82
Mo6/1/1:6 (489 MHz) down 83
Mo6/1/1:7 (495 MHz) down 82
Mo6/1/1:7 (495 MHz) down 83
Cable7/0/0 (333 MHz) up 81 Mo1/0/0:1 (507 MHz) [enforce]
Cable7/0/0 (333 MHz) up 48129 Mo1/0/0:1 (507 MHz)
Cable7/0/0/U0 up 81
Cable7/0/0/U0 up 48129
Cable7/0/0/U1 up 81 Cable7/0/0/U0
Cable7/0/0/U1 up 48129
Cable7/0/0/U2 up 81
Cable7/0/0/U2 up 48129
Cable7/0/0/U3 up 81
Cable7/0/0/U3 up 48129
Mo1/0/0:0 (501 MHz) up 81
Mo1/0/0:0 (501 MHz) up 48129
Mo1/0/0:0/U0 up 81
Mo1/0/0:0/U0 up 48129
Mo1/0/0:0/U1 up 81 Mo1/0/0:0/U0
Mo1/0/0:0/U1 up 48129
Mo1/0/0:0/U2 up 81
Mo1/0/0:0/U2 up 48129
Mo1/0/0:0/U3 up 81
Mo1/0/0:0/U3 up 48129
Mo1/0/0:1 (507 MHz) up 81
Mo1/0/0:1 (507 MHz) up 48129
Mo1/0/0:1/U0 up 81
Mo1/0/0:1/U0 up 48129
Mo1/0/0:1/U1 up 81 Mo1/0/0:1/U0
Mo1/0/0:1/U1 up 48129
Mo1/0/0:1/U2 up 81
Mo1/0/0:1/U2 up 48129
Mo1/0/0:1/U3 up 81
Mo1/0/0:1/U3 up 48129
Mo1/0/0:2 (513 MHz) up 81
Cisco IOS CMTS Cable Command Reference
CBL-1276 OL-15510-15
Cable Commands: show a through show cable l
show cable load-balance docsis-group
Mo1/0/0:2 (513 MHz) up 48129
Mo1/0/0:2/U0 up 81
Mo1/0/0:2/U0 up 48129
Mo1/0/0:2/U1 up 81 Mo1/0/0:2/U0
Mo1/0/0:2/U1 up 48129
Mo1/0/0:2/U2 up 81
Mo1/0/0:2/U2 up 48129
Mo1/0/0:2/U3 up 81
Mo1/0/0:2/U3 up 48129
Mo1/0/0:3 (519 MHz) up 81
Mo1/0/0:3 (519 MHz) up 48129
Mo1/0/0:3/U0 up 81
Mo1/0/0:3/U0 up 48129
Mo1/0/0:3/U1 up 81 Mo1/0/0:3/U0
Mo1/0/0:3/U1 up 48129
Mo1/0/0:3/U2 up 81
Mo1/0/0:3/U2 up 48129
Mo1/0/0:3/U3 up 81
Mo1/0/0:3/U3 up 48129
In8/0/0:0 (555 MHz) initial 55808
In8/0/0:0/U0 initial 55808
In8/0/0:0/U1 initial 55808
In8/0/0:0/U2 initial 55808
In8/0/0:0/U3 initial 55808
In8/0/0:1 (561 MHz) initial 55808
In8/0/0:1/U0 initial 55808
In8/0/0:1/U1 initial 55808
In8/0/0:1/U2 initial 55808
In8/0/0:1/U3 initial 55808
In8/0/0:2 (567 MHz) initial 55808
In8/0/0:2/U0 initial 55808
In8/0/0:2/U1 initial 55808
In8/0/0:2/U2 initial 55808
In8/0/0:2/U3 initial 55808
In8/0/0:3 (573 MHz) initial 55808
In8/0/0:3/U0 initial 55808
In8/0/0:3/U1 initial 55808
In8/0/0:3/U2 initial 55808
In8/0/0:3/U3 initial 55808
In8/0/1:0 (579 MHz) initial 55808
In8/0/1:0/U0 initial 55808
In8/0/1:0/U1 initial 55808
In8/0/1:0/U2 initial 55808
In8/0/1:0/U3 initial 55808
In8/0/1:1 (585 MHz) initial 55808
In8/0/1:1/U0 initial 55808
In8/0/1:1/U1 initial 55808
In8/0/1:1/U2 initial 55808
In8/0/1:1/U3 initial 55808
In8/0/1:2 (591 MHz) initial 55808
In8/0/1:2/U0 initial 55808
In8/0/1:2/U1 initial 55808
In8/0/1:2/U2 initial 55808
In8/0/1:2/U3 initial 55808
In8/0/1:3 (597 MHz) initial 55808
In8/0/1:3/U0 initial 55808
In8/0/1:3/U1 initial 55808
In8/0/1:3/U2 initial 55808
In8/0/1:3/U3 initial 55808
Mo1/0/0:4 (525 MHz) up 55808
Mo1/0/0:4/U4 up 55808
Mo1/0/0:4/U5 up 55808
Mo1/0/0:4/U6 up 55808
Mo1/0/0:4/U7 initial 55808
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1277
Cable Commands: show a through show cable l
show cable load-balance docsis-group
Mo1/0/0:5 (531 MHz) initial 55808
Mo1/0/0:5/U4 up 55808
Mo1/0/0:5/U5 up 55808
Mo1/0/0:5/U6 up 55808
Mo1/0/0:5/U7 initial 55808
Mo1/0/0:6 (537 MHz) up 55808
Mo1/0/0:6/U4 up 55808
Mo1/0/0:6/U5 up 55808
Mo1/0/0:6/U6 up 55808
Mo1/0/0:6/U7 initial 55808
Mo1/0/0:7 (543 MHz) up 55808
Mo1/0/0:7/U4 up 55808
Mo1/0/0:7/U5 up 55808
Mo1/0/0:7/U6 up 55808
Mo1/0/0:7/U7 initial 55808
Statistics:
Target interface State Transfers
Complete Pending Retries Failures
Mo6/1/0:0 (405 MHz) initial 0 0 0 0
Mo6/1/0:0/U0 initial 0 0 0 0
Mo6/1/0:0/U1 initial 0 0 0 0
Mo6/1/0:0/U2 initial 0 0 0 0
Mo6/1/0:0/U3 initial 0 0 0 0
Mo6/1/0:1 (411 MHz) down 0 0 0 0
Mo6/1/0:2 (417 MHz) down 0 0 0 0
Mo6/1/0:3 (423 MHz) down 0 0 0 0
Mo6/1/0:4 (429 MHz) down 0 0 0 0
Mo6/1/0:5 (435 MHz) down 0 0 0 0
Mo6/1/0:6 (441 MHz) down 0 0 0 0
Mo6/1/0:7 (447 MHz) down 0 0 0 0
Mo6/1/1:0 (453 MHz) down 0 0 0 0
Mo6/1/1:1 (459 MHz) down 0 0 0 0
Mo6/1/1:2 (465 MHz) down 0 0 0 0
Mo6/1/1:3 (471 MHz) down 0 0 0 0
Mo6/1/1:4 (477 MHz) down 0 0 0 0
Mo6/1/1:5 (483 MHz) down 0 0 0 0
Mo6/1/1:6 (489 MHz) down 0 0 0 0
Mo6/1/1:7 (495 MHz) down 0 0 0 0
Cable7/0/0 (333 MHz) up 10 0 0 0
Cable7/0/0/U0 up 33 0 0 0
Cable7/0/0/U1 up 84 0 0 0
Cable7/0/0/U2 up 48 0 0 0
Cable7/0/0/U3 up 34 0 0 0
Mo1/0/0:0 (501 MHz) up 19 0 0 0
Mo1/0/0:0/U0 up 34 0 0 0
Mo1/0/0:0/U1 up 49 0 0 0
Mo1/0/0:0/U2 up 23 0 0 0
Mo1/0/0:0/U3 up 22 0 0 0
Mo1/0/0:1 (507 MHz) up 23 0 0 0
Mo1/0/0:1/U0 up 10 0 0 0
Mo1/0/0:1/U1 up 21 0 0 0
Mo1/0/0:1/U2 up 16 0 0 0
Mo1/0/0:1/U3 up 21 0 0 0
Mo1/0/0:2 (513 MHz) up 21 0 0 0
Mo1/0/0:2/U0 up 4 0 0 0
Mo1/0/0:2/U1 up 3 0 0 0
Mo1/0/0:2/U2 up 7 0 0 0
Mo1/0/0:2/U3 up 8 0 0 0
Mo1/0/0:3 (519 MHz) up 10 0 0 0
Mo1/0/0:3/U0 up 1 0 0 0
Mo1/0/0:3/U1 up 2 0 0 0
Mo1/0/0:3/U2 up 4 0 0 0
Cisco IOS CMTS Cable Command Reference
CBL-1278 OL-15510-15
Cable Commands: show a through show cable l
show cable load-balance docsis-group
Mo1/0/0:3/U3 up 4 0 0 0
In8/0/0:0 (555 MHz) initial 0 0 0 0
In8/0/0:0/U0 initial 0 0 0 0
In8/0/0:0/U1 initial 0 0 0 0
In8/0/0:0/U2 initial 0 0 0 0
In8/0/0:0/U3 up 0 0 0 0
In8/0/0:0/U4 down 0 0 0 0
In8/0/0:0/U5 down 0 0 0 0
In8/0/0:0/U6 down 0 0 0 0
In8/0/0:0/U7 down 0 0 0 0
In8/0/0:1 (561 MHz) initial 0 0 0 0
In8/0/0:1/U0 initial 0 0 0 0
In8/0/0:1/U1 initial 0 0 0 0
In8/0/0:1/U2 initial 0 0 0 0
In8/0/0:1/U3 up 0 0 0 0
In8/0/0:1/U4 down 0 0 0 0
In8/0/0:1/U5 down 0 0 0 0
In8/0/0:1/U6 down 0 0 0 0
In8/0/0:1/U7 down 0 0 0 0
In8/0/0:2 (567 MHz) up 0 0 0 0
In8/0/0:2/U0 initial 0 0 0 0
In8/0/0:2/U1 initial 0 0 0 0
In8/0/0:2/U2 initial 0 0 0 0
In8/0/0:2/U3 up 0 0 0 0
In8/0/0:2/U4 down 0 0 0 0
In8/0/0:2/U5 down 0 0 0 0
In8/0/0:2/U6 down 0 0 0 0
In8/0/0:2/U7 down 0 0 0 0
In8/0/0:3 (573 MHz) initial 0 0 0 0
In8/0/0:3/U0 initial 0 0 0 0
In8/0/0:3/U1 initial 0 0 0 0
In8/0/0:3/U2 initial 0 0 0 0
In8/0/0:3/U3 up 0 0 0 0
In8/0/0:3/U4 down 0 0 0 0
In8/0/0:3/U5 down 0 0 0 0
In8/0/0:3/U6 down 0 0 0 0
In8/0/0:3/U7 down 0 0 0 0
In8/0/1:0 (579 MHz) initial 0 0 0 0
In8/0/1:0/U0 initial 0 0 0 0
In8/0/1:0/U1 initial 0 0 0 0
In8/0/1:0/U2 initial 0 0 0 0
In8/0/1:0/U3 up 0 0 0 0
In8/0/1:0/U4 down 0 0 0 0
In8/0/1:0/U5 down 0 0 0 0
In8/0/1:0/U6 down 0 0 0 0
In8/0/1:0/U7 down 0 0 0 0
In8/0/1:1 (585 MHz) initial 0 0 0 0
In8/0/1:1/U0 initial 0 0 0 0
In8/0/1:1/U1 initial 0 0 0 0
In8/0/1:1/U2 initial 0 0 0 0
In8/0/1:1/U3 up 0 0 0 0
In8/0/1:1/U4 down 0 0 0 0
In8/0/1:1/U5 down 0 0 0 0
In8/0/1:1/U6 down 0 0 0 0
In8/0/1:1/U7 down 0 0 0 0
In8/0/1:2 (591 MHz) initial 0 0 0 0
In8/0/1:2/U0 initial 0 0 0 0
In8/0/1:2/U1 initial 0 0 0 0
In8/0/1:2/U2 initial 0 0 0 0
In8/0/1:2/U3 up 0 0 0 0
In8/0/1:2/U4 down 0 0 0 0
In8/0/1:2/U5 down 0 0 0 0
In8/0/1:2/U6 down 0 0 0 0
In8/0/1:2/U7 down 0 0 0 0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1279
Cable Commands: show a through show cable l
show cable load-balance docsis-group
In8/0/1:3 (597 MHz) initial 0 0 0 0
In8/0/1:3/U0 initial 0 0 0 0
In8/0/1:3/U1 initial 0 0 0 0
In8/0/1:3/U2 initial 0 0 0 0
In8/0/1:3/U3 up 0 0 0 0
In8/0/1:3/U4 down 0 0 0 0
In8/0/1:3/U5 down 0 0 0 0
In8/0/1:3/U6 down 0 0 0 0
In8/0/1:3/U7 down 0 0 0 0
Mo1/0/0:4 (525 MHz) up 0 0 0 0
Mo1/0/0:4/U0 down 0 0 0 0
Mo1/0/0:4/U1 down 0 0 0 0
Mo1/0/0:4/U2 down 0 0 0 0
Mo1/0/0:4/U3 down 0 0 0 0
Mo1/0/0:4/U4 up 0 0 0 0
Mo1/0/0:4/U5 up 0 0 0 0
Mo1/0/0:4/U6 up 0 0 0 0
Mo1/0/0:4/U7 initial 0 0 0 0
Mo1/0/0:5 (531 MHz) initial 0 0 0 0
Mo1/0/0:5/U0 down 0 0 0 0
Mo1/0/0:5/U1 down 0 0 0 0
Mo1/0/0:5/U2 down 0 0 0 0
Mo1/0/0:5/U3 down 0 0 0 0
Mo1/0/0:5/U4 up 0 0 0 0
Mo1/0/0:5/U5 up 0 0 0 0
Mo1/0/0:5/U6 up 0 0 0 0
Mo1/0/0:5/U7 initial 0 0 0 0
Mo1/0/0:6 (537 MHz) up 0 0 0 0
Mo1/0/0:6/U0 down 0 0 0 0
Mo1/0/0:6/U1 down 0 0 0 0
Mo1/0/0:6/U2 down 0 0 0 0
Mo1/0/0:6/U3 down 0 0 0 0
Mo1/0/0:6/U4 up 0 0 0 0
Mo1/0/0:6/U5 up 0 0 0 0
Mo1/0/0:6/U6 up 0 0 0 0
Mo1/0/0:6/U7 initial 0 0 0 0
Mo1/0/0:7 (543 MHz) initial 0 0 0 0
Mo1/0/0:7/U0 down 0 0 0 0
Mo1/0/0:7/U1 down 0 0 0 0
Mo1/0/0:7/U2 down 0 0 0 0
Mo1/0/0:7/U3 down 0 0 0 0
Mo1/0/0:7/U4 up 0 0 0 0
Mo1/0/0:7/U5 up 0 0 0 0
Mo1/0/0:7/U6 up 0 0 0 0
Mo1/0/0:7/U7 initial 0 0 0 0
Pending:
Modem Grp Idx Primary RF/RCC MD/TCS Action Active Retries
Src Target Src Target Time
001c.ea37.9aa0 81 Mo1/0/0:2/1 Mo1/0/0:1/0 60/1 60/1 REINIT 02:05 0 DOCSIS
3.0 LB
001c.ea37.9b5e 81 Cable7/0/0/1 Mo1/0/0:1/0 60/4 60/8 REINIT 02:12 0 DOCSIS
3.0 LB
001c.ea37.9bb0 81 Cable7/0/0/2 Mo1/0/0:2/0 60/2 60/2 REINIT 02:17 0 DOCSIS
3.0 LB
The following is a sample output of the show cable load-balance docsis-group vdoc command:
Router# show cable load-balance docsis-group 1 vdoc
Target interface State Group Util Total IGMP CIR High Low
Index Targeted Rep Init Util CIR
Cable7/0/0 (531 MHz) down 81 0 0(0) 0(0) 0(0) 0 0
Cisco IOS CMTS Cable Command Reference
CBL-1280 OL-15510-15
Cable Commands: show a through show cable l
show cable load-balance docsis-group
Mo3/0/0:0 (453 MHz) up 81 0 9(5) 7(5) 2(0) 0 0
Mo3/0/0:1 (459 MHz) initi 81 0 0(0) 0(0) 0(0) 0 0
Mo3/0/0:10 (513 MHz) initi 81 0 0(0) 0(0) 0(0) 0 0
Mo3/0/0:11 (519 MHz) initi 81 0 0(0) 0(0) 0(0) 0 0
Mo3/0/0:2 (465 MHz) initi 81 0 0(0) 0(0) 0(0) 0 0
Mo3/0/0:3 (471 MHz) initi 81 0 0(0) 0(0) 0(0) 0 0
Mo3/0/0:4 (477 MHz) initi 81 0 5(0) 0(0) 5(0) 0 0
Mo3/0/0:5 (483 MHz) up 81 0 7(7) 7(7) 0(0) 0 0
Mo3/0/0:6 (489 MHz) initi 81 0 0(0) 0(0) 0(0) 0 0
Mo3/0/0:7 (495 MHz) initi 81 0 0(0) 0(0) 0(0) 0 0
Mo3/0/0:8 (501 MHz) initi 81 0 0(0) 0(0) 0(0) 0 0
Mo3/0/0:9 (507 MHz) initi 81 0 0(0) 0(0) 0(0) 0 0
Table 76 describes the fields shown in the show cable load-balance docsis-group display.
Table 76 show cable load-balance docsis-group – Field Description
Field Description
Fields for the Default Display and all Option
DOCSIS Group Current number of DOCSIS groups created on the CMTS.
Group Index Number of the load balancing group to which the cable
interface has been assigned.
Status Information about the DOCSIS LBG:
• R—Restricted load balancing group (RLBG).
• G—General load balancing group (GLBG).
• E—The DOCSIS LBG is enabled.
• D—The DOCSIS LBG is disabled.
Interval Minimum time period configured when cable modems can
be moved to load balance the interfaces.
In Cisco IOS Release 12.2(33)SCE and earlier releases, the
valid range is 1 to 1000 seconds, with a default value of 10.
In Cisco IOS Release 12.2(33)SCE1 and later releases, the
default value of interval is 30.
DCC mask/UCC Downstream and upstream channel change masks associated
with the DOCSIS group.
For example, in the output ‘0x40(1)/Y’, ‘0x40’ indicates that
the user configured the dynamic channel change (DCC)
technique 1 for the DOCSIS LBG. Similarly, '0x80'
indicates configured DCC technique 0 and '0x20' indicates
configured DCC technique 2. '(1)' indicates the DCC
technique 1 is used to move the cable modem (CM). '/Y'
indicates that load balancing sends upstream channel change
(UCC) for movement of US channel only.
Policy DOCSIS policy associated with the load balancing group.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1281
Cable Commands: show a through show cable l
show cable load-balance docsis-group
Table 76 show cable load-balance docsis-group – Field Description (continued)
Field Description
Method Load balancing method used for the load balancing group.
The following indicates what method is used for DS and US
modems:
• m = modem
Uses the number of active cable modems on an
interface.
• s = service flow
Uses the number of active Service Flow IDs (SFIDs) on
an interface.
• u = utilization
Uses the current percent of utilization of an interface.
Cisco IOS CMTS Cable Command Reference
CBL-1282 OL-15510-15
Cable Commands: show a through show cable l
show cable load-balance docsis-group
Table 76 show cable load-balance docsis-group – Field Description (continued)
Field Description
Threshold Thresholds configured for this load balancing group:
• M = Minimum
Minimum difference in the number of cable modems or
service flows that can exist on two interfaces in the
group before cable modems are moved between the
interfaces. If the imbalance between interfaces is below
this value, cable modems are not moved. This field
contains a value only when the group is configured for
the modems or service flows method of load balancing.
(This value is configured using the load minimum
option of the cable load-balance group threshold
command.)
• S = Stability.
Minimum allowable percentage of good periodic
ranging requests that is acceptable. When the channel
has a lower percent of modems responding to the
ranging requests in a one minute period, the Cisco
CMTS begins moving modems. The valid range is 0 to
100 percent, with a default of 50 percent.
• E = Enforce
Minimum difference in the percentage of total load that
must exist between interfaces in a load balancing group
before the Cisco CMTS performs dynamic load
balancing and begins moving cable modems that are
currently online. When the difference in load between
two interfaces falls below this value, the CMTS stops
dynamic load balancing and performs static load
balancing. (This value is configured using the enforce
option of the cable load-balance group threshold
command.)
• U = Ugs
Percentage of the bandwidth that is allocated for
Unsolicited Grant Services (UGS) traffic, such as
Voice-over-IP (VoIP), that is in use on an interface
because the CMTS moves cable modems that are online
with active UGS service flows. (This value is
configured using the ugs option of the cable
load-balance group threshold command.)
• P = PacketCable MultiMedia (PCMM)
Percentage of the reserved bandwidth threshold. Above
this level, cable modems with active PCMM service
flows participate in load balancing. The default
threshold is 70%.
Interface Cable interface (downstream or upstream) that belongs to a
load balancing group.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1283
Cable Commands: show a through show cable l
show cable load-balance docsis-group
Table 76 show cable load-balance docsis-group – Field Description (continued)
Field Description
Utilization Long-term average of the upstream utilization. Displays the
current load usage of the cable interface expressed as a
percentage of the total bandwidth. For upstreams, this field
shows a single percentage value, which is the average
percentage of bandwidth being used on the upstream.
For downstreams, this field shows a set of three percentage
values:
• The percentage shows the load usage for the entire
interface.
• The first percentage, within the parentheses, shows the
load for the downstream.
• The second percentage, within the parentheses, shows
the average load for all upstreams on the downstream.
For example, if this field shows “18%(18%/12%)”, it indicates
that downstream and upstream channels on the interface are
running on an average load of 18 percent. The downstream
is running on an average load of 18 percent and all upstreams
for this downstream are running on an average load of 12
percent.
Note To view the short-term average of the utilization, use
the show interface cable mac-scheduler command.
Cisco IOS CMTS Cable Command Reference
CBL-1284 OL-15510-15
Cable Commands: show a through show cable l
show cable load-balance docsis-group
Table 76 show cable load-balance docsis-group – Field Description (continued)
Field Description
State Current state of the cable interface.
The following states indicate normal operational states,
depending on the configuration:
• down—Interface is shut down. The CMTS cannot use
the interface for load balancing in this state.
• initial—Interface is currently in the initialization phase.
The CMTS uses the interface for load balancing after
the initialization completes.
• up—Interface is up and passing traffic. The CMTS
actively uses the interface for load balancing.
• testing—Interface is currently under a load balancing
test. The CMTS is unable to use the interface for normal
load balancing operations until the test completes.
The following states indicate abnormal states. The CMTS
does not use interfaces in these states for load balancing
operations, but continues to monitor and update the status
every time the CMTS polls the interfaces for their current
load usage:
• suspicious—Interface is in an unknown state. The
interface might be up and passing traffic, but is not
consistent enough to support load balancing operations.
The CMTS attempts to reinitialize the interface after a
time-out period. If the interface has failed initialization
more than 10 times, the CMTS moves the interface to
the disabled state.
• disabled—Interface has been disabled because a load
balancing test is in-progress or because the interface
reinitialization failed after 10 attempts.
• unstable—Interface has failed repeated initialization
attempts. The CMTS will attempt to reinitialize the
interface after a time-out period. If a load balance test is
not in-progress and if reinitialization fails, the CMTS
moves it to the unstable state.
Reserved Percentage of bandwidth that is currently reserved by
unsolicited grant service (UGS) service flows.
Modems Number of cable modems currently online on this cable
interface.
Flows Number of service flows currently active on the cable
interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1285
Cable Commands: show a through show cable l
show cable load-balance docsis-group
Table 76 show cable load-balance docsis-group – Field Description (continued)
Field Description
Weight Interface bandwidth, in megabits per second (mbps), for the
downstream or upstream. The system uses this value in
calculating whether the loads on the interfaces are balanced.
Changing a channel parameter, such as modulation profile or
channel width, affects the channel bandwidth and weight
value.
Additional Fields for the target Option
Interface Source downstream or upstream interface that is part of a
cable load balancing group. If the target field contains a
value, it indicates that the source interface is currently
oversubscribed.
To reduce the cable load, the CMTS moves cable modems
from the source interface to the target interface.
Target Downstream or upstream interface to which cable modems
on the source interface are being moved as part of load
balancing operations. This field indicates the following:
• If it is a downstream interface, the display shows the
center frequency of the downstream within parentheses.
• If only a frequency is shown, it indicates that the CMTS
is moving cable modems to a different center frequency
on the same downstream interface.
• When the display includes the words “enforce”, it
indicates that the CMTS is performing dynamic load
balancing on the interfaces.
• If this field is blank, it indicates that the source interface
is not oversubscribed.
Additional Fields for the statistics Option
Target interface Downstream or upstream interface. If this is a downstream
interface, the display shows the center frequency of the
downstream within parentheses.
Cisco IOS CMTS Cable Command Reference
CBL-1286 OL-15510-15
Cable Commands: show a through show cable l
show cable load-balance docsis-group
Table 76 show cable load-balance docsis-group – Field Description (continued)
Field Description
Transfers The following information is tracked for the indicated target
interface:
• complete—Number of cable modems successfully
moved to the target interface.
• pending—Number of cable modems in the process of
being moved to the target interface.
• retries—Number of times that the CMTS unsuccessfully
tried to move the same cable modem to the target
interface. This occurs when one or more MAC layer
messages to the cable modem are dropped due to radio
frequency (RF) noise or because the modem is not
DOCSIS-compliant. If the number of retries exceeds
five for a particular cable modem, the CMTS counts this
as a failure.
• failures—Number of times that the CMTS exceeded the
maximum number of allowable retries (5) when trying
to move a particular cable modem to the target interface.
A large number of failures could indicate one or more
possible problems:
– The specific cable modems are not
DOCSIS-compliant.
– One or both interfaces are having problems passing
traffic.
– One or both interfaces are having persistent RF
noise problems.
– The source and target interfaces are not combined in
the same node and do not share the same physical
connectivity (which is required when interfaces are
part the same load balancing group).
Additional Fields for the pending Option
Modem Hardware (MAC) address of the cable modem that is moved
as part of load balancing operations.
Source interface Downstream or upstream cable interface on which the cable
modem is currently online.
Target interface Downstream or upstream cable interface to which the CMTS
is trying to move the cable modem to load balance the
interfaces in this load balancing group. If the CMTS is
moving the cable modem to a different frequency on the
same downstream interface, this field shows only the new
center frequency.
Retries Number of times that the CMTS has attempted to move this
cable modem to the target interface. The CMTS attempts to
move the cable modem 5 times before counting this load
balancing move as a failure.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1287
Cable Commands: show a through show cable l
show cable load-balance docsis-group
Table 76 show cable load-balance docsis-group – Field Description (continued)
Field Description
Additional Fields for the modem-list option
US Upstream channels in the DOCSIS LBG.
MAC Address Total number (in parentheses) and MAC addresses of the
modems connected to the upstream channels.
Related Commands Command Description
cable load-balance Creates a DOCSIS LBG on the Cisco CMTS.
docsis-group
cable load-balance Creates a DOCSIS policy and associates an existing rule and tag with the
docsis-policy policy.
cable load-balance Enables or disables DOCSIS load balancing on the Cisco CMTS.
docsis-enable
cable load-balance Creates a rule to prevent the CM from disabling or enabling load balancing.
rule
cable tag Creates a tag to associate it with DOCSIS policies and groups.
Cisco IOS CMTS Cable Command Reference
CBL-1288 OL-15510-15
Cable Commands: show a through show cable l
show cable logging
show cable logging
To display the log of messages about bad IP source addresses, downstream indexes, on the cable
interfaces, use the show cable logging command in user EXEC or privileged EXEC mode.
show cable logging [badipsource | | summary] [slot]
Syntax Description badipsource Displays the contents of the error log buffer containing the error messages
for bad IP source addresses.
Displays the contents of the message log buffer for downstream indexes.
summary Displays the status of the logging feature and its buffer.
slot (Optional) Slot of a particular cable interface on the Cisco uBR7200 series
router. The slot parameter can range from 3 to 6, depending on the cable
interface.
Note This option is supported only on the Cisco uBR-MC16U/X,
Cisco uBR10-MC5X20U, Cisco uBR10-MC5X20H, and
Cisco uBR-MC28U/X cable interface line card.
Command Modes User EXEC (>)
Privileged EXEC (#)
Command History Release Modification
12.1(13)EC This command was introduced for the Cisco uBR7100 series and
Cisco uBR7200 series universal broadband routers.
12.2(11)CY Support was added for the Cisco uBR10012 universal broadband router.
12.2(11)BC2 Support was added to the Release 12.2 BC train for the Cisco uBR7100
series, Cisco uBR7200 series, and Cisco uBR10012 routers.
12.2(15)CX Support was added to display the log buffer on an individual
Cisco uBR-MC28U/X cable interface line card on the Cisco uBR7200 series
router.
12.2(15)BC2 Support was added for the Cisco uBR-MC16U/X, Cisco uBR10-MC5X20U,
and Cisco uBR10-MC5X20H cable interface line cards.
12.3(21)BC This command was enhanced to support logging events tracked with the
Cable Duplicate MAC Address Reject feature on the Cisco CMTS, when
configured. This supports the detection of cloned cable modems.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
12.3(23)BC5 The command output was modified to display the CPU revision number of
the line card.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.2(33)SCB.
12.2(33)SCG The
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1289
Cable Commands: show a through show cable l
show cable logging
Usage Guidelines For additional information about the Cable Duplicate MAC Address Reject feature on the Cisco CMTS,
or enforced DOCSIS 1.1 security, see the Cable Duplicate MAC Address Reject for the Cisco CMTS.
The cable logging badipsource command creates a circular buffer that contains the BADIPSOURCE
error messages, which the Cisco CMTS generates when it discovers a CM or CPE device using an
unauthorized IP address. If the buffer becomes full, the oldest messages are deleted to make room for
the newer messages.
Use the show cable logging command to display the current contents of the buffer. After you have
viewed all of the error messages in the current buffer, use the clear cable logging command to clear out
the buffer to make room for newer messages.
Use the show cable logging summary command to check if the logging feature is enabled and also to
view the status of the logging buffer.
The Broadband Processing Engine (BPE) cable interface line cards (such as the Cisco uBR-MC16U/X
and Cisco uBR-MC28U/X) contain an onboard processor that also maintains its own log buffer. To
display the contents of this log, add the card slot number after the show cable logging command.
Examples The following is a sample output of the show cable logging badipsource command. The oldest
messages are displayed first.
Router# show cable logging badipsource
00:01:19: %UBR10000-3-BADIPSOURCE: Interface Cable6/1/1, IP packet from invalid source.
IP=10.44.50.13, MAC=0050.0f02.1d15, Expected SID=1, Actual SID=1
00:01:26: %UBR10000-3-BADIPSOURCE: Interface Cable6/1/1, IP packet from invalid source.
IP=10.44.50.13, MAC=0050.0f02.1d15, Expected SID=1, Actual SID=1
01:49:33: %UBR10000-3-BADIPSOURCE: Interface Cable6/1/0, IP packet from invalid source.
IP=0.0.0.44, MAC=0030.eb00.029d, Expected Interface=Cable6/1/0 SID=2833
02:12:03: %UBR10000-3-BADIPSOURCE: Interface Cable6/1/0, IP packet from invalid source.
IP=0.0.0.44, MAC=0030.eb15.73bd, Expected Interface=Cable6/1/0 SID=2800
02:12:43: %UBR10000-3-BADIPSOURCE: Interface Cable6/1/0, IP packet from invalid source.
IP=0.0.0.44, MAC=00e0.ca01.287a, Expected Interface=Cable6/1/0 SID=3299
02:22:50: %UBR10000-3-BADIPSOURCE: Interface Cable6/1/0, IP packet from invalid source.
IP=0.0.0.44, MAC=0030.eb00.02a2, Expected Interface=Cable6/1/0 SID=394
The following is a sample output of the show cable logging badipsource command when logging has
not been enabled with the cable logging badipsource command:
Router# show cable logging badipsource
Cable logging: BADIPSOURCE Disabled
The following is a sample output for the downstream-index option, showing whether logging is
enabled, the total size of the buffer, how many bytes are currently used, and how many error messages
have been logged since the buffer was last cleared.
Router# show cable logging summary
Cable logging: Enabled
Total buffer size (bytes): 1000000
Used buffer size (bytes) : 36968
Logged messages : 231
The following is a sample output for the summary option, showing whether logging is enabled, the total
size of the buffer, how many bytes are currently used, and how many error messages have been logged
since the buffer was last cleared.
Router# show cable logging summary
Cisco IOS CMTS Cable Command Reference
CBL-1290 OL-15510-15
Cable Commands: show a through show cable l
show cable logging
Cable logging: BADIPSOURCE Enabled
Total buffer size (bytes): 1000000
Used buffer size (bytes) : 36968
Logged messages : 231
The following is a sample output for the summary option, indicating the CPU revision number of the
line card. The display given below is specific to the uBR7200 series routers.
Router# show cable logging summary slot 6
Current LC State Info for slot 6
CLC CPU: BCM1250(Rev A8/A10)
- Status - NO NPE/CLC OIR Timeout detected
Last Process Executed = Per-minute Jobs (4 ms count = 0ms)
Intr Busy Count = 0
Sched Flag Count = 2076
Status = 0x0
Late Poll Etime = 0
LC IPC Reply Status = 0
Interrupted PC/Level Trace
60475E5C/0x0 60475D98/0x0 60406D60/0x0 60406D70/0x0
604754E4/0x0 60335188/0x0 60406D38/0x0 60475E50/0x0
604761DC/0x0 60406D70/0x0 604761DC/0x0 60476994/0x0
60407810/0x0 6047101C/0x0 60470EFC/0x0 60475E5C/0x0
604759C0/0x0 60471014/0x0 60337F04/0x0 60406D4C/0x0
60475E50/0x0 60473EB0/0x0 60475E54/0x0 60476150/0x0
604761D4/0x0 604756FC/0x0 60407810/0x0 60337F80/0x0
60335230/0x0 60475E94/0x0 60406D60/0x0 604756FC/0x0
604761DC/0x0 60475694/0x0 60406CD4/0x0 60470EF0/0x0
60475DBC/0x0 60406D38/0x0 60476954/0x0 604077D0/0x0
60406CDC/0x0 60406CE0/0x0 609FA0C0/0x0 60470EFC/0x0
604754DC/0x0 604077F0/0x0 60475E1C/0x0 60471018/0x0
60337F58/0x0 60406D38/0x0 60475694/0x0 60475E3C/0x0
60406D68/0x0 60337F50/0x0 60470EF0/0x0 60406D60/0x0
604756A8/0x0 60406D38/0x0 60475DC4/0x0 60406D48/0x0
Cable logging: BADIPSOURCE Disabled Slot 6
Cable logging: LAYER2EVENTS Disabled Slot 6
Cable logging: OVERLAPIP Disabled Slot 6
Related Commands cable logging badipsource Logs error messages about bad IP source addresses on the cable
interfaces.
cable logging Logs messages about the downstream indexes.
downstream-index
cable source-verify Enables verification of IP addresses for CMs and CPE devices on the
upstream.
clear cable logging Removes all error and buffer messages on the cable interfaces from
the corresponding logs.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1291
Cable Commands: show a through show cable l
Cisco IOS CMTS Cable Command Reference
CBL-1292 OL-15510-15
Cable Commands: show cable m through
show cable u
Revised: July 2012, OL-15510-15
New Commands
Command Cisco IOS Software Release
show cable mac-domain cable forwarding 12.3(23)BC
show cable mac-domain cgd-associations 12.3(23)BC
show cable modem domain-name 12.2(33)SCA
show cable modem ipv6 12.2(33)SCA
show cable modem voice 12.3(23)BC
show cable modem primary-channel 12.3(23)BC
show cable modem type 12.2(33)SCA
show cable modem wideband primary-channel 12.3(23)BC
show cable rate-adapt 12.3(23)BC2
show cable service-voice downstream-type 12.3(23)BC
show cable mac-domain rcc 12.2(33)SCB
show cable rf-status 12.2(33)SCB
show cable rsvp flow-db 12.2(33)SCB
show cable modem auth-profile 12.2(33)SCB
show cable modem service-type-id 12.2(33)SCB
show cable modem summary wb-rf 12.2(33)SCB
show cable modem wideband rcs-status 12.2(33)SCB
show cable multicast authorization 12.2(33)SCB
show cable multicast db 12.2(33)SCB
show cable multicast dsid 12.2(33)SCB
show cable multicast qos 12.2(33)SCB
show cable modem service-flow 12.2(33)SCB1
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1293
Cable Commands: show cable m through show cable u
Command Cisco IOS Software Release
show cable mac-domain 12.2(33)SCC
upstream-service-group
show cable rate-limit-ccf 12.2(33)SCC
show cable signal-quality 12.2(33)SCC
show cable spectrum-analysis 12.2(33)SCC
show cable us-sg 12.2(33)SCC
show cable modem partial-mode 12.2(33)SCD2
show cable multicast debug 12.2(33)SCE
show cable urm 12.2(33)SCE
show cable modem rf-adapt 12.2(33)SCF
show cable multicast statistics failure 12.2(33)SCF
show cable rf-adapt 12.2(33)SCF
show cable modem extended-power 12.2(33)SCF2
show cable throttle-modem 12.2(33)SCF3
show cable modem partial-service 12.2(33)SCG
show cable modem resiliency 12.2(33)SCG
show cable modem tcs summary 12.2(33)SCG
show cable modem wideband phy 12.2(33)SCG
show cable resiliency 12.2(33)SCG
show cable upstream service-flow summary 12.2(33)SCG
Modified Commands
Command Cisco IOS Software Release
show cable mac-domain 12.3(23)BC
downstream-service-group
show cable modem 12.3(23)BC, 12.2(33)SCA
show cable modem calls 12.2(33)SCA
show cable modem classifiers 12.2(33)SCA
show cable modem cnr 12.2(33)SCA
show cable modem connectivity 12.2(33)SCA
show cable modem counters 12.2(33)SCA
show cable modem cpe 12.2(33)SCA
show cable modem docsis device-class 12.2(33)SCA
show cable modem errors 12.2(33)SCA
show cable modem flap 12.2(33)SCA
show cable modem mac 12.2(33)SCA
show cable modem maintenance 12.2(33)SCA
Cisco IOS CMTS Cable Command Reference
CBL-1294 OL-15510-15
Cable Commands: show cable m through show cable u
Command Cisco IOS Software Release
show cable modem offline 12.2(33)SCA
show cable modem phy 12.2(33)SCA
show cable modem qos 12.2(33)SCA
show cable modem registered 12.2(33)SCA
show cable modem rogue 12.2(33)SCA
show cable modem remote-query 12.3(23)BC
show cable modem phy 12.2(33)SCA
show cable modem 12.2(33)SCB
show cable mac-domain cgd-associations 12.2(33)SCB
show cable mac-domain 12.2(33)SCB
downstream-service-group
show cable modem wideband 12.2(33)SCB
show cable modem wideband rcs-status 12.2(33)SCB
show cable qos enforce-rule 12.2(33)SCB
show cable rate-adapt 12.2(33)SCB
show cable modem service-flow 12.3(23)BC7
show cable modem 12.2(33)SCC
show cable modem cnr 12.2(33)SCC
show cable modem flap 12.2(33)SCC
show cable modem phy 12.2(33)SCC
show cable modem qos 12.2(33)SCC
show cable multicast dsid 12.2(33)SCC
show cable service-class 12.2(33)SCC
show cable mac-domain 12.2(33)SCD
downstream-service-group
show cable mac-domain cgd-associations 12.2(33)SCD
show cable mac-domain rcc 12.2(33)SCD
show cable modem 12.2(33)SCD
show cable multicast dsid 12.2(33)SCD
show cable modem 12.2(33)SCD2
show cable modem docsis version 12.2(33)SCD2
show cable qos enforce-rule 12.2(33)SCD2
show cable modem service-flow 12.2(33)SCE
show cable multicast db 12.2(33)SCE
show cable multicast qos 12.2(33)SCE
show cable privacy 12.2(33)SCE
show cable mac-domain cable forwarding 12.2(33)SCF
show cable modem 12.2(33)SCF
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1295
Cable Commands: show cable m through show cable u
Command Cisco IOS Software Release
show cable modem access-group 12.2(33)SCF
show cable modem calls 12.2(33)SCF
show cable modem cnr 12.2(33)SCF
show cable modem connectivity 12.2(33)SCF
show cable modem counters 12.2(33)SCF
show cable modem docsis version 12.2(33)SCF
show cable modem domain-name 12.2(33)SCF
show cable modem errors 12.2(33)SCF
show cable modem flap 12.2(33)SCF
show cable modem ipv6 12.2(33)SCF
show cable modem mac 12.2(33)SCF
show cable modem maintenance 12.2(33)SCF
show cable modem offline 12.2(33)SCF
show cable modem phy 12.2(33)SCF
show cable modem primary channel 12.2(33)SCF
show cable modem qos service-class 12.2(33)SCF
show cable modem registered 12.2(33)SCF
show cable modem rogue 12.2(33)SCF
show cable modem summary 12.2(33)SCF
show cable modem type 12.2(33)SCF
how cable modem unregistered 12.2(33)SCF
show cable modem vendor 12.2(33)SCF
show cable modem wideband 12.2(33)SCF
show cable multicast db 12.2(33)SCF
show cable modem 12.2(33)SCE4
show cable modem service-flow 12.2(33)SCF2
show cable service-class 12.2(33)SCF2
show cable mac-domain cgd-associations 12.2(33)SCG
show cable mac-domain 12.2(33)SCG
downstream-service-group
show cable modem qos 12.2(33)SCG
show cable modem wideband 12.2(33)SCG
Cisco IOS CMTS Cable Command Reference
CBL-1296 OL-15510-15
Cable Commands: show cable m through show cable u
show cable mac-domain cable forwarding
show cable mac-domain cable forwarding
To display all the interfaces (wideband and modular) and statistics belonging to the Mac domain, use the
show cable mac-domain cable forwarding command in privileged EXEC mode.
show cable mac-domain cable slot/subslot/port forwarding
Syntax Description slot Specifies the chassis slot number of the cable interface line card. Valid
values are 5 to 8.
subslot Specifies the secondary slot number of the cable interface line card. Valid
subslots are 0 or 1.
port Specifies the port number. Valid values are 0 to 4 (depending on the cable
interface).
forwarding Displays the forwarding statistics for the cable line cards.
Command Default No default behavior or values.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.3(23)BC This command was introduced.
12.2(33)SCA This command is integrated in Cisco IOS Release 12.2(33)SCA.
Usage Guidelines The show cable mac-domain cable forwarding command does not support wideband and modular
interfaces. However, if wideband and modular interfaces belong to the Mac domain, the interfaces are
listed in the output with the interface state.
Starting with Cisco IOS Release 12.2(33)SCF, for a chassis loaded with the UBR-MC20X20V or
uBR-MC3GX60V line cards, and legacy uBR-MC5X20 line cards, the show cable mac-domain cable
forwarding command shall not display the legacy downstream information for the UBR-MC20X20V
and the uBR-MC3GX60V line cards.
Examples The following is sample output of the show cable mac-domain cable forwarding command on the
cable interface at 8/0/0:
Router# show cable mac-domain cable 8/0/0 forwarding
Interface Output Interface Reserved/ Interface
Name Packets Rate Bandwidth Reservable State
(bytes) (bits/sec) (Kbps) Bandwidth
------------------------------------------------------------------------------
Ca8/0/0 201358 0 26000 6500/19500 UP
Mo1/0/0:0 344340 0 4160 1040/3120 UP
Mo1/0/0:1 252132 0 7800 1950/5850 UP
Mo1/0/0:2 252132 0 7800 1950/5850 UP
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1297
Cable Commands: show cable m through show cable u
show cable mac-domain cable forwarding
Wi1/0/0:0 198916 0 7803 1951/5852 UP
Wi1/0/0:1 1152 0 10404 2601/7803 UP
Table 146 describes the significant fields shown in the display.
Table 77 show cable mac-domain cable forwarding Field Descriptions
Field Description
Interface Name The name of the interface belonging to Mac domain.
Output Packets/Rate The cumulative packets output and output rate.
Interface Bandwidth The total interface bandwidth allocated.
Reserved/Reservable Bandwidth The total reserved and available bandwidth.
Interface State Indicates whether the interface is up or down.
Cisco IOS CMTS Cable Command Reference
CBL-1298 OL-15510-15
Cable Commands: show cable m through show cable u
show cable mac-domain cgd-associations
show cable mac-domain cgd-associations
To display a summary of the Channel Grouping Domain (CGD) associations for all cable MAC domains,
use the show cable mac-domain cgd-associations command in privileged EXEC mode.
Cisco uBR10012 Router
show cable mac-domain cable slot/subslot/port cgd-associations
Cisco uBR7225VXR and Cisco uBR7246VXR Routers
show cable mac-domain cable slot/port cgd-associations
Syntax Description cable Identifies the cable interface on the Cisco uBR10012 router.
slot/subslot/port
• slot—Slot where the line card resides. The valid range is from 5 to 8.
• subslot—Subslot where the line card resides. Available slots are 0 or 1.
• port—Downstream controller number on the line card. Valid port values are
from 0 to 4.
cable slot/port Identifies the cable interface on the Cisco uBR7246VXR or Cisco uBR7225VXR
router.
• slot—Slot where the 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.
• port—Downstream port number on the line card. The valid port value is 0 or 1.
Command Default None
Command Modes Privileged EXEC (#)
Command History Release Modification
12.3(23)BC This command was introduced for the Cisco uBR10012 router.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.2(33)SCB. Added
support for Cisco uBR7246VXR and Cisco uBR7225VXR routers.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1299
Cable Commands: show cable m through show cable u
show cable mac-domain cgd-associations
Usage Guidelines The show cable mac-domain cgd-associations command displays the following information for each
cable MAC domain:
• Shared port adapter (SPA) downstream channels that have been added to each MAC domain.
• Upstream channels associated with each SPA downstream channel and the downstream channels of
the integrated cable interface line card.
If the All column in the command output indicates Y, then this indicates that all upstream channels
associated with the line card downstream channels or SPA downstream channels are configured
using the upstream cable connector command. If all upstream channels are not configured, then
this column will not be displayed.
• The SPA downstream channels that are currently active.
A SPA downstream channel is active when the corresponding modular cable interface, which
represents the SPA downstream channel, and its line protocol are up. A SPA downstream channel
that is considered active is an operational primary downstream channel in the cable MAC domain.
Note For more information on Channel Grouping Domains, refer to the Cisco DOCSIS 3.0 Downstream
Solution Design and Implementation Guide, Release 2.0.
Examples Cisco IOS Release 12.3(23)BC
The following is a sample output of the show cable mac-domain cgd-associations command for the
cable interface line card at slot 6, subslot 0, and port 0:
Router# show cable mac-domain cable 6/0/0 cgd-associations
CGD Host SPA DS Channels Upstreams (All) Active Remote DS
Ca6/0/0 Local 1 Y
1/0/0 0-1 0
Cisco IOS Release 12.2(33)SCB
The following is a sample output of the show cable mac-domain cgd-associations command for the
cable interface line card at slot 7, subslot 0, and port 0:
Router# show cable mac-domain Cable7/0/0 cgd-associations
CGD Host Resource DS Channels Upstreams (AllUS) Active Remote DS
Ca7/0/0 7/0/0 0 0
3/1/0 0-2 0
0-2
Cisco IOS Release 12.2(33)SCG
The following example is a sample output of the show cable mac-domain cgd-associations command
for the Cisco uBR-MC3GX60V cable interface line card sharing downstreams with the Cisco
Wideband SPA, in Cisco IOS Release 12.2(33)SCG:
Router# show cable mac-domain cable 8/0/0 cgd-associations
CGD Host Resource DS Channels Upstreams (AllUS) Active Remote DS
Ca8/0/0 1/1/0 0 0-3 Yes
Cisco IOS CMTS Cable Command Reference
CBL-1300 OL-15510-15
Cable Commands: show cable m through show cable u
show cable mac-domain cgd-associations
Table 78 describes the fields shown in the show cable mac-domain cgd-associations command display.
Table 78 show cable cgd-associations Field Descriptions
Field Description
CGD Host MAC domain interface for CGD.
Resource Downstream cable interface line card.
DS Channels Downstream RF channels.
Upstreams (AllUS) Upstream channels in the MAC domain.
Active Remote DS Active downstream channels.
Related Commands Command Description
show cable mac-domain downstream-service-group Displays MAC Domain Downstream Service
Group information for the primary
downstream channel.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1301
Cable Commands: show cable m through show cable u
show cable mac-domain downstream-service-group
show cable mac-domain downstream-service-group
To display MAC Domain Downstream Service Group information for a primary downstream channel,
use the show cable mac-domain downstream-service-group command in privileged EXEC mode.
Cisco uBR7225VXR and Cisco uBR7246VXR Universal Broadband Routers
show cable mac-domain cable slot/port downstream-service-group
Cisco uBR10012 Universal Broadband Router
show cable mac-domain cable slot/subslot/port downstream-service-group
Syntax Description slot Slot where the 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 is from 5 to 8.
subslot The subslot used for the cable interface line card. Valid values are 0 or 1.
port The downstream port used as a primary downstream channel. Valid values
are from 0 to 4 (depending on the cable interface).
Command Default No default behavior or values
Command Modes Privileged EXEC (#)
Command History Release Modification
12.3(21)BC This command was introduced for the Cisco uBR10012 router.
12.3(23)BC This command displays the MAC Domain Downstream Service Group
information for primary downstream channels from the SPA as well as the
Cisco uBR10-MC5X20 line card.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
12.2(33)SCD This command was modified. Support was added for Cisco uBR7225VXR
and Cisco uBR7246VXR routers.
Usage Guidelines Use the show cable mac-domain downstream-service-group command to display MAC Domain
Downstream Service Group (MD-DS-SG) information for the specified primary downstream channel.
For each fiber node, a traditional DOCSIS downstream channel on a Cisco uBR10-MC5X20 cable
interface line card is used to carry MAC management and signaling messages, and the associated
traditional DOCSIS upstream channel is used for return data traffic and signaling. The traditional
DOCSIS downstream channel used in this way for a MAC domain is called the primary downstream
channel.
Cisco IOS CMTS Cable Command Reference
CBL-1302 OL-15510-15
Cable Commands: show cable m through show cable u
show cable mac-domain downstream-service-group
Note Beginning in Cisco IOS Release 12.3(23)BC, either an RF channel from the SPA or a
Cisco uBR10-MC5X20 downstream channel can serve as a primary channel in a fiber node. Changes in
Cisco IOS Release 12.3(23)BC apply to Cisco IOS Release 12.2(33)SCB but do not apply to
Cisco IOS Release 12.2(33)SCA.
Examples The following two examples display show cable mac-domain downstream-service-group output for
the primary downstream channel on the cable interface at slot/subslot/port 5/0/0:
Cisco IOS Release 12.3(21)BC
Router# show cable mac-domain cable5/0/0 downstream-service-group
Primary MD-DS-SG RF
IF Id SPA Chan
C5/0/0 1 1/0/0 0 - 1
Cisco IOS Release 12.3(23)BC
Router# show cable mac-domain cable5/0/0 downstream-service-group
Cable MD-DS-SG RF Local Remote
IF Id SPA Chan Primary Chan Primary Chan
C5/0/0 1 1/0/0 00-01 Yes
In the preceding examples, the MD-DS-SG with ID 1 is used for RF channels 0 and 1 on the Wideband
SPA located in slot/subslot/bay 1/0/0.
Cisco IOS Release 12.2(33)SCB
The following example shows a sample output of the show cable mac-domain
downstream-service-group command for the primary downstream channel on the cable interface at
slot/subslot/port 7/0/0:
Router# show cable mac-domain Cable7/0/0 downstream-service-group
Cable MD-DS-SG RF
IF Id Resource Chan Primary Chan
C7/0/0 1 3/1/0 00-02 0 1 2
7/0/0 00 0
Cisco IOS Release 12.2(33)SCD
The following example shows a sample output of the show cable mac-domain
downstream-service-group command for the primary downstream channel on the cable interface at
slot/port 5/0:
Router# show cable mac-domain cable 5/0 downstream-service-group
Cable MD-DS-SG RF
IF Id Resource Chan Primary Chan
C5/0 1 5/0 00-03 0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1303
Cable Commands: show cable m through show cable u
show cable mac-domain downstream-service-group
Cisco IOS Release 12.2(33)SCG
The following example shows a sample output of the show cable mac-domain
downstream-service-group command for the Cisco uBR-MC3GX60V cable interface line card with
primary downstream channel hosted on the Cisco Wideband SPA, in Cisco IOS Release 12.2(33)SCG:
Router# show cable mac-domain cable 8/0/0 downstream-service-group
Cable MD-DS-SG RF
IF Id Resource Chan Primary Chan
C8/0/0 1 1/1/0 00-03 0
1/3/0 00-03
7/0/0 00-03
8/0/2 00-03
Table 79 describes the fields shown in the show cable mac-domain downstream-service-group
command display.
Table 79 show cable mac-domain downstream-service-group Field Descriptions
Field Description
Cable IF Cable interface.
MD-DS-SG MAC Domain Downstream Service Group.
Resource Downstream cable interface line card.
RF Chan Downstream RF channel.
Primary Chan Primary downstream channel.
Related Commands Command Description
show cable modem Displays information for registered and unregistered cable
modems (including wideband cable modems).
show cable modem wideband Displays information for registered and unregistered wideband
cable modems.
Cisco IOS CMTS Cable Command Reference
CBL-1304 OL-15510-15
Cable Commands: show cable m through show cable u
show cable mac-domain rcc
show cable mac-domain rcc
To display runtime receive channel configuration (RCC) on a cable line card interface, use the show
cable mac-domain rcc command in privileged EXEC mode.
Cisco uBR7225VXR and Cisco uBR7246VXR Universal Broadband Routers
show cable mac-domain cable slot/port rcc
Cisco uBR10012 Universal Broadband Router
show cable mac-domain cable slot/subslot/port rcc
Syntax Description slot Slot where the 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 is from 5 to 8.
subslot Specifies the secondary slot number of the cable interface line card. Valid
subslots are 0 or 1.
port Specifies the port number. Valid values are 0 to 4 (depending on the cable
interface).
Command Default No default behavior or values.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCB This command was introduced.
12.2(33)SCD This command was modified. Support was added for Cisco uBR7225VXR
and Cisco uBR7246VXR routers.
Examples The following is a sample output of the show cable mac-domain rcc command on the cable interface
at slot/subslot/port 8/0/0:
Router# show cable mac-domain cable 8/0/0 rcc
RCC-ID RCP RCs MD-DS-SG CMs WB/RCC-TMPL
1 00 00 00 00 00 2 0 0 WB (101)
2 00 10 00 00 03 3 2 0 RCC-TMPL (1)
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1305
Cable Commands: show cable m through show cable u
show cable mac-domain rcc
The following is a sample output of the show cable mac-domain rcc command on the cable interface
at slot/port 5/0:
Router# show cable mac-domain cable 5/0 rcc
RCC-ID RCP RCs MD-DS-SG CMs WB/RCC-TMPL
1 00 00 00 00 00 3 0 3 WB (25)
Table 80 describes the significant fields shown in the display.
Table 80 show cable mac-domain rcc Field Descriptions
Field Description
RCC-ID RCC index per MAC domain. The RCC ID refers
to the RCC ID output from the show cable modem
wideband command.
RCP The receive channel profile associated with the
RCC object.
RCs Total number of DS channels.
MD-DS-SG Indicates the MAC domain DS service group for
which the RCC is generated.
CM Total number of CMs associated with the RCC
object.
WB/RCC-TMPL Indicates the wideband interface or the RCC
template.
Note A zero value in the RCP or MD-DS-SG field indicates that the RCC is generated directly through a
wideband interface configuration and not through any RCC templates.
Related Commands Command Description
show interface Displays the logical up and down state for each of the configured RF
rf-status channels for a wideband interface.
Cisco IOS CMTS Cable Command Reference
CBL-1306 OL-15510-15
Cable Commands: show cable m through show cable u
show cable mac-domain upstream-service-group
show cable mac-domain upstream-service-group
To display runtime statistics of the MAC domain upstream service group on a cable interface line card,
use the show cable mac-domain upstream-service-group command in privileged EXEC mode.
show cable mac-domain cable slot/subslot/port upstream-service-group
Syntax Description slot Chassis slot number of the cable interface line card. The valid range is from
0 to 8.
subslot Secondary slot number of the cable interface line card. Valid values are 0 or
1.
port Port number. The valid range is from 0 to 4 (depending on the cable
interface).
upstream-service-grou Specifies the upstream service group number.
p
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines This command displays privacy information of a particular CM, identified by its IP address or MAC
address.
Examples The following is a sample output of the show cable mac-domain upstream-service-group command
on the cable interface line card at slot/subslot/port 7/1/0:
Router# show cable mac-domain cable 7/1/0 upstream-service-group
Cable MD 7/1/0
US-SG-ID : 1 US-Chan : U0,1,2,3,4
Primary-DS: 5/1/0:0 US-SG-ID: 1
MDD US-List : U0,1,2,3
MDD Ambiguity : U0,1,2,3
Primary-DS: 3/0/0:0 US-SG-ID: 1
MDD US-List : U0,1,2,3,4
MDD Ambiguity : U0,1,2,3,4
Primary-DS: 3/0/0:1 US-SG-ID: 1
MDD US-List : U0,1,2,3,4
MDD Ambiguity : U0,1,2,3,4
Primary-DS: 3/0/0:2 US-SG-ID: 1
MDD US-List : U0,1,2,3,4
MDD Ambiguity : U0,1,2,3,4
Primary-DS: 3/0/0:3 US-SG-ID: 1
MDD US-List : U0,1,2,3,4
MDD Ambiguity : U0,1,2,3,4
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1307
Cable Commands: show cable m through show cable u
show cable mac-domain upstream-service-group
Table 81 describes the significant fields shown in the display.
Table 81 show cable mac-domain upstream-service-group Field Descriptions
Field Description
US-SG-ID Upstream service group ID.
US-chan Total number of upstream channels on the cable interface line
card.
Primary-DS The primary downstream interface.
MDD US-List MAC management message: MDD TLV type 7 content,
upstream active channel list.
MDD Ambiguity MAC management message: MDD TLV type 8 content,
upstream ambiguity resolution channel list.
Related Commands Command Description
show interface Displays the logical up and down states for each of the configured RF
rf-status channels on a wideband interface.
Cisco IOS CMTS Cable Command Reference
CBL-1308 OL-15510-15
Cable Commands: show cable m through show cable u
show cable metering-status
show cable metering-status
To display information about the most recent successful usage-based billing operation, use the show
cable metering-status command in privileged EXEC mode.
show cable metering-status [verbose]
Syntax Description verbose (Optional) Displays the information in a more readable format.
Command Modes Privileged EXEC
Command History Release Modification
12.3(9a)BC This command was introduced.
12.2(33)SCB SAMIS over Internet Protocol Detail Record (IPDR) was introduced.
Usage Guidelines The show cable metering-status command displays information about the most recent successful
usage-based billing operation. If usage-based billing is configured for File mode, this command displays
the device and file name for the record that was last written. If usage-based billing is configured for
Streaming mode, this command displays the IP address and port number for the external server to which
the billing record was sent.
Note This command displays the status of the last successful billing record operation. If a failure occurred,
the CMTS sends an SNMP trap to the SNMP manager with that information.
Examples The following example shows a typical output for the show cable metering-status command when
usage-based billing is configured to write the billing records to a local file system:
Router# show cable metering-status
destination complete-time
flow cpe status
aggr supp
disk0:R7519-UBR7246-200308-004428 Jun 12 09:33:05 No No success
The following example shows a typical output for the show cable metering-status command when
usage-based billing is configured to stream the billing records to an external server:
Router# show cable metering-status
destination complete-time flow cpe status
aggr supp
10.11.37.2 :1234 Jun 12 09:33:05 No No success
The following example shows a typical output for the verbose form of the show cable metering-status
command:
Router# show cable metering-status verbose
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1309
Cable Commands: show cable m through show cable u
show cable metering-status
Destination : disk0:R7519-UBR7246-20000308-004428
Complete Time : Jun 12 09:33:05
Flow Aggregate : Yes
Cpe list suppression : Yes
Status of last export : success
The following example shows a typical output for the show cable metering-status command when
usage-based billing is configured to use the Internet Protocol Detail Record (IPDR) Exporter to stream
the billing records to an external server:
Router# show cable metering-status
destination complete-time flow cpe status
aggr supp
IPDR_Session1 Jun 12 09:33:05 N/A N/A success
The following example shows a typical output for the verbose form of the show cable metering-status
command when usage-based billing is configured to use the IPDR Exporter to stream the billing records
to an external server:
Router# show cable metering-status verbose
Last export status
Destination : IPDR_Session1
Complete Time : Jun 12 09:36:05
Status of last export : success
The following example shows the error message that is displayed when you enter the show cable
metering-status command but not have enabled usage-based billing:
Router# show cable metering-status
CMTS Metering collection not enabled
The following example shows if the SAMIS report failed, the output displays the details of the failure:
Router# show cable metering-status verbose
Load for five secs: 0%/0%; one minute: 1%; five minutes: 0%
Time source is NTP, .19:24:53.955 PDT Fri Jun 11 2010
Last export status
Destination : 20.1.0.2:5959
Complete Time : Jun11 19:24:40
Flow Aggregate : No
Full records : Yes
Cpe list suppression : No
Source interface : GigabitEthernet0/1
Status of last export : write-error (bulk-data)
Table 82 describes the fields displayed by the show cable metering-status command.
Table 82 show cable metering-status Field Descriptions
Field Description
destination, Destination Destination for the billing records. This is a file system device name
and file name, if records are being written to a local file system, or
an IP address and TCP port number, if records are being streamed
to an external server.
complete_time, Complete Time Date and time when the last billing record was written to a local file
or streamed to an external server.
flow aggr, Flow Aggregate Indicates whether traffic counters are aggregated in the billing
records, so that one total is recorded for the upstream service flows
and downstream service flows for each CM.
Cisco IOS CMTS Cable Command Reference
CBL-1310 OL-15510-15
Cable Commands: show cable m through show cable u
show cable metering-status
Table 82 show cable metering-status Field Descriptions (continued)
Field Description
cpe suppress, CPE list Indicates whether CPE IP addresses are included or suppressed in
suppression the billing records:
• Yes = CPE addresses are suppressed and are not included in the
billing records.
• No = CPE addresses are included in the billing records.
status, Status of last export Indicates the status of the last billing operation:
• success—The billing records were successfully written to the
filesystem (file mode) or transferred to the billing collection
server (streaming mode).
• connect-failed—The CMTS was able to open the proper socket
connection to the server but could not connect to the server.
• data-incomplete—A failure occurred during the file write or the
streaming to the collection server, and the records that were
written might be incomplete.
• disk-full—The billing records could not be written because the
filesystem does not have sufficient free space.
• no-memory—The processor had insufficient memory to collect
the billing records.
• open-failure—The transfer failed because the CMTS could not
open a new file on the filesystem (file mode) or open a socket
to the destination IP address and port (streaming mode).
• unknown—An unknown error occurred.
• write-error (data-type)—The operating system reported an
error when attempting to write the billing records (file mode),
or the send to the destination socket failed (streaming mode).
– The value of data-type could be file-header, file-end,
bulk-data, sflog, bulk-data, ipdr-data, ipdr-sflog, or
ipdr-file.
Related Commands Command Description
cable metering destination Enables usage-based billing and streams the billing records to an
external server.
cable metering filesystem Enables usage-based billing and writes the billing records to a file
on a local file system.
cable metering Enables debugging of usage-based billing operations.
source-interface
snmp-server enable traps cable Enables the sending of Simple Network Management Protocol
(SNMP) traps for cable-related events.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1311
Cable Commands: show cable m through show cable u
show cable modem
show cable modem
To display information for the registered and unregistered CMs, use the show cable modem command
in privileged EXEC mode.
show cable modem [ip-address | mac-address | cable {slot/port | slot/subslot/port} [upstream port
[logical-channel-index]] | name fqdn] queue [verbose] [cm-status]
Cisco IOS Release 12.2(33)SCE and later releases
show cable modem [ip-address | mac-address | cable {slot/cable-interface-index |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn]
[verbose] [cm-status]
Syntax Description ip-address (Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you
specify the IP address for a CPE device behind a CM, information for that
CM is displayed.
mac-address (Optional) MAC address of a specific CM to be displayed. If you specify the
MAC address for a CPE device behind a CM, information for that CM is
displayed.
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.
subslot (Cisco uBR10012 only) Secondary slot number of the cable interface line
card. The valid subslots are 0 or 1.
port Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—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.
upstream port (Optional) Displays information for all CMs using the specified upstream
port. You can specify this option only when displaying information for a
cable interface. The valid range for port begins with 0 and ends with a value
that depends on the number of upstream ports supported by the cable
interface line card.
Cisco IOS CMTS Cable Command Reference
CBL-1312 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem
name fqdn (Optional) Specifies the fully qualified domain name (FQDN) of the cable
device to be displayed. This option is only available if the show cable
modem domain-name command has been run for the first time to update the
cable DNS cache on the CMTS router.
verbose Displays detailed information for the CMs.
cm-status Displays CM status events.
queue Displays the downstream hierarchical queueing framework (HQF) queue
information for a cable modem.
logical-channel-index (Optional) Logical channel index. The valid values are 0 or 1.
Command Modes Privileged EXEC (#)
Command History This table includes the following release-specific history entries:
• BC Release
• C Release
• E Release
• N Release
• SC Release
• T Release
• X Release
BC Release Modification
12.2(15)BC1 Additional lines were added to the show cable modem verbose displays,
for one or all cable modems, to show information about the dynamic
shared-secret feature. Cable modems that fail the dynamic secret
authentication checks and then come online are marked with an exclamation
point (!), so that this situation can be investigated.
12.2(4)BC1 Support was added for the Cisco uBR10012 router.
12.2(8)BC2 The output for the Online State field was updated for the cable tftp-enforce
command. A pound sign (#) appears next to the state value when a CM was
allowed to come online without attempting to download a DOCSIS
configuration file through the cable interface with the Cisco CMTS.
12.2(15)BC1c The verbose option displays whether dynamic service change requests
(DSX) are allowed from cable modems.
12.2(15)BC2 Two new states—cc(r1) and cc(r2)—have been added to the CM MAC state
field (see Table 101) to indicate the CM status when it has been instructed
to change channels and is ranging to obtain a new downstream or upstream
channel.
Also, three new states—online(pkd), online(ptd), and expire(pkd)—were
added to clarify the BPI state when network access has been disabled in the
CM’s DOCSIS configuration file.
In addition, the show cable modem verbose command now displays the
total amount of time that a CM has been online since last registering.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1313
Cable Commands: show cable m through show cable u
show cable modem
12.3(13a)BC New initialization states were added for the MAC State Field:
• init(d)—The Cisco CMTS has seen DHCPDISCOVER
• init(io)—The Cisco CMTS has seen DHCPOFFER
• init(dr)—The Cisco CMTS has seen DHCPREQUEST
• init(i)—The Cisco CMTS has seen DHCPACK
• init(o)—The Cisco CMTS has seen first TFTP packet for TFTP request
for cable modem configuration file
• init(t)—The Cisco CMTS has seen the TOD request
See Table 101 for additional information.
12.3(21)BC All cable bundles are now automatically converted and configured to be in
a virtual bundle, and standalone cable interfaces must be manually
configured to be in a virtual bundle to operate properly. Previously, new
virtual interface bundles and bundle members required reconfiguration, and
there could also be standalone interfaces not part of a bundle at all.
12.3(23)BC The verbose option displays additional information about the cable modem.
The following fields have been added to the output of this option:
• Host Interface
• Primary Downstream
• Wideband Capable
• Voice Enabled
• DS Change Times
C Release Modification
12.1(4)CX Support was added for the Cisco uBR10012 router.
12.2(15)CX The verbose option displays the sysDescr field for each cable modem, when
the cable modem remote-query command has been configured. Other
fields have also been added to support DOCSIS 2.0 (ATDMA) operation.
E Release Modification
12.1(10)EC1 Adds an exclamation point to CMs that have exceeded the maximum
delay/timing offset specified by the cable map-advance command.
12.1(11b)EC1 The output for the Online State field was updated for the cable tftp-enforce
command. A pound sign (#) appears next to the state value when a CM was
allowed to come online without attempting to download a DOCSIS
configuration file through the cable interface with the Cisco CMTS.
12.1(20)EC1 The three new states—online(pkd), online(ptd), and expire(pkd)—were
added to the Cisco IOS Release 12.1 EC train.
Cisco IOS CMTS Cable Command Reference
CBL-1314 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem
N Release Modification
11.3(5)NA The output was reorganized and the Receive Power field was added.
SC Release Modification
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA, with
the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was
added.
• The name keyword option was added for specifying the fully-qualified
domain name of a CM.
• The output column spacing and headings were changed, including
some of the following changes:
– “BPI Enb” has been changed to “BPI”
– “DIP” output field was added to indicate support of dual IP for both
IPv4 and IPv6 addressing.
• The following new initialization states were added to show
initialization of CMs and CPEs supporting IPv6:
– init6(s)—CMTS router has seen SOLICIT message.
– init6(a)—CMTS router has seen ADVERTISE message.
– init6(r)—CMTS router has seen REQUEST message.
– init6(i)—CMTS router has seen REPLY message.
– init6(o)—CMTS router has seen version 6 TFTP request.
– init6(t)—CMTS router has seen version 6 TOD request.
12.2(33)SCB A new keyword, cm-status, was added to display CM status events.
12.2(33)SCC This command was modified with the following changes:
• The command output displays the CM attribute bitmasks.
• The command output provides basic receive-statistics for all event code
types of the specified CM.
12.2(33)SCD This command was modified. The cm-status keyword was added to display
the CM status events and the queue keyword was added to display
downstream HQF queue information on the Cisco uBR7225VXR and
Cisco uBR7246VXR routers.
12.2(33)SCD2 This command was modified. The command output was modified to display
the cable modems that are in upstream and downstream partial service
mode.
12.2(33)SCE This command was modified. The port parameter was changed to
cable-interface-index.
12.2(33)SCE4 This command was modified. The command output displays online time of
the modem since the last counter reset, along with the total time online.
12.2(33)SCF This command was modified. The logical-channel-index argument was
added. The show cable modem verbose command output was modified to
display the downstream channel information for the cable modems.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1315
Cable Commands: show cable m through show cable u
show cable modem
T Release Modification
2.1(1a)T1 The output of this command was enhanced to show that the Cisco CMTS
has detected an unstable return path for a particular CM and has
compensated with a power adjustment. An asterisk (*) appears in the power
adjustment field for a modem when a power adjustment has been made; an
exclamation point (!) appears when the CM has reached its maximum power
transmit level and cannot increase its power level further.
12.0(7)T The detail option was replaced with the verbose option.
X Release Modification
11.3XA This command was introduced.
12.0(4)XI The output was expanded to show the primary service identifier (SID) and
the customer premises equipment (CPE) count.
12.0(7)XR The output of this command was enhanced to show that the Cisco CMTS
has detected an unstable return path for a particular CM and has
compensated with a power adjustment. An asterisk (*) appears in the power
adjustment field for a modem when a power adjustment has been made; an
exclamation point (!) appears when the CM has reached its maximum power
transmit level and cannot increase its power level further.
Usage Guidelines This command displays information for all CMs, for all CMs attached to a specific CMTS cable
interface, or for a particular CM, identified by its IP address, MAC address, or its domain name. The
output is sorted by the cable interface and the CM MAC address.
Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first
on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable
command.
Tip Several options in the show cable modem command do not pause the screen to display the information
page by page, even if the terminal length command has been used to set the page size of your terminal.
Paging and pausing the display could result in outdated or stale information for CMs, and thus produce
an incorrect snapshot of the current CM state of the system. To capture or review this information, use
your terminal program’s capture buffer to save the information to a file, and then review it offline.
Tip You can also specify the MAC address or IP address for a CPE device, and the Cisco CMTS will display
the information for the CM that is associated with that CPE device in its internal database.
Note If the CPE IP address is no longer associated with a cable modem, the show cable modem command
might not display information about the cable modem. To display the IP address of the CPE device for
the cable modem, use the clear cable host ip-address command to clear the IP address of the modem
from the router database, and then enter the ping docsis mac-address command, which resolves the
MAC address by sending the DOCSIS ping to the CM.
Cisco IOS CMTS Cable Command Reference
CBL-1316 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem
Refer to the following document on Cisco.com for additional information about cable interface bundling
and virtual interface bundling on the Cisco CMTS:
• Cable Interface Bundling and Virtual Interface Bundling on the Cisco CMTS
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy,
the new primary processor after a switchover automatically creates a new database of the online cable
modems. This means that the show cable modem ip-address command might not show a particular cable
modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the
ping ip-address command, and then the show cable modem ip-address command will show the cable
modem. You can also display any particular cable modem by using the show cable modem | include
ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically
synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be
synchronized manually, using the hccp resync command. When a SYNC event command is occurring,
CLI commands might be very slow to respond. In particular, if you enter the show cable modem
command at the same time a SYNC event is occurring, the command might respond produce a blank
display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Operation of the show cable modem Commands with Different Cable Interface Line Cards
The show cable modem commands display the most current information for standard cable interface
line cards. If the card itself is down, the show cable modem commands still show whatever information
is appropriate (such as offline cable modems and flap list information).
The show cable modem commands function slightly different when used on routers that are using
Broadband Processing Engine (BPE) cable interface line cards (such as the Cisco uBR-MC16U/X,
Cisco uBR-MC28U/X, or Cisco uBR10-MC5X20S/U/H). When BPE cards are the only cable interface
cards installed, the show cable modem commands do not display any output until at least one BPE card
is up and communicating with the router processor. If the BPE cards are not yet up, the show cable
modem command does not display any output.
Examples Example of the show cable modem Command Output for all CMs
The following sample output from the show cable modem command shows the default CM displays for
individual CMs.
Router# show cable modem
MAC Address IP Address I/F MAC Prim RxPwr Timing Num BPI
State Sid (db) Offset CPEs Enbld
0010.7b6b.58c1 0.0.0.0 C4/0/U5 offline 5 -0.25 2285 0 yes
0010.7bed.9dc9 0.0.0.0 C4/0/U5 offline 6 -0.75 2290 0 yes
0010.7bed.9dbb 0.0.0.0 C4/0/U5 offline 7 0.50 2289 0 yes
0010.7b6b.58bb 0.0.0.0 C4/0/U5 offline 8 0.00 2290 0 yes
0010.7bb3.fcd1 10.20.113.2 C5/0/U5 online 1 0.00 1624 0 yes
0010.7bb3.fcdd 0.0.0.0 C5/0/U5 init(r1) 2 -20.00 1624 0 no
0010.7b43.aa7f 0.0.0.0 C5/0/U5 init(r2) 3 7.25 1623 0 no
Example of the show cable modem Command for a Specified MAC Address
Router# show cable modem 0010.7bb3.fcd1
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1317
Cable Commands: show cable m through show cable u
show cable modem
MAC Address IP Address I/F MAC Prim RxPwr Timing Num BPI
State Sid (db) Offset CPEs Enbld
0010.7bb3.fcd1 10.20.113.2 C5/0/U5 online 1 0.00 1624 0 Y
Example of the show cable modem Command for all CMs on a Cisco uBR10012 Router
The following shows a typical display for a Cisco uBR10012 router:
Note The asterisk(*) in the Primary SID (Prim Sid) field indicates that the modem has service flows
with zero blaze index in Cisco IOS Release 12.3(23)BC.
In Cisco IOS Release 12.2(33)SCB and later, the asterisk that may appear in the Primary SID
field does not signify anything.
Router# show cable modem
MAC Address IP Address I/F MAC Prim RxPwr Timing Num BPI
State Sid (db) Offset CPE Enb
0010.9507.01db 144.205.151.130 C5/1/0/U5 online(pt) 1 0.25 938 1 N
0080.37b8.e99b 144.205.151.131 C5/1/0/U5 online 2 -0.25 1268 0 N
0002.fdfa.12ef 144.205.151.232 C6/1/0/U0 online(pt) 13 -0.25 1920 1 N
0002.fdfa.137d 144.205.151.160 C6/1/0/U0 online *16 -0.50 1920 1 N
0003.e38f.e9ab 144.205.151.237 C6/1/0/U0 online 3 -0.50 1926 1 N
0003.e3a6.8173 144.205.151.179 C6/1/1/U2 offline *4 0.50 1929 0 N
0003.e3a6.8195 144.205.151.219 C6/1/1/U2 online(pt) 22 -0.50 1929 1 N
0006.28dc.37fd 144.205.151.244 C6/1/1/U2 online(pt) 61 0.00 1925 2 N
0006.28e9.81c9 144.205.151.138 C6/1/1/U2 online(pt) 2 !0.75 1925 1 N
0006.28f9.8bbd 144.205.151.134 C6/1/1/U2 #online 25 -0.25 1924 1 N
0006.28f9.9d19 144.205.151.144 C6/1/1/U2 online(pt) 28 0.25 1924 1 N
0010.7bed.9b6d 144.205.151.228 C6/1/1/U2 online(pt) 59 0.25 1554 1 N
0002.fdfa.12db 144.205.151.234 C7/0/0/U0 online 15 -0.75 1914 1 N
0002.fdfa.138d 144.205.151.140 C7/0/0/U5 online 4 0.00 1917 1 N
0003.e38f.e85b 144.205.151.214 C7/0/0/U5 online 17 *0.25 1919 1 N
0003.e38f.f4cb 144.205.151.238 C7/0/0/U5 online(pt) 16 0.00 !2750 1 N
0003.e3a6.7fd9 144.205.151.151 C7/0/0/U5 online 1 0.25 1922 0 N
0020.4005.3f06 144.205.151.145 C7/0/0/U0 online(pt) 2 0.00 1901 1 N
0020.4006.b010 144.205.151.164 C7/0/0/U5 online(pt) 3 0.00 1901 1 N
0050.7302.3d83 144.205.151.240 C7/0/0/U0 online(pt) 18 -0.25 1543 1 N
00b0.6478.ae8d 144.205.151.254 C7/0/0/U5 online(pt) 44 0.25 1920 21 N
00d0.bad3.c0cd 144.205.151.149 C7/0/0/U5 online 19 0.25 1543 1 N
00d0.bad3.c0cf 144.205.151.194 C7/0/0/U0 online 13 0.00 1546 1 N
00d0.bad3.c0d5 144.205.151.133 C7/0/0/U0 online 12 *0.50 1546 1 N
Example of show cable modem Command When no CMs are Online
The following example shows sample output when the cable interface line cards are up, but no cable
modems are yet online:
Router# show cable modem
MAC Address IP Address I/F MAC Prim RxPwr Timing Num BPI
State Sid (db) Offset CPE Enb
Example of show cable modem Command When no Cable Interface Line Cards are Up
The following example shows sample output when the Cisco CMTS router contains only Broadband
Processing Engine (BPE) cable interface line cards and none of the cable interface line cards are up:
Router# show cable modem
Example of show cable modem verbose Command for a Specified MAC Address
The following example shows sample output for the verbose option for a particular CM:
Cisco IOS CMTS Cable Command Reference
CBL-1318 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem
Router# show cable modem 0010.7bb3.fcd1 verbose
MAC Address : 00C0.7bb3.fcd1
IP Address : 10.20.113.2
Prim Sid : 1
QoS Profile Index : 6
Interface : C5/0/U5
sysDescr : Vendor ABC DOCSIS 2.0 Cable Modem
Upstream Power : 0 dBmV (SNR = 33.25 dBmV)
Downstream Power : 0 dBmV (SNR = ----- dBmV)
Timing Offset : 1624
Initial Timing Offset : 2812
Received Power : 0.25
MAC Version : DOC1.0
Qos Provisioned Mode : DOC1.0
Enable DOCSIS2.0 Mode : Y
Phy Operating Mode : atdma
Capabilities : {Frag=N, Concat=N, PHS=N, Priv=BPI}
Sid/Said Limit : {Max Us Sids=0, Max Ds Saids=0}
Optional Filtering Support : {802.1P=N, 802.1Q=N}
Transmit Equalizer Support : {Taps/Symbol= 0, Num of Taps= 0}
Number of CPE IPs : 0(Max CPEs = 1)
CFG Max-CPE : 1
Flaps : 373(Jun 1 13:11:01)
Errors : 0 CRCs, 0 HCSes
Stn Mtn Failures : 0 aborts, 3 exhausted
Total US Flows : 1(1 active)
Total DS Flows : 1(1 active)
Total US Data : 1452082 packets, 171344434 bytes
Total US Throughput : 0 bits/sec, 0 packets/sec
Total DS Data : 1452073 packets, 171343858 bytes
Total DS Throughput : 0 bits/sec, 0 packets/sec
Active Classifiers : 0 (Max = NO LIMIT)
DSA/DSX messages : reject all
Dynamic Secret : A3D1028F36EBD54FDCC2F74719664D3F
Total Time Online : 16:16
Note The “Number of CPES” field shows the value set for the CM, not the value for the CMTS that is set by
the cable modem max-cpe command. In Cisco IOS Release 12.2(15)BC1 and later releases, the verbose
display also includes information about the dynamic shared-secret feature (see the cable
dynamic-secret command).
Note An asterisk (*) in the Receive Power column indicates that a power adjustment has been made for that
CM. An exclamation point (!) in the Receive Power column indicates that the CM has reached its
maximum power transmit level and cannot increase its power level further. An exclamation point (!) in
the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset
specified by the cable map-advance command.
A pound sign (#) in the MAC State column indicates that the cable tftp-enforce mark-only command
has been used for the CM to attempt a TFTP download of the DOCSIS configuration file before
registering, but the CM did not do so (Cisco IOS Release 12.1(11b)EC1 and Cisco IOS
Release 12.2(8)BC2 or later releases).
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1319
Cable Commands: show cable m through show cable u
show cable modem
Tip The show cable modem command displays the CM timing offset in DOCSIS ticks, while other
commands, such as cable map-advance, display the offset in microseconds. Use the following method
to convert microseconds to DOCSIS ticks: ticks = microseconds*64/6.25.
Example of the Updated show cable modem verbose Command for a Specified MAC Address in Cisco IOS
Release 12.3(23)BC
The following example shows sample output for the verbose option for a particular CM for the Cisco
IOS Release 12.3(23)BC with new output fields:
Router# show cable modem 0000.39b9.ac51 verbose
MAC Address : 0000.39b9.ac51
IP Address : 55.1.176.11
Prim Sid : 7
QoS Profile Index : 5
Host Interface : C8/0/0/U5
Primary Downstream : Mo3/0/1:3 (RfId : 27)
Wideband Capable : N
sysDescr : Toshiba PacketCable 1.0 EMTA ; <<HW_REV: 13.0.0;
VENDOR: Toshiba Corporation; BOOTR: 2.2; SW_REV: 6.1.318; MODEL: PCX3000>>
Upstream Power : 29.00 dBmV (SNR = 16.07 dB)
Downstream Power : 14.90 dBmV (SNR = 34.30 dB)
Timing Offset : 1774
Initial Timing Offset : 1774
Curr US Timing Adjust : 272
Prev US Timing Adjust : 0
Received Power : 0.00 dBmV
MAC Version : DOC1.1
QoS Provisioned Mode : DOC1.0
Enable DOCSIS2.0 Mode : Y
Phy Operating Mode : tdma
Capabilities : {Frag=N, Concat=Y, PHS=N, Priv=}
Sid/Said Limit : {Max US Sids=0, Max DS Saids=0}
Optional Filtering Support : {802.1P=N, 802.1Q=N}
Transmit Equalizer Support : {Taps/Symbol= 0, Num of Taps= 0}
Number of CPE IPs : 0(Max CPE IPs = 17)
CFG Max-CPE : 3
Flaps : 7(Sep 16 20:04:13)
Errors : 0 CRCs, 0 HCSes
Stn Mtn Failures : 0 aborts, 0 exhausted
Total US Flows : 1(1 active)
Total DS Flows : 1(1 active)
Total US Data : 3399 packets, 1956063 bytes
Total US Throughput : 0 bits/sec, 0 packets/sec
Total DS Data : 125 packets, 10704 bytes
Total DS Throughput : 0 bits/sec, 0 packets/sec
Active Classifiers : 0 (Max = NO LIMIT)
CM Upstream Filter Group : 10
DSA/DSX messages : permit all
Voice Enabled : NO
DS Change Times : 0
Total Time Online : 7d22h
Note In Cisco IOS Release 12.3(23)BC, the output for this command does not display information
about dynamic shared secret.
Cisco IOS CMTS Cable Command Reference
CBL-1320 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem
Example of show cable modem Command for a CM or CPE With a Specified IPv6 Address
The following example shows sample output for the show cable modem command for a CM with the
IPv6 address of 2001:ODBA:4321:600:980D:E743:174F:1E48.
Note The IP Address field shows “---” because the IPv6 address is too long for the size of the output field. To
view a complete IPv6 address for a device, use the verbose form of the command.
Router# show cable modem 2001:ODBA:4321:600:980D:E743:174F:1E48
B D
MAC Address IP Address I/F MAC Prim RxPwr Timing Num P I
State Sid (dBmv) Offset CPE I P
0019.474a.ccd0 --- C5/0/1/U0 w-online 38 0.00 1580 0 N
Example of the show cable modem verbose Command Output That Shows CM Attribute Masks in Cisco IOS
Release 12.2(33)SCC
The following example shows the sample output for the verbose option for a particular CM in Cisco IOS
Release 12.2(33)SCC:
Router# show cable modem 001a.c3ff.ce9e verbose
MAC Address : 0019.474a.d396
IP Address : 10.10.2.4
IPv6 Address : ---
Dual IP : N
Prim Sid : 1
Host Interface : C5/0/0/U2
MD-DS-SG / MD-US-SG : 1 / N/A
MD-CM-SG : 0x100
Primary Downstream : C5/0/0 (RfId : 240)
Wideband Capable : Y
RCP Index : 2
RCP ID : 00 10 18 33 81
Multi-Transmit Channel Mode : N
Upstream Channel : US2
Ranging Status : sta
Upstream Power (dBmV) : 0.00
Upstream SNR (dB) : 36.12
Received Power (dBmV) : 0.00
Timing Offset (97.6 ns): 1018
Initial Timing Offset : 1018
Rng Timing Adj Moving Avg(0.381 ns): 0
Rng Timing Adj Lt Moving Avg : 0
Rng Timing Adj Minimum : 0
Rng Timing Adj Maximum : 0
Pre-EQ Good : 0
Pre-EQ Scaled : 0
Pre-EQ Impulse : 0
Pre-EQ Direct Loads : 0
Good Codewords rx : 457865
Corrected Codewords rx : 0
Uncorrectable Codewords rx : 0
Phy Operating Mode : tdma
sysDescr :
Downstream Power : 0.00 dBmV (SNR = ----- dB)
MAC Version : DOC2.0
QoS Provisioned Mode : DOC1.1
Enable DOCSIS2.0 Mode : Y
Modem Status : {Modem= online(pt), Security=assign(tek)}
Capabilities : {Frag=Y, Concat=Y, PHS=Y}
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1321
Cable Commands: show cable m through show cable u
show cable modem
Security Capabilities : {Priv=BPI+, EAE=N, Key_len=56}
L2VPN Capabilities : {L2VPN=N, eSAFE=N}
Sid/Said Limit : {Max US Sids=16, Max DS Saids=15}
Optional Filtering Support : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs : 0(Max CPE IPs = 16)
CFG Max-CPE : 1
Flaps : 0()
Errors : 0 CRCs, 0 HCSes
Stn Mtn Failures : 0 aborts, 0 exhausted
Total US Flows : 1(1 active)
Total DS Flows : 1(1 active)
Total US Data : 12937 packets, 1079852 bytes
Total US Throughput : 0 bits/sec, 0 packets/sec
Total DS Data : 6226 packets, 459372 bytes
Total DS Throughput : 0 bits/sec, 0 packets/sec
LB group ID assigned (index) : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID : 0
LB policy ID in config file : 0
LB priority : 0
Tag :
Required DS Attribute Mask : 0x0
Forbidden DS Attribute Mask : 0x0
Required US Attribute Mask : 0x0
Forbidden US Attribute Mask : 0x0
Service Type ID :
Service Type ID in config file :
Active Classifiers : 0 (Max = NO LIMIT)
CM Upstream Filter Group : 0
CM Downstream Filter Group : 0
CPE Upstream Filter Group : 0
CPE Downstream Filter Group : 0
DSA/DSX messages : permit all
Voice Enabled : NO
DS Change Times : 0
Boolean Services : 2
Number of Multicast DSIDs Support : 16
MDF Capability Mode : 0
IGMP/MLD Version : IGMPv2
FCType10 Forwarding Support : N
Features Bitmask : 0x0
Total Time Online : 7d4h18m
CFG Max IPv6 CPE Prefix : 1024 (-1 used)
Example of the show cable modem Command Output for a Cable Modem Operating in the MTC Mode
The following example shows the sample output for the verbose option for a particular CM operating in
the MTC mode in Cisco IOS Release 12.2(33)SCC:
Router# show cable modem 0014.f831.d596 verbose
MAC Address : 001e.6bfa.f02e
IP Address : 30.10.0.6
IPv6 Address : ---
Dual IP : N
Prim Sid : 5
Host Interface : C5/1/0/UB
MD-DS-SG / MD-US-SG : 1 / 1
MD-CM-SG : 0xF0101
Primary Wideband Channel ID : 48
Primary Downstream : Mo3/0/0:0 (RfId : 120)
Wideband Capable : Y
RCP Index : 3
Cisco IOS CMTS Cable Command Reference
CBL-1322 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem
RCP ID : 00 10 00 00 04
Multi-Transmit Channel Mode : Y
Upstream Channel : US1 US2 US3 US4
Ranging Status : sta sta sta sta
Upstream Power (dBmV) : 0.00 0.00 0.00 0.00
Upstream SNR (dB) : 36.12 36.12 36.12 33.1
Received Power (dBmV) : 0.00 1.00 0.00 -0.75
Reported Transmit Power (dBmV) : 45.00 45.00 45.00 54.75
Peak Transmit Power (dBmV) : 51.00 51.00 56.00 56.00
Minimum Transmit Power (dBmV) : 24.00 24.00 21.00 18.00
Timing Offset (97.6 ns): 2312 2281 2282 2282
Initial Timing Offset : 2314 2058 2058 2058
Rng Timing Adj Moving Avg(0.381 ns): 7 4 0 -94
Rng Timing Adj Lt Moving Avg : 63 30 11 -144
Rng Timing Adj Minimum : -512 -256 -256 -512
Rng Timing Adj Maximum : 256 57088 57344 57344
Pre-EQ Good : 0 0 0 0
Pre-EQ Scaled : 0 0 0 0
Pre-EQ Impulse : 0 0 0 0
Pre-EQ Direct Loads : 0 0 0 0
Good Codewords rx : 5012 4996 4992 4990
Corrected Codewords rx : 0 0 0 0
Uncorrectable Codewords rx : 0 0 0 0
Phy Operating Mode : atdma* atdma* tdma* tdma*
sysDescr :
Downstream Power : 0.00 dBmV (SNR = ----- dB)
MAC Version : DOC3.0
QoS Provisioned Mode : DOC1.1
Enable DOCSIS2.0 Mode : Y
Modem Status : {Modem= w-online, Security=disabled}
Capabilities : {Frag=N, Concat=N, PHS=Y}
Security Capabilities : {Priv=, EAE=Y, Key_len=}
L2VPN Capabilities : {L2VPN=N, eSAFE=N}
Sid/Said Limit : {Max US Sids=8, Max DS Saids=24}
Optional Filtering Support : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs : 0(Max CPE IPs = 16)
CFG Max-CPE : 4
Flaps : 0()
Errors : 0 CRCs, 0 HCSes
Stn Mtn Failures : 0 aborts, 0 exhausted
Total US Flows : 2(2 active)
Total DS Flows : 1(1 active)
Total US Data : 6 packets, 1557 bytes
Total US Throughput : 0 bits/sec, 0 packets/sec
Total DS Data : 0 packets, 0 bytes
Total DS Throughput : 0 bits/sec, 0 packets/sec
LB group ID assigned (index) : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID : 0
LB policy ID in config file : 0
LB priority : 0
Tag :
Required DS Attribute Mask : 0x0
Forbidden DS Attribute Mask : 0x0
Required US Attribute Mask : 0x0
Forbidden US Attribute Mask : 0x0
Service Type ID :
Service Type ID in config file :
Active Classifiers : 0 (Max = NO LIMIT)
CM Upstream Filter Group : 0
CM Downstream Filter Group : 0
CPE Upstream Filter Group : 0
CPE Downstream Filter Group : 0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1323
Cable Commands: show cable m through show cable u
show cable modem
DSA/DSX messages : permit all
Voice Enabled : NO
DS Change Times : 0
Boolean Services : 2
Number of Multicast DSIDs Support : 24
MDF Capability Mode : 2
IGMP/MLD Version : IGMPv3
FCType10 Forwarding Support : Y
Features Bitmask : 0x0
Total Time Online : 1d16h
CM Initialization Reason : NO_PRIM_SF_USCHAN
CFG Max IPv6 CPE Prefix : 16 (-1 used)
Note An asterisk (*) in the Phy Operating Mode row indicates the type of PHY-layer modulation that the CM
(operating in the MTC mode) is using: tdma or atdma.
Example of the show cable modem verbose Command Output in Cisco IOS Release 12.2(33)SCE4
The following example shows the sample output for the verbose option for a particular CM in
Cisco IOS Release 12.2(33)SCE4:
Router# show cable modem 001a.c3ff.ce9e verbose
MAC Address : 0014.e84f.1630
IP Address : 50.6.9.4
IPv6 Address : ---
Dual IP : N
Prim Sid : 1
Host Interface : C6/1/0/U0
MD-DS-SG / MD-US-SG : N/A / N/A
MD-CM-SG : 0x2D0000
Primary Downstream : C6/1/0 (RfId : 600)
Wideband Capable : N
RCP Index : 0
RCP ID : 00 00 00 00 00
Downstream Channel DCID RF Channel : 73 6/1/0
Multi-Transmit Channel Mode : N
Upstream Channel : US0
Ranging Status : sta
Upstream Power (dBmV) : 0.00
Upstream SNR (dB) : 31.26
Received Power (dBmV) : 0.50
Timing Offset (97.6 ns): 1237
Initial Timing Offset : 1237
Rng Timing Adj Moving Avg(0.381 ns): 503
Rng Timing Adj Lt Moving Avg : 402
Rng Timing Adj Minimum : 0
Rng Timing Adj Maximum : 1024
Pre-EQ Good : 0
Pre-EQ Scaled : 0
Pre-EQ Impulse : 0
Pre-EQ Direct Loads : 0
Good Codewords rx : 429
Corrected Codewords rx : 0
Uncorrectable Codewords rx : 0
Phy Operating Mode : tdma
sysDescr :
Downstream Power : 0.00 dBmV (SNR = ----- dB)
MAC Version : DOC2.0
QoS Provisioned Mode : DOC1.1
Enable DOCSIS2.0 Mode : Y
Cisco IOS CMTS Cable Command Reference
CBL-1324 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem
Modem Status : {Modem= online, Security=disabled}
Capabilities : {Frag=Y, Concat=Y, PHS=Y}
Security Capabilities : {Priv=, EAE=N, Key_len=}
L2VPN Capabilities : {L2VPN=N, eSAFE=N}
Sid/Said Limit : {Max US Sids=16, Max DS Saids=15}
Optional Filtering Support : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs : 0(Max CPE IPs = 16)
CFG Max-CPE : 1
Flaps : 0()
Errors : 0 CRCs, 0 HCSes
Stn Mtn Failures : 0 aborts, 0 exhausted
Total US Flows : 2(2 active)
Total DS Flows : 2(2 active)
Total US Data : 20 packets, 6786 bytes
Total US Throughput : 0 bits/sec, 0 packets/sec
Total DS Data : 11255 packets, 720320 bytes
Total DS Throughput : 5119 bits/sec, 9 packets/sec
LB group ID assigned (index) : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID : 0
LB policy ID in config file : 0
LB priority : 0
Tag :
Required DS Attribute Mask : 0x0
Forbidden DS Attribute Mask : 0x0
Required US Attribute Mask : 0x0
Forbidden US Attribute Mask : 0x0
Service Type ID :
Service Type ID in config file :
Active Classifiers : 0 (Max = NO LIMIT)
CM Upstream Filter Group : 30
CM Downstream Filter Group : 29
CPE Upstream Filter Group : 1
CPE Downstream Filter Group : 1
DSA/DSX messages : permit all
Voice Enabled : NO
DS Change Times : 0
Boolean Services : 0
Number of Multicast DSIDs Support : 0
MDF Capability Mode : 0
IGMP/MLD Version : IGMPv2
FCType10 Forwarding Support : N
Features Bitmask : 0x0
Total Time Online : 18:53 (18:53 since last counter reset)
!From Cisco IOS Release 12.2(33)SCE4 onwards, the command output shows online time of the
!modem since the last counter reset.
CFG Max IPv6 CPE Prefix : 16 (-1 used)
Example of the show cable modem verbose Command in Cisco IOS Release 12.2(33)SCF
The following is a sample output of the show cable modem verbose command in
Cisco IOS Release 12.2(33)SCF:
Router# show cable modem 10.1.0.2 verbose
MAC Address : 001e.6bfb.0a60
IP Address : 10.1.0.2
IPv6 Address : ---
Dual IP : N
Prim Sid : 43
Host Interface : C7/0/0/UB
MD-DS-SG / MD-US-SG : 1 / 1
MD-CM-SG : 0x3C0101
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1325
Cable Commands: show cable m through show cable u
show cable modem
Primary Wideband Channel ID : 897 (Wi7/0/0:0)
Primary Downstream : In7/0/0:0 (RfId : 720)
Wideband Capable : Y
RCP Index : 3
RCP ID : 00 10 00 00 04
Multi-Transmit Channel Mode : Y
Upstream Channel : US0 US1 US2
Ranging Status : sta sta sta
Upstream SNR (dB) : 33.1 33.1 33.1
Upstream Data SNR (dB) : 22.78 22.78 22.78
Received Power (dBmV) : 0.50 0.00 0.00
Reported Transmit Power (dBmV) : 51.00 51.00 51.00
Peak Transmit Power (dBmV) : 51.00 51.00 51.00
Minimum Transmit Power (dBmV) : 24.00 24.00 24.00
Timing Offset (97.6 ns): 1302 1303 1303
The following example is a sample output of the show cable modem verbose command that displays
the downstream channel information for a specific CM identified by its IP address:
Router# show cable modem 80.62.0.4 verbose
MAC Address : 0018.6832.0eb2
IP Address : 80.62.0.4
IPv6 Address : ---
Dual IP : N
Prim Sid : 13
Host Interface : C6/1/0/U0
MD-DS-SG / MD-US-SG : 3 / N/A
MD-CM-SG : 0x2D0300
Primary Downstream : In6/1/0:0 (RfId : 600)
Wideband Capable : N
RCP Index : 0
RCP ID : 00 00 00 00 00
Downstream Channel DCID RF Channel : 193 6/1/0:0
Multi-Transmit Channel Mode : N
Upstream Channel : US0
Ranging Status : sta
Upstream Power (dBmV) : 0.00
Upstream SNR (dB) : 36.12
Upstream Data SNR (dB) : --
Received Power (dBmV) : 0.00
Timing Offset (97.6 ns): 1192
Initial Timing Offset : 1192
Rng Timing Adj Moving Avg(0.381 ns): -1
Rng Timing Adj Lt Moving Avg : -7
Rng Timing Adj Minimum : -256
Rng Timing Adj Maximum : 0
Pre-EQ Good : 0
Pre-EQ Scaled : 0
Pre-EQ Impulse : 0
Pre-EQ Direct Loads : 0
Good Codewords rx : 42
Corrected Codewords rx : 0
Uncorrectable Codewords rx : 0
Phy Operating Mode : tdma
sysDescr :
Downstream Power : 0.00 dBmV (SNR = ----- dB)
MAC Version : DOC2.0
QoS Provisioned Mode : DOC1.1
Enable DOCSIS2.0 Mode : Y
Modem Status : {Modem= online, Security=disabled}
Capabilities : {Frag=Y, Concat=Y, PHS=Y}
Security Capabilities : {Priv=, EAE=N, Key_len=}
L2VPN Capabilities : {L2VPN=N, eSAFE=N}
Cisco IOS CMTS Cable Command Reference
CBL-1326 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem
Sid/Said Limit : {Max US Sids=16, Max DS Saids=15}
Optional Filtering Support : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs : 0(Max CPE IPs = 16)
CFG Max-CPE : 1
Flaps : 0()
Errors : 0 CRCs, 0 HCSes
Stn Mtn Failures : 0 aborts, 0 exhausted
Total US Flows : 2(2 active)
Total DS Flows : 2(2 active)
Total US Data : 9 packets, 4545 bytes
Total US Throughput : 0 bits/sec, 0 packets/sec
Total DS Data : 9 packets, 3114 bytes
Total DS Throughput : 0 bits/sec, 0 packets/sec
LB group ID assigned (index) : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID : 0
LB policy ID in config file : 0
LB priority : 0
Tag :
Required DS Attribute Mask : 0x0
Forbidden DS Attribute Mask : 0x0
Required US Attribute Mask : 0x0
Forbidden US Attribute Mask : 0x0
Service Type ID :
Service Type ID in config file :
Active Classifiers : 0 (Max = NO LIMIT)
CM Upstream Filter Group : 0
CM Downstream Filter Group : 0
CPE Upstream Filter Group : 0
CPE Downstream Filter Group : 0
DSA/DSX messages : permit all
Voice Enabled : NO
DS Change Times : 0
Boolean Services : 0
Number of Multicast DSIDs Support : 0
MDF Capability Mode : 0
IGMP/MLD Version : IGMPv2
FCType10 Forwarding Support : N
Features Bitmask : 0x0
Total Time Online : 4d14h
CFG Max IPv6 CPE Prefix : 16 (-1 used)
The following example is a sample output of the show cable modem verbose command that displays
the downstream channel information for a specific cable interface:
Router# show cable modem Cable 6/1/0 verbose
MAC Address : 0018.6832.0eb2
IP Address : 80.62.0.4
IPv6 Address : ---
Dual IP : N
Prim Sid : 13
Host Interface : C6/1/0/U0
MD-DS-SG / MD-US-SG : 3 / N/A
MD-CM-SG : 0x2D0300
Primary Downstream : In6/1/0:0 (RfId : 600)
Wideband Capable : N
RCP Index : 0
RCP ID : 00 00 00 00 00
Downstream Channel DCID RF Channel : 193 6/1/0:0
Multi-Transmit Channel Mode : N
Upstream Channel : US0
Ranging Status : sta
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1327
Cable Commands: show cable m through show cable u
show cable modem
Upstream Power (dBmV) : 0.00
Upstream SNR (dB) : 36.12
Upstream Data SNR (dB) : --
Received Power (dBmV) : 0.00
Timing Offset (97.6 ns): 1192
Initial Timing Offset : 1192
Rng Timing Adj Moving Avg(0.381 ns): 0
Rng Timing Adj Lt Moving Avg : 0
Rng Timing Adj Minimum : 0
Rng Timing Adj Maximum : 256
Pre-EQ Good : 0
Pre-EQ Scaled : 0
Pre-EQ Impulse : 0
Pre-EQ Direct Loads : 0
Good Codewords rx : 66
Corrected Codewords rx : 0
Uncorrectable Codewords rx : 0
Phy Operating Mode : tdma
sysDescr :
Downstream Power : 0.00 dBmV (SNR = ----- dB)
MAC Version : DOC2.0
QoS Provisioned Mode : DOC1.1
Enable DOCSIS2.0 Mode : Y
Modem Status : {Modem= online, Security=disabled}
Capabilities : {Frag=Y, Concat=Y, PHS=Y}
Security Capabilities : {Priv=, EAE=N, Key_len=}
L2VPN Capabilities : {L2VPN=N, eSAFE=N}
Sid/Said Limit : {Max US Sids=16, Max DS Saids=15}
Optional Filtering Support : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs : 0(Max CPE IPs = 16)
CFG Max-CPE : 1
Flaps : 1(Mar 22 22:39:59)
Errors : 0 CRCs, 0 HCSes
Stn Mtn Failures : 0 aborts, 1 exhausted
Total US Flows : 2(2 active)
Total DS Flows : 2(2 active)
Total US Data : 2 packets, 1010 bytes
Total US Throughput : 0 bits/sec, 0 packets/sec
Total DS Data : 2 packets, 692 bytes
Total DS Throughput : 0 bits/sec, 0 packets/sec
LB group ID assigned (index) : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID : 0
LB policy ID in config file : 0
LB priority : 0
Tag :
Required DS Attribute Mask : 0x0
Forbidden DS Attribute Mask : 0x0
Required US Attribute Mask : 0x0
Forbidden US Attribute Mask : 0x0
Service Type ID :
Service Type ID in config file :
Active Classifiers : 0 (Max = NO LIMIT)
CM Upstream Filter Group : 0
CM Downstream Filter Group : 0
CPE Upstream Filter Group : 0
CPE Downstream Filter Group : 0
DSA/DSX messages : permit all
Voice Enabled : NO
DS Change Times : 0
Boolean Services : 0
Number of Multicast DSIDs Support : 0
MDF Capability Mode : 0
Cisco IOS CMTS Cable Command Reference
CBL-1328 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem
IGMP/MLD Version : IGMPv2
FCType10 Forwarding Support : N
Features Bitmask : 0x0
Total Time Online : 1d2h33m
CFG Max IPv6 CPE Prefix : 16 (-1 used)
MAC Address : 0018.6832.069e
IP Address : 80.62.0.3
IPv6 Address : ---
Dual IP : N
Prim Sid : 15
Host Interface : C6/1/0/U0
MD-DS-SG / MD-US-SG : 3 / N/A
MD-CM-SG : 0x2D0300
Primary Downstream : In6/1/0:0 (RfId : 600)
Wideband Capable : N
RCP Index : 0
RCP ID : 00 00 00 00 00
Downstream Channel DCID RF Channel : 193 6/1/0:0
Multi-Transmit Channel Mode : N
Upstream Channel : US0
Ranging Status : sta
Upstream Power (dBmV) : 0.00
Upstream SNR (dB) : 36.12
Upstream Data SNR (dB) : --
Received Power (dBmV) : 0.50
Timing Offset (97.6 ns): 1196
Initial Timing Offset : 1196
Rng Timing Adj Moving Avg(0.381 ns): -39
Rng Timing Adj Lt Moving Avg : -92
Rng Timing Adj Minimum : -256
Rng Timing Adj Maximum : 0
Pre-EQ Good : 0
Pre-EQ Scaled : 0
Pre-EQ Impulse : 0
Pre-EQ Direct Loads : 0
Good Codewords rx : 54
Corrected Codewords rx : 0
Uncorrectable Codewords rx : 0
Phy Operating Mode : tdma
sysDescr :
Downstream Power : 0.00 dBmV (SNR = ----- dB)
MAC Version : DOC2.0
QoS Provisioned Mode : DOC1.1
Enable DOCSIS2.0 Mode : Y
Modem Status : {Modem= online, Security=disabled}
Capabilities : {Frag=Y, Concat=Y, PHS=Y}
Security Capabilities : {Priv=, EAE=N, Key_len=}
L2VPN Capabilities : {L2VPN=N, eSAFE=N}
Sid/Said Limit : {Max US Sids=16, Max DS Saids=15}
Optional Filtering Support : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs : 0(Max CPE IPs = 16)
CFG Max-CPE : 1
Flaps : 3(Mar 20 09:22:20)
Errors : 0 CRCs, 0 HCSes
Stn Mtn Failures : 0 aborts, 1 exhausted
Total US Flows : 2(2 active)
Total DS Flows : 2(2 active)
Total US Data : 13 packets, 6565 bytes
Total US Throughput : 0 bits/sec, 0 packets/sec
Total DS Data : 13 packets, 4498 bytes
Total DS Throughput : 0 bits/sec, 0 packets/sec
LB group ID assigned (index) : N/A (N/A)
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1329
Cable Commands: show cable m through show cable u
show cable modem
LB group ID in config file (index) : N/A (N/A)
LB policy ID : 0
LB policy ID in config file : 0
LB priority : 0
Tag :
Required DS Attribute Mask : 0x0
Forbidden DS Attribute Mask : 0x0
Required US Attribute Mask : 0x0
Forbidden US Attribute Mask : 0x0
Service Type ID :
Service Type ID in config file :
Active Classifiers : 0 (Max = NO LIMIT)
CM Upstream Filter Group : 0
CM Downstream Filter Group : 0
CPE Upstream Filter Group : 0
CPE Downstream Filter Group : 0
DSA/DSX messages : permit all
Voice Enabled : NO
DS Change Times : 0
Boolean Services : 0
Number of Multicast DSIDs Support : 0
MDF Capability Mode : 0
IGMP/MLD Version : IGMPv2
FCType10 Forwarding Support : N
Features Bitmask : 0x0
Total Time Online : 6d12h
CFG Max IPv6 CPE Prefix : 16 (-1 used)
The following example is a sample output of the show cable modem verbose command that displays
the downstream channel information for all CMs:
Router# show cable modem verbose
MAC Address : 0006.2854.740b
IP Address : 0.0.0.0
IPv6 Address : ---
Dual IP : N
Prim Sid : 12
QoS Profile Index : 2
Host Interface : C6/1/0/U0
MD-DS-SG / MD-US-SG : 3 / N/A
MD-CM-SG : 0x2D0300
Primary Downstream : In6/1/0:0 (RfId : 600)
Wideband Capable : N
RCP Index : 0
RCP ID : 00 00 00 00 00
Downstream Channel DCID RF Channel : 193 6/1/0:0
Multi-Transmit Channel Mode : N
Upstream Channel :
Ranging Status :
Upstream Power (dBmV) :
Upstream SNR (dB) :
Upstream Data SNR (dB) :
Received Power (dBmV) :
Timing Offset (97.6 ns):
Initial Timing Offset :
Rng Timing Adj Moving Avg(0.381 ns):
Rng Timing Adj Lt Moving Avg :
Rng Timing Adj Minimum :
Rng Timing Adj Maximum :
Pre-EQ Good :
Pre-EQ Scaled :
Pre-EQ Impulse :
Cisco IOS CMTS Cable Command Reference
CBL-1330 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem
Pre-EQ Direct Loads :
Good Codewords rx :
Corrected Codewords rx :
Uncorrectable Codewords rx :
Phy Operating Mode :
sysDescr :
Downstream Power : 0.00 dBmV (SNR = ----- dB)
MAC Version : DOC1.0
QoS Provisioned Mode : DOC1.0
Enable DOCSIS2.0 Mode : Y
Modem Status : {Modem= offline, Security=disabled}
Capabilities : {Frag=N, Concat=N, PHS=N}
Security Capabilities : {Priv=, EAE=N, Key_len=}
L2VPN Capabilities : {L2VPN=N, eSAFE=N}
Sid/Said Limit : {Max US Sids=0, Max DS Saids=0}
Optional Filtering Support : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support : {Taps/Symbol= 0, Num of Taps= 0}
Number of CPE IPs : 0(Max CPE IPs = 16)
CFG Max-CPE : 16
Flaps : 8218(Mar 22 03:17:15)
Errors : 0 CRCs, 0 HCSes
Stn Mtn Failures : 0 aborts, 222 exhausted
Total US Flows : 1(1 active)
Total DS Flows : 1(1 active)
Total US Data : 454 packets, 32291 bytes
Total US Throughput : 0 bits/sec, 0 packets/sec
Total DS Data : 0 packets, 0 bytes
Total DS Throughput : 0 bits/sec, 0 packets/sec
LB group ID assigned (index) : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID : 0
LB policy ID in config file : 0
LB priority : 0
Tag :
Required DS Attribute Mask : 0x0
Forbidden DS Attribute Mask : 0x0
Required US Attribute Mask : 0x0
Forbidden US Attribute Mask : 0x0
Service Type ID :
Service Type ID in config file :
Active Classifiers : 0 (Max = NO LIMIT)
CM Upstream Filter Group : 0
CM Downstream Filter Group : 0
CPE Upstream Filter Group : 0
CPE Downstream Filter Group : 0
DSA/DSX messages : permit all
Voice Enabled : NO
DS Change Times : 0
Boolean Services : 0
Number of Multicast DSIDs Support : 0
MDF Capability Mode : 0
IGMP/MLD Version : IGMPv2
FCType10 Forwarding Support : N
Features Bitmask : 0x0
Total Time Online : 00:00
CFG Max IPv6 CPE Prefix : 16 (-1 used)
MAC Address : 0018.6832.0eb2
IP Address : 80.62.0.4
IPv6 Address : ---
Dual IP : N
Prim Sid : 13
Host Interface : C6/1/0/U0
MD-DS-SG / MD-US-SG : 3 / N/A
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1331
Cable Commands: show cable m through show cable u
show cable modem
MD-CM-SG : 0x2D0300
Primary Downstream : In6/1/0:0 (RfId : 600)
Wideband Capable : N
RCP Index : 0
RCP ID : 00 00 00 00 00
Downstream Channel DCID RF Channel : 193 6/1/0:0
Multi-Transmit Channel Mode : N
Upstream Channel : US0
Ranging Status : sta
Upstream Power (dBmV) : 0.00
Upstream SNR (dB) : 36.12
Upstream Data SNR (dB) : --
Received Power (dBmV) : 0.00
Timing Offset (97.6 ns): 1192
Initial Timing Offset : 1192
Rng Timing Adj Moving Avg(0.381 ns): -1
Rng Timing Adj Lt Moving Avg : -7
Rng Timing Adj Minimum : -256
Rng Timing Adj Maximum : 0
Pre-EQ Good : 0
Pre-EQ Scaled : 0
Pre-EQ Impulse : 0
Pre-EQ Direct Loads : 0
Good Codewords rx : 42
Corrected Codewords rx : 0
Uncorrectable Codewords rx : 0
Phy Operating Mode : tdma
sysDescr :
Downstream Power : 0.00 dBmV (SNR = ----- dB)
MAC Version : DOC2.0
QoS Provisioned Mode : DOC1.1
Enable DOCSIS2.0 Mode : Y
Modem Status : {Modem= online, Security=disabled}
Capabilities : {Frag=Y, Concat=Y, PHS=Y}
Security Capabilities : {Priv=, EAE=N, Key_len=}
L2VPN Capabilities : {L2VPN=N, eSAFE=N}
Sid/Said Limit : {Max US Sids=16, Max DS Saids=15}
Optional Filtering Support : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs : 0(Max CPE IPs = 16)
CFG Max-CPE : 1
Flaps : 0()
Errors : 0 CRCs, 0 HCSes
Stn Mtn Failures : 0 aborts, 0 exhausted
Total US Flows : 2(2 active)
Total DS Flows : 2(2 active)
Total US Data : 9 packets, 4545 bytes
Total US Throughput : 0 bits/sec, 0 packets/sec
Total DS Data : 9 packets, 3114 bytes
Total DS Throughput : 0 bits/sec, 0 packets/sec
LB group ID assigned (index) : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID : 0
LB policy ID in config file : 0
LB priority : 0
Tag :
Required DS Attribute Mask : 0x0
Forbidden DS Attribute Mask : 0x0
Required US Attribute Mask : 0x0
Forbidden US Attribute Mask : 0x0
Service Type ID :
Service Type ID in config file :
Active Classifiers : 0 (Max = NO LIMIT)
CM Upstream Filter Group : 0
Cisco IOS CMTS Cable Command Reference
CBL-1332 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem
CM Downstream Filter Group : 0
CPE Upstream Filter Group : 0
CPE Downstream Filter Group : 0
DSA/DSX messages : permit all
Voice Enabled : NO
DS Change Times : 0
Boolean Services : 0
Number of Multicast DSIDs Support : 0
MDF Capability Mode : 0
IGMP/MLD Version : IGMPv2
FCType10 Forwarding Support : N
Features Bitmask : 0x0
Total Time Online : 4d14h
CFG Max IPv6 CPE Prefix : 16 (-1 used)
Example of the show cable modem Command Output on the Cisco uBR7225VXR and Cisco uBR7246VXR Routers
The following example shows the sample output for the cm-status option in
Cisco IOS Release 12.2(33)SCD on a Cisco uBR7246VXR router:
Router# show cable modem cm-status
I/F MAC Address Event TID Count Error Dups Time
C5/0 001e.6bfb.29a6 Seq out-of-range 1 1 0 1 Jan 18 09:00:19
C7/0 001c.ea2b.79b2 MDD timeout 0 0 1 0 Jan 11 11:29:22
QAM failure 0 0 1 0 Jan 11 11:29:02
MDD recovery 0 0 1 0 Jan 11 11:30:20
QAM recovery 0 0 1 0 Jan 11 11:30:13
C7/0 001c.ea2b.78b0 MDD timeout 0 0 1 0 Jan 11 11:29:16
QAM failure 0 0 1 0 Jan 11 11:28:53
MDD recovery 0 0 1 0 Jan 11 11:29:59
QAM recovery 0 0 1 0 Jan 11 11:29:46
The following example shows the sample output of the queue option for a particular CM in
Cisco IOS Release 12.2(33)SCD:
Router# show cable modem 40.3.192.2 queue
* idx/gqid Len/Limit Deqs Drops CIR MIR/PR ForwInt SFID
pkts pkts pkts kbps kbps
BE Queues:
3/43 0/128 103 0 0 0/0 In5/1:1 Ca5/1:22
CIR Queues:
Low Latency Queues:
Example of the show cable modem Command Output for Partial Service Mode
The following example shows the sample output of the show cable modem command that displays the
cable modems that are in upstream (indicated by “p” under I/F) and downstream partial service mode
(indicated by “p-online” under MAC State):
Router# show cable modem
D
MAC Address IP Address I/F MAC Prim RxPwr Timing Num I
State Sid (dBmv) Offset CPE P
0016.9252.9ac0 2.99.81.4 C7/0/0/U0 online(pt) 1 0.00 1332 0 N
000f.2172.229d 2.99.81.36 C7/0/0/U3 online(pt) 2 0.50 1778 0 N
001e.6bfb.33a0 2.99.81.14 C7/0/0/p p-online(pt) 3 -0.50 1424 0 N
0022.cef4.3d9a 2.99.81.23 C7/0/0/p p-online(pt) 4 0.00 1438 0 N
0019.474a.c456 2.99.81.18 C7/0/0/U3 online(pt) 5 0.00 1336 0 N
001e.6bfb.194e 2.99.81.32 C7/0/0/p p-online(pt) 6 -0.50 1422 0 N
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1333
Cable Commands: show cable m through show cable u
show cable modem
00e0.6f8b.a888 2.99.81.31 C7/0/0/U3 online(pt) 7 0.50 1427 0 N
001e.6bfb.1538 2.99.81.38 C7/0/0/p p-online(pt) 8 0.00 1423 0 N
001e.6bfb.0d22 2.99.81.29 C7/0/0/p p-online(pt) 9 0.00 1738 0 N
001e.6bfb.1a7e 2.99.81.30 C7/0/0/p p-online(pt) 10 0.00 1738 0 N
0019.474a.c418 2.99.81.75 C7/0/0/U1 online(pt) 11 0.00 1335 0 N
001e.6bfa.f58a 2.99.81.9 C7/0/0/p p-online(pt) 12 0.00 1737 0 N
0022.cef4.3fa2 2.99.81.24 C7/0/0/p p-online(pt) 13 0.00 1438 0 N
001e.6bfb.1b72 2.99.81.10 C7/0/0/p p-online(pt) 14 -0.50 1425 0 N
0019.474a.c330 2.99.81.34 C7/0/0/U0 online(pt) 15 0.00 1028 0 N
0023.be50.e578 2.99.81.17 C7/0/0/UB p-online(pt) 16 0.00 1805 0 N
0025.2e2d.784a 2.99.81.28 C7/0/0/UB p-online(pt) 17 0.50 1798 0 N
0025.2e2d.748c 2.99.81.26 C7/0/0/UB p-online(pt) 18 0.00 1798 0 N
001e.6bfa.f070 2.99.81.37 C7/0/0/U3 online(pt) 20 0.50 1735 0 N
0019.474a.c422 2.99.81.20 C8/0/0/U1 online(pt) 1 0.50 1340 0 N
0019.474a.c466 2.99.81.21 C8/0/0/U1 online(pt) 2 0.00 1334 0 N
001e.6bfb.2e96 2.99.81.33 C8/0/0/UB w-online(pt) 3 0.00 1738 0 N
Table 83 describes the significant fields shown in the display:
Table 83 show cable modem Field Descriptions
Field Description
MAC Address MAC address for the CM.
IP Address IP address that the DHCP server has assigned to the CM.
IPv6 Address IPv6 address that the DHCP server has assigned to the CM.
Dual IP Support of dual IP for both IPv4 and IPv6 addressing.
I/F, Interface Cable interface line card providing the upstream for this CM.
sysDescr Vendor and model of the cable modem, as reported by the cable modem. This
field displays a value only when the cable modem remote-query command
is configured.
Upstream Power Upstream and Downstream Power fields are displayed only if the
CM remote-query feature has been enabled using the cable modem
Downstream Power
remote-query command. Upstream Power displays the CM transmit level in
dBmV, and Downstream Power displays the dBmV level received at the CM,
as measured by the CMTS.
MAC State Current state of the MAC layer.
Prim SID Primary SID assigned to this CM.
Host Interface Host interface name.
Primary Wideband Bonding group ID of the wideband interface assigned to the CM.
Channel ID
MD-DS-SG MAC Domain Downstream Service Group, the downstream channels of a
single MAC domain that reach the cable modem.
DSID Downstream Service Identifier.
Primary Downstream Primary downstream channel assigned to the CM.
Wideband Capable Cable modem is wideband-capable or not.
Downstream Channel Downstream channel and channel ID used by a CM.
DCID RF Channel
Multi-Transmit Cable modem is in MTC mode or not.
Channel Mode
Cisco IOS CMTS Cable Command Reference
CBL-1334 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem
Table 83 show cable modem Field Descriptions (continued)
Field Description
Upstream SNR Upstream signal-to-noise ratio (SNR) for a particular cable modem (CM), in
decibels (dB).
Upstream SM MER Upstream station maintenance (SM) modulation error ratio (MER) for a
(dB) particular cable modem, in decibels (dB).
Upstream Data MER Upstream modulation error ratio (MER) for a particular cable modem, in
(dB) decibels (dB). This field is displayed only when RF adaptation is enabled.
RxPwr, Received Average power in dBmV for the upstream channel symbol rate for the CM.
Power With default settings, 0 dBmV is considered optimal, but a range of -1 to 1
dBmV is allowable. When CMs exceed this range, older Cisco IOS releases
supported a drop to as low as -2 dBmV. Recent Cisco IOS releases support a
drop to as low as -4 dBmV.
This field supports a resolution of 0.25 dBmV, but the dB resolution level for
CMs and for the Cisco CMTS are slightly higher—approximately 1.0 and 1.4 dB.
Note An asterisk (*) in the RxPwr column indicates that a power
adjustment has been made for that CM. An exclamation point (!)
indicates that the CM has reached its maximum power transmit level
and cannot increase its power level further.
Timing Offset and Timing offset for the CM, in ticks, as recognized on the CMTS. (A tick, as
Initial Timing Offset used here, is 6.25/64 microseconds.) This is the delay between when a
particular cable modem is scheduled to make a transmission and when the
CMTS actually receives it.
Note An exclamation point (!) in the Timing Offset column indicates that
the CM has exceeded the maximum delay and timing offset specified
by the cable map-advance command.
Note The timing offset shown here is typically smaller than the TX Time
Offset value shown by the show cable modem remote-query
command, because the latter value is the offset as recognized on the
CM (which will include any internal delay between when the CM
software begins the transmission and when the bits actually appear on
the local cable interface).
Reported Transmit Reported Transmit Power level by the cable modem for each upstream
Power (dBmV) channel. This applies only to the cable modems operating in the MTC mode.
Peak Transmit Power This is the maximum transmit power level that the cable modem in the MTC
(dBmV) mode could transmit at for the upstream channel.
Minimum Transmit This is the minimum transmit power level that the cable modem in the MTC
Power (dBmV) mode could transmit at for the upstream channel.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1335
Cable Commands: show cable m through show cable u
show cable modem
Table 83 show cable modem Field Descriptions (continued)
Field Description
Rng Timing Adj A Cisco CMTS router tracking variables to see relative timing offset
Moving Avg(0.381 adjustments.
ns):
Rng Timing Adj Lt
Moving Avg:
Rng Timing Adj
Minimum:
Rng Timing Adj
Maximum:
Pre-EQ Good : Equalizer statistics counter.
Pre-EQ Scaled :
Pre-EQ Impulse:
Pre-EQ Direct Loads
Good Codewords rx Good code words for a particular upstream channel. This counter is reset
during interface reset.
Corrected Codewords Correctable code words for a particular upstream channel. This counter is
rx reset during interface reset.
Uncorrectable Uncorrectable code words for a particular upstream channel. This counter is
Codewords rx reset during interface reset.
sysDescr Identifies the vendor and model of the cable modem, as reported by the cable
modem. This field displays a value only when the cable modem
remote-query.
Num CPEs, CFG Indicates the number of CPE devices for which the CM is providing services.
Max-CPE
Number of CPE IPs Indicates the maximum number of IP addresses assigned to CPE devices
behind this CM, as configured by the cable max-hosts command.
Ver, MAC Version Displays the maximum supported version of DOCSIS that the CM supports
(DOCSIS 1.0, DOCSIS 1.1, DOCSIS 2.0).
QoS Prov, QoS Displays the version of DOCSIS that the CM currently is provisioned for
Provisioned Mode (DOCSIS 1.0, DOCSIS 1.1, DOCSIS 2.0).
Enable DOCSIS 2.0 Indicates that the cable modems are allowed to come online when in
Mode mixed-mode environments such as DOCSIS 1.0 TDMA, DOCSIS 1.1 TDMA
and DOCSIS 2.0 ATDMA. This value is set to Y by default, unless the
TLV 39 has been set to disabled (0) in the CM’s Registration Request
message or in the DOCSIS configuration file.
Phy Operating Mode Indicates the type of PHY-layer modulation that the CM is using: tdma or
atdma. Also indicates the TDMA/ATDMA/SCDA mode that the cable
modem is operating on a specific channel.
Modem Status Indicates the overall modem state and the security state of the primary SID.
BPI Enbld, BPI Indicates whether or not Baseline Privacy Interface (BPI) or BPI Plus (BPI+)
encryption is enabled for the CM.
DIP Dual IP flag. Identifies whether or not (“Y” or “N”) the CM or CPE supports
both IPv4 and IPv6 addressing.
Cisco IOS CMTS Cable Command Reference
CBL-1336 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem
Table 83 show cable modem Field Descriptions (continued)
Field Description
Capabilities Indicates what the CM reported as its capabilities in its Registration Request
message: DOCSIS fragmentation, concatenation, packet header suppression
(PHS), and BPI encryption.
Security Capabilities Indicates the privacy mode used by the CM (BPI or BPI+), early
authentication and encryption (EAE) support, and the Key Length.
Optional Filtering Indicates whether 802.1P or 802.1Q packet filtering is enabled for this CM.
Support
Transmit Equalizer Number of taps being used for transmit equalization.
Support
Flaps Number of flaps reported by this CM, with the date and time of the last flap
within the parentheses.
Errors Number of frame CRC and HCS errors reported for this CM.
Stn Mtn Failures Number of station maintenance (cable keepalive) messages that the CMTS
sent to this CM but did not receive any reply.
Total US Flows Total number of upstream service flows, with the number of active service
flows within the parentheses.
Total DS Flows Total number of downstream service flows, with the number of active service
flows within the parentheses.
Total US Data Total data this CM has transmitted on the upstream, in packets and bytes.
Total US Throughput Calculated throughput for this CM on the upstream, if available.
Total DS Data Total data this CM has received on the downstream, in packets and bytes.
Total DS Throughput Calculated throughput for this CM on the downstream, if available.
Active Classifiers Current number of active classifiers for this CM, with the maximum number
of allowable classifiers for this CM within the parentheses.
CM Required Attribute Indicates the current required attribute-mask value.
CM Forbidden Indicates the current forbidden attribute-mask value.
Attribute
DSA/DSX messages Indicates whether dynamic service changes (DSX) from the cable modem are
permitted (permit all) or disallowed (reject all).
Voice Enabled Indicates whether the CM is voice-enabled.
Number of Multicast Indicates the total number of supported multicast DSIDs.
DSIDs Support
FCType10 Forwarding Indicates FCType10 Forwarding Support.
Support
Dynamic Secret Dynamically-generated shared secret (a 16-byte hexadecimal value) that was
used in the cable modem’s previous registration cycle. If the cable modem is
currently offline, this field shows all zeroes.
Note This field displays a value only when the cable dynamic-secret
command has been used on the CMTS interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1337
Cable Commands: show cable m through show cable u
show cable modem
Table 83 show cable modem Field Descriptions (continued)
Field Description
Total Time Online Amount of time in days, hours, and minutes that this CM has been
continuously online since it last registered with the CMTS. This field begins
incrementing whenever the CM enters one of the online(x) MAC states, and
is reset to 0 whenever the CM enters any other MAC state.
Event Event type.
TID Transaction identifier.
Count Number of valid messages received.
Dups Number of duplicate messages received.
Time Time when last valid event was received.
Len/Limit Pkts Queue length and limit in packets.
Deqs Pkts Dequeue packets.
Drops Pkts Dropped packets.
CIR Kbps Committed information rate.
MIR/PR Kbps Maximum information and peak rate.
Forwint Forwarding interface.
SFID Service flow identifier.
BE Queues Best effort queues.
CIR Queues Committed information rate queues.
Low Latency Queues Low latency queues.
Table 101 shows the possible values for the MAC state field:
Table 84 Descriptions for the MAC State Field 1
MAC State Value Description
Ranging Status Conditions for Devices Using IPv4 Addressing
init(r1) The CM sent initial ranging.
init(r2) The CM is ranging. The CMTS received initial ranging from the Cm and has sent
RF power, timing offset, and frequency adjustments to the CM.
init(rc) Ranging has completed.
Note If a CM appears to be stuck in this state, it could be that the CM is able
to communicate successfully on the cable network, but that the upstream
is at capacity and does not have any additional bandwidth to allow the
CM to finish registration and come online. Either manually move one or
more CMs to other upstreams, or enable load balancing on the upstream
using the cable load-balance group commands.
Baseline Privacy Interface Plus
assign(epk) BPI is enabled and key encryption key (KEK) is assigned.
assign(ept) BPI is enabled and traffic encryption key (TEK) is assigned. The registration
messages will be encrypted.
Cisco IOS CMTS Cable Command Reference
CBL-1338 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem
Table 84 Descriptions for the MAC State Field (continued)1
MAC State Value Description
Registration and Provisioning Status Conditions for Devices Using IPv4 Addressing
If early authentication and encryption is used, the letter ‘s’ is appended to these states to indicate secure
registration.
init(d) The DHCP request was received, as DHCPDISCOVER. This also indicates that
the first IP broadcast packet has been received from the CM.
init(dr) The DHCP request has been sent to the cable modem.
init(i) The cable modem has received the DHCPOFFER reply (DHCPACK) from the
DHCP server that has assigned an IP address to the modem, but the modem has
not yet replied with a DHCPREQUEST message requesting that particular IP
address, nor has it sent an IP packet with that IP address.
Note If a CM appears to be stuck in this state, the CM has likely received the
DHCPOFFER reply from the DHCP server, but this reply might have
contained one or more invalid options for that particular CM.
init(io) The Cisco CMTS has seen the DHCP offer as sent to the cable modem from the
DHCP server that has assigned an IP address to the modem.
init(o) The CM has begun to download the option file (DOCSIS configuration file)
using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP
response. If the CM remains in this state, it indicates that the download has
failed.
init(t) Time-of-day (TOD) exchange has started.
Registration and Provisioning Status Conditions for Devices Using IPv6 Addressing
If early authentication and encryption is used, the letter ‘s’ is appended to these states to indicate secure
registration.
init6(s) The Cisco CMTS router has seen the DHCPv6 SOLICIT message from the CM.
init6(a) The Cisco CMTS router has seen the ADVERTISE message from the DHCPv6
server to the CM.
init6(r) The Cisco CMTS router has seen the REQUEST response from the CM to the
DHCPv6 server.
init6(i) The Cisco CMTS router has seen the REPLY message from the DHCPv6 server
to the CM.
init6(o) The Cisco CMTS router has seen the REQEST message from the CM to the TFTP
server.
init6(t) The Cisco CMTS router has seen the REQUEST message from the CM to the
TOD server.
Non-error Status Conditions
cc(r1) The CM had registered and was online, but has received a Downstream Channel
Change (DCC) or Upstream Channel Change (UCC) request message from the
CMTS. The CM has begun moving to the new channel, and the CMTS has
received the CM’s initial ranging on the new downstream or upstream channel.
At the MAC layer, the CM is considered offline because it is not yet passing
traffic on the new channel, but this state does not trigger the flap-list counters.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1339
Cable Commands: show cable m through show cable u
show cable modem
Table 84 Descriptions for the MAC State Field (continued)1
MAC State Value Description
cc(r2) This state should normally follow cc(r1) and indicates that the CM has finished
its initial ranging on the new channel, and is currently performing continuous
ranging on the new channel. At the MAC layer, the CM is considered offline
because it is not yet passing traffic on the new channel, but this state does not
trigger the flap-list counters.
offline The CM is considered offline (disconnected or powered down).
resetting The CM is being reset and will shortly restart the ranging and registration
process.
online The CM has registered and is enabled to pass data on the network.
online(d) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. The CM does not forward
traffic to or from the CPE devices, but the CMTS can continue to communicate
with the CM using DOCSIS messages and IP traffic (such as SNMP commands).
Note If BPI was enabled in the DOCSIS configuration file sent to the CM,
assume that the CM is using BPI encryption, unless other messages show
that the BPI negotiation and key assignments have failed.
online(pkd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled and
KEK is assigned.
Note This state is equivalent to the online(d) and online(pk) states.
online(ptd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled and
TEK is assigned. BPI encryption is now being performed.
Note This state is equivalent to the online(d) and online(pt) states.
online(pk) The CM registered, BPI is enabled and KEK is assigned.
online(pt) The CM registered, BPI is enabled and TEK is assigned. BPI encryption is now
being performed.
Note If network access was disabled in the DOCSIS configuration file sent to
the CM, the network disabled status takes precedence, and the MAC
status field shows online(d) instead of online(pt) even when BPI
encryption is enabled and operational.
expire(epk) Early authentication and encryption is enabled, KEK was assigned, but the
current KEK expired before the CM could successfully renew a new KEK value.
expire(pkd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled,
KEK was assigned, but the current KEK expired before the CM could
successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pk) states.
expire(ept) Early authentication and encryption is enabled, TEK was assigned, but the
current TEK expired before the CM could successfully renew a new KEK value.
Cisco IOS CMTS Cable Command Reference
CBL-1340 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem
Table 84 Descriptions for the MAC State Field (continued)1
MAC State Value Description
expire(ptd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled,
TEK was assigned, but the current TEK expired before the CM could
successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pt) states.
Error Status Conditions
reject(m) The CM attempted to register but registration was refused due to a bad Message
Integrity Check (MIC) value. This also could indicate that the shared secret in
the DOCSIS configuration file does not match the value configured on the CMTS
with the cable shared-secret command.
In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later
releases, this could also indicate that the cable tftp-enforce command has been
used to require that a CM attempt a TFTP download of the DOCSIS
configuration file before registering, but the CM did not do so.
reject(c) The CM attempted to register, but registration was refused due to a a number of
possible errors:
• The CM attempted to register with a minimum guaranteed upstream
bandwidth that would exceed the limits imposed by the cable upstream
admission-control command.
• The CM has been disabled because of a security violation.
• A bad class of service (COS) value in the DOCSIS configuration file.
• The CM attempted to create a new COS configuration but the CMTS is
configured to not permit such changes.
• The CM failed the timestamp check for its DOCSIS configuration file. (This
could indicate a possible theft-of-service attempt, or a problem with the
synchronization of the clocks on the CM and CMTS.)
reject(epk) Early authentication and encryption is enabled, KEK key assignment is rejected,
and the modem has not been authenticated.
reject(pk) KEK key assignment is rejected, and the modem has not been authenticated.
reject(pkd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI encryption was
not established because KEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pk) states.
reject(ept) Early authentication and encryption is enabled, TEK key assignment is rejected,
and BPI encryption has not been established.
reject(ptd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI encryption was
not established because TEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pt) states.
reject(ts) The CM attempted to register, but registration failed because the TFTP server
timestamp in the CM registration request did not match the timestamp maintained
by the CMTS. This might indicate that the CM attempted to register by replaying
an old DOCSIS configuration file used during a prior registration attempt.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1341
Cable Commands: show cable m through show cable u
show cable modem
Table 84 Descriptions for the MAC State Field (continued)1
MAC State Value Description
reject(ip) The CM attempted to register, but registration failed because the IP address in
the CM request did not match the IP address that the TFTP server recorded when
it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.
reject(na) The CM attempted to register, but registration failed because the CM did not send
a Registration-Acknowledgement (REG-ACK) message in reply to the
Registration-Response (REG-RSP) message sent by the CMTS. A
Registration-NonAcknowledgement (REG-NACK) is assumed.
1. The CM MAC state field can also be retrieved using SNMP by getting the value of the cdxCmtsCmStatusValue object in the
CISCO-DOCS-EXT-MIB.
The following symbols appended to the modem state indicate a special condition:
An exclamation mark (!) indicates that the cable dynamic-secret command is used with either the mark
or reject keyword and the cable modem has failed the dynamic secret authentication check.
An ampersand (&) indicates that the cable modem has registered using a self-signed certificate. This is
inherently not secure and can be avoided by negating the cable privacy
accept-self-signed-certificate command.
A hash sign (#) indicates that the cable modem is using an unknown configuration file. To solve this
problem, use the cable dynamic-secret command with the reject keyword. This will reject
registration for CMs with DOCSIS configuration files.
In Cisco IOS Releases 12.1(20)EC, 12.2(15)BC1, and earlier releases, when
network access is disabled in the DOCSIS configuration file sent to the CM, the
network disabled status takes precedence, and the MAC status field shows
online(d) even if BPI encryption fails.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Related Commands Command Description
cable modem vendor Associates the name of a vendor with its Organizational Unique
Identifier (OUI).
show cable modem access-group Displays the access groups for the CMs on a particular cable
interface.
show cable modem calls Displays displays voice call information for a particular CM,
identified either by its IP address or MAC address.
show cable modem classifiers Displays information about the classifiers for a particular CM.
show cable modem cnr Displays information about the upstream carrier-to-noise ratio
(CNR) for a particular cable modem.
show cable modem connectivity Displays connectivity statistics for one or more CMs.
show cable modem counters Displays downstream and upstream traffic counters for one or
more CMs.
Cisco IOS CMTS Cable Command Reference
CBL-1342 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem
Command Description
show cable modem cpe Displays the CPE devices accessing the cable interface through a
particular CM.
show cable modem Updates the cable-specific DNS cache and display the domain
domain-name name for specified CMs and CPE behind a CM on a Cisco CMTS
router.
show cable modem errors Displays error statistics for one or more CMs.
show cable modem flap Displays flap list statistics for one or more CMs.
show cable modem ipv6 Displays IPv6 information for specified CMs and CPE behind a
CM on a Cisco CMTS router.
show cable modem mac Displays MAC layer information for one or more CMs.
show cable modem maintenance Displays station maintenance (SM) error statistics for one or more
CMs.
show cable modem offline Displays a list of the CMs that are marked as offline with the
Cisco CMTS.
show cable modem partial-mode Displays information about the cable modems that are in upstream
and downstream partial service mode.
show cable modem phy Displays the DOCSIS PHY layer information for one or more
CMs.
show cable modem qos Displays quality of service (QoS) and service flow information for
a particular CM.
show cable modem registered Displays a list of the CMs that are marked as registered with the
Cisco CMTS.
show cable modem Displays information collected by the remote-query feature.
remote-query
show cable modem rf-adapt Displays RF adaptation information for cable modems.
show cable modem summary Displays a summary of CMs on one or more cable interfaces.
show cable modem unregistered Displays a list of the CMs that are marked as unregistered with the
Cisco CMTS.
show cable modem vendor Displays the vendor name or Organizational Unique Identifier
(OUI) for the CMs on each cable interface.
show cable modulation-profile Displays modulation profile group information.
show interface cable modem Displays information about the CMs connected to a particular
cable interface.
show interface cable sid Displays cable interface information.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1343
Cable Commands: show cable m through show cable u
show cable modem access-group
show cable modem access-group
To display the access groups for the CMs on a particular cable interface, use the show cable modem
access-group command in privileged EXEC mode.
Cisco uBR7100 series and Cisco uBR7200 series routers:
show cable modem [ip-address | cable {slot/port | slot/cable-interface-index} [upstream port
[logical-channel-index]] | mac-address] access-group
Cisco uBR10012 routers:
show cable modem cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port
[logical-channel-index]] access-group
Syntax Description ip-address (Optional) Access-group information displayed for the CM with the
specified IP address. (Cisco uBR7100 series and Cisco uBR7200
series routers only.)
mac-address (Optional) Access-group information displayed for the CM with the
specified MAC address. (Cisco uBR7100 series and Cisco uBR7200
series routers only.)
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.
subslot (Cisco uBR10012 only) Secondary slot number of the cable interface
line card. The valid subslots are 0 or 1.
port Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—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.
upstream port (Optional) Displays information for all CMs using this specific
upstream. You can specify this option only when displaying
information for a cable interface. The valid range for port begins with
0 and ends with a value that depends on the number of upstream ports
on the cable interface line card.
Cisco IOS CMTS Cable Command Reference
CBL-1344 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem access-group
logical-channel-index (Optional) Logical channel index. The valid values are 0 or 1.
access-group Displays the access groups for the CMs and their associated hosts and
other customer premises equipment (CPE) devices.
Command Modes Privileged EXEC (#)
Command History Release Modification
11.3XA This command was introduced.
12.2(4)BC1 Support for this command was added for the Cisco uBR10012 router, but
only to display access groups on a per-interface basis.
12.2(33)SCE This command was modified. The port parameter was changed to
cable-interface-index.
12.2(33)SCF This command was modified. The logical-channel-index argument was
added.
Usage Guidelines This command displays information only for CMs. To display information for both CMs and their
associated hosts and other customer premises equipment (CPE) devices, use the show cable device
access-group command. To display information only for hosts, use the show cable host access-group
command.
If an SNMP manager is requesting information about CM or CPE devices at the same time that this
command is given, the command displays the following error message:
No information is available, please try later.
Wait until the SNMP retrieval is done and retry the CLI command.
Note Also see the information about this command’s behavior in a Hot Standby Connection-to-Connection
Protocol (HCCP) configuration.
Examples The following example shows sample output for the show cable modem access-group command on a
Cisco uBR7200 series router for a particular CM:
Router# show cable modem 0010.7bb3.fcd1 access-group
MAC Address IP Address Access-group
0010.7bb3.fcd1 10.20.113.2 34
Upstream Power : 42 dBmV (SNR = 10 dBmV)
Downstream Power : 15 dBmV (SNR = 15 dBmV)
Router#
Note The upstream and downstream power fields will be displayed only if the CM remote-query feature has
been enabled using the cable modem remote-query command.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1345
Cable Commands: show cable m through show cable u
show cable modem access-group
The following example shows sample output for the show cable modem access-group command for a
particular cable interface on a Cisco uBR10012 router:
Router# show cable modem c8/1/0 access-group
MAC Address IP Address Access-group
0050.7366.1243 22.1.1.11 1
0002.b970.0027 23.1.1.10 1
0006.5314.858d 22.1.1.10 N/A
Router#
Table 0-85 describes the fields that are shown in the show cable modem access-group display:
Table 0-85 Descriptions for the show cable modem access-group Fields
Field Description
MAC Address The MAC address for the CM.
IP Address The IP address that the DHCP server has assigned to the CM.
Access-group Displays the access group name or number in use (if any) for this CM.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Related Commands Command Description
cable modem vendor Associates the name of a vendor with its Organizational Unique Identifier
(OUI).
show cable device Displays a list of CMs and their CPE devices, along with their access groups.
access-group
show cable host Displays a list of hosts and other CPE devices, along with their access
access-group groups.
show cable modem Displays information for the registered and unregistered CMs.
show cable modem Displays displays voice call information for a particular CM, identified
calls either by its IP address or MAC address.
show cable modem Displays information about the classifiers for a particular CM.
classifiers
show cable modem Displays information about the upstream carrier-to-noise ratio (CNR) for a
cnr particular cable modem.
show cable modem Displays connectivity statistics for one or more CMs.
connectivity
show cable modem Displays the CPE devices accessing the cable interface through a particular
cpe CM.
show cable modem Displays error statistics for one or more CMs.
errors
show cable modem Displays flap list statistics for one or more cable modems.
flap
Cisco IOS CMTS Cable Command Reference
CBL-1346 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem access-group
Command Description
show cable modem Displays station maintenance (SM) error statistics for one or more cable
maintenance modems.
show cable modem Displays information collected by the remote-query feature.
remote-query
show cable modem Displays RF adaptation information for cable modems.
rf-adapt
show cable Displays modulation profile group information.
modulation-profile
show interface cable Displays information about the CMs connected to a particular cable
modem interface.
show interface cable Displays cable interface information.
sid
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1347
Cable Commands: show cable m through show cable u
show cable modem auth-profile
show cable modem auth-profile
To display the multicast authorization profile, and profile group information for a particular IP address
or MAC address, use the show cable modem auth-profile command in privileged EXEC mode.
show cable modem [ip-address | mac-address] [auth-profile]
Syntax Description ip-address (Optional) IPv4 or IPv6 address of a CM that is displayed. If you specify the
IP address for a CPE device behind a CM, information for that CM is
displayed.
mac-address (Optional) MAC address of a CM that is displayed. You can also specify the
MAC address for a CPE device behind a CM, and information for that CM
will be displayed.
auth-profile (Optional) Displays the multicast authorization profile, and profile group
information.
Command Default None
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines Use this command to display the multicast authorization profile, and the profile group information.
Examples The following sample output of the show cable modem auth-profile command shows the multicast
authorization profile and profile group display for a particular ip-address or mac-address.
Router# show cable modem 30.17.2.23 auth-profile
Multicast Profile Information for 0025.2e34.4377
IP: 30.17.2.121
Multicast Profile Group # : default
Router#
Related Commands Command Description
show cable multicast Displays the list of defined multicast authorization profiles and all CMs
authorization associated with corresponding profiles.
Cisco IOS CMTS Cable Command Reference
CBL-1348 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem auth-profile
Command Description
show cable multicast Displays the entire multicast downstream service identifier (DSID) database
dsid content.
show cable multicast Displays the configuration information for MQoS (Group-Config,
qos Group-QoS-Config, Group-Encryption-Config).
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1349
Cable Commands: show cable m through show cable u
show cable modem calls
show cable modem calls
To display voice call information for a particular CM, use the show cable modem calls command in
privileged EXEC mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] calls
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] calls
Syntax Description ip-address (Optional) IPv4 or IPv6 address of a specific CM to be displayed. If
you specify the IP address for a CPE device behind a CM,
information for that CM is displayed.
mac-address (Optional) MAC address of a specific CM to be displayed. If you
specify the MAC address for a CPE device behind a CM, information
for that CM is displayed.
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.
subslot (Cisco uBR10012 only) Secondary slot number of the cable interface
line card. The valid subslots are 0 or 1.
port Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—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.
upstream port (Optional) Displays information for all CMs using the specified
upstream port. You can specify this option only when displaying
information for a cable interface. The valid range for port begins with
0 and ends with a value that depends on the number of upstream ports
supported by the cable interface line card.
Cisco IOS CMTS Cable Command Reference
CBL-1350 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem calls
logical-channel-index (Optional) Logical channel index. The valid values are 0 or 1.
name fqdn (Optional) Specifies the fully qualified domain name (FQDN) of the
cable device to be displayed. This option is only available if the show
cable modem domain-name command has been run for the first time
to update the cable DNS cache on the CMTS router.
calls Display voice call information for a CM.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.3(13a)BC1 Support for voice call information was added to the show cable modem
command.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA, with
the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was
added.
• The name keyword option was added for specifying the fully-qualified
domain name of a CM.
12.2(33)SCE This command was modified. The port parameter was changed to
cable-interface-index.
12.2(33)SCF This command was modified. The logical-channel-index argument was
added.
Usage Guidelines Using the keyword options, you can display IPv6 information by IP address (IPv4 or IPv6) of a particular
CM, for all CMs associated with a specified cable interface, by MAC address of a CM, or by domain
name of a CM.
Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first
on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable
command.
This command supports PacketCable and PacketCable MultiMedia (PCMM) information. Additional
information for voice call support with PacketCable and PacketCable MultiMedia (PCMM) is available
in the feature document PacketCable and PacketCable Multimedia for the Cisco CMTS available on
Cisco.com:
Examples The following example shows sample output for the default calls option for a particular CM:
Router# show cable modem calls
Cable Modem Call Status Flags:
H: Active high priority calls
R: Recent high priority calls
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1351
Cable Commands: show cable m through show cable u
show cable modem calls
V: Active voice calls (including high priority)
MAC Address IP Address I/F Prim CMCallStatus LatestHiPriCall
Sid (min:sec)
000f.66f8.a121 10.8.130.63 C4/0/U0 175 HV -
Related Commands Command Description
cable modem vendor Associates the name of a vendor with its Organizational Unique Identifier
(OUI).
show cable calls Displays voice call history information and status for the PacketCable
Emergency 911 Services Listing and History feature.
show cable modem Displays information for the registered and unregistered CMs.
show cable modem Displays information about the classifiers for a particular CM.
classifiers
show cable modem Displays information about the upstream carrier-to-noise ratio (CNR) for a
cnr particular cable modem.
show cable modem Displays connectivity statistics for one or more CMs.
connectivity
show cable modem Displays error statistics for one or more CMs.
errors
show cable modem Displays flap list statistics for one or more cable modems.
flap
show cable modem Displays station maintenance (SM) error statistics for one or more cable
maintenance modems.
show cable modem Displays information collected by the remote-query feature.
remote-query
show cable modem Displays RF adaptation information for cable modems.
rf-adapt
show cable Displays modulation profile group information.
modulation-profile
show interface cable Displays information about the CMs connected to a particular cable
modem interface.
show interface cable Displays cable interface information.
sid
Cisco IOS CMTS Cable Command Reference
CBL-1352 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem classifiers
show cable modem classifiers
To display information about the classifiers for a particular CM, use the show cable modem classifiers
command in privileged EXEC mode.
show cable modem {ip-address | mac-address} [name fqdn] classifiers [cache | verbose]
Syntax Description ip-address Specifies the IPv4 or IPv6 address of a specific CM to be displayed. If you
specify the IP address for a CPE device behind a CM, classifier information
for that CM is displayed.
mac-address Displays classifier information for the CM with the specified MAC address.
If you specify the MAC address for a CPE device behind a CM, information
for that CM is displayed.
name fqdn (Optional) Specifies the fully qualified domain name (FQDN) of the cable
device to be displayed. This option is only available if the show cable
modem domain-name command has been run for the first time to update
the cable DNS cache on the CMTS router.
cache (Optional) Displays the classifiers in the cache maintained for each CM.
(This cache is based on IP header field values and speeds up classifier
lookups and reduces per-packet processing overhead.)
verbose (Optional) Displays detailed information for the CM classifiers.
Command Modes Privileged EXEC (#)
Command History Release Modification
11.3 NA This command was introduced.
12.1(4)CX and The number of matches field was added to this command, and the command
12.2(4)BC1 was restricted to display information for a single CM at a time.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA, with
the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was
added.
• The name keyword option was added for specifying the fully-qualified
domain name of a CM.
Usage Guidelines This command displays classifier information for a particular CM, identified either by its IP address,
MAC address, or domain name.
Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first
on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable
command.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1353
Cable Commands: show cable m through show cable u
show cable modem classifiers
Note For information about this command’s behavior in a Hot Standby Connection-to-Connection Protocol
(HCCP) configuration, see the “Operation with Hot Standby Connection-to-Connection Protocol
(HCCP) Configuration” section of the show cable modem command.
Examples The following example shows sample output for the default classifiers option for a particular CM:
Router# show cable modem 10.4.0.81 classifiers
CfrId SFID CM Mac Address Direction State Priority Matches
6431 26120 0000.399f.a44f upstream active 128 -
6429 26054 0000.399f.a44f upstream active 128 -
6432 26121 0000.399f.a44f downstream active 128 1182
6430 26055 0000.399f.a44f downstream active 128 3934
Router#
Table 86 describes the fields that are shown in the show cable modem classifiers display:
Table 86 Descriptions for the show cable modem classifiers Fields
Field Description
CfrID Classifier ID for the classifier that is being displayed.
SFID Service flow ID (SFID) for this classifier.
CM MAC Address MAC address for the CM.
Direction Identifies whether this classifier applies to the downstream or the upstream
direction.
State Classifier activation state: active or inactive.
Priority Classifier rule priority value for this classifier.
Matches Number of packets that have been matched to this service flow.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Related Commands Command Description
cable modem vendor Associates the name of a vendor with its Organizational Unique Identifier
(OUI).
show cable modem Displays information for the registered and unregistered CMs.
show cable modem Displays displays voice call information for a particular CM, identified
calls either by its IP address or MAC address.
show cable modem Displays information about the upstream carrier-to-noise ratio (CNR) for a
cnr particular cable modem.
show cable modem Displays connectivity statistics for one or more CMs.
connectivity
Cisco IOS CMTS Cable Command Reference
CBL-1354 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem classifiers
Command Description
show cable modem Displays error statistics for one or more CMs.
errors
show cable modem Displays flap list statistics for one or more cable modems.
flap
show cable modem Displays station maintenance (SM) error statistics for one or more cable
maintenance modems.
show cable modem Displays information collected by the remote-query feature.
remote-query
show cable Displays modulation profile group information.
modulation-profile
show interface cable Displays information about the CMs connected to a particular cable
modem interface.
show interface cable Displays cable interface information.
sid
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1355
Cable Commands: show cable m through show cable u
show cable modem cnr
show cable modem cnr
To display information about the upstream carrier-to-noise ratio (CNR) or signal-to-noise ratio (SNR)
for a particular cable modem (CM), use the show cable modem command in privileged EXEC mode.
show cable modem {ip-address | mac-address | name fqdn} cnr
Syntax Description ip-address IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP
address for a customer premise equipment (CPE) device behind a CM,
classifier information for that CM is displayed.
mac-address Classifier information for the CM with the specified MAC address. If you
specify the MAC address for a CPE device behind a CM, information for
that CM is displayed.
name fqdn Specifies the fully qualified domain name (FQDN) of the cable device to be
displayed. This option is only available if the show cable modem
domain-name command has been run for the first time to update the cable
domain name system (DNS) cache on the Cisco CMTS router.
Command Modes Privileged EXEC (#)
Command History This table includes the following release-specific history entries:
• BC Release
• CX Release
• SC Release
BC Release Modification
12.2(4)BC2 The command was changed to its current form of show cable modem cnr.
12.2(8)BC2 Support was added for the Cisco uBR-LCP2-MC16S cable interface line
card on the Cisco uBR10012 router.
12.2(11)BC3 Support was added for the Cisco uBR10-MC5X20S cable interface line
cards on the Cisco uBR10012 router.
12.2(15)BC1 If a cable modem is offline, its CNR value is now shown as “-----”.
12.2(15)BC2 Support was added for the Cisco uBR-MC16U/X and
Cisco uBR-MC5X20U cable interface line cards.
12.3(17a)BC2 Support was added for the Cisco uBR-MC5X20H cable interface line card.
Cisco IOS CMTS Cable Command Reference
CBL-1356 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem cnr
CX Release Modification
12.1(7)CX1 This command was introduced (in the form of show cable modem snr) for
Cisco uBR7200 series routers using the Cisco uBR-MC16S cable interface
line card.
12.2(15)CX Support was added for the Cisco uBR-MC28U/X cable interface line cards
on the Cisco uBR7246VXR router.
SC Release Modification
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA, with
the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was
added.
• The name keyword option was added for specifying the fully-qualified
domain name of a CM.
• The following new initialization states were added to show
initialization of CMs and CPEs supporting IPv6:
– init6(s)—Cisco CMTS router has seen SOLICIT message.
– init6(a)—Cisco CMTS router has seen ADVERTISE message.
– init6(r)—Cisco CMTS router has seen REQUEST message.
– init6(i)—Cisco CMTS router has seen REPLY message.
– init6(o)—Cisco CMTS router has seen version 6 TFTP request.
– init6(t)—Cisco CMTS router has seen version 6 TOD request.
12.2(33)SCC The output of this command was modified to show the CNR and SNR
information for multiple upstream connections providing service to a single
CM.
12.2(33)SCF The output of this command was modified to show expected power level,
received carrier power level, and CNR information for all the upstream
channels providing services to a CM. The SNR information is no longer
displayed in the output of this command.
Usage Guidelines The show cable modem cnr command displays information on the current CNR value for cable modems
that are using interfaces on the following cable line cards:
• Cisco uBR-MC16U/X
• Cisco uBR-MC28U/X
• Cisco uBR10-MC5X20S/U/H
• Cisco uBR-E-28U
• Cisco uBR-E-16U
For cable modems on all other interfaces, this command displays information about the current SNR
value of the modem.
In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first
on the route processor (RP) of the Cisco CMTS router before any domain name can be used as part of a
cable command.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1357
Cable Commands: show cable m through show cable u
show cable modem cnr
Starting Cisco IOS Release 12.2(33)SCF, carrier-to-noise plus interference ratio (CNiR [CNR]) can be
measured for all upstream channels irrespective of whether spectrum management is enabled or not for
the upstream channels. Therefore, the output of the show cable modem cnr command displays only the
CNR (CNiR) values for all the upstream channels for a specific cable modem.
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy,
the new primary processor after a switchover automatically creates a new database of the online cable
modems. This means that the show cable modem ip-address cnr command might not show a particular
cable modem until the Cisco CMTS receives IP traffic from that cable modem. You can force IP traffic
by using the ping ip-address command, and then the show cable modem ip-address cnr command will
show the cable modem. You can also display any particular cable modem by using the show cable
modem | include ip-address command.
In addition, when the HCCP redundancy has been configured, the Cisco IOS software automatically
synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be
synchronized manually, using the hccp resync command. When a SYNC event command is occurring,
CLI commands might be very slow to respond. In particular, if you enter the show cable modem
command at the same time a SYNC event is occurring, the command might respond with a blank display,
or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip In Cisco IOS Release 12.1(12)EC, Cisco IOS Release 12.2(8)BC1, and later releases, you can add a
timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Examples The following example is a sample output of the show cable modem cnr command for a CM:
Router# show cable modem 10.20.114.34 cnr
MAC Address IP Address I/F MAC Prim snr/cnr
State Sid (db)
00d0.ba77.7595 10.20.114.34 Cable3/0/U5 online 1 45.00
The following example is a sample output of the show cable modem cnr command after an HCCP
switchover. The CNR value is missing until traffic is sent to the cable modem (in this case using the ping
command).
Router# show cable modem 10.10.10.46 cnr
MAC Address IP Address I/F MAC Prim snr/cnr
State Sid (db)
0002.fd22.aadf 10.10.10.46 C5/1/0/U5 online 1970 -----
Router# ping 10.10.10.46
Router# show cable modem 10.10.10.46 cnr
MAC Address IP Address I/F MAC Prim snr/cnr
State Sid (db)
0002.fd22.aadf 10.10.10.46 C5/1/0/U5 online 1970 42.00
Cisco IOS CMTS Cable Command Reference
CBL-1358 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem cnr
The following example is a sample output of the show cable modem cnr command for all upstream
ports providing service to a specified cable modem in Cisco IOS Release 12.2(33)SCC:
Router# show cable modem 0014.f8c1.fd1a cnr
MAC Address IP Address I/F MAC SID snr/cnr
State (dB)
0014.f8c1.fd1a 10.10.4.1 C5/0/1/U0 online 1 33
001e.6bfb.119a 9.9.9.2 C5/0/1/U1 online 2 33
001e.6bfb.0f9e 9.9.9.3 C5/0/1/U2 online 3 33
0019.474a.d4c4 9.9.9.4 C5/0/1/U3 online 4 33
The following example is a sample output of the show cable modem cnr command for an upstream port
providing service to a specified cable modem in Cisco IOS Release 12.2(33)SCF:
Router# show cable modem 0022.cea4.f0fa cnr
MAC Address IP Address I/F MAC Prim ExPwr RxPwr cnr
State Sid (dBmv) (dBmv) (dB)
0022.cea4.f0fa 10.10.1.62 C8/1/14/U3 w-online 78 0.0 -0.50 23
Table 87 describes the significant fields shown in the display:
Table 87 show cable modem cnr Field Descriptions
Field Description
MAC Address MAC address of the CM.
IP Address IP address that the DHCP server has assigned to the CM.
I/F Cable interface line card providing the upstream for this CM.
MAC State Current state of the MAC layer (see Table 101).
Prim Sid Primary Sid assigned to this CM.
In Cisco IOS Release 12.2(33)SCC, this field is renamed to SID and
represents multiple upstream connections with unique SIDs providing service
to a single CM.
ExPwr (dBmv) Expected carrier power level, in decibel millivolts (dBmv).
RxPwr (dBmv) Received carrier power level, in decibel millivolts (dBmv).
snr/cnr (db) The current upstream CNR or SNR for this particular CM, in decibels (dB).
In Cisco IOS Release 12.2(15)BC1 and later releases, this field shows “-----”
for offline cable modems.
Note You can also use the show controllers cable command to display the
SNR or CNR for a cable interface line card, but this value is only an
estimate because it uses a random sampling of modems to determine
the average for the card at any particular time. The CNR value shown
by the show controllers cable command can therefore appear to
fluctuate compared to the individual values shown by the show cable
modem cnr command.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1359
Cable Commands: show cable m through show cable u
show cable modem cnr
Table 101 shows the possible values for the MAC state field.
Table 88 MAC State Field Descriptions 1
MAC State Value Description
Registration and Provisioning Status Conditions for Devices Using IPv4 Addressing
init(r1) CM sent initial ranging.
init(r2) CM is ranging. The Cisco CMTS received initial ranging from the CM and has
sent RF power, timing offset, and frequency adjustments to the CM.
init(rc) Ranging has completed.
Note If a CM appears to be stuck in this state, it could be that the CM is able
to communicate successfully on the cable network, but that the upstream
is at capacity and does not have any additional bandwidth to allow the
CM to finish registration and come online. Either manually move one or
more CMs to other upstreams, or enable load balancing on the upstream
using the cable load-balance group commands.
init(d) DHCP request was received, as DHCPDISCOVER. This also indicates that the
first IP broadcast packet has been received from the CM.
init(dr) Cable modem has broadcast a DHCP REQUEST packet back to the DHCP
server.
init(i) Cable modem has received the DHCPOFFER reply (DHCPACK) from the
DHCP server that has assigned an IP address to the modem, but the modem has
not yet replied with a DHCPREQUEST message requesting that particular IP
address, nor has it sent an IP packet with that IP address.
Note If a CM appears to be stuck in this state, the CM has likely received the
DHCPOFFER reply from the DHCP server, but this reply might have
contained one or more invalid options for that particular CM.
init(io) Cisco CMTS learns the DHCP offer that is sent to the cable modem from the
DHCP server, which has assigned an IP address to the modem.
init(o) CM has begun to download the option file (DOCSIS configuration file) using the
Trivial File Transfer Protocol (TFTP), as specified in the DHCP response. If the
CM remains in this state, it indicates that the download has failed.
init(t) Time-of-day (ToD) exchange has started.
resetting CM is being reset and will shortly restart the registration process.
Registration and Provisioning Status Conditions for Devices Using IPv6 Addressing
init6(s) Cisco CMTS router learns the DHCPv6 SOLICIT message from the CM.
init6(a) Cisco CMTS router learns the ADVERTISE message from the DHCPv6 server
to the CM.
init6(r) Cisco CMTS router learns the REQUEST response from the CM to the DHCPv6
server.
init6(i) Cisco CMTS router learns the REPLY message from the DHCPv6 server to the
CM.
init6(o) Cisco CMTS router learns the REQUEST message from the CM to the TFTP
server.
Cisco IOS CMTS Cable Command Reference
CBL-1360 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem cnr
Table 88 MAC State Field Descriptions (continued)1
MAC State Value Description
init6(t) Cisco CMTS router learns the REQUEST message from the CM to the ToD
server.
Non-error Status Conditions
cc(r1) CM had registered and was online, but has received a Downstream Channel
Change (DCC) or Upstream Channel Change (UCC) request message from the
Cisco CMTS. The CM has begun moving to the new channel, and the
Cisco CMTS has received the initial ranging of the CM on the new downstream
or upstream channel. At the MAC layer, the CM is considered offline because it
is not yet passing traffic on the new channel, but this state does not trigger the
flap-list counters.
cc(r2) This state should normally follow cc(r1) and indicates that the CM has finished
its initial ranging on the new channel, and is currently performing continuous
ranging on the new channel. At the MAC layer, the CM is considered offline
because it is not yet passing traffic on the new channel, but this state does not
trigger the flap-list counters.
offline CM is considered offline (disconnected or powered down).
online CM has registered and is enabled to pass data on the network.
online(d) CM is registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. The CM does not forward
traffic to or from the CPE devices, but the Cisco CMTS can continue to
communicate with the CM using DOCSIS messages and IP traffic (such as
SNMP commands).
Note If BPI was enabled in the DOCSIS configuration file sent to the CM,
assume that the CM is using BPI encryption unless other messages show
that the BPI negotiation and key assignments have failed.
online(pkd) CM is registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled and
KEK is assigned.
Note This state is equivalent to the online(d) and online(pk) states.
online(ptd) CM is registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled and
TEK is assigned. BPI encryption is now being performed.
Note This state is equivalent to the online(d) and online(pt) states.
online(pk) CM is registered, BPI is enabled and KEK is assigned.
online(pt) CM is registered, BPI is enabled and TEK is assigned. BPI encryption is now
being performed.
Note If network access was disabled in the DOCSIS configuration file sent to
the CM, the network disabled status takes precedence, and the MAC
status field shows online(d) instead of online(pt) even when BPI
encryption is enabled and operational.
Note If an exclamation point (!) appears in front of one of the online states, it indicates that the cable
dynamic-secret command has been used with either the mark or reject option, and that the
cable modem has failed the dynamic secret authentication check.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1361
Cable Commands: show cable m through show cable u
show cable modem cnr
Table 88 MAC State Field Descriptions (continued)1
MAC State Value Description
expire(pk) CM is registered, BPI is enabled, KEK was assigned, but the current KEK
expired before the CM could successfully renew a new KEK value.
expire(pkd) CM is registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled,
KEK was assigned, but the current KEK expired before the CM could
successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pk) states.
expire(pt) CM is registered, BPI is enabled, TEK was assigned, but the current TEK expired
before the CM could successfully renew a new KEK value.
expire(ptd) CM is registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled,
TEK was assigned, but the current TEK expired before the CM could
successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pt) states.
Error Status Conditions
reject(m) CM attempted to register but registration was refused due to a bad Message
Integrity Check (MIC) value. This also could indicate that the shared secret in
the DOCSIS configuration file does not match the value configured on the
Cisco CMTS with the cable shared-secret command.
In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later
releases, this could also indicate that the cable tftp-enforce command has been
used to require that a CM attempt a TFTP download of the DOCSIS
configuration file before registering, but the CM did not do so.
reject(c) CM attempted to register, but registration was refused due to a a number of
possible errors:
• CM attempted to register with a minimum guaranteed upstream bandwidth
that would exceed the limits imposed by the cable upstream
admission-control command.
• CM has been disabled because of a security violation.
• Bad class of service (CoS) value in the DOCSIS configuration file.
• CM attempted to create a new CoS configuration but the Cisco CMTS is
configured to not permit such changes.
• CM failed the timestamp check for its DOCSIS configuration file. (This
could indicate a possible theft-of-service attempt, or a problem with the
synchronization of the clocks on the CM and Cisco CMTS.)
reject(pk) KEK key assignment is rejected, BPI encryption has not been established.
reject(pkd) CM is registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI encryption was
not established because KEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pk) states.
reject(pt) TEK key assignment is rejected, BPI encryption has not been established.
Cisco IOS CMTS Cable Command Reference
CBL-1362 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem cnr
Table 88 MAC State Field Descriptions (continued)1
MAC State Value Description
reject(ptd) CM is registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI encryption was
not established because TEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pt) states.
Note In Cisco IOS Release 12.1(20)EC, Cisco IOS Release 12.2(15)BC1, and earlier releases, when
network access is disabled in the DOCSIS configuration file sent to the CM, the network
disabled status takes precedence, and the MAC status field shows online(d) even if BPI
encryption fails. Use the show cable modem mac-address command to confirm whether BPI
is enabled or disabled for a particular cable modem.
reject(ts) CM attempted to register, but registration failed because the TFTP server
timestamp in the CM registration request did not match the timestamp maintained
by the CMTS. This might indicate that the CM attempted to register by replaying
an old DOCSIS configuration file used during a prior registration attempt.
reject(ip) CM attempted to register, but registration failed because the IP address in the CM
request did not match the IP address that the TFTP server recorded when it sent
the DOCSIS configuration file to the CM. IP spoofing could be occurring.
reject(na) CM attempted to register, but registration failed because the CM did not send a
Registration-Acknowledgement (REG-ACK) message in reply to the
Registration-Response (REG-RSP) message sent by the Cisco CMTS. A
Registration-NonAcknowledgement (REG-NACK) is assumed.
1. The CM MAC state field can also be retrieved using SNMP by getting the value of the cdxCmtsCmStatusValue object in the
CISCO-DOCS-EXT-MIB.
Related Commands Command Description
cable modem vendor Associates the name of a vendor with its Organizational Unique Identifier
(OUI).
show cable modem Displays information for the registered and unregistered CMs.
show cable Displays modulation profile group information.
modulation-profile
show cable modem Displays information collected by the remote-query feature.
remote-query
show controllers cable Displays information about the interface controllers for a cable interface on
the Cisco CMTS router.
show interface cable Displays information about the CMs connected to a particular cable
modem interface.
show interface cable Displays cable interface information.
sid
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1363
Cable Commands: show cable m through show cable u
show cable modem connectivity
show cable modem connectivity
To display connectivity statistics for one or more CMs, use the show cable modem connectivity
command in privileged EXEC mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] connectivity
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn]
connectivity
Syntax Description ip-address (Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you
specify the IP address for a CPE device behind a CM, information for that
CM is displayed.
mac-address (Optional) MAC address of a specific CM to be displayed. If you specify
the MAC address for a CPE device behind a CM, information for that CM
is displayed.
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.
subslot (Cisco uBR10012 only) Secondary slot number of the cable interface line
card. The valid subslots are 0 or 1.
port Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—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.
upstream port (Optional) Displays information for all CMs using this specific upstream.
You can specify this option only when displaying information for a cable
interface. The valid range for port begins with 0 and ends with a value that
depends on the number of upstream ports on the cable interface line card.
Cisco IOS CMTS Cable Command Reference
CBL-1364 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem connectivity
logical-channel-index (Optional) Logical channel index. The valid values are 0 or 1.
name fqdn (Optional) Specifies the fully qualified domain name (FQDN) of the cable
device to be displayed. This option is only available if the show cable
modem domain-name command has been run for the first time to update
the cable DNS cache on the CMTS router.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.1(4)CX and This command was introduced (and the connectivity option was removed
12.2(4)BC1 from the show interface cable sid command).
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA, with
the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was
added.
• The name keyword option was added for specifying the fully-qualified
domain name of a CM.
12.2(33)SCE This command was modified. The port parameter was changed to
cable-interface-index.
12.2(33)SCF This command was modified. The logical-channel-index argument was
added.
Usage Guidelines This command displays connectivity information for all CMs, for all CMs attached to a specific CMTS
cable interface, or for a particular CM, as identified by its IP address or MAC address.
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy,
the new primary processor after a switchover automatically creates a new database of the online cable
modems. This means that the show cable modem ip-address command might not show a particular cable
modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the
ping ip-address command, and then the show cable modem ip-address command will show the cable
modem. You can also display any particular cable modem by using the show cable modem | include
ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically
synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be
synchronized manually, using the hccp resync command. When a SYNC event command is occurring,
CLI commands might be very slow to respond. In particular, if you enter the show cable modem
command at the same time a SYNC event is occurring, the command might respond produce a blank
display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1365
Cable Commands: show cable m through show cable u
show cable modem connectivity
Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first
on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable
command.
Note The show cable modem connectivity command replaces the connectivity option for the show interface
cable sid command, because the connectivity statistics are better managed on a per-modem basis than
on a per-SID basis.
Examples The following example shows sample output for the show cable modem connectivity command for all
online CMs:
Router# show cable modem connectivity
Prim 1st time Times %online Online time Offline time
Sid online Online min avg max min avg max
1 Apr 28 2003 1 99.67 00:00 1d1h9m 1d1h9m 05:38 04:58 05:38
2 Apr 28 2003 1 99.66 00:00 1d1h8m 1d1h8m 05:46 05:02 05:46
3 Apr 28 2003 1 99.69 00:00 1d1h7m 1d1h7m 05:18 04:34 05:18
The following example shows sample output for the show cable modem connectivity command for all
online CMs for a particular cable interface:
Router# show cable modem c8/1/0 connectivity
Prim 1st time Times %online Online time Offline time
Sid online Online min avg max min avg max
1 Apr 28 2003 1 99.67 00:00 1d1h12m 1d1h12m 05:38 04:58 05:38
2 Apr 28 2003 1 99.66 00:00 1d1h11m 1d1h11m 05:46 05:02 05:46
3 Apr 28 2003 1 99.69 00:00 1d1h11m 1d1h11m 05:18 04:34 05:18
The following example shows sample output for the show cable modem connectivity command for a
particular CM:
Router# show cable modem 0010.7bb3.fcd1 connectivity
Prim 1st time Times %online Online time Offline time
Sid online Online min avg max min avg max
1 May 30 2000 4 99.85 48:20 11h34m 1d2h23m 00:01 00:59 03:00
Table 89 describes the information shown in the show cable modem connectivity displays:
Table 89 Descriptions for the show cable modem connectivity Fields
Field Description
Prim SID The primary SID assigned to this CM.
1st time online First time at which the modem with this SID connected.
Times online Number of times the modem with this SID connected.
% online Percentage of time the modem with this SID has been connected.
Cisco IOS CMTS Cable Command Reference
CBL-1366 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem connectivity
Table 89 Descriptions for the show cable modem connectivity Fields (continued)
Field Description
Online time The minimum, average, and maximum number of days, hours, and minutes
the modem with this SID has been connected.
Note A CM is considered online when it has completed the registration
process and has communicated with the DHCP, TFTP, and TOD
servers.
Offline time The minimum, average, and maximum number of days, hours, and minutes
the modem with this SID has been disconnected.
Note A CM is considered offline after it has missed 16 consecutive station
maintenance messages.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Related Commands Command Description
cable modem vendor Associates the name of a vendor with its Organizational Unique Identifier
(OUI).
show cable modem Displays information for the registered and unregistered CMs.
show cable modem Displays displays voice call information for a particular CM, identified
calls either by its IP address or MAC address.
show cable modem Displays information about the upstream carrier-to-noise ratio (CNR) for a
cnr particular cable modem.
show cable modem Displays flap list statistics for one or more cable modems.
flap
show cable modem Displays station maintenance (SM) error statistics for one or more cable
maintenance modems.
show cable modem Displays information collected by the remote-query feature.
remote-query
show cable modem Displays RF adaptation information for cable modems.
rf-adapt
show cable Displays modulation profile group information.
modulation-profile
show interface cable Displays information about the CMs connected to a particular cable
modem interface.
show interface cable Displays cable interface information.
sid
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1367
Cable Commands: show cable m through show cable u
show cable modem counters
show cable modem counters
To display downstream and upstream traffic counters for one or more cable modems (CMs), use the
show cable modem counters command in privileged EXEC mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] counters
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn]
counters
Syntax Description ip-address (Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you
specify the IP address for a CPE device behind a CM, information for that
CM is displayed.
mac-address (Optional) MAC address of a specific CM to be displayed. If you specify the
MAC address for a CPE device behind a CM, information for that CM is
displayed.
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.
subslot (Cisco uBR10012 only) Secondary slot number of the cable interface line
card. The valid subslots are 0 or 1.
port Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—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 IOS CMTS Cable Command Reference
CBL-1368 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem counters
upstream port (Optional) Displays information for all CMs using the specified upstream
port. You can specify this option only when displaying information for a
cable interface. The valid range for port begins with 0 and ends with a value
that depends on the number of upstream ports supported by the cable
interface line card.
logical-channel-index (Optional) Logical channel index. The valid values are 0 or 1.
name fqdn (Optional) Specifies the fully qualified domain name (FQDN) of the cable
device to be displayed. This option is only available if the show cable
modem domain-name command has been run for the first time to update the
cable DNS cache on the CMTS router.
counters Displays downstream and upstream traffic counters for one or more cable
modems.
Defaults Displays counter information for all CMs.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.1(4)CX and This command was introduced.
12.2(4)BC1
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA, with
the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was
added.
• The name keyword option was added for specifying the fully-qualified
domain name of a CM.
12.2(33)SCE This command was modified. The port parameter was changed to
cable-interface-index.
12.2(33)SCF This command was modified. The logical-channel-index argument was
added.
Usage Guidelines Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy,
the new primary processor after a switchover automatically creates a new database of the online cable
modems. This means that the show cable modem ip-address command might not show a particular cable
modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the
ping ip-address command, and then the show cable modem ip-address command will show the cable
modem. You can also display any particular cable modem by using the show cable modem | include
ip-address command.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1369
Cable Commands: show cable m through show cable u
show cable modem counters
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically
synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be
synchronized manually, using the hccp resync command. When a SYNC event command is occurring,
CLI commands might be very slow to respond. In particular, if you enter the show cable modem
command at the same time a SYNC event is occurring, the command might respond produce a blank
display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first
on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable
command.
Examples The following example shows sample output for the show cable modems counters command for all
CMs:
Router# show cable modem counters
MAC Address US Packets US Bytes DS Packets DS Bytes
0050.7366.1243 29 2126 29 2126
0002.b970.0027 1811 116174 29 2126
0006.5314.858d 329154 21071059 134607 9961268
Router#
The following example shows sample output for the show cable modems counters command for all
CMs on a particular cable interface:
Router# show cable modem c8/1/0 counters
MAC Address US Packets US Bytes DS Packets DS Bytes
0050.7366.1243 29 2126 29 2126
0002.b970.0027 1811 116174 29 2126
0006.5314.858d 329154 21071059 134607 9961268
Router#
The following example shows sample output for the show cable modems counters command for a
particular CM, as identified by its MAC address:
Router# show cable modem 0010.7bb3.fcd1 counters
MAC Address US Packets US Bytes DS Packets DS Bytes
0010.7bb3.fcd1 1452082 171344434 1452073 171343858
Router#
The following example shows sample output for the show cable modems counters command for a
particular CM, as identified by its IP address:
Router# show cable modem 23.1.1.10 counters
Cisco IOS CMTS Cable Command Reference
CBL-1370 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem counters
MAC Address US Packets US Bytes DS Packets DS Bytes
0002.b970.0027 1811 116174 29 2126
Router#
Table 90 describes the fields shown in the show cable modem counters displays:
Table 90 Descriptions for the show cable modem counters Fields
Field Description
MAC Address MAC address for the CM.
US Packets Number of packets this CM has transmitted on the upstream.
US Bytes Number of bytes this CM has transmitted on the upstream.
DS Packets Number of packets this CM has received on the downstream.
DS Bytes Number of byte this CM has received on the downstream.
Related Commands Command Description
show cable modem Displays information for the registered and unregistered CMs.
show cable modem Displays the access groups for the CMs on a particular cable interface.
access-group
show cable modem Displays displays voice call information for a particular CM, identified
calls either by its IP address or MAC address.
show cable modem Displays information about the classifiers for a particular CM.
classifiers
show cable modem Displays connectivity statistics for one or more CMs.
connectivity
show cable modem Displays the CPE devices accessing the cable interface through a particular
cpe CM.
show cable modem Displays quality of service (QoS) and service flow information for a
qos particular CM.
show cable modem Displays a list of the CMs that are marked as registered with the
registered Cisco CMTS.
show cable modem Displays information collected by the remote-query feature.
remote-query
show cable modem Displays RF adaptation information for cable modems.
rf-adapt
show cable modem Displays a list of the CMs that are marked as unregistered with the
unregistered Cisco CMTS.
show interface cable Displays information about the CMs connected to a particular cable
modem interface.
show interface cable Displays cable interface information.
sid
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1371
Cable Commands: show cable m through show cable u
show cable modem cpe
show cable modem cpe
To display the customer premise equipment (CPE) devices accessing the cable interface through a
particular cable modem (CM), use the show cable modem cpe command in privileged EXEC mode.
show cable modem {ip-address | mac-address | name fqdn} cpe
Syntax Description ip-address Displays the CPE devices for the CM with the specified IPv4 or IPv6
address.
mac-address Displays the CPE devices for the CM with the specified MAC address.
name fqdn (Optional) Specifies the fully qualified domain name (FQDN) of the cable
device to be displayed. This option is only available if the show cable
modem domain-name command has been run for the first time to update
the cable DNS cache on the CMTS router.
Command Modes Privileged EXEC (#)
Command History Release Modification
11.3XA This command was introduced.
12.1(4)CX and The command was simplified to display only the IP and MAC addresses for
12.2(4)BC1 the CPE devices.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA, with
the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM device was added.
• The name keyword option was added for specifying the fully-qualified
domain name of a CM.
Usage Guidelines This command lists the CPE devices that are accessing the cable network through a particular CM. You
can identify the CM either by its IP address or by its MAC address.
Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first
on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable
command.
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy,
the new primary processor after a switchover automatically creates a new database of the online cable
modems. This means that the show cable modem ip-address command might not show a particular cable
modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the
Cisco IOS CMTS Cable Command Reference
CBL-1372 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem cpe
ping ip-address command, and then the show cable modem ip-address command will show the cable
modem. You can also display any particular cable modem by using the show cable modem | include
ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically
synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be
synchronized manually, using the hccp resync command. When a SYNC event command is occurring,
CLI commands might be very slow to respond. In particular, if you enter the show cable modem
command at the same time a SYNC event is occurring, the command might respond produce a blank
display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Examples The following example shows sample output for the show cable modem cpe command, listing the CPE
devices by their MAC and IP addresses:
Router# show cable modem 0019.474a.c14a cpe
IP address MAC address Dual IP
50.3.37.3 0005.0052.2c1d Y
Table 100 describes the significant fields shown in the display.
Table 91 show cable modem cpe Field Descriptions
Field Description
IP Address IP address acquired by the CPE.
MAC Address MAC address of the CPE.
Dual IP Dual IP flag. Identifies whether or not (“Y” or “N”) the CPE
supports both IPv4 and IPv6 addressing.
Related Commands Command Description
cable modem vendor Associates the name of a vendor with its Organizational Unique Identifier
(OUI).
show cable modem Displays information for the registered and unregistered CMs.
show cable modem Displays displays voice call information for a particular CM, identified
calls either by its IP address or MAC address.
show cable modem Displays information about the classifiers for a particular CM.
classifiers
show cable modem Displays information about the upstream carrier-to-noise ratio (CNR) for a
cnr particular cable modem.
show cable modem Displays connectivity statistics for one or more CMs.
connectivity
show cable modem Displays error statistics for one or more CMs.
errors
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1373
Cable Commands: show cable m through show cable u
show cable modem cpe
Command Description
show cable modem Displays flap list statistics for one or more cable modems.
flap
show cable modem Displays station maintenance (SM) error statistics for one or more cable
maintenance modems.
show cable modem Displays information collected by the remote-query feature.
remote-query
show cable Displays modulation profile group information.
modulation-profile
show interface cable Displays information about the CMs connected to a particular cable
modem interface.
show interface cable Displays cable interface information.
sid
Cisco IOS CMTS Cable Command Reference
CBL-1374 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem docsis device-class
show cable modem docsis device-class
To display the DOCSIS device-class information for cable modems (CMs) on all or specified cable
interfaces and upstreams, use the show cable modem docsis device-class command in privileged EXEC
configuration mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem docsis device-class [summary [cable slot/subslot [cable slot/subslot]
[upstream port1 port2]]] [total]
show cable modem cable slot/subslot docsis version summary
Cisco uBR10012 Router
show cable modem docsis device-class [summary [cable slot/subslot/port [cable
slot/subslot/port] [upstream port1 port2]]] [total]
show cable modem cable slot/subslot/port docsis version summary
Syntax Description summary (Optional) Displays a summary of DOCSIS device class information for
CMs on all or specified cable interfaces on the CMTS router.
cable slot/subslot (Optional) Specifies a single cable interface, or a range of cable interfaces
[cable slot/subslot] on a Cisco uBR7100 or Cisco uBR7200 series router, whose CMs you want
to display information about, where:
• slot—Specifies the chassis slot number of the cable interface line card.
• subslot—Specifies the downstream port number.
Valid values for these arguments are dependent on your CMTS router and
cable interface line card. Refer to the hardware documentation for your
router chassis and cable interface line card for supported slot and port
numbering.
cable slot/subslot/port (Optional) Specifies a single cable interface, or a range of cable interfaces
[cable slot/subslot/port] on a Cisco uBR10012 router, whose CMs you want to display information
about, where:
• slot—Specifies the chassis slot number of the cable interface line card.
Valid slots are 5 to 8.
• subslot—Specifies the secondary slot number of the cable interface line
card. Valid subslots are 0 or 1.
• port—Specifies the downstream port number. Valid ports are 0 to 4,
depending on the cable interface line card.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1375
Cable Commands: show cable m through show cable u
show cable modem docsis device-class
upstream port1 port2 (Optional) Specifies a specific upstream port, or a range of upstream ports
on the specified cable interface(s), whose CMs you want to display
information about, where:
• port1—Specify only port1 if you want to display information about a
single upstream. When used with the port2 argument, specifies the
beginning of a range of upstream ports, and port1 must be a
lower-numbered port than port2.
• port2—Specifies the end of a range of upstream ports, and port2 must
be a higher-numbered port than port1.
total (Optional) Displays a total of DOCSIS device-class information for the CMs
connected to all interfaces, or to the specified cable interfaces.
Command Default The default form of the command (show cable modem docsis device-class without any options)
provides DOCSIS device class information for all CMs on the CMTS router.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.3(21)BC This command was introduced.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines This command displays a summary of DOCSIS device-class information for all CMs for a single cable
interface, or for a range of cable interfaces, and optionally specified upstreams on those cable interfaces.
Examples The following example shows typical output for the default form of the show cable modem docsis
device-class command on a Cisco uBR100012 router:
Router# show cable modem docsis device-class
MAC Address I/F MAC Prim Reg Device Class Reg
State Sid Ver -------------------- Priv
0030.80bc.22b9 C3/0/U0 online(pt) 1 1.0 CM BPI
0000.cadb.04b2 C3/0/U0 online(pt) 2 1.1 eCM eMTA BPI+
0000.cadb.0512 C3/0/U0 online(pt) 3 1.1 eCM eMTA eSTB BPI+
0003.e38f.f5c7 C3/0/U1 online(pt) 4 1.0 CM BPI
0000.cadb.0bae C3/0/U1 online(pt) 5 1.1 eCM ePS BPI+
0010.7b6b.77ed C3/0/U2 online 6 1.0 CM
0000.cadb.0356 C4/0/U0 online(pt) 1 1.1 eCM eMTA BPI+
0000.cadb.02a6 C4/0/U0 init(d) 2 n/a <unavailable>
0000.cadb.2f7a C4/0/U1 online(pt) 3 2.0 eCM eSTB BPI+
0000.cadb.2952 C4/0/U2 online(pt) 4 1.1 eCM eSTB ePS BPI+
0000.cadb.0236 C4/0/U2 init(d) 6 n/a <unavailable>
0003.e3a6.850d C4/0/U3 online(pt) 7 1.1 eCM eMTA ePS BPI+
0003.e3a6.85ad C4/0/U3 online(pt) 8 1.0 CM BPI
Cisco IOS CMTS Cable Command Reference
CBL-1376 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem docsis device-class
The following example shows sample output for the show cable modem docsis device-class command
for a particular cable interface, in chassis slot 3 and subslot 0:
Router# show cable modem cable3/0 docsis device-class
MAC Address I/F MAC Prim Reg Device Class Reg
State Sid Ver -------------------- Priv
0030.80bc.22b9 C3/0/U0 online(pt) 1 1.0 CM BPI
0000.cadb.04b2 C3/0/U0 online(pt) 2 1.1 eCM eMTA BPI+
0000.cadb.0512 C3/0/U0 online(pt) 3 1.1 eCM eMTA eSTB BPI+
0003.e38f.f5c7 C3/0/U1 online(pt) 4 1.0 CM BPI
0000.cadb.0bae C3/0/U1 online(pt) 5 1.1 eCM ePS BPI+
0010.7b6b.77ed C3/0/U2 online 6 1.0 CM
Table 92 show cable modem docsis device-class Field Descriptions
Field Description
MAC Address The MAC address of the CM.
I/F The cable interface line card providing the upstream for this CM.
MAC State The current state of the MAC layer.
Prim Sid The primary SID assigned to this CM.
Reg Ver Displays the maximum supported version of DOCSIS that the CM supports. The
possible values are: DOCSIS 1.0, DOCSIS 1.1, DOCSIS 2.0, and DOCSIS 3.0.
Shows “n/a” if the modem is not online.
Device Class Displays the device-class information for the PacketCable device. The modem
can report its device-class type during registration. The possible values are:
• CM or eCM—A standalone cable modem or embedded CM.
• ePS—Embedded Portal Services
• eMTA—Embedded Multimedia Terminal Adapter
• eSTB—Embedded Set Top Box
• unavailable—The CM has not reported its device class.
Reg Priv Indicates whether Baseline Privacy Interface (BPI) or BPI Plus (BPI+)
encryption is enabled for the CM.
Examples for Summary and Total Options
The following example shows the corresponding display for the show cable modem docsis device-class
total command:
Router# show cable modem docsis device-class total
Online unrep CM eCM eMTA eSTB ePS
Total: 13 2 4 7 4 3 3
The following example shows sample output for the show cable modem docsis device-class summary
form of the command on a Cisco CMTS router:
Router# show cable modem docsis device-class summary
DOCSIS Device Class
----------------------------
Interface Online unrep CM eCM eMTA eSTB ePS
Cable3/0/U0 3 0 1 2 2 1 0
Cable3/0/U1 2 0 1 1 0 0 1
Cable3/0/U2 1 0 1 0 0 0 0
Cable4/0/U0 2 1 0 1 1 0 0
Cable4/0/U1 1 0 0 1 0 1 0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1377
Cable Commands: show cable m through show cable u
show cable modem docsis device-class
Cable4/0/U2 2 1 0 1 0 1 1
Cable4/0/U3 2 0 1 1 1 0 1
The following example shows sample output for the show cable modem docsis device-class summary
command with the total option on a Cisco CMTS router:
Router# show cable modem docsis device-class summary total
DOCSIS Device Class
----------------------------
Interface Online unrep CM eCM eMTA eSTB ePS
Cable3/0/U0 3 0 1 2 2 1 0
Cable3/0/U1 2 0 1 1 0 0 1
Cable3/0/U2 1 0 1 0 0 0 0
Cable4/0/U0 2 1 0 1 1 0 0
Cable4/0/U1 1 0 0 1 0 1 0
Cable4/0/U2 2 1 0 1 0 1 1
Cable4/0/U3 2 0 1 1 1 0 1
Total: 13 2 4 7 4 3 3
The following example shows sample output for the show cable modem docsis device-class summary
total command for all enabled upstreams on a specific cable interface line card on a Cisco CMTS router:
Router# show cable modem docsis device-class summary cable 3/0 total
DOCSIS Device Class
----------------------------
Interface Online unrep CM eCM eMTA eSTB ePS
Cable3/0/U0 3 0 1 2 2 1 0
Cable3/0/U1 2 0 1 1 0 0 1
Cable3/0/U2 1 0 1 0 0 0 0
Total: 6 0 3 3 2 1 1
The following example shows sample output for the show cable modem docsis device-class summary
total command for a range of interfaces on a Cisco CMTS router:
Router# show cable modem docsis device-class summary cable 3/0 cable 4/0 total
DOCSIS Device Class
----------------------------
Interface Online unrep CM eCM eMTA eSTB ePS
Cable3/0/U0 3 0 1 2 2 1 0
Cable3/0/U1 2 0 1 1 0 0 1
Cable3/0/U2 1 0 1 0 0 0 0
Cable4/0/U0 2 1 0 1 1 0 0
Cable4/0/U1 1 0 0 1 0 1 0
Cable4/0/U2 2 1 0 1 0 1 1
Cable4/0/U3 2 0 1 1 1 0 1
Total: 13 2 4 7 4 3 3
The following example shows sample output for the show cable modem docsis device-class summary
total command for a range of interfaces and upstreams on a CMTS router:
Router# show cable modem docsis device-class summary cable 3/0 cable 4/0 upstream 0 2
total
DOCSIS Device Class
----------------------------
Interface Online unrep CM eCM eMTA eSTB ePS
Cable3/0/U0 3 0 1 2 2 1 0
Cable3/0/U1 2 0 1 1 0 0 1
Cable3/0/U2 1 0 1 0 0 0 0
Cable4/0/U0 2 1 0 1 1 0 0
Cable4/0/U1 1 0 0 1 0 1 0
Cisco IOS CMTS Cable Command Reference
CBL-1378 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem docsis device-class
Cable4/0/U2 2 1 0 1 0 1 1
Total: 11 2 3 6 3 3 2
The following example shows sample output for the show cable modem docsis device-class summary
total command for a range of upstreams on an interface:
Router# show cable modem docsis device-class summary cable3/0 upstream 0 1 total
DOCSIS Device Class
----------------------------
Interface Online unrep CM eCM eMTA eSTB ePS
Cable3/0/U0 3 0 1 2 2 1 0
Cable3/0/U1 2 0 1 1 0 0 1
Total: 5 0 2 3 2 1 1
The following example shows sample output for the show cable modem docsis device-class summary
command for all enabled upstreams on a specific cable interface line card:
Router# show cable modem cable3/0 docsis device-class summary
DOCSIS Device Class
----------------------------
Interface Online unrep CM eCM eMTA eSTB ePS
Cable3/0/U0 3 0 1 2 2 1 0
Cable3/0/U1 2 0 1 1 0 0 1
Cable3/0/U2 1 0 1 0 0 0 0
Total: 6 0 3 3 2 1 1
Table 93 show cable modem docsis device-class summary Field Descriptions
Field Description
Interface Name of the cable interface and associated upstreams on the Cisco CMTS router.
Online Total number of CMs currently online on this cable interface.
unrep Total number of CMs on this interface for which the device-class information is
unreported or unavailable.
CM Total number of CMs on this interface that have a reported device class as a
standalone cable modem.
eCM Total number of CMs on this interface that have reported the device class as an
embedded cable modem.
eMTA Total number of CMs on this interface that have reported the device class as an
embedded multimedia terminal adapter.
eSTB Total number of CMs on this interface that have reported the device class as an
embedded set-top box.
ePS Total number of CMs on this interface that have reported the device class as
embedded portal services.
Total The total number of all CMs reported online and for a given DOCSIS device class
across all cable interfaces on the Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1379
Cable Commands: show cable m through show cable u
show cable modem docsis device-class
Related Commands Command Description
show cable modem Displays the DOCSIS version information for CMs on one or more cable
docsis version interfaces and upstreams.
Cisco IOS CMTS Cable Command Reference
CBL-1380 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem docsis version
show cable modem docsis version
To display the DOCSIS version information for cable modems (CMs) on one or more cable interfaces
and upstreams, use the show cable modem docsis version command in privileged EXEC configuration
mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem docsis version [summary [cable {slot/port | slot/cable-interface-index} [cable
{slot/port | slot/cable-interface-index}] [upstream port1 port2 [logical-channel-index]]]]
[total]
show cable modem cable {slot/port | slot/cable-interface-index} docsis version summary
Cisco uBR10012 Router
show cable modem docsis version [summary [cable {slot/subslot/port |
slot/subslot/cable-interface-index} [cable {slot/subslot/port |
slot/subslot/cable-interface-index}] [upstream port1 port2 [logical-channel-index]]]] [total]
show cable modem cable {slot/subslot/port | slot/subslot/cable-interface-index} docsis version
summary
Syntax Description summary (Optional) Displays a summary of DOCSIS device class information for
CMs on all or specified cable interfaces on the CMTS router.
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.
subslot (Cisco uBR10012 only) Secondary slot number of the cable interface line
card. The valid subslots are 0 or 1.
port Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—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 IOS CMTS Cable Command Reference
OL-15510-15 CBL-1381
Cable Commands: show cable m through show cable u
show cable modem docsis version
upstream port1 port2 (Optional) Specifies a specific upstream port, or a range of upstream ports
on the specified cable interface(s), whose cable modems you want to display
information about, where:
• port1—Specify only port1 if you want to display information about a
single upstream. When used with the port2 argument, specifies the
beginning of a range of upstream ports, and port1 must be a
lower-numbered port than port2.
• port2—Specifies the end of a range of upstream ports, and port2 must
be a higher-numbered port than port1.
logical-channel-index (Optional) Logical channel index. The valid values are 0 or 1.
total (Optional) Displays a total of DOCSIS device-class information for the CMs
connected to all interfaces, or to the specified cable interfaces.
docsis version Displays the DOCSIS version information for cable modems on one or more
summary cable interfaces and upstreams.
Command Default The default form of the command (show cable modem docsis version without any options) provides
DOCSIS version information for all CMs on the CMTS router.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.3(23)BC This command was introduced.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.2(33)SCB.
12.3(23)BC7 The output for the show cable modem docsis version summary total forms
of the command were modified.
12.2(33)SCD2 This command was modified. The command output was modified to display
the cable modems that are in upstream and downstream partial service mode.
12.2(33)SCE This command was modified. The port parameter was changed to
cable-interface-index.
12.2(33)SCF This command was modified. The logical-channel-index argument was
added.
Usage Guidelines This command displays a summary of DOCSIS version information for all CMs for a single cable
interface or upstream, or for a range of cable interfaces or upstreams.
Examples Examples: show cable modem docsis version Command
The following example shows typical output for the default form of the show cable modem docsis
version command on a Cisco uBR10012 router:
Router# show cable modem docsis version
MAC Address I/F MAC Prim Reg QoS US Phy DS Chl
State Sid Ver Prov Mode Mode
Cisco IOS CMTS Cable Command Reference
CBL-1382 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem docsis version
0018.6852.800a C5/1/0/U3 w-online(pt) 166 2.0 1.1 tdma WB
0018.6852.7f92 C5/1/0/U1 w-online(pt) 167 2.0 1.1 tdma WB
0014.bfbe.3ea6 C5/1/0/U0 w-online(pt) 168 2.0 1.1 tdma WB
0018.6852.8022 C5/1/0/U2 w-online(pt) 169 2.0 1.1 tdma WB
0018.6852.7fa0 C5/1/0/U0 w-online(pt) 170 2.0 1.1 tdma WB
0018.6852.8016 C5/1/0/U3 w-online(pt) 171 2.0 1.1 tdma WB
0018.6852.8008 C5/1/0/U2 w-online(pt) 172 2.0 1.1 tdma WB
0018.6852.800e C5/1/0/U1 w-online(pt) 173 2.0 1.1 tdma WB
0018.6852.8000 C5/1/0/U1 w-online(pt) 174 2.0 1.1 tdma WB
0002.8a8c.ed06 C5/1/1/U0 online(pt) 79 2.0 1.1 tdma NB
0018.6852.801c C5/1/1/U0 w-online(pt) 80 2.0 1.1 tdma WB
0018.6852.8006 C5/1/1/U0 w-online(pt) 81 2.0 1.1 tdma WB
00e0.6f2c.6a4e C5/1/1/U0 online(pt) 82 1.1 1.1 tdma NB
0011.ae02.a63c C5/1/3/U0 online(pt) 37 2.0 1.1 tdma NB
0011.ae00.c514 C5/1/3/U0 online(pt) 38 2.0 1.1 tdma NB
The following example shows sample output for the show cable modem docsis version command for a
particular cable interface on a Cisco uBR10012 router:
Router# show cable modem cable 5/1/0 docsis version
MAC Address I/F MAC Prim Reg QoS US Phy DS Chl
State Sid Ver Prov Mode Mode
0018.6852.800a C5/1/0/U3 w-online(pt) 166 2.0 1.1 tdma WB
0018.6852.7f92 C5/1/0/U1 w-online(pt) 167 2.0 1.1 tdma WB
0014.bfbe.3ea6 C5/1/0/U0 w-online(pt) 168 2.0 1.1 tdma WB
0018.6852.8022 C5/1/0/U2 w-online(pt) 169 2.0 1.1 tdma WB
0018.6852.7fa0 C5/1/0/U0 w-online(pt) 170 2.0 1.1 tdma WB
0018.6852.8016 C5/1/0/U3 w-online(pt) 171 2.0 1.1 tdma WB
0018.6852.8008 C5/1/0/U2 w-online(pt) 172 2.0 1.1 tdma WB
0018.6852.800e C5/1/0/U1 w-online(pt) 173 2.0 1.1 tdma WB
0018.6852.8000 C5/1/0/U1 w-online(pt) 174 2.0 1.1 tdma WB
Table 94 describes the significant fields shown in the display.
Table 94 show cable modem docsis version Field Descriptions
Field Description
MAC Address The MAC address of the CM.
I/F The cable interface line card providing the upstream for this CM.
MAC State The current state of the MAC layer.
Prim Sid The primary SID assigned to this CM.
Reg Ver Displays the maximum supported version of DOCSIS that the CM supports. The
possible values are: 1.0, 1.1, 2.0, and 3.0. Shows “n/a” if the modem is not online.
QoS Prov Displays the version of DOCSIS that the CM currently is provisioned and
registered for. The possible values are: 1.0, 1.1, 2.0, and 3.0. Shows “n/a” if the
modem is not online.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1383
Cable Commands: show cable m through show cable u
show cable modem docsis version
Table 94 show cable modem docsis version Field Descriptions
Field Description
US Phy Mode Displays the DOCSIS operating mode for the CM, with the following possible
values:
• tdma—DOCSIS 1.X, Time Division Multiple Access (TDMA)-only mode
• atdma—DOCSIS 2.0 Advanced Time Division Multiple Access (A-TDMA)
mode
• scdma—DOCSIS 2.0 Synchronous Code Division Multiple Access
(SCDMA) mode
Note This field is the same as that returned by the
docsIfCmtsCmStatusModulationType object in the DOCS-IF-MIB.
DS Chl Mode Displays the downstream channel mode for the CM, with the following possible
values:
• NB—Narrowband
• WB—Wideband
Examples: show cable modem version docsis version total Command
The following example shows the corresponding display for the show cable modem docsis version
total command:
Router# show cable modem docsis version total
Total Registered CMs: 15
Total Unregistered CMs: 0
Total DOCSIS 3.0 Operating/Capable/Registered CMs: 0/0/0
Total DOCSIS 2.0 Operating/Capable/Registered CMs: 0/14/14
Total DOCSIS 1.1 Operating/Capable/Registered CMs: 15/15/1
Total DOCSIS 1.0 Operating/Capable/Registered CMs: 0/15/0
Total v1.1 US QoS operating CMs: 15
Total V1.0 US QoS operating CMs: 0
Total Wide Band US operating CMs: 0
Total scdma US Phy operating CMs: 0
Total atdma US Phy operating CMs: 0
Total tdma US Phy operating CMs: 15
Total Wide Band DS operating CMs: 11
Total Narrow Band DS operating CMs: 4
Beginning in Cisco IOS Release 12.2(33)SCD2, the output of the show cable modem docsis
version total command was modified to display the cable modems that are in partial service mode as
shown in the following example:
Router# show cable modem docsis version total
Total Registered CMs: 35
Total Unregistered CMs: 1
Total DOCSIS 3.0 Operating/Capable/Registered CMs: 21/22/22
Total DOCSIS 2.0 Operating/Capable/Registered CMs: 0/34/12
Total DOCSIS 1.1 Operating/Capable/Registered CMs: 35/35/1
Total DOCSIS 1.0 Operating/Capable/Registered CMs: 0/35/0
Cisco IOS CMTS Cable Command Reference
CBL-1384 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem docsis version
Total v1.1 US QoS operating CMs: 35
Total V1.0 US QoS operating CMs: 0
Total Wide Band US operating CMs: 21
Total Wide Band US partial-mode CMs: 9
Total scdma US Phy operating CMs: 0
Total atdma US Phy operating CMs: 0
Total tdma US Phy operating CMs: 14
Total Wide Band DS operating CMs: 22
Total Wide Band DS partial-mode CMs: 12
Total Narrow Band DS operating CMs: 13
Table 95 describes the fields shown in the show cable modem docsis version total command display.
Table 95 show cable modem docsis version total Field Descriptions
Field Description
Total Registered CMs Total number of cable modems currently online in a CMTS router.
Total Unregistered CMs Total number of cable modems that are either offline and not currently
communicating with the CMTS router, or that are attempting to come
online but are not yet registered.
Total DOCSIS x.y Total number of cable modems (in a/b/c format) for the specified
Operating/Capable/Registered DOCSIS version (x.y) that have the following status:
CMs: a/b/c
• Operating—Total number (a) of CMs currently operating in the
specified DOCSIS version.
• Capable—Total number (b) of CMs that can operate in the
specified DOCSIS version, but might not be operating in that
version.
• Registered—Total number (c) of CMs that are currently
registered in the specified DOCSIS version.
Total Vx.y US QoS operating Total number of cable modems whose upstreams are currently
CMs operating in a specified DOCSIS version (x.y) quality of service
(QoS).
Total Wide Band US operating Total number of cable modems with upstreams currently operating in
CMs wideband channel mode.
Total Wide Band US Total number of cable modems with upstreams currently operating in
partial-mode CMs partial wideband channel mode.
Total mode US Phy operating Total number of cable modems with upstreams currently operating in
CMs a particular wideband channel mode, where mode is:
• scdma—DOCSIS 2.0 Synchronous Code Division Multiple
Access (SCDMA) mode
• atdma—DOCSIS 2.0 Advanced Time Division Multiple Access
(A-TDMA) mode
• tdma—DOCSIS 1.X, Time Division Multiple Access (TDMA)
mode
Total Wide Band DS operating Total number of cable modems with downstreams operating in
CMs wideband channel mode.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1385
Cable Commands: show cable m through show cable u
show cable modem docsis version
Table 95 show cable modem docsis version total Field Descriptions
Field Description
Total Wide Band DS Total number of cable modems with downstreams operating in partial
partial-mode CMs wideband channel mode.
Total Narrow Band DS Total number of cable modems with downstreams operating in
operating CMs narrowband channel mode.
Examples: show cable modem docsis version summary Command
The following example shows typical output for the default form of the show cable modem docsis
version summary command on a Cisco uBR10012 router:
Router# show cable modem docsis version summary
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C5/1/0/U0 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U1 3 0 3 0 0 3 0 0 0 0 3 3 0
C5/1/0/U2 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U3 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/1/U0 4 0 3 1 0 4 0 0 0 0 4 2 2
C5/1/3/U0 2 0 2 0 0 2 0 0 0 0 2 0 2
Beginning in Cisco IOS Release 12.2(33)SCD2, the output of the show cable modem docsis version
summary command was modified to display the cable modems that are in full or partial service mode
as shown in the following example:
Router# show cable modem docsis version summary
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DOCSIS Mode
------------------- --------- -------------- ----------------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 scdm atdm tdma UP WB WP NB
C7/0/0/UB 12 12 0 0 0 12 0 0 0 0 9 12 12 0
C7/0/0/U0 2 0 2 0 0 2 0 0 0 2 0 0 0 2
C7/0/0/U1 1 0 1 0 0 1 0 0 0 1 0 0 0 1
C7/0/0/U3 4 0 4 0 0 4 0 0 0 4 0 0 0 4
C8/0/0/UB 9 9 0 0 0 9 0 0 0 0 0 9 0 0
C8/0/0/U0 1 1 0 0 0 1 0 0 0 1 0 1 0 0
C8/0/0/U1 5 0 4 1 0 5 0 0 0 5 0 0 0 5
C8/0/0/U3 1 0 1 0 0 1 0 0 0 1 0 0 0 1
The following example shows typical output for the show cable modem docsis version summary
command with the total option on a Cisco uBR10012 router:
Router# show cable modem docsis version summary total
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C5/1/0/U0 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U1 3 0 3 0 0 3 0 0 0 0 3 3 0
Cisco IOS CMTS Cable Command Reference
CBL-1386 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem docsis version
C5/1/0/U2 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U3 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/1/U0 4 0 3 1 0 4 0 0 0 0 4 2 2
C5/1/3/U0 2 0 2 0 0 2 0 0 0 0 2 0 2
Total: 15 0 14 1 0 15 0 0 0 0 15 11 4
Beginning in Cisco IOS Release 12.3(23)BC7, the output for the show cable modem docsis version
summary total command was modified as shown in the following example:
Router# show cable modem docsis version summary total
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C5/1/0/U0 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U1 3 0 3 0 0 3 0 0 0 0 3 3 0
C5/1/0/U2 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U3 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/1/U0 4 0 3 1 0 4 0 0 0 0 4 2 2
C5/1/3/U0 2 0 2 0 0 2 0 0 0 0 2 0 2
-----------------------------------------------------------------------------
Total: 15 v3.0: 0 v1.1: 15 WB : 0 WB: 11
v2.0: 14 v1.0: 0 scdm: 0 NB: 4
v1.1: 1 atdm: 0
v1.0: 0 tdma: 15
-----------------------------------------------------------------------------
Beginning in Cisco IOS Release 12.2(33)SCD2, the output of the show cable modem docsis version
summary total command was modified to display the cable modems that are in full or partial service
mode as shown in the following example:
Router# show cable modem docsis version summary total
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DOCSIS Mode
------------------- --------- -------------- ----------------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 scdm atdm tdma UP WB WP NB
C7/0/0/UB 12 12 0 0 0 12 0 0 0 0 9 12 12 0
C7/0/0/U0 2 0 2 0 0 2 0 0 0 2 0 0 0 2
C7/0/0/U1 1 0 1 0 0 1 0 0 0 1 0 0 0 1
C7/0/0/U3 4 0 4 0 0 4 0 0 0 4 0 0 0 4
C8/0/0/UB 9 9 0 0 0 9 0 0 0 0 0 9 0 0
C8/0/0/U0 1 1 0 0 0 1 0 0 0 1 0 1 0 0
C8/0/0/U1 5 0 4 1 0 5 0 0 0 5 0 0 0 5
C8/0/0/U3 1 0 1 0 0 1 0 0 0 1 0 0 0 1
-----------------------------------------------------------------------------
Total: 35 v3.0: 22 v1.1: 35 UB : 21 WB: 22
UP : 9 WP: 12
v2.0: 12 v1.0: 0 scdm: 0 NB: 13
v1.1: 1 atdm: 0
v1.0: 0 tdma: 14
-----------------------------------------------------------------------------
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1387
Cable Commands: show cable m through show cable u
show cable modem docsis version
Examples: show cable modem docsis version summary cable total Command
The following example shows sample output for the show cable modem docsis version summary cable
total command for all enabled upstreams on a specific cable interface line card on a Cisco uBR10012
router:
Router# show cable modem docsis version summary cable 5/1/0 total
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C5/1/0/U0 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U1 3 0 3 0 0 3 0 0 0 0 3 3 0
C5/1/0/U2 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U3 2 0 2 0 0 2 0 0 0 0 2 2 0
Total: 9 0 9 0 0 9 0 0 0 0 9 9 0
Beginning in Cisco IOS Release 12.3(23)BC7, the output for the show cable modem docsis version
summary cable total command was modified as shown in the following example:
Router# show cable modem docsis version summary cable 5/1/0 total
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C5/1/0/U0 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U1 3 0 3 0 0 3 0 0 0 0 3 3 0
C5/1/0/U2 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U3 2 0 2 0 0 2 0 0 0 0 2 2 0
-----------------------------------------------------------------------------
Total: 9 v3.0: 0 v1.1: 9 WB : 0 WB: 9
v2.0: 9 v1.0: 0 scdm: 0 NB: 0
v1.1: 0 atdm: 0
v1.0: 0 tdma: 9
-----------------------------------------------------------------------------
The following example shows sample output for the show cable modem docsis version summary cable
total command for a range of interfaces on the Cisco uBR10012 router:
Router# show cable modem docsis version summary cable 5/1/0 cable 5/1/3 total
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C5/1/0/U0 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U1 3 0 3 0 0 3 0 0 0 0 3 3 0
C5/1/0/U2 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U3 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/1/U0 4 0 3 1 0 4 0 0 0 0 4 2 2
C5/1/3/U0 2 0 2 0 0 2 0 0 0 0 2 0 2
Total: 15 0 14 1 0 15 0 0 0 0 15 11 4
Cisco IOS CMTS Cable Command Reference
CBL-1388 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem docsis version
Beginning in Cisco IOS Release 12.3(23)BC7, the output for the show cable modem docsis version
summary cable total command for a range of interfaces was modified as shown in the following
example:
Router# show cable modem docsis version summary cable 5/1/0 cable 5/1/3 total
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C5/1/0/U0 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U1 3 0 3 0 0 3 0 0 0 0 3 3 0
C5/1/0/U2 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U3 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/1/U0 4 0 3 1 0 4 0 0 0 0 4 2 2
C5/1/3/U0 2 0 2 0 0 2 0 0 0 0 2 0 2
-----------------------------------------------------------------------------
Total: 15 v3.0: 0 v1.1: 15 WB : 0 WB: 11
v2.0: 14 v1.0: 0 scdm: 0 NB: 4
v1.1: 1 atdm: 0
v1.0: 0 tdma: 15
-----------------------------------------------------------------------------
The following example shows sample output for the show cable modem docsis version summary cable
upstream total command for a range of interfaces and upstreams on the Cisco uBR10012 router:
Router# show cable modem docsis version summary cable 5/1/0 cable 5/1/3 upstream 0 3 total
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C5/1/0/U0 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U1 3 0 3 0 0 3 0 0 0 0 3 3 0
C5/1/0/U2 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U3 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/1/U0 4 0 3 1 0 4 0 0 0 0 4 2 2
C5/1/3/U0 2 0 2 0 0 2 0 0 0 0 2 0 2
Total: 15 0 14 1 0 15 0 0 0 0 15 11 4
Beginning in Cisco IOS Release 12.3(23)BC7, the output for the show cable modem docsis version
summary cable upstream total command for a range of interfaces and upstreams was modified as
shown in the following example:
Router# show cable modem docsis version summary cable 5/1/0 cable 5/1/3 upstream 0 3 total
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C5/1/0/U0 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U1 3 0 3 0 0 3 0 0 0 0 3 3 0
C5/1/0/U2 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U3 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/1/U0 4 0 3 1 0 4 0 0 0 0 4 2 2
C5/1/3/U0 2 0 2 0 0 2 0 0 0 0 2 0 2
-----------------------------------------------------------------------------
Total: 15 v3.0: 0 v1.1: 15 WB : 0 WB: 11
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1389
Cable Commands: show cable m through show cable u
show cable modem docsis version
v2.0: 14 v1.0: 0 scdm: 0 NB: 4
v1.1: 1 atdm: 0
v1.0: 0 tdma: 15
-----------------------------------------------------------------------------
The following example shows sample output for the show cable modem docsis version summary cable
upstream total command for a range of upstreams in an interface on the Cisco uBR10012 router:
Router# show cable modem docsis version summary cable 5/1/0 upstream 0 3 total
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C5/1/0/U0 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U1 3 0 3 0 0 3 0 0 0 0 3 3 0
C5/1/0/U2 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U3 2 0 2 0 0 2 0 0 0 0 2 2 0
Total: 9 0 9 0 0 9 0 0 0 0 9 9 0
Beginning in Cisco IOS Release 12.3(23)BC7, the output for the show cable modem docsis version
summary cable upstream total command for a range of upstreams was modified as shown in the
following example:
Router# show cable modem docsis version summary cable 5/1/0 upstream 0 3 total
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C5/1/0/U0 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U1 3 0 3 0 0 3 0 0 0 0 3 3 0
C5/1/0/U2 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U3 2 0 2 0 0 2 0 0 0 0 2 2 0
-----------------------------------------------------------------------------
Total: 9 v3.0: 0 v1.1: 9 WB : 0 WB: 9
v2.0: 9 v1.0: 0 scdm: 0 NB: 0
v1.1: 0 atdm: 0
v1.0: 0 tdma: 9
-----------------------------------------------------------------------------
The following example shows sample output for the show cable modem cable docsis version summary
command for all enabled upstreams on a specific cable interface line card on a Cisco uBR10012 router:
Router# show cable modem cable 8/0/1 docsis version summary
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C8/0/1/U0 4 0 2 1 1 0 4 0 0 0 4 0 4
Beginning in Cisco IOS Release 12.3(23)BC7, the output for the show cable modem cable docsis
version summary command for a range of upstreams was modified as shown in the following example:
Router# show cable modem cable 8/0/1 docsis version summary
Cable Modem DOCSIS Version Summary
Cisco IOS CMTS Cable Command Reference
CBL-1390 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem docsis version
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C8/0/1/U0 4 0 2 1 1 0 4 0 0 0 4 0 4
Table 96 describes the significant fields shown in the display.
Table 96 show cable modem docsis version summary Field Descriptions
Field Description
Interface The cable interface line card providing the upstream for this cable
modem.
Online Total number of cable modems currently online on this cable
interface.
DOCSIS Registered Total number of cable modems registered on this cable interface with
the specified DOCSIS version (x.y) capabilities.
US QoS Total number of cable modems whose upstreams are currently
operating in a specified DOCSIS version (x.y) quality of service
(QoS).
US Phy Mode Total number of cable modems on this cable interface with upstreams
currently operating in a particular wideband channel mode, where:
• WB—Total number of upstreams on this cable interface
operating in any wideband channel mode.
• scdma—Total number of upstreams on this cable interface
operating in DOCSIS 2.0 Synchronous Code Division Multiple
Access (SCDMA) mode.
• atdma—Total number of upstreams on this cable interface
operating in DOCSIS 2.0 Advanced Time Division Multiple
Access (A-TDMA) mode.
• tdma—Total number of upstreams on this cable interface
operating in DOCSIS 1.X, Time Division Multiple Access
(TDMA) mode.
DS Mode Total number of cable modems on this cable interface whose
downstreams are operating in the following modes:
• WB—Total number of downstreams on this cable interface
operating in wideband channel mode.
• NB—Total number of downstreams on this cable interface
operating in narrowband channel mode.
DOCSIS Mode • UP—Total number of cable modems in upstream bonding partial
service mode (p).
• WB—Total number of cable modems in downstream bonding
fully-operational mode (w-online).
• WP—Total number of cable modems in downstream bonding
partial service mode (p-online).
• NB—Total number of cable modems in narrowband online mode
(online).
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1391
Cable Commands: show cable m through show cable u
show cable modem docsis version
Related Commands Command Description
show cable modem Displays the DOCSIS device-class information for cable modems (CMs) on
docsis device-class all or specified cable interfaces and upstreams.
show cable modem Displays information about the cable modems that are in upstream and
partial-mode downstream partial service mode.
show cable modem Displays RF adaptation information for cable modems.
rf-adapt
Cisco IOS CMTS Cable Command Reference
CBL-1392 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem domain-name
show cable modem domain-name
To update the cable-specific Domain Name System (DNS) cache and display the domain name for
specified cable modems (CMs) and customer premise equipment (CPE) behind a CM on a Cisco CMTS
router, use the show cable modem domain-name command in privileged EXEC mode.
Cisco uBR7246VXR Router and Cisco uBR7225VXR Router
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] domain-name
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn]
domain-name
Syntax Description ip-address (Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you
specify the IP address for a CPE device behind a CM, information for that
CM is displayed.
mac-address (Optional) MAC address of a specific CM to be displayed. If you specify the
MAC address for a CPE device behind a CM, information for that CM is
displayed.
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.
subslot (Cisco uBR10012 only) Secondary slot number of the cable interface line
card. The valid subslots are 0 or 1.
port Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—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 IOS CMTS Cable Command Reference
OL-15510-15 CBL-1393
Cable Commands: show cable m through show cable u
show cable modem domain-name
upstream port (Optional) Displays information for all CMs using the specified upstream
port. You can specify this option only when displaying information for a
cable interface. The valid range for port begins with 0 and ends with a value
that depends on the number of upstream ports supported by the cable
interface line card.
logical-channel-index (Optional) Logical channel index. The valid values are 0 or 1.
name fqdn (Optional) Specifies the fully qualified domain name (FQDN) of the cable
device to be displayed. This option is only available if the show cable
modem domain-name command has been run for the first time to update the
cable DNS cache on the CMTS router.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCA This command was introduced.
12.2(33)SCE This command was modified. The port parameter was changed to
cable-interface-index.
12.2(33)SCF This command was modified. The logical-channel-index argument was
added.
Usage Guidelines Use the show cable modem domain-name command without any options to initiate an update to the
cable-specific DNS cache on the CMTS router and to enable use of domain names in other CMTS router
cable modem commands that support a name option.
Note In Cisco IOS Release 12.2(33)SCA, although the show cable modem domain-name command accepts
an IPv4 address format for a CM, DNS for IPv4-managed cable devices is not supported.
Examples The following example shows sample output for all CMs and CPE behind a CM for the show cable
modem domain-name command, listing the devices by their MAC and IP addresses and displaying the
associated domain name:
Router# show cable modem domain-name
MAC Address IP Address Domain Name
0018.6835.27b3 10.3.37.76
0019.474a.c14a 2001:0DB8:3800:809:A896:1431:75EA:5EA1 cisco-test-cm1.cisco.com
0007.0e03.6851 10.3.37.36
0007.0e01.b085 10.3.37.34
0018.6835.27aa 2001:0DB8:3800:809:E97D:2986:9F37:FFE cisco-test-cm2.cisco.com
Related Commands
Cisco IOS CMTS Cable Command Reference
CBL-1394 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem domain-name
Command Description
cable modem vendor Associates the name of a vendor with its Organizational Unique Identifier
(OUI).
show cable modem Displays information for the registered and unregistered CMs.
show cable modem Displays displays voice call information for a particular CM, identified
calls either by its IP address or MAC address.
show cable modem Displays information about the upstream carrier-to-noise ratio (CNR) for a
cnr particular cable modem.
show cable modem Displays flap list statistics for one or more cable modems.
flap
show cable modem Displays station maintenance (SM) error statistics for one or more cable
maintenance modems.
show cable modem Displays information collected by the remote-query feature.
remote-query
show cable modem Displays RF adaptation information for cable modems.
rf-adapt
show cable Displays modulation profile group information.
modulation-profile
show interface cable Displays information about the CMs connected to a particular cable
modem interface.
show interface cable Displays cable interface information.
sid
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1395
Cable Commands: show cable m through show cable u
show cable modem errors
show cable modem errors
To display packet header error statistics for one or more CMs, use the show cable modem errors
command in privileged EXEC mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] errors
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn]
errors
Syntax Description ip-address (Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you
specify the IP address for a CPE device behind a CM, information for that
CM is displayed.
mac-address (Optional) MAC address of a specific CM to be displayed. If you specify
the MAC address for a CPE device behind a CM, information for that CM
is displayed.
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.
subslot (Cisco uBR10012 only) Secondary slot number of the cable interface line
card. The valid subslots are 0 or 1.
port Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—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.
upstream port (Optional) Displays information for all CMs using this specific upstream.
You can specify this option only when displaying information for a cable
interface. The valid range for port begins with 0 and ends with a value that
depends on the number of upstream ports on the cable interface line card.
Cisco IOS CMTS Cable Command Reference
CBL-1396 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem errors
logical-channel-index (Optional) Logical channel index. The valid values are 0 or 1.
name fqdn (Optional) Specifies the fully qualified domain name (FQDN) of the cable
device to be displayed. This option is only available if the show cable
modem domain-name command has been run for the first time to update
the cable DNS cache on the CMTS router.
errors Displays packet header error statistics for one or more CMs.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.1(4)CX, 12.2(1)XF, This command was introduced for the Cisco uBR7100 series,
and 12.2(4)BC1 Cisco uBR7200 series, and Cisco uBR10012 router.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA, with
the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was
added.
• The name keyword option was added for specifying the fully-qualified
domain name of a CM.
12.2(33)SCE This command was modified. The port parameter was changed to
cable-interface-index.
12.2(33)SCF This command was modified. The logical-channel-index argument was
added.
Usage Guidelines This command displays packet header error information for all CMs, for all CMs attached to a specific
CMTS cable interface, or for a particular CM, as identified by its IP address or MAC address.
Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first
on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable
command.
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy,
the new primary processor after a switchover automatically creates a new database of the online cable
modems. This means that the show cable modem ip-address command might not show a particular cable
modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the
ping ip-address command, and then the show cable modem ip-address command will show the cable
modem. You can also display any particular cable modem by using the show cable modem | include
ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically
synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be
synchronized manually, using the hccp resync command. When a SYNC event command is occurring,
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1397
Cable Commands: show cable m through show cable u
show cable modem errors
CLI commands might be very slow to respond. In particular, if you enter the show cable modem
command at the same time a SYNC event is occurring, the command might respond produce a blank
display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip In Cisco IOS Release 12.2(15)BC1 and later releases, use the clear cable modem flap-counters
command to clear these counters.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Examples The following example shows sample output for the show cable modem errors command for all CMs
on a particular cable interface.
Router# show cable modem c8/1/0 errors
MAC Address I/F CRC HCS
0050.7366.1243 C8/1/0/U1 0 1
0002.b970.0027 C8/1/0/U4 0 0
0006.5314.858d C8/1/0/U4 8 3
Router#
Table 97 describes the fields shown in the show cable modem errors displays:
Table 97 Descriptions for the show cable modem errors Fields
Field Description
MAC Address The MAC address for the CM.
I/F The cable interface line card, including the upstream, for this CM.
CRC Number of times the CMTS upstream receiver flagged a packet with a cyclic
redundancy check (CRC) error from this CM. CRC errors usually indicate
downstream signal interruption or interference noise on a plant. Occasional
CRC errors can always be expected, but a high number of CRC errors could
indicate plant problems such as intermittent upstream problems, laster
clipping, common-path distortion, or impulsive noise or interference.
HCS Number of times the CMTS upstream receiver flagged a packet with a header
checksum (HCS) error from this CM. HCS errors could indicate the same sort
of plant problems as CRC errors.
Related Commands Command Description
cable modem vendor Associates the name of a vendor with its Organizational Unique Identifier
(OUI).
show cable modem Displays information for the registered and unregistered CMs.
Cisco IOS CMTS Cable Command Reference
CBL-1398 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem errors
Command Description
show cable modem Displays information about the upstream carrier-to-noise ratio (CNR) for a
cnr particular cable modem.
show cable modem Displays connectivity statistics for one or more CMs.
connectivity
show cable modem Displays flap list statistics for one or more cable modems.
flap
show cable modem Displays station maintenance (SM) error statistics for one or more cable
maintenance modems.
show interface cable Displays information about the CMs connected to a particular cable
modem interface.
show cable modem Displays RF adaptation information for cable modems.
rf-adapt
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1399
Cable Commands: show cable m through show cable u
show cable modem extended-power
show cable modem extended-power
To display the list of cable modems that are transmitting upstream data at extended power level, use the
show cable modem extended-power command in privilege EXEC mode.
show cable modem extended-power
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCF2 This command was introduced.
Examples The following is a sample output of the show cable modem extended-power command that displays all
the cable modems that are transmitting upstream data at extended power level:
Router# show cable modem extended-power
MAC Address IP Address I/F MAC Prim Report ECN
State Sid Power
001e.6bfb.3382 5.50.0.3 C7/0/0/UB w-online 3 57.00 Y
0022.cea5.0214 5.50.1.102 C7/0/0/UB w-online 5 54.00 Y
001e.6bfb.1378 5.50.6.83 C7/0/0/UB w-online 6 54.00 Y
Table 1 describes significant fields shown in the display.
Table 98 show cable modem extended-power Field Descriptions
Field Description
MAC Address MAC address of the cable modem.
IP Address IP address that the DHCP server has assigned to the cable
modem.
I/F Cable interface line card providing the upstream for the cable
modem.
MAC State Current state of the MAC layer.
Prim Sid Primary Service ID (SID) assigned to the cable modem.
Report Power Power (in dB) at which cable modems are transmitting
upstream data.
ECN Extended high power at which the CM is operating.
Cisco IOS CMTS Cable Command Reference
CBL-1400 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem extended-power
Related Commands Command Description
cable upstream Enables or disables the DOCSIS extended transmit power support on the
ext-power Cisco CMTS.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1401
Cable Commands: show cable m through show cable u
show cable modem flap
show cable modem flap
To display flap list statistics for one or more cable modems, use the show cable modem flap command
in privileged EXEC mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] flap
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] flap
Syntax Description ip-address (Optional) IPv4 or IPv6 address of a specific cable modem to be displayed.
If you specify the IP address for a CPE device behind a cable modem,
information for that cable modem is displayed.
mac-address (Optional) MAC address of a specific cable modem to be displayed. If you
specify the MAC address for a CPE device behind a cable modem,
information for that cable modem is displayed.
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.
subslot (Cisco uBR10012 only) Secondary slot number of the cable interface line
card. The valid subslots are 0 or 1.
port Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—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.
upstream port (Optional) Displays information for all cable modems using the specified
upstream port. You can specify this option only when displaying information
for a cable interface. The valid range for port begins with 0 and ends with a
value that depends on the number of upstream ports supported by the cable
interface line card.
Cisco IOS CMTS Cable Command Reference
CBL-1402 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem flap
logical-channel-index (Optional) Logical channel index. The valid values are 0 or 1.
name fqdn (Optional) Specifies the fully qualified domain name (FQDN) of the cable
device to be displayed. This option is only available if the show cable
modem domain-name command has been run for the first time to update the
cable DNS cache on the CMTS router.
flap mtc Displays aggregate data across all upstream channels for each flap detector
for cable modems in MTC mode. Displays per channel flap information for
a single cable modem in MTC mode.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.1(4)CX, 12.2(1)XF, This command was introduced for the Cisco uBR7100 series,
and 12.2(4)BC1 Cisco uBR7200 series, and Cisco uBR10012 routers.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA, with
the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a cable modem or CPE
device was added.
• The name keyword option was added for specifying the fully-qualified
domain name of a cable modem.
12.2(33)SCC A new keyword, mtc, was added to provide multiple transmit channel
(MTC) information for cable modems in the MTC mode.
• The mtc keyword displays aggregate data across all upstream channels
for each flap detector for cable modems in the MTC mode.
• The show cable modem flap command remains unchanged for
non-MTC mode cable modems.
12.2(33)SCE This command was modified. The port parameter was changed to
cable-interface-index.
12.2(33)SCF This command was modified. The logical-channel-index argument was
added.
Usage Guidelines This command displays information about the flap list activity for one or more cable modems. Unlike
the show cable flap-list command, the show cable modem flap command displays flap counters of a
cable modem irrespective of the plant condition.
Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first
on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable
command.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1403
Cable Commands: show cable m through show cable u
show cable modem flap
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy,
the new primary processor after a switchover automatically creates a new database of the online cable
modems. This means that the show cable modem ip-address command might not show a particular cable
modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the
ping ip-address command, and then the show cable modem ip-address command will show the cable
modem. You can also display any particular cable modem by using the show cable modem | include
ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically
synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be
synchronized manually, using the hccp resync command. When a SYNC event command is occurring,
CLI commands might be very slow to respond. In particular, if you enter the show cable modem
command at the same time a SYNC event is occurring, the command might respond produce a blank
display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
For cable modems in MTC mode, the show cable modem flap command will display aggregate data
across all upstream channels for each flap detector. However, for a single MTC cable modem, the show
cable modem flap command will display per channel flap information.
Note The output of the show cable modem flap command will remain unchanged for non-MTC mode cable
modems.
Examples The following example shows sample output for the show cable modem flap command on a
Cisco CMTS router:
Router# show cable modem flap
MAC Address I/F Ins Hit Miss CRC P-Adj Flap Time
0025.2e34.4386 C6/0/0/U0 0 46657 3974 0 0 0 (14212 msec)
0025.2e2f.d4b6 C6/0/0/U0 0 47868 1896 0 0 0 (18000 msec)
0025.2e2f.d4de C6/0/0/U0 0 47960 1883 0 0 0 (19552 msec)
0023.bee1.e96b C6/0/0/U0 0 46537 4333 0 0 0 (22432 msec)
0025.2e2f.d4d8 C6/0/0/U0 0 21891 780 0 0 0 ( -- )
0025.2e2f.d48c C6/0/0/U0 0 47918 1828 0 0 0 ( -- )
0025.2e2f.d490 C6/0/0/U0 0 47900 1812 0 0 0 ( -- )
0019.474e.e46a C8/0/0/U0 0 33424 0 0 0 0 (6372 msec)
0019.474e.e266 C8/0/0/U0 0 33418 0 0 0 0 (8352 msec)
0022.ce89.96f2 C8/0/0/U0 0 33427 0 0 0 0 (11112 msec)
0025.2e2f.d58a C8/0/0/U0 0 33423 0 0 !33420 33420 Oct 5 16:02:16(15252
msec)
001a.c30c.7ef6 C8/0/0/U0 0 33424 2 0 0 0 (17592 msec)
0022.ce89.96b0 C8/0/0/U0 0 33414 0 0 0 0 ( -- )
0025.2e2f.d6de C8/0/0/U0 0 33414 0 0 !33411 33411 Oct 5 16:02:
21( -- )
0025.2e34.43c8 C8/0/0/U0 0 33411 0 0 0 0 ( -- )
0023.bee1.e974 C8/0/0/U0 0 33406 0 0 0 0 ( -- )
0019.474e.e3a7 C8/0/0/U0 0 33324 0 0 0 0 ( -- )
Cisco IOS CMTS Cable Command Reference
CBL-1404 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem flap
The following example shows sample output for the show cable modem flap command for all cable
modems on a specific cable interface:
Router# show cable modem c6/0/0 flap
MAC Address I/F Ins Hit Miss CRC P-Adj Flap Time
0025.2e34.4386 C6/0/0/U0 0 46778 3980 0 0 0 (14212 msec)
0025.2e2f.d4b6 C6/0/0/U0 0 48002 1899 0 0 0 (18000 msec)
0025.2e2f.d4de C6/0/0/U0 0 48098 1889 0 0 0 (19552 msec)
0023.bee1.e96b C6/0/0/U0 0 46658 4351 0 0 0 (22432 msec)
0025.2e2f.d4d8 C6/0/0/U0 0 21979 781 0 0 0 ( -- )
0025.2e2f.d48c C6/0/0/U0 0 48048 1835 0 0 0 ( -- )
0025.2e2f.d490 C6/0/0/U0 0 48029 1819 0 0 0 ( -- )
The following example shows sample output for the show cable modem flap command for a particular
cable modem:
Router# show cable modem 0010.7bb3.fcd1 flap
MAC Address I/F Ins Hit Miss CRC P-Adj Flap Time
0010.7bb3.fcd1 C5/0/U5 0 36278 92 0 369 372 Jun 1 13:05:23 (14212 msec)
The following example shows sample output of the show cable modem flap command for all cable
modems in the MTC mode on a specific cable interface:
Router# show cable modem c5/0/0 flap
MAC Address I/F Ins Hit Miss CRC P-Adj Flap Time
000e.5c44.d2f0 C5/0/0/U0 0 3040 0 0 0 0 ( -- )
0019.474a.d542 C5/0/0/U3 0 2930 214 0 0 1 May 27 05:21:26(19552 msec)
001a.c3ff.d578 C5/0/0/UB 0 12195 60 0 0 4 May 25 10:01:03(22432 msec)
Table 99 describes the significant fields shown in the display:
Table 99 show cable modem flap Field Descriptions
Field Description
MAC Address The MAC address for the CM.
I/F The cable interface line card, including upstream, for this cable modem.
Ins The number of times the cable modem comes up and inserts itself into the
network. It can indicate intermittent downstream sync loss or DHCP or
modem registration problems.
Hit The number of times the cable modem responds to MAC layer keepalive
messages. (The minimum hit rate is once per 30 seconds. It can indicate
intermittent upstream, laser clipping, or common-path distortion.
Miss The number of times the cable modem misses the MAC layer keepalive
message. An 8 percent miss rate is normal for the Cisco cable interface line
cards. It can indicate intermittent upstream, laser clipping, or common-path
distortion.
CRC The number of cyclic redundancy check (CRC) errors from this cable modem.
It can indicate intermittent upstream, laser clipping, or common-path
distortion.
P-Adj The number of times the headend instructed the cable modem to adjust
transmit (TX) power more than 3 dB. It can indicate amplifier degradation,
poor connections, or thermal sensitivity.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1405
Cable Commands: show cable m through show cable u
show cable modem flap
Table 99 show cable modem flap Field Descriptions (continued) (continued)
Field Description
Flap The sum of P-Adj and Ins values. cable modems with high flap counts have
high SIDs and might not register.
Time The most recent time that the cable modem dropped the connection. The
value displayed in the brackets indicates the duration (milliseconds) between
the cable interface to become active and the first ranging success after a line
card switchover (cable modem recovery time).
Related Commands Command Description
cable flap-list aging Specifies the number of days to keep a cable modem in the flap-list table
before aging it out of the table.
cable flap-list Sets the insertion time interval that determines whether a cable modem is
insertion-time placed in the flap list.
cable flap-list Configures the threshold for recording a flap-list event, in terms of missed
miss-threshold Station Maintenance messages.
cable flap-list Specifies the power-adjust threshold for recording a cable modem flap-list
power-adjust event.
threshold
cable flap-list size Specifies the maximum number of cable modems that can be listed in the
flap-list table.
clear cable flap-list Clears all the entries in the flap-list table.
show cable flap-list Displays the current contents of the flap list.
show cable modem Displays information for the registered and unregistered cable modems.
show cable modem Displays RF adaptation information for cable modems.
rf-adapt
show interface cable Displays information about the cable modems connected to a particular cable
modem interface.
Cisco IOS CMTS Cable Command Reference
CBL-1406 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem ipv6
show cable modem ipv6
To display IPv6 information for specified cable modems (CMs) and customer premise equipment (CPE)
behind a CM on a Cisco CMTS router, use the show cable modem ipv6 command in privileged EXEC
mode.
Cisco uBR7246VXR Router and Cisco uBR7225VXR Router
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] ipv6 [cpe | prefix | registered |
unregistered]
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] ipv6
[cpe | prefix | registered | unregistered]
Syntax Description ip-address (Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you
specify the IP address for a CPE device behind a CM, information for that
CM is displayed.
mac-address (Optional) MAC address of a specific CM to be displayed. If you specify the
MAC address for a CPE device behind a CM, information for that CM is
displayed.
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.
subslot (Cisco uBR10012 only) Secondary slot number of the cable interface line
card. The valid subslots are 0 or 1.
port Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—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 IOS CMTS Cable Command Reference
OL-15510-15 CBL-1407
Cable Commands: show cable m through show cable u
show cable modem ipv6
upstream port (Optional) Displays information for all CMs using the specified upstream
port. You can specify this option only when displaying information for a
cable interface. The valid range for port begins with 0 and ends with a value
that depends on the number of upstream ports supported by the cable
interface line card.
logical-channel-index (Optional) Logical channel index. The valid values are 0 or 1.
name fqdn (Optional) Specifies the fully qualified domain name (FQDN) of the cable
device to be displayed. This option is only available if the show cable
modem domain-name command has been run for the first time to update the
cable DNS cache on the CMTS router.
cpe (Optional—Available only when used with an IP address of CM) Displays
IPv6 information for the CPE devices behind the CM with the specified IPv4
or IPv6 address.
prefix (Optional) Displays the IPv6 prefix of the network.
registered (Optional) Displays IPv6 information for registered CMs.
unregistered (Optional) Displays IPv6 information for unregistered CMs.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCA This command was introduced.
12.2(33)SCE This command was modified. The port parameter was changed to
cable-interface-index.
12.2(33)SCF This command was modified. The logical-channel-index argument was
added.
Usage Guidelines Use the show cable modem ipv6 command without any options to display IPv6 information for all CMs
on the CMTS router.
Using the keyword options, you can display IPv6 information by IP address (IPv4 or IPv6) of a particular
CM, for all CMs associated with a specified cable interface, by MAC address of a CM, or by domain
name of a CM.
Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first
on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable
command.
Displaying CPE Information
• To display the number of CPEs behind a CM, use the show cable modem ipv6 registered form of
the command.
• To display CPE information behind a particular CM, you must use the command with an IPv6
address of the CM and the cpe keyword option.
Cisco IOS CMTS Cable Command Reference
CBL-1408 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem ipv6
Examples IPv6 Information for all CMs Example
The following example shows sample output for the show cable modem ipv6 command for all CMs on
the CMTS routers, listing the devices by their MAC and IP addresses and displaying the associated
domain name:
Router# show cable modem ipv6
MAC Address Type Interface Mac State D/IP IP Address
0004.27a5.b761 B/D C6/0/2/U1 online N ---
0007.0e01.d9a1 B/D C6/0/2/U0 online N ---
0006.2854.7275 R/D C6/0/2/U1 online Y 2001:0DB8:3800:80B:7565:5B87:1D7D:5AD5
Table 100 describes the significant fields shown in the display.
Table 100 show cable modem ipv6 Field Descriptions
Field Description
MAC Address MAC address of this CM.
Type Type of device that this CM is functioning as, with the
following possible values:
• B/D—CM as bridge using DHCP address assignment.
• G/D—CPE router using DHCP address assignment.
• C/A—CPE using Stateless Address Auto-Configuration
(SLAAC) address assignment.
Note In Cisco IOS Release 12.2(33)SCA, the Cisco CMTS
router does not support SLAAC.
Interface Cable line card interface and upstream associated with this
CM.
Mac State The current state of the MAC layer for this CM (See
Table 101 for descriptions of the possible states).
D/IP Dual IP flag. Identifies whether or not (“Y” or “N”) the CM
or CPE supports both IPv4 and IPv6 addressing.
IP Address IP address acquired by the CM. Prior to acquisition of the IP
address, or if the CM fails registration, the following output
is shown:
• IPv4 address not yet acquired—”0.0.0.0”
• IPv6 address not yet acquired—“::”
• CM fails IPv6 registration, but online with IPv4 address
or CM fails IPv4 registration, but online with IPv6
address: “---”
• IPv6 address of IPv4-only CM, or IPv4 address of an
IPv6-only CM: “---”
Domain Name Domain name for the CM.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1409
Cable Commands: show cable m through show cable u
show cable modem ipv6
Table 101 shows the possible values for the MAC state field:
Table 101 Descriptions for the MAC State Field 1
MAC State Value Description
Registration and Provisioning Status Conditions for Devices Using IPv4 Addressing
init(r1) The CM sent initial ranging.
init(r2) The CM is ranging. The CMTS received initial ranging from the Cm and has sent
RF power, timing offset, and frequency adjustments to the CM.
init(rc) Ranging has completed.
Note If a CM appears to be stuck in this state, it could be that the CM is able
to communicate successfully on the cable network, but that the upstream
is at capacity and does not have any additional bandwidth to allow the
CM to finish registration and come online. Either manually move one or
more CMs to other upstreams, or enable load balancing on the upstream
using the cable load-balance group commands.
init(d) The DHCP request was received, as DHCPDISCOVER. This also indicates that
the first IP broadcast packet has been received from the CM.
init(dr) The DHCP request has been sent to the cable modem.
init(i) The cable modem has received the DHCPOFFER reply (DHCPACK) from the
DHCP server that has assigned an IP address to the modem, but the modem has
not yet replied with a DHCPREQUEST message requesting that particular IP
address, nor has it sent an IP packet with that IP address.
Note If a CM appears to be stuck in this state, the CM has likely received the
DHCPOFFER reply from the DHCP server, but this reply might have
contained one or more invalid options for that particular CM.
init(io) The Cisco CMTS has seen the DHCP offer as sent to the cable modem from the
DHCP server that has assigned an IP address to the modem.
init(o) The CM has begun to download the option file (DOCSIS configuration file)
using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP
response. If the CM remains in this state, it indicates that the download has
failed.
init(t) Time-of-day (TOD) exchange has started.
resetting The CM is being reset and will shortly restart the registration process.
Registration and Provisioning Status Conditions for Devices Using IPv6 Addressing
init6(s) The Cisco CMTS router has seen the DHCPv6 SOLICIT message from the CM.
init6(a) The Cisco CMTS router has seen the ADVERTISE message from the DHCPv6
server to the CM.
init6(r) The Cisco CMTS router has seen the REQUEST response from the CM to the
DHCPv6 server.
init6(i) The Cisco CMTS router has seen the REPLY message from the DHCPv6 server
to the CM.
init6(o) The Cisco CMTS router has seen the REQEST message from the CM to the TFTP
server.
Cisco IOS CMTS Cable Command Reference
CBL-1410 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem ipv6
Table 101 Descriptions for the MAC State Field (continued)1
MAC State Value Description
init6(t) The Cisco CMTS router has seen the REQUEST message from the CM to the
TOD server.
Non-error Status Conditions
cc(r1) The CM had registered and was online, but has received a Downstream Channel
Change (DCC) or Upstream Channel Change (UCC) request message from the
CMTS. The CM has begun moving to the new channel, and the CMTS has
received the CM’s initial ranging on the new downstream or upstream channel.
At the MAC layer, the CM is considered offline because it is not yet passing
traffic on the new channel, but this state does not trigger the flap-list counters.
cc(r2) This state should normally follow cc(r1) and indicates that the CM has finished
its initial ranging on the new channel, and is currently performing continuous
ranging on the new channel. At the MAC layer, the CM is considered offline
because it is not yet passing traffic on the new channel, but this state does not
trigger the flap-list counters.
offline The CM is considered offline (disconnected or powered down).
online The CM has registered and is enabled to pass data on the network.
online(d) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. The CM does not forward
traffic to or from the CPE devices, but the CMTS can continue to communicate
with the CM using DOCSIS messages and IP traffic (such as SNMP commands).
Note If BPI was enabled in the DOCSIS configuration file sent to the CM,
assume that the CM is using BPI encryption, unless other messages show
that the BPI negotiation and key assignments have failed.
online(pkd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled and
KEK is assigned.
Note This state is equivalent to the online(d) and online(pk) states.
online(ptd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled and
TEK is assigned. BPI encryption is now being performed.
Note This state is equivalent to the online(d) and online(pt) states.
online(pk) The CM registered, BPI is enabled and KEK is assigned.
online(pt) The CM registered, BPI is enabled and TEK is assigned. BPI encryption is now
being performed.
Note If network access was disabled in the DOCSIS configuration file sent to
the CM, the network disabled status takes precedence, and the MAC
status field shows online(d) instead of online(pt) even when BPI
encryption is enabled and operational.
Note If an exclamation point (!) appears in front of one of the online states, it indicates that the cable
dynamic-secret command has been used with either the mark or reject option, and that the
cable modem has failed the dynamic secret authentication check.
expire(pk) The CM registered, BPI is enabled, KEK was assigned, but the current KEK
expired before the CM could successfully renew a new KEK value.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1411
Cable Commands: show cable m through show cable u
show cable modem ipv6
Table 101 Descriptions for the MAC State Field (continued)1
MAC State Value Description
expire(pkd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled,
KEK was assigned, but the current KEK expired before the CM could
successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pk) states.
expire(pt) The CM registered, BPI is enabled, TEK was assigned, but the current TEK
expired before the CM could successfully renew a new KEK value.
expire(ptd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled,
TEK was assigned, but the current TEK expired before the CM could
successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pt) states.
Error Status Conditions
reject(m) The CM attempted to register but registration was refused due to a bad Message
Integrity Check (MIC) value. This also could indicate that the shared secret in
the DOCSIS configuration file does not match the value configured on the CMTS
with the cable shared-secret command.
In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later
releases, this could also indicate that the cable tftp-enforce command has been
used to require that a CM attempt a TFTP download of the DOCSIS
configuration file before registering, but the CM did not do so.
reject(c) The CM attempted to register, but registration was refused due to a a number of
possible errors:
• The CM attempted to register with a minimum guaranteed upstream
bandwidth that would exceed the limits imposed by the cable upstream
admission-control command.
• The CM has been disabled because of a security violation.
• A bad class of service (COS) value in the DOCSIS configuration file.
• The CM attempted to create a new COS configuration but the CMTS is
configured to not permit such changes.
• The CM failed the timestamp check for its DOCSIS configuration file. (This
could indicate a possible theft-of-service attempt, or a problem with the
synchronization of the clocks on the CM and CMTS.)
reject(pk) KEK key assignment is rejected, BPI encryption has not been established.
reject(pkd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI encryption was
not established because KEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pk) states.
reject(pt) TEK key assignment is rejected, BPI encryption has not been established.
reject(ptd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI encryption was
not established because TEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pt) states.
Cisco IOS CMTS Cable Command Reference
CBL-1412 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem ipv6
Table 101 Descriptions for the MAC State Field (continued)1
MAC State Value Description
Note In Cisco IOS Release 12.1(20)EC, Cisco IOS Release 12.2(15)BC1, and earlier releases, when
network access is disabled in the DOCSIS configuration file sent to the CM, the network
disabled status takes precedence, and the MAC status field shows online(d) even if BPI
encryption fails. Use the show cable modem mac-address command to confirm whether BPI
is enabled or disabled for a particular cable modem.
reject(ts) The CM attempted to register, but registration failed because the TFTP server
timestamp in the CM registration request did not match the timestamp maintained
by the CMTS. This might indicate that the CM attempted to register by replaying
an old DOCSIS configuration file used during a prior registration attempt.
reject(ip) The CM attempted to register, but registration failed because the IP address in
the CM request did not match the IP address that the TFTP server recorded when
it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.
reject(na) The CM attempted to register, but registration failed because the CM did not send
a Registration-Acknowledgement (REG-ACK) message in reply to the
Registration-Response (REG-RSP) message sent by the CMTS. A
Registration-NonAcknowledgement (REG-NACK) is assumed.
1. The CM MAC state field can also be retrieved using SNMP by getting the value of the cdxCmtsCmStatusValue object in the
CISCO-DOCS-EXT-MIB.
Example of the show cable modem ipv6 prefix Command for all CMs
The following example shows sample output for the show cable modem ipv6 prefix command for all
CMs on the CMTS routers:
Router# show cable modem ipv6 prefix
Device Type: B - CM Bridge, R - CM Router
IP Assignment Method: D - DHCP
MAC Address Type D/IP IPv6 prefix
0006.2854.7275 R/D Y 2001:ODB8:3800:80C::/64
Example of the show cable modem ipv6 Command for all Registered CMs
The following example shows sample output for the show cable modem ipv6 registered command for
all registered CMs on the CMTS routers:
Router# show cable modem ipv6 registered
Interface Prim Online CPE IP Address MAC Address
Sid State
C4/0/U2 1 online 0 --- 0018.6835.27b3
C4/0/U2 2 online 0 2001:0DB8:3800:809:A896:1431:75EA:5EA1 0019.474a.c14a
C4/1/U1 2 online 0 --- 0007.0e03.6851
C4/1/U1 3 online 0 --- 0007.0e01.b085
C4/1/U1 4 online 0 2001:0DB8:3800:809:E97D:2986:9F37:FFE 0018.6835.27aa
Example of the show cable modem ipv6 cpe Command for all CMs
The following example shows sample output for the show cable modem ipv6 cpe command for all CMs
on the CMTS routers:
Router# show cable modem 0019.474a.c14a ipv6 cpe
MAC Address IP Address Domain Name
0005.0052.2c1d 2001:420:3800:809:48F7:3C33:B774:9185
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1413
Cable Commands: show cable m through show cable u
show cable modem ipv6
Related Commands Command Description
cable modem vendor Associates the name of a vendor with its Organizational Unique Identifier
(OUI).
show cable modem Displays information for the registered and unregistered CMs.
show cable modem Displays RF adaptation information for cable modems.
rf-adapt
show interface cable Displays information about the CMs connected to a particular cable
modem interface.
Cisco IOS CMTS Cable Command Reference
CBL-1414 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem mac
show cable modem mac
To display MAC layer information for one or more CMs, use the show cable modem mac command in
privileged EXEC mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem [ip-address | mac-address | cable slot/port [upstream port] | name fqdn]
mac[summary [total]]
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable slot/subslot/port [upstream port] | name
fqdn] mac[summary [total]]
Syntax Description ip-address (Optional) Specifies the IPv4 or IPv6 address of a specific CM to be
displayed. If you specify the IP address for a CPE device behind a CM,
information for that CM is displayed.
mac-address (Optional) Specifies the MAC address of a specific CM to be displayed. If
you specify the MAC address for a CPE device behind a CM, information
for that CM is displayed.
cable slot/port (Optional) Displays information for all CMs on the specified cable interface
and downstream port, where:
• slot—Specifies the chassis slot number of the cable interface line card.
• port—Specifies the downstream port number.
Valid values for these arguments are dependent on your CMTS router and
cable interface line card. Refer to the hardware documentation for your
router chassis and cable interface line card for supported slot and port
numbering.
cable slot/subslot/port (Optional) Displays information for all CMs on the specified cable interface
on a Cisco uBR10012 router, where:
• slot—Specifies the chassis slot number of the cable interface line card.
Valid slots are 5 to 8.
• subslot—Specifies the secondary slot number of the cable interface line
card. Valid subslots are 0 or 1.
• port—Specifies the downstream port number. Valid ports are 0 to 4,
depending on the cable interface line card.
upstream port (Optional) Displays information for all CMs using the specified upstream
port. You can specify this option only when displaying information for a
cable interface. The valid range for port begins with 0 and ends with a value
that depends on the number of upstream ports supported by the cable
interface line card.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1415
Cable Commands: show cable m through show cable u
show cable modem mac
name fqdn (Optional) Specifies the fully qualified domain name (FQDN) of the cable
device to be displayed. This option is only available if the show cable
modem domain-name command has been run for the first time to update
the cable DNS cache on the CMTS router.
summary [total] (Optional) Displays a summary of MAC layer information for each cable
interface. If you add the optional total keyword, the display includes a total
of CMs that are included in each of the displayed fields.
Defaults Displays MAC layer information for all CMs.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.1(4)CX and This command was introduced for the Cisco uBR7100 series,
12.2(4)BC1 Cisco uBR7200 series, and Cisco uBR10012 routers.
12.2(8)BC2 This command was enhanced to show whether a CM is capable of operating
in DOCSIS 1.0 or DOCSIS 1.1 mode, and the version for which it is
currently provisioned.
12.2(11)BC1 The mac option was enhanced to support the summary and summary total
options.
12.2(15)CX This command was enhanced to support DOCSIS 2.0 CMs using Advanced
Time Division Multiple Access (A-TDMA) modulation profiles.
12.3(17a)BC Introduced revised information that is displayed for the following two
versions of the show cable modem mac command:
• show cable modem mac summary
Refer to “Usage Guidelines.”
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA, with
the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was
added.
• The name keyword option was added for specifying the fully-qualified
domain name of a CM.
• The following new initialization states were added to show
initialization of CMs and CPEs supporting IPv6:
– init6(s)—CMTS router has seen SOLICIT message.
– init6(a)—CMTS router has seen ADVERTISE message.
– init6(r)—CMTS router has seen REQUEST message.
– init6(i)—CMTS router has seen REPLY message.
– init6(o)—CMTS router has seen version 6 TFTP request.
– init6(t)—CMTS router has seen version 6 TOD request.
Cisco IOS CMTS Cable Command Reference
CBL-1416 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem mac
Usage Guidelines
Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first
on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable
command.
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy,
the new primary processor after a switchover automatically creates a new database of the online cable
modems. This means that the show cable modem ip-address command might not show a particular cable
modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the
ping ip-address command, and then the show cable modem ip-address command will show the cable
modem. You can also display any particular cable modem by using the show cable modem | include
ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically
synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be
synchronized manually, using the hccp resync command. When a SYNC event command is occurring,
CLI commands might be very slow to respond. In particular, if you enter the show cable modem
command at the same time a SYNC event is occurring, the command might respond produce a blank
display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Cisco IOS Release 12.3(17a)BC introduces changes for two versions of the show cable modem mac
command.
• show cable modem mac summary
The information displayed with this command is revised. The DOCSIS 2.0 column in the Quality of
Service (QoS) Provision Mode field has been removed, as this field is not applicable to QoS
provisioning in DOCSIS 2.0.
Command Output in Cisco IOS Release 12.3(17a)BC and Later Releases
Router# show cable modem mac summary
Cable Modem Summary
-------------------
Mac Version QoS Provision Mode
Interface Total DOC2.0 DOC1.1 DOC1.0 Reg/Online DOC1.1 DOC1.0
Cable5/1/0/U0 10 0 2 8 10 0 10
Command Output in Cisco IOS Release 12.3(13a)BC and Earlier Releases
Router# scm mac sum
Cable Modem Summary
-------------------
Mac Version QoS Provision Mode
Interface Total DOC2.0 DOC1.1 DOC1.0 Reg/Online DOC2.0 DOC1.1 DOC1.0
Cable8/0/0/U0 8 0 5 3 5 0 5 0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1417
Cable Commands: show cable m through show cable u
show cable modem mac
Examples This section contains examples for the different forms of the show cable modem mac command.
Default Displays
The following example shows typical output for the default form of the show cable modem mac
command:
Router# show cable modem mac
MAC Address MAC Prim Ver QoS Frag Concat PHS Priv DS US
State Sid Prov Saids Sids
0050.7366.1243 online 1 DOC1.0 DOC1.0 no no no BPI 0 0
0002.b970.0027 online 2 DOC1.1 DOC1.0 no yes yes BPI+ 0 4
0006.5314.858d online 3 DOC1.1 DOC1.1 yes yes yes BPI+ 0 4
0010.64ff.e4ad online 1 DOC1.1 DOC1.0 yes yes yes BPI+ 0 4
0010.f025.1bd9 init(rc) 2 DOC1.0 DOC1.0 no no no BPI 0 0
0010.9659.4447 online(pt) 3 DOC1.0 DOC1.0 no yes no BPI 0 0
0010.9659.4461 online(pt) 4 DOC1.0 DOC1.0 no yes no BPI 0 0
0010.64ff.e459 online 5 DOC1.0 DOC1.0 no yes no BPI 0 0
0020.4089.7ed6 online 6 DOC1.0 DOC1.0 no no no BPI 0 0
0090.9607.3831 online(pt) 7 DOC1.0 DOC1.0 no no no BPI 0 0
0090.9607.3830 online(pt) 1 DOC1.0 DOC1.0 no no no BPI 0 0
0050.7366.12fb init(i) 2 DOC1.0 DOC1.0 no no no BPI 0 0
0010.fdfa.0a35 online(pt) 3 DOC1.1 DOC1.1 yes yes yes BPI+ 0 4
The following example shows sample output for the show cable modem mac command for a particular
cable interface:
Router# show cable modem c3/0 mac
MAC Address MAC Prim Ver QoS Frag Concat PHS Priv DS US
State Sid Prov Saids Sids
0050.7366.1243 online 1 DOC1.0 DOC1.0 no no no BPI 0 0
0002.b970.0027 online 2 DOC1.1 DOC1.0 no yes yes BPI+ 0 4
0006.5314.858d online 3 DOC1.1 DOC1.1 yes yes yes BPI+ 0 4
The following example shows sample output for the show cable modem mac command for a particular
CM, as identified by its MAC address:
Router# show cable modem 0010.7bb3.fcd1 mac
MAC Address MAC Prim Ver QoS Frag Concat PHS Priv DS US
State Sid Prov Saids Sids
0010.7bb3.fcd1 online 91 DOC1.1 DOC1.1 yes yes yes BPI+ 1 4
The following example shows a sample output for the show cable modem mac command for a CM, as
identified by its MAC address:
Router# show cable modem xxxx.xxxx.xxxx mac
D
MAC Address IP Address I/F MAC Prim RxPwr Timing Num I
State Sid (dBmv) Offset CPE P
xxxx.xxxx.xxxx x.x.x.x C6/0/2/U0 *online 3087 0.50 1037 0 N
Note The * in front of the MAC state indicates that the CM did not satisfy the bpi-plus-policy and the data
traffic is blocked. The cable privacy bpi-plus-policy command enforces this requirement.
Note The ! in front of the MAC state indicates that the CM has attempted to register with a modified
cm configuration file. This is possibly a non-compliant CM trying to modify the service it is receiving.
Cisco IOS CMTS Cable Command Reference
CBL-1418 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem mac
The following example shows sample output for the show cable modem mac command for a particular
CM, as identified by its IP address:
Router# show cable modem 10.1.1.10 mac
MAC Address MAC Prim Ver QoS Frag Concat PHS Priv DS US
State Sid Prov Saids Sids
0002.b970.0027 online 2 DOC1.1 DOC1.0 no yes yes BPI+ 0 4
Table 102 describes the fields shown in the default forms of the show cable modem mac displays:
Table 102 Descriptions for the Default show cable modem mac Fields
Field Description
MAC Address The MAC address for the CM.
MAC State The current state of the MAC layer (see Table 101).
Prim SID The primary SID assigned to this CM.
Ver Displays the maximum supported version of DOCSIS that the CM supports
(DOCSIS 1.0, DOCSIS 1.1, DOCSIS 2.0).
QoS Prov Displays the version of DOCSIS that the CM currently is provisioned and
registered for (DOCSIS 1.0, DOCSIS 1.1, DOCSIS 2.0).
Frag Indicates whether DOCSIS 1.1 or 2.0 MAC-layer fragmentation is enabled
for this CM.
Concat Indicates whether DOCSIS 1.1 or 2.0 MAC-layer concatenation is enabled
for this CM.
PHS Indicates whether DOCSIS 1.1 or 2.0 packet header suppression (PHS) is
enabled for this CM.
Priv Indicates whether Baseline Privacy Interface (BPI) or BPI Plus (BPI+)
encryption is enabled for the CM.
DS Saids Number of downstream security association IDs (Saids) used by this CM.
US Sids Number of upstream service IDs (SIDs) used by this CM.
Table 101 shows the possible values for the MAC state field:
Table 103 Descriptions for the MAC State Field 1
MAC State Value Description
Registration and Provisioning Status Conditions for Devices Using IPv4 Addressing
init(r1) The CM sent initial ranging.
init(r2) The CM is ranging. The CMTS received initial ranging from the Cm and has sent
RF power, timing offset, and frequency adjustments to the CM.
init(rc) Ranging has completed.
Note If a CM appears to be stuck in this state, it could be that the CM is able
to communicate successfully on the cable network, but that the upstream
is at capacity and does not have any additional bandwidth to allow the
CM to finish registration and come online. Either manually move one or
more CMs to other upstreams, or enable load balancing on the upstream
using the cable load-balance group commands.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1419
Cable Commands: show cable m through show cable u
show cable modem mac
Table 103 Descriptions for the MAC State Field (continued)1
MAC State Value Description
init(d) The DHCP request was received, as DHCPDISCOVER. This also indicates that
the first IP broadcast packet has been received from the CM.
init(dr) The DHCP request has been sent to the cable modem.
init(i) The cable modem has received the DHCPOFFER reply (DHCPACK) from the
DHCP server that has assigned an IP address to the modem, but the modem has
not yet replied with a DHCPREQUEST message requesting that particular IP
address, nor has it sent an IP packet with that IP address.
Note If a CM appears to be stuck in this state, the CM has likely received the
DHCPOFFER reply from the DHCP server, but this reply might have
contained one or more invalid options for that particular CM.
init(io) The Cisco CMTS has seen the DHCP offer as sent to the cable modem from the
DHCP server that has assigned an IP address to the modem.
init(o) The CM has begun to download the option file (DOCSIS configuration file)
using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP
response. If the CM remains in this state, it indicates that the download has
failed.
init(t) Time-of-day (TOD) exchange has started.
resetting The CM is being reset and will shortly restart the registration process.
Registration and Provisioning Status Conditions for Devices Using IPv6 Addressing
init6(s) The Cisco CMTS router has seen the DHCPv6 SOLICIT message from the CM.
init6(a) The Cisco CMTS router has seen the ADVERTISE message from the DHCPv6
server to the CM.
init6(r) The Cisco CMTS router has seen the REQUEST response from the CM to the
DHCPv6 server.
init6(i) The Cisco CMTS router has seen the REPLY message from the DHCPv6 server
to the CM.
init6(o) The Cisco CMTS router has seen the REQEST message from the CM to the TFTP
server.
init6(t) The Cisco CMTS router has seen the REQUEST message from the CM to the
TOD server.
Non-error Status Conditions
cc(r1) The CM had registered and was online, but has received a Downstream Channel
Change (DCC) or Upstream Channel Change (UCC) request message from the
CMTS. The CM has begun moving to the new channel, and the CMTS has
received the CM’s initial ranging on the new downstream or upstream channel.
At the MAC layer, the CM is considered offline because it is not yet passing
traffic on the new channel, but this state does not trigger the flap-list counters.
cc(r2) This state should normally follow cc(r1) and indicates that the CM has finished
its initial ranging on the new channel, and is currently performing continuous
ranging on the new channel. At the MAC layer, the CM is considered offline
because it is not yet passing traffic on the new channel, but this state does not
trigger the flap-list counters.
offline The CM is considered offline (disconnected or powered down).
Cisco IOS CMTS Cable Command Reference
CBL-1420 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem mac
Table 103 Descriptions for the MAC State Field (continued)1
MAC State Value Description
online The CM has registered and is enabled to pass data on the network.
online(d) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. The CM does not forward
traffic to or from the CPE devices, but the CMTS can continue to communicate
with the CM using DOCSIS messages and IP traffic (such as SNMP commands).
Note If BPI was enabled in the DOCSIS configuration file sent to the CM,
assume that the CM is using BPI encryption, unless other messages show
that the BPI negotiation and key assignments have failed.
online(pkd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled and
KEK is assigned.
Note This state is equivalent to the online(d) and online(pk) states.
online(ptd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled and
TEK is assigned. BPI encryption is now being performed.
Note This state is equivalent to the online(d) and online(pt) states.
online(pk) The CM registered, BPI is enabled and KEK is assigned.
online(pt) The CM registered, BPI is enabled and TEK is assigned. BPI encryption is now
being performed.
Note If network access was disabled in the DOCSIS configuration file sent to
the CM, the network disabled status takes precedence, and the MAC
status field shows online(d) instead of online(pt) even when BPI
encryption is enabled and operational.
Note If an exclamation point (!) appears in front of one of the online states, it indicates that the cable
dynamic-secret command has been used with either the mark or reject option, and that the
cable modem has failed the dynamic secret authentication check.
expire(pk) The CM registered, BPI is enabled, KEK was assigned, but the current KEK
expired before the CM could successfully renew a new KEK value.
expire(pkd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled,
KEK was assigned, but the current KEK expired before the CM could
successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pk) states.
expire(pt) The CM registered, BPI is enabled, TEK was assigned, but the current TEK
expired before the CM could successfully renew a new KEK value.
expire(ptd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled,
TEK was assigned, but the current TEK expired before the CM could
successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pt) states.
Error Status Conditions
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1421
Cable Commands: show cable m through show cable u
show cable modem mac
Table 103 Descriptions for the MAC State Field (continued)1
MAC State Value Description
reject(m) The CM attempted to register but registration was refused due to a bad Message
Integrity Check (MIC) value. This also could indicate that the shared secret in
the DOCSIS configuration file does not match the value configured on the CMTS
with the cable shared-secret command.
In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later
releases, this could also indicate that the cable tftp-enforce command has been
used to require that a CM attempt a TFTP download of the DOCSIS
configuration file before registering, but the CM did not do so.
reject(c) The CM attempted to register, but registration was refused due to a a number of
possible errors:
• The CM attempted to register with a minimum guaranteed upstream
bandwidth that would exceed the limits imposed by the cable upstream
admission-control command.
• The CM has been disabled because of a security violation.
• A bad class of service (COS) value in the DOCSIS configuration file.
• The CM attempted to create a new COS configuration but the CMTS is
configured to not permit such changes.
• The CM failed the timestamp check for its DOCSIS configuration file. (This
could indicate a possible theft-of-service attempt, or a problem with the
synchronization of the clocks on the CM and CMTS.)
reject(pk) KEK key assignment is rejected, BPI encryption has not been established.
reject(pkd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI encryption was
not established because KEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pk) states.
reject(pt) TEK key assignment is rejected, BPI encryption has not been established.
reject(ptd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI encryption was
not established because TEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pt) states.
Note In Cisco IOS Release 12.1(20)EC, Cisco IOS Release 12.2(15)BC1, and earlier releases, when
network access is disabled in the DOCSIS configuration file sent to the CM, the network
disabled status takes precedence, and the MAC status field shows online(d) even if BPI
encryption fails. Use the show cable modem mac-address command to confirm whether BPI
is enabled or disabled for a particular cable modem.
reject(ts) The CM attempted to register, but registration failed because the TFTP server
timestamp in the CM registration request did not match the timestamp maintained
by the CMTS. This might indicate that the CM attempted to register by replaying
an old DOCSIS configuration file used during a prior registration attempt.
Cisco IOS CMTS Cable Command Reference
CBL-1422 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem mac
Table 103 Descriptions for the MAC State Field (continued)1
MAC State Value Description
reject(ip) The CM attempted to register, but registration failed because the IP address in
the CM request did not match the IP address that the TFTP server recorded when
it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.
reject(na) The CM attempted to register, but registration failed because the CM did not send
a Registration-Acknowledgement (REG-ACK) message in reply to the
Registration-Response (REG-RSP) message sent by the CMTS. A
Registration-NonAcknowledgement (REG-NACK) is assumed.
1. The CM MAC state field can also be retrieved using SNMP by getting the value of the cdxCmtsCmStatusValue object in the
CISCO-DOCS-EXT-MIB.
Summary and Total Options
The following example shows the same display for the show cable modem mac summary command:
Router# show cable modem mac summary
Cable Modem Summary
-------------------
Mac Version QoS Provision Mode
Interface Total DOC2.0 DOC1.1 DOC1.0 Reg/Online DOC2.0 DOC1.1 DOC1.0
Cable8/1/0/U1 1 1 0 0 1 0 0 1
Cable8/1/0/U4 2 2 0 2 2 1 1 0
Router#
The following example shows the summary display when the total option is added:
Router# show cable modem mac summary total
Cable Modem Summary
-------------------
Mac Version QoS Provision Mode
Interface Total DOC2.0 DOC1.1 DOC1.0 Reg/Online DOC2.0 DOC1.1 DOC1.0
Cable5/1/0/U5 1 0 0 1 1 0 0 1
Cable6/1/0/U0 11 0 0 11 8 0 0 8
Cable6/1/1/U2 17 0 1 16 15 0 0 15
Cable7/0/0/U0 2 0 0 2 1 0 0 1
Cable7/0/0/U5 1 0 0 1 0 0 0 0
Total: 32 0 1 31 25 0 0 25
Router#
Table 104 describes the fields shown in the show cable modem mac summary displays:
Table 104 Descriptions for the show cable modem mac summary Fields
Field Description
I/F The cable interface line card providing the upstream for this CM.
Total Total number of CMs currently active on this cable interface.
MAC Version Total number of CMs on this interface that reported in their registration
DOC 2.0 request as having DOCSIS 2.0 capabilities.
MAC Version Total number of CMs on this interface that reported in their registration
DOC 1.1 request as having DOCSIS 1.1 capabilities.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1423
Cable Commands: show cable m through show cable u
show cable modem mac
Table 104 Descriptions for the show cable modem mac summary Fields (continued)
Field Description
MAC Version Total number of CMs on this interface that reported in their registration
DOC 1.0 request as having DOCSIS 1.0 capabilities.
Reg/Online Total number of CMs on this interface that have completed registration and
are currently online.
QoS Provisioned Mode Total number of CMs on this interface that have been provisioned and
DOC 2.0 registered for DOCSIS 2.0 operations.
QoS Provisioned Mode Total number of CMs on this interface that have been provisioned and
DOC 1.1 registered for DOCSIS 1.1 operations.
QoS Provisioned Mode Total number of CMs on this interface that have been provisioned and
DOC 1.0 registered for DOCSIS 1.0 operations.
Related Commands Command Description
cable modem vendor Associates the name of a vendor with its Organizational Unique
Identifier (OUI).
show cable modem Displays information for the registered and unregistered CMs.
show cable modem cnr Displays information about the upstream carrier-to-noise ratio (CNR)
for a particular cable modem.
show cable modem Displays connectivity statistics for one or more CMs.
connectivity
show cable modem errors Displays error statistics for one or more CMs.
show cable modem flap Displays flap list statistics for one or more CMs.
show cable modem Displays station maintenance (SM) error statistics for one or more
maintenance CMs.
show cable modem phy Displays the DOCSIS PHY layer information for one or more CMs.
show interface cable Displays information about the CMs connected to a particular cable
modem interface.
show interface cable sid Displays cable interface information.
Cisco IOS CMTS Cable Command Reference
CBL-1424 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem maintenance
show cable modem maintenance
To display station maintenance (SM) error statistics for one or more cable modems, use the show cable
modem maintenance command in privileged EXEC mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] maintenance
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn]
maintenance
Syntax Description ip-address (Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you
specify the IP address for a CPE device behind a CM, information for that
CM is displayed.
mac-address (Optional) MAC address of a specific CM to be displayed. If you specify the
MAC address for a CPE device behind a CM, information for that CM is
displayed.
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.
subslot (Cisco uBR10012 only) Secondary slot number of the cable interface line
card. The valid subslots are 0 or 1.
port Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—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 IOS CMTS Cable Command Reference
OL-15510-15 CBL-1425
Cable Commands: show cable m through show cable u
show cable modem maintenance
upstream port (Optional) Displays information for all CMs using the specified upstream
port. You can specify this option only when displaying information for a
cable interface. The valid range for port begins with 0 and ends with a value
that depends on the number of upstream ports supported by the cable
interface line card.
logical-channel-index (Optional) Logical channel index. The valid values are 0 or 1.
name fqdn (Optional) Specifies the fully qualified domain name (FQDN) of the cable
device to be displayed. This option is only available if the show cable
modem domain-name command has been run for the first time to update the
cable DNS cache on the CMTS router.
maintenance Displays station maintenance (SM) error statistics for one or more cable
modems.
Command Modes Privileged EXEC (#)
Command History Release Modification
11.3XA This command was introduced.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA, with
the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was
added.
• The name keyword option was added for specifying the fully-qualified
domain name of a CM.
12.2(33)SCE This command was modified. The port parameter was changed to
cable-interface-index.
12.2(33)SCF This command was modified. The logical-channel-index argument was
added.
Usage Guidelines This command displays information about the number of times that a CM has exhausted its maximum
retry attempts to respond to a Station Maintenance (SM) request, as well as the number of times that the
CMTS has aborted ranging with a CM during a Station Maintenance interval. This information can be
used to determine whether a particular cable modem or interface is experiencing plant or network
difficulties.
You can display this information for all online cable modems, all online cable modems for a specific
cable interface, or for one particular cable modem.
Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first
on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable
command.
Cisco IOS CMTS Cable Command Reference
CBL-1426 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem maintenance
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy,
the new primary processor after a switchover automatically creates a new database of the online cable
modems. This means that the show cable modem ip-address command might not show a particular cable
modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the
ping ip-address command, and then the show cable modem ip-address command will show the cable
modem. You can also display any particular cable modem by using the show cable modem | include
ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically
synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be
synchronized manually, using the hccp resync command. When a SYNC event command is occurring,
CLI commands might be very slow to respond. In particular, if you enter the show cable modem
command at the same time a SYNC event is occurring, the command might respond produce a blank
display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Examples The following example shows sample output for the show cable modem maintenance command for all
online cable modems:
Router# show cable modem maintenance
MAC Address I/F Prim SM Exhausted SM Aborted
Sid Count Time Count Time
0010.9507.01db C5/1/0/U5 1 0 --- -- 00:00:00 0 --- -- 00:00:00
0002.b96f.fdbb C6/1/0/U0 5 1 Jun 20 13:23:03 0 --- -- 00:00:00
0002.fdfa.129d C6/1/0/U0 6 0 --- -- 00:00:00 0 --- -- 00:00:00
0002.fdfa.137d C6/1/0/U0 7 0 --- -- 00:00:00 0 --- -- 00:00:00
0050.7302.3d73 C6/1/0/U0 8 0 --- -- 00:00:00 0 --- -- 00:00:00
0002.fdfa.12d5 C6/1/0/U0 9 0 --- -- 00:00:00 0 --- -- 00:00:00
0002.fdfa.1163 C6/1/0/U0 10 0 --- -- 00:00:00 0 --- -- 00:00:00
0006.28f9.8bbd C6/1/0/U0 11 0 --- -- 00:00:00 0 --- -- 00:00:00
00d0.bad3.c0cf C6/1/0/U0 12 0 --- -- 00:00:00 0 --- -- 00:00:00
0003.e38f.e85b C6/1/0/U0 14 149 Jun 21 14:24:03 0 --- -- 00:00:00
0001.9659.519f C6/1/0/U0 18 53 Jun 21 14:25:32 0 --- -- 00:00:00
0003.e3a6.8195 C6/1/0/U0 19 10 Jun 21 05:37:54 0 --- -- 00:00:00
0003.e3a6.8173 C6/1/1/U2 15 2 Jun 20 13:41:27 0 --- -- 00:00:00
0002.fdfa.12ef C6/1/1/U2 16 1 Jun 20 13:16:30 0 --- -- 00:00:00
0002.fdfa.12e9 C6/1/1/U2 17 1 Jun 20 13:16:30 0 --- -- 00:00:00
0003.e3a6.7f69 C6/1/1/U2 18 2 Jun 20 13:43:10 0 --- -- 00:00:00
0030.80bc.3095 C6/1/1/U2 19 2 Jun 20 13:45:00 0 --- -- 00:00:00
0003.e38f.e9ab C6/1/1/U2 20 1 Jun 20 13:43:47 0 --- -- 00:00:00
0006.28f9.9d19 C6/1/1/U2 22 0 --- -- 00:00:00 0 --- -- 00:00:00
0003.e3a6.7fe3 C6/1/1/U2 23 0 --- -- 00:00:00 0 --- -- 00:00:00
0020.4005.3f06 C6/1/1/U2 24 0 --- -- 00:00:00 0 --- -- 00:00:00
Router#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1427
Cable Commands: show cable m through show cable u
show cable modem maintenance
The following example shows sample output for the show cable modem maintenance command for all
cable modems on a specific cable interface:
Router# show cable modem c8/1/0 maintenance
MAC Address I/F Prim SM Exhausted SM Aborted
Sid Count Time Count Time
0050.7366.1243 C8/1/0/U1 1 1 Apr 28 13:06:11 0 --- -- 00:00:00
0002.b970.0027 C8/1/0/U4 2 0 --- -- 00:00:00 0 --- -- 00:00:00
0006.5314.858d C8/1/0/U4 3 2 Apr 28 13:07:28 0 --- -- 00:00:00
Router#
The following example shows sample output for the show cable modem maintenance command for a
particular CM:
Router# show cable modem 0010.7bb3.fcd1 maintenance
MAC Address I/F Prim SM Exhausted SM Aborted
Sid Count Time Count Time
0010.7bb3.fcd1 C5/0/U5 1 3 Jun 1 10:24:52 0 Jan 1 00:00:00
Router#
Table 105 describes the fields shown in the show cable modem maintenance displays:
Table 105 Descriptions for the show cable modem maintenance Fields
Field Description
MAC Address The MAC address for the CM.
I/F The cable interface line card, including upstream, for this CM.
Prim SID The primary SID assigned to this CM.
SM Exhausted Number of times this CM has repeatedly timed out and exhausted the
Count maximum allowable retry attempts when it was sent a Station Maintenance
request. The CMTS responds by taking the CM offline, forcing the CM to
reinitialize and reregister.
SM Exhausted The last time that this CM repeatedly timed out and exhausted the maximum
Time allowable retry attempts when it was sent a Station Maintenance request.
SM Aborted Number of times the CMTS has aborted ranging for a CM during a Station
Count Maintenance period, typically because the CM has been reset.
SM Aborted The last time the CMTS aborted ranging for a CM during a Station
Time Maintenance period, typically because the CM has been reset.
Related Commands Command Description
cable flap-list Configures the threshold for recording a flap-list event, in terms of missed
miss-threshold Station Maintenance messages.
cable modem vendor Associates the name of a vendor with its Organizational Unique Identifier
(OUI).
show cable modem Displays information for the registered and unregistered CMs.
show cable modem Displays displays voice call information for a particular CM, identified
calls either by its IP address or MAC address.
Cisco IOS CMTS Cable Command Reference
CBL-1428 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem maintenance
Command Description
show cable modem Displays information about the upstream carrier-to-noise ratio (CNR) for a
cnr particular cable modem.
show cable modem Updates the cable-specific DNS cache and display the domain name for
domain-name specified CMs and CPE behind a CM on a Cisco CMTS router.
show cable modem Displays information collected by the remote-query feature.
remote-query
show cable modem Displays RF adaptation information for cable modems.
rf-adapt
show cable Displays modulation profile group information.
modulation-profile
show interface cable Displays information about the CMs connected to a particular cable
modem interface.
show interface cable Displays cable interface information.
sid
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1429
Cable Commands: show cable m through show cable u
show cable modem offline
show cable modem offline
To display a list of the cable modems (CMs) that are marked as offline with the Cisco CMTS router, use
the show cable modem offline command in privileged EXEC mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] offline
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn]
offline
Syntax Description ip-address (Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you
specify the IP address for a CPE device behind a CM, information for that
CM is displayed.
mac-address (Optional) MAC address of a specific CM to be displayed. If you specify the
MAC address for a CPE device behind a CM, information for that CM is
displayed.
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.
subslot (Cisco uBR10012 only) Secondary slot number of the cable interface line
card. The valid subslots are 0 or 1.
port Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—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 IOS CMTS Cable Command Reference
CBL-1430 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem offline
upstream port (Optional) Displays information for all CMs using the specified upstream
port. You can specify this option only when displaying information for a
cable interface. The valid range for port begins with 0 and ends with a value
that depends on the number of upstream ports supported by the cable
interface line card.
logical-channel-index (Optional) Logical channel index. The valid values are 0 or 1.
name fqdn (Optional) Specifies the fully qualified domain name (FQDN) of the cable
device to be displayed. This option is only available if the show cable
modem domain-name command has been run for the first time to update the
cable DNS cache on the CMTS router.
offline Displays a list of the cable modems that are marked as offline.
Defaults Displays a list of all offline CMs known by the Cisco CMTS router.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.0(7)XR and This command was introduced.
12.1(1a)T1
12.2(4)BC1 Support for the Cisco uBR10012 router was introduced.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA, with
the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was
added.
• The name keyword option was added for specifying the fully-qualified
domain name of a CM.
• The following new initialization states were added to show
initialization of CMs and CPEs supporting IPv6:
– init6(s)—CMTS router has seen SOLICIT message.
– init6(a)—CMTS router has seen ADVERTISE message.
– init6(r)—CMTS router has seen REQUEST message.
– init6(i)—CMTS router has seen REPLY message.
– init6(o)—CMTS router has seen version 6 TFTP request.
– init6(t)—CMTS router has seen version 6 TOD request.
12.2(33)SCE This command was modified. The port parameter was changed to
cable-interface-index.
12.2(33)SCF This command was modified. The logical-channel-index argument was
added.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1431
Cable Commands: show cable m through show cable u
show cable modem offline
Usage Guidelines This command displays a list of CMs that had either been online previously or had attempted to register
with the CMTS, but that are now considered offline. Offline cable modems remain in the CMTS
databases for 24 hours and then are deleted.
Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first
on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable
command.
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy,
the new primary processor after a switchover automatically creates a new database of the online cable
modems. This means that the show cable modem ip-address command might not show a particular cable
modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the
ping ip-address command, and then the show cable modem ip-address command will show the cable
modem. You can also display any particular cable modem by using the show cable modem | include
ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically
synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be
synchronized manually, using the hccp resync command. When a SYNC event command is occurring,
CLI commands might be very slow to respond. In particular, if you enter the show cable modem
command at the same time a SYNC event is occurring, the command might respond produce a blank
display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Examples The following example shows sample output for the default form of the show cable modem offline
command.
Router# show cable modem offline
Interface MAC address Prim Previous Offline Rx Rx SM
Sid State Time Power SNR Exhaust
Count
Cable5/0/U0 0030.946a.5d61 1 init(i) Jun 14 21:31:57 0.00 31.86 162
Cable5/0/U0 0030.946a.5d85 2 init(i) Jun 14 22:47:39 -0.25 31.26 156
Cable5/0/U0 0030.946a.5b6d 3 init(i) Jun 14 14:20:11 1.00 30.56 166
The following example shows sample output for the show cable modem offline command for a
particular upstream on a cable interface:
Router# show cable modem c3/0 upstream 0 offline
Interface MAC address Prim Previous Offline Rx Rx SM
Sid State Time Power SNR Exhaust
Count
C3/0/U0 0050.7366.1c69 58 init(rc) Jan 7 16:46:49 4.50 26.72 2
C3/0/U0 0050.7366.1c53 59 init(rc) Jan 7 16:47:09 5.25 25.10 1
C3/0/U0 0050.7366.1ca7 60 init(rc) Jan 7 16:47:11 5.00 25.57 1
Cisco IOS CMTS Cable Command Reference
CBL-1432 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem offline
C3/0/U0 0050.7366.1c45 61 init(rc) Jan 7 16:49:27 5.00 26.74 2
C3/0/U0 0050.7366.1c95 62 init(rc) Jan 7 16:51:29 5.50 31.82 1
C3/0/U0 0050.7366.1c99 64 init(rc) Jan 7 16:52:55 5.25 26.76 2
The following example shows sample output for the show cable modem offline command for a single
CM, as identified by its IP address:
Router# show cable modem 22.1.1.10 offline
Interface MAC address Prim Previous Offline Rx Rx SM
Sid State Time Power SNR Exhaust
Count
Cable5/0/U0 0030.946a.5b6d 3 init(i) Jun 14 14:20:11 1.00 30.56 166
The following example shows sample output for the show cable modem offline command for a single
CM, as identified by its MAC address:
Router# show cable modem 0030.946a.5d61 offline
Interface MAC address Prim Previous Offline Rx Rx SM
Sid State Time Power SNR Exhaust
Count
Cable5/0/U0 0030.946a.5d61 1 init(i) Jun 14 21:31:57 0.00 31.86 162
Table 106 describes the major fields shown in the show cable modem offline displays:
Table 106 Descriptions for the show cable modem offline Fields
Field Description
Interface The cable interface line card that this CM last used when it was online.
MAC address Hardware MAC address for this CM.
Prim SID The primary SID that had been last assigned to this CM before it went offline.
Previous State The last known state of the MAC layer for this CM before it went offline (see
Table 101).
Note A pound sign (#) in the Previous State column indicates that the cable
tftp-enforce mark-only command has been used to require that a CM
attempt a TFTP download of the DOCSIS configuration file before
registering, but the CM did not do so (Cisco IOS Release
12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases).
Offline Time The time and date that this CM last went offline.
Rx Power The last known received power level (in dB) for the CM before it went
offline.
Note An asterisk (*) in the Rx Power column indicates that a power
adjustment was made for that CM. An exclamation point (!) indicates
that the CM had reached its maximum power transmit level and could
not increase its power level further.
Rx SNR The last known signal-to-noise ratio (SNR) value for this CM before it went
offline.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1433
Cable Commands: show cable m through show cable u
show cable modem offline
Table 106 Descriptions for the show cable modem offline Fields (continued)
Field Description
SM Exhaust Count Number of times that this CM has exhausted the maximum allowable retries
for not responding to the regular Station Maintenance (SM) messages sent to
it by the CMTS.
Note Using the clear counters command to reset a cable interface’s counters also resets the SM
Exhaust Count field for all offline CMs to zero and resets the Offline Time field for all offline
CMs to the current time.
Table 101 shows the possible values for the Previous State field:
Table 107 Descriptions for the Previous State Field 1
MAC State Value Description
Registration and Provisioning Status Conditions for Devices Using IPv4 Addressing
init(r1) The CM sent initial ranging.
init(r2) The CM is ranging. The CMTS received initial ranging from the Cm and has sent
RF power, timing offset, and frequency adjustments to the CM.
init(rc) Ranging has completed.
Note If a CM appears to be stuck in this state, it could be that the CM is able
to communicate successfully on the cable network, but that the upstream
is at capacity and does not have any additional bandwidth to allow the
CM to finish registration and come online. Either manually move one or
more CMs to other upstreams, or enable load balancing on the upstream
using the cable load-balance group commands.
init(d) The DHCP request was received, as DHCPDISCOVER. This also indicates that
the first IP broadcast packet has been received from the CM.
init(dr) The DHCP request has been sent to the cable modem.
init(i) The cable modem has received the DHCPOFFER reply (DHCPACK) from the
DHCP server that has assigned an IP address to the modem, but the modem has
not yet replied with a DHCPREQUEST message requesting that particular IP
address, nor has it sent an IP packet with that IP address.
Note If a CM appears to be stuck in this state, the CM has likely received the
DHCPOFFER reply from the DHCP server, but this reply might have
contained one or more invalid options for that particular CM.
init(io) The Cisco CMTS has seen the DHCP offer as sent to the cable modem from the
DHCP server that has assigned an IP address to the modem.
init(o) The CM has begun to download the option file (DOCSIS configuration file)
using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP
response. If the CM remains in this state, it indicates that the download has
failed.
init(t) Time-of-day (TOD) exchange has started.
resetting The CM is being reset and will shortly restart the registration process.
Registration and Provisioning Status Conditions for Devices Using IPv6 Addressing
init6(s) The Cisco CMTS router has seen the DHCPv6 SOLICIT message from the CM.
Cisco IOS CMTS Cable Command Reference
CBL-1434 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem offline
Table 107 Descriptions for the Previous State Field (continued)1
MAC State Value Description
init6(a) The Cisco CMTS router has seen the ADVERTISE message from the DHCPv6
server to the CM.
init6(r) The Cisco CMTS router has seen the REQUEST response from the CM to the
DHCPv6 server.
init6(i) The Cisco CMTS router has seen the REPLY message from the DHCPv6 server
to the CM.
init6(o) The Cisco CMTS router has seen the REQEST message from the CM to the TFTP
server.
init6(t) The Cisco CMTS router has seen the REQUEST message from the CM to the
TOD server.
Non-error Status Conditions
cc(r1) The CM had registered and was online, but has received a Downstream Channel
Change (DCC) or Upstream Channel Change (UCC) request message from the
CMTS. The CM has begun moving to the new channel, and the CMTS has
received the CM’s initial ranging on the new downstream or upstream channel.
At the MAC layer, the CM is considered offline because it is not yet passing
traffic on the new channel, but this state does not trigger the flap-list counters.
cc(r2) This state should normally follow cc(r1) and indicates that the CM has finished
its initial ranging on the new channel, and is currently performing continuous
ranging on the new channel. At the MAC layer, the CM is considered offline
because it is not yet passing traffic on the new channel, but this state does not
trigger the flap-list counters.
offline The CM is considered offline (disconnected or powered down).
online The CM has registered and is enabled to pass data on the network.
online(d) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. The CM does not forward
traffic to or from the CPE devices, but the CMTS can continue to communicate
with the CM using DOCSIS messages and IP traffic (such as SNMP commands).
Note If BPI was enabled in the DOCSIS configuration file sent to the CM,
assume that the CM is using BPI encryption, unless other messages show
that the BPI negotiation and key assignments have failed.
online(pkd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled and
KEK is assigned.
Note This state is equivalent to the online(d) and online(pk) states.
online(ptd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled and
TEK is assigned. BPI encryption is now being performed.
Note This state is equivalent to the online(d) and online(pt) states.
online(pk) The CM registered, BPI is enabled and KEK is assigned.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1435
Cable Commands: show cable m through show cable u
show cable modem offline
Table 107 Descriptions for the Previous State Field (continued)1
MAC State Value Description
online(pt) The CM registered, BPI is enabled and TEK is assigned. BPI encryption is now
being performed.
Note If network access was disabled in the DOCSIS configuration file sent to
the CM, the network disabled status takes precedence, and the MAC
status field shows online(d) instead of online(pt) even when BPI
encryption is enabled and operational.
Note If an exclamation point (!) appears in front of one of the online states, it indicates that the cable
dynamic-secret command has been used with either the mark or reject option, and that the
cable modem has failed the dynamic secret authentication check.
expire(pk) The CM registered, BPI is enabled, KEK was assigned, but the current KEK
expired before the CM could successfully renew a new KEK value.
expire(pkd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled,
KEK was assigned, but the current KEK expired before the CM could
successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pk) states.
expire(pt) The CM registered, BPI is enabled, TEK was assigned, but the current TEK
expired before the CM could successfully renew a new KEK value.
expire(ptd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled,
TEK was assigned, but the current TEK expired before the CM could
successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pt) states.
Error Status Conditions
reject(m) The CM attempted to register but registration was refused due to a bad Message
Integrity Check (MIC) value. This also could indicate that the shared secret in
the DOCSIS configuration file does not match the value configured on the CMTS
with the cable shared-secret command.
In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later
releases, this could also indicate that the cable tftp-enforce command has been
used to require that a CM attempt a TFTP download of the DOCSIS
configuration file before registering, but the CM did not do so.
reject(c) The CM attempted to register, but registration was refused due to a a number of
possible errors:
• The CM attempted to register with a minimum guaranteed upstream
bandwidth that would exceed the limits imposed by the cable upstream
admission-control command.
• The CM has been disabled because of a security violation.
• A bad class of service (COS) value in the DOCSIS configuration file.
• The CM attempted to create a new COS configuration but the CMTS is
configured to not permit such changes.
• The CM failed the timestamp check for its DOCSIS configuration file. (This
could indicate a possible theft-of-service attempt, or a problem with the
synchronization of the clocks on the CM and CMTS.)
Cisco IOS CMTS Cable Command Reference
CBL-1436 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem offline
Table 107 Descriptions for the Previous State Field (continued)1
MAC State Value Description
reject(pk) KEK key assignment is rejected, BPI encryption has not been established.
reject(pkd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI encryption was
not established because KEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pk) states.
reject(pt) TEK key assignment is rejected, BPI encryption has not been established.
reject(ptd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI encryption was
not established because TEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pt) states.
Note In Cisco IOS Release 12.1(20)EC, Cisco IOS Release 12.2(15)BC1, and earlier releases, when
network access is disabled in the DOCSIS configuration file sent to the CM, the network
disabled status takes precedence, and the MAC status field shows online(d) even if BPI
encryption fails. Use the show cable modem mac-address command to confirm whether BPI
is enabled or disabled for a particular cable modem.
reject(ts) The CM attempted to register, but registration failed because the TFTP server
timestamp in the CM registration request did not match the timestamp maintained
by the CMTS. This might indicate that the CM attempted to register by replaying
an old DOCSIS configuration file used during a prior registration attempt.
reject(ip) The CM attempted to register, but registration failed because the IP address in
the CM request did not match the IP address that the TFTP server recorded when
it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.
reject(na) The CM attempted to register, but registration failed because the CM did not send
a Registration-Acknowledgement (REG-ACK) message in reply to the
Registration-Response (REG-RSP) message sent by the CMTS. A
Registration-NonAcknowledgement (REG-NACK) is assumed.
1. The CM MAC state field can also be retrieved using SNMP by getting the value of the cdxCmtsCmStatusValue object in the
CISCO-DOCS-EXT-MIB.
Related Commands Command Description
cable modem vendor Associates the name of a vendor with its Organizational Unique Identifier
(OUI).
clear counters Clears counters for one or all interfaces.
show cable modem Displays information for the registered and unregistered CMs.
show cable modem Displays the access groups for the CMs on a particular cable interface.
access-group
show cable modem Displays information about the classifiers for a particular CM.
classifiers
show cable modem Displays connectivity statistics for one or more CMs.
connectivity
show cable modem Displays the CPE devices accessing the cable interface through a particular
cpe CM.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1437
Cable Commands: show cable m through show cable u
show cable modem offline
Command Description
show cable modem Displays a list of the CMs that are marked as registered with the
registered Cisco CMTS.
show cable modem Displays RF adaptation information for cable modems.
rf-adapt
show cable modem Displays a list of the CMs that are marked as unregistered with the
unregistered Cisco CMTS.
show cable modem Displays the vendor name or Organizational Unique Identifier (OUI) for the
vendor CMs on each cable interface.
show interface cable Displays information about the CMs connected to a particular cable
modem interface.
show interface cable Displays cable interface information.
sid
Cisco IOS CMTS Cable Command Reference
CBL-1438 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem partial-mode
show cable modem partial-mode
To display information about cable modems that are in upstream and downstream partial service mode,
use the show cable modem partial-mode command in privileged EXEC mode.
show cable modem partial-mode
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCD2 This command was introduced.
Usage Guidelines If all cable modems are in full service mode (all downstream and upstream channels of the cable modems
are online and operational), then the show cable modem partial-mode command does not provide any
output. This command provides output only when the cable modems register in partial service mode (one
or more downstream or upstream channels of the downstream or upstream bonded cable modems are not
operational).
Examples The following is a sample output of the show cable modem partial-mode command that displays all
the cable modems in partial service mode:
Router# show cable modem partial-mode
MAC Address IP Address I/F MAC Prim RCC UP-reason/
State Sid ID Failed-tcs
001e.6bfb.33a0 2.99.81.14 C7/0/0/p p-online(pt) 3 2 0x1 / 0x4
0022.cef4.3d9a 2.99.81.23 C7/0/0/p p-online(pt) 4 2 0x1 / 0x4
001e.6bfb.194e 2.99.81.32 C7/0/0/p p-online(pt) 6 2 0x1 / 0x4
001e.6bfb.1538 2.99.81.38 C7/0/0/p p-online(pt) 8 2 0x1 / 0x4
001e.6bfb.0d22 2.99.81.29 C7/0/0/p p-online(pt) 9 1 0x1 / 0x4
001e.6bfb.1a7e 2.99.81.30 C7/0/0/p p-online(pt) 10 1 0x1 / 0x4
001e.6bfa.f58a 2.99.81.9 C7/0/0/p p-online(pt) 12 1 0x1 / 0x4
0022.cef4.3fa2 2.99.81.24 C7/0/0/p p-online(pt) 13 2 0x1 / 0x4
001e.6bfb.1b72 2.99.81.10 C7/0/0/p p-online(pt) 14 2 0x1 / 0x4
0023.be50.e578 2.99.81.17 C7/0/0/UB p-online(pt) 16 2 N/A
0025.2e2d.784a 2.99.81.28 C7/0/0/UB p-online(pt) 17 2 N/A
0025.2e2d.748c 2.99.81.26 C7/0/0/UB p-online(pt) 18 2 N/A
Table 108 describes the significant fields shown in the display.
Table 108 show cable modem partial-mode Field Descriptions
Field Description
MAC Address MAC address of the cable modem.
IP Address IP address that the DHCP server has assigned to the cable modem.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1439
Cable Commands: show cable m through show cable u
show cable modem partial-mode
Table 108 show cable modem partial-mode Field Descriptions (continued)
Field Description
I/F Cable interface line card providing the upstream for the cable
modem.
MAC State Current state of the MAC layer.
Prim Sid Primary Service ID (SID) assigned to the cable modem.
RCC ID Receive channel configuration (RCC) ID of the cable modem.
UP-reason/Failed-tcs • UP-reason—Upstream partial service reason. This is a bitmap
defined in upstream resiliency.
• Failed-tcs—Transmit channel set (TCS) bitmap of the cable
modem, which is not available.
Related Commands Command Description
show cable modem Displays information about the registered and unregistered cable modems.
show cable modem Displays information about the DOCSIS version of cable modems on one or
docsis-version more cable interfaces.
Cisco IOS CMTS Cable Command Reference
CBL-1440 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem partial-service
show cable modem partial-service
To display the impaired state of the cable modems on the Cisco CMTS router, use the show cable
modem partial-service command in privileged EXEC mode.
show cable modem partial-service
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCG This command was introduced.
Examples The following is a sample output of the show cable modem partial-service command:
Router# show cable modem partial-service
MAC Address IP Address I/F MAC DSxUS Impaired Impaired
State State DS US
54d4.6ffb.2f6b 40.4.58.16 C7/0/0/p w-online(pt) 3x3 1
54d4.6ffb.30fd 40.4.58.14 C7/0/0/p w-online(pt) 3x3 1
4458.2945.2ade 40.4.58.18 C7/0/0/p w-online(pt) 3x3 1
001e.6bfc.d1ea 40.4.58.26 C7/0/0/p w-online 3x3 1
54d4.6ffb.2e21 40.4.58.5 C7/0/0/p w-online(pt) 3x3 1
54d4.6ffb.2e1b 40.4.58.23 C7/0/0/p w-online(pt) 3x3 1
4458.2945.2a78 40.4.58.21 C7/0/0/p w-online(pt) 3x3 1
4458.2945.4604 40.4.58.19 C7/0/0/p w-online(pt) 3x3 1
54d4.6ffb.2e66 --- C8/0/0/p w-online(pt) 3x3 1
Table 83 describes the significant fields shown in the display:
Table 109 show cable modem partial-service Field Descriptions
Field Description
MAC Address MAC address of the cable modem.
IP Address IP address of the cable modem.
I/F Interface on the cable modem.
MAC State State of the cable modem.
DSxUS State State of the downstream and upstream channels on the cable modem.
Impaired DS Name of the impaired downstream RF channel.
Impaired US Port number of the impaired upstream RF channel.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1441
Cable Commands: show cable m through show cable u
show cable modem partial-service
Related Commands Command Description
show cable modem Displays information for the registered and unregistered cable
modems.
show interface cable modem Displays information about the cable modems connected to a
particular cable interface.
Cisco IOS CMTS Cable Command Reference
CBL-1442 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem phy
show cable modem phy
To display DOCSIS PHY layer information for one or more cable modems (CMs), use the show cable
modem phy command in privileged EXEC mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] phy
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] phy
Syntax Description ip-address (Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you
specify the IP address for a CPE device behind a CM, information for that
CM is displayed.
mac-address (Optional) MAC address of a specific CM to be displayed. If you specify the
MAC address for a CPE device behind a CM, information for that CM is
displayed.
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.
subslot (Cisco uBR10012 only) Secondary slot number of the cable interface line
card. The valid subslots are 0 or 1.
port Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—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.
upstream port (Optional) Displays information for all CMs using the specified upstream
port. You can specify this option only when displaying information for a
cable interface. The valid range for port begins with 0 and ends with a value
that depends on the number of upstream ports supported by the cable
interface line card.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1443
Cable Commands: show cable m through show cable u
show cable modem phy
logical-channel-index (Optional) Logical channel index. The valid values are 0 or 1.
name fqdn (Optional) Specifies the fully qualified domain name (FQDN) of the cable
device to be displayed. This option is only available if the show cable
modem domain-name command has been run for the first time to update the
cable DNS cache on the CMTS router.
phy Displays DOCSIS PHY layer information for one or more cable modems.
Defaults Displays PHY information for all CMs.
Command Modes Privileged EXEC (#)
Command History This table includes the following release-specific history entries:
• CX and BC Releases
• SC Release
CX and BC Releases Modification
12.1(4)CX and This command was introduced for the Cisco uBR7100 series,
12.2(4)BC1 Cisco uBR7200 series, and CIsco uBR10012 routers.
12.2(15)BC2 The service ID (SID) and Mode fields were added to the default display.
12.3(17a)BC Enhanced the show cable modem phy command. The MicroReflec column
(MicroReflections) has been removed, and the DOCSIS Prov (DOCSIS
Provider) column has been added in its place. This new column contains
DOCSIS version information. See updated examples.
SC Release Modification
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA, with
the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was
added.
• The name keyword option was added for specifying the fully-qualified
domain name of a CM.
12.2(33)SCC For DOCSIS 3.0-certified cable modems with multiple upstream channels,
the command output was modified to display PHY layer details of each
upstream channel. In this case, the output may contain multiple results for
the same MAC address. The asterix (*) that appears beside the DOCSIS
operating mode under the Mode column identifies that the CM is operating
in the MTC mode.
12.2(33)SCE This command was modified. The port parameter was changed to
cable-interface-index.
12.2(33)SCF This command was modified. The logical-channel-index argument was
added.
Cisco IOS CMTS Cable Command Reference
CBL-1444 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem phy
Usage Guidelines This command displays information about the DOCSIS PHY layer for one or more CMs. You can
display information for all CMs, for all CMs on a particular cable interface, or for a particular CM, as
identified by its IP or MAC address.
Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first
on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable
command.
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy,
the new primary processor after a switchover automatically creates a new database of the online cable
modems. This means that the show cable modem ip-address command might not show a particular cable
modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the
ping ip-address command, and then the show cable modem ip-address command will show the cable
modem. You can also display any particular cable modem by using the show cable modem | include
ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically
synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be
synchronized manually, using the hccp resync command. When a SYNC event command is occurring,
CLI commands might be very slow to respond. In particular, if you enter the show cable modem
command at the same time a SYNC event is occurring, the command might respond produce a blank
display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Examples Example from Cisco IOS Release 12.3(17a)BC and Later Releases
Cisco IOS Release 12.3(17a)BC introduces revised output for the show cable modem phy command.
The MicroReflec column (MicroReflections) has been removed, and the DOCSIS Prov (DOCSIS
Provider) column has been added in its place. This new column contains DOCSIS version information.
Router# show cable modem phy
MAC Address I/F Sid USPwr USSNR Timing DSPwr DSSNR Mode DOCSIS
(dBmV) (dB) Offset (dBmV) (dB) Prov
0003.e350.9a3f C5/1/0/U0 1 0.00 30.23 2811 0.00 ----- tdma 1.0
0050.734e.c1a1 C5/1/0/U0 2 0.00 30.47 2811 0.00 ----- tdma 1.0
0007.0e01.1749 C5/1/0/U0 3 0.00 30.65 2808 0.00 ----- tdma 1.0
0007.0e00.90dd C5/1/0/U0 4 0.00 30.66 2806 0.00 ----- tdma 1.0
0003.e350.9ad3 C5/1/0/U0 5 0.00 30.47 2810 0.00 ----- tdma 1.0
0003.e38f.f4e5 C5/1/0/U0 6 0.00 30.36 2813 0.00 ----- tdma 1.0
0003.e350.9b97 C5/1/0/U0 7 0.00 30.44 2812 0.00 ----- tdma 1.0
0003.e350.9bed C5/1/0/U0 8 0.00 30.16 2814 0.00 ----- tdma 1.0
0003.e308.455d C5/1/0/U0 9 0.00 30.79 2811 0.00 ----- tdma 1.0
0003.6bd6.bfaf C5/1/0/U0 10 0.00 30.40 2813 0.00 ----- tdma 1.0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1445
Cable Commands: show cable m through show cable u
show cable modem phy
Examples from Cisco IOS Release 12.3(13a)BC and Earlier Releases
Router# show cable modem phy
MAC Address I/F Sid USPwr USSNR Timing MicroReflec DSPwr DSSNR Mode
(dBmV) (dB) Offset (dBc) (dBmV) (dB)
0008.0e06.7b14 C8/0/0/U0 1 0.00 30.36 1938 0 0.00 ----- tdma
0050.f112.5977 C8/0/0/U0 2 0.00 30.36 1695 0 0.00 ----- tdma
0090.837b.b0b9 C8/0/0/U0 3 0.00 30.64 1187 0 0.00 ----- tdma
0007.0e03.6e99 C8/0/0/U0 5 0.00 30.36 2747 0 0.00 ----- tdma
0007.0e04.5091 C8/0/0/U0 6 0.00 30.94 2746 0 0.00 ----- tdma
0006.5314.81d9 C8/0/0/U0 7 0.00 30.36 2745 0 0.00 ----- tdma
0003.6b1b.ee63 C8/0/0/U0 8 0.00 31.26 2745 0 0.00 ----- tdma
0030.eb15.84e7 C8/0/0/U0 12 0.00 30.36 1157 0 0.00 ----- tdma
The following example shows sample output for the show cable modem phy command for all CMs on
the Cisco CMTS router:
Router# show cable modem phy
MAC Address I/F Sid USPwr USSNR Timing MicroReflec DSPwr DSSNR Mode
(dBmV) (dBmV) Offset (dBc) (dBmV) (dBmV)
0008.0e09.81f8 C3/0 1 50.00 28.40 1705 26 -3.4 36.02 tdma
0003.6b3c.1aa7 C3/0 2 0.00 28.27 3643 0 0.00 ----- tdma
0008.0e09.7fe2 C4/0 3 35.00 28.44 1760 27 12.00 35.03 tdma
The following example shows sample output for the show cable modem phy command for all CMs on
a particular cable interface:
Router# show cable modem cable 3/0 phy
MAC Address I/F Sid USPwr USSNR Timing MicroReflec DSPwr DSSNR Mode
(dBmV) (dBmV) Offset (dBc) (dBmV) (dBmV)
0008.0e09.81f8 C3/0 1 50.00 28.40 1705 26 -3.4 36.02 tdma
0003.6b3c.1aa7 C3/0 2 0.00 28.27 3643 0 0.00 ----- tdma
The following example shows sample output for the show cable modem phy command for a particular
CM:
Router# show cable modem 0050.7366.1243 phy
MAC Address I/F Sid USPwr USSNR Timing MicroReflec DSPwr DSSNR Mode
(dBmV) (dBmV) Offset (dBc) (dBmV) (dBmV)
0050.6736.4124 C3/0 14 38.00 24.58 1651 0 8.00 35.41 tdma
Example from Cisco IOS Release 12.2(33)SCD
The following example shows a sample output of the show cable modem phy command for all CMs on
the Cisco CMTS router:
Router# show cable modem phy
MAC Address I/F Sid USPwr USMER Timing DSPwr DSMER Mode DOCSIS
(dBmV) (SNR) Offset (dBmV) (SNR) Prov
(dB) (dB)
001c.ea37.9b5c C3/0/U2.0 27 0.00 36.12 5394 0.00 ----- tdma 1.1
001c.ea37.9b78 C3/0/U2.0 29 0.00 36.12 5396 0.00 ----- tdma 1.1
001c.ea37.9b5a C3/0/U3.0 31 0.00 36.12 5394 0.00 ----- tdma 1.1
001c.ea37.9ba4 C3/0/U2.0 32 0.00 36.12 5393 0.00 ----- tdma 1.1
001c.ea37.9aac C3/1/U2.1 28 0.00 36.12 5620 0.00 ----- tdma 1.1
001a.c3ff.d1a4 C3/1/U0.0 29 43.50 36.12 6020 0.00 ----- tdma* 1.1
001a.c3ff.d1a4 C3/1/U1.0 29 43.50 36.12 6020 0.00 ----- tdma* 1.1
001a.c3ff.d1a4 C3/1/U2.0 29 43.50 36.12 6019 0.00 ----- tdma* 1.1
001a.c3ff.d1a4 C3/1/U3.0 29 43.50 36.12 6021 0.00 ----- tdma* 1.1
Cisco IOS CMTS Cable Command Reference
CBL-1446 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem phy
Table 110 describes the fields shown in the show cable modem phy displays:
Table 110 Descriptions for the show cable modem phy Fields
Field Description
MAC Address The MAC address for the CM.
I/F The cable interface on the CMTS that is providing services for this CM.
SID Service ID that this CM is using.
USPwr (dBmV) Displays the CM transmit level in dBmV, as measured by the CMTS.
USSNR (dBmV) Upstream signal-to-noise ratio (SNR) or carrier-to-noise ratio (CNR), in dB,
as measured by the CMTS. This field shows the CNR value for cable
interfaces that support onboard hardware-based spectrum management, such
as the Cisco uBR-MC16S card, and shows the SNR value for other cable
interfaces.
Note Although the field name shows the value as being given in dBmV, the
actual value should be interpreted in dB.
Timing Offset The timing offset for the CM, in ticks, as recognized on the CMTS. (A tick,
as used here, is 6.25/64 microseconds.) This is the delay between when a
particular cable modem is scheduled to make a transmission and when the
CMTS actually receives it.
Note An exclamation point (!) in the Timing Offset column indicates that
the CM has exceeded the maximum delay and timing offset specified
by the cable map-advance command.
Note The timing offset shown here is typically smaller than the TX Time
Offset value shown by the show cable modem remote-query
command, because the latter value is the offset as recognized on the
CM (which will include any internal delay between when the CM
software begins the transmission and when the bits actually appear on
the local cable interface).
Microreflec (dBc) The approximate value of microreflections on the downstream, measured in
dBc below the signal level, as seen by the CM. Microreflections are a type of
impairment that is caused by impedance mismatches between amplifiers,
couples, cables, and other equipment in the cable plant. Microreflections
create copies of a signal that arrive at the receiver with different amounts of
delay and attenuation, generating intersymbol interference (ISI) that can
cause the receiver to improperly detect the amplitude and phase of the
incoming signal.
Note This value is not exact but provides an approximate indication of the
microreflections that have been received.
DSPwr (dBmV) Downstream receive power level, in dBmV, as reported by the CM.
DSSNR (dBmV) Downstream signal-to-noise ratio (SNR), in dB, as reported by the CM.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1447
Cable Commands: show cable m through show cable u
show cable modem phy
Table 110 Descriptions for the show cable modem phy Fields (continued)
Field Description
Note This command displays values for the downstream power and SNR values only if you have
configured the cable modem remote-query command on the CMTS, and if the CM supports
providing those options.
Mode DOCSIS operating mode for the CM:
• tdma=DOCSIS 1.X, TDMA-only mode
• atdma=DOCSIS 2.0 A-TDMA mode
A hyphen (-) indicates the mode is unknown or the CM has not yet registered.
For DOCSIS 3.0-certified cable modems with multiple upstream channels,
the output may contain multiple results for the same MAC address. In
Cisco IOS Release 12.2(33)SCC, the asterix (*) that appears beside the
DOCSIS operating mode under the Mode column identifies that the CM is
operating in the MTC mode.
Note This field is the same as that returned by the
docsIfCmtsCmStatusModulationType object in the DOCS-IF-MIB.
Related Commands Command Description
cable modem Enables and configures the remote-query feature to gather CM performance
remote-query statistics on the CMTS.
cable modem vendor Associates the name of a vendor with its Organizational Unique Identifier
(OUI).
show cable modem Displays information for the registered and unregistered CMs.
show cable modem Displays information about the upstream carrier-to-noise ratio (CNR) for a
cnr particular cable modem.
show cable modem Displays connectivity statistics for one or more CMs.
connectivity
show cable modem Displays the CPE devices accessing the cable interface through a particular
cpe CM.
show cable modem Displays error statistics for one or more CMs.
errors
show cable modem Displays flap list statistics for one or more cable modems.
flap
show cable modem Displays MAC layer information for one or more CMs.
mac
Cisco IOS CMTS Cable Command Reference
CBL-1448 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem phy
Command Description
show cable modem Displays station maintenance (SM) error statistics for one or more cable
maintenance modems.
show cable modem Displays information collected by the remote-query feature.
remote-query
show cable modem Displays RF adaptation information for cable modems.
rf-adapt
show interface cable Displays information about the CMs connected to a particular cable
modem interface.
show interface cable Displays cable interface information.
sid
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1449
Cable Commands: show cable m through show cable u
show cable modem primary-channel
show cable modem primary-channel
To display the primary-channel and host interface for all modems or for modems on a MAC domain host
interface, use the show cable modem primary-channel command.
show cable modem [cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port
[logical-channel-index]]] primary-channel [non-bonding-capable [legacy-ranging]]
[wideband [registered-traditional-docsis]]
Syntax Description 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 subslots are
0 or 1.
port Downstream port number. 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 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.
upstream port (Optional) Displays information for all CMs using this specific upstream.
You can specify this option only when displaying information for a cable
interface. The valid range for port begins with 0 and ends with a value that
depends on the number of upstream ports on the cable interface line card.
logical-channel-index (Optional) Logical channel index. The valid values are 0 or 1.
non-bonding-capable Displays the cable modems and primary downstreams of the cable modems
that are not capable of bonding.
legacy-initial-ranging Displays modems that access with legacy INIT-RNG-REQ.
wideband Displays wideband online modems.
registered-traditional- Displays wideband cable modems registered in traditional pre-DOCSIS3.0
docsis mode.
Command Default No default behavior or values.
Command Modes Privileged EXEC (#)
Cisco IOS CMTS Cable Command Reference
CBL-1450 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem primary-channel
Command History Release Modification
12.3(23)BC This command was introduced for the Cisco uBR10012 router.
12.2(33)SCE This command was modified. The port parameter was changed to
cable-interface-index.
12.2(33)SCF This command was modified. The logical-channel-index argument was
added.
Usage Guidelines Use this command to display the primary downstream channel information of modems for different
modem categories in terms of bonding capability, such as, non-bonding-capable modems accessed with
legacy initial ranging or wideband cable modems registered via traditional DOCSIS.
Examples The following show cable modem primary-channel non-bonding-capable command shows the
individual cable modems displays and the primary downstream channel for each cable modem.
Router# show cable modem primary-channel non-bonding-capable
MAC Address IP Address Host MAC Prim Num Primary DS
Interface State Sid CPE Downstream RfId
000f.66f9.aa73 80.17.1.3 C6/0/0/U0 online(pt) 1 0 C6/0/0 255
0007.0e02.d7e9 80.17.1.7 C6/0/0/U0 online(pt) 5 0 Mo3/0/0:1 1
0013.10bb.22f9 80.17.1.2 C6/0/0/U0 online(pt) 2 0 Mo3/0/0:1 1
000f.66f9.b193 80.17.1.6 C6/0/0/U0 online(pt) 22 0 C6/0/0 255
0012.17ea.f3fb 80.17.1.4 C6/0/0/U0 online(pt) 23 0 C6/0/0 255
0013.10bb.23d1 80.17.1.5 C6/0/1/U1 online(pt) 5 0 C6/0/1 255
Related Commands Command Description
show cable modem Displays information for the registered and unregistered CMs.
show cable modem voice Displays detected voice-enabled modems.
show cable service-voice Shows the current enforced downstream type on the uBR10-MC5x20 line
downstream type card.
show cable modem Displays RF adaptation information for cable modems.
rf-adapt
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1451
Cable Commands: show cable m through show cable u
show cable modem primary-channel summary total
show cable modem primary-channel summary total
To display the number of cable modems grouped by primary downstream channels information under a
Channel Grouping Domain (CGD), use the show cable modem primary-channel summary total
command in privileged EXEC mode.
show cable modem primary-channel [cable slot/subslot/port] summary total
Syntax Description slot The slot used for the cable interface line card. Valid values are 5 to 8.
subslot The subslot used for the cable interface line card. Valid values are 0 to 1.
port The downstream port used as a MAC domain host interface port. Valid values are
0 to 4.
Command Modes Privileged EXEC
Command History Release Modification
12.3(23)BC This command was introduced for the Cisco uBR10012 router.
Usage Guidelines Use the show cable modem primary-channel summary total command to display the number of cable
modems grouped by primary downstream channels. You can also use this command to display
information for narrowband and wideband modems and group the information based on a SPA or a
uBR10-MC 5x20 primary downstream. You can also display information on modems based on a specific
cable MAC domain.
Examples The following example shows attributes of the primary channels to which the various modems are hosted
under the CGD domain c6/0/0.
Router#show cable modem primary-channel
MAC Address IP Address Host MAC Prim Num Primary DS
Interface State Sid CPE Downstream RfId
000f.66f9.aa73 80.17.1.2 C6/0/0/U0 online 13 0 C6/0/0 255
000f.66f9.b193 80.17.1.3 C6/0/0/U0 online 14 0 C6/0/0 255
0012.17ea.f3fb 80.17.1.5 C6/0/0/U0 online 15 0 C6/0/0 255
0019.474a.d4f8 80.17.1.13 C6/0/0/U0 online 16 0 C6/0/0 255
0000.cab7.7f1c 80.17.1.8 C6/0/0/U0 online 17 1 C6/0/0 255
0019.474a.d3d4 80.17.1.11 C6/0/0/U0 online 18 0 C6/0/0 255
0007.0e02.d7e9 80.17.1.10 C6/0/0/U0 online 19 0 C6/0/0 255
0019.474a.cd82 80.17.1.20 C6/0/0/U0 online 20 0 C6/0/0 255
0019.474a.d3fa 80.17.1.7 C6/0/0/U0 online 22 0 C6/0/0 255
0018.6852.82ea 80.17.1.6 C6/0/0/U0 online 24 0 C6/0/0 255
0013.10bb.23d1 80.17.1.12 C6/0/0/U0 online 23 1 Mo3/0/0:0 0
The following example shows modems grouped according to their capability, indicating whether they
are wideband or narrowband modems. The command also displays the local of the primary downstreams
of the modem, indicating whether the primary downstream is a SPA downstream (Remote) or a
uBR10-MC 5x20 downstream (Local). The Wideband column indicates if the status of the modem is
online or wideband-online.
Cisco IOS CMTS Cable Command Reference
CBL-1452 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem primary-channel summary total
Router#show cable modem primary-channel summary total
Cable Modem
Total Reg Oper Unreg Offline Wideband initRC initD initIO initO 0-Blaze
Local Primary Narrowband:
C6/0/0 5 5 5 0 0 0 0 0 0 0 0
C6/0/1 0 0 0 0 0 0 0 0 0 0 0
Subtotal: 5 5 5 0 0 0 0 0 0 0 0
Local Primary Wideband:
C6/0/0 5 5 5 0 0 0 0 0 0 0 0
C6/0/1 0 0 0 0 0 0 0 0 0 0 0
Subtotal: 5 5 5 0 0 0 0 0 0 0 0
Remote Primary Narrowband:
Mo3/0/0:0 1 1 1 0 0 0 0 0 0 0 0
Subtotal: 1 1 1 0 0 0 0 0 0 0 0
Remote Primary Wideband:
Subtotal: 0 0 0 0 0 0 0 0 0 0 0
Total: 11 11 11 0 0 0 0 0 0 0 0
The example below shows the modems grouped by primary downstream channels for the cable MAC
domain c6/0/0.
Router#show cable modem primary-channel summary c6/0/0 total
Cable Modem
Total Reg Oper Unreg Offline Wideband initRC initD initIO initO 0-Blaze
Local Primary Narrowband:
C6/0/0 5 5 5 0 0 0 0 0 0 0 0
Local Primary Wideband:
C6/0/0 5 5 5 0 0 0 0 0 0 0 0
Remote Primary Narrowband:
Mo3/0/0:0 1 1 1 0 0 0 0 0 0 0 0
Subtotal: 1 1 1 0 0 0 0 0 0 0 0
Remote Primary Wideband:
Subtotal: 0 0 0 0 0 0 0 0 0 0 0
Total: 11 11 11 0 0 0 0 0 0 0 0
Related Commands Command Description
show cable modem Displays information for the registered and unregistered cable
modems.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1453
Cable Commands: show cable m through show cable u
show cable modem privacy
show cable modem privacy
To display the privacy information for the registered and unregistered CMs, use the show cable modem
privacy command in privileged EXEC mode.
Cisco uBR7200 Series Routers
show cable modem {ip-address | mac-address} privacy [verbose]
Cisco uBR10012 Router
show cable modem {ip-address | mac-address} privacy [verbose]
Syntax Description ip-address IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP
address for a CPE device behind a CM, information for that CM is displayed.
mac-address MAC address of a specific CM to be displayed. If you specify the MAC
address for a CPE device behind a CM, information for that CM is displayed.
privacy Displays the privacy information for the CMs.
verbose Displays detailed information for the CMs.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCC This command was introduced.
Usage Guidelines This command displays privacy information of a particular CM, identified by its IP address or MAC
address.
Examples The following sample output from the show cable modem privacy command shows the privacy
information for a particular CM using a specified MAC address.
Router# show cable modem 0018.6835.2987 privacy
MAC Address : 0018.6835.2987
Primary SID : 10
BPI Mode : BPI+
BPI State : assign(tek)
Security Capabilities :
Encryption : DES-56
EAE : Unsupported
Latest Key Sequence : 2
Key Status : Active
Remaining Lifetime : 294 sec
Key Gracetime : 60 sec
Current Key Sequence : 2
CA Certificate Details :
Certificate Serial : 57BF2DF60E9FFBECF8E69709DE34BC26
Cisco IOS CMTS Cable Command Reference
CBL-1454 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem privacy
Certificate Self-Signed : False
Certificate State : Chained
CM Certificate Details :
CM Certificate Serial : 010244AF1A135202
CM Certificate State : Chained
KEK Reject Code : None
KEK Reject Reason : No Information
KEK Invalid Code : None
KEK Invalid Reason : No Information
Primary SID Information :
SID : 10
Encryption Algorithm : 56-bit DES
Latest Sequence Number : 5
Key Status : Active
Remaining Lifetime : 144 sec
Key Gracetime : 60 sec
Current Sequence Number : 4
Key Status : Active
Remaining Lifetime : 54 sec
Key Gracetime : 60 sec
TEK Reject Code : None
TEK Reject Reason : No Information
TEK Invalid Code : None
TEK Invalid Reason : No Information
Example of show cable modem privacy verbose Command Output for a Specified MAC Address
The following example shows sample output for the verbose option for a particular CM:
Router# show cable modem 0018.6835.2987 privacy verbose
MAC Address : 0018.6835.2987
Primary SID : 10
BPI Mode : BPI+
BPI State : assign(tek)
Security Capabilities :
Encryption : DES-56
EAE : Unsupported
Latest Key Sequence : 2
Key Status : Active
Remaining Lifetime : 256 sec
Key Gracetime : 60 sec
Authorization Key : 2004065504831967119C16051FD722C5209E165F
Key Encryption Key : F14EFC15118B6B06
Upstream HMAC Key : 150E3F56451F6E033DEB79BCF819A9D8EAF6B95D
Downstream HMAC Key : 9AA3EC8869D64927560589692CCE4C21F3DA9029
Current Key Sequence : 2
Authorization Counters :
Authorization Infos : 4
Authorization Requests : 2
Authorization Replies : 2
Authorization Rejects : 0
Authorization Invalids : 0
Traffic Key Counters :
Traffic Key Requests : 4
Traffic Key Replies : 4
Traffic Key Rejects : 0
Traffic Key Invalids : 0
Certificate Counters :
Untrusted Manufacturer : 0
Untrusted CM Certificate : 0
Issuer Not Found : 0
Invalid Signature : 0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1455
Cable Commands: show cable m through show cable u
show cable modem privacy
Expired Certificate : 0
Certificate Not Activated: 0
Certificate in Hotlist : 0
Public Key Mismatch : 0
Invalid MAC : 0
Invalid CM Certificate : 0
CA Certificate Details :
Certificate Serial : 57BF2DF60E9FFBECF8E69709DE34BC26
Certificate Self-Signed : False
Certificate State : Chained
CM Certificate Details :
CM Certificate Serial : 010244AF1A135202
CM Certificate State : Chained
KEK Reject Code : None
KEK Reject Reason : No Information
KEK Invalid Code : None
KEK Invalid Reason : No Information
Primary SID Information :
SID : 10
Encryption Algorithm : 56-bit DES
Latest Sequence Number : 5
Key Status : Active
Remaining Lifetime : 106 sec
Key Gracetime : 60 sec
Hardware Keys Match : True
DES Key : 156819BF016E139B
DES IV : 07291CAE15AD0845
Current Sequence Number : 4
Key Status : Active
Remaining Lifetime : 16 sec
Key Gracetime : 60 sec
Hardware Keys Match : True
DES Key : 23EF1C9801F40EE3
DES IV : 163D19831AFB25DC
TEK Requests : 4
TEK Replies : 4
TEK Rejects : 0
TEK Invalids : 0
TEK Receive Errors : 0
TEK Reject Code : None
TEK Reject Reason : No Information
TEK Invalid Code : None
TEK Invalid Reason : No Information
Table 111 describes the major fields shown in the show cable modem privacy command display:
Table 111 show cable modem privacy Field Descriptions
Field Description
MAC Address MAC address for the CM.
Prim SID Primary SID assigned to the CM.
BPI Mode Baseline Privacy Interface (BPI) mode used.
BPI State Displays the BPI state.
Security Capabilities Security capabilities of the modem like encryption algorithm
and Early Authentication and Encryption (EAE).
Encryption Encryption method used.
Cisco IOS CMTS Cable Command Reference
CBL-1456 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem privacy
Table 111 show cable modem privacy Field Descriptions (continued)
Field Description
EAE EAE support.
Latest Key Sequence Latest key sequence number.
Key Status Status of the key; whether active or not.
Remaining Lifetime Remaining lifetime of the key in seconds.
Key Gracetime Grace time available for the key in seconds.
Authorization Key Authorization key code.
Key Encryption Key Key used to encrypt the traffic key.
Upstream HMAC Key Upstream Hashed Message Authentication Code (HMAC)
key.
Downstream HMAC Key Downstream Hashed Message Authentication Code (HMAC)
key.
Current Key Sequence Current key sequence number.
Authorization Counters Authorization counter information.
Authorization Infos Authorization information.
Authorization Requests Number of authorized requests.
Authorization Replies Number of authorized replies.
Authorization Rejects Rejected authorization.
Authorization Invalids Invalid authorization.
Traffic Key Counters Traffic key counter informayion.
Traffic Key Requests Number of traffic key requests.
Traffic Key Replies Number of traffic key replies.
Traffic Key Rejects Number of traffic key rejects.
Traffic Key Invalids Number of invalid traffic keys.
Certificate Counters Certificate counter information.
Untrusted Manufacturer Count of untrusted manufacturers.
Untrusted CM Certificate Count of untrusted CM certificates.
Issuer Not Found Count of certificate issuers not found in the database.
Invalid Signature Count of invalid signatures.
Expired Certificate Number of expired certificates.
Certificate Not Activated Count of certificates not activated.
Certificate in Hotlist Number of certificates in hotlist.
Public Key Mismatch Number of public key mismatch.
Invalid MAC Number of invalid MACs.
Invalid CM Certificate Number of invalid CM certificates.
CA Certificate Details CA certificate information.
Certificate Serial CA certificate serial number.
Certificate Self-Signed Self-signed CA certificate.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1457
Cable Commands: show cable m through show cable u
show cable modem privacy
Table 111 show cable modem privacy Field Descriptions (continued)
Field Description
Certificate State Current state of the CA certificate.
CM Certificate Details CM certificate information.
CM Certificate Serial CM certificate serial number.
CM Certificate State Current state of the CM certificate.
KEK Reject Code Key Encryption Key (KEK) reject code.
KEK Reject Reason KEK reject reason.
KEK Invalid Code KEK invalid code.
KEK Invalid Reason Reason for the invalid KEK.
Primary SID Information Primary SID assigned to this CM.
SID SID used by the CM.
Encryption Algorithm Encryption algorithm used.
Latest Sequence Number Latest sequence number.
Current Sequence Number Current sequence number.
Hardware Keys Match Hardware key match.
DES Key Data Encryption Standard (DES) key number.
DES IV Initialization vector. This can be AES or DES.
TEK Requests Displays the number of Traffic Exchange Key (TEK)
requests.
TEK Replies Number of TEK requests.
TEK Rejects Number of TEK rejects.
TEK Invalids Number of invalid TEKs.
TEK Receive Errors Number of TEK receive errors.
TEK Reject Code TEK reject code.
TEK Reject Reason TEK reject reason.
TEK Invalid Code TEK invalid code.
TEK Invalid Reason TEK invalid reason.
Related Commands Command Description
cable privacy Enables and configures BPI+ encryption on a cable interface.
cable privacy kek Sets KEK and timeout periods.
cable privacy tek Sets TEK and timeout periods.
show cable privacy Displays information about BPI status and operation.
Cisco IOS CMTS Cable Command Reference
CBL-1458 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem qos
show cable modem qos
To display the quality of service (QoS) and service flow information for a particular cable modem (CM),
use the show cable modem qos command in privileged EXEC mode.
show cable modem {ip-address | mac-address | name fqdn} qos [service-class | verbose]
Syntax Description ip-address IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP
address for a CPE device behind a CM, information for that CM is
displayed.
mac-address MAC address of a specific CM to be displayed. If you specify the MAC
address for a CPE device behind a CM, information for that CM is
displayed.
name fqdn (Optional) Specifies the fully qualified domain name (FQDN) of the cable
device to be displayed. This option is only available if the show cable
modem domain-name command has been run for the first time to update
the cable DNS cache on the CMTS router.
service-class (Optional) Displays the service class names associated with each service
flow for a specific cable modem.
verbose (Optional) Displays detailed information for each service flow ID (SFID)
for the CM.
Command Modes Privileged EXEC (#)
Command History Release Modification
11.3XA This command was introduced.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA, with
the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was
added.
• The name keyword option was added for specifying the fully-qualified
domain name of a CM.
12.2(33)SCC The command output was modified to display the traffic peak rate value for
a specific service flow.
12.2(33)SCF This command was modified. The service-class keyword was added to
display the service class names for each service flow for a specific cable
modem.
12.2(33)SCG The command output was modified to display the scheduling type as “N/A”
for all downstream service flows.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1459
Cable Commands: show cable m through show cable u
show cable modem qos
Usage Guidelines This command displays the service flows currently in use by a CM. The default form of the display
shows one service flow per line, while the verbose form displays complete information for each flow.
Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first
on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable
command.
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy,
the new primary processor after a switchover automatically creates a new database of the online cable
modems. This means that the show cable modem ip-address command might not show a particular cable
modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the
ping ip-address command, and then the show cable modem ip-address command will show the cable
modem. You can also display any particular cable modem by using the show cable modem | include
ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically
synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be
synchronized manually, using the hccp resync command. When a SYNC event command is occurring,
CLI commands might be very slow to respond. In particular, if you enter the show cable modem
command at the same time a SYNC event is occurring, the command might respond produce a blank
display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Note Starting with Cisco IOS Release 12.2(33)SCG, the output of the show cable modem qos command
displays the scheduling type of all downstream service flows (DS-SF) as “N/A” to indicate that the
DS-SFs do not have any scheduling type.
Examples Example of the show cable modem qos Command for a Cable Modem Specified by MAC Address
The following example is a sample output of the show cable modem qos command for a specific CM
identified by its MAC address:
Router# show cable modem 0010.7bb3.fcd1 qos
Sfid Dir Curr Sid Sched Prio MaxSusRate MaxBrst MinRsvRate Throughput
State Type
3 US act 1 BE 7 2000000 1522 100000 0
4 DS act N/A BE 0 4000000 1522 0 0
Example of the show cable modem qos Command for a Cable Modem Specified by IP Address
The following example is a sample output of the show cable modem qos command for a specific CM
identified by its IP address:
Cisco IOS CMTS Cable Command Reference
CBL-1460 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem qos
Router# show cable modem 22.1.1.10 qos
Sfid Dir Curr Sid Sched Prio MaxSusRate MaxBrst MinRsvRate Throughput
State Type
7 US act 3 BE 0 0 3044 0 0
9 US act 4 BE 0 1000000 65224 0 0
10 US act 5 BE 0 1000000 65224 0 0
8 DS act N/A BE 0 0 3044 0 0
Example of the show cable modem qos verbose Command for a Cable Modem Specified by IP Address
The following example is a sample output for the verbose form of the show cable modem qos command
for a specific CM identified by its IP address:
Router# show cable modem 22.1.1.10 qos verbose
Sfid : 7
Current State : Active
Sid : 3
Traffic Priority : 0
Maximum Sustained rate : 0 bits/sec
Maximum Burst : 3044 bytes
Mimimum Reserved rate : 0 bits/sec
Minimum Packet Size : 64 bytes
Admitted QoS Timeout : 200 seconds
Active QoS Timeout : 0 seconds
Maximum Concatenated Burst : 1522 bytes
Scheduling Type : Best Effort
Request/Transmission policy : 0x0
IP ToS Overwrite[AND-mask, OR-mask] : 0xFF, 0x0
Current Throughput : 0 bits/sec, 0 packets/sec
Sfid : 9
Current State : Active
Sid : 4
Traffic Priority : 0
Maximum Sustained rate : 1000000 bits/sec
Maximum Burst : 65224 bytes
Mimimum Reserved rate : 0 bits/sec
Minimum Packet Size : 64 bytes
Admitted QoS Timeout : 0 seconds
Active QoS Timeout : 0 seconds
Maximum Concatenated Burst : 1522 bytes
Scheduling Type : Best Effort
Request/Transmission policy : 0x0
IP ToS Overwrite[AND-mask, OR-mask] : 0xFF, 0x0
Current Throughput : 0 bits/sec, 0 packets/sec
Sfid : 10
Current State : Active
Sid : 5
Traffic Priority : 0
Maximum Sustained rate : 1000000 bits/sec
Maximum Burst : 65224 bytes
Mimimum Reserved rate : 0 bits/sec
Minimum Packet Size : 64 bytes
Admitted QoS Timeout : 0 seconds
Active QoS Timeout : 0 seconds
Maximum Concatenated Burst : 1522 bytes
Scheduling Type : Best Effort
Request/Transmission policy : 0x0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1461
Cable Commands: show cable m through show cable u
show cable modem qos
IP ToS Overwrite[AND-mask, OR-mask] : 0xFF, 0x0
Current Throughput : 0 bits/sec, 0 packets/sec
Sfid : 8
Current State : Active
Sid : N/A
Traffic Priority : 0
Maximum Sustained rate : 0 bits/sec
Maximum Burst : 3044 bytes
Mimimum Reserved rate : 0 bits/sec
Minimum Packet Size : 64 bytes
Admitted QoS Timeout : 200 seconds
Active QoS Timeout : 0 seconds
Maximum Latency : 0 usecs
Current Throughput : 0 bits/sec, 0 packets/sec
The following example is a sample output for the verbose form of the show cable modem qos command
indicating the traffic peak rate value for a specific service flow.
Router# show cable modem 22.1.1.10 qos verbose
Sfid : 40
Current State : Active
Sid : 35
Traffic Priority : 4
Maximum Sustained rate : 20000000 bits/sec
Maximum Burst : 20000000 bytes
Minimum Reserved rate : 0 bits/sec
Minimum Packet Size : 0 bytes
Admitted QoS Timeout : 200 seconds
Active QoS Timeout : 0 seconds
Maximum Concatenated Burst : 65535 bytes
Scheduling Type : Best Effort
Request/Transmission policy : 0x0
IP ToS Overwrite[AND-mask, OR-mask] : 0xFF, 0x0
Peak Rate : 50000000 bits/sec
Current Throughput : 0 bits/sec, 0 packets/sec
Example of the show cable modem qos service-class Command for a Cable Modem in
Cisco IOS Release 12.2(33)SCF
The following example is a sample output of the service-class option of the show cable modem qos
command for a specific CM identified by its IP address:
Router# show cable modem 22.1.1.10 qos service-class
Sfid Dir Sched MaxSusRate MaxBrst MinRsvRate SrvClassName
Type
33 US BE 0 3044 0 us_srvclass_ts1
35 US BE 0 3044 0 us_srvclass_ts2
34 DS BE 0 3044 0 ds_srvclass_ts1
36 DS BE 0 3044 0 ds_srvclass_ts2
Cisco IOS CMTS Cable Command Reference
CBL-1462 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem qos
Table 112 describes the major fields shown in the show cable modem qos displays:
Table 112 Descriptions for the show cable modem qos Fields
Field Description
Sfid Identifies the Service Flow ID (SFID) for this service flow.
Dir Identifies whether the service flow applies to the downstream (DS) or
upstream (US) direction.
Curr State Current State—Identifies the current state of the service flow: Active or
Inactive.
Sid Identifies the Service ID (SID) associated with this SFID.
Sched Type Identifies this service flow’s scheduling type:
• BE—Best-Effort
• NRTPS—Non-Real-Time Polling Service
• N/A—Scheduling type is not applicable to a service flow.
• RTPS—Real-Time Polling Service
• RSVD—Reserved but not yet in use
• UGS_AD—Unsolicited Grant Service with Activity Detection
• UGS—Unsolicited Grant Service
• UNDEF—Not yet defined.
Prio Traffic priority (0 to 7) given to this service flow.
MaxSusRate Maximum sustained rate value, in bits per second.
MaxBrst Maximum burst value, in bytes.
MinRsvRate Minimum reserved rate, in bits per second.
Throughput Current Throughput for this service flow, in packets per second.
SrvClassName Service class name associated with this service flow.
Minimum Packet Size Assumed minimum reserved rate packet size on this service flow, in bytes.
Admitted QoS Timeout Timeout for admitted QoS parameters, in seconds, which specifies the length
of time that the CMTS must reserve resources for a service flow’s admitted
Qos parameter set, when they exceed the resources allowed by the active QoS
parameter set.
Active QoS Timeout Timeout for active Qos parameters, in seconds, which specifies the maximum
amount of time that resources can remained unused on an active service flow.
Maximum Latency Maximum downstream latency allowed for packets using this service flow, in
microseconds.
Related Commands Command Description
cable qos permission Specifies permission for updating the cable router QoS table.
cable qos profile Configures a QoS profiles.
cable service-flow Sets the amount of time a dynamic service flow can be present in the system
inactivity-timeout without any activity.
show cable modem Displays information for the registered and unregistered CMs.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1463
Cable Commands: show cable m through show cable u
show cable modem qos
Command Description
show cable modem Displays the access groups for the CMs on a particular cable interface.
access-group
show cable modem Displays displays voice call information for a particular CM, identified
calls either by its IP address or MAC address.
show cable modem Displays information about the classifiers for a particular CM.
classifiers
show cable modem Displays connectivity statistics for one or more CMs.
connectivity
show cable modem Displays a list of the CMs that are marked as registered with the
registered Cisco CMTS router.
show cable modem Displays information collected by the remote-query feature.
remote-query
show cable modem Displays a list of the CMs that are marked as unregistered with the
unregistered Cisco CMTS router.
show cable Displays modulation profile group information.
modulation-profile
show interface cable Displays information about the CMs connected to a particular cable
modem interface.
show interface cable Displays the DOCSIS 1.1 QoS parameter sets.
qos paramset
show interface cable Displays cable interface information.
sid
show cable qos profile Displays quality-of-service (QoS) profiles for a Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
CBL-1464 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem registered
show cable modem registered
To display a list of the cable modems (CMs) that have registered with the Cisco CMTS, use the show
cable modem registered command in privileged EXEC mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] registered
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn]
registered
Syntax Description ip-address (Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you
specify the IP address for a CPE device behind a CM, information for that
CM is displayed.
mac-address (Optional) MAC address of a specific CM to be displayed. If you specify the
MAC address for a CPE device behind a CM, information for that CM is
displayed.
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.
subslot (Cisco uBR10012 only) Secondary slot number of the cable interface line
card. The valid subslots are 0 or 1.
port Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—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 IOS CMTS Cable Command Reference
OL-15510-15 CBL-1465
Cable Commands: show cable m through show cable u
show cable modem registered
upstream port (Optional) Displays information for all CMs using the specified upstream
port. You can specify this option only when displaying information for a
cable interface. The valid range for port begins with 0 and ends with a value
that depends on the number of upstream ports supported by the cable
interface line card.
logical-channel-index (Optional) Displays the logical channel index. Valid values are 0 and 1.
name fqdn (Optional) Specifies the fully qualified domain name (FQDN) of the cable
device to be displayed. This option is only available if the show cable
modem domain-name command has been run for the first time to update the
cable DNS cache on the CMTS router.
registered Displays a list of the cable modems that have registered with the
Cisco CMTS.
Defaults Displays a list of all registered CMs on the Cisco CMTS router.
Command Modes Privileged EXEC (#)
Command History Release Modification
11.3 NA This command was introduced.
12.2(4)BC1 Support for the Cisco uBR10012 router was introduced.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA, with
the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was
added.
• The name keyword option was added for specifying the fully-qualified
domain name of a CM.
• The alignment of output fields has been changed.
12.2(33)SCE This command was modified. The port parameter was changed to
cable-interface-index.
12.2(33)SCF This command was modified. The logical-channel-index argument was
added.
Usage Guidelines Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy,
the new primary processor after a switchover automatically creates a new database of the online cable
modems. This means that the show cable modem ip-address command might not show a particular cable
modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the
ping ip-address command, and then the show cable modem ip-address command will show the cable
modem. You can also display any particular cable modem by using the show cable modem | include
ip-address command.
Cisco IOS CMTS Cable Command Reference
CBL-1466 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem registered
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically
synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be
synchronized manually, using the hccp resync command. When a SYNC event command is occurring,
CLI commands might be very slow to respond. In particular, if you enter the show cable modem
command at the same time a SYNC event is occurring, the command might respond produce a blank
display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first
on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable
command.
Examples Example in Cisco IOS Release 12.2(33)SCA
The following example shows sample output for the default form of the show cable modem registered
command in Cisco IOS Release 12.2(33)SCA:
Router# show cable modem registered
Interface Prim Online Timing Rec QoS CPE IP address MAC address
Sid State Offset Power
C3/0/U0 1 online(pt) 2024 0.00 5 0 10.74.1.60 0000.cadb.0bae
C3/0/U0 2 online(pt) 2032 0.00 5 0 10.74.1.58 0000.cadb.0512
C3/0/U0 3 online(pt) 2024 0.50 5 0 10.74.1.61 0000.cadb.04b2
C3/0/U0 4 online(pt) 3079 0.00 5 0 10.74.1.48 0003.e3a6.7f71
C3/0/U0 5 online(pt) 2558 -1.00 5 0 10.74.1.50 0010.7b6b.77ed
C3/0/U0 6 online(pt) 3083 -0.50 5 0 10.74.1.42 0030.80bc.22b9
Examples in Cisco IOS Release 12.3BC
The following example shows sample output for the default form of the show cable modem registered
command.
Router# show cable modem registered
Interface Prim Online Timing Rec QoS CPE IP address MAC address
Sid State Offset Power
Cable3/0/U0 1 online 2812 -0.25 5 1 10.18.1.5 0030.80bc.2303
Cable3/0/U0 2 online 2804 0.50 5 0 10.18.1.9 0006.2854.73f5
The following example shows sample output for the show cable modem registered command for a
particular cable interface:
Router# show cable modem c8/1/0 registered
Interface Prim Online Timing Rec QoS CPE IP address MAC address
Sid State Offset Power
C8/1/0/U1 1 online 1548 0.00 5 0 10.1.1.11 0050.7366.1243
C8/1/0/U4 2 online 1925 0.00 5 0 10.1.1.10 0002.b970.0027
C8/1/0/U4 3 online 1918 -0.50 2 0 10.1.1.10 0006.5314.858d
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1467
Cable Commands: show cable m through show cable u
show cable modem registered
The following example shows sample output for the show cable modem registered command for a
single CM, as identified by its IP address:
Router# show cable modem 22.1.1.10 registered
Interface Prim Online Timing Rec QoS CPE IP address MAC address
Sid State Offset Power
C8/1/0/U4 3 online 1918 -0.75 2 0 10.1.1.10 0006.5314.858d
The following example shows sample output for the show cable modem registered command for a
single CM, as identified by its MAC address:
Router# show cable modem 0006.5314.858d registered
Interface Prim Online Timing Rec QoS CPE IP address MAC address
Sid State Offset Power
C8/1/0/U4 3 online 1918 -0.25 2 0 10.1.1.10 0006.5314.858d
Note An asterisk (*) in the Receive Power column indicates that a power adjustment has been made for that
CM. An exclamation point (!) in the Receive Power column indicates that the CM has reached its
maximum power transmit level and cannot increase its power level further. An exclamation point (!) in
the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset
specified by the cable map-advance command.
A pound sign (#) in the MAC State column indicates that the cable tftp-enforce mark-only command
has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before
registering, but the CM did not do so (Cisco IOS Release 12.1(11b)EC1 and Cisco IOS
Release 12.2(8)BC2 or later releases).
Tip The show cable modem command displays the CM timing offset in DOCSIS ticks, while other
commands, such as cable map-advance, display the offset in microseconds. Use the following method
to convert microseconds to DOCSIS ticks: ticks = microseconds*64/6.25.
Table 113 describes the major fields shown in the show cable modem registered displays:
Table 113 Descriptions for the show cable modem registered Fields
Field Description
Interface The cable interface line card providing the upstream for this CM.
Prim SID The primary SID assigned to this CM.
Online State The current state of the MAC layer. Should show “online” for registered
CMs.
Cisco IOS CMTS Cable Command Reference
CBL-1468 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem registered
Table 113 Descriptions for the show cable modem registered Fields (continued)
Field Description
Timing Offset The timing offset for the CM, in ticks, as recognized on the CMTS. (A tick,
as used here, is 6.25/64 microseconds.) This is the delay between when a
particular cable modem is scheduled to make a transmission and when the
CMTS actually receives it.
Note An exclamation point (!) in the Timing Offset column indicates that
the CM has exceeded the maximum delay and timing offset specified
by the cable map-advance command.
Note The timing offset shown here is typically smaller than the TX Time
Offset value shown by the show cable modem remote-query
command, because the latter value is the offset as recognized on the
CM (which will include any internal delay between when the CM
software begins the transmission and when the bits actually appear on
the local cable interface).
Rec Power The received power level (in dB) for the CM.
Note An asterisk (*) in the RxPwr column indicates that a power
adjustment has been made for that CM. An exclamation point (!)
indicates that the CM has reached its maximum power transmit level
and cannot increase its power level further.
QoS Displays the QoS profile assigned to the CM (DOCSIS 1.1 and DOCSIS 2.0
CMs only).
CPE Indicates the number of CPE devices for which the CM is providing services.
IP Address The IP address that the DHCP server has assigned to the CM.
MAC Address The MAC address for the CM.
Related Commands Command Description
cable modem vendor Associates the name of a vendor with its Organizational Unique Identifier
(OUI).
show cable modem Displays information for the registered and unregistered CMs.
show cable modem Displays the access groups for the CMs on a particular cable interface.
access-group
show cable modem Displays displays voice call information for a particular CM, identified
calls either by its IP address or MAC address.
show cable modem Displays information about the classifiers for a particular CM.
classifiers
show cable modem Displays connectivity statistics for one or more CMs.
connectivity
show cable modem Displays the CPE devices accessing the cable interface through a particular
cpe CM.
show cable modem Displays a list of the CMs that are marked as offline with the Cisco CMTS.
offline
show cable modem Displays RF adaptation information for cable modems.
rf-adapt
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1469
Cable Commands: show cable m through show cable u
show cable modem registered
Command Description
show cable modem Displays a list of the CMs that are marked as unregistered with the
unregistered Cisco CMTS.
show cable modem Displays the vendor name or Organizational Unique Identifier (OUI) for the
vendor CMs on each cable interface.
show interface cable Displays information about the CMs connected to a particular cable
modem interface.
show interface cable Displays cable interface information.
sid
Cisco IOS CMTS Cable Command Reference
CBL-1470 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem remote-query
show cable modem remote-query
To display information collected by the remote-query feature, use the show cable modem
remote-query command in privileged EXEC mode.
show cable modem remote-query
Syntax Description This command has no keywords or arguments.
Command Modes Privileged EXEC
Command History Release Modification
12.0(7)XR, 12.1(2)T This command was introduced.
12.1(2)EC1 Support for this command was added to the 12.1 EC train.
12.2(4)BC1b Support for this command was added to the 12.2 BC train.
12.3(23)BC Support was added for displaying status of modems during an SNMP
request.
Usage Guidelines This command shows the statistics collected when the remote-query feature has been enabled and
configured by the cable modem remote-query command.
Note In Cisco IOS Release 12.1 CX, Cisco IOS Release 12.2 BC, and later, use the show cable
modem phy command instead of the show cable modem remote-query command.
Tip The information shown by this command can also be displayed by querying the attributes in the
CISCO-DOCS-REMOTE-QUERY-MIB.
Note Also see the information about this command’s behavior in a Hot Standby Connection-to-Connection
Protocol (HCCP) configuration, see the “Operation with Hot Standby Connection-to-Connection
Protocol (HCCP) Configuration” section on page 1507.
Examples The following example shows typical output from the show cable modem remote-query command. In
this example, the final CM (IP address of 10.200.71.2) has not been configured with an SNMP
community string that allows access to the remote-query feature.
Router# show cable modem remote-query
Remote Query Polling State : Active
IP address MAC address S/N US DS Tx Time Micro (dB) Modem
Ratio Power Power Offset Reflection State
10.200.71.8 0001.9659.47af 36.6 31.0 0.0 12352 17 online
10.200.71.4 0001.9659.47c7 36.6 37.0 0.0 12352 17 online
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1471
Cable Commands: show cable m through show cable u
show cable modem remote-query
10.200.71.6 0001.9611.b9a3 36.6 37.0 0.0 12353 15 online
10.200.71.3 0001.9659.47a9 36.6 37.0 0.0 12351 16 online
10.200.71.2 0001.9659.47c1 0.0 0.0 0.0 0 0 online
In the following example, the SNMP Request column shows cable modems being offline when an SNMP
request using the cable modem remote query command is not received. The modems are either offline
or are not responding to the SNMP request.
Router# show cable modem remote-query
Remote Query Polling State : Inactive
IP address MAC address S/N US DS Tx Time SNMP
Ratio Power Power Offset Request
80.51.1.4 0018.f826.3453 0.0 0.0 0.0 0 CM offline
80.51.1.2 000c.e5f6.0c40 0.0 0.0 0.0 0 CM offline
80.51.1.8 0019.474a.d4fe 0.0 0.0 0.0 0 CM offline
80.51.1.3 0018.6852.82fa 0.0 0.0 0.0 0 CM offline
80.51.1.5 0019.474a.c1ae 0.0 0.0 0.0 0 CM offline
Table 0-114 shows the fields displayed by the show cable modem remote-query command.
Table 0-114 Descriptions for the show cable modem remote-query Fields
Field Description
IP Address The IP address that the DHCP server has assigned to the CM.
MAC Address The MAC address for the CM.
S/N Ratio The current signal-to-noise ratio (SNR) on the downstream, as seen by the
CM.
US Power The current operational transmit power level, in dBmV, as seen by the CM.
DS Power The received power level, in dBmV, as seen by the CM. This field is set to
zero if the CM does not support power level measurements.
TX Time Offset The timing offset for the CM, in ticks, as recognized on the CM. (A tick, as
used here, is 6.25/64 microseconds.) This is the delay between when a
particular cable modem is scheduled to make a transmission and when the
CMTS actually receives it. The CM value includes any internal delay
between when the CM software begins the transmission and when the bits
actually appear on the local cable interface.
Note The timing offset shown here is typically larger than the Time Offset
value shown by the show cable modem command, because the latter
value is the offset as recognized on the CMTS (which does not
include the internal delay on the CM).
Micro (dB) Reflection The approximate number of total microreflections (including in-channel
responses) on the downstream, measured in dBc below the signal level, as
seen by the CM. Microreflections are a type of impairment that is caused by
impedance mismatches between amplifiers, couples, cables, and other
equipment in the cable plant. Microreflections create copies of a signal that
arrive at the receiver with different amounts of delay and attenuation,
generating intersymbol interference (ISI) that can cause the receiver to
improperly detect the amplitude and phase of the incoming signal.
Note This value is not exact but provides an approximate indication of the
microreflections that have been received.
Modem State The current state of the MAC layer for the CM (see Table 101 on page 1410).
Cisco IOS CMTS Cable Command Reference
CBL-1472 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem remote-query
The following example shows typical output from the show cable modem remote-query command.
Router# show cable modem remote-query
IP address MAC address S/N US DS Tx Time Micro (dB) Modem
Ratio Power Power Offset Reflection State
10.118.4.194 0007.0e04.5ba9 33.4 42.3 - 1.0 8794 1 online
10.118.4.156 0003.6b1b.e8c9 34.0 44.0 - 1.0 8795 3 online(d)
Router#
The following example shows typical output from the show cable modem remote-query command
when the remote-query feature has not been configured.
Router# show cable modem remote-query
Remote Query Polling State : Inactive
IP address MAC address S/N US DS Tx Time Micro (dB) Modem
Ratio Power Power Offset Reflection State
10.200.71.8 0001.9659.47af 0.0 0.0 0.0 0 0 online
10.200.71.4 0001.9659.47c7 0.0 0.0 0.0 0 0 online
10.200.71.6 0001.9611.b9a3 0.0 0.0 0.0 0 0 online
10.200.71.3 0001.9659.47a9 0.0 0.0 0.0 0 0 online
10.200.71.2 0001.9659.47c1 0.0 0.0 0.0 0 0 online
10.200.71.10 00d0.5904.5321 0.0 0.0 0.0 0 0 offline
10.200.71.11 0050.f112.5123 0.0 0.0 0.0 0 0 offline
Router#
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Related Commands Command Description
cable modem remote-query Enables and configures the remote-query feature to gather CM
performance statistics on the CMTS.
debug cable remote-query Turns on debugging to gather information from remote CMs.
show cable modem Displays information for the registered and unregistered CMs.
show cable modem cnr Displays information about the upstream carrier-to-noise ratio
(CNR) for a particular cable modem.
snmp-server enable traps Enables traps that are sent when the remote polling of CMs has been
cable completed.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1473
Cable Commands: show cable m through show cable u
show cable modem resiliency
show cable modem resiliency
To display the resiliency status of the cable modems in resiliency mode on the Cisco CMTS router, use
the show cable modem resiliency command in privileged EXEC mode.
show cable modem resiliency
Command Default None
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCG This command was introduced.
Examples The following example shows a sample output of the show cable modem resiliency command:
Router# show cable modem resiliency
Orig BG Curr BG
I/F MAC Address ID I/F RFs ID I/F RFs
------- -------------- ---------------------- ----------------------
C7/0/0 0025.2eaf.843e 897 Wi7/0/0:0 4 898 Wi7/0/0:1 3
C7/0/0 0025.2eaf.8356 897 Wi7/0/0:0 4 899 Wi7/0/0:2 3
C7/0/0 0015.d176.5199 897 Wi7/0/0:0 4 720 In7/0/0:0
Table 1 describes the significant fields shown in the display.
Table 115 show cable modem resiliency Field Descriptions
Field Description
I/F Modem host interface.
MAC Address MAC address of the cable modem.
Orig BG ID Original wideband (WB) interface bonding group ID.
I/F Original bonding group (BG) WB interface.
RFs Number of RFs originally assigned.
Curr BG ID Currently assigned bonding group ID.
I/F Assigned interface (dynamic WB or narrowband).
RFs Number of RFs in the interface (if assigned to a WB interface).
Cisco IOS CMTS Cable Command Reference
CBL-1474 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem resiliency
Related Commands Command Description
cable resiliency Enables the Downstream Resiliency Bonding Group feature on the Cisco
ds-bonding CMTS router.
cable ds-resiliency Reserves a resiliency bonding group for a line card on the Cisco CMTS
router.
show cable resiliency Displays all information about resiliency bonding groups on the Cisco
CMTS router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1475
Cable Commands: show cable m through show cable u
show cable modem rf-adapt
show cable modem rf-adapt
To display RF adaptation relocation history for cable modems, use the show cable modem rf-adapt
command in privileged EXEC mode.
show cable modem [mac-address | cable {slot/cable-interface-index |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] ] rf-adapt
[verbose]
Syntax Description mac-address (Optional) MAC address of a specific cable modem to be displayed. If you
specify the MAC address for a CPE device behind a cable modem,
information for that cable modem is displayed.
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.
subslot (Cisco uBR10012 only) Secondary slot number of the cable interface line
card. The valid subslots are 0 or 1.
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.
upstream port (Optional) Displays information for all CMs using the specified upstream
port. You can specify this option only when displaying information for a
cable interface. The valid range for port begins with 0 and ends with a value
that depends on the number of upstream ports supported by the cable
interface line card.
logical-channel-index (Optional) Logical channel index. The valid values are 0 or 1.
rf-adapt Displays RF adaptation information.
verbose Displays detailed information for the cable modems.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCF This command was introduced.
Cisco IOS CMTS Cable Command Reference
CBL-1476 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem rf-adapt
Examples The following is a sample output of the show cable modem rf-adapt command:
Router# show cable modem rf-adapt
MAC Address Downgrade Upgrade Primary Last Last Action
Count Count Upstream Action Time
0019.474a.d4cc 1 0 C8/0/1/U3.0 D Jun 25 22:10:22
0019.474a.d554 1 1 C8/0/14/U0.0 U Jun 25 22:10:22
0019.474a.d542 2 1 C8/0/0/U0.0 D Jun 25 22:10:22
0019.474a.d508 1 1 C8/0/8/U0.0 U Jun 25 22:10:23
0025.2e2d.7400 1 0 C8/0/0/U1.0 D Jun 25 22:10:23
0022.cea4.f404 1 1 C8/0/2/U2.0 U Jun 25 22:10:23
Router# show cable modem 001e.6bfb.2d3c rf-adapt
MAC Address Downgrade Upgrade Primary Last Last Action
Count Count Upstream Action Time
001e.6bfb.2d3c 1 0 Ca6/1/0/U0.0 D Mar 7 05:12:37
Router# show cable modem 0025.2e2d.7990 rf-adapt verbose
Action Action Source Destination Action
Time Type Upstream Upstream Reason
Mar 9 23:03:08 D Ca7/0/0/U0.0 Ca7/0/0/U0.1 SNR 26<28
Mar 9 21:50:05 U Ca7/0/0/U0.1 Ca7/0/0/U0.0 SNR 31>=31
Mar 9 21:37:02 D Ca7/0/0/U0.0 Ca7/0/0/U0.1 SNR 26<28
Mar 9 20:45:59 U Ca7/0/0/U0.1 Ca7/0/0/U0.0 SNR 32>=31
Mar 9 20:36:56 D Ca7/0/0/U0.0 Ca7/0/0/U0.1 SNR 27<28
Table 83 describes the significant fields shown in the display:
Table 116 show cable modem Field Descriptions
Field Description
MAC Address MAC address of the cable modem.
Downgrade Count Number of times the cable modem was relocated from the primary to the
secondary logical upstream channel.
Upgrade Count Number of times the cable modem was relocated from the secondary to the
primary logical upstream channel.
Primary Upstream The primary logical upstream at the time of the relocation event.
Last Action Last action performed on the cable modem; indicates whether the cable
modem was downgraded or upgraded.
Last Action Time Date and time when the last action was performed on the cable modem.
Action Time Date and time when the action was performed on the cable modem.
Action Type Upgrade or downgrade.
Source Upstream Upstream logical channel from where the cable modem is moved.
Destination Upstream Upstream logical channel to where the cable modem is moved.
Action Reason Reason for the relocation of the cable modem.
Related Commands
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1477
Cable Commands: show cable m through show cable u
show cable modem rf-adapt
Command Description
cable rf-adapt timer Configures timers for RF adaptation.
cable upstream rf-adapt Enables RF adaptation on the physical upstream channel.
cable upstream rf-adapt (logical Configures the primary upstream logical channel and secondary
channel) upstream logical channel.
cable upstream threshold Configures the upstream for the signal-to-noise ratio (SNR) and
forward error correction (FEC) threshold values to be used in
determining the allowable noise levels.
cable upstream threshold Configures the hysteresis value to be used in conjunction with the
hysteresis dynamic modulation upgrade thresholds.
cable upstream threshold Configures the upstream RF adaptation threshold value, which
rf-adapt prevents excessive relocation of modems from the primary
upstream channel to the secondary upstream channel.
show cable modem Displays information for the registered and unregistered cable
modems.
show cable modem phy Displays the DOCSIS PHY layer information for one or more
cable modems.
show cable modulation-profile Displays modulation profile group information.
show cable rf-adapt Displays the downgrade and upgrade candidate lists.
show interface cable modem Displays information about the cable modems connected to a
particular cable interface.
Cisco IOS CMTS Cable Command Reference
CBL-1478 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem rogue
show cable modem rogue
To display a list of cable modems that have been marked, locked, or rejected because they failed the
dynamic shared-secret authentication checks, use the show cable modem rogue command in privileged
EXEC mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] rogue
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn]
rogue
Syntax Description ip-address (Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you
specify the IP address for a CPE device behind a CM, information for that
CM is displayed.
mac-address (Optional) MAC address of a specific CM to be displayed. If you specify the
MAC address for a CPE device behind a CM, information for that CM is
displayed.
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.
subslot (Cisco uBR10012 only) Secondary slot number of the cable interface line
card. The valid subslots are 0 or 1.
port Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—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 IOS CMTS Cable Command Reference
OL-15510-15 CBL-1479
Cable Commands: show cable m through show cable u
show cable modem rogue
upstream port (Optional) Displays information for all CMs using the specified upstream
port. You can specify this option only when displaying information for a
cable interface. The valid range for port begins with 0 and ends with a value
that depends on the number of upstream ports supported by the cable
interface line card.
logical-channel-index (Optional) Logical channel index. The valid values are 0 or 1.
name fqdn (Optional) Specifies the fully qualified domain name (FQDN) of the cable
device to be displayed. This option is only available if the show cable
modem domain-name command has been run for the first time to update the
cable DNS cache on the CMTS router.
rogue Displays a list of cable modems that have been marked, locked, or rejected.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(15)BC1 This command was introduced for Cisco uBR7100 series, Cisco uBR7200
series, and Cisco uBR10012 routers.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA, with
the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was
added.
• The name keyword option was added for specifying the fully-qualified
domain name of a CM.
12.2(33)SCE This command was modified. The port parameter was changed to
cable-interface-index.
12.2(33)SCF This command was modified. The logical-channel-index argument was
added.
Usage Guidelines This command displays a list of cable modems that attempted to register with a DOCSIS configuration
file that does not pass the authentication required by the cable dynamic-secret command. After a cable
modem is added to the rogue list, it remains in the rogue list until one of the following occurs:
• The cable modem remains offline, without attempting to reregister, for 24 hours. It is then removed
from all of the CMTS internal databases, including the rogue list.
• An administrator manually deletes the cable modem from the CMTS internal databases, using the
clear cable modem delete command.
• An administrator unlocks the cable modem using the clear cable modem lock command.
Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first
on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable
command.
Cisco IOS CMTS Cable Command Reference
CBL-1480 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem rogue
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy,
the new primary processor after a switchover automatically creates a new database of the online cable
modems. This means that the show cable modem ip-address command might not show a particular cable
modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the
ping ip-address command, and then the show cable modem ip-address command will show the cable
modem. You can also display any particular cable modem by using the show cable modem | include
ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically
synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be
synchronized manually, using the hccp resync command. When a SYNC event command is occurring,
CLI commands might be very slow to respond. In particular, if you enter the show cable modem
command at the same time a SYNC event is occurring, the command might respond produce a blank
display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Examples The following sample output from the show cable modem rogue command.
Router# show cable modem rogue
Spoof TFTP
MAC Address Vendor Interface Count Dnld Dynamic Secret
AAAA.7b43.aa7f Vendor1 C4/0/U5 2 Yes 45494DC933F8F47A398F69EE6361B017
AAAA.7b43.aa7f Vendor1 C4/0/U5 2 Yes D47BCBB5494E9936D51CB0EB66EF0B0A
BBBB.7b43.aa7f Vendor2 C4/0/U5 2 No 8EB196423170B26684BF6730C099D271
AAAA.7b43.aa7f Vendor1 C4/0/U5 2 No DF8FE30203010001A326302430120603
BBBB.7b43.aa7f Vendor2 C4/0/U5 2 No 300E0603551D0F0101FF040403020106
AAAA.7b43.aa7f Vendor1 C4/0/U5 2 Yes 820101002D1A264CE212A1BB6C1728B3
DDDD.7b43.aa7f Vendor4 C4/0/U5 2 Yes 7935B694DCA90BC624AC92A519C214B9
AAAA.7b43.aa7f Vendor1 C4/0/U5 2 No 3AB096D00D56ECD07D9B7AB662451CFF
Router#
Table 0-117 describes the fields shown by the show cable modem rogue command.
Table 0-117 show cable modem Field Descriptions
Field Description
MAC Address The MAC address for the CM.
Vendor Vendor name for this cable modem, as configured using the cable modem
vendor command.
Interface The cable interface line card providing the upstream for this CM.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1481
Cable Commands: show cable m through show cable u
show cable modem rogue
Table 0-117 show cable modem Field Descriptions (continued)
Field Description
Spoof Count Number of times that this cable modem has attempted to register with an
invalid dynamic shared-secret value.
Note To account for possible network problems, such as loss of packets and
congestion, the Cisco CMTS will allow a cable modem to attempt to
register twice before marking it as having failed the dynamic
shared-secret authentication checks.
TFTP Dnld Whether TFT downloads are enforced, as configured by the cable
tftp-enforce command.
Dynamic Secret The dynamic shared-secret for this cable modem.
Related Commands Command Description
cable dynamic-secret Enables the Dynamic Shared Secret feature, so that DOCSIS configuration
files are verified with a Message Integrity Check (MIC) that has been
created with a dynamically generated shared secret.
cable modem vendor Associates the name of a vendor with its Organizational Unique Identifier
(OUI).
cable Configures one or more secondary shared secret keys that CMs can use to
shared-secondary-secre successfully process the DOCSIS configuration file and register with the
t CMTS.
cable shared-secret Configures an authentication shared secret key that CMs must use to
successfully process the DOCSIS configuration file and register with the
CMTS.
cable tftp-enforce Requires that all CMs on a cable interface attempt to download a DOCSIS
configuration file using the Trivial File Transfer Protocol (TFTP) through
the cable interface before being allowed to register and come online.
clear cable modem lock Resets the lock on one or more CMs, and reinitializes them, so that they
can reregister with a valid DOCSIS configuration file.
show cable modem Displays information for the registered and unregistered CMs.
show cable modem Displays RF adaptation information for cable modems.
rf-adapt
show interface cable Displays information about the CMs connected to a particular cable
modem interface.
show interface cable sid Displays the SID information for a CM.
Cisco IOS CMTS Cable Command Reference
CBL-1482 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem service-type-id
show cable modem service-type-id
To display the modems having the service type id, use the show cable modem service-type-id command
in privileged EXEC mode.
show cable modem service-type-id [service-type-id]
Syntax Description service-type-id Specifies the name of the service type identifier.
Command Default If no service type identifier is specified, this command will show all the CMs with their respective
service-type-id.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines This command shows CMs having specified service-type-id.
Examples The following example shows sample output for the show cable modem service-type-id command:
Router# show cable modem service-type-id
B D
MAC Address IP Address I/F MAC Prim Service-type-id P I
State Sid I P
0018.6812.29ae 41.42.2.212 C6/1/4/U2 offline 3838 commercial N N
0018.6811.f9f8 41.42.0.140 C6/1/4/U2 offline 3225 commercial N N
0018.6811.fba6 41.42.5.169 C6/1/4/U2 offline 3439 commercial N N
0018.6812.225a 41.42.3.210 C6/1/4/U2 offline 3355 commercial N N
0018.6811.fa8c 41.42.1.133 C6/1/4/U2 offline 3091 commercial N N
0018.6812.37e8 41.42.0.136 C6/1/4/U2 offline 7439 commercial N N
0018.6811.fbca 41.42.2.255 C6/1/4/U2 offline 6263 commercial N N
0018.6811.fb44 41.42.2.17 C6/1/4/U2 offline 2996 commercial N N
0018.6812.2f20 41.42.0.100 C6/1/4/U2 offline 3544 commercial N N
Table 118 describes the significant fields shown in the display.
Table 118 show cable modem service-type-id Field Descriptions
Field Description
MAC Address Hardware (MAC-layer) address of the cable modem or CPE
device.
IP Address IP address of the cable modem or CPE device.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1483
Cable Commands: show cable m through show cable u
show cable modem service-type-id
Table 118 show cable modem service-type-id Field Descriptions (continued)
Field Description
I/F The cable interface line card providing the upstream for this
CM.
MAC State The current state of the MAC layer.
Prim Sid Primary Service ID (SID) of the device.
Service Type Id Service Type identifier.
BPI Indicates whether or not Baseline Privacy Interface (BPI) or
BPI Plus (BPI+) encryption is enabled for the CM.
DIP Dual IP flag. Identifies whether or not (“Y” or “N”) the CM
or CPE supports both IPv4 and IPv6 addressing.
Related Commands Command Description
clear cable modem This command clears the cable modem service type id.
service-type-id
Cisco IOS CMTS Cable Command Reference
CBL-1484 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem service-flow
show cable modem service-flow
To display information about all service flows associated with a particular modem, use the show cable
modem service-flow command in privileged EXEC mode.
show cable modem {ip-address | mac-address} service-flow [verbose | ds-hardware]
Syntax Description ip-address Specifies the IPv4 address of a specific CM to be displayed. If you specify
the IP address for a CPE device behind a CM, information for that CM is
displayed.
mac-address Identifies the MAC address of a specific CM to be displayed. You can also
specify the MAC address for a CPE device behind a CM, and information for
that CM will be displayed.
service-flow Displays summary of relevant parameters and statistics for all service flows
associated with a particular modem.
verbose (Optional) Displays comprehensive details for all service flows associated
with a particular modem.
ds-hardware (Optional) Displays details of Baseline Privacy Interface (BPI), Payload
Header Suppression (PHS), Downstream Service Identifier (DSID) and
other statistical data.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCB1 This command was introduced for Cisco uBR7200 series and
Cisco uBR10012 routers in Cisco IOS Release 12.2(33)SCB1.
12.3(23)BC7 This command was integrated into Cisco IOS Release 12.3(23)BC7.
12.2(33)SCE This command was modified. The ds-hardware keyword was added.
12.2(33)SCF2 This command was modified. The command output was enhanced to display
upstream buffer control parameters.
Usage Guidelines The show cable modem service-flow command has a verbose and a non-verbose option. The
non-verbose command supports live debugging and provides a summary of relevant parameters and
statistics for all service flows of a particular modem. The verbose option of the command provides
comprehensive details for all service flows associated with a particular modem.
The optional ds-hardware keyword is used to display per service flow BPI, PHS, DSID and stats data
obtained directly from the hardware on the line card or SPA.
Note The output data for unconfigured or non applicable features are not always displayed.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1485
Cable Commands: show cable m through show cable u
show cable modem service-flow
Examples The following is a sample output of the show cable modem service-flow command without the verbose
option:
Router# show cable modem 40.30.0.5 service-flow
SUMMARY:
MAC Address IP Address Host MAC Prim Num Primary DS
Interface State Sid CPE Downstream RfId
001a.c30c.7eec 40.30.0.5 C7/0/0/U0 online 15 0 C7/0/0 Local
Sfid Dir Curr Sid Sched Prio MaxSusRate MaxBrst MinRsvRate Throughput
State Type
31 US act 15 BE 0 0 3044 0 0
32 DS act N/A BE 0 0 3044 0 0
UPSTREAM SERVICE FLOW DETAIL:
SFID SID Requests Polls Grants Delayed Dropped Packets
Grants Grants
31 15 0 0 0 0 0 0
DOWNSTREAM SERVICE FLOW DETAIL:
SFID RP_SFID QID Flg Policer Scheduler FrwdIF
Xmits Drops Xmits Drops
32 32817 131124 0 0 0 0 Ca7/0/0
Flags Legend:
$: Low Latency Queue (aggregated)
~: CIR Queue
The following is a sample output of the show cable modem service-flow command with the verbose
option, for Cisco IOS Release 12.2(33)SCF2:
Router# show cable modem 0022.cea5.02ba service-flow verbose
SUMMARY:
MAC Address IP Address Host MAC Prim Num Primary
DS
Interface State Sid CPE Downstrea
RfId
0022.cea5.02ba 5.60.122.132 C7/1/0/UB w-online 10 0 In7/1/0:0
840
Sfid Dir Curr Sid Sched Prio MaxSusRate MaxBrst MinRsvRate Throughp
State Type
29 US act 10 BE 0 100000 3044 0 0
30 DS act N/A BE 0 200000 3044 0 0
CfrId SFID CM Mac Address Direction State Priority Matches
Reg Info Requests Tx : 2
Reg Info TLV len : 152
UPSTREAM SERVICE FLOW DETAIL:
Cisco IOS CMTS Cable Command Reference
CBL-1486 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem service-flow
Sfid : 29
Mac Address : 0022.cea5.02ba
Type : Primary
Direction : Upstream
Current State : Active
Current QoS Indexes [Prov, Adm, Act] : [3, 4, 4]
Active Time : 03:45
Required Attributes : 0x00000000
Forbidden Attributes : 0x00000000
Aggregate Attributes : 0x00000000
Sid : 10
Service Class Name : REG-US
Traffic Priority : 0
Maximum Sustained rate : 100000 bits/sec
Maximum Burst : 3044 bytes
Minimum Reserved Rate : 0 bits/sec
Minimum Packet Size : 0 bytes
!Upstream Buffer Control Parameters
Minimum Buffer Size : 1000 bytes
Target Buffer Size : 1500 bytes
Maximum Buffer Size : 2000 bytes
Peak Rate : 0 bits/sec
Admitted QoS Timeout : 200 seconds
Active QoS Timeout : 0 seconds
Packets : 3
Bytes : 1020
Rate Limit Delayed Grants : 0
Rate Limit Dropped Grants : 0
Current Throughput : 0 bits/sec, 0 packets/sec
Application Priority : 0
US Bonded : YES
Upstream Bonding Group : UBG-1
Transmit Channel Set : 0x6
Sid Cluster : SC-0, Sid [ 10 10 ]
Segments Valid : 3
Segments Discarded : 0
Segments Lost : 0
SID Cluster Switching Information
Total Bytes Requested : 0
Total Time : 0
Outstanding Bytes : 0
Max Requests : 1
Classifiers: NONE
Sid : 10
Request polls issued : 0
BWReqs {Cont,Pigg,RPoll,Other} : 4, 0, 0, 0
No grant buf BW request drops : 0, where:0
Rate exceeded BW request drops : 0
Grants issued : 4
Packets received : 4
Bytes received : 1488
rate-adapt : Disabled
rate-adapt {rcvd, Consec-PB} : 0, 0
Fragment reassembly completed : 0
Fragment reassembly incomplete : 0
Concatenated packets received : 0
Queue-indicator bit statistics : 0 set, 0 granted
Good Codewords rx : 8
Corrected Codewords rx : 0
Uncorrectable Codewords rx : 0
Concatenated headers received : 0
Fragmentation headers received : 0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1487
Cable Commands: show cable m through show cable u
show cable modem service-flow
Fragmentation headers discarded: 0
ARP Requests Received : 2
Examples of show cable modem service-flow ds-hardware Command Output for Various Types of Modems
The following is a sample output of the show cable modem service-flow ds-hardware command on the
narrow band modem on a legacy interface:
Router# show cable modem 50.3.112.12 service-flow ds-hardware
LC SFID:15 RP SFID: 32999
KeyIndex: 6 PHSIndex: 0
TX Pkts: 9 TX Bytes: 636
BPI -
Said: 0x1 KeySeq:0x1
Even Key: 15DC474264C81500 Even Iv: 2619043723FB046B
Odd Key: 07A89421B4458B00 Odd Iv: 1FB0253D0D1C1643
PHS -
PHSM: 0000-0000-0000-0000
Ctrl: 0x0 PHSI: 0x0 PHSS: 0x0 Count: 0x0
The following is a sample output of the show cable modem service-flow ds-hardware command on the
narrow band modem with a modena remote primary channel:
Router# show cable modem 50.3.112.6 service-flow ds-hardware
LC SFID:7 RP SFID: 33007 StatIndex: 13
KeyIndex: 7 PHSIndex: 0
TX Pkts: 8 TX Bytes: 592
BPI -
KeyNum: 0x7 Control: 0xC001 KeySeq: 0x1
Even Key: 10F4-6BE1-D944-B0 Even Iv: 04B3-1CCD-25DA-163E
Odd Key: 0818-8A00-9D01-1E Odd Iv: 1C58-1967-16BC-0BD0
PHS -
PHSM: 0000-0000-0000-0000
Ctrl: 0x0 PHSI: 0x0 PHSS: 0x0 Count: 0x0
The following is a sample output of the show cable modem service-flow ds-hardware command on the
wideband modem on a remote modena:
Router# show cable modem 50.3.112.28 service-flow ds-hardware
LC SFID:9 RP SFID: 33001 StatIndex: 7
KeyIndex: 4 PHSIndex: 0
TX Pkts: 13 TX Bytes: 962
DSID: 0x11E Priority: 0x0 SCC: 0 Seqnum: 0xD
BPI -
KeyNum: 0x4 Control: 0xC002 KeySeq: 0x1
Even Key: 01B8-5830-9246-66 Even Iv: 0BAB-1CA8-0145-1AB9
Odd Key: 0720-8C81-FD04-6F Odd Iv: 0D80-13F1-0E32-083B
PHS -
PHSM: 0000-0000-0000-0000
Ctrl: 0x0 PHSI: 0x0 PHSS: 0x0 Count: 0x0
The following is a sample output of the show cable modem service-flow ds-hardware command on the
narrowband modem on an integrated interface:
Router# show cable modem 80.36.0.3 service-flow ds-hardware
LC SFID:50 RP SFID: 33150 StatIndex: 21
KeyIndex: 8 PHSIndex: 0
TX Pkts: 4 TX Bytes: 648
BPI (DES) -
KeyNum: 0x3 Said: 0x16 KeySeq:0x1
Even Key: 0A3C-5BC0-C9C0-9F Even Iv: 0204-25F7-07A1-026E
Odd Key: 0448-0392-26C4-55 Odd Iv: 087F-0B13-237A-1F89
Cisco IOS CMTS Cable Command Reference
CBL-1488 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem service-flow
PHS -
PHSM: 0000-0000-0000-0000
Ctrl: 0x0 PHSI: 0x0 PHSS: 0x0 Count: 0x0
The following is a sample output of the show cable modem service-flow ds-hardware command on the
wideband modem on a bonded local interface:
Router# show cable modem 80.36.0.122 service-flow ds-hardware
LC SFID:46 RP SFID: 33148 StatIndex: 19
KeyIndex: 7 PHSIndex: 0
TX Pkts: 200 TX Bytes: 23600
DSID: 0x152 Priority: 0x0 Seqnum: 0xC8
Enabled: 0x1 DPV Enabled: 0x0 SeqNum Change Cnt: 0x0
BPI (DES) -
KeyNum: 0x3 Said: 0x14 KeySeq:0x1
Even Key: 08E0-8C51-8AC2-A5 Even Iv: 0EA2-1FA8-1C32-2685
Odd Key: 12F4-3980-C984-53 Odd Iv: 0DA1-0BA2-0E4F-0864
PHS -
PHSM: 0000-0000-0000-0000
Ctrl: 0x0 PHSI: 0x0 PHSS: 0x0 Count: 0x0
Table 1 describes the significant fields shown in the output.
Table 119 show cable mode service-flow Field Descriptions
Field Description
MAC Address Hardware (MAC-layer) address of the cable modem or CPE
device.
IP Address IP address of the cable modem or CPE device.
Host Interface Host interface name.
MAC State Current state of the MAC layer.
Prim Sid Primary SID assigned to this CM.
Num CPE Number of CPE devices for which the CM is providing
services.
Primary Downstream Primary downstream channel assigned to the CM.
DS RfId Downstream RF identifier.
SFID Service flow identifier.
SID Service ID (SID) of the device.
Requests Number of requests.
Polls Number of polls.
Grants Number of grants.
Delayed Grants Number of delayed grants.
Dropped Grants Number of dropped grants.
Packets Number of packets.
RP_SFID Route processor SFID.
QID Link queue identification number.
Flg Indicates whether the queue is low latency or CIR.
Policer Xmits Packets transmitted out of the policer.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1489
Cable Commands: show cable m through show cable u
show cable modem service-flow
Table 119 show cable mode service-flow Field Descriptions (continued)
Field Description
Drops Packets dropped by the policer.
Scheduler Xmits Packets transmitted out of the scheduler.
Drops Packets dropped by the scheduler.
FrwdIF Forwarding interface.
LC SFID Line card SFID.
KeyIndex Per flow index to BPI data.
PHSIndex Per flow index to PHS data.
TX Pkts Number of packets the router has transmitted on this service
flow.
TX Bytes Number of bytes the router has transmitted on this service
flow.
BPI Indicates whether or not Baseline Privacy Interface (BPI)
encryption is enabled for the CM.
Said Security association identifier.
KeySeq Downstream traffic key sequence number.
Even Key Even traffic encryption key (TEK) value.
Even Iv Value of the even Initialization Vector (IV).
Odd Key Odd TEK key value.
Odd Iv Odd IV value.
PHS Payload header suppression.
PHSM PHS Mask. 5-bit PHS mask that defines the header bytes that
should be suppressed.
Ctrl Control block.
PHSI PHS Index. Number that uniquely references the PHS rule.
PHSS PHS Size. 8-bit value specifying the number of header bytes
to be suppressed.
Count PHS rule usage count.
Related Commands Command Description
show cable modem Displays information for the registered and unregistered CMs.
show cable modem access-group Displays the access groups for the CMs on a particular cable
interface.
show cable modem calls Displays displays voice call information for a particular CM,
identified either by its IP address or MAC address.
show cable modem classifiers Displays information about the classifiers for a particular CM.
show cable modem cnr Displays information about the upstream carrier-to-noise ratio
(CNR) for a particular cable modem.
show cable modem connectivity Displays connectivity statistics for one or more CMs.
Cisco IOS CMTS Cable Command Reference
CBL-1490 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem service-flow
Command Description
show cable modem counters Displays downstream and upstream traffic counters for one or
more CMs.
show cable modem cpe Displays the CPE devices accessing the cable interface through a
particular CM.
show cable modem Updates the cable-specific DNS cache and display the domain
domain-name name for specified CMs and CPE behind a CM on a Cisco CMTS
router.
show cable modem errors Displays error statistics for one or more CMs.
show cable modem flap Displays flap list statistics for one or more CMs.
show cable modem ipv6 Displays IPv6 information for specified CMs and CPE behind a
CM on a Cisco CMTS router.
show cable modem mac Displays MAC layer information for one or more CMs.
show cable modem maintenance Displays station maintenance (SM) error statistics for one or more
CMs.
show cable modem offline Displays a list of the CMs that are marked as offline with the
Cisco CMTS.
show cable modem phy Displays the DOCSIS PHY layer information for one or more
CMs.
show cable modem qos Displays quality of service (QoS) and service flow information for
a particular CM.
show cable modem registered Displays a list of the CMs that are marked as registered with the
Cisco CMTS.
show cable modem Displays information collected by the remote-query feature.
remote-query
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1491
Cable Commands: show cable m through show cable u
show cable modem summary
show cable modem summary
To display a summary of CMs on one or more cable interfaces, use the show cable modem summary
command in privileged EXEC mode.
show cable modem summary [total]
show cable modem summary interface1 [interface2] total
show cable modem summary interface1 [interface2] upstream port1 port2 total
show cable modem cable {slot/port | slot/cable-interface-index} [upstream port
[logical-channel-index]] summary
show cable modem cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port
[logical-channel-index]] summary
Syntax Description total (Optional) Displays a footer line showing the totals for each column.
interface1 (Optional) Cable interface to be summarized. The interface1 parameter can
take the following forms:
• cable {slot/port | slot/cable-interface-index}
• cable {slot/subslot/port | slot/subslot/cable-interface-index}
where,
• 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.
• subslot—(Cisco uBR10012 only) Secondary slot number of the cable
interface line card. The valid subslots are 0 or 1.
• port—Downstream port number.
– Cisco uBR7225VXR and Cisco uBR7246VXR routers—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 IOS CMTS Cable Command Reference
CBL-1492 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem summary
interface2 (Optional) Second cable interface, specifying a range of cable interfaces to
be summarized. The interface2 parameter has the same form as interface1.
Note When specifying a range of cable interfaces, interface1 must be the
lower-numbered interface and interface2 must be the
higher-numbered interface.
upstream port1 port2 (Optional) Specifies a range of upstream ports on the cable interfaces to be
summarized. The port1 and port2 parameters can start at 0, and port2 must
be a higher-numbered port than port1.
upstream port (Optional) Specifies a specific upstream port to be summarized. This option
can be specified only when summarizing a single cable interface.
logical-channel-index (Optional) Logical channel index. The valid values are 0 or 1.
summary Displays a summary of CMs on one or more cable interfaces.
Command Modes Privileged EXEC (#)
Command History Release Modification
11.3XA This command was introduced.
12.1(4)CX and Support was added for the Cisco uBR10012 router.
12.2(4)BC1
12.1(6)EC The total option was supported for the Cisco uBR7100 series and
Cisco uBR7200 series routers.
12.1(11b)EC The upstream Description field was added to the show cable modem
summary display in Cisco IOS Release 12.1 EC.
12.2(8)BC1 The total option was supported for the Cisco uBR10012 universal
broadband router.
12.2(15)BC2 The upstream Description field was added to the show cable modem
summary display in Cisco IOS Release 12.2 BC.
12.3(21)BC Support was added for wideband cable modem output.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
Support for the Cisco uBR7225VXR router was added.
12.2(33)SCE This command was modified. The port parameter was changed to
cable-interface-index.
12.2(33)SCF This command was modified. The logical-channel-index argument was
added.
Usage Guidelines This command displays a summary of CMs for a single cable interface or upstream, or for a range of
cable interfaces or upstreams. The following possible combinations are possible for this command:
• show cable modem summary total—Displays a summary and a total for all CMs on the chassis.
• show cable modem summary cable x/0 total—Displays a summary of CMs on a specified card.
• show cable modem summary cable x/0 upstream port1 port2 total—Displays a summary of CMs
on the specified card and specified range of ports. The port1 value must be less than the port2 value.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1493
Cable Commands: show cable m through show cable u
show cable modem summary
• show cable modem summary cable x/0 cable y/0 total—Displays a summary of CMs on the
specified range of cards.
• show cable modem summary cable x/0 cable y/0 upstream port1 port2 total—Displays a
summary of CMs on the specified range of ports on the specified range of cards.
Note Also see the information about this command’s behavior in a Hot Standby Connection-to-Connection
Protocol (HCCP) configuration, see the “Operation with Hot Standby Connection-to-Connection
Protocol (HCCP) Configuration” in the Cisco Broadband Cable Command Reference Guide.
Examples The following example shows typical output for the default form of the show cable modem summary
command on a Cisco uBR7200 series router:
Router# show cable modem summary
Interface Total Active Registered Description
Modems Modems Modems
Cable3/0/U0 165 141 141 Line 32/1
Cable3/0/U1 209 172 170 Line 32/2
Cable3/0/U2 262 207 203 Line 32/3
Cable3/0/U3 256 194 188 Line 32/4
Cable5/0/U0 746 714 711 Line 41/1
Cable6/0/U0 806 764 759 Line 42/2
Router#
Note The Description field appears in Cisco IOS Release 12.1(11b)EC, 12.2(15)BC2, and later releases, and
shows the string configured for the upstream using the cable upstream description command.
The following example shows typical output for the show cable modem summary command with the
total option on a Cisco uBR7200 series router:
Router# show cable modem summary total
Interface Total Active Registered Description
Modems Modems Modems
Cable5/0/U0 746 714 711 Node1
Cable6/0/U1 806 764 759 Node3
Total: 1552 1478 1470
Router#
The following example shows sample output for the show cable modem summary command with the
total option for a Cisco uBR10012 router:
Router# show cable modem summary total
Interface Cable Modem Description
Total Reg Unreg Offline Wideband initRC initD initIO initO
C5/0/0/U0 84 84 0 0 84 0 0 0 0
C5/0/0/U1 84 84 0 0 84 0 0 0 0
C5/0/0/U2 83 83 0 0 83 0 0 0 0
C5/0/0/U3 83 83 0 0 83 0 0 0 0
<<output omitted>>
Total: 8020 8020 0 0 8016 0 0 0 0
Cisco IOS CMTS Cable Command Reference
CBL-1494 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem summary
Router#
The following example shows sample output for the show cable modem summary total command for
a range of interfaces on the Cisco uBR10012 router:
Router# show cable modem summary c5/1/1 c5/1/2 total
Interface Cable Modem Description
Total Reg Unreg Offline Wideband initRC initD initIO initO
C5/1/1/U0 84 84 0 0 84 0 0 0 0
C5/1/1/U1 84 84 0 0 83 0 0 0 0
C5/1/1/U2 83 83 0 0 83 0 0 0 0
C5/1/1/U3 83 83 0 0 83 0 0 0 0
C5/1/2/U0 84 84 0 0 84 0 0 0 0
C5/1/2/U1 84 84 0 0 84 0 0 0 0
C5/1/2/U2 83 83 0 0 83 0 0 0 0
C5/1/2/U3 83 83 0 0 83 0 0 0 0
Total: 668 668 0 0 667 0 0 0 0
Router#
The following example shows sample output for the show cable modem summary total command for
a range of interfaces and upstreams on the Cisco uBR10012 router:
Router# show cable modem summary c5/1/1 c5/1/2 upstream 0 1 total
Interface Cable Modem Description
Total Reg Unreg Offline Wideband initRC initD initIO initO
C5/1/1/U0 84 84 0 0 84 0 0 0 0
C5/1/1/U1 84 84 0 0 83 0 0 0 0
C5/1/2/U0 84 84 0 0 84 0 0 0 0
C5/1/2/U1 84 84 0 0 84 0 0 0 0
Total: 336 336 0 0 335 0 0 0 0
Router#
Note When displaying a summary for a range of ports or cable interfaces, the first port or cable interface (for
example, u0 or c4/0) must be lower-numbered than the second port or interface (for example, u6 or c6/0).
If you specify the higher-numbered port or interface first, the display shows no CMs connected.
Table 0-120 describes the fields shown in the show cable modem summary displays:
Table 0-120 Descriptions for the show cable modem summary Fields
Field Description
Interface The cable interface line card providing the upstream for the CMs.
Total Modems or Total Total number of CMs, registered, unregistered, and offline for this interface.
Registered Modems or Total number of CMs that have registered and are online on this interface.
Reg This number might be different from the Total Modems number if some
modems are offline or not fully registered.
Unregistered Modems Total number of CMs that are either offline and not currently communicating
with the CMTS, or attempting to come online but are not yet registered.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1495
Cable Commands: show cable m through show cable u
show cable modem summary
Table 0-120 Descriptions for the show cable modem summary Fields (continued)
Field Description
Offline Total number of CMs that were online or attempted to register but are no
longer communicating with the CMTS.
Wideband CM is registered as a wideband CM.
init(rc) MAC state of CM is init(rc).
init(d) MAC state of CM is init(d).
init(io) MAC state of CM is init(io).
init(o) MAC state of CM is init(o).
Description Description entered for this upstream using the cable upstream description
command.
Note For information on MAC states, see the show cable modem command.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Related Commands Command Description
show cable modem Displays information for the registered and unregistered CMs.
show cable modem Displays the access groups for the CMs on a particular cable interface.
access-group
show cable modem Displays voice call information for a particular CM, identified either by its
calls IP address or MAC address.
show cable modem Displays connectivity statistics for one or more CMs.
connectivity
show cable modem Displays downstream and upstream traffic counters for one or more CMs.
counters
show cable modem Displays the CPE devices accessing the cable interface through a particular
cpe CM.
show cable modem Displays a list of the CMs that are marked as offline with the Cisco CMTS.
offline
show cable modem Displays a list of the CMs that are marked as registered with the
registered Cisco CMTS.
show cable modem Displays information collected by the remote-query feature.
remote-query
show cable modem Displays RF adaptation information for cable modems.
rf-adapt
show cable modem Displays a list of the CMs that are marked as unregistered with the
unregistered Cisco CMTS.
Cisco IOS CMTS Cable Command Reference
CBL-1496 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem summary
Command Description
show cable modem Displays the vendor name or Organizational Unique Identifier (OUI) for the
vendor CMs on each cable interface.
show interface cable Displays information about the CMs connected to a particular cable
modem interface.
show interface cable Displays cable interface information.
sid
show cable modem Displays information for a wideband CMs.
wideband
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1497
Cable Commands: show cable m through show cable u
show cable modem summary wb-rf
show cable modem summary wb-rf
To display the number of RF channels that are down on a cable interface, use the show cable modem
summary wb-rf command in privileged EXEC mode.
show cable modem [cable slot/subslot/port] summary wb-rf [modular-cable
slot/bay/port:nb-channel-number]
Syntax Description cable slot/subslot/port (Optional) Specifies the cable interface. The following are the
valid values:
• slot—Specifies the chassis slot number of the cable
interface line card. Valid values are 5to 8.
• subslot—Specifies the secondary slot number of the cable
interface line card. Valid subslots are 0 or 1.
• port—Specifies the port number. Valid values are 0 to 4
(depending on the cable interface).
modular-cable (Optional) Specifies the modular cable interface. The following
slot/bay/port:nb-channel-number are the valid values:
• slot—The slot where a SIP resides. On the Cisco uBR10012
router, slots 1 and 3 can be used for SIPs.
• bay—The bay in a SIP where a SPA is located. Valid values
are 0 (upper bay) and 1 (lower bay).
• port—Specifies the interface number on the SPA.
• nb-channel-number—Specifies the narrowband channel
number.
Command Default No default behavior or values.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCB This command was introduced.
Cisco IOS CMTS Cable Command Reference
CBL-1498 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem summary wb-rf
Examples The following is a sample output of the show cable modem summary wb-rf command on the cable
interface at slot/subslot/port 8/0/0:
Router# show cable modem cable 8/0/0 summary wb-rfs
Total Total Percent
RF w-online RF down RF down
-------- -------- ------- -------
1/0/0 0 4 0 0
1 6 0 0
2 7 0 0
The following is a sample output of the show cable modem summary wb-rf command on the modular
cable interface at slot/bay/port and narrowband channel 1/0/0 18:
Router# show cable modem c8/0/0 summary wb-rfs modular-cable 1/0/0 18
Total Total Percent
RF w-online RF down RF down
-------- -------- ------- -------
1/0/0 18 0 0 0
Related Commands
Command Description
show cable modem Displays a summary of CMs on one or more cable interfaces.
summary
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1499
Cable Commands: show cable m through show cable u
show cable modem tcs summary
show cable modem tcs summary
To display transmit channel set (TCS) information on the Cisco CMTS router, use the show cable
modem tcs summary command in privileged EXEC mode.
show cable modem tcs summary
Syntax Description There are no keywords or arguments.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCG This command was introduced.
Examples Following is a sample output of the show cable modem tcs summary command:
Router# show cable modem tcs summary
Interface Cable Modem
Total Reg Oper Unreg Offline Wideband TCS USCB
C7/0/0/U0-3 8 8 8 0 0 8 3840 1,2
C7/0/0/U0 3 3 3 0 0 2
C7/0/0/U1 2 2 2 0 0 2
C7/0/0/U3 5 5 5 0 0 0
C7/1/0/U3 1 1 1 0 0 0
C7/1/1/U0 1 0 0 1 1 0
C8/0/0/U0-1,2.0,3 3 3 3 0 0 3 3840
1,2,3,4,5,6,7,8
Total: 23 22 22 1 1 15
Note In the above example, the interface value indicates the upstream channels of the TCS. The interface is
displayed as U0-1 3 5-7 when the TCS is U0, U1, U3, U5, U6, U7 and if it is a logical channel, the
interface is displayed as U0.0,1.0,3.0.
Table 121 describes the significant fields shown in the display:
Table 121 show cable modem tcs summary Field Descriptions
Field Description
Interface Cable interface line card providing the upstream for the CMs.
Total Modems or Total Total number of CMs, registered, unregistered, and offline for this interface.
Registered Modems or Total number of CMs that have registered and are online on this interface.
Reg This number might be different from the Total Modems number if some
modems are offline or not fully registered.
Cisco IOS CMTS Cable Command Reference
CBL-1500 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem tcs summary
Table 121 show cable modem tcs summary Field Descriptions (continued)
Field Description
Oper Total number of CMs that are operational.
Unregistered Modems Total number of CMs that are either offline and not currently communicating
or Unreg with the Cisco CMTS, or attempting to come online but are not yet registered.
Offline Total number of CMs that were online or attempted to register but are no
longer communicating with the Cisco CMTS.
Wideband CM is registered as a wideband CM.
TCS TCS ID.
USCB Upstream bonding group ID.
Related Commands Command Description
show cable modem Displays information for the registered and unregistered CMs on the Cisco
CMTS router.
show interface cable Displays information about the CMs connected to a particular cable interface
modem on the Cisco CMTS router.
show cable modem Displays information for a wideband CM on the Cisco CMTS router.
wideband
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1501
Cable Commands: show cable m through show cable u
show cable modem type
show cable modem type
To display cable modem (CM) provisioning information for all CMs, such as boot mode configuration
and MAC and IP address information, use the show cable modem type command in privileged EXEC
configuration mode.
Cisco uBR7246VXR Router and Cisco uBR7225VXR Router
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] type
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] type
Syntax Description ip-address (Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you
specify the IP address for a CPE device behind a CM, information for that
CM is displayed.
mac-address (Optional) MAC address of a specific CM to be displayed. If you specify the
MAC address for a CPE device behind a CM, information for that CM is
displayed.
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.
subslot (Cisco uBR10012 only) Secondary slot number of the cable interface line
card. The valid subslots are 0 or 1.
port Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—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 IOS CMTS Cable Command Reference
CBL-1502 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem type
upstream port (Optional) Displays information for all CMs using the specified upstream
port. You can specify this option only when displaying information for a
cable interface. The valid range for port begins with 0 and ends with a value
that depends on the number of upstream ports supported by the cable
interface line card.
logical-channel-index (Optional) Logical channel index. The valid values are 0 or 1.
name fqdn (Optional) Specifies the fully qualified domain name (FQDN) of the cable
device to be displayed. This option is only available if the show cable
modem domain-name command has been run for the first time to update the
cable DNS cache on the CMTS router.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCA This command was introduced.
12.2(33)SCE This command was modified. The port parameter was changed to
cable-interface-index.
12.2(33)SCF This command was modified. The logical-channel-index argument was
added.
Usage Guidelines In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first
on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable
command.
Examples The following example shows sample output for the show cable modem type command :
Router# show cable modem type
Boot Mode configuration:
P - Primary Boot mode (IPv6 or IPv4)
D - Dual Stack (Yes/No)
A - Alternative Provisioning Mode (Yes/No)
MAC Address Interface P/D/A IPv4 address IPv6 Address
0004.27a5.b761 C6/0/2/U1 v6/N/N 10.7.0.161 ---
0007.0e01.d9a1 C6/0/2/U0 v6/N/N 10.7.0.162 ---
0006.2854.7275 C6/0/2/U1 v6/Y/N 10.7.0.3 2001:ODB8:3800:80B:7565:5B87:1D7D:5AD5
0018.6835.27dd C6/0/U0 v6/N/N --- 2001:0DB8:3800:803:41D7:DECC:F15D:133
Table 122 describes the significant fields shown in the display.
Table 122 show cable modem type Field Descriptions
Field Description
MAC Address MAC address of this CM.
Interface Cable line card interface and upstream associated with this
CM.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1503
Cable Commands: show cable m through show cable u
show cable modem type
Table 122 show cable modem type Field Descriptions (continued)
Field Description
P/D/A String of 3 values representing the boot mode configuration
of the CM as follows:
• P—Primary Boot Mode, where “v4” or “v6” indicates
IPv4 or IPv6 as the primary addressing mode.
• D—Dual Stack, where “Y” or “N” indicates whether or
not both IPv4 and IPv6 addressing modes are supported.
• A—Alternative Provisioning Mode (APM), where “Y”
or “N” indicates whether or not APM is supported.
Note APM is not supported by the Cisco CMTS routers in
Cisco IOS Release 12.2(33)SCA.
IPv4 address IPv4 address acquired by the CM. Prior to acquisition of the
IP address, or if the CM fails IPv4 registration, the following
output is shown:
• IPv4 address not yet acquired—“0.0.0.0”
• CM fails IPv4 registration, but online with IPv6 address:
“---”
• IPv4 address of an IPv6-only CM: “---”
IPv6 Address IPv6 address acquired by the CM. Prior to acquisition of the
IP address, or if the CM fails IPv6 registration, the following
output is shown:
• IPv6 address not yet acquired—“::”
• CM fails IPv6 registration, but online with IPv4 address
“---”
• IPv6 address of IPv4-only CM: “---”
Related Commands Command Description
show cable modem Displays information for the registered and unregistered CMs.
show cable modem Displays RF adaptation information for cable modems.
rf-adapt
Cisco IOS CMTS Cable Command Reference
CBL-1504 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem unregistered
show cable modem unregistered
To display a list of the cable modems (CMs) that are marked as unregistered with the Cisco CMTS, use
the show cable modem unregistered command in privileged EXEC mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] unregistered
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn]
unregistered
Syntax Description ip-address (Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you
specify the IP address for a CPE device behind a CM, information for that
CM is displayed.
mac-address (Optional) MAC address of a specific CM to be displayed. If you specify the
MAC address for a CPE device behind a CM, information for that CM is
displayed.
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.
subslot (Cisco uBR10012 only) Secondary slot number of the cable interface line
card. The valid subslots are 0 or 1.
port Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—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 IOS CMTS Cable Command Reference
OL-15510-15 CBL-1505
Cable Commands: show cable m through show cable u
show cable modem unregistered
upstream port (Optional) Displays information for all CMs using the specified upstream
port. You can specify this option only when displaying information for a
cable interface. The valid range for port begins with 0 and ends with a value
that depends on the number of upstream ports supported by the cable
interface line card.
logical-channel-index (Optional) Logical channel index. The valid values are 0 or 1.
name fqdn (Optional) Specifies the fully qualified domain name (FQDN) of the cable
device to be displayed. This option is only available if the show cable
modem domain-name command has been run for the first time to update the
cable DNS cache on the CMTS router.
Defaults Displays a list of all unregistered CMs on the Cisco CMTS router.
Command Modes Privileged EXEC (#)
Command History Release Modification
11.3 NA This command was introduced.
12.2(4)BC1 This command was introduced on the Cisco uBR10012 router.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA, with
the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was
added.
• The name keyword option was added for specifying the fully-qualified
domain name of a CM.
• The following new initialization states were added to show
initialization of CMs and CPEs supporting IPv6:
– init6(s)—CMTS router has seen SOLICIT message.
– init6(a)—CMTS router has seen ADVERTISE message.
– init6(r)—CMTS router has seen REQUEST message.
– init6(i)—CMTS router has seen REPLY message.
– init6(o)—CMTS router has seen version 6 TFTP request.
– init6(t)—CMTS router has seen version 6 TOD request.
12.2(33)SCE This command was modified. The port parameter was changed to
cable-interface-index.
12.2(33)SCF This command was modified. The logical-channel-index argument was
added.
Cisco IOS CMTS Cable Command Reference
CBL-1506 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem unregistered
Usage Guidelines Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy,
the new primary processor after a switchover automatically creates a new database of the online cable
modems. This means that the show cable modem ip-address command might not show a particular cable
modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the
ping ip-address command, and then the show cable modem ip-address command will show the cable
modem. You can also display any particular cable modem by using the show cable modem | include
ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically
synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be
synchronized manually, using the hccp resync command. When a SYNC event command is occurring,
CLI commands might be very slow to respond. In particular, if you enter the show cable modem
command at the same time a SYNC event is occurring, the command might respond produce a blank
display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first
on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable
command.
Examples The following example shows sample output for the default form of the show cable modem
unregistered command.
Router# show cable modem unregistered
Interface Prim Online Timing Rec QoS CPE IP address MAC address
Sid State Offset Power
Cable3/0/U0 1 online 2812 -0.25 5 1 3.18.1.5 0030.80bc.2303
Cable3/0/U0 2 online 2804 0.50 5 0 3.18.1.9 0006.2854.73f5
C6/0/U0 6 init6(i) 1532 -0.50 2 0 0.0.0.0 0018.6835.27dd
The following example shows sample output for the show cable modem unregistered command for a
particular cable interface:
Router# show cable modem c8/1/0 unregistered
Interface Prim Online Timing Rec QoS CPE IP address MAC address
Sid State Offset Power
C8/1/0/U1 1 online 1548 0.00 5 0 22.1.1.11 0050.7366.1243
C8/1/0/U4 2 online 1925 0.00 5 0 23.1.1.10 0002.b970.0027
C8/1/0/U4 3 online 1918 -0.50 2 0 22.1.1.10 0006.5314.858d
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1507
Cable Commands: show cable m through show cable u
show cable modem unregistered
The following example shows sample output for the show cable modem unregistered command for a
single CM, as identified by its IP address:
Router# show cable modem 22.1.1.10 unregistered
Interface Prim Online Timing Rec QoS CPE IP address MAC address
Sid State Offset Power
C8/1/0/U4 3 online 1918 -0.75 2 0 22.1.1.10 0006.5314.858d
The following example shows sample output for the show cable modem unregistered command for a
single CM, as identified by its MAC address:
Router# show cable modem 0006.5314.858d unregistered
Interface Prim Online Timing Rec QoS CPE IP address MAC address
Sid State Offset Power
C8/1/0/U4 3 online 1918 -0.25 2 0 22.1.1.10 0006.5314.858d
Note An asterisk (*) in the Receive Power column indicates that a power adjustment has been made for that
CM. An exclamation point (!) in the Receive Power column indicates that the CM has reached its
maximum power transmit level and cannot increase its power level further. An exclamation point (!) in
the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset
specified by the cable map-advance command.
A pound sign (#) in the MAC State column indicates that the cable tftp-enforce mark-only command
has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before
registering, but the CM did not do so (Cisco IOS Release 12.1(11b)EC1 and Cisco IOS
Release 12.2(8)BC2 or later releases).
Tip The show cable modem command displays the CM timing offset in DOCSIS ticks, while other
commands, such as cable map-advance, display the offset in microseconds. Use the following method
to convert microseconds to DOCSIS ticks: ticks = microseconds*64/6.25.
Table 123 describes the major fields shown in the show cable modem unregistered displays:
Table 123 Descriptions for the show cable modem unregistered Fields
Field Description
Interface The cable interface line card providing the upstream for this CM.
Prim SID The primary SID assigned to this CM.
Online State The current state of the MAC layer (see Table 101).
Cisco IOS CMTS Cable Command Reference
CBL-1508 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem unregistered
Table 123 Descriptions for the show cable modem unregistered Fields (continued)
Field Description
Timing Offset The timing offset for the CM, in ticks, as recognized on the CMTS. (A tick,
as used here, is 6.25/64 microseconds.) This is the delay between when a
particular cable modem is scheduled to make a transmission and when the
CMTS actually receives it.
Note An exclamation point (!) in the Timing Offset column indicates that
the CM has exceeded the maximum delay and timing offset specified
by the cable map-advance command.
Note The timing offset shown here is typically smaller than the TX Time
Offset value shown by the show cable modem remote-query
command, because the latter value is the offset as recognized on the
CM (which will include any internal delay between when the CM
software begins the transmission and when the bits actually appear on
the local cable interface).
Rec Power The received power level (in dB) for the CM.
Note An asterisk (*) in the RxPwr column indicates that a power
adjustment has been made for that CM. An exclamation point (!)
indicates that the CM has reached its maximum power transmit level
and cannot increase its power level further.
QoS Displays the QoS profile assigned to the CM (DOCSIS 1.1 and DOCSIS 2.0
CMs only).
CPE Indicates the number of CPE devices for which the CM is providing services.
IP Address The IP address that the DHCP server has assigned to the CM.
MAC Address The MAC address for the CM.
Table 101 shows the possible values for the Online State field:
Table 124 Descriptions for the Online State Field 1
MAC State Value Description
Registration and Provisioning Status Conditions for Devices Using IPv4 Addressing
init(r1) The CM sent initial ranging.
init(r2) The CM is ranging. The CMTS received initial ranging from the Cm and has sent
RF power, timing offset, and frequency adjustments to the CM.
init(rc) Ranging has completed.
Note If a CM appears to be stuck in this state, it could be that the CM is able
to communicate successfully on the cable network, but that the upstream
is at capacity and does not have any additional bandwidth to allow the
CM to finish registration and come online. Either manually move one or
more CMs to other upstreams, or enable load balancing on the upstream
using the cable load-balance group commands.
init(d) The DHCP request was received, as DHCPDISCOVER. This also indicates that
the first IP broadcast packet has been received from the CM.
init(dr) The DHCP request has been sent to the cable modem.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1509
Cable Commands: show cable m through show cable u
show cable modem unregistered
Table 124 Descriptions for the Online State Field (continued)1
MAC State Value Description
init(i) The cable modem has received the DHCPOFFER reply (DHCPACK) from the
DHCP server that has assigned an IP address to the modem, but the modem has
not yet replied with a DHCPREQUEST message requesting that particular IP
address, nor has it sent an IP packet with that IP address.
Note If a CM appears to be stuck in this state, the CM has likely received the
DHCPOFFER reply from the DHCP server, but this reply might have
contained one or more invalid options for that particular CM.
init(io) The Cisco CMTS has seen the DHCP offer as sent to the cable modem from the
DHCP server that has assigned an IP address to the modem.
init(o) The CM has begun to download the option file (DOCSIS configuration file)
using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP
response. If the CM remains in this state, it indicates that the download has
failed.
init(t) Time-of-day (TOD) exchange has started.
resetting The CM is being reset and will shortly restart the registration process.
Registration and Provisioning Status Conditions for Devices Using IPv6 Addressing
init6(s) The Cisco CMTS router has seen the DHCPv6 SOLICIT message from the CM.
init6(a) The Cisco CMTS router has seen the ADVERTISE message from the DHCPv6
server to the CM.
init6(r) The Cisco CMTS router has seen the REQUEST response from the CM to the
DHCPv6 server.
init6(i) The Cisco CMTS router has seen the REPLY message from the DHCPv6 server
to the CM.
init6(o) The Cisco CMTS router has seen the REQEST message from the CM to the TFTP
server.
init6(t) The Cisco CMTS router has seen the REQUEST message from the CM to the
TOD server.
Non-error Status Conditions
cc(r1) The CM had registered and was online, but has received a Downstream Channel
Change (DCC) or Upstream Channel Change (UCC) request message from the
CMTS. The CM has begun moving to the new channel, and the CMTS has
received the CM’s initial ranging on the new downstream or upstream channel.
At the MAC layer, the CM is considered offline because it is not yet passing
traffic on the new channel, but this state does not trigger the flap-list counters.
cc(r2) This state should normally follow cc(r1) and indicates that the CM has finished
its initial ranging on the new channel, and is currently performing continuous
ranging on the new channel. At the MAC layer, the CM is considered offline
because it is not yet passing traffic on the new channel, but this state does not
trigger the flap-list counters.
offline The CM is considered offline (disconnected or powered down).
online The CM has registered and is enabled to pass data on the network.
Cisco IOS CMTS Cable Command Reference
CBL-1510 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem unregistered
Table 124 Descriptions for the Online State Field (continued)1
MAC State Value Description
online(d) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. The CM does not forward
traffic to or from the CPE devices, but the CMTS can continue to communicate
with the CM using DOCSIS messages and IP traffic (such as SNMP commands).
Note If BPI was enabled in the DOCSIS configuration file sent to the CM,
assume that the CM is using BPI encryption, unless other messages show
that the BPI negotiation and key assignments have failed.
online(pkd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled and
KEK is assigned.
Note This state is equivalent to the online(d) and online(pk) states.
online(ptd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled and
TEK is assigned. BPI encryption is now being performed.
Note This state is equivalent to the online(d) and online(pt) states.
online(pk) The CM registered, BPI is enabled and KEK is assigned.
online(pt) The CM registered, BPI is enabled and TEK is assigned. BPI encryption is now
being performed.
Note If network access was disabled in the DOCSIS configuration file sent to
the CM, the network disabled status takes precedence, and the MAC
status field shows online(d) instead of online(pt) even when BPI
encryption is enabled and operational.
Note If an exclamation point (!) appears in front of one of the online states, it indicates that the cable
dynamic-secret command has been used with either the mark or reject option, and that the
cable modem has failed the dynamic secret authentication check.
expire(pk) The CM registered, BPI is enabled, KEK was assigned, but the current KEK
expired before the CM could successfully renew a new KEK value.
expire(pkd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled,
KEK was assigned, but the current KEK expired before the CM could
successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pk) states.
expire(pt) The CM registered, BPI is enabled, TEK was assigned, but the current TEK
expired before the CM could successfully renew a new KEK value.
expire(ptd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled,
TEK was assigned, but the current TEK expired before the CM could
successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pt) states.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1511
Cable Commands: show cable m through show cable u
show cable modem unregistered
Table 124 Descriptions for the Online State Field (continued)1
MAC State Value Description
Error Status Conditions
reject(m) The CM attempted to register but registration was refused due to a bad Message
Integrity Check (MIC) value. This also could indicate that the shared secret in
the DOCSIS configuration file does not match the value configured on the CMTS
with the cable shared-secret command.
In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later
releases, this could also indicate that the cable tftp-enforce command has been
used to require that a CM attempt a TFTP download of the DOCSIS
configuration file before registering, but the CM did not do so.
reject(c) The CM attempted to register, but registration was refused due to a a number of
possible errors:
• The CM attempted to register with a minimum guaranteed upstream
bandwidth that would exceed the limits imposed by the cable upstream
admission-control command.
• The CM has been disabled because of a security violation.
• A bad class of service (COS) value in the DOCSIS configuration file.
• The CM attempted to create a new COS configuration but the CMTS is
configured to not permit such changes.
• The CM failed the timestamp check for its DOCSIS configuration file. (This
could indicate a possible theft-of-service attempt, or a problem with the
synchronization of the clocks on the CM and CMTS.)
reject(pk) KEK key assignment is rejected, BPI encryption has not been established.
reject(pkd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI encryption was
not established because KEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pk) states.
reject(pt) TEK key assignment is rejected, BPI encryption has not been established.
reject(ptd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI encryption was
not established because TEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pt) states.
Note In Cisco IOS Release 12.1(20)EC, Cisco IOS Release 12.2(15)BC1, and earlier releases, when
network access is disabled in the DOCSIS configuration file sent to the CM, the network
disabled status takes precedence, and the MAC status field shows online(d) even if BPI
encryption fails. Use the show cable modem mac-address command to confirm whether BPI
is enabled or disabled for a particular cable modem.
reject(ts) The CM attempted to register, but registration failed because the TFTP server
timestamp in the CM registration request did not match the timestamp maintained
by the CMTS. This might indicate that the CM attempted to register by replaying
an old DOCSIS configuration file used during a prior registration attempt.
Cisco IOS CMTS Cable Command Reference
CBL-1512 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem unregistered
Table 124 Descriptions for the Online State Field (continued)1
MAC State Value Description
reject(ip) The CM attempted to register, but registration failed because the IP address in
the CM request did not match the IP address that the TFTP server recorded when
it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.
reject(na) The CM attempted to register, but registration failed because the CM did not send
a Registration-Acknowledgement (REG-ACK) message in reply to the
Registration-Response (REG-RSP) message sent by the CMTS. A
Registration-NonAcknowledgement (REG-NACK) is assumed.
1. The CM MAC state field can also be retrieved using SNMP by getting the value of the cdxCmtsCmStatusValue object in the
CISCO-DOCS-EXT-MIB.
Related Commands Command Description
cable modem vendor Associates the name of a vendor with its Organizational Unique Identifier
(OUI).
show cable modem Displays information for the registered and unregistered CMs.
show cable modem Displays the access groups for the CMs on a particular cable interface.
access-group
show cable modem Displays information about the classifiers for a particular CM.
classifiers
show cable modem Displays connectivity statistics for one or more CMs.
connectivity
show cable modem Displays the CPE devices accessing the cable interface through a particular
cpe CM.
show cable modem Displays a list of the CMs that are marked as offline with the Cisco CMTS.
offline
show cable modem Displays a list of the CMs that are marked as registered with the
registered Cisco CMTS.
show cable modem Displays RF adaptation information for cable modems.
rf-adapt
show cable modem Displays the vendor name or Organizational Unique Identifier (OUI) for the
vendor CMs on each cable interface.
show interface cable Displays information about the CMs connected to a particular cable
modem interface.
show interface cable Displays cable interface information.
sid
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1513
Cable Commands: show cable m through show cable u
show cable modem vendor
show cable modem vendor
To display the vendor name or Organizational Unique Identifier (OUI) for the CMs on each cable
interface, use the show cable modem vendor command in privileged EXEC mode.
show cable modem [cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port
[logical-channel-index]]] vendor [summary]
Syntax Description 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 subslots
are 0 or 1.
port Downstream port number. 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 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.
upstream port (Optional) Displays information for all CMs using this specific upstream.
You can specify this option only when displaying information for a cable
interface. The valid range for port begins with 0 and ends with a value that
depends on the number of upstream ports on the cable interface line card.
logical-channel-index (Optional) Logical channel index. The valid values are 0 or 1.
summary (Optional) Displays the total numbers for each vendor and OUI, along with
the total numbers of those vendor’s CMs that are currently registered with
the CMTS, unregistered, or offline.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(8)BC2 This command was introduced for the Cisco uBR7100 series,
Cisco uBR7200 series, and Cisco uBR10012 routers.
12.2(33)SCE This command was modified. The port parameter was changed to
cable-interface-index.
12.2(33)SCF This command was modified. The logical-channel-index argument was
added.
Usage Guidelines This command displays the vendor name for each CM. If the vendor name has not been defined by the
cable modem vendor command, the command displays the OUI value for the modem’s vendor.
Cisco IOS CMTS Cable Command Reference
CBL-1514 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem vendor
Note The Institute of Electrical and Electronics Engineers (IEEE) is the official issuer of OUI values. The
IEEE OUI web site is at http://standards.ieee.org/regauth/oui/index.shtml.
Note Also see the information about this command’s behavior in a Hot Standby Connection-to-Connection
Protocol (HCCP) configuration.
Examples The following example shows typical output for the show cable modem vendor command:
Router# show cable modem vendor
Vendor MAC Address I/F MAC Prim RxPwr Timing Num BPI
State Sid (db) Offset CPE Enb
Cisco 0001.9659.519f C1/0/U0 init(rc) 16 0.75 2738 0 N
Cisco 0002.b96f.fdbb C1/0/U0 online 20 1.00 2738 1 N
Cisco 0002.b96f.fdf9 C1/0/U0 online 21 0.50 2737 1 N
Cisco 0002.b96f.fff7 C1/0/U0 online 12 0.50 2737 1 N
Cisco 0002.fdfa.1163 C1/0/U0 online 1 0.00 2734 1 N
Cisco 0002.fdfa.12d5 C1/0/U0 online 14 0.00 2737 1 N
Cisco 0002.fdfa.12db C1/0/U0 online 18 0.25 2736 1 N
Cisco 0002.fdfa.12e9 C1/0/U0 online 13 0.25 2737 1 N
Cisco 0006.28dc.37fd C1/0/U0 offline 7 0.25 2734 0 N
Cisco 0006.28e9.81c9 C1/0/U0 online 2 0.75 2735 1 N
Motorola 0020.28f9.9d19 C1/0/U0 online 28 -0.25 2733 1 N
Motorola 0020.4006.b010 C1/0/U0 online 19 0.00 2728 1 N
00.C0.FF 00c0.FF78.8bea C1/0/U0 offline 10 1.25 2732 0 N
Cisco 00b0.6478.ae8d C1/0/U0 offline 10 1.50 2735 0 N
Cisco 00d0.bad3.c0cd C1/0/U0 online 26 0.25 2214 1 N
Cisco 00d0.bad3.c0d5 C1/0/U0 online 27 0.00 2215 1 N
Router#
The following example shows typical output for the show cable modem vendor command on the
Cisco uBR10012 router:
Router# show cable modem vendor
Vendor MAC Address I/F MAC Prim RxPwr Timing Num BPI
State Sid (db) Offset CPE Enb
Thomson 0010.9507.01db C5/1/0/U5 online 1 0.00 938 1 N
Ericsson 0080.37b8.e99b C5/1/0/U5 online 2 -0.25 1268 0 N
Cisco 0002.fdfa.12ef C6/1/0/U0 online 13 0.00 1920 1 N
Cisco 0002.fdfa.137d C6/1/0/U0 online 16 -0.50 1920 1 N
Cisco 0003.e38f.e9ab C6/1/0/U0 online 3 -0.25 1926 1 N
Cisco 0003.e3a6.7f69 C6/1/0/U0 online 15 0.50 1927 1 N
Cisco 0003.e3a6.816d C6/1/0/U0 online 4 0.00 1929 1 N
Cisco 0006.28f9.8be5 C6/1/0/U0 online 12 0.75 1922 1 N
Cisco 0001.9659.519f C6/1/1/U2 online 26 0.25 1930 1 N
Cisco 0002.b96f.fdbb C6/1/1/U2 online 29 -0.75 1929 1 N
Cisco 0002.b96f.fdf9 C6/1/1/U2 online 39 -0.50 1931 1 N
Cisco 0002.b96f.fff7 C6/1/1/U2 online 38 0.00 1928 1 N
Cisco 0002.fdfa.1163 C6/1/1/U2 online 15 0.00 1923 1 N
Cisco 0002.fdfa.12d5 C6/1/1/U2 online 35 0.25 1923 1 N
Cisco 0002.fdfa.12e9 C6/1/1/U2 online 5 -0.25 1925 1 N
Cisco 0050.7302.3d73 C6/1/1/U2 online 58 0.25 1553 1 N
Cisco 0002.fdfa.12db C7/0/0/U0 online 15 -0.75 1914 1 N
Cisco 0002.fdfa.138d C7/0/0/U5 online 4 0.25 1917 1 N
Cisco 0003.e38f.e85b C7/0/0/U5 online 17 0.25 1919 1 N
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1515
Cable Commands: show cable m through show cable u
show cable modem vendor
Cisco 0003.e38f.f4cb C7/0/0/U5 online 16 0.00 1922 1 N
Cisco 0003.e3a6.7fd9 C7/0/0/U5 online 1 0.25 1922 0 N
Motorola 0020.4005.3f06 C7/0/0/U0 online 2 0.00 1901 1 N
Motorola 0020.4006.b010 C7/0/0/U5 online 3 0.25 1901 1 N
Cisco 0050.7302.3d83 C7/0/0/U0 online 18 -0.25 1543 1 N
Cisco 00b0.6478.ae8d C7/0/0/U5 online 44 0.50 1920 21 N
Cisco 00d0.bad3.c0cd C7/0/0/U5 online 19 0.00 1543 1 N
Cisco 00d0.bad3.c0cf C7/0/0/U0 online 13 0.00 1546 1 N
Cisco 00d0.bad3.c0d5 C7/0/0/U0 online 12 -0.50 1546 1 N
Router#
Tip The show cable modem vendor command displays the CM timing offset in DOCSIS ticks, while other
commands, such as cable map-advance, display the offset in microseconds. Use the following method
to convert microseconds to DOCSIS ticks: ticks = microseconds*64/6.25.
Table 0-125 describes the major fields shown in the show cable modem vendor displays:
Table 0-125 Descriptions for the show cable modem vendor Fields
Field Description
Vendor The vendor name for the indicated CM, as specified by the cable modem
vendor command. If no name for this vendor has been specified, displays the
modem’s OUI value.
MAC Address The MAC address for the CM.
I/F The cable interface line card providing the upstream for this CM.
MAC State The current state of the MAC layer.
Prim SID The primary SID assigned to this CM.
RxPwr The received power level (in dB) for the CM.
Note An asterisk (*) in the RxPwr column indicates that a power
adjustment has been made for that CM. An exclamation point (!)
indicates that the CM has reached its maximum power transmit level
and cannot increase its power level further.
Timing Offset The timing offset for the CM, in ticks, as recognized on the CMTS. (A tick,
as used here, is 6.25/64 microseconds.) This is the delay between when a
particular cable modem is scheduled to make a transmission and when the
CMTS actually receives it.
Note An exclamation point (!) in the Timing Offset column indicates that
the CM has exceeded the maximum delay and timing offset specified
by the cable map-advance command.
Note The timing offset shown here is typically smaller than the TX Time
Offset value shown by the show cable modem remote-query
command, because the latter value is the offset as recognized on the
CM (which will include any internal delay between when the CM
software begins the transmission and when the bits actually appear on
the local cable interface).
Num CPE Indicates the number of CPE devices for which the CM is providing services.
BPI Enbld Indicates whether Baseline Privacy Interface (BPI) or BPI Plus (BPI+)
encryption is enabled for the CM.
Cisco IOS CMTS Cable Command Reference
CBL-1516 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem vendor
Note An asterisk (*) in the RxPwr column indicates that a power adjustment has been made for that CM. An
exclamation point (!) in the Receive Power column indicates that the CM has reached its maximum
power transmit level and cannot increase its power level further. An exclamation point (!) in the Timing
Offset column indicates that the CM has exceeded the maximum delay and timing offset specified by
the cable map-advance command.
A pound sign (#) in the MAC State column indicates that the cable tftp-enforce mark-only command
has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before
registering, but the CM did not do so (Cisco IOS Release 12.1(11b)EC1 and Cisco IOS
Release 12.2(8)BC2 or later releases).
The following example shows typical output for the show cable modem vendor summary command,
displaying the total numbers for each vendor and OUI, along with the total numbers of those vendor’s
CMs that are currently registered with the CMTS, unregistered, or offline.
Router# show cable modem vendor summary
Vendor OUI Cable Modem
Total Registered Unregistered Offline
00.02.B2 00.02.B2 4288 3997 291 259
00.0A.73 00.0A.73 4105 3938 167 108
00.0B.06 00.0B.06 1060 1001 59 48
00.40.7B 00.40.7B 216 211 5 2
00.50.04 00.50.04 701 684 17 15
00.50.DA 00.50.DA 737 706 31 26
00.D0.DD 00.D0.DD 2 0 2 2
3Com 00.01.03 669 645 24 21
3Com 00.04.75 10 10 0 0
Ambit 00.D0.59 1 1 0 0
BestData 00.E0.CA 1 1 0 0
Cisco 00.04.C1 1 1 0 0
LinkSys 00.06.25 15 13 2 2
Motorola 00.04.BD 705 676 29 21
Motorola 00.08.0E 762 734 28 16
Motorola 00.20.40 1504 1444 60 45
Powercom 00.30.3B 3 2 1 1
SMC 00.04.E2 1 1 0 0
Terayon 00.E0.6F 652 612 40 25
Thomson 00.10.95 127 121 6 5
Toshiba 00.00.39 1 1 0 0
Turbo 00.90.83 4 4 0 0
Zoom 00.40.36 1 1 0 0
Router#
Tip You can add a timestamp to this command using the exec prompt timestamp command in line
configuration mode.
Related Commands Command Description
cable modem vendor Associates the name of a vendor with its Organizational Unique Identifier
(OUI).
show cable modem Displays information for the registered and unregistered CMs.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1517
Cable Commands: show cable m through show cable u
show cable modem vendor
Command Description
show cable modem Displays connectivity statistics for one or more CMs.
connectivity
show cable modem Displays the CPE devices accessing the cable interface through a particular
cpe CM.
show cable modem Displays information collected by the remote-query feature.
remote-query
show cable modem Displays RF adaptation information for cable modems.
rf-adapt
show interface cable Displays information about the CMs connected to a particular cable
modem interface.
show interface cable Displays cable interface information.
sid
Cisco IOS CMTS Cable Command Reference
CBL-1518 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem voice
show cable modem voice
To show the detected voice-enabled modems, use the show cable modem voice command.
show cable modem voice [pending|failed]
Syntax Description pending (Optional) Displays cable modems that are being moved to the target channel via
Downstream Frequency Override (DFO).
failed (Optional) Displays cable modems that have already reached the maximum
Downstream Frequency Override retry limit without success.
Command Default No default behavior or values
Command Modes Privileged EXEC
Command History Release Modification
12.3(23)BC This command was introduced for the Cisco uBR10012 router.
Usage Guidelines Use this command to display the detected voice-enabled modems.
Note The show cable modem voice command is not supported on the Cisco uBR-MC28U line card on the
Cisco uBR7200 series routers.
Examples Router# show cable modem voice
MAC Address IP Address Host MAC Prim Num Primary DS
Interface State Sid CPE Downstream RfId
0013.10bb.22f9 80.17.1.2 C6/0/0/U0 online(pt) 2 0 Mo3/0/0:1 1
0013.10bb.23d1 80.17.1.5 C6/0/1/U1 online(pt) 5 0 C6/0/1 255
Related Commands show cable service-voice Displays the downstream-types that are capable of providing voice
downstream-type services.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1519
Cable Commands: show cable m through show cable u
show cable modem wideband
show cable modem wideband
To display information for registered and unregistered wideband CMs, use the show cable modem
wideband command in privileged EXEC mode.
show cable modem wideband [registered-traditional-docsis | channel ]
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]]] wideband
[channel]
Syntax Description ip-address (Optional) Identifies the IP address of a specific wideband CM to be
displayed. If you specify the IP address for a CPE device behind a CM,
information for that CM is displayed.
mac-address (Optional) Identifies the MAC address of a specific wideband CM to
be displayed. If you specify the MAC address for a CPE device behind
a wideband CM, information for that wideband CM is displayed.
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
subslots are 0 or 1.
port Downstream port number. 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 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.
upstream port (Optional) Displays information for all CMs using this specific
upstream. You can specify this option only when displaying
information for a cable interface. The valid range for port begins with
0 and ends with a value that depends on the number of upstream ports
on the cable interface line card.
logical-channel-index (Optional) Logical channel index. The valid values are 0 or 1.
registered-traditional-docsis (Optional) Displays information for wideband CMs that are currently
registered as traditional DOCSIS modems.
channel (Optional) Displays the number of downstream (DS) and upstream
(US) channels used by a cable modem.
Command Modes Privileged EXEC (#)
Cisco IOS CMTS Cable Command Reference
CBL-1520 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem wideband
Command History Release Modification
12.3(21)BC This command was introduced for the Cisco uBR10012 universal broadband
router.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
12.2(33)SCB This command output no longer shows the downstream (DS) channel ID or
the bonding group (BG) ID. A new column was added to display the Receive
Channel Configuration (RCC) ID of the RCC assigned to the cable modem.
12.2(33)SCE This command was modified. The port parameter was changed to
cable-interface-index.
12.2(33)SCF This command was modified. The channel keyword and
logical-channel-index argument was added.
12.2(33)SCG This command output was modified to display direct downstream and
upstream channel information on downstream channel bonding (DSCB) and
upstream channel bonding (USCB) partial services.
Usage Guidelines This command displays information for a one or more wideband CMs. Optionally, the CMs for which
to display information can be identified IP address, MAC address, or cable interface.
If a wideband-capable CM is not able to register as a wideband CM (for example, if no wideband channel
is available), the CM attempts to register as a traditional DOCSIS modem. The
registered-traditional-docsis keyword limits the set of wideband CMs for which to display information
to wideband-capable CMs that are currently registered as DOCSIS 1.X or DOCSIS 2.0 modems.
Examples Example of the show cable modem wideband Command in a Cisco IOS Release Prior to
Cisco IOS Release 12.2(33)SCB
The following is a sample output for the default form of the show cable modem wideband command
on a Cisco uBR10012 router running a Cisco IOS Release prior to Cisco IOS Release 12.2(33)SCB:
Router# show cable modem wideband
MAC Address IP Address I/F MAC Prim BGDSID MD-DS-SG
State Sid ID
0014.bfbe.3cc0 1.11.0.1 C5/0/1/U0 w-online(pt) 3 24 24 N/A
0016.92f0.90d6 1.11.0.4 C5/0/1/U0 w-online(pt) 5 24 272 1
0014.bfbe.3cb8 1.11.0.2 C6/0/1/U0 w-online(pt) 3 36 36 N/A
0016.92f0.90d8 1.11.0.3 C6/0/1/U0 w-online(pt) 5 36 274 1
Example of the show cable modem wideband Command in Cisco IOS Release 12.2(33)SCB
The following is a sample output for the default form of the show cable modem wideband command
on a Cisco uBR10012 router running Cisco IOS Release 12.2(33)SCB:
Router# show cable modem wideband
MAC Address IP Address I/F MAC Prim RCC MD-DS-SG
State Sid ID
0014.bfbe.4694 30.2.0.3 C8/0/0/U0 w-online(pt) 3 1 1
0018.6852.84aa 30.2.0.5 C8/0/0/U0 w-online(pt) 4 2 1
Note The RCC ID refers to the output of the show cable mac-domain rcc command.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1521
Cable Commands: show cable m through show cable u
show cable modem wideband
Examples of the show cable modem wideband channel Command in Cisco IOS Release 12.2(33)SCF
The following is a sample output of the show cable modem wideband channel command for all cable
modems:
Router# show cable modem wideband channel
MAC Address IP Address I/F MAC DSxUS Primary
State WB
0018.6852.7b76 80.62.0.5 C6/1/0/U0 w-online 2x1 Wi6/1/0:1
0019.474a.c182 80.62.0.2 C6/1/0/U0 w-online 2x1 Wi6/1/0:1
The following is a sample output of the show cable modem wideband channel command for a specific
cable modem identified by its IP address:
Router# show cable modem 80.62.0.5 wideband channel
MAC Address IP Address I/F MAC DSxUS Primary
State WB
0018.6852.7b76 80.62.0.5 C6/1/0/U0 w-online 2x1 Wi6/1/0:1
The following is a sample output of the show cable modem wideband channel command for a specific
cable modem identified by its MAC address:
Router# show cable modem 0018.6852.7b76 wideband channel
MAC Address IP Address I/F MAC DSxUS Primary
State WB
0018.6852.7b76 80.62.0.5 C6/1/0/U0 w-online 2x1 Wi6/1/0:1
The following is a sample output of the show cable modem wideband channel command for a specific
cable interface:
Router# show cable modem Cable 6/1/0 wideband channel
MAC Address IP Address I/F MAC DSxUS Primary
State WB
0018.6852.7b76 80.62.0.5 C6/1/0/U0 w-online 2x1 Wi6/1/0:1
0019.474a.c182 80.62.0.2 C6/1/0/U0 w-online 2x1 Wi6/1/0:1
Table 126 describes the significant fields shown in the display:
Table 126 show cable modem wideband Field Descriptions
Field Description
MAC Address MAC address for the CM.
IP Address IP address that the DHCP server has assigned to the CM.
I/F Cable interface providing the upstream for this CM.
MAC State Current state of the MAC layer (see Table 127).
Prim SID Primary SID assigned to this CM.
Bonding group ID Identifier of the primary wideband channel.
DSID Downstream Service Identifier.
DSxUS Number of DS and US channels used by the CM.
Primary WB Primary wideband channel for the CM.
MD-DS-SG MAC Domain Downstream Service Group, the downstream channels of a
single MAC domain that reach the cable modem.
Cisco IOS CMTS Cable Command Reference
CBL-1522 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem wideband
Following is a sample output of the show cable modem wideband command in
Cisco IOS Release 12.2(33)SCG:
Router# show cable modem cable 7/0/0 wideband channel
MAC Address IP Address I/F MAC DSxUS Primary
State WB
001a.c30c.7f04 40.4.58.4 C7/0/0/U3 w-online(pt) 3x1 Wi7/0/0:0
54d4.6ffb.2f6b 40.4.58.16 C7/0/0/p w-online(pt) 3x3 Wi7/0/0:0
54d4.6ffb.30fd 40.4.58.14 C7/0/0/p w-online(pt) 3x3 Wi7/0/0:0
4458.2945.2ade 40.4.58.18 C7/0/0/p w-online(pt) 3x3 Wi7/0/0:0
001e.6bfc.d1ea 40.4.58.26 C7/0/0/p w-online 3x3 Wi7/0/0:0
001a.c30c.7dbc 40.4.58.7 C7/0/0/U2 w-online(pt) 3x1 Wi7/0/0:0
001a.c30c.7efc 40.4.58.6 C7/0/0/U2 w-online(pt) 3x1 Wi7/0/0:0
001a.c30c.7e1e 40.4.58.8 C7/0/0/U2 w-online(pt) 3x1 Wi7/0/0:0
54d4.6ffb.2e1b 40.4.58.23 C7/0/0/p w-online(pt) 3x3 Wi7/0/0:0
4458.2945.2a78 40.4.58.21 C7/0/0/p w-online(pt) 3x3 Wi7/0/0:0
4458.2945.4604 40.4.58.19 C7/0/0/p w-online(pt) 3x3 Wi7/0/0:0
Table 127 shows the possible values for the MAC State field for a wideband CM modem that registers
as a traditional DOCSIS modem:
Table 127 Descriptions for the MAC State Field (for Traditional DOCSIS Modems) 1
MAC State Value Description
Registration and Provisioning Status Conditions
init(r1) The CM sent initial ranging.
init(r2) The CM is ranging. The CMTS received initial ranging from the CM and has sent
RF power, timing offset, and frequency adjustments to the CM.
init(rc) Ranging has completed.
Note If a CM appears to be stuck in this state, it could be that the CM is able
to communicate successfully on the cable network, but that the upstream
is at capacity and does not have any additional bandwidth to allow the
CM to finish registration and come online. Either manually move one or
more CMs to other upstreams, or enable load balancing on the upstream
using the cable load-balance group commands.
init(d) The DHCP request was received, as DHCPDISCOVER. This also indicates that
the first IP broadcast packet has been received from the CM.
init(dr) The DHCP request has been sent to the cable modem.
init(i) The cable modem has received the DHCPOFFER reply (DHCPACK) from the
DHCP server that has assigned an IP address to the modem, but the modem has
not yet replied with a DHCPREQUEST message requesting that particular IP
address, nor has it sent an IP packet with that IP address.
Note If a CM appears to be stuck in this state, the CM has likely received the
DHCPOFFER reply from the DHCP server, but this reply might have
contained one or more invalid options for that particular CM.
init(io) The Cisco CMTS has seen the DHCP offer as sent to the cable modem from the
DHCP server that has assigned an IP address to the modem.
init(o) The CM has begun to download the option file (DOCSIS configuration file)
using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP
response. If the CM remains in this state, it indicates that the download has
failed.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1523
Cable Commands: show cable m through show cable u
show cable modem wideband
Table 127 Descriptions for the MAC State Field (for Traditional DOCSIS Modems) 1
MAC State Value Description
init(t) Time-of-day (TOD) exchange has started.
resetting The CM is being reset and will shortly restart the registration process.
Non-error Status Conditions
cc(r1) The CM had registered and was online, but has received a Downstream Channel
Change (DCC) or Upstream Channel Change (UCC) request message from the
CMTS. The CM has begun moving to the new channel, and the CMTS has
received the CM’s initial ranging on the new downstream or upstream channel.
At the MAC layer, the CM is considered offline because it is not yet passing
traffic on the new channel, but this state does not trigger the flap-list counters.
cc(r2) This state should normally follow cc(r1) and indicates that the CM has finished
its initial ranging on the new channel, and is currently performing continuous
ranging on the new channel. At the MAC layer, the CM is considered offline
because it is not yet passing traffic on the new channel, but this state does not
trigger the flap-list counters.
offline The CM is considered offline (disconnected or powered down).
online The CM has registered and is enabled to pass data on the network.
online(d) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. The CM does not forward
traffic to or from the CPE devices, but the CMTS can continue to communicate
with the CM using DOCSIS messages and IP traffic (such as SNMP commands).
Note If BPI was enabled in the DOCSIS configuration file sent to the CM,
assume that the CM is using BPI encryption, unless other messages show
that the BPI negotiation and key assignments have failed.
online(pkd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled and
KEK is assigned.
Note This state is equivalent to the online(d) and online(pk) states.
online(ptd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled and
TEK is assigned. BPI encryption is now being performed.
Note This state is equivalent to the online(d) and online(pt) states.
online(pk) The CM registered, BPI is enabled and KEK is assigned.
online(pt) The CM registered, BPI is enabled and TEK is assigned. BPI encryption is now
being performed.
Note If network access was disabled in the DOCSIS configuration file sent to
the CM, the network disabled status takes precedence, and the MAC
status field shows online(d) instead of online(pt) even when BPI
encryption is enabled and operational.
Note If an exclamation point (!) appears in front of one of the online states, it indicates that the cable
dynamic-secret command has been used with either the mark or reject option, and that the
cable modem has failed the dynamic secret authentication check.
expire(pk) The CM registered, BPI is enabled, KEK was assigned, but the current KEK
expired before the CM could successfully renew a new KEK value.
Cisco IOS CMTS Cable Command Reference
CBL-1524 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem wideband
Table 127 Descriptions for the MAC State Field (for Traditional DOCSIS Modems) 1
MAC State Value Description
expire(pkd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled,
KEK was assigned, but the current KEK expired before the CM could
successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pk) states.
expire(pt) The CM registered, BPI is enabled, TEK was assigned, but the current TEK
expired before the CM could successfully renew a new KEK value.
expire(ptd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI is enabled,
TEK was assigned, but the current TEK expired before the CM could
successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pt) states.
Error Status Conditions
reject(m) The CM attempted to register but registration was refused due to a bad Message
Integrity Check (MIC) value. This also could indicate that the shared secret in
the DOCSIS configuration file does not match the value configured on the CMTS
with the cable shared-secret command.
In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later
releases, this could also indicate that the cable tftp-enforce command has been
used to require that a CM attempt a TFTP download of the DOCSIS
configuration file before registering, but the CM did not do so.
reject(c) The CM attempted to register, but registration was refused due to a a number of
possible errors:
• The CM attempted to register with a minimum guaranteed upstream
bandwidth that would exceed the limits imposed by the cable upstream
admission-control command.
• The CM has been disabled because of a security violation.
• A bad class of service (COS) value in the DOCSIS configuration file.
• The CM attempted to create a new COS configuration but the CMTS is
configured to not permit such changes.
• The CM failed the timestamp check for its DOCSIS configuration file. (This
could indicate a possible theft-of-service attempt, or a problem with the
synchronization of the clocks on the CM and CMTS.)
reject(pk) KEK key assignment is rejected, BPI encryption has not been established.
reject(pkd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI encryption was
not established because KEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pk) states.
reject(pt) TEK key assignment is rejected, BPI encryption has not been established.
reject(ptd) The CM registered, but network access for CPE devices using this CM has been
disabled through the DOCSIS configuration file. In addition, BPI encryption was
not established because TEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pt) states.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1525
Cable Commands: show cable m through show cable u
show cable modem wideband
Table 127 Descriptions for the MAC State Field (for Traditional DOCSIS Modems) 1
MAC State Value Description
reject(ts) The CM attempted to register, but registration failed because the TFTP server
timestamp in the CM registration request did not match the timestamp maintained
by the CMTS. This might indicate that the CM attempted to register by replaying
an old DOCSIS configuration file used during a prior registration attempt.
reject(ip) The CM attempted to register, but registration failed because the IP address in
the CM request did not match the IP address that the TFTP server recorded when
it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.
reject(na) The CM attempted to register, but registration failed because the CM did not send
a Registration-Acknowledgement (REG-ACK) message in reply to the
Registration-Response (REG-RSP) message sent by the CMTS. A
Registration-NonAcknowledgement (REG-NACK) is assumed.
1. The CM MAC state field can also be retrieved using SNMP by getting the value of the cdxCmtsCmStatusValue object in the
CISCO-DOCS-EXT-MIB.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Table 128 shows the possible values for the MAC state field for a wideband-capable CM that registers
as a wideband modem:
Table 128 Additional MAC States for a Wideband Cable Modem
MAC State Value Description
Non-error Status Conditions
w-online The WCM has registered and is enabled to pass data on the network.
w-online(d) The WCM registered, but network access for CPE devices using this WCM
has been disabled through the DOCSIS configuration file. The CM does not
forward traffic to or from the CPE devices, but the WCMTS can continue to
communicate with the WCM using DOCSIS messages and IP traffic (such as
SNMP commands).
Note If BPI was enabled in the DOCSIS configuration file sent to the
WCM, assume that the CM is using BPI encryption, unless other
messages show that the BPI negotiation and key assignments have
failed.
w-online(pkd) The WCM registered, but network access for CPE devices using this WCM
has been disabled through the DOCSIS configuration file. In addition, BPI is
enabled and KEK is assigned.
Note This state is equivalent to the w-online(d) and w-online(pk) states.
w-online(pt) The WCM registered, BPI is enabled and TEK is assigned. BPI encryption is
now being performed.
Note If network access was disabled in the DOCSIS configuration file sent
to the WCM, the network disabled status takes precedence, and the
MAC status field shows w-online(d) instead of w-online(pt) even
when BPI encryption is enabled and operational.
Cisco IOS CMTS Cable Command Reference
CBL-1526 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem wideband
Table 128 Additional MAC States for a Wideband Cable Modem
MAC State Value Description
w-online(ptd) The WCM registered, but network access for CPE devices using this WCM
has been disabled through the DOCSIS configuration file. In addition, BPI is
enabled and TEK is assigned. BPI encryption is now being performed.
Note This state is equivalent to the w-online(d) and w-online(pt) states.
w-online(pk) The WCM registered, BPI is enabled and KEK is assigned.
w-expire(pk) The WCM registered, BPI is enabled, KEK was assigned, but the current
KEK expired before the WCM could successfully renew a new KEK value.
w-expire(pkd) The WCM registered, but network access for CPE devices using this WCM
has been disabled through the DOCSIS configuration file. In addition, BPI is
enabled, KEK was assigned, but the current KEK expired before the CM
could successfully renew a new KEK value.
Note This state is equivalent to the w-online(d) and w-expire(pk) states.
w-expire(pt) The WCM registered, BPI is enabled, TEK was assigned, but the current TEK
expired before the WCM could successfully renew a new KEK value.
w-expire(ptd) The WCM registered, but network access for CPE devices using this WCM
has been disabled through the DOCSIS configuration file. In addition, BPI is
enabled, TEK was assigned, but the current TEK expired before the WCM
could successfully renew a new KEK value.
Note This state is equivalent to the w-online(d) and w-expire(pt) states.
Error Status Conditions
w-reject(pk) KEK key assignment is rejected, BPI encryption has not been established.
w-reject(pkd) The WCM registered, but network access for CPE devices using this WCM
has been disabled through the DOCSIS configuration file. In addition, BPI
encryption was not established because KEK key assignment was rejected.
Note This state is equivalent to the w-online(d) and w-reject(pk) states.
w-reject(pt) TEK key assignment is rejected, BPI encryption has not been established.
w-reject(ptd) The WCM registered, but network access for CPE devices using this WCM
has been disabled through the DOCSIS configuration file. In addition, BPI
encryption was not established because TEK key assignment was rejected.
Note This state is equivalent to the w-online(d) and w-reject(pt) states.
Related Commands Command Description
show cable modem Associates the name of a vendor with its Organizational Unique Identifier
vendor (OUI).
show cable modem Displays information for the registered and unregistered CMs.
show cable modem Displays voice call information for a particular CM, identified either by its
summary IP address or MAC address.
show cable modem Displays information about the classifiers for a particular CM.
classifiers
show cable modem Displays information about the upstream carrier-to-noise ratio (CNR) for a
cnr particular cable modem.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1527
Cable Commands: show cable m through show cable u
show cable modem wideband
Command Description
show cable modem Displays connectivity statistics for one or more CMs.
connectivity
show cable modem Displays error statistics for one or more CMs.
errors
show cable modem Displays flap list statistics for one or more cable modems.
flap
show cable modem Displays station maintenance (SM) error statistics for one or more cable
maintenance modems.
show cable modem Displays information collected by the remote-query feature.
remote-query
show cable modem Displays RF adaptation information for cable modems.
rf-adapt
show cable Displays modulation profile group information.
modulation-profile
show interface cable Displays information about the CMs connected to a particular cable
modem interface.
show interface cable Displays cable interface information.
sid
Cisco IOS CMTS Cable Command Reference
CBL-1528 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem wideband phy
show cable modem wideband phy
To display the physical information of registered and unregistered wideband CMs on the Cisco CMTS
router, use the show cable modem wideband phy command in privileged EXEC mode.
show cable modem wideband phy
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCG This command was introduced.
Examples The following is a sample output for the default form of the show cable modem wideband phy
command:
Router# show cable modem wideband phy
MAC Address IP Address I/F MAC Chan Frq SNR Pwr
State Desc (MHZ) (db) (dBmV)
001a.c30c.7f04 40.4.58.4 C7/0/0/U3 w-online(pt) dsPri 555 ----- 0.00
dsSec 561 N/A N/A
dsSec 567 N/A N/A
us3 13 36.12 0.00
54d4.6ffb.2f6b 40.4.58.16 C7/0/0/p w-online(pt) dsPri 555 ----- 0.00
dsSec 561 N/A N/A
dsSec 567 N/A N/A
us0 31 36.12 45.00
us1 37 ----- 44.00
us2 20 36.12 44.50
us3 13 36.12 44.00
54d4.6ffb.30fd 40.4.58.14 C7/0/0/p w-online(pt) dsPri 561 ----- 0.00
dsSec 555 N/A N/A
dsSec 567 N/A N/A
us0 31 36.12 44.75
us1 37 ----- 44.00
us2 20 36.12 44.00
us3 13 36.12 44.75
4458.2945.2ade 40.4.58.18 C7/0/0/p w-online(pt) dsPri 555 ----- 0.00
dsSec 561 N/A N/A
dsSec 567 N/A N/A
us0 31 36.12 23.50
us1 37 ----- 23.50
us2 20 36.12 23.50
us3 13 36.12 23.50
001e.6bfc.d1ea 40.4.58.26 C7/0/0/p w-online dsPri 555 ----- 0.00
dsSec 561 N/A N/A
dsSec 567 N/A N/A
us0 31 36.12 46.25
us1 37 ----- 46.25
us2 20 36.12 46.25
us3 13 36.12 46.25
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1529
Cable Commands: show cable m through show cable u
show cable modem wideband phy
54d4.6ffb.2e21 40.4.58.5 C7/0/0/p w-online(pt) dsPri 555 ----- 0.00
dsSec 561 N/A N/A
dsSec 567 N/A N/A
us0 31 36.12 45.50
us1 37 ----- 45.00
us2 20 36.12 45.00
us3 13 36.12 45.00
001a.c30c.7dbc 40.4.58.7 C7/0/0/U2 w-online(pt) dsPri 555 ----- 0.00
dsSec 561 N/A N/A
dsSec 567 N/A N/A
us2 20 36.12 0.00
001a.c30c.7efc 40.4.58.6 C7/0/0/U2 w-online(pt) dsPri 555 ----- 0.00
dsSec 561 N/A N/A
dsSec 567 N/A N/A
us2 20 36.12 0.00
001a.c30c.7e1e 40.4.58.8 C7/0/0/U2 w-online(pt) dsPri 555 ----- 0.00
dsSec 561 N/A N/A
dsSec 567 N/A N/A
us2 20 36.12 0.00
54d4.6ffb.2e1b 40.4.58.23 C7/0/0/p w-online(pt) dsPri 561 ----- 0.00
dsSec 555 N/A N/A
dsSec 567 N/A N/A
us0 31 36.12 45.00
us1 37 ----- 44.25
us2 20 36.12 44.25
us3 13 36.12 44.50
4458.2945.2a78 40.4.58.21 C7/0/0/p w-online(pt) dsPri 561 ----- 0.00
dsSec 555 N/A N/A
dsSec 567 N/A N/A
us0 31 36.12 34.75
us1 37 ----- 33.00
us2 20 36.12 33.00
us3 13 36.12 33.75
4458.2945.4604 40.4.58.19 C7/0/0/p w-online(pt) dsPri 555 ----- 0.00
dsSec 561 N/A N/A
dsSec 567 N/A N/A
us0 31 36.12 23.75
us1 37 ----- 23.75
us2 20 36.12 24.00
us3 13 36.12 24.00
001e.6bfb.0662 40.4.58.11 C8/0/0/UB w-online(pt) dsPri 555 ----- 0.00
dsSec 561 N/A N/A
dsSec 567 N/A N/A
us0 15 36.12 27.50
us1 25 36.12 27.00
us2 35 27.70 29.00
us3 45 27.70 38.25
001e.6bfb.01aa --- C8/0/0/UB w-online(pt) dsPri 573 ----- 0.00
dsSec 555 N/A N/A
dsSec 561 N/A N/A
dsSec 567 N/A N/A
us0 15 36.12 26.75
us1 25 36.12 26.75
us2 35 27.48 28.25
us3 45 27.32 38.00
54d4.6ffb.2e66 --- C8/0/0/p w-online(pt) dsPri 555 ----- 0.00
dsSec 561 N/A N/A
dsSec 567 N/A N/A
us0 15 36.12 26.25
us1 25 36.12 28.75
us2 35 28.26 27.00
us3 45 28.26 38.00
Cisco IOS CMTS Cable Command Reference
CBL-1530 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem wideband phy
Table 126 describes the significant fields shown in the display:
Table 129 show cable modem wideband phy Field Descriptions
Field Description
MAC Address MAC address of the CM.
IP Address IP address that the DHCP server has assigned to the CM.
I/F Cable interface providing the upstream to the CM.
MAC State Current state of the MAC layer.
Chan Desc Descriptive name of the channel.
Frq State (MHZ) Frequency value.
SNR (db) Upstream signal-to-noise ratio (SNR) for a particular CM.
Pwr (dBmV) Power value.
Related Commands Command Description
show cable modem Displays information for the registered and unregistered CMs.
show cable modem Displays voice call information for a particular CM, identified either by its
summary IP address or MAC address.
show cable modem Displays information of registered and unregistered wideband CMs.
wideband
show interface cable Displays information about the CMs connected to a particular cable
modem interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1531
Cable Commands: show cable m through show cable u
show cable modem wideband primary-channel
show cable modem wideband primary-channel
To display primary-channel information for a wideband channel, use the show cable modem wideband
primary-channel command in privileged EXEC mode.
show cable modem [ip-address | mac-address] wideband primary-channel
Syntax Description ip-address Identifies the IP address of a specific cable modem to be displayed. If you specify the
IP address for a CPE device behind a cable modem, information for that cable modem
is displayed.
mac-address Identifies the MAC address of a specific cable modem to be displayed. You can also
specify the MAC address for a CPE device behind a cable modem, and information for
that cable modem will be displayed.
Command Modes Privileged EXEC
Command History Release Modification
12.3(23)BC This command was introduced for the Cisco uBR10012 router.
Usage Guidelines This command displays primary-channel information for a wideband channel that is associated with a
specific MAC address or IP address of a cable modem or CPE device behing the cable modem.
Related Commands Command Description
show cable modem Displays information for the registered and unregistered cable
modems.
show cable modem primary-channel Displays information for the wideband and narrowband cable
summary total modems and location of the primary downstream channel.
Cisco IOS CMTS Cable Command Reference
CBL-1532 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modem wideband rcs-status
show cable modem wideband rcs-status
To display details of events for each RF channel in the cable modem's receive channel configuration
(RCC), use the show cable modem wideband rcs-status command in privileged EXEC mode.
show cable modem [mac-address | ip-address |cable slot/subslot/port] wideband rcs-status
Syntax Description mac-address (Optional) Specifies the MAC address of a wideband CM to be displayed.
ip-address (Optional) Specifies the IP address of a wideband CM to be displayed.
cable slot/subslot/port Optional) Identifies a cable interface on the Cisco uBR10012 router. The
following are the valid values:
• slot—Specifies the chassis slot number of the cable interface line card.
Valid values are 5to 8.
• subslot—Specifies the secondary slot number of the cable interface line
card. Valid subslots are 0 or 1.
• port—Specifies the port number. Valid values are 0 to 4 (depending on
the cable interface).
Command Default No default behavior or values.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCB This command was introduced.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1533
Cable Commands: show cable m through show cable u
show cable modem wideband rcs-status
Examples The following is a sample output of the show cable modem wideband rcs-status command on a
wideband cable interface:
Router# show cable modem wideband rcs-status
CM : 0019.474a.c0ba
RF : 1/0/0 10
Status : UP
FEC/QAM Failure : 0
Dup FEC/QAM Failure : 0
FEC/QAM Recovery : 0
Dup FEC/QAM Recovery : 0
MDD Failure : 0
Dup MDD Failure : 0
MDD Recovery : 0
Dup MDD Recovery : 0
Flaps : 0
Flap Duration : 00:00
RF : 1/0/0 11
Status : UP
FEC/QAM Failure : 0
Dup FEC/QAM Failure : 0
FEC/QAM Recovery : 0
Dup FEC/QAM Recovery : 0
MDD Failure : 0
Dup MDD Failure : 0
MDD Recovery : 0
Dup MDD Recovery : 0
Flaps : 0
Flap Duration : 00:00
Related Commands Command Description
show cable modem Displays the number of RFs that are down on a cable interface.
summary wb-rf
Cisco IOS CMTS Cable Command Reference
CBL-1534 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modulation-profile
show cable modulation-profile
To display modulation profile group information for a Cisco CMTS, use the show cable
modulation-profile command in privileged EXEC mode.
show cable modulation-profile [profile [verbose] ] [iuc-code]
show cable modulation-profile cable {slot/port | slot/subslot/port} [upstream port]
Syntax Description profile (Optional) Profile number. Valid values start with 1.
verbose (Optional) Displays detailed information for an individual profile.
iuc-code (Optional) Internal usage code (IUC). Valid options are:
a-long—Advanced Phy Long Grant Burst (IUC 10)
a-short—Advanced Phy Short Grant Burst (IUC 9)
a-ugs—Advanced Phy Unsolicited Grant Burst (IUC 11)
initial—Initial Ranging Burst (IUC 3)
long—Long Grant Burst (IUC 6)
reqdata—Request/Data Burst (IUC 2) 1
request—Request Burst (IUC 1)
short—Short Grant Burst (IUC 5)
station—Station Ranging Burst (IUC 4)
cable slot/port Identifies a cable interface and downstream port on the
Cisco uBR7100 series and Cisco uBR7200 series routers.
On the Cisco uBR7100 series router, the only valid value is 1/0. On the
Cisco uBR7200 series router, slot can range from 3 to 6, and port can
be 0 or 1, depending on the cable interface.
cable slot/subslot/port Identifies a cable interface on the Cisco uBR10012 router. The
following are the valid values:
• slot = 5 to 8
• subslot = 0 or 1
• port = 0 to 4 (depending on the cable interface)
upstream port (Optional) Displays information for a particular upstream on the
selected cable interface. The port value starts with 0 and continues up,
depending on the type of cable interface card.
1. The Cisco CMTS recognizes the reqdata burst type but does not use it.
Command Modes Privileged EXEC
Command History Release Modification
11.3 XA This command was first introduced.
12.(0)5T1, 12.0(6)SC, This command was supported, replacing the show cable burst-profile
12.1(2)EC command.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1535
Cable Commands: show cable m through show cable u
show cable modulation-profile
Release Modification
12.1(3a)EC This reqdata type was added as a placeholder for scripts that might
reference it, but the DOCSIS MAC scheduler on the Cisco CMTS does not
use this type of burst.
12.2(15)CX Support was added for the Cisco uBR-MC28U/X cable interface line card,
including support for DOCSIS 2.0 A-TDMA and mixed modulation profiles.
This includes adding additional information to the command’s display, as
well as adding the a-long, a-short, a-ugs, and verbose options.
12.2(15)CX1 Added the ability to display the modulation profiles being used by a
particular cable interface and upstream.
12.2(15)BC2 This command displays all default modulation profiles 1, 21, 41, 101, 121,
201, 221, and 241), even when the cable interface card that is associated with
those profiles is not installed. Previous releases displayed only the default
modulation profiles that were in use.
Usage Guidelines The show cable modulation-profile command displays modulation profile group information. A
modulation profile is a collection of burst profiles that are sent out in a Upstream Channel Descriptor
(UCD) message to configure a modem’s transmit parameters for an upstream message burst type.
Table 0-130 shows the IUC codes for each burst type:
Table 0-130 Internal Usage Code Types
IUC Type IUC Type
IUC 1 Request Burst (req) IUC 7 Not used
1
IUC 2 Request/Data Burst (reqdata) IUC 8 Not used
IUC 3 Initial Ranging Burst (initial) IUC 9 Advanced Phy Short Grant Burst
(a-short)
IUC 4 Station Ranging Burst (station) IUC 10 Advanaced Phy Long Grant
Burst (a-long)
IUC 5 Short Grant Burst (short) IUC 11 Advanaced Phy Unsolicited
Grant Burst (a-ugs)
IUC 6 Long Grant Burst (long) IUC 12 Not used
1. The Cisco CMTS recognizes the reqdata burst type but does not use it.
Modulation Profile Ranges
The ranges for modulation profiles depends on the cable interface being used and the type of modulation
profile being created. Table 0-131 lists the valid ranges according to cable interface and modulation
type:
Table 0-131 Allowable Ranges for Modulation Profiles
Cable Interface DOCSIS 1.X (TDMA) Mixed DOCSIS 1.X/2.0 DOCSIS 2.0 (A-TDMA)
1
Cisco uBR7100 series 1 to 10 , default=1 N/A N/A
Cisco uBR-MC16C 1 to 10, default=1 N/A N/A
Cisco uBR-MC16S 1 to 10, default=1 N/A N/A
Cisco IOS CMTS Cable Command Reference
CBL-1536 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modulation-profile
Table 0-131 Allowable Ranges for Modulation Profiles
Cable Interface DOCSIS 1.X (TDMA) Mixed DOCSIS 1.X/2.0 DOCSIS 2.0 (A-TDMA)
Cisco uBR-MC28C 1 to 10, default=1 N/A N/A
Cisco uBR10-MC5X20S, 21 to 30, default=21 121 to 130, default=121 221 to 230, default=221
Cisco uBR10-MC5X20U,
Cisco uBR10-MC5X20H
Cisco uBR-MC16U/X, 41 to 50, default=41 141 to 150, default=141 241 to 250, default=241
Cisco uBR-MC28U/X
1. Only 8 modulation profiles are supported in Cisco IOS software releases before 12.2(15)BC1, so in these releases the valid range
is 1 to 8.
Note Default modulation profiles are created for each type of card and operation mode. You cannot delete the
default modulation profiles (1, 21, 41, 101, 121, 201, 221, and 241). In Cisco IOS Release 12.2(15)BC2
and later, all default modulation profiles are displayed, even when that particular cable interface is not
installed. In previous versions, only the default modulation profiles that were in use were displayed.
Examples The following is sample output from the show cable modulation-profile command in Cisco IOS
Release 12.2(11)BC3 and earlier releases:
CMTS01# show cable modulation-profile
Mo IUC Type Preamb Diff FEC FEC Scrambl Max Guard Last Scrambl Preamb
length enco T CW seed B time CW offset
bytes size size size short
1 request qpsk 64 no 0x0 0x10 0x152 1 8 no yes 56
1 initial qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0
1 station qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0
1 short qpsk 72 no 0x5 0x4B 0x152 0 8 no yes 48
The following is sample output from the show cable modulation-profile command in Cisco IOS
Release 12.2(15)CX and later releases:
Router# show cable modulation-profile
Mod IUC Type
Pre Diff FEC FEC Scrmb Max Guard Last Scrmb Pre Pre RS
len enco T k seed B time CW offst Type
BYTE BYTE siz size short
1 request qpsk 64 no 0x0 0x10 0x152 0 8 no yes 184 qpsk na
1 initial qpsk 128 no 0x5 0x22 0x152 0 48 no yes 128 qpsk na
1 station qpsk 128 no 0x5 0x22 0x152 0 48 no yes 128 qpsk na
1 short qpsk 72 no 0x4 0x4C 0x152 12 8 yes yes 176 qpsk na
1 long qpsk 80 no 0x9 0xEC 0x152 0 8 yes yes 168 qpsk na
41 request qpsk 68 no 0x0 0x10 0x152 0 8 no yes 0 qpsk na
41 initial qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk na
41 station qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk na
41 short qpsk 80 no 0x4 0x4C 0x152 12 8 yes yes 0 qpsk na
41 long qpsk 80 no 0x8 0xEC 0x152 0 8 yes yes 0 qpsk na
45 request qpsk 68 no 0x0 0x10 0x152 0 8 no yes 0 qpsk na
45 initial qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk na
45 station qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk na
45 short 16qam 160 no 0x6 0x4C 0x152 7 8 yes yes 0 16qam na
45 long 16qam 160 no 0x8 0xE7 0x152 0 8 yes yes 0 16qam na
141 request qpsk 68 no 0x0 0x10 0x152 0 8 no yes 0 qpsk na
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1537
Cable Commands: show cable m through show cable u
show cable modulation-profile
141 initial qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk na
141 station qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk na
141 short 16qam 160 no 0x6 0x4C 0x152 7 8 yes yes 0 16qam na
141 long 16qam 160 no 0x8 0xE7 0x152 0 8 yes yes 0 16qam na
141 a-short 32qam 160 no 0x9 0x4C 0x152 6 8 yes yes 0 qpsk1 no
141 a-long 64qam 196 no 0xC 0xE7 0x152 0 8 yes yes 0 qpsk1 no
241 request qpsk 68 no 0x0 0x10 0x152 0 8 no yes 0 qpsk0 no
241 initial qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk0 no
241 station qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk0 no
241 a-short 32qam 160 no 0x9 0x4C 0x152 6 8 yes yes 0 qpsk1 no
241 a-long 64qam 196 no 0xC 0xE7 0x152 0 8 yes yes 0 qpsk1 no
241 a-ugs 16qam 80 no 0x3 0xE7 0x152 0 8 yes yes 0 qpsk1 no
242 request qpsk 68 no 0x0 0x10 0x152 0 8 no yes 0 qpsk0 no
242 initial qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk0 no
242 station qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk0 no
242 a-short qpsk 80 no 0x4 0x4C 0x152 12 8 yes yes 0 qpsk0 no
242 a-long qpsk 68 no 0x8 0xEC 0x152 0 8 yes yes 0 qpsk0 no
242 a-ugs qpsk 80 no 0x0 0xEC 0x152 0 8 yes yes 0 qpsk0 no
243 request 64qam 132 no 0x4 0x10 0x152 0 8 no yes 0 qpsk1 no
243 initial 64qam 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk1 no
243 station 64qam 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk1 no
243 a-short 64qam 160 no 0x9 0x4C 0x152 5 8 yes yes 0 qpsk1 no
243 a-long 64qam 196 no 0xC 0xE7 0x152 0 8 yes yes 0 qpsk1 no
243 a-ugs 64qam 100 no 0x7 0xE7 0x152 0 8 yes yes 0 qpsk1 no
244 request 64qam 132 no 0x4 0x10 0x152 0 8 no yes 0 qpsk1 no
244 initial 64qam 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk1 no
244 station 64qam 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk1 no
244 a-short 64qam 160 no 0x9 0x4C 0x152 5 8 yes yes 0 qpsk1 no
244 a-long 64qam 196 no 0xC 0xE7 0x152 0 8 yes yes 0 qpsk1 no
244 a-ugs 64qam 32 no 0xA 0xC8 0x152 255 32 yes yes 0 qpsk1 yes
245 initial qpsk 32 no 0xA 0xC8 0x152 32 32 no yes 0 qpsk1 yes
245 station qpsk 32 no 0xA 0xC8 0x152 32 32 yes yes 0 qpsk1 yes
245 a-short 64qam 64 no 0xA 0xC8 0x152 32 32 yes yes 0 qpsk1 yes
245 a-long 64qam 32 no 0xA 0xC8 0x152 252 32 yes yes 0 qpsk1 yes
245 a-ugs 64qam 32 no 0xA 0xC8 0x152 32 32 yes yes 0 qpsk1 yes
Router#
The following shows sample output from the show cable modulation-profile command for a mixed
mode modulation profile (TDMA/A-TDMA) on the Cisco uBR10-MC5X20S cable interface line card:
Router# show cable modulation-profile 121
Mod IUC Type Pre Diff FEC FEC Scrmb Max Guard Last Scrmb Pre Pre RS
len enco T k seed B time CW offst Type
BYTE BYTE siz size short
121 request qpsk 32 no 0x0 0x10 0x152 0 20 no yes 0 qpsk na
121 initial qpsk 64 no 0x5 0x22 0x152 0 48 no yes 64 qpsk na
121 station qpsk 64 no 0x5 0x22 0x152 0 48 no yes 64 qpsk na
121 short qpsk 64 no 0x5 0x4B 0x152 6 20 yes yes 64 qpsk na
121 long qpsk 64 no 0x8 0xDC 0x152 0 20 yes yes 64 qpsk na
121 a-short 64qam 128 no 0x5 0x63 0x152 10 20 yes yes 192 qpsk0 no
121 a-long 64qam 128 no 0xF 0xC8 0x152 0 20 yes yes 192 qpsk0 no
Router#
The following shows sample output from the show cable modulation-profile command for two
DOCSIS 2.0 modulation profiles (A-TDMA) on the Cisco uBR10-MC5X20S cable interface line card:
Router# show cable modulation-profile 221
Mod IUC Type Pre Diff FEC FEC Scrmb Max Guard Last Scrmb Pre Pre RS
len enco T k seed B time CW offst Type
BYTE BYTE siz size short
Cisco IOS CMTS Cable Command Reference
CBL-1538 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modulation-profile
221 request qpsk 64 no 0x0 0x10 0x152 0 8 no yes 184 qpsk0 na
221 initial qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk0 na
221 station qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk0 na
221 short qpsk 72 no 0x5 0x4B 0x152 6 8 yes yes 176 qpsk0 na
221 long qpsk 80 no 0x8 0xDC 0x152 0 8 yes yes 168 qpsk0 na
221 a-short 64qam 128 no 0x5 0x63 0x152 10 20 yes yes 192 qpsk0 no
221 a-long 64qam 128 no 0xF 0xC8 0x152 0 20 yes yes 192 qpsk0 no
Router# show cable modulation-profile 241
Mod IUC Type Pre Diff FEC FEC Scrmb Max Guard Last Scrmb Pre Pre RS
len enco T k seed B time CW offst Type
BYTE BYTE siz size short
241 request qpsk 68 no 0x0 0x10 0x152 0 8 no yes 0 qpsk0 no
241 initial qpsk 2 no 0x0 0x10 0x0 0 0 no no 0 qpsk1 no
241 station qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk0 no
241 a-short 32qam 160 no 0x9 0x4C 0x152 6 8 yes yes 0 qpsk1 no
241 a-long 64qam 132 no 0xC 0xE7 0x152 0 8 yes yes 0 qpsk1 no
241 a-ugs 16qam 80 no 0x3 0xE7 0x152 0 8 yes yes 0 qpsk1 no
Router#
The following shows sample output for the upstream option, which displays the modulation profile
currently being used by a particular upstream:
Router# show cable modulation-profile cable 4/1 upstream 1
Mod IUC Type Pre Diff FEC FEC Scrmb Max Guard Last Scrmb Pre Pre RS
len enco T k seed B time CW offst Type
BYTE BYTE siz size short
41 request qpsk 64 no 0x0 0x10 0x152 0 8 no yes 396 qpsk na
41 initial qpsk 128 no 0x5 0x22 0x152 0 48 no yes 6 qpsk na
41 station qpsk 128 no 0x5 0x22 0x152 0 48 no yes 6 qpsk na
41 short qpsk 88 no 0x5 0x4C 0x152 35 42 yes yes 396 qpsk na
41 long qpsk 76 no 0x6 0xE8 0x152 135 143 yes yes 396 qpsk na
Router#
The following example shows typical detailed output for an individual modulation profile that is
displayed when using the verbose option. Each IUC is described in detail.
Router# show cable modulation-profile 1 verbose
Modulation Profile Number: 1
Burst: tdma
IUC: request (IUC 1)
Modulation: qpsk
Preamble length: 64
Differential Encoding: off
FEC parity T bytes: 0x0
FEC codeword length K bytes: 0x10
Scrambler seed: 0x152
Max short burst size B bytes: 0
Guard time size in symbols: 8
Shortened last codeword: no
Scrambler: enabled
Preamble offset: 184
Preamble type: qpsk0
RS interleaver on: na
RS interleaver depth: 0
RS interleaver block size: 0
Modulation Profile Number: 1
Burst: tdma
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1539
Cable Commands: show cable m through show cable u
show cable modulation-profile
IUC: initial maintenance (IUC 3)
Modulation: qpsk
Preamble length: 128
Differential Encoding: off
FEC parity T bytes: 0x5
FEC codeword length K bytes: 0x22
Scrambler seed: 0x152
Max short burst size B bytes: 0
Guard time size in symbols: 48
Shortened last codeword: no
Scrambler: enabled
Preamble offset: 0
Preamble type: qpsk0
RS interleaver on: na
RS interleaver depth: 0
RS interleaver block size: 0
Modulation Profile Number: 1
Burst: tdma
IUC: station maintenance (IUC 4)
Modulation: qpsk
Preamble length: 128
Differential Encoding: off
FEC parity T bytes: 0x5
FEC codeword length K bytes: 0x22
Scrambler seed: 0x152
Max short burst size B bytes: 0
Guard time size in symbols: 48
Shortened last codeword: no
Scrambler: enabled
Preamble offset: 0
Preamble type: qpsk0
RS interleaver on: na
RS interleaver depth: 0
RS interleaver block size: 0
Modulation Profile Number: 1
Burst: tdma
IUC: short grant (IUC 5)
Modulation: qpsk
Preamble length: 72
Differential Encoding: off
FEC parity T bytes: 0x5
FEC codeword length K bytes: 0x4B
Scrambler seed: 0x152
Max short burst size B bytes: 6
Guard time size in symbols: 8
Shortened last codeword: yes
Scrambler: enabled
Preamble offset: 176
Preamble type: qpsk0
RS interleaver on: na
RS interleaver depth: 0
RS interleaver block size: 0
Modulation Profile Number: 1
Burst: tdma
IUC: long grant (IUC 6)
Modulation: qpsk
Preamble length: 80
Differential Encoding: off
FEC parity T bytes: 0x8
FEC codeword length K bytes: 0xDC
Scrambler seed: 0x152
Cisco IOS CMTS Cable Command Reference
CBL-1540 OL-15510-15
Cable Commands: show cable m through show cable u
show cable modulation-profile
Max short burst size B bytes: 0
Guard time size in symbols: 8
Shortened last codeword: yes
Scrambler: enabled
Preamble offset: 168
Preamble type: qpsk0
RS interleaver on: na
RS interleaver depth: 0
RS interleaver block size: 0
Router#
Table 0-132 describes the significant fields displayed by the show cable modulation-profile command.
.
Table 0-132 show cable modulation-profile Field Descriptions
Field Description
Mo Modulation profile group number. A modulation profile group is the set
of burst profiles that defines upstream transmit characteristics for the
various types of upstream transmission classes.
IUC Interval usage code. Each upstream transmit burst belongs to a class that
is given a number called the interval usage code (IUC). Bandwidth maps
messages (MAP) by IUC codes used to allocate upstream time slots. The
following types are currently defined:
• Request—Bandwidth request slot
• Request Data—Bandwidth request and short data burst slot
• Initial Maintenance—Initial link registration contention slot
• Station Maintenance—Link keepalive slot
• Short Data Grant—Short data burst slot
• Long Data Grant—Long data burst slot
Type Modulation type.
Preamb length Preamble length.
Diff enco Differential encoding enabled (yes) or not enabled (no).
FEC T bytes Number of bytes that can be corrected for each forward error correction
(FEC) code word.
FEC CW size Size, in bytes, of the FEC code word.
Scrambl seed Scrambler seed value in hex format.
Max B size Maximum burst size.
Guard time size Time between successive bursts measured in symbols.
Last CW short Handling of FEC for shortened last code word.
Scrambl Scrambler enabled (yes) or not enabled (no).
Preamb offset (DOCSIS 1.0 and DOCSIS 1.1 modulation profiles) The bits to be used
for the preamble value.
Pre offst (DOCSIS 2.0 modulation profiles) The bits to be used for the preamble
value.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1541
Cable Commands: show cable m through show cable u
show cable modulation-profile
Table 0-132 show cable modulation-profile Field Descriptions (continued)
Field Description
Pre Type (DOCSIS 2.0 modulation profiles) The A-TDMA preamble type (qpsk0
or qpsk1).
RS (DOCSIS 2.0 modulation profiles) The A-TDMA RS encoding type.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Related Commands Command Description
cable upstream Configures a spectrum group to use a specified frequency.
modulation-profile
show cable hop Displays CM configuration settings.
show interface cable Displays cable interface information.
sid
Cisco IOS CMTS Cable Command Reference
CBL-1542 OL-15510-15
Cable Commands: show cable m through show cable u
show cable multicast authorization
show cable multicast authorization
To display the list of defined multicast authorization profiles and all CMs associated with corresponding
profiles, use the show cable multicast authorization command in privileged EXEC mode.
show cable multicast authorization {profile-group {profile-group-number | all} profile-list
{profile-number | all} }
Syntax Description profile-group Displays the profile group.
profile-group-number Displays the profile number.
all Displays all profile groups.
profile-list Displays the profile list.
profile-number Displays the profile number.
all Displays all profiles.
Command Default No default behavior or values.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCB This command was introduced.
12.2(33)SCC The command output was modified to display profile description for the
specified profile.
Usage Guidelines Use this command to display all the profile groups, profile descriptions, and CMs associated with the
profiles.
Examples The following command shows all the profile groups and rules associated with it:
Router# show cable multicast authorization profile-group all
Profile-Group Index: 1
CMs using this group: 2
ProfileId CMs Profile
------------------------------
0 2 prof1
1 2 prof2
2 2 prof3
Session-Rule List:
Group / Source Prio Action
-------------------------------------------------------------
grp: FF15::1/64 1 permit
src: 0::0/0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1543
Cable Commands: show cable m through show cable u
show cable multicast authorization
grp: FF15::1/64 1 permit
src: 1234::1/64
grp: 224.1.1.1/16 1 permit
src: 0.0.0.0/0
grp: FF16::1/64 1 permit
src: 0::0/0
grp: 224.1.1.1/16 1 permit
src: 1.1.1.1/16
-------------------------------------------------------------
The following command shows a particular profile group and rules associated with it:
Router# show cable multicast authorization profile-group 1
Profile-Group Index: 1
CMs using this group: 2
ProfileId CMs Profile
------------------------------
0 2 prof1
1 2 prof2
2 2 prof3
Session-Rule List:
Group / Source Prio Action
-------------------------------------------------------------
grp: FF15::1/64 1 permit
src: 0::0/0
grp: FF15::1/64 1 permit
src: 1234::1/64
grp: 224.1.1.1/16 1 permit
src: 0.0.0.0/0
grp: FF16::1/64 1 permit
src: 0::0/0
grp: 224.1.1.1/16 1 permit
src: 1.1.1.1/16
-------------------------------------------------------------
The following command shows all the profiles and their profile descriptions, and the session rules for
each profile.
Router# show cable multicast authorization profile-list all
CMTS Authorization Profile List
-------------------------------
Profile-Index: 0 Name: prof1
Number of CMs: 2
Id Group / Source Prio Action
------------------------------------------------------------------------
1 grp: FF15::1/64 1 permit
src: 0::0/0
2 grp: FF15::1/64 1 permit
src: 1234::1/64
3 grp: 224.1.1.1/16 1 permit
src: 0.0.0.0/0
Cisco IOS CMTS Cable Command Reference
CBL-1544 OL-15510-15
Cable Commands: show cable m through show cable u
show cable multicast authorization
4 grp: FF16::1/64 1 permit
src: 0::0/0
5 grp: 224.1.1.1/16 1 permit
src: 1.1.1.1/16
------------------------------------------------------------------------
Profile-Index: 1 Name: prof2
Number of CMs: 2
Id Group / Source Prio Action
------------------------------------------------------------------------
------------------------------------------------------------------------
Profile-Index: 2 Name: prof3
Number of CMs: 2
Id Group / Source Prio Action
------------------------------------------------------------------------
------------------------------------------------------------------------
The following command shows a particular profile and its description.
Router# show cable multicast authorization profile-list 3
CMTS Authorization Profile List
-------------------------------
Profile-Index: 3 Name: gold
Number of CMs: 0
Profile Description: gold profile for higher bandwidth
Id Group / Source Prio Action
------------------------------------------------------------------------
------------------------------------------------------------------------
Table 118 describes the significant fields shown in the display.
Table 133 show cable multicast authorization Field Descriptions
Field Description
Profile-Group Index Displays the profile group index.
Name Displays the name of the profile group.
Profile Description Displays the description given to the profile.
ProfileId Displays the QoS profile being used.
CMs Displays the CMs belonging to the profile.
Profile Displays the profile being used for multicast.
Session-Rule List Displays the list of session rules being used for the multicast.
Source (src) Displays the source IP address.
Group (grp) Displays the group IP address.
Priority Displays the rule priority value.
Action Displays the action taken for multicast.
Related Commands Command Description
cable multicast auth Configures cable multicast authorization profile and sets the maximum
enable default-action sessions limit.
cable multicast auth Configures cable multicast authorization profile.
profile-name
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1545
Cable Commands: show cable m through show cable u
show cable multicast authorization
Command Description
profile description Configures profile descriptions for each profile in the selected cable
multicast authorization profile.
show cable multicast Displays the contents of multicast explicit tracking database.
db
show cable multicast Displays the entire DSID database content.
dsid
show cable multicast Displays the configuration information for MQoS, (Group-Config,
qos Group-QoS-Config, Group-Encryption-Config).
Cisco IOS CMTS Cable Command Reference
CBL-1546 OL-15510-15
Cable Commands: show cable m through show cable u
show cable multicast db
show cable multicast db
To display the contents of the multicast explicit tracking database, use the show cable multicast db
command in privileged EXEC mode.
show cable multicast db [bundle bundle-interface [ipv4-address | ipv6-address | summary] |
cm-mac [host-mac-add | hosts | proxy] | summary | client pcmm] | [detail]
Syntax Description bundle (Optional) Displays the bundle interface.
bundle-interface
For example, Bundle 10.
ipv4-address (Optional) IPv4 address.
ipv6-address (Optional) IPv6 address of the group that should be matched using the format
X:X:X:X:X.
cm-mac (Optional) MAC address of the cable modem.
host-mac-add (Optional) Host MAC address.
hosts (Optional) Displays host details.
proxy (Optional) Displays proxy details.
summary (Optional) Displays the bundle interface summary or the multicast explicit
tracking database summary.
client (Optional) Displays entries by the client type.
pcmm (Optional) Displays all PacketCable multimedia (PCMM) client entries.
detail (Optional) Displays additional information related to the multicast explicit
tracking database.
Command Default None
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCB This command was introduced.
12.2(33)SCE This command was modified. The following two keywords were added to
this command:
• client
• pcmm
12.2(33)SCF This command was modified. A new keyword, detail, was added to provide
additional information related to the multicast explicit tracking database.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1547
Cable Commands: show cable m through show cable u
show cable multicast db
Usage Guidelines Starting with Cisco IOS Release 12.2(33)SCF:
• There is an Explicit Tracking Database (ETDB) entry for each static multicast configuration.
• The total number of replications supported on each chassis is restricted to a maximum of 5000
replications.
• The total number of replications corresponding to static multicast is restricted to a maximum of 1500
replications.
• The show cable multicast db detail command is not applicable for ETDB entries created by the
static TLV.
Examples The following is a sample output from the show cable multicast db command:
Router# show cable multicast db
Interface : Bundle1
Session (S,G) : (*,230.1.1.1)
Fwd Intfc Sub Intfc Host Intfc CM Mac Hosts
w1/0/0:0 aaaa.bbbb.cccc 2
w1/0/0:0 aaaa.bbbb.cccc 2
Session (S,G) : (255.255.255.255,255.255.255.255)
Fwd Intfc Sub Intfc Host Intfc CM Mac Hosts
w1/0/0:0 aabb.bbcc.ccdd 3
Interface : Bundle2
Session (S,G) : (*,230.1.1.1)
Fwd Intfc Sub Intfc Host Intfc CM Mac Hosts
w1/0/0:0 aaaa.bbbb.cccc 2
w1/0/0:0 aaaa.bbbb.cccc 2
Session (S,G) : (255.255.255.255,255.255.255.255)
Fwd Intfc Sub Intfc Host Intfc CM Mac Hosts
w1/0/0:0 aabb.bbcc.ccdd 3
The following is a sample output from the show cable multicast db summary command:
Router# show cable multicast db summary
Interface Session Count CM Count
Bundle1 10 5
Bundle2 23 11
The following is a sample output from the show cable multicast db bundle bundle-interface command:
Router# show cable multicast db bundle 1
Interface : Bundle1
Session (S,G) : (*,230.1.2.3)
Fwd Intfc Sub Intfc Host Intfc CM Mac Hosts
Wi1/1/0:0 Bundle1 Ca5/0/0 ff01.0001.0000 1
Interface : Bundle1
Session (S,G) : (20.1.1.1,232.1.1.1)
Fwd Intfc Sub Intfc Host Intfc CM Mac Hosts
Wi1/1/0:0 Bundle1 Ca5/0/0 ff01.0001.0000 1
Cisco IOS CMTS Cable Command Reference
CBL-1548 OL-15510-15
Cable Commands: show cable m through show cable u
show cable multicast db
The following is a sample output from the show cable multicast db bundle bundle-interface summary
command:
Router# show cable multicast db bundle 1 summary
Interface Session Count CM Count
Bundle1 10 5
The following is a sample output from the show cable multicast db bundle bundle-interface
ipv4-address command:
Router# show cable multicast db bundle 1 225.0.0.1
Session (S,G) : (*,225.0.0.1)
Fwd Intfc Sub Intfc Host Intfc CM Mac Hosts
Wi5/1:0 Bundle1 Ca5/1 001e.6bfb.29a6 1
The following is a sample output from the show cable multicast db bundle bundle-interface
ipv6-address command:
Router# show cable multicast db bundle1 ff15::1
Session (S,G) : (*,FF15::1)
Fwd Intfc Sub Intfc Host Intfc CM Mac Hosts
In5/1:0 Bundle1 Ca5/1 001e.6bfb.29a6 1
The following is a sample output from the show cable multicast db cm-mac command:
Router# show cable multicast db 000f.66f9.aa73
Session (S,G) : (*,230.1.1.1)
Fwd Intfc Sub Intfc Host Intfc Hosts Proxy Static
w1/0/0:0 2 Y N
Session (S,G) : (*,230.1.1.1)
Fwd Intfc Sub Intfc Host Intfc Hosts Proxy Static
w1/0/0:0
The following is a sample output from the show cable multicast db cm-mac host-mac-add command:
Router# show cable multicast db aaaa.bbbb.cccc 000f.66f9.aa73
Bundle Interface : Bundle1
CM mac :
Host mac : aaaa.bbbb.cccc
Session (S,G) : (*,230.1.1.1)
Fwd Interface :
Sub Interface :
Host Interface :
IGMP/MLD Ver :
TimeStamp Delta :
Bundle Interface : Bundle1
CM mac :
Host mac : aaaa.bbbb.cccc
Session (S,G) : (*,230.1.1.1)
Fwd Interface :
Sub Interface :
Host Interface :
IGMP/MLD Ver :
TimeStamp Delta :
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1549
Cable Commands: show cable m through show cable u
show cable multicast db
The following is a sample output from the show cable multicast db cm-mac hosts command:
Router# show cable multicast db aaaa.bbbb.cccc hosts
Session (S,G) : (*,230.1.1.1)
Fwd Intfc Sub Intfc Host Intfc Host Mac Proxy
w1/0/0:0 aaaa.bbbb.cccc Y
Session (S,G) : (255.255.255.255,255.255.255.255)
Fwd Intfc Sub Intfc Host Intfc Host Mac Proxy
w1/0/0:0 aabb.bbcc.ccdd N
The following is a sample output from the show cable multicast db cm-mac proxy command:
Router# show cable multicast db aaaa.bbbb.cccc proxy
Bundle Interface : Bundle1
CM mac :
Host mac : aaaa.bbbb.cccc
Session (S,G) : (*,230.1.1.1)
Fwd Interface :
Sub Interface :
Host Interface :
IGMP/MLD Ver :
TimeStamp Delta :
Bundle Interface : Bundle1
CM mac :
Host mac : aaaa.bbbb.cccc
Session (S,G) : (*,230.1.1.1)
Fwd Interface :
Sub Interface :
Host Interface :
IGMP/MLD Ver :
TimeStamp Delta :
The following is a sample output from the show cable multicast db command that displays all the
available PCMM client entries on a Cisco CMTS router:
Router# show cable multicast db client pcmm
Interface : Bundle1
Session (S,G) : (*,229.2.2.12)
Fwd Intf Bundle Intf Host Intf CM MAC CPE IP Gate-ID SFID
Wi1/1/0:0 Bundle1 Ca5/0/0 0018.6852.8056 60.1.1.202 1344
Cisco IOS CMTS Cable Command Reference
CBL-1550 OL-15510-15
Cable Commands: show cable m through show cable u
show cable multicast db
The following is a sample output from the show cable multicast db command with the detail keyword
in Cisco IOS Release 12.2(33)SCF:
Router# show cable multicast db detail
Interface Fwd Intfc group source
Bundle1 Wi7/0/0:0 230.1.2.4 N/A
ETDB received IGMP ETDB processed IGMP
Nov 25 08:42:36.643 Nov 25 08:42:36.643
Sid gc_id Stat Index DSID Stat Index Allocated
DEFAULT N/A 61330 0xCF25C Nov 25 08:42:36.643
8201 1 61331 0xCF25C Nov 25 08:42:36.643
Interface Fwd Intfc group source
Bundle1 Wi7/0/0:0 230.1.2.3 N/A
ETDB received IGMP ETDB processed IGMP
Nov 25 08:42:22.339 Nov 25 08:42:22.339
Sid gc_id Stat Index DSID Stat Index Allocated
DEFAULT N/A 61328 0xCF25B Nov 25 08:42:22.339
8201 1 61329 0xCF25B Nov 25 08:42:22.339
The following is a sample output from the show cable multicast db command with the detail keyword
that provides multicast explicit tracking database information for a particular bundle interface in
Cisco IOS Release 12.2(33)SCF:
Router# show cable multicast db bundle 1 detail
Interface Fwd Intfc group source
Bundle1 Wi7/0/0:0 230.1.2.4 N/A
ETDB received IGMP ETDB processed IGMP
Nov 25 08:42:36.643 Nov 25 08:42:36.643
Sid gc_id Stat Index DSID Stat Index Allocated
DEFAULT N/A 61330 0xCF25C Nov 25 08:42:36.643
8201 1 61331 0xCF25C Nov 25 08:42:36.643
Interface Fwd Intfc group source
Bundle1 Wi7/0/0:0 230.1.2.3 N/A
ETDB received IGMP ETDB processed IGMP
Nov 25 08:42:22.339 Nov 25 08:42:22.339
Sid gc_id Stat Index DSID Stat Index Allocated
DEFAULT N/A 61328 0xCF25B Nov 25 08:42:22.339
8201 1 61329 0xCF25B Nov 25 08:42:22.339
The following is a sample output from the show cable multicast db command with the detail keyword
that provides multicast explicit tracking database information for a particular bundle interface based on
its host MAC address in Cisco IOS Release 12.2(33)SCF:
Router# show cable multicast db bundle 1 230.1.2.4 detail
Interface Fwd Intfc group source
Bundle1 Wi7/0/0:0 230.1.2.4 N/A
ETDB received IGMP ETDB processed IGMP
Nov 25 08:42:36.643 Nov 25 08:42:36.643
Sid gc_id Stat Index DSID Stat Index Allocated
DEFAULT N/A 61330 0xCF25C Nov 25 08:42:36.643
8201 1 61331 0xCF25C Nov 25 08:42:36.643
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1551
Cable Commands: show cable m through show cable u
show cable multicast db
The following is a sample output from the show cable multicast db command with the detail keyword
that provides multicast explicit tracking database information based on its cable modem MAC address
in Cisco IOS Release 12.2(33)SCF:
Router# show cable multicast db 0019.474a.d516 detail
Interface Fwd Intfc group source
Bundle1 Wi7/0/0:0 230.1.2.3 N/A
ETDB received IGMP ETDB processed IGMP
Nov 25 08:42:22.339 Nov 25 08:42:22.339
Sid gc_id Stat Index DSID Stat Index Allocated
DEFAULT N/A 61328 0xCF25B Nov 25 08:42:22.339
8201 1 61329 0xCF25B Nov 25 08:42:22.339
Interface Fwd Intfc group source
Bundle1 Wi7/0/0:0 230.1.2.4 N/A
ETDB received IGMP ETDB processed IGMP
Nov 25 08:42:36.643 Nov 25 08:42:36.643
Sid gc_id Stat Index DSID Stat Index Allocated
DEFAULT N/A 61330 0xCF25C Nov 25 08:42:36.643
8201 1 61331 0xCF25C Nov 25 08:42:36.643
Table 134 describes the significant fields shown in the show cable multicast db command display.
Table 134 show cable multicast db Field Descriptions
Field Description
Bundle Interface Bundle interface number.
CM Mac MAC address of the CM.
Host Mac Host MAC address.
Fwd Intfc Forwarding interface name.
Sub Intfc Sub-interface name.
Host Intfc Host interface name.
IGMP/MLD Ver IPv4 or IPv6 multicast group signaling protocols.
IPv4: IGMPv1/v2/v3
IPv6: MLDv1/v2
TimeStamp Delta Timestamp of the session.
Hosts Hosts behind the CM.
CPE IP IP address of the CPE.
Gate-ID Unique number identifying the local PCMM multicast gate.
SFID Service flow ID (SFID) for the downstream associated with
this PCMM multicast gate.
Cisco IOS CMTS Cable Command Reference
CBL-1552 OL-15510-15
Cable Commands: show cable m through show cable u
show cable multicast db
Related Commands Command Description
show cable multicast Displays the list of defined multicast authorization profiles and all
authorization cable modems associated with the corresponding profiles.
show cable multicast dsid Displays the entire multicast downstream service identifier (DSID)
database content.
show cable multicast qos Displays the configuration information of the MQoS (Group-Config,
Group-QoS-Config, Group-Encryption-Config).
show packetcable gate Displays the information about the total number of PCMM multicast
multimedia gates.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1553
Cable Commands: show cable m through show cable u
show cable multicast debug
show cable multicast debug
To display information about debug counters, use the show cable multicast debug command in
privileged EXEC mode.
show cable multicast debug [etdb [multicast-group-address | mac-address]]
Syntax
Description etdb (Optional) Displays information about multicast explicit tracking database
debug counters.
multicast-group-address (Optional) IP address of the multicast group.
mac-address (Optional) MAC address of the cable modem.
Command Default None
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCE This command was introduced.
Usage Guidelines The show cable multicast debug command provides information only about the explicit tracking
database counter in Cisco IOS Release 12.2(33)SCE and later. This means that the command output does
not include other debug counters such as multicast authorization and multicast quality of service (QoS).
If you want to verify multicast group specific or MAC specific debug counters, you must turn on
debugging of multicast counters using the debug cable multicast counter start command before using
the show cable multicast debug command.
Note The command output will be the same if you run the show cable multicast debug command with or
without the keyword etdb in Cisco IOS Release 12.2(33)SCE, because this command does not support
any other debug counters in Cisco IOS Release 12.2(33)SCE.
Cisco IOS CMTS Cable Command Reference
CBL-1554 OL-15510-15
Cable Commands: show cable m through show cable u
show cable multicast debug
Examples The following is a sample output of the show cable multicast debug command that displays information
about multicast explicit tracking database debug counters on the Cisco uBR10012 router:
Router# show cable multicast debug
ETDB
counter value
et_ses_update 3
et_ses_delete 0
et_cm_delete 0
et_post_host_add 1
et_post_cm_add 1
et_post_ses_intfc_update 3
et_post_ses_intfc_delete 0
et_post_cm_delete 0
et_post_host_delete 0
The following is a sample output of the show cable multicast debug command that displays information
about multicast explicit tracking database debug counters based on a particular multicast group:
Router# show cable multicast debug etdb 230.1.1.1
ETDB GROUP:230.1.1.1
counter value
et_ses_update 3
et_ses_delete 0
et_post_host_add 1
et_post_cm_add 1
et_post_ses_intfc_update 3
et_post_ses_intfc_delete 0
et_post_cm_delete 0
et_post_host_delete 0
The following is a sample output of the show cable multicast debug command that displays information
about multicast explicit tracking database debug counters based on a particular cable modem:
Router# show cable multicast debug etdb 001a.c3ff.d41a
ETDB CM:001a.c3ff.d41a
counter value
et_ses_update 2
et_ses_delete 0
et_cm_delete 0
et_post_host_add 0
et_post_cm_add 0
et_post_ses_intfc_update 2
et_post_cm_delete 0
et_post_host_delete 0
Table 83 describes the major fields shown in the show depi command display:
Table 135 show cable multicast debug Field Descriptions
Field Description
ETDB Multicast explicit tracking database
counter Debug counters for the multicast operation.
value Debug counter values.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1555
Cable Commands: show cable m through show cable u
show cable multicast debug
Table 135 show cable multicast debug Field Descriptions (continued)
Field Description
ETDB GROUP Identifies a particular multicast group for explicit tracking database debug
counters.
ETDB CM Identifies a particular cable modem for explicit tracking database debug
counters.
Related Commands Command Description
debug cable multicast counter clear Resets debugging of multicast counters.
debug cable multicast counter start The Cisco CMTS router starts collecting multicast debug
counters based on a particular multicast group or a cable
modem.
debug cable multicast counter stop The Cisco CMTS router stops collecting multicast debug
counters.
Cisco IOS CMTS Cable Command Reference
CBL-1556 OL-15510-15
Cable Commands: show cable m through show cable u
show cable multicast dsid
show cable multicast dsid
To display the entire multicast downstream service identifier (DSID) database content, use the show
cable multicast dsid command in privileged EXEC mode.
Cisco uBR7246VXR and Cisco uBR7225VXR Routers
show cable multicast dsid [dsid | ip-address [source-ip] | integrated-cable
slot/port:integrated-channel {dynamic | static}| wideband-cable slot/port:wideband-channel
{dynamic} | ipv6-address]
Cisco uBR10012 Router
show cable multicast dsid [dsid | ip-address [source-ip] | integrated-cable
slot/sub-slot/port:integrated-channel {dynamic | static}| wideband-cable
slot/bay/port:wideband-channel {dynamic | static} | ipv6-address]
Syntax Description dsid (Optional) Downstream service identifier.
ip-address (Optional) IP address of the group.
source-ip (Optional) IP address of the source.
integrated-cable (Optional) Identifies the cable interface on the router for which information
slot/sub-slot/port:integr should be displayed. The valid values are:
ated-channel
• slot—0 to 8 on the Cisco uBR10012 router, 3 to 6 on the
Cisco uBR7246VXR router, and 1 or 2 on the Cisco uBR7225VXR
router.
• sub-slot—0 or 1
• port—0 to 4 on the Cisco uBR10012 router and 0 or 1 on the
Cisco uBR7246VXR and Cisco uBR7225VXR routers.
• integrated-channel—0 to 3
wideband-cable (Optional) Identifies the wideband interface on the router for which
slot/bay/port:wideband information should be displayed. The valid values are:
-channel
• slot—0 to 8 on the Cisco uBR10012 router, 3 to 6 on the
Cisco uBR7246VXR router, and 1 or 2 on the Cisco uBR7225VXR
router.
• bay—0 or 1
• port—0 to 4 on the Cisco uBR10012 router and 0 or 1 on the
Cisco uBR7246VXR and Cisco uBR7225VXR routers.
• wideband-channel—0 to 5
dynamic Identifies the dynamic DSIDs.
static Identifies the static DSIDs.
ipv6-address IPv6 address of the group that should be matched using the format
X:X:X:X::X.
Command Default None
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1557
Cable Commands: show cable m through show cable u
show cable multicast dsid
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCB This command was introduced.
12.2(33)SCC This command was modified to display all the SIP and SPA indexes assigned
for a multicast session.
12.2(33)SCD This command was modified. Support for Cisco uBR7246VXR and
Cisco uBR7225VXR routers were added. Two new keywords, dynamic and
static, were added to this command.
Usage Guidelines Use this command to display the DSID database content and SIP and SPA indexes assigned for a
multicast session.
Examples The following example shows a sample output for the show cable multicast dsid command:
Router# show cable multicast dsid
Multicast Group : 230.1.2.3
Source : *
IDB : Bu2 Interface: Mo1/1/0:0 Dsid: 0x1F078
StatIndex : 2 SAID: DEFAULT
Multicast Group : 230.1.2.3
Source : *
IDB : Bu2 Interface: Mo1/1/0:0 Dsid: 0x1F078
StatIndex : 3 SAID: 8196
Multicast Group : 230.1.2.3
Source : *
IDB : Bu2 Interface: Mo1/1/0:0 Dsid: 0x1F078
StatIndex : 4 SAID: 8197
Example of the show cable multicast dsid ip-address Command Output That Shows the DSID Entry With Matching
Multicast Session for the Cisco uBR7246VXR and Cisco uBR7225VXR routers in Cisco IOS Release 12.2(33)SCD
The following example shows a sample output for the show cable multicast dsid ip-address [source-ip]
command:
Router# show cable multicast dsid 225.0.0.1
Multicast Group : 225.0.0.1
Source : *
IDB : Bu1 Interface: Wi5/0:0 Dsid: 0x5F078
StatIndex : 7 SAID : DEFAULT
Multicast Group : 225.0.0.1
Source : *
IDB : Bu1 Interface: Wi5/0:0 Dsid: 0x5F078
StatIndex : 8 SAID : 8195 GC : 1
Cisco IOS CMTS Cable Command Reference
CBL-1558 OL-15510-15
Cable Commands: show cable m through show cable u
show cable multicast dsid
Example of the show cable multicast dsid wideband-Cable Command Output That Displays the Dynamic or
Preallocated Static DSID Created on a Particular Interface for the Cisco uBR7246VXR and Cisco uBR7225VXR
routers in Cisco IOS Release 12.2(33)SCD
The following example shows a sample output for the show cable multicast dsid wideband-Cable
[dynamic | static] command:
Router# show cable multicast dsid wideband-Cable 5/0:0 dynamic
Multicast Group : 225.0.0.1
Source : *
IDB : Bu1 Interface: Wi5/0:0 Dsid: 0x5F078
StatIndex : 7 SAID : DEFAULT
Multicast Group : 225.0.0.1
Source : *
IDB : Bu1 Interface: Wi5/0:0 Dsid: 0x5F078
StatIndex : 8 SAID : 8195 GC : 1
Multicast Group : 225.0.0.2
Source : *
IDB : Bu1 Interface: Wi5/0:0 Dsid: 0x5F079
StatIndex : 9 SAID : DEFAULT
Multicast Group : 225.0.0.2
Source : *
IDB : Bu1 Interface: Wi5/0:0 Dsid: 0x5F079
StatIndex : 10 SAID : 8196 GC : 1
Example of the show cable multicast dsid integrated-Cable Command Output That Displays the Dynamic DSID
Created on a Particular Interface for the Cisco uBR7246VXR and Cisco uBR7225VXR routers in
Cisco IOS Release 12.2(33)SCD
The following example shows a sample output for the show cable multicast dsid integrated-Cable
static command:
Router# show cable multicast dsid integrated-Cable 5/0:0 static
Dsid Stat Index Type
0x5F000 65384 IGMPv1/v2
0x5F001 65385 IGMPv3
0x5F002 65386 MLDv1
0x5F003 65387 MLDv2
0x5F004 65388 PreReg
Table 136 describes the significant fields shown in the show cable multicast dsid command display.
Table 136 show cable multicast dsid Field Descriptions
Field Description
Multicast Group Multicast group.
Source Source IP address.
IDB Interface description block number.
Interface Interface name.
Dsid Downstream service identifier.
StatIndex Blaze indexes assigned for a multicast session.
SAID Security Association Identifier.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1559
Cable Commands: show cable m through show cable u
show cable multicast dsid
Related Commands Command Description
show cable multicast Displays the list of defined multicast authorization profiles and all CMs
authorization associated with corresponding profiles.
show cable multicast Displays the multicast explicit tracking database content.
db
show cable multicast Displays the configuration information for MQoS (Group-Config,
qos Group-QoS-Config, Group-Encryption-Config).
Cisco IOS CMTS Cable Command Reference
CBL-1560 OL-15510-15
Cable Commands: show cable m through show cable u
show cable multicast qos
show cable multicast qos
To display the configuration information for multicast quality of service (MQoS), use the show cable
multicast qos command in privileged EXEC mode.
show cable multicast qos {group-config [group-config-index] | group-encryption
[group-encryption-index] | group-qos [group-qos-index]}
Syntax Description group-config Displays multicast group configuration information.
group-config-index (Optional) Index for the multicast group. The valid range is from 1 to 2048.
group-encryption Displays multicast group encryption information.
group-encryption-index (Optional) Index for the multicast group encryption.
group-qos Displays multicast group QoS information.
group-qos-index (Optional) Index for the multicast group QoS.
Command Default None
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCB This command was introduced.
12.2(33)SCC The command output was modified to display the application ID for default
multicast group QoS configuration.
12.2(33)SCE The command output was modified to list the PCMM application for
multimedia multicast configuration.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1561
Cable Commands: show cable m through show cable u
show cable multicast qos
Examples Example of the show cable multicast qos Command Output for Multicast Group Configuration
The following example shows a sample output of the show cable multicast qos command that displays
multicast group configuration information:
Router# show cable multicast qos group-config
Default Multicast Group-Qos Application ID 65535
Multiast Group Config 1 : Priority 1
Group QOS - 1
Group Encryption - 1
Application ID 65534
Session Range - Group Prefix 230.0.0.0 Mask 255.0.0.0 Source Prefix 0.0.0.0 Mask 0.0.0.0
Example of the show cable multicast qos Command Output for Multicast Group Encryption
The following example shows a sample output of the show cable multicast qos command that displays
multicast group encryption information:
Router# show cable multicast qos group-encryption
Multicast Group Encryption 1 : Algorithm 56bit-des
Multicast Group Encryption 2 : Algorithm 128bit-aes
Example of the show cable multicast qos Command Output for Multicast Group QoS
The following example shows a sample output of the show cable multicast qos command that displays
multicast group QoS information in Cisco IOS Release 12.2(33)SCC:
Router# show cable multicast qos group-qos
Group QOS Index Service Class Control Igmp Limit Override
DEFAULT MQOS_DEFAULT Aggregate NO-LIMIT 1 MQOS Aggregate NO-LIMIT
The following example shows a sample output of the show cable multicast qos command that displays
multicast group QoS information including the application (the App field) for multimedia multicast
configuration in Cisco IOS Release 12.2(33)SCE:
Router# show cable multicast qos group-qos
Group QOS Index Service Class Control Igmp Limit Override App
DEFAULT mcast_default Aggregate NO-LIMIT
1 SDV_SD Single --- No CLI
512 SDV_HD Single --- No PCMM
Table 118 describes the significant fields shown in the display.
Table 137 show cable multicast qos Field Descriptions
Field Description
Group Identifies the multicast group.
QOS Identifies the QoS profile that is being enforced.
Index Index number of the QoS group.
Service Class Identifies the service class being used for the multicast.
Control Identifies the type of control.
Igmp Limit Displays the Internet Group Management Protocol (IGMP)
session limit for aggregate service flows.
Cisco IOS CMTS Cable Command Reference
CBL-1562 OL-15510-15
Cable Commands: show cable m through show cable u
show cable multicast qos
Table 137 show cable multicast qos Field Descriptions (continued)
Field Description
Override Displays the additional IGMP session admitted and
forwarded as best effort traffic.
App Displays the application used for multimedia multicast.
Related Commands Command Description
show cable multicast Displays the list of defined multicast authorization profiles and all CMs
authorization associated with corresponding profiles.
show cable multicast Displays the contents of multicast explicit tracking database.
db
show cable multicast Displays the entire Downstream Service Identifier (DSID) database content.
dsid
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1563
Cable Commands: show cable m through show cable u
show cable multicast statistics failure
show cable multicast statistics failure
To display the multicast statistics failure details, use the show cable multicast statistics command in
global configuration mode.
show cable multicast statistics failure
Command Default Information for all multicast statistics failure is displayed.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCF This command was introduced.
Usage Guidelines The show cable multicast statistics failure command displays information about admission control
failure and PXF queue failure.
Examples The following is a sample output from the show cable multicast statistics failure command:
Router# show cable multicast statistics failure
counter value
Admission Control Failure 0
PXF Queue Failure 0
Related Commands Command Description
show cable multicast db Displays the contents of the multicast explicit tracking database.
clear cable multicast Clears all multicast statistics counters.
statistics counter
Cisco IOS CMTS Cable Command Reference
CBL-1564 OL-15510-15
Cable Commands: show cable m through show cable u
show cable noise
show cable noise
To display cable noise statistics on a Cisco CMTS, use the show cable noise command in EXEC mode.
show cable {slot/port | slot/subslot/port} noise
Syntax Description slot/port Identifies the cable interface and downstream port on the
Cisco uBR7100 series and Cisco uBR7200 series routers.
On the Cisco uBR7100 series router, the only valid value is 1/0. On
the Cisco uBR7200 series router, slot can range from 3 to 6, and port
can be 0 or 1, depending on the cable interface.
slot/subslot/port Identifies the cable interface on the Cisco uBR10012 router. The
following are the valid values:
• slot = 5 to 8
• subslot = 0 or 1
• port = 0 to 4 (depending on the cable interface)
Command Modes EXEC
Command History Release Modification
12.0(4)XI This command was introduced.
12.1(3a)EC1 This command was removed from the 12.1 EC release.
Usage Guidelines This command is not supported on Cisco IOS Release 12.1(3a)EC1 or later releases.
Examples The following example shows how to display CM noise statistics:
Router# show cable 6/0 noise
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Related Commands Command Description
show cable modem Displays CM configuration settings.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1565
Cable Commands: show cable m through show cable u
show cable privacy
show cable privacy
To display Baseline Privacy Interface Plus (BPI+) certificate information and the security or privacy
information for the Cisco CMTS router, use the show cable privacy command in privileged EXEC
mode.
show cable privacy {eae-exclude | hotlist {cm} | manufacturer-cert-list | root-cert-list}
Syntax Description eae-exclude Displays the early authentication and encryption (EAE) details.
hotlist {cm} Displays a list of cable modems detected as clones.
manufacturer-cert-list Displays the BPI manufacturer certificate verification list.
root-cert-list Displays the BPI root certificate verification list.
Command Modes Privileged EXEC (#)
Command History Release Modification
11.3 NA This command was introduced in a different form and its functions moved to
the show interface cable privacy command.
12.2(4)BC1 This command was introduced in its current form.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
12.2(33)SCC This command was modified. The eae-exclude keyword was added.
12.2(33)SCE This command was modified. The hotlist keyword was added.
Usage Guidelines The show cable privacy command is available only in IOS images that support BPI and BPI+
encryption.
Examples The following is a sample output of the show cable privacy command with the eae-exclude keyword
that lists the cable modems excluded from the early authentication and encryption process:
Router# show cable privacy eae-exclude
EAE Exclusion List:
MAC: 1111.1111.1111 Mask: ffff.ffff.ffff
MAC: 2222.2222.2222 Mask: ffff.ffff.ffff
The following is a sample output of the show cable privacy command with the hotlist keyword that lists
the permanent and temporary hotlist entries:
Router# show cable privacy hotlist cm
MAC Address Last Ranged Type Interface
0025.2eaf.6f16 Dec 13 21:03:56 Permanent C8/1/0
0025.2eaf.6f26 Dec 13 21:03:56 Temporary C5/1/0
Cisco IOS CMTS Cable Command Reference
CBL-1566 OL-15510-15
Cable Commands: show cable m through show cable u
show cable privacy
Table 138 describes the significant fields shown in the show cable privacy command display:
Table 138 show cable privacy Command Field Description
Field Description
MAC Address MAC address of the cable modem that is on the hotlist.
Last Ranged On Displays the time stamp when the cable modem last attempted registration
on that interface. This value helps gauge the frequency with which the
MAC address is attempting to be cloned, and manage the hotlist
accordingly.
Type • Permanent—The cable modem entry can be configured as a permanent
clone from the CLI by executing the
cable privacy hotlist cable modem command. A cable modem
marked as a permanent clone can only be removed from the hotlist by
executing the no form of the cable privacy hotlist cable modem
command.
• Temporary—The Cisco CMTS detects a duplicate cable modem MAC
address. This duplicate MAC address is flagged as a clone and is
prevented from coming online for 180 seconds.
Related Commands Command Description
cable privacy Configures certificates for BPI+ encryption.
add-certificate
cable privacy Enables and configures BPI+ encryption on a cable interface.
show cable modem Displays cable modem configuration settings.
show interface cable Displays baseline privacy information.
privacy
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1567
Cable Commands: show cable m through show cable u
show cable qos enforce-rule
show cable qos enforce-rule
To display the quality of service (QoS) enforce-rules that are currently defined, use the show cable qos
enforce-rule command in privileged EXEC mode.
show cable qos enforce-rule [name] [verbose]
Syntax Description name (Optional) Specifies the name of a particular enforce-rule to be
displayed.
verbose (Optional) Displays detailed information about the QoS enforce-rule
options that are currently defined.
Command Default All enforce-rules are displayed.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(15)BC1 This command was introduced.
12.3(9a)BC This command was integrated into Cisco IOS Release 12.3(9a)BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
12.3(23)BC2 The following new output fields were added for the verbose form of the
command: Penalty End-time, Weekend First Peak Time, Weekend First
Duration, Weekend First Average-rate, Weekend Second Peak Time,
Weekend Second Duration, Weekend Second Average rate, Weekend
Offpeak Duration, Weekend Offpeak Average-rate, and Weekend
Auto-enforce.
12.3(23)SCD1 The following new output fields were added for the verbose form of the
command: Monitoring after RelTime, Penalty-Period for week-days,
Penalty-Period for week-ends.
The following output fields were modified for the verbose form of the
command: Penalty End-time, First Peak Time, Second Peak Time, Weekend
First Peak Time, Weekend Second Peak Time.
The output field Penalty End-time was renamed as Default Penalty Duration.
Examples The following example shows typical output for the default version of the show cable qos enforce-rule
command:
Router# show cable qos enforce-rule
Name Dur Dir byte-cnt Auto rate penalty Reg Enf Ena Persist
(min) (kbytes) enf (min) (min) QoS QoS
residential 10 us 5 act 1 10080 5 10 Yes Yes
ef-q11d 30 ds 150 act 1 20 11 99 Yes Yes
Cisco IOS CMTS Cable Command Reference
CBL-1568 OL-15510-15
Cable Commands: show cable m through show cable u
show cable qos enforce-rule
ef-q11u 30 us 60 act 1 20 11 99 Yes Yes
ef-q21 720 us 60 act 1 10 21 81 Yes Yes
ef-q21d 300 ds 150 act 1 10 21 81 Yes Yes
ef-q22 720 us 60 act 1 10 22 82 Yes Yes
ef-q22d 300 ds 150 act 1 10 22 82 Yes No
ef-q23 720 us 60 act 1 10 23 83 Yes Yes
ef-q23d 300 ds 150 act 1 10 23 83 Yes Yes
ef-q24 720 us 60 act 1 10 24 84 Yes Yes
ef-q24d 300 ds 150 act 1 10 24 84 Yes Yes
ef-q25 720 us 60 act 1 10 25 85 Yes Yes
ef-q25d 300 ds 150 act 1 10 25 85 Yes Yes
ef-q26 720 us 60 act 1 10 26 86 Yes Yes
ef-q26d 300 ds 150 act 1 10 26 86 Yes Yes
ef-q27 720 us 60 act 1 10 27 87 Yes Yes
ef-q27d 300 ds 150 act 1 10 27 87 Yes Yes
ef-q28 720 us 60 act 1 10 28 88 Yes Yes
ef-q28d 300 ds 150 act 1 10 28 88 Yes No
ef-q5d 300 ds 150 act 1 10 5 99 Yes Yes
ef-q5u 720 us 600 act 1 10 5 99 Yes Yes
The following example shows sample output from the show cable qos enforce-rule command for a
particular enforce-rule named “residential”:
Router# show cable qos enforce-rule residential
Name Dur Dir byte-cnt Auto rate penalty Reg Enf Ena Persist
(min) (kbytes) enf (min) (min) QoS QoS
residential 10 us 5 act 1 10080 5 10 Yes Yes
Table 57 describes the significant fields displayed by the show cable qos enforce-rule command.
.
Table 139 show cable qos enforce-rule Field Descriptions
Field Description
Name Name of the enforce-rule.
Dur (min) The monitoring duration period, in minutes.
Dir Direction in which the byte-count is applied:
• DS—Downstream direction
• US—Upstream direction
byte-cnt (kbytes) Maximum number of bytes, in kilobytes, that subscribers using this
enforce-rule can transmit during the monitoring-duration window before
being considered to be overconsuming.
Auto enf Displays whether the enforce-rule QoS profile is automatically activated
when a subscriber exceeds their allowed bandwidth.
rate (min) Size of the sample-rate interval, in minutes.
penalty (min) Size of the penalty period, in minutes.
Reg QoS Profile ID for the registered QoS profile or the name of the service class.
Enf QoS Profile ID for the enforced QoS profile or the name of the service class.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1569
Cable Commands: show cable m through show cable u
show cable qos enforce-rule
Table 139 show cable qos enforce-rule Field Descriptions (continued)
Field Description
Ena Displays whether this enforce-rule is currently enabled and active.
Persist Displays whether this enforce-rule keeps the enforced QoS profile in
force across cable modem reboots:
• Yes—Enforced QoS profiles remain in effect across cable modem
reboots.
• No—Enforced QoS profiles do not remain in effect when a cable
modem reboots. See the no-persistence option for the qos-profile
enforced command.
The following example shows the sample output from the show cable qos enforce-rule verbose form
of the command with the new output fields beginning in Cisco IOS Release 12.3(23)BC2:
Name : test
Version : docsis10
Monitoring Type : peak-offpeak
Registered : 255
Enforced : 4
Monitoring Duration : 120 (in minutes)
Sample-rate : 10 (in minutes)
Average-rate : 1 kbits/sec
Direction : upstream
Penalty Time : 10080 (in minutes)
Penalty End-time : 23 (time of day in hrs)
Rule Enabled : Yes
Persistence : Yes
Week-end : Yes
First Peak Time : 6
Duration : 180 (in minutes)
First Average-rate : 2 kbits/sec
Second Peak Time : 18
Duration : 240 (in minutes)
Second Averate-rate : 3 kbits/sec
Offpeak Duration : 120 (in minutes)
Offpeak Average-rate : 1 kbits/sec
Auto-enforce : active
Weekend First Peak Time : 8
Weekend First Duration : 120 (in minutes)
Weekend First Average-rate : 2 kbits/sec
Weekend Second Peak Time : 18
Weekend Second Duration : 180 (in minutes)
Weekend Second Average-rate : 5 kbits/sec
Weekend Offpeak Duration : 240 (in minutes)
Weekend Offpeak Average-rate : 4 kbits/sec
Weekend Auto-enforce : active
The following example shows the sample output from the show cable qos enforce-rule verbose form
of the command with the new output fields in Cisco IOS Release 12.3(33)SCD2:
Router# show cable qos enforce-rule test verbose
Name : test
Version : docsis11
Monitoring Type : peak-offpeak
Registered : REG-DS
Enforced : ENF-DS
Cisco IOS CMTS Cable Command Reference
CBL-1570 OL-15510-15
Cable Commands: show cable m through show cable u
show cable qos enforce-rule
Monitoring Duration : 70 (in minutes)
Sample-rate : 10 (in minutes)
Average-rate : 3 kbits/sec
Direction : downstream
Auto Enforce : Yes
Current Penalty Duration : 10 (in minutes)
Default Penalty Duration : 10 (in minutes)
Penalty End-time : 23:0 (time of day)
Rule Enabled : Yes
Persistence : Yes
Weekend : No
Penalty Off : No
Monitor Weekend : Yes
Monitoring after RelTime : Off
First Peak Time : 10:0
Duration : 60 (in minutes)
First Average-rate : 1 kbits/sec
Second Peak Time : 19:0
Duration : 65 (in minutes)
Second Average-rate : 2 kbits/sec
Offpeak Duration : 70 (in minutes)
Offpeak Average-rate : 3 kbits/sec
Auto Enforce : Yes
Sample Rate : 10
Penalty-Period for week-days : 0
Weekend First Peak Time : 11:0
Weekend Duration : 75 (in minutes)
Weekend First Average-rate : 4 kbits/sec
Weekend Second Peak Time : 20:0
Weekend Duration : 80 (in minutes)
Weekend Second Average-rate : 5 kbits/sec
Weekend Offpeak Duration : 85 (in minutes)
Weekend Offpeak Average-rate : 6 kbits/sec
Weekend Auto Enforce : Yes
Weekend Sample Rate : 12
Penalty-Period for week-ends : 0
Related Commands Command Description
cable qos enforce-rule Creates an enforce-rule to enforce a particular QoS profile for subscriber
traffic management and enters enforce-rule configuration mode.
duration Specifies the time period and sample rate to be used for monitoring
subscribers.
enabled (enforce-rule) Activates an enforce-rule and begins subscriber traffic management on a
Cisco CMTS router.
penalty-period Specifies the time period that an enforced QoS profile should be in effect for
subscribers that violate their registered QoS profiles.
qos-profile enforced Specifies a QoS profile that should be enforced when users violate their
registered QoS profiles. This command is applicable for only DOCSIS 1.0
cable modems.
qos-profile registered Specifies the registered QoS profile that should be used for this enforce-rule.
This command is applicable for only DOCSIS 1.0 cable modems.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1571
Cable Commands: show cable m through show cable u
show cable qos enforce-rule
Command Description
service-class Specifies a service class (enforced or registered) that should be used for the
(enforce-rule) cable modem monitoring in an enforce-rule. This command is applicable for
DOCSIS 1.1 or later cable modems.
show cable Displays subscribers who are violating their registered QoS profiles.
subscriber-usage
Cisco IOS CMTS Cable Command Reference
CBL-1572 OL-15510-15
Cable Commands: show cable m through show cable u
show cable qos permission
show cable qos permission
To display the status of permissions for changing quality-of-service (QoS) tables on a Cisco CMTS, use
the show cable qos permission command in privileged EXEC mode.
show cable qos permission
Syntax Description This command has no keywords or arguments.
Command Modes Privileged EXEC
Command History Release Modification
12.1 T This command was introduced.
12.1(4)CX This command was deprecated for DOCSIS 1.1 use, because DOCSIS 1.1
replaces the QoS profile model with a service flow model. The show
interface cable qos paramset command is used for DOCSIS 1.1 operation.
Examples The following example displays the output of the show cable qos permission command:
CMTS01# show cable qos permission
Create by SNMP Update by SNMP Create by modems
yes yes yes
Table 0-140 describes the fields displayed by the show cable qos permission command.
Table 0-140 show cable qos permission Command Field Descriptions
Field Description
Create by SNMP Indicates permission setting for creation of QoS table entries by the
Simple Network Management Protocol (SNMP).
Update by SNMP Indicates permission setting for creation of QoS table entries by
modem registration requests.
Create by modems Indicates permission setting for dynamic updating of QoS table
entries by the SNMP.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1573
Cable Commands: show cable m through show cable u
show cable qos permission
Related Commands Command Description
cable qos permission Specifies permission for updating the cable router QoS table.
cable qos profile Configures a QoS profiles.
cable service-flow Sets the amount of time a dynamic service-flow can be present in the system
inactivity-timeout without any activity.
show controllers cable Displays cable router QoS profiles.
show interface cable Displays the DOCSIS 1.1 QoS parameter sets.
qos paramset
Cisco IOS CMTS Cable Command Reference
CBL-1574 OL-15510-15
Cable Commands: show cable m through show cable u
show cable qos profile
show cable qos profile
To display quality-of-service (QoS) profiles for a Cisco CMTS, use the show cable qos profile
command in privileged EXEC mode.
show cable qos profile profile-index [verbose]
Syntax Description profile-index Displays cable QoS table. Valid range is 1 to 255.
verbose Displays detailed information about the QoS profiles.
Command Modes Privileged EXEC
Command History Release Modification
11.3NA This command was introduced.
12.0(3)T The command was included in the mainline release.
12.0(7)XR The verbose option was added.
12.1(1)T The IP precedence rate enabling bits were added to the display.
12.1(4)CX This command was deprecated for DOCSIS 1.1 use, because DOCSIS 1.1
replaces the QoS profile model with a service flow model. The show
interface cable qos paramset command is used for DOCSIS 1.1 operation.
Examples The following example shows how to display the existing QoS profiles on the CMTS:
Router# show cable qos profile
ID Prio Max Guarantee Max Max TOS TOS Create B IP prec.
upstream upstream downstream tx mask value by priv rate
bandwidth bandwidth bandwidth burst enab enab
1 0 0 0 0 0 0x0 0x0 cmts(r) no no
2 0 64000 0 1000000 0 0x0 0x0 cmts(r) no no
3 7 31200 31200 0 0 0x0 0x0 cmts yes no
4 7 87200 87200 0 0 0x0 0x0 cmts yes no
5 2 256000 0 128000 1503 0x0 0x0 cm no no
Profiles 1 and 2 are always created by the CMTS at initial startup. The CMTS dynamically creates
profiles 3 and 4, as shown above, to support Voice over IP (VoIP) codecs G.711 and G.729 when a CM
configures phone lines and uses dynamic service requests to request VoIP service. The remaining
profiles, such as profile 5 above, are typically created by a CM when it comes online.
Profile 3 creates a grant-size of 31.22 KiloBytes per second for G.729 service, and profile 4 creates a
grant-size of 87.2 KiloBytes per second for G.711 service. Both profiles use a default grant-interval of
20 milliseconds. For more information on these profiles, see the TAC technical note at the following
URL:
http://www.cisco.com/warp/public/109/uBR7200_QoSMAC.html
The following example displays detailed output for profile 1:
Router# show cable qos profile 1 verbose
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1575
Cable Commands: show cable m through show cable u
show cable qos profile
Profile Index 1
Name Default
Upstream Traffic Priority 0
Upstream Maximum Rate (bps) 0
Upstream Guaranteed Rate (bps) 0
Unsolicited Grant Size (bytes) 0
Unsolicited Grant Interval (usecs) 0
Upstream Maximum Transmit Burst (bytes) 0
IP Type of Service Overwrite Mask 0x0
IP Type of Service Overwrite Value 0x0
Downstream Maximum Rate (bps) 0
Created By cmts(r)
Baseline Privacy Enabled no
Table 0-141 describes the fields displayed by the show cable qos profile command.
Table 0-141 show cable qos profile Command Field Descriptions
Field Description
ID Profile number.
Prio Priority level.
Max upstream bandwidth Maximum upstream bandwidth.
Guarantee upstream bandwidth Guaranteed minimum upstream bandwidth.
Max downstream bandwidth Maximum downstream bandwidth.
Max tx burst Maximum transmit burst size in bytes.
Tos mask Hex value of the mask bits.
Tos value Value of the mask byte.
Create by Identity of who created the profile:
• cmts = Created by the CMTS with read-write properties. The
profile can be modified but not deleted.
• cmts(r) = Created by the CMTS with read-only properties. The
profile cannot be modified or deleted.
• cm = Created by the CM DOCSIS configuration file.
• mgmt = Created by an operator using CLI commands.
B priv enab Describes whether Baseline Privacy Interface (BPI) encryption is
enabled (yes) or disabled (no) for this QoS profile.
IP prec. rate enab Describes whether IP precedence rate limiting enabling is enabled
(yes) or disabled (no) for this QoS profile. When a profile is
created by a CM, this value is set by the Type Length Value (TLV)
11 fields in the DOCSIS configuration file, unless overwritten
using the cable qos profile command.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Cisco IOS CMTS Cable Command Reference
CBL-1576 OL-15510-15
Cable Commands: show cable m through show cable u
show cable qos profile
Related Commands Command Description
cable qos permission Specifies permission for updating the cable router QoS table.
cable qos profile Configures a QoS profiles.
cable service-flow Sets the amount of time a dynamic service-flow can be present in the
inactivity-timeout system without any activity.
show cable modem qos Displays quality of service (QoS) and service flow information for a
particular CM.
show cable noise Displays the status of permissions for changing QoS tables.
show interface cable qos Displays the DOCSIS 1.1 QoS parameter sets.
paramset
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1577
Cable Commands: show cable m through show cable u
show cable rate-adapt
show cable rate-adapt
To display the global and local upstream utilization optimization configuration parameters, use the show
cable rate-adapt command in privileged EXEC mode.
show cable rate-adapt
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.3(23)BC2 This command was introduced.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.2(33)SCB. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines This command displays the current global rate-adapt settings that govern all cable modem and the local
rate-adapt settings that relate to a specific cable modem upstream.
Examples The following example shows a typical display of the show cable rate-adapt command:
Router# show cable rate-adapt
Global:Enabled Local-Only:Enabled global:maps 500 priority 6, rate 12 bcs 10 fcms On
Note The output “maps 500” relates to duration. It indicates that the service flow is optimized for 500 MAPs.
Table 142 describes the fields shown in the show cable rate-adapt display.
Table 142 show cable rate-adapt Field Descriptions
Field Description
Global Indicates if upstream utilization optimization is enabled globally
on all cable modems.
Local Indicates if upstream utilization optimization is enabled locally on
a specific upstream flow.
priority Indicates the specified priority setting.
rate Indicates the specified minimum max-rate.
bcs Indicates the number of broadcast contention minislots (BCS).
fcms Indicates if forced broadcast contention minislot (fcms) is turned
on or off.
duration Indicates the duration of a rate-adapt flow.
Cisco IOS CMTS Cable Command Reference
CBL-1578 OL-15510-15
Cable Commands: show cable m through show cable u
show cable rate-adapt
Related Commands Command Description
cable upstream Enables upstream utilization optimization globally on all cable modem
rate-adapt (global) upstream flows.
cable upstream Enables upstream utilization optimization locally.
rate-adapt (interface)
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1579
Cable Commands: show cable m through show cable u
show cable rate-limit-ccf
show cable rate-limit-ccf
To display information about rate limiting criteria for upstream bonded service flows on the
Cisco uBR10-MC5X20H cable interface line card, use the show cable rate-limit-ccf command in
privileged EXEC mode.
show cable rate-limit-ccf [start-index count | clear]
Syntax Description start-index (Optional) Starting index for the log entries. The valid range is from 0 to
2000. The default value is 0.
count (Optional) Total number of log entries to be displayed. The valid range is
from 0 to 2000.
clear (Optional) Clears information about rate limiting.
Command Default None
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCC This command was introduced in Cisco IOS Release 12.2(33)SCC.
Examples The following is a sample output of the show cable rate-limit-ccf command that displays information
about rate limiting criteria for upstream bonded service flows on a Cisco uBR10-MC5X20H cable
interface line card:
Router# show cable rate-limit-ccf
rate_limiting config: aggr_throughput: 215000000 aggr_burst: 240000
cpu_threshold: 50 cpu_burst: 10
5X20H rate limit: cpu-throttle 0 ccf-bw-drop 0 others 0
5X20H rate limit ccf info count: 0
Table 143 describes the fields shown in the show cable rate-limit-ccf command display.
Table 143 show cable rate-limit-ccf Field Descriptions
Field Description
aggr_throughput Aggregate throughput value.
aggr_burst Aggregate burst rate value.
cpu_threshold CPU threshold for Continuous Concatenation and
Fragmentation (CCF) in percentage.
cpu_burst CPU burst for CCF in percentage
cpu-throttle Total number of bandwidth requests that stopped
due to CPU throttle.
Cisco IOS CMTS Cable Command Reference
CBL-1580 OL-15510-15
Cable Commands: show cable m through show cable u
show cable rate-limit-ccf
Table 143 show cable rate-limit-ccf Field Descriptions
Field Description
ccf-bw-drop Total number of bandwidth requests that stopped
due to CCF resource constraint.
5X20H rate limit ccf info count Total number of log entries.
Related Commands Command Description
cable upstream Configures rate limiting criteria for upstream bonded service flows on a
rate-limit-ccf Cisco uBR10-MC5X20H cable interface line card.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1581
Cable Commands: show cable m through show cable u
show cable redundancy
show cable redundancy
To display the DDC redundancy partners and their relative states, and additional information about DDC
states on the Cisco CMTS, use the show cable redundancy command in privileged EXEC mode.
show cable redundancy {hashfilter | class | calls}
Syntax Description hashfilter Displays the hash filter(s) being used in the scheme.
class Displays the displays the number of cable modems in each DDC class of the
same scheme.
calls Displays the number of active and E911 calls currently being supported on
the relative DDC nodes.
Command Default This command has no default behaviors or values.
Command Modes Privileged EXEC (#)
Command History Release Modification
Release 12.3(9a)BC This command was introduced on the Cisco uBR7246 universal broadband
router.
Examples The following example of the show cable redundancy hashfilter command illustrates the same DDC
Redundancy scheme (two Cisco uBR7246VXR routers). This command displays the configured hash
filter parameters. You can either list all hash filters (as shown) or list one hash filter, if specified with
the optional hash_id value at the end of the command.
Router# show cable redundancy hashfilter
HashFilter 1
HashType MacMask
default ffff.ffff.ffff
MacAddr OUI Node
0000.39cc.b270 1
0000.39cc.ba70 2
0000.39cc.c070 2
HashFilter 2
HashType MacMask
default 0000.00ff.ffff
MacAddr OUI Node
00.00.391
00.08.0D1
00.0C.E51
The following example of the show cable redundancy class command displays the number of cable
modems in each DDC class of the same scheme (two Cisco uBR7246VXR routers).
Router# show cable redundancy class
Number of modems in each DDC class:
InterfaceClass0Class1Class2Class3Class4
Cisco IOS CMTS Cable Command Reference
CBL-1582 OL-15510-15
Cable Commands: show cable m through show cable u
show cable redundancy
Cable3/0 32 00 0 0
Cable3/1 3200 0 0
Cable4/0320 0 0 0
Cable4/100 0 0 0
Cable5/0310 0 0 0
Cable5/1320 0 0 0
Cable6/000 0 0 0
Cable6/100 0 0 0
The following example of the show cable redundancy calls command displays the number of active
911 (E911) calls, voice calls, and the number of cable modems with service flows for each subinterface.
If the subinterface is configured on a bundle, the number of calls is the total for all the members in the
bundle.
Router# show cable redundancy calls
SubInterface 911Calls VoiceCalls ModemCount ServiceFlow
Cable3/0.1 0 0 159 159
Cable3/0.2 0 0 0 0
Related Commands Command Description
cable redundancy Sets the MAC address and DDC node mappings of the DDC redundancy
hashfilter scheme.
cable redundancy Sets the total number of Cisco DDC nodes (routers) in the DDC Redundancy
myid scheme and sets the ID of the current DDC node.
cable redundancy Configures the DDC node with active or standby state.
node
cable redundancy Sets the downstream frequencies for each node participating in the scheme
node frequency other than the current DDC node (router).
cable redundancy Sets the target DDC node (router) to use in a DDC switchover event.
target
cable redundancy Sets the active voice call threshold on the current DDC node (router).
threshold
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1583
Cable Commands: show cable m through show cable u
show cable resiliency
show cable resiliency
To display all information about the resiliency bonding groups and their assigned status on the
Cisco CMTS router, use the show cable resiliency command in privileged EXEC mode.
show cable resiliency
Command Default None
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCG This command was introduced.
Examples The following example shows a sample output of the show cable resiliency command:
Router# show cable resiliency
BG Resil BG RF
Resil BG I/F ID State Count Time Ctrl Num
------------- ---- -------------- ----- --------------- ----------
Wi1/2/0:10 10 Free
Wi1/2/0:20 20 Free
Wi7/0/0:1 1 Assigned 3 Nov 3 09:55:49 0 0
1
2
Wi7/0/0:2 2 Assigned 3 Nov 3 09:57:09 0 0
1
3
Table 1 describes the significant fields shown in the display.
Table 144 show cable resiliency Field Descriptions
Field Description
Resil BG I/F Bonding group interface assigned to resiliency mode.
BG ID Bonding group ID.
Resil BG State Status of the resiliency bonding group—free or assigned.
Count Number of times this bonding group has been assigned.
Time Day and time the bonding group was last assigned.
RF Ctrl Primary RF channel.
RF Num RF index number of the assigned RF channel.
Related Commands
Cisco IOS CMTS Cable Command Reference
CBL-1584 OL-15510-15
Cable Commands: show cable m through show cable u
show cable resiliency
Command Description
cable resiliency Enables the Downstream Resiliency Bonding Group feature on the Cisco
ds-bonding CMTS router.
cable ds-resiliency Reserves a resiliency bonding group for a line card on the Cisco CMTS
router.
show cable modem Displays resiliency status of the cable modem in resiliency mode on the
resiliency Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1585
Cable Commands: show cable m through show cable u
show cable rf-adapt
show cable rf-adapt
To display the downgrade and upgrade candidate modems, use the show cable rf-adapt command in
user EXEC or privileged EXEC mode.
show cable rf-adapt [cable {slot/cable-interface-index | slot/subslot/cable-interface-index}
[upgrade-candidates | downgrade-candidates | upstream upstream-channel-id
[upgrade-candidates | downgrade-candidates]] | upgrade-candidates |
downgrade-candidates]
Syntax Description cable Displays information about the cable modems in a specific cable interface.
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.
subslot (Cisco uBR10012 only) Secondary slot number of the cable interface line
card. The valid subslots are 0 or 1.
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.
upgrade-candidates Displays information about the upgrade candidate cable modems.
downgrade-candidates Displays information about the downgrade candidate cable modems.
upstream (Optional) Displays candidates on a particular upstream channel. The valid
upstream-channel-id range for upstream-channel-id is from 0 to 3.
Command Modes User EXEC (>) or
Privileged EXEC (#)
Command History Release Modification
12.2(33)SCF This command was introduced.
Cisco IOS CMTS Cable Command Reference
CBL-1586 OL-15510-15
Cable Commands: show cable m through show cable u
show cable rf-adapt
Examples The following is a sample output of the show cable rf-adapt downgrade-candidates command:
Router# show cable rf-adapt downgrade-candidates
MAC Address IP Address Source Destination
Upstream Upstream
0019.474a.d4cc 10.10.1.9 C8/0/1/U3.0 C8/0/1/U3.1
0019.474a.d554 10.10.1.73 C8/0/14/U0.0 C8/0/14/U0.1
0019.474a.d542 10.10.1.79 C8/0/0/U0.0 C8/0/0/U0.1
0019.474a.d508 10.10.1.11 C8/0/8/U0.0 C8/0/8/U0.1
0025.2e2d.7400 10.10.1.66 C8/0/0/U1.0 C8/0/0/U1.1
0022.cea4.f404 10.10.1.53 C8/0/2/U2.0 C8/0/2/U2.1
The following is a sample output of the show cable rf-adapt upgrade-candidates command:
Router# show cable rf-adapt upgrade-candidates
MAC Address IP Address Source Destination
Upstream Upstream
0019.474a.d554 10.10.1.73 C8/0/14/U0.1 C8/0/14/U0.0
0019.474a.d542 10.10.1.79 C8/0/0/U0.1 C8/0/0/U0.0
0025.2e2d.7400 10.10.1.66 C8/0/0/U1.1 C8/0/0/U1.0
The following is a sample output of the show cable rf-adapt cable upstream downgrade-candidates
command:
Router# show cable rf-adapt cable 7/0/0 upstream 0 downgrade-candidates
MAC Address IP Address Source Destination
Upstream Upstream
0019.474a.d4cc 10.10.1.9 C7/0/0/U3.0 C7/0/0/U3.1
The following is a sample output of the show cable rf-adapt cable upstream upgrade-candidates
command:
Router# show cable rf-adapt cable 7/0/0 upstream 0 upgrade-candidates
MAC Address IP Address Source Destination
Upstream Upstream
0019.474a.d554 10.10.1.73 C7/0/0/U0.1 C7/0/0/U0.0
The following is a sample output of the show cable rf-adapt cable downgrade-candidates command:
Router# show cable rf-adapt cable 7/0/0 downgrade-candidates
MAC Address IP Address Source Destination
Upstream Upstream
0019.474a.d4cc 10.10.1.9 C7/0/0/U3.0 C7/0/0/U3.1
The following is a sample output of the show cable rf-adapt cable upgrade-candidates command:
Router# show cable rf-adapt cable 7/0/0 upgrade-candidates
MAC Address IP Address Source Destination
Upstream Upstream
0019.474a.d554 10.10.1.73 C7/0/0/U0.1 C7/0/0/U0.0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1587
Cable Commands: show cable m through show cable u
show cable rf-adapt
Table 145 describes the significant fields shown in the display.
Table 145 show cable modem rf-adapt Field Descriptions
Field Description
MAC Address MAC address of the cable modem.
IP Address IP address of the cable modem.
Source Upstream Source upstream port and logical channel index of
the cable modem.
Destination Upstream Destination upstream port and logical channel
index to which the cable modem will be moved.
Related Commands Command Description
cable rf-adapt timer Configures timers for RF adaptation.
cable upstream rf-adapt Enables RF adaptation on the physical upstream channel.
cable upstream rf-adapt Specifies the primary upstream logical channel and the secondary
(logical channel) upstream logical channel.
cable upstream threshold Configures the upstream RF adaptation threshold value, which
rf-adapt prevents excessive relocation of modems from the primary upstream
channel to the secondary upstream channel.
show cable modem Displays information about the registered and unregistered cable
modems.
show cable modem rf-adapt Displays the RF adaptation history.
Cisco IOS CMTS Cable Command Reference
CBL-1588 OL-15510-15
Cable Commands: show cable m through show cable u
show cable rf-status
show cable rf-status
To display the logical up and down state of a channel number, or the logical state of all RF channels, use
the show cable rf-status command in privileged EXEC mode.
show cable rf-status [modular-cable slot/bay/port:nb-channel-number]
Syntax Description modular-cable (Optional) Specifies the modular cable interface.
slot (Optional) The slot where a SIP resides. On the Cisco uBR10012 router,
slots 1 and 3 can be used for SIPs.
bay (Optional) The bay in a SIP where a SPA is located. Valid values are 0
(upper bay) and 1 (lower bay).
port (Optional) Specifies the interface number on the SPA.
nb-channel-number (Optional) Specifies the channel number for the RF channel.
Command Default No default behavior or values.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCB This command was introduced.
Examples The following is a sample output of the show cable rf-status command used to display the logical state
of all RF channels on a modular cable interface:
Router# show cable rf-status
Logical Flap Flap
RF Status Counts Time
-------- ------- ------ ----
1/0/0 0 UP 0
1 UP 0
2 UP 0
3 UP 0
5 UP 0
6 UP 0
7 UP 0
8 UP 0
9 UP 0
10 UP 0
11 UP 0
12 UP 0
13 UP 0
14 UP 0
15 UP 0
16 UP 0
17 UP 0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1589
Cable Commands: show cable m through show cable u
show cable rf-status
18 UP 0
19 UP 0
20 UP 0
21 UP 0
22 UP 0
23 UP 0
Table 146 describes the significant fields shown in the display.
Table 146 show cable rf-status Field Descriptions
Field Description
RF Indicates the RF channel ID.
Logical Status Indicates the logical up and down state of all RF channels.
Flap Counts Indicates the number of times the RF channel has dropped and recovered.
Flap Time Indicates the duration in seconds for each flap count.
The following is a sample output of the show cable rf-status command used to display the logical up
and down state of a particular channel number on a modular cable interface:
Router# show cable rf-status modular-cable 1/0/0:1
Load for five secs: 6%/0%; one minute: 3%; five minutes: 2%
Time source is NTP, .14:47:27.751 EDT Thu Aug 7 2008
Logical Flap Flap
RF Status Counts Time
-------- ------- ------ ----
1/0/0 1 UP 0
Related
Commands Command Description
show interface rf-status Displays the logical up and down state for each of the configured RF
channels for a wideband interface.
Cisco IOS CMTS Cable Command Reference
CBL-1590 OL-15510-15
Cable Commands: show cable m through show cable u
show cable rsvp flow-db
show cable rsvp flow-db
To display contents of the Resource ReSerVation Protocol (RSVP) to DOCSIS service-flow mapping
database, use the show cable rsvp flow-db command in user EXEC mode.
show cable rsvp flow-db [mac-addr]
Syntax
Description mac-addr (Optional) The MAC address of the specific cable modem in hexadecimal
format.
Command Default No default behavior or values.
Command Modes User EXEC mode
Command History Release Modification
12.2(33)SCB This command was introduced.
Usage Guidelines The show cable rsvp flow-db command displays contents of the RSVP to DOCSIS service-flow
mapping database.
Examples The following example shows the sample output for the show cable rsvp flow-db command.
Router# show cable rsvp flow-db
CM Count : 1
Flow Count : 1
Mac Address Src IP Src Dest IP Dest Pr Sfid Dir Handle
Port Port ot (Hex)
0019.474a.c5f6 200.0.0.1 1000 40.1.1.62 1000 6 11 DS 7000406
Table 147 describes the significant fields shown in the display.
Table 147 cable rsvp flow-db Field Descriptions
Field Description
Mac Address The MAC address of the specific cable modem.
Src IP RSVP path source IP address.
Src Port RSVP path source port number.
Dest IP Destination IP address.
Dest port Destination port number.
Proto IP protocol type. Here 17 is the UDP's IP protocol number.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1591
Cable Commands: show cable m through show cable u
show cable rsvp flow-db
Table 147 cable rsvp flow-db Field Descriptions
Field Description
SFid Service flow ID.
Dir Direction of the DOCSIS service flow. Here DS indicates
downstream flow.
Related Commands Command Description
cable rsvp default-scn Specifies the default service class for the RSVP.
Cisco IOS CMTS Cable Command Reference
CBL-1592 OL-15510-15
Cable Commands: show cable m through show cable u
show cable service-class
show cable service-class
To display the parameters for cable service class, use the show cable service class command in
privileged EXEC mode.
show cable service-class [sclass-index] [verbose]
Syntax Description sclass-index Identifies the index for a service class that has already been defined
(1 to 255).
verbose Displays all of the defined attributes for the service class.
Command Modes Privileged EXEC
Command History Release Modification
12.1(4)CX This command was introduced.
12.2(4)BC1 Support was added to the Release 12.2 BC train.
12.2(33)SCC This command was integrated into Cisco IOS Release 12.2(33)SCC. The
command output was modified to display the traffic peak rate value for a
specific service flow.
12.2(33)SCG The command output was modified to display the scheduling type as “N/A”
for all downstream service flows.
Usage Guidelines You can display a summary of either one service class or all service classes. You can also display a
complete listing of each service class and of all the defined service classes.
Note Starting with Cisco IOS Release 12.2(33)SCG, the output of the show cable service class command
displays the scheduling type of all downstream service flows (DS-SF) as “N/A” to indicate that the
DS-SFs do not have any scheduling type.
Examples The following sample output shows the standard and verbose formats of the show cable service class
command:
Router# show cable service-class
Index Name Dir Sched Prio MaxSusRate MaxBurst MinRsvRate
1 UP_UGS US/DS UGS 0 0 1522 0
2 UP_UGSAD US/DS UGS_AD 0 0 1522 0
3 UP_RTPS US/DS RTPS 0 128000 2000 64000
4 UP_BE US/DS BE 5 128000 2000 0
5 DOWN_BE US/DS BE 5 1000000 3000 0
Router# show cable service-class 1
Index Name Dir Sched Prio MaxSusRate MaxBurst MinRsvRate
1 UP_UGS US/DS UGS 0 0 1522 0
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1593
Cable Commands: show cable m through show cable u
show cable service-class
Router# show cable service-class 1 verbose
Index: 1
Name: UP_UGS
Direction: Upstream/Downstream
Traffic Priority: 0
Maximum Sustained Rate: 0 bits/sec
Max Burst: 1522 bytes
Minimum Reserved Rate: 0 bits/sec
Minimum Packet Size 100 bytes
Admitted QoS Timeout 30 seconds
Active QoS Timeout 30 seconds
Scheduling Type: Unsolicited Grant Service
Request/Transmission Policy: 0x1FF
Unsolicited Grant Size: 100 bytes
Nominal Grant Interval: 20000 usecs
Tolerated Grant Jitter: 4000 usecs
Grants per Interval: 1
IP ToS Overwrite [AND-mask,OR-mask]: 0xE0,0xA0
Max Latency: 0 usecs
Parameter Presence Bitfield: {0xE08, 0xBCC000}
Router# show cable service-class verbose
Index: 1
Name: UP_UGS
Direction: Upstream/Downstream
Traffic Priority: 0
Maximum Sustained Rate: 0 bits/sec
Max Burst: 1522 bytes
Minimum Reserved Rate: 0 bits/sec
Minimum Packet Size 100 bytes
Peak Rate 0 bits/sec
Admitted QoS Timeout 30 seconds
Active QoS Timeout 30 seconds
Scheduling Type: Unsolicited Grant Service
Request/Transmission Policy: 0x1FF
Unsolicited Grant Size: 100 bytes
Nominal Grant Interval: 20000 usecs
Tolerated Grant Jitter: 4000 usecs
Grants per Interval: 1
IP ToS Overwrite [AND-mask,OR-mask]: 0xE0,0xA0
Max Latency: 0 usecs
Parameter Presence Bitfield: {0xE08, 0xBCC000}
Index: 2
Name: UP_UGSAD
Direction: Upstream/Downstream
Traffic Priority: 0
Maximum Sustained Rate: 0 bits/sec
Max Burst: 1522 bytes
Minimum Reserved Rate: 0 bits/sec
Minimum Packet Size 100 bytes
Peak Rate 0 bits/sec
Admitted QoS Timeout 30 seconds
Active QoS Timeout 30 seconds
Scheduling Type: Unsolicited Grant Service(AD)
Request/Transmission Policy: 0x1FF
Nominal Polling Interval: 10000 usecs
Tolerated Poll Jitter: 4000 usecs
Unsolicited Grant Size: 100 bytes
Nominal Grant Interval: 20000 usecs
Tolerated Grant Jitter: 4000 usecs
Grants per Interval: 1
Cisco IOS CMTS Cable Command Reference
CBL-1594 OL-15510-15
Cable Commands: show cable m through show cable u
show cable service-class
IP ToS Overwrite [AND-mask,OR-mask]: 0xE0,0xA0
Max Latency: 0 usecs
Parameter Presence Bitfield: {0xE08, 0xBFC000}
Index: 3
Name: UP_RTPS
Direction: Upstream/Downstream
Traffic Priority: 0
Maximum Sustained Rate: 128000 bits/sec
Max Burst: 2000 bytes
Minimum Reserved Rate: 64000 bits/sec
Minimum Packet Size 64 bytes
Peak Rate 0 bits/sec
Admitted QoS Timeout 30 seconds
Active QoS Timeout 30 seconds
Maximum Concatenated Burst: 1522 bytes
Scheduling Type: Realtime Polling Service
Request/Transmission Policy: 0x1FF
Nominal Polling Interval: 10000 usecs
Tolerated Poll Jitter: 4000 usecs
IP ToS Overwrite [AND-mask,OR-mask]: 0xE0,0xA0
Max Latency: 0 usecs
Parameter Presence Bitfield: {0xDC8, 0x83E000}
Index: 4
Name: UP_BE
Direction: Upstream/Downstream
Traffic Priority: 5
Maximum Sustained Rate: 128000 bits/sec
Max Burst: 2000 bytes
Minimum Reserved Rate: 0 bits/sec
Minimum Packet Size 64 bytes
Peak Rate 0 bits/sec
Admitted QoS Timeout 30 seconds
Active QoS Timeout 30 seconds
Maximum Concatenated Burst: 1522 bytes
Scheduling Type: Best Effort
Request/Transmission Policy: 0x0
IP ToS Overwrite [AND-mask,OR-mask]: 0xE0,0x0
Max Latency: 0 usecs
Parameter Presence Bitfield: {0xDE8, 0x80E000}
Index: 5
Name: DOWN_BE
Direction: Upstream/Downstream
Traffic Priority: 5
Maximum Sustained Rate: 1000000 bits/sec
Max Burst: 3000 bytes
Minimum Reserved Rate: 0 bits/sec
Minimum Packet Size 64 bytes
Peak Rate 0 bits/sec
Admitted QoS Timeout 30 seconds
Active QoS Timeout 30 seconds
Maximum Concatenated Burst: 0 bytes
Scheduling Type: Best Effort
Request/Transmission Policy: 0x0
IP ToS Overwrite [AND-mask,OR-mask]: 0xFF,0x0
Max Latency: 0 usecs
Parameter Presence Bitfield: {0xDE8, 0x0}
Router#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1595
Cable Commands: show cable m through show cable u
show cable service-class
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Related Commands cable service class Defines and modifies a service class.
show interface cable Displays the parameters in one or more service templates.
qos paramset
Cisco IOS CMTS Cable Command Reference
CBL-1596 OL-15510-15
Cable Commands: show cable m through show cable u
show cable service-voice downstream-type
show cable service-voice downstream-type
To display the downstream-types that are capable of providing voice services, use the show cable
service-voice downstream-type command.
show cable service-voice downstream-type
Syntax Description This command has no keywords or arguments.
Command Default No default behavior or values
Command Modes Privileged EXEC
Command History Release Modification
12.3(23)BC This command was introduced for the Cisco uBR10012 router.
Usage Guidelines Use this command to display the downstream-types that are capable for providing voice services on each
uBR10-MC 5x20 line card.
Examples The example below shows that both HA-capable-DS and MDC-DS are enabled for downstream types on
the uBR10-MC 5x20 line card in slot 5, subslot 1 and the line card in slot 6, subslot 0.
Router# show cable service-voice downstream-type
Slot 5/1 : HA-capable-DS MDC-DS
Slot 6/0 : HA-capable-DS MDC-DS
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1597
Cable Commands: show cable m through show cable u
show cable signal-quality
show cable signal-quality
To display information about the signal quality of an upstream port on a cable interface, use the show
cable signal-quality command in privileged EXEC mode.
show cable signal-quality {cable {slot/port | slot/subslot/port} upstream number | cmts | mer}
Syntax Description cable Specifies the cable interface.
slot/subslot/port Displays information about all CMs on the specified cable interface line
card on a Cisco CMTS router:
• slot—Chassis slot number of the cable interface line card. Valid slots
are from 5 to 8.
• subslot—Secondary slot number of the cable interface line card. Valid
subslots are 0 or 1.
• port—Port number. Valid ports are from 0 to 4, depending on the cable
interface line card.
upstream number Specifies the upstream channel ID. Valid values are from 0 to 3.
cmts Displays the carrier-to-noise ratio (CNR) data and expected signal power
received per cable interface.
mer Displays the modulation error rate (MER) data per cable interface.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCC This command was introduced in Cisco IOS Release 12.2(33)SCC.
Usage Guidelines The show cable signal-quality command with the mer keyword displays the modulation error rate data
per cable interface. Note that at least one cable modem (CM) must be online on the cable interface for
this command to provide the modulation error rate data. This is identical to the modulation error rate
data displayed by the show controllers command.
The CNR data is displayed only for the upstream channels that are assigned to a spectrum group.
Upstream channels with fixed frequencies do not return any CNR data.
Examples The following example shows the CNR data received on the upstream ports on the cable interface line
card at slot/subslot/port 7/0/3 on a Cisco uBR10012 router:
Router# show cable signal-quality cable 7/0/3 cmts
I/F CNiR Expected Received
(dB) Signal Power (dBmV)
Cable7/0/3/U0 55.0 1.0
Cable7/0/3/U1 44.0 0.0
Cable7/0/3/U2 43.0 -1.0
Cable7/0/3/U3 43.0 2.0
Cisco IOS CMTS Cable Command Reference
CBL-1598 OL-15510-15
Cable Commands: show cable m through show cable u
show cable signal-quality
The following example shows the MER data received on the cable upstream port 3 on the cable interface
line card at slot/subslot/port 5/0/0 on a Cisco uBR10012 router:
Router# show cable signal-quality cable 5/0/0 upstream 3 mer
I/F Received MER Received MER
(dB) Samples
Cable5/0/0/U3 36.0 10
The following example shows the signal quality information for all cable interfaces on a
Cisco uBR10012 router:
Router#show cable signal-quality mer
I/F Received MER Received MER
(dB) Samples
Cable6/1/0/U0 ----- -----
Cable6/1/0/U1 ----- -----
Cable6/1/0/U2 ----- -----
Cable6/1/0/U3 ----- -----
Cable6/1/1/U0 ----- -----
Cable6/1/1/U1 ----- -----
Cable6/1/1/U2 ----- -----
Cable6/1/1/U3 ----- -----
Cable6/1/2/U0 ----- -----
Cable6/1/2/U1 ----- -----
Cable6/1/2/U2 ----- -----
Cable6/1/2/U3 ----- -----
Cable6/1/3/U0 ----- -----
Cable6/1/3/U1 ----- -----
Cable6/1/3/U2 ----- -----
Cable6/1/3/U3 ----- -----
Cable6/1/4/U0 ----- -----
Cable6/1/4/U1 ----- -----
Cable6/1/4/U2 ----- -----
Cable6/1/4/U3 ----- -----
Cable7/1/0/U0 23.6 10
Cable7/1/0/U1 ----- -----
Cable7/1/0/U2 ----- -----
Cable7/1/0/U3 ----- -----
Cable7/1/1/U0 ----- -----
Cable7/1/1/U1 ----- -----
Cable7/1/1/U2 ----- -----
Cable7/1/1/U3 ----- -----
Cable7/1/2/U0 ----- -----
Cable7/1/2/U1 ----- -----
Cable7/1/2/U2 ----- -----
Cable7/1/2/U3 ----- -----
Cable7/1/3/U0 ----- -----
Cable7/1/3/U1 ----- -----
Cable7/1/3/U2 ----- -----
Cable7/1/3/U3 ----- -----
Cable7/1/4/U0 ----- -----
Cable7/1/4/U1 ----- -----
Cable7/1/4/U2 ----- -----
Cable7/1/4/U3 ----- -----
Cable8/0/0/U0 36.1 10
Cable8/0/0/U1 ----- -----
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1599
Cable Commands: show cable m through show cable u
show cable signal-quality
Table 148 describes the major fields displayed by the show cable signal-quality command.
Table 148 show cable signal-quality Command Field Descriptions
Field Description
I/F Cable interface.
CNiR (db) CNR value.
Expected Received Signal Power Expected signal power received per upstream port.
(dBmV)
Received MER (db) Received MER signal-to-noise ratio (SNR) value.
Received MER (samples) Samples used for calculating the SNR per upstream port.
Related Commands Command Description
show cable Displays information about the spectrum measurements of an upstream port
spectrum-analysis on a cable interface on a Cisco uBR10012 router.
show controllers Displays information about the interface controllers for a cable interface on
the Cisco CMTS router.
show cable modem cnr Displays information about CNR or SNR data for a particular cable modem.
show cable modem Displays information about the registered and unregistered CMs on a
Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
CBL-1600 OL-15510-15
Cable Commands: show cable m through show cable u
show cable spectrum-analysis
show cable spectrum-analysis
To display information about the spectrum measurements of an upstream port on a cable interface line
card, use the show cable spectrum-analysis command in privileged EXEC mode.
show cable spectrum-analysis slot/subslot/port upstream port
Syntax Description slot/subslot/port Displays information about all CMs on the specified cable interface line
card on a Cisco CMTS router:
• slot—Chassis slot number of the cable interface line card. Valid slots
are from 5 to 8.
• subslot—Secondary slot number of the cable interface line card. Valid
subslots are 0 or 1.
• port—Downstream port number. Valid ports are from 0 to 4, depending
on the cable interface line card.
upstream port Specifies the upstream port number.
Command Modes Privileged EXEC(#)
Command History Release Modification
12.2(33)SCC This command was introduced in Cisco IOS Release 12.2(33)SCC.
Examples The following example shows the spectrum measurements on upstream port 1 on a Cisco uBR10012
router:
Router# show cable spectrum-analysis c5/0/0 upstream 1
Spectrum Analysis Measurements for Cable5/0/0: Upstream 1
Channel Center Frequency: 17000000 Hz
Frequency Span: 6400000 Hz
Number of Bins: 321
Bin Spacing: 20000 Hz
Resolution Bandwidth: 34200 Hz
Amplitude Data:
Bin 1: -60.00 dBmV
Bin 2: -58.00 dBmV
Bin 3: -58.00 dBmV
Bin 4: -58.00 dBmV
Bin 5: -55.00 dBmV
Bin 6: -55.00 dBmV
Bin 7: -58.00 dBmV
Bin 8: -55.00 dBmV
Bin 9: -49.00 dBmV
Bin 10: -49.00 dBmV
Bin 11: -49.00 dBmV
Bin 12: -49.00 dBmV
Bin 13: -49.00 dBmV
Bin 14: -55.00 dBmV
Bin 15: -58.00 dBmV
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1601
Cable Commands: show cable m through show cable u
show cable spectrum-analysis
Bin 16: -45.00 dBmV
Bin 17: -38.00 dBmV
Bin 18: -35.00 dBmV
Bin 19: -33.00 dBmV
Bin 20: -33.00 dBmV
Bin 21: -34.00 dBmV
Bin 22: -37.00 dBmV
Bin 23: -37.00 dBmV
Bin 24: -32.00 dBmV
Bin 25: -28.00 dBmV
Bin 26: -27.00 dBmV
Bin 27: -26.00 dBmV
Bin 28: -27.00 dBmV
Bin 29: -31.00 dBmV
Bin 30: -32.00 dBmV
Bin 31: -29.00 dBmV
Bin 32: -29.00 dBmV
Table 148 describes the significant fields shown in the display.
Table 149 show cable spectrum-analysis Field Descriptions
Field Description
Spectrum analysis measurements Spectrum measurements.
Channel center frequency Channel center frequency value.
Frequency span Frequency span.
No of Bins Total number of bins in the spectrum analysis data.
Bin spacing Spacing between the center frequency of each bin.
Resolution Bandwidth Spacing between bins after the spectral window is applied.
Amplitude Data Spectral amplitudes for the received signal power of a bin.
Related Commands Command Description
show cable Displays information about the signal quality of an upstream port on a cable
signal-quality interface line card.
show controllers cable Displays information about the interface controllers for a cable interface line
card on a Cisco CMTS router.
show cable modem cnr Displays information about the upstream carrier-to-noise ratio (CNR) or
signal-to-noise ratio (SNR) for a particular cable modem.
Cisco IOS CMTS Cable Command Reference
CBL-1602 OL-15510-15
Cable Commands: show cable m through show cable u
show cable spectrum-group
show cable spectrum-group
To display information about spectrum groups on a Cisco CMTS, use the show cable spectrum-group
command in user EXEC or privileged EXEC mode.
show cable spectrum-group [groupnum] [detail]
Syntax Description groupnum (Optional) Displays information about the specified group number
(1–32). If no group number is specified, information for all spectrum
groups is displayed.
detail (Optional) Displays whether the groups are allocated, free, or in-use.
Command Modes User EXEC, Privileged EXEC
Command History Release Modification
11.3 NA This command was introduced.
12.0(5)SC, 12.0(5)T The detail keyword was added.
Examples The following is sample output from the show cable spectrum-group command for all upstream
spectrum groups:
CMTS01# show cable spectrum-group
Group Frequency Upstream Weekly Scheduled Power Shared
No. Band Port Availability Level Spectrum
(Mhz) From Time: To Time: (dBmV)
1 5.000-42.000 0 No
1 17.328 [1.60] Cable3/0 U0 0
1 5.808 [1.60] Cable3/0 U1 0
1 5.808 [1.60] Cable3/0 U2 0
1 15.792 [1.60] Cable3/0 U3 0
1 6.096 [1.60] Cable3/0 U4 0
1 5.808 [1.60] Cable3/0 U5 0
2 5.000-42.000 0 No
2 6.608 [3.20] Cable6/0 U1 0
2 5.808 [1.60] Cable6/0 U2 0
2 5.808 [1.60] Cable6/0 U3 0
2 5.808 [1.60] Cable6/0 U4 0
2 5.808 [1.60] Cable6/0 U5 0
3 5.000-42.000 0 No
3 17.488 [1.60] Cable5/0 U1 0
3 6.160 [1.60] Cable5/0 U2 0
3 36.912 [1.60] Cable5/0 U3 0
3 36.560 [1.60] Cable5/0 U4 0
3 16.240 [1.60] Cable5/0 U5 0
4 6.000- 8.600 0 No
4 16.000-18.000 0 No
4 17.168 [1.60] Cable5/0 U0 0
5 5.000-42.000 0 No
6 5.000-42.000 0 No
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1603
Cable Commands: show cable m through show cable u
show cable spectrum-group
7 5.000-42.000 0 No
8 5.000-42.000 0 No
9 5.000-42.000 0 No
10 5.000-42.000 0 No
11 5.000-42.000 0 No
12 10.000-13.000 0 No
CMTS#
The following is sample output from the show cable spectrum-group detail command:
CMTS# show cable spectrum-group detail
Group Frequency Upstream Weekly Scheduled Power Shared
No. Band Port Availability Level Spectrum
(Mhz) From Time: To Time: (dBmV)
1 10.000 1 Yes
1 10.000 2 Yes
1 11.000 3 Yes
1 11.000 4 Yes
1 15.000-20.000 0 Yes
A 8.400-12.600
A 15.000-20.000
1 11.008 [0.80] Cable3/0 U2 4
1 15.808 [1.60] Cable3/0 U3 0
1 Unassigned Cable3/0 U4
1 17.408 [1.60] Cable3/0 U5 0
I 10.600-11.400 4
I 15.000-16.600 0
I 16.600-18.200 0
F 8.400-10.600
F 11.400-12.600
F 18.200-20.000
C Width [3.20]
C Width [1.60]
C Width [0.80]
O 19.000 [1.60] 0
O 10.000 [0.80] 2
O 18.600 [0.80] 0
O 19.400 [0.80] 0
O 10.000 [0.80] 1
CMTS#
Table 0-150 describes the fields shown in the show cable spectrum-group displays.
Cisco IOS CMTS Cable Command Reference
CBL-1604 OL-15510-15
Cable Commands: show cable m through show cable u
show cable spectrum-group
Table 0-150 show cable spectrum-group Command Field Descriptions
Field Description
Group No. Identifies the spectrum group. When using the detail keyword, the
following also appear:
• A = Signifies that the band is allocated.
• F = Signifies that the band is free.
• I = Signifies that the band is in-use.
• C = Identifies the channel width.
• O = Identifies the offered list bands (based on the current
channel widths).
Frequency Band (MHz) Identifies the upper and lower ranges of the frequency for this
spectrum group.
Upstream Port Identifies the upstream port number.
Weekly Scheduled Availability Identifies the day and time of day when this group is available. If
no values appear in the From and To Time fields, this group is
available at all times.
Input PowerLevel Identifies the assigned decibels per millivolt (dBmV) input level.
Shared Spectrum Indicates if upstreams are physically combined (share the same
combiner group). Y or yes values indicate that upstreams that are
members of the spectrum group are combined and cannot be
assigned overlapping frequency bands.
N or no values indicate that upstreams that are members of the
spectrum group are not combined and can be assigned overlapping
frequency bands.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Related Commands Command Description
show cable hop Displays CM configuration settings.
show cable Displays modulation profile group information.
modulation-profile
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1605
Cable Commands: show cable m through show cable u
show cable subscriber-usage
show cable subscriber-usage
To display subscribers who are violating their registered quality of service (QoS) profiles, use the show
cable subscriber-usage command in privileged EXEC mode.
show cable subscriber-usage [over-consume] [{cable slot/port | cable
slot/subslot/port}[upstream port]] [sort-byte-count] [sort-avg-rate]
Syntax Description over-consume (Optional) Displays only those subscribers who have exceeded their
maximum allowed bandwidth.
cable slot/port (Optional) Displays information for all CMs on the specified cable
interface and downstream port on a Cisco 7100 series or Cisco 7200
series router, where:
• slot—Specifies the chassis slot number of the cable interface line
card.
• port—Specifies the downstream port number.
Valid values for these arguments are dependent on your CMTS router
and cable interface line card. Refer to the hardware documentation for
your router chassis and cable interface line card for supported slot and
port numbering.
cable slot/subslot/port (Optional) Displays information for all CMs on the specified cable
interface on a Cisco uBR10012 router, where:
• slot—Specifies the chassis slot number of the cable interface line
card. Valid slots are 5 to 8.
• subslot—Specifies the secondary slot number of the cable
interface line card. Valid subslots are 0 or 1.
• port—Specifies the downstream port number. Valid ports are 0 to
4, depending on the cable interface line card.
upstream port (Optional) Displays information for a particular upstream on the
selected cable interface. The port value starts with 0 and continues up,
depending on the type of cable interface card.
sort-byte-count (Optional) Sorts the list by the subscriber byte count, with the highest
byte counts listed first. The default is to sort the list by Service Flow
ID (SFID). (This option is replaced by the sort-avg-rate keyword in
later releases.)
sort-avg-rate (Optional) Sorts the list by the subscriber’s average rate. The default is
to sort the list by Service Flow ID (SFID).
Command Default All subscribers are shown, with the display sorted by SFID.
Command Modes Privileged EXEC (#)
Cisco IOS CMTS Cable Command Reference
CBL-1606 OL-15510-15
Cable Commands: show cable m through show cable u
show cable subscriber-usage
Command History Release Modification
12.2(15)BC1 This command was introduced.
12.3(9a)BC This command was integrated into Cisco IOS Release 12.3(9a)BC. The
sort-byte-count keyword option is replaced by the sort-avg-rate keyword
option.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support
for the Cisco uBR7225VXR router was added.
Usage Guidelines The show cable subscriber-usage command displays the current usage statistics for all subscribers on
the Cisco CMTS router, all subscribers on a particular cable interface, or for only those subscribers that
are marked as over-consuming bandwidth.
Effective with Cisco IOS Release 12.3(9a)BC, the sort-byte-count keyword option is replaced by the
sort-avg-rate keyword option.
Examples The following example shows typical output for the default version of the show cable subscriber-usage
command:
Router# show cable subscriber-usage
Sfid Mac Address Enforce-rule Total-Kbyte Last-detect Last-penalty Pen
Name Count time time Flag
3 0007.0e03.110d efrule-q5 121944817 Jan1 03:44:08 Jan1 03:54:08 Act
4 0007.0e03.110d efrule-q5d 1879076068 Jan1 03:35:05 Jan1 03:45:06 Act
5 0007.0e03.1431 efrule-q5 120052387 Jan1 03:44:18 Jan1 03:54:18 Act
6 0007.0e03.1431 efrule-q5d 1838493626 Jan1 03:34:55 Jan1 03:44:55 Act
7 0007.0e03.1445 efrule-q5 120919427 Jan1 03:44:08 Jan1 03:54:08 Act
8 0007.0e03.1445 efrule-q5d 1865955172 Jan1 03:35:06 Jan1 03:45:06 Act
9 0007.0e03.1225 efrule-q5 120200155 Jan1 03:44:18 Jan1 03:54:18 Act
10 0007.0e03.1225 efrule-q5d 1839681070 Jan1 03:34:55 Jan1 03:44:55 -
11 0007.0e03.0cb1 efrule-q5 122941643 Jan1 03:43:58 Jan1 03:53:58 Act
12 0007.0e03.0cb1 efrule-q5d 1889107176 Jan1 03:35:06 Jan1 03:45:06 Act
13 0007.0e03.1435 efrule-q5 119504795 Jan1 03:44:18 Jan1 03:54:18 Act
14 0007.0e03.1435 efrule-q5d 1835164034 Jan1 03:34:55 Jan1 03:44:55 -
15 0007.0e02.f80d efrule-q5 119250047 Jan1 03:44:18 Jan1 03:54:18 Act
16 0007.0e02.f80d efrule-q5d 1832034114 Jan1 03:34:55 Jan1 03:44:55 -
17 0007.0e03.1469 efrule-q5 117562137 Jan1 03:44:18 Jan1 03:54:18 Act
18 0007.0e03.1469 efrule-q5d 1816957486 Jan1 03:34:55 Jan1 03:44:55 -
19 0007.0e03.11f9 efrule-q5 124265775 Jan1 03:44:18 Jan1 03:54:18 Act
20 0007.0e03.11f9 efrule-q5d 1959957066 Jan1 03:35:46 Jan1 03:45:46 Act
21 0007.0e03.1461 efrule-q5 113314731 Jan1 03:34:55 Jan1 03:44:55 -
22 0007.0e03.1461 efrule-q5d 1827583110 Jan1 03:35:46 Jan1 03:45:46 Act
23 0007.0e03.11d9 efrule-q5 104607787 Jan1 03:34:55 Jan1 03:44:55 -
24 0007.0e03.11d9 efrule-q5d 1675444338 Jan1 03:34:55 Jan1 03:44:55 -
25 0007.0e03.1475 efrule-q5 113751019 Jan1 03:34:55 Jan1 03:44:55 -
26 0007.0e03.1475 efrule-q5d 1841060070 Jan1 03:35:56 Jan1 03:45:56 Act
27 0007.0e03.10d9 efrule-q5 113713981 Jan1 03:34:55 Jan1 03:44:55 -
28 0007.0e03.10d9 efrule-q5d 1840272262 Jan1 03:35:56 Jan1 03:45:56 Act
29 0007.0e03.1065 efrule-q5 113443243 Jan1 03:34:55 Jan1 03:44:55 -
30 0007.0e03.1065 efrule-q5d 1834855264 Jan1 03:35:56 Jan1 03:45:56 Act
31 0007.0e03.1081 efrule-q5 119843737 Jan1 03:44:18 Jan1 03:54:18 Act
32 0007.0e03.1081 efrule-q5d 1852632338 Jan1 03:35:56 Jan1 03:45:56 Act
33 0007.0e03.1179 efrule-q5 118522795 Jan1 03:44:18 Jan1 03:54:18 Act
34 0007.0e03.1179 efrule-q5d 1834693996 Jan1 03:35:56 Jan1 03:45:56 Act
35 0007.0e03.1471 efrule-q5 122182565 Jan1 03:43:58 Jan1 03:53:58 Act
36 0007.0e03.1471 efrule-q5d 1881390866 Jan1 03:34:55 Jan1 03:44:55 -
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1607
Cable Commands: show cable m through show cable u
show cable subscriber-usage
37 0007.0e03.1341 efrule-q5 129557931 Jan1 03:43:48 Jan1 03:53:48 Act
38 0007.0e03.1341 efrule-q5d 2016792338 Jan1 03:35:56 Jan1 03:45:56 Act
The following example shows typical output for subscribers on a particular cable interface:
Router# show cable subscriber-usage c6/0/0
Sfid Mac Address Enforce-rule Total-Kbyte Last-detect Last-penalty Pen
Name Count time time Flag
7 0007.0e03.2cad test1 0 Jan1 00:00:00 Jan1 00:00:00 -
9 0007.0e03.2c45 test1 0 Jan1 00:00:00 Jan1 00:00:00 -
The following example shows typical output for the show cable subscriber-usage command for one
upstream on a particular cable interface:
Router# show cable subscriber-usage c6/0/1 upstream 0
Sfid Mac Address Enforce-rule Total-Kbyte Last-detect Last-penalty Pen
Name Count time time Flag
5 0007.0e03.2c25 test1 0 Jan1 00:00:00 Jan1 00:00:00 -
The following example shows typical output for the sort-byte-count option for the show cable
subscriber-usage command:
Router# show cable subscriber-usage sort-byte-count
Sfid Mac Address Enforce-rule Total-Kbyte Last-detect Last-penalty Pen
Name Count time time Flag
7 0007.0e03.2cad test1 65157114 Feb24 11:36:34 Mar3 11:36:34 Act
9 0007.0e03.2c45 test1 16381014 -
5 0007.0e03.2c25 test1 13440960 -
Table 151 describes the fields shown by the show cable subscriber-usage command.
Table 151 show cable subscriber-usage Field Descriptions
Field Description
SFID Number of the Service Flow ID.
Mac Address Hardware address (MAC address) of the subscriber’s cable modem.
Enforce-rule Name Name of the enforce-rule being applied to this subscriber.
Total-Kbyte Total number of kilobytes consumed by the subscriber’s cable
modem during the last monitoring-duration window.
Note The total byte count is reset to 0 whenever an enforce-rule’s
configuration is changed.
Last-detect time Last time period, if any, at which it was determined that the cable
modem was using more bandwidth than allowed by their QoS
profile. This value also shows the time at which the enforced QoS
profile was automatically applied, if this option has been enabled.
Last-penalty time If an enforced QoS profile is currently in effect, this field shows the
time period at which the subscriber’s current penalty time expires,
at which point their original registered QoS profile is restored.
Pen Flag Identifies whether a penalty enforce-rule has been applied to this
cable modem.
Related Commands
Cisco IOS CMTS Cable Command Reference
CBL-1608 OL-15510-15
Cable Commands: show cable m through show cable u
show cable subscriber-usage
Command Description
activate-rule Specifies the number of bytes that a subscriber can transmit during the
at-byte-count monitoring period on a Cisco CMTS router.
cable qos enforce-rule Creates an enforce-rule to enforce a particular QoS profile for subscriber
traffic management and enters enforce-rule configuration mode.
duration Specifies the time period and sample rate to be used for monitoring
subscribers.
enabled (enforce-rule) Activates an enforce-rule and begins subscriber traffic management on a
Cisco CMTS Router.
penalty-period Specifies the time period that an enforced QoS profile should be in effect for
subscribers who violate their registered QoS profiles.
qos-profile enforced Specifies a QoS profile that should be enforced when users violate their
registered QoS profiles.
qos-profile registered Specifies the registered QoS profile that should be used for this enforce-rule.
show cable qos Displays the QoS enforce-rules that are currently defined.
enforce-rule
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1609
Cable Commands: show cable m through show cable u
show cable tech-support
show cable tech-support
To display general information about the router when reporting a problem, use the show cable
tech-support command in privileged EXEC mode.
show cable tech-support {slot/port | slot/subslot/port}
Syntax Description slot/port (Optional) Cisco IOS Release 12.3(9a)BC allows you to display
information about one specific cable interface.
Identifies the cable interface and downstream port on the Cisco uBR7100
series and Cisco uBR7200 series routers.
On the Cisco uBR7100 series router, the only valid value is 1/0. On the
Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0
or 1, depending on the cable interface.
slot/subslot/port (Optional) Cisco IOS Release 12.3(9a)BC allows you to display
information about one specific cable interface.
Identifies the cable interface on the Cisco uBR10012 router. The following
are the valid values:
• slot = 5 to 8
• subslot = 0 or 1
• port = 0 to 4 (depending on the cable interface)
Command Default No default behavior or values
Command Modes Privileged EXEC
Command History Release Modification
11.2 This command was introduced.
12.1(1a)T1 This command was modified to include information about the cable clock
card.
12.2(15)BC2 This command added several show pxf commands to the display on the
Cisco uBR10012 router.
12.3(9a)BC The output of the command was significantly shortened by moving a
number of show commands (the ones that display information about
individual cable modems) to the show tech-support command. This release
also adds support for an option to display information about only one
specific cable interface.
Usage Guidelines The show cable tech-support command displays a large amount of configuration, run-time status, and
other information about the cable interfaces on the Cisco CMTS. The output of this command can be
provided to technical support representatives when reporting a problem.
Cisco IOS CMTS Cable Command Reference
CBL-1610 OL-15510-15
Cable Commands: show cable m through show cable u
show cable tech-support
Note The show tech-support includes most of the information shown in the show cable tech-support
command. Unless the problem is clearly cable-specific, TAC personnel will typically request the show
tech-support output to troubleshoot any problems.
The show cable tech-support command displays the output of a number of different show commands.
The exact output depends on the platform, configuration, and type of protocols being used. Typically,the
output includes the output from the following commands:
• show cable modem
• show cable flap-list
• show cable qos profile
• show cable modulation-profile
• show cable spectrum-group
• show cable hop
• show interface cable sid (for each cable interface)
• show interface cable sid connectivity (for each cable interface)
• show interface cable downstream
• show interface cable upstream
• show interface cable mac-scheduler
show interface cable modem Other commands could be included in the show cable tech-support output,
depending on the CMTS platform, the Cisco IOS software being used, and the cards that are installed in
the chassis.
On the Cisco uBR10012 router, the following commands also appear in Cisco IOS Release 12.2(15)BC2
and later releases:
• show pxf cpu statistics
• show pxf cpu subblocks
• show pxf cpu buffer
• show pxf dma
• show pxf cpu cef memory
• show pxf cpu queue
• show pxf cpu statistics drop
Tip Depending on the platform and configuration, the output from the show cable tech-support command
can easily exceed the buffers found in most communications programs. To capture this output so it can
be sent to Cisco TAC, use a Telnet program that allows you to capture the output directly to disk.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1611
Cable Commands: show cable m through show cable u
show cable tech-support
Examples The following abbreviated example illustrates the cable modem and interface information for the
Cisco uBR10012 router on which Cisco IOS Release 12.3(9a)BC is installed.
Router# show cable tech-support
----------------------------------- Slot 8/1 -----------------------------------
------------------ show cable modem Cable8/1/0 ------------------
MAC Address IP Address I/F MAC Prim RxPwr Timing Num BPI
State Sid (dB) Offset CPE Enb
------------------ show cable modem Cable8/1/0 connectivity ------------------
Prim 1st time Times %online Online time Offline time
Sid online Online min avg max min avg max
------------------ show interface Cable8/1/0 sid ------------------
Sid Prim MAC Address IP Address Type Age Admin Sched Sfid
State Type
------------------ show interface Cable8/1/0 sid counter ------------------
Sid Req-polls BW-reqs Grants Packets Frag Concatpkts
issued received issued received complete received
------------------ show interface Cable8/1/0 sid association ------------------
Sid Prim Online IP Address MAC Address Interface VRF Name
------------------ show interface Cable8/1/0 modem 0 ------------------
SID Priv bits Type State IP address method MAC address
------------------ show cable modem Cable8/1/1 ------------------
MAC Address IP Address I/F MAC Prim RxPwr Timing Num BPI
State Sid (dB) Offset CPE Enb
------------------ show cable modem Cable8/1/1 connectivity ------------------
Prim 1st time Times %online Online time Offline time
Sid online Online min avg max min avg max
------------------ show interface Cable8/1/1 sid ------------------
Sid Prim MAC Address IP Address Type Age Admin Sched Sfid
State Type
------------------ show interface Cable8/1/1 sid counter ------------------
Sid Req-polls BW-reqs Grants Packets Frag Concatpkts
issued received issued received complete received
------------------ show interface Cable8/1/1 sid association ------------------
Sid Prim Online IP Address MAC Address Interface VRF Name
------------------ show interface Cable8/1/1 modem 0 ------------------
SID Priv bits Type State IP address method MAC address
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to
show commands using the exec prompt timestamp command in line configuration mode.
Cisco IOS CMTS Cable Command Reference
CBL-1612 OL-15510-15
Cable Commands: show cable m through show cable u
show cable tech-support
Related Commands Command Description
show controllers cable Displays information about a specific line card's interface controllers.
show interface cable Displays information about the cable interface.
downstream
show running-config Displays the current run-time configuration.
show startup-config Displays the configuration that was used to initially configure the
CMTS at system startup.
show tech-support Displays the output from show commands that display the router’s
configuration and run-time status.
show version Displays the configuration of the system hardware, the software
version, the names and sources of configuration files, and the boot
images.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1613
Cable Commands: show cable m through show cable u
show cable throttle-modem
show cable throttle-modem
To display cable modem (CM) throttle information, use the show cable throttle-modem command in
user EXEC or privileged EXEC mode.
show cable throttle-modem
Syntax Description This command has no arguments or keywords.
Command Default None
Command Modes User EXEC (>),
Privileged EXEC (#)
Command History Release Modification
12.2(33)SCF3 This command was introduced.
Examples The following is a sample output of the show cable throttle-modem command when the Cable Modem
Registration Throttling feature is disabled:
Router# show cable throttle-modem
CPU for five seconds: 4%/0%; one minute: 1%; five minutes: 1%
CM Throttle Status : Config Disabled; Oper Disabled;
CM Throttle Config : Init Rate 32 CM/Sec; Holdoff 45 Sec;
Flush Rate 300 CM/Sec
CM Register Rate : 0 CM/Sec
The following is a sample output of the show cable throttle-modem command when the Cable Modem
Registration Throttling feature is enabled:
Router# show cable throttle-modem
CPU for five seconds: 5%/0%; one minute: 1%; five minutes: 1%
CM Throttle Status : Config Enabled; Oper Enabled;
CM Throttle Config : Init Rate 32 CM/Sec; Holdoff 45 Sec;
Flush Rate 300 CM/Sec
CM Register Rate : 0 CM/Sec
CM Throttling Rate : 4 CM/Sec
Num of CM in Queue : 0
Cisco IOS CMTS Cable Command Reference
CBL-1614 OL-15510-15
Cable Commands: show cable m through show cable u
show cable throttle-modem
Table 152 describes the significant fields shown in the display.
Table 152 show cable throttle-modem Field Descriptions
Field Description
CPU for five seconds CPU usage information.
CM Throttle Status CM throttle operating status. The valid values are:
• Config Enabled—Feature is enabled.
• Oper Enabled—Feature is functional.
CM Throttle Config CM throttle configuration parameters.
CM Register Rate Information about the current cable modem registration
success rate.
CM Throttling Rate Dynamic cable modem throttle rate from the waiting queue,
adjusted according to CPU usage, capped by the init-rate
value.
Num of CM in Queue Number of CMs in the queue.
Related Commands Command Description
cable throttle-modem Enables the Cable Modem Registration Throttling feature.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1615
Cable Commands: show cable m through show cable u
show cable upstream service-flow summary
show cable upstream service-flow summary
To display the upstream service flow summary information on the Cisco CMTS router, use the show
cable upstream service-flow summary command in privileged EXEC mode.
show cable upstream service-flow summary
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCG This command was introduced.
Examples The following is a sample output of the show cable upstream service-flow summary command:
Router# show cable upstream service-flow summary
Interface Static Upstream Service Flow Dynamic Upstream Service Flow Desc
Total PRI BE UGS UGS-AD RTPS N-RTPS BE UGS UGS-AD RTPS N-RTPS
C7/0/0/U0 3 0 0 0 0 3 0 0 0 0 0 0
C7/0/0/U2 21 4 12 0 0 9 0 0 0 0 0 0
C7/0/0/U3 20 5 15 0 0 5 0 0 0 0 0 0
C7/0/0/UB1 24 8 24 0 0 0 0 0 0 0 0 0 UBG1
C7/1/0/U2 4 1 3 0 0 1 0 0 0 0 0 0
C7/1/1/U2 1 1 1 0 0 0 0 0 0 0 0 0
C8/0/0/U0 1 1 1 0 0 0 0 0 0 0 0 0
C8/0/0/U1 1 0 0 0 0 1 0 0 0 0 0 0
C8/0/0/U2 1 0 0 0 0 1 0 0 0 0 0 0
C8/0/0/U3 1 0 0 0 0 1 0 0 0 0 0 0
C8/0/0/UB3 5 2 5 0 0 0 0 0 0 0 0 0
C8/0/0/UB8 4 1 4 0 0 0 0 0 0 0 0 0
Total: 86 23 65 0 0 21 0 0 0 0 0 0
Table 108 describes the significant fields shown in the display.
Table 153 show cable upstream service-flow summary Field Descriptions
Field Description
Interface Cable interface.
Total Total number of upstream service flows.
PRI Number of primary upstream service flows.
BE Number of best effort service schedule types.
UGS Number of unsolicited grant service schedule types.
UGS-AD Number of unsolicited grant service with activity detection
schedule types.
RTPS Number of real-time polling service schedule types.
Cisco IOS CMTS Cable Command Reference
CBL-1616 OL-15510-15
Cable Commands: show cable m through show cable u
show cable upstream service-flow summary
Table 153 show cable upstream service-flow summary Field Descriptions (continued)
Field Description
N-RTPS Number of non-real-time polling service schedule types.
Description Descriptive name for the bonding group.
Related Commands Command Description
show interface cable Displays configuration and status information for the cable interface on the
Cisco CMTS router.
show interface cable Displays information about the downstream cable interface on the Cisco
downstream CMTS router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1617
Cable Commands: show cable m through show cable u
show cable urm
show cable urm
To view the connector group table information on a Cisco uBR-MC3GX60V cable interface line card,
use the show cable urm command in the privileged EXEC mode. The connector group table provides
information about the cable MAC domain upstream channel to connector mapping of a physical
upstream channel.
show cable urm [slot/subslot]
Syntax Description slot/subslot Identifies the cable interface on the Cisco uBR10012 router.
• slot—Slot where the line card resides. The valid range is from 5 to 8.
• subslot—Subslot where the line card resides. Available slots are 0 or 1.
Command Default Display information for all the slot/subslot values that has been configured.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCE This command was introduced.
Examples The following is a sample output indicating the connector group table information of the cable line card
in slot 6/1:
Router# show cable urm 6/1
===
connector group table
===
card cnnrs md:us=>cnnr
6/1 0-3 3:2=> 1 *empty* *empty* *empty* *empty* *empty*
*empty* *empty* *empty* *empty* *empty* *empty*
4-7 *empty* *empty* *empty* *empty* *empty* *empty*
*empty* *empty* *empty* *empty* *empty* *empty*
8-11 *empty* *empty* *empty* *empty* *empty* *empty*
*empty* *empty* *empty* *empty* *empty* *empty*
12-15 *empty* *empty* *empty* *empty* *empty* *empty*
*empty* *empty* *empty* *empty* *empty* *empty*
16-19 *empty* *empty* *empty* *empty* *empty* *empty*
*empty* *empty* *empty* *empty* *empty* *empty*
Table 154 describes the significant fields shown in the display.
Table 154 show cable urm Field Descriptions
Cisco IOS CMTS Cable Command Reference
CBL-1618 OL-15510-15
Cable Commands: show cable m through show cable u
show cable urm
Field Description
card The slot/subslot information of the card.
cnnrs The connector index range of connectors in a
connector group. The values for the Cisco
uBR-MC3GX60V, Cisco UBR-MC20X20V,
and the Cisco uBR10-MC5X20U line cards
are 0-19.
md:us=>cnnr The MAC domain upstream channel to
connector mapping information of a physical
upstream channel. The entry position
corresponding to a physical upstream
channel index in a connector group. For
uBR-MC3GX60V line card, there are 12
physical upstream channels in each
connector group. For the UBR-MC20X20V
and uBR10-MC5X20U line cards, there are 2
channels in each group. In the example,
C6/1/3:U2 is mapped to connector 1 in the
running config by the user using connector
command. Internally, CMTS software maps
C6/1/3:U2 to physical upstream channel 0
(1st entry) in the 0-3 connector group.
Related Commands Command Description
show running-config Shows the MD:US connector mapping configured by users.
interface cable
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1619
Cable Commands: show cable m through show cable u
show cable us-sg
show cable us-sg
To display the upstream service groups configured on all cable interfaces of a Cisco CMTS router, use
the show cable us-sg command in privileged EXEC mode.
show cable us-sg
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCC This command was introduced in Cisco IOS Release 12.2(33)SCC.
Examples The following is a sample output of the show cable us-sg command.
Router# show cable us-sg
Cable MD 5/0/0
US-SG-ID : 1 US-Chan : U0,1,2,3,4,5
Primary-DS: 1/0/0:0 US-SG-ID: 1
MDD US-List : U0,1,2,3,4,5
MDD Ambiguity : U0,1,2,3,4,5
Cable MD 6/0/0
US-SG-ID : 1 US-Chan : U0,1,2,3
Primary-DS: 1/0/0:4 US-SG-ID: 1
MDD US-List : U0,1,2,3
MDD Ambiguity : U0,1,2,3
Cable MD 7/0/0
US-SG-ID : 1 US-Chan : U0,1,2,3
Primary-DS: 7/0/0:0 US-SG-ID: 1
MDD US-List : U0,1,2,3
MDD Ambiguity : U0,1,2,3
Primary-DS: 7/0/0:1 US-SG-ID: 1
MDD US-List : U0,1,2,3
MDD Ambiguity : U0,1,2,3
Table 1 shows the significant fields shown in the display:
Table 155 show interface cable service-flow Field Descriptions
Field Description
US-SG-ID Upstream service group ID.
US-Chan Upstream channels on the cable interface line card.
Primary-DS Primary downstream interafce.
Cisco IOS CMTS Cable Command Reference
CBL-1620 OL-15510-15
Cable Commands: show cable m through show cable u
show cable us-sg
Table 155 show interface cable service-flow Field Descriptions (continued)
Field Description
MDD US-List MAC management message: MDD TLV type 7 content, upstream
active channel list.
MDD Ambiguity MAC management message: MDD TLV type 8 content, upstream
ambiguity resolution channel list.
Related Commands Command Description
show cable mac-domain Displays runtime statistics of the upstream service group on a cable
upstream-service-group interface line card.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1621
Cable Commands: show cable m through show cable u
show cable us-sg
Cisco IOS CMTS Cable Command Reference
CBL-1622 OL-15510-15
Cable Commands: show ch through show cr
Revised: July 2012, OL-15510-15
New Commands
Command Cisco IOS Software Release
show cr10k-rp cable 12.2(33)SCA
show cr10k-rp controller 12.2(33)SCA
show cr10k-rp queue 12.2(33)SCA
show cr10k-rp slots 12.2(33)SCA
show controller integrated-cable 12.2(33)SCC
show controller gigabitethernet 12.2(33)SCE
show cmts ipc-cable client base service 12.2(33)SCF
show controllers cable jib 12.2(33)SCF
Modified Commands
Command Cisco IOS Software Release
show controllers cable 12.3(23)BC
show controllers modular-cable 12.3(23)BC5
show controllers jacket 12.2(33)SCB
show cr10k-rp controller 12.2(33)SCB
show cr10k-rp queue 12.2(33)SCB
show controllers modular-cable 12.3(23)BC6
show controllers cable 12.2(33)SCC
show controllers modular-cable 12.2(33)SCC
show controller integrated-cable 12.2(33)SCE
show controllers cable 12.2(33)SCE
show controllers modular-cable 12.2(33)SCE
show controllers cable 12.2(33)SCF
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1623
Cable Commands: show ch through show cr
Command Cisco IOS Software Release
show cr10k-rp controller 12.2(33)SCF
show controllers cable 12.2(33)SCG
show controllers modular-cable 12.2(33)SCG
Obsolete Commands
Command Effective Cisco IOS Release
show controllers cable upstream spectrum 12.3(21)BC
show cr10k-rp 12.2(33)SCB
show cr10k-rp service-flow ds 12.2(33)SCB
Cisco IOS CMTS Cable Command Reference
CBL-1624 OL-15510-15
Cable Commands: show ch through show cr
show checkpoint
show checkpoint
To display information about the Checkpoint Facility (CF) subsystem on a Cisco CMTS, use the show
checkpoint command in privileged EXEC mode.
show checkpoint {clients [client-id] | entities | statistics}
Syntax Description clients Displays a list of current checkpoint clients.
client-id (Optional) Particular client statistics.
entities Displays a list of current checkpoint entities.
statistics Displays the current status for checkpoint operations.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(11)BC3 This command was introduced to support High Availability (HA)
redundancy operations.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
Usage Guidelines The Checkpoint Facility (CF) subsystem manages the passing of messages from the Active to Standby
interfaces. It also handles sequencing and throttling, as needed during redundancy operations.
Checkpoint clients, such as line cards and other subsystems, register with the CF subsystem so that they
can update the Protect card or standby processor with state changes as necessary.
The show checkpoint command displays information about the clients (other processes on the CMTS
that are sending checkpoint messages), entities, and run-time status for checkpoint operations.
The show checkpoint clients client-id command displays information about the client with a particular
client ID.
Examples The following shows typical output for the show checkpoint clients command:
Router# show checkpoint clients
Check Point List of Clients
CHKPT on ACTIVE server.
Client Name Client ID Msg Send Msg len Bundling
(number of) (Total)
-----------------------------------------------------------
CHKPT DevTest 3 0 0 On
CHKPT EXAMPLE 2 0 0 On
CR10K RP CHKPT 20 0 0 On
Router#
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1625
Cable Commands: show ch through show cr
show checkpoint
The following shows typical output for the show checkpoint clients command with the client-id
parameter:
Router# show checkpoint clients 1
--------------------------------------------------------------------------------
Client Name Client Entity Bundle
ID ID Mode
--------------------------------------------------------------------------------
CHKPT Test client 1 -- On
Total API Messages Sent: 0
Total Transport Messages Sent: 0
Length of Sent Messages: 0
Total Blocked Messages Sent: 0
Length of Sent Blocked Messages: 0
Total Non-blocked Messages Sent: 0
Length of Sent Non-blocked Messages: 0
Total Messages Received: 0
Total Rcv Message Len: 0
Total Bytes Allocated: 0
Buffers Held: 0
Huge Buffers Requested: 0
Transport Frag Count: 0
Transport Frag Peak: 0
Transport Sends w/Flow Off: 0
Send Errs: 0
Send Peer Errs: 0
Rcv Xform Errs: 0
Xmit Xform Errs: 0
Incompatible Messages: 0
Client Unbundles to Process Memory: T
Router#
The following shows typical output for the show checkpoint entities command:
Router# show checkpoint entities
Check Point List of Entities
CHKPT on ACTIVE server.
--------------------------------------------------------------------------------
Entity Name Entity
ID
--------------------------------------------------------------------------------
UBR10k HA Entity Gro 4
Total API Messages Sent: 0
Total IPC Sent: 0
Total Message Len: 0
Total Bytes Allocated: 0
Cisco IOS CMTS Cable Command Reference
CBL-1626 OL-15510-15
Cable Commands: show ch through show cr
show checkpoint
The following shows typical output for the show checkpoint statistics command:
Router# show checkpoint statistics
Check Point Status
CHKPT on ACTIVE server.
Number of chkpt messages currently in hold queue 0
CHKPT MAX MTU size = 1422
IPC MAX MTU size = 4096
CHKPT Pending msg timer = 100 ms
Router#
Related Commands Command Description
hccp authentication Changes the minimum time between frequency hops.
hccp check version Exits bypass version mode, and returns to normal HCCP operation.
hccp ds-switch Specifies the downstream upconverter module for a Working CMTS or
Protect CMTS (deprecated command).
hccp protect Allows you to configure a Cisco CMTS to be a Protect CMTS for a specified
Working CMTS in a 1+1 redundancy environment.
hccp working Allows you to designate a Cisco CMTS to be a Working CMTS in a 1+1
redundancy environment.
show hccp Displays information for all cable interfaces on which one or more HCCP
groups and authentication modes have been configured.
show hccp interface Displays group information for a specific cable interface on which one or
more groups and authentication modes have been configured.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1627
Cable Commands: show ch through show cr
show cmts ipc-cable client base
show cmts ipc-cable client base
To display the interprocess communication (IPC) session status, the service information for all the slots
and subslots on the line cards, and statistics for each session on the Cisco uBR10012 router, use the show
cmts ipc-cable client base command in user EXEC or privileged EXEC mode.
show cmts ipc-cable client base {client | service | stats}
Syntax Description client Displays the IPC session status information.
service Displays all the IPC services for the slots and subslots on the
Cisco uBR10012 router.
stats Displays the IPC layer statistics information for every session.
Command Default No default behavior or values.
Command Modes User EXEC (>) or
Privileged EXEC (#)
Command History Release Modification
12.2(33)SCB This command was introduced.
12.2(33)SCF The service keyword was added to this command.
Usage Guidelines The show cmts ipc-cable client base client command displays the IPC session information for a group
of messages that are exchanged between a route processor (RP) and a line card or between two line cards.
This information includes the client ID, client name, IPC transport information, slot and subslot
information, session state to identify whether the session is ready for message exchange, number of
messages that are pending, and number of messages dropped.
The show cmts ipc-cable client base service command displays the IPC service information for all the
slots and subslots on the Cisco uBR10012 router. This information includes IPC port information, such
as type of service and port ID, retry and timeout information of the IPC messages, and watermark
information in the request queue.
The show cmts ipc-cable client base stats command displays the IPC layer error statistics for every
session and is used for internal debugging purposes. The error statistics information includes the client
ID, client name, transport type, slot and subslot information, client buffer, IPC layer state, error counter
information for the sent and received messages, and IPC In Service Software Upgrade (ISSU) register
information.
Cisco IOS CMTS Cable Command Reference
CBL-1628 OL-15510-15
Cable Commands: show ch through show cr
show cmts ipc-cable client base
Examples The following is a sample output of the show cmts ipc-cable client base client command:
Router# show cmts ipc-cable client base client
Client Id: 0 Name: CLNT DOCSIS
Slot/Subslot Seat ISSU Sid Connection State Ready Transport Msg-Pending Msg-D
ropped ISSU MTU
5/0 0x70000 17 RP-CLC Up Yes IPC 0 0
32
6/1 0x50000 65540 RP-CLC Up Yes IPC 0 0
32
8/0 0x60000 589827 RP-CLC Up Yes IPC 0 0
32
Client Id: 1 Name: CLNT HCCP
Slot/Subslot Seat ISSU Sid Connection State Ready Transport Msg-Pending Msg-D
ropped ISSU MTU
5/0 0x70000 17 RP-CLC Up Yes IPC 0 0
32
6/1 0x50000 65540 RP-CLC Up Yes IPC 0 0
32
8/0 0x60000 589827 RP-CLC Up Yes IPC 0 0
32
Client Id: 2 Name: CLNT PKTCBL
Slot/Subslot Seat ISSU Sid Connection State Ready Transport Msg-Pending Msg-D
ropped ISSU MTU
5/0 0x70000 17 RP-CLC Up Yes IPC 0 0
32
6/1 0x50000 65540 RP-CLC Up Yes IPC 0 0
32
8/0 0x60000 589827 RP-CLC Up Yes IPC 0 0
32
Client Id: 3 Name: CLNT PNEGO
Slot/Subslot Seat ISSU Sid Connection State Ready Transport Msg-Pending Msg-D
ropped ISSU MTU
5/0 0x70000 17 RP-CLC Up Yes IPC 0 0
32
6/1 0x50000 65540 RP-CLC Up Yes IPC 0 0
32
8/0 0x60000 589827 RP-CLC Up Yes IPC 0 0
32
Client Id: 4 Name: CLNT PLATFORM
Slot/Subslot Seat ISSU Sid Connection State Ready Transport Msg-Pending Msg-D
ropped ISSU MTU
5/0 0x70000 17 RP-CLC Up Yes IPC 0 0
32
6/1 0x50000 65540 RP-CLC Up Yes IPC 0 0
32
!
.
.
.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1629
Cable Commands: show ch through show cr
show cmts ipc-cable client base
Table 156 describes the significant fields shown in the display.
Table 156 show cmts ipc-cable client base client Field Descriptions
Field Description
Client Id ISSU client ID.
Name Client session name.
Slot/subslot Slot and subslot.
Seat IPC seat number for the session.
ISSU Sid ISSU application client session service identifier.
Connection Connection type.
State Connection state that is established.
Ready Readiness of the session.
Transport Transport stream that is used.
Msg-Pending Total number of messages waiting for acknowledgement.
Msd-Dropped Total number of messages dropped.
ISSU MTU IPC Maximum Transmission Unit (MTU) of the ISSU
session.
The following is a sample output of the show cmts ipc-cable client base service command:
Router# show cmts ipc-cable client base service
CMTS IPC service 1/0: default
ipc_port_info = 0x69390F4 ipc_port_id = A0000
retry_max = 20 retry_period = 1 rpc_timeout = 120
context = 0x6939164 pid = 399 name = ReqXmt 1/0: default
in_transit = 0 reqQ size = 0 inband = False
reqQ watermark low = 200 med = 500 high = 1000
resume_send = True block_done = False
CMTS IPC service 3/0: default
ipc_port_info = 0x6939084 ipc_port_id = B0000
retry_max = 20 retry_period = 1 rpc_timeout = 120
context = 0x6937FE4 pid = 405 name = ReqXmt 3/0: default
in_transit = 0 reqQ size = 0 inband = False
reqQ watermark low = 200 med = 500 high = 1000
resume_send = True block_done = False
CMTS IPC service 5/0: default
ipc_port_info = 0x465C0C14 ipc_port_id = D000A
retry_max = 20 retry_period = 1 rpc_timeout = 120
context = 0x6937874 pid = 420 name = ReqXmt 5/0: default
in_transit = 0 reqQ size = 0 inband = False
reqQ watermark low = 200 med = 500 high = 1000
resume_send = True block_done = True
CMTS IPC service 5/0: inband
ipc_port_info = 0xE6C7F50 ipc_port_id = D000B
retry_max = 20 retry_period = 1 rpc_timeout = 20
context = 0x6937644 pid = 424 name = ReqXmt 5/0: inband
in_transit = 0 reqQ size = 0 inband = True
reqQ watermark low = 200 med = 500 high = 1000
resume_send = False block_done = False
Cisco IOS CMTS Cable Command Reference
CBL-1630 OL-15510-15
Cable Commands: show ch through show cr
show cmts ipc-cable client base
CMTS IPC service 5/0: expedite
ipc_port_info = 0x34C3FA4 ipc_port_id = D000C
retry_max = 3 retry_period = 1 rpc_timeout = 5
context = 0x69380C4 pid = 353 name = ReqXmt 5/0: expedite
in_transit = 0 reqQ size = 0 inband = False
reqQ watermark low = 200 med = 500 high = 1000
resume_send = True block_done = False
CMTS IPC service 5/0: non critical
ipc_port_info = 0x4CFFBD34 ipc_port_id = D000D
retry_max = 3 retry_period = 10 rpc_timeout = 30
context = 0x6937954 pid = 419 name = ReqXmt 5/0: non critical
in_transit = 0 reqQ size = 0 inband = False
reqQ watermark low = 200 med = 500 high = 1000
resume_send = False block_done = False
CMTS IPC service 5/1: default
ipc_port_info = 0x6938134 ipc_port_id = C000A
retry_max = 20 retry_period = 1 rpc_timeout = 120
context = 0x69387C4 pid = 226 name = ReqXmt 5/1: default
in_transit = 0 reqQ size = 0 inband = False
reqQ watermark low = 200 med = 500 high = 1000
resume_send = True block_done = True
CMTS IPC service 5/1: inband
ipc_port_info = 0x34C1F4C ipc_port_id = C000B
retry_max = 20 retry_period = 1 rpc_timeout = 20
in_transit = 0 reqQ size = 0 inband = True
reqQ watermark low = 200 med = 500 high = 1000
resume_send = False block_done = False
CMTS IPC service 5/1: expedite
ipc_port_info = 0x2DFFF38 ipc_port_id = C000C
retry_max = 3 retry_period = 1 rpc_timeout = 5
context = 0x465B73D4 pid = 96 name = ReqXmt 5/1: expedite
in_transit = 0 reqQ size = 0 inband = False
reqQ watermark low = 200 med = 500 high = 1000
resume_send = True block_done = False
CMTS IPC service 5/1: non critical
ipc_port_info = 0x2E00100 ipc_port_id = C000D
retry_max = 3 retry_period = 10 rpc_timeout = 30
context = 0x465BE054 pid = 164 name = ReqXmt 5/1: non critical
in_transit = 0 reqQ size = 0 inband = False
reqQ watermark low = 200 med = 500 high = 1000
resume_send = False block_done = False
Table 157 describes the significant fields shown in the display.
Table 157 show cmts ipc-cable client base service Field Descriptions
Field Description
CMTS IPC service 1/0: default Slot and subslot. Describes the type of service—default,
inband, expedite, or non-critical.
ipc_port_info IPC port information.
ipc_port_id IPC port ID.
retry_max Maximum retries in Cisco IOS software IPC layer.
retry_period Time period of the retry interval in the IOS IPC layer.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1631
Cable Commands: show ch through show cr
show cmts ipc-cable client base
Table 157 show cmts ipc-cable client base service Field Descriptions (continued)
Field Description
rpc_timeout RPC timeout value.
context Context value.
pid Program identifier value.
name Type of IPC service.
in_transit Indicates total number of messages waiting for
acknowledgement
inband Inband service type.
reqQ size Size of the request queue.
reqQ watermark Threshold value of the queue.
resume_send IPC message sent is resumed.
block_done IPC message is blocked.
The following is a sample output of the show cmts ipc-cable client base stats command:
Router# show cmts ipc-cable client base stats
Client Id: 0 Name: CLNT DOCSIS
Slot/subslot: 5 /0 Transport Type = RP-CLC
IPC getbuffer fail : 0
IPC layer is down : 0
Sender msg has error : 0
Rcvd msg fail parser : 0
Sender drop - Misc. : 0
SID mgmt Q drop-No CM : 0
SID mgmt Q drop-Misc : 0
SID mgmt Q full : 0
SID mgmt Q drop-IF down: 0
IPC timeout : 0
IPC - no watch boolean : 0
Rcvd client no callback : 0
CR10K IPC Header transform error : 0
CR10K IPC ISSU send nego failed : 0
CR10K IPC ISSU not compatible : 0
CR10K IPC ISSU start nego failed : 0
CR10K IPC ISSU register failed : 0
Table 158 describes the significant fields shown in the display.
Table 158 show cmts ipc-cable client base stats Field Descriptions
Field Description
Client Id ISSU client ID.
Name Client session name.
Slot/subslot Slot and subslot.
Transport Type Transport type.
Related Commands
Cisco IOS CMTS Cable Command Reference
CBL-1632 OL-15510-15
Cable Commands: show ch through show cr
show cmts ipc-cable client base
Command Description
show cable ipc-stats Displays the statistics of all IPC messages on the Cisco CMTS router.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1633
Cable Commands: show ch through show cr
show controller gigabitethernet
show controller gigabitethernet
To display information about the Gigabit Ethernet interface used by the Downstream External PHY
Interface (DEPI), use the show controller gigabitethernet command in privileged EXEC mode.
show controller gigabitethernet slot/subslot/{bay | port}
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
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.
bay The bay in a SIP where a SPA is located. Valid values are 0 (upper bay) and
1 (lower bay).
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
Command Default None.
Command Modes Privilege EXEC
Command History Release Modification
12.2(33)SCE This command was introduced.
Examples This is a sample output for the show controller gigabitethernet command:
Router# show controller gigabitethernet 6/1/0
Cisco IOS CMTS Cable Command Reference
CBL-1634 OL-15510-15
Cable Commands: show ch through show cr
show controller gigabitethernet
DEPI INTERFACE : GigabitEthernet6/1/0
slot : 6
subunit : 256
unit : 0
slotunit : 24
type : 27
fci : 0x65D
ph_state : 0x6
MAC : 0013.5f06.7f74
status : 0x210040
status2 : 0x80200010
state : 0x4
encsz : 14
oir : 0x0
max_pak_size : 1524
visible_bw : 10000
visible_bw_def : 10000
IB CHANNEL : 3074
Port0 Status : 1
Port1 Status : 1
DS : 11B7A40C
Table 159 describes the significant fields shown in the display.
Table 159 show controller gigabitethernet Field Descriptions
Field Description
visible_bw Configured bandwidth for bypass traffic
IB CHANNEL Ironbus channel ID for bypass traffic
Port0 Status Status of GigE port 0
Port1 Status Status of GigE port 1
Related Commands Command Description
show controller ethernet Displays the hardware status of the backplane ethernet (BPE) device.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1635
Cable Commands: show ch through show cr
show controller integrated-cable
show controller integrated-cable
To view information about the Cisco UBR-MC20X20V or Cisco uBR-MC88V line card statistics, use
the show controller integrated-cable command in privileged EXEC mode.
show controller integrated-cable {slot/port | slot/subslot/port} [all | association | bpi-entry
bpi-index | brief | config | counters {rf-channel [rf-channel] | wb-channel [wb-channel]} |
errors | fpga_version | iofpga | mapping {rf-channel [rf-channel] | wb-channel
[wb-channel]} | registers | rf-channel [rf-channel] | status | wideband-channel [wb-channel] ]
Syntax Description slot/port | Identifies the cable interface on the Cisco uBR7225VXR,
slot/subslot/port Cisco uBR7246VXR, or Cisco uBR10012 router.
• 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.
– Cisco uBR10012 router: The valid range is from 5 to 8.
• subslot—Subslot where the line card resides. Available slots are 0 or 1.
This option is available on the Cisco uBR10012 router.
• port—Downstream port number on the line card.
– Cisco uBR10012 router: The valid range is from 0 to 4.
– Cisco uBR7246VXR and Cisco uBR7225VXR routers: The valid
port value is 0 or 1.
all (Optional) Displays the complete information about the line card statistics.
association (Optional) Displays the controller association information.
bpi-entry (Optional) Displays the controller Baseline Privacy Interface (BPI)
information.
• bpi-index—BPI index number. The valid range is from 0 to 24575.
brief (Optional) Displays brief information about the line card statistics.
config (Optional) Displays statistics about the JIB hardware and downstream PHY
configuration.
counters (Optional) Displays information about the RF and wideband (WB) channel
counters.
rf-channel Displays the RF channel information.
rf-channel (Optional) RF channel number. The valid range is from 0 to 3.
wb-channel Displays the wideband channel information.
wb-channel (Optional) Wideband channel number. The valid range is from 0 to 5.
errors (Optional) Displays information about the error counters, such as DOCSIS
processor error counters, BPI error counters, and queue manager error
counters.
fpga_version (Optional) Displays the FPGA version information.
iofpga (Optional) Displays the IOFPGA information.
mapping (Optional) Displays mapping statistics of the RF and WB channels.
registers (Optional) Displays the list of JIB hardware downstream register values.
Cisco IOS CMTS Cable Command Reference
CBL-1636 OL-15510-15
Cable Commands: show ch through show cr
show controller integrated-cable
status (Optional) Displays the JIB hardware and downstream PHY status.
wideband-channel (Optional) Displays the controller wideband cable information.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SCC This command was introduced.
12.2(33)SCD The command was modified. Added support for the Cisco uBR-MC88V line
card on Cisco uBR7246VXR and Cisco uBR7225VXR universal broadband
routers.
12.2(33)SCE This command was modified. The following optional keywords were added:
• fgpa_version
• iofpga
• rf-channel
• wideband-channel
Usage Guidelines This command allows the user to view the following line card statistics:
• Controller association
• JIB hardware downstream configuration
• Channel counters
• Errors
• Mapping of WB and RF channels
• JIB hardware downstream registers
• JIB hardware downstream status
Examples The following example shows a typical display of the show controller integrated-cable command and
the all keyword:
Router# show controllers integrated-Cable 6/0/0 all
Integrated Cable Controller 6/0/0:
----------------------------------
Channel 1 Annex = B Modulation = 256 QAM
Channel 2 Annex = B Modulation = 256 QAM
Channel 3 Annex = B Modulation = 256 QAM
Channel 4 Annex = B Modulation = 256 QAM
JIB3_DS BPI registers (base address 0xF8880000)
bpi_int_isr_0 [0x00000000] = 0x00000000
bpi_int_ier_0 [0x00000004] = 0x0000000F
glb_int_isr_0 [0x00000010] = 0x00000000
glb_int_ier_0 [0x00000014] = 0x000003FF
glb_int_isr_1 [0x00000020] = 0x00000000
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1637
Cable Commands: show ch through show cr
show controller integrated-cable
glb_int_ier_1 [0x00000024] = 0x000003FF
bpi_int_fesr_0 [0x00000040] = 0x00000000
bpi_tst_tp_sel_reg [0x00000050] = 0x00000000
bpi_tst_tp_reg [0x00000054] = 0x00000000
bpi_cnt_good_packet_in_cnt [0x00000064] = 0x61308806
bpi_cnt_bad_packet_in_cnt [0x00000068] = 0x00006538
bpi_cnt_good_packet_out_cnt [0x0000006C] = 0x61308806
bpi_cnt_bad_packet_out_cnt [0x00000070] = 0x00006538
bpi_ecc_sbit_err_cnt [0x00000074] = 0x00000000
glb_sw_rev_id [0x00000078] = 0x00020002
glb_hw_rev_id [0x0000007C] = 0x00010008
frz_reg [0x00000080] = 0x00000000
frz_en [0x00000084] = 0x00000001
glb_dcm_status [0x00000088] = 0x00000007
glb_sw_rst [0x0000008C] = 0x00000000
JIB3_DS ERP registers (base address 0xF8881000)
erp_irq_src_reg [0x00000000] = 0x00000000
erp_irq_en_reg [0x00000004] = 0x80000FFF
erp_tp_sel_reg [0x00000050] = 0x00000000
erp_tp_reg [0x00000054] = 0x00000000
erp_cfg_reg [0x00000060] = 0x00000000
erp_err_record_reg [0x00000064] = 0x00000000
erp_err_addr_record_reg [0x00000068] = 0x00000000
erp_err_wd_record_reg [0x0000006C] = 0x00000000
erp_proc_err_addr_record_reg [0x00000090] = 0x00000000
JIB3_DS RX SPI registers (base address 0xF8882000)
rxspi_irq_src_reg [0x00000000] = 0x00000000
rxspi_irq_en_reg [0x00000004] = 0x000001FF
rxspi_ferr_src_reg [0x00000040] = 0x00000000
rxspi_testpoint_sel_reg [0x00000050] = 0x00000000
rxspi_testpoint_reg [0x00000054] = 0x00000000
rxspi_rst_cntl_reg [0x00000060] = 0x00000000
rxspi_cntl_status_reg [0x00000064] = 0x00000005
rxspi_cfg_cntl_reg [0x00000068] = 0x00000021
rxspi_afthres_reg [0x0000006C] = 0x01C00180
rxspi_cal_dur_reg [0x00000070] = 0x00030000
rxspi_non_drop_err_cnt_reg [0x00000088] = 0x00000000
rxspi_drop_byte_cnt_reg [0x0000008C] = 0x00000000
rxspi_rx_byte_cnt_reg[0] [0x000000B0] = 0xFFFFFFFF
rxspi_rx_byte_cnt_reg[1] [0x000000B4] = 0xFFFFFFFF
rxspi_rx_byte_cnt_reg[2] [0x000000B8] = 0x14B49467
rxspi_rx_pkt_cnt_reg[0] [0x000000C0] = 0x3FF2F36C
rxspi_rx_pkt_cnt_reg[1] [0x000000C4] = 0x20F3AFA9
rxspi_rx_pkt_cnt_reg[2] [0x000000C8] = 0x004A4A35
rxspi_fifo_pkt_drop_cnt_reg[0] [0x000000E0] = 0x00000000
rxspi_fifo_pkt_drop_cnt_reg[1] [0x000000E4] = 0x00000000
rxspi_fifo_pkt_drop_cnt_reg[2] [0x000000E8] = 0x00000000
rxspi_calendar_table_reg[0] [0x00000800] = 0x00000000
rxspi_calendar_table_reg[1] [0x00000804] = 0x00000001
rxspi_calendar_table_reg[2] [0x00000808] = 0x00000002
rxspi_calendar_table_reg[3] [0x0000080C] = 0x00000003
JIB3_DS TX SPI registers (base address 0xF8883000)
txspi_irq_src_reg [0x00000000] = 0x00000000
txspi_irq_en_reg [0x00000004] = 0x0000001F
txspi_ferr_src_reg [0x00000040] = 0x00000000
txspi_testpoint_sel_reg [0x00000050] = 0x00000000
txspi_testpoint_reg [0x00000054] = 0x00000000
txspi_rst_cntl_reg [0x00000060] = 0x00000000
Cisco IOS CMTS Cable Command Reference
CBL-1638 OL-15510-15
Cable Commands: show ch through show cr
show controller integrated-cable
txspi_cntl_status_reg [0x00000064] = 0x00000009
txspi_cfg_cntl_reg [0x00000068] = 0x00000001
txspi_afthres_reg [0x0000006C] = 0x01EC01E8
txspi_cal_dur_reg [0x00000070] = 0x00040000
txspi_train_cntl_reg [0x00000074] = 0x00000000
txspi_nonfatalerr_cnt_reg [0x00000080] = 0x00000000
txspi_eop_abort_pkt_cnt_reg[0] [0x00000090] = 0x00000000
txspi_eop_abort_pkt_cnt_reg[1] [0x00000094] = 0x00000000
txspi_eop_abort_pkt_cnt_reg[2] [0x00000098] = 0x00000000
txspi_eop_abort_pkt_cnt_reg[3] [0x0000009C] = 0x00000000
txspi_eop_abort_byte_cnt_reg[0] [0x000000A0] = 0x00000000
txspi_eop_abort_byte_cnt_reg[1] [0x000000A4] = 0x00000000
txspi_eop_abort_byte_cnt_reg[2] [0x000000A8] = 0x00000000
txspi_eop_abort_byte_cnt_reg[3] [0x000000AC] = 0x00000000
txspi_tx_byte_cnt_reg[0] [0x000000C0] = 0x00000000
txspi_tx_byte_cnt_reg[1] [0x000000C4] = 0x00000000
txspi_tx_byte_cnt_reg[2] [0x000000C8] = 0x00000000
txspi_tx_byte_cnt_reg[3] [0x000000CC] = 0x00000000
txspi_tx_pkt_cnt_reg[0] [0x00000100] = 0x00000000
txspi_tx_pkt_cnt_reg[1] [0x00000104] = 0x00000000
txspi_tx_pkt_cnt_reg[2] [0x00000108] = 0x00000000
txspi_tx_pkt_cnt_reg[3] [0x0000010C] = 0x00000000
txspi_calendar_table_reg[0] [0x00000800] = 0x00000000
txspi_calendar_table_reg[1] [0x00000804] = 0x00000001
txspi_calendar_table_reg[2] [0x00000808] = 0x00000002
txspi_calendar_table_reg[3] [0x0000080C] = 0x00000003
txspi_calendar_table_reg[4] [0x00000810] = 0x00000004
JIB3_DS DOC registers (base address 0xF8884000)
doc_int_err0 [0x00000000] = 0x00000000
doc_int_err0_ier [0x00000004] = 0xFFBFBFFD
doc_int_err1 [0x00000010] = 0x00000000
doc_int_err1_ier [0x00000014] = 0x003FFFF8
doc_int_fesr [0x00000040] = 0x00000000
doc_test_sel [0x00000050] = 0x00000000
doc_testpoint [0x00000054] = 0x00000000
doc_cfg_ctrl [0x00000060] = 0x031A0000
doc_err_cap_ctrl [0x00000064] = 0x001F0001
doc_err_cap_addr [0x00000068] = 0x00000000
doc_err_cap_data [0x0000006C] = 0x000080F7
doc_seg_num [0x00000070] = 0x00000001
doc_wb_chan_stats_sel [0x00000074] = 0x00000077
doc_wb_pkt_cnt [0x00000078] = 0x00000000
doc_wb_byte_cnt [0x0000007C] = 0x00000000
doc_wb_police_sel [0x00000080] = 0x00000000
doc_wb_police_data [0x00000084] = 0x00000000
doc_wb_police_intv [0x00000088] = 0x00000000
doc_nb_chan_stats_sel [0x0000008C] = 0x0000004C
doc_nb_pkt_cnt [0x00000090] = 0x00000000
doc_nb_byte_cnt [0x00000094] = 0x00000000
doc_nb_police_sel [0x00000098] = 0x00000000
doc_nb_police_data [0x0000009C] = 0x00000000
doc_nb_police_intv [0x000000A0] = 0x00000000
doc_int_doc_cnt [0x000000D4] = 0x00000000
doc_int_ecc_sbiterr_cnt [0x000000D8] = 0x00000000
doc_pkt_good_in_cnt [0x000000DC] = 0x6130ED6F
doc_pkt_good_out_cnt [0x000000E0] = 0x61308837
doc_pkt_err_in_cnt [0x000000E4] = 0x00000000
doc_pkt_err_out_cnt [0x000000E8] = 0x00006538
doc_pkt_drop_cnt [0x000000EC] = 0x00000000
doc_efc_all_cnt [0x000000F0] = 0x00000000
doc_efc_hi_cnt [0x000000F4] = 0x00000000
doc_efc_me_cnt [0x000000F8] = 0x00000000
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1639
Cable Commands: show ch through show cr
show controller integrated-cable
doc_efc_lo_cnt [0x000000FC] = 0x00000000
doc_efc_ch_sel [0x00000100] = 0x00000000
doc_efc_debug_ctrl [0x00000104] = 0x00000000
doc_rldram_ext_ecc [0x00000114] = 0x00000000
doc_rldram_cfg [0x00000118] = 0x00101544
doc_rldram_ctrl [0x0000011C] = 0x00100389
doc_rldram_status [0x00000120] = 0x039D7403
doc_rldram_blk_clr [0x00000124] = 0x0B7FFFFF
doc_rldram_cal_match_win_h [0x00000128] = 0x00000000
doc_rldram_cal_match_win_l [0x0000012C] = 0x1FFFFFFF
doc_rldram_ecc_err_rec_addr [0x00000130] = 0x00000000
doc_magic_num_err_pkt_ctrl [0x00000150] = 0x00000000
doc_magic_num_err_pkt_addr [0x00000154] = 0x00000000
doc_magic_num_err_pkt_data [0x00000158] = 0x00000000
JIB3_DS RIF registers (base address 0xF8885000)
rif_int_err0 [0x00000000] = 0x00000000
rif_int_ier0 [0x00000004] = 0x00000007
rif_int_fesr0 [0x00000040] = 0x00000000
rif_tp_sel [0x00000050] = 0x00000000
rif_tp [0x00000054] = 0x00000000
rif_cfg_ctrl [0x00000060] = 0x00000000
rif_cnt_in_mpeg_cnt [0x00000064] = 0xFFFFFFFF
rif_cnt_out_good_mpeg_cnt [0x00000068] = 0xFFFFFFFF
rif_cnt_out_bad_mpeg_cnt [0x0000006C] = 0x00000000
rif_cnt_drop_mpeg_cnt [0x00000070] = 0x00000000
rif_1bit_ecc_err_stat [0x00000074] = 0x00000000
JIB3_DS RTN registers (base address 0xF8886000)
return_int_isr [0x00000000] = 0x00000000
return_int_ier [0x00000004] = 0x000001FF
return_int_fesr [0x00000040] = 0x00000000
return_tp_sel [0x00000050] = 0x00000000
return_tp [0x00000054] = 0x00000000
return_ctrl_reg [0x00000060] = 0x00000000
return_pif_loopback_chnl [0x00000064] = 0x00000000
return_sniffer_nonbonded_en [0x00000068] = 0x00000000
return_sniffer_bonded_en [0x0000006C] = 0x00000000
return_spi_chnl_sel [0x00000070] = 0x0000013A
return_err_drop_en [0x00000074] = 0x0000000F
return_snf_macda_cfg_addr [0x00000078] = 0x00000000
return_snf_macda_cfg_data_hi [0x0000007C] = 0x00000000
return_snf_macda_cfg_data_lo [0x00000080] = 0x00000000
return_in_pifrx_good_cnt [0x000000A0] = 0x00000000
return_in_pifrx_bad_cnt [0x000000A4] = 0x00000000
return_in_piflp_good_cnt [0x000000A8] = 0xFFFFFFFF
return_in_piflp_bad_cnt [0x000000AC] = 0x00000000
return_in_sniffer_good_cnt [0x000000B0] = 0x61308845
return_in_sniffer_bad_cnt [0x000000B4] = 0x00006538
return_in_spi_loop_good_cnt [0x000000B8] = 0x00000000
return_in_spi_loop_bad_cnt [0x000000BC] = 0x00000000
return_out_spi0_cnt [0x000000C0] = 0x00000000
return_out_spi1_cnt [0x000000C4] = 0x00000000
return_out_spi2_cnt [0x000000C8] = 0x00000000
return_out_spi3_cnt [0x000000CC] = 0x00000000
return_out_spi4_cnt [0x000000D0] = 0x00000000
return_pifrx_if_par_err_drop_cnt [0x000000D4] = 0x00000000
return_pifrx_if_len_err_drop_cnt [0x000000D8] = 0x00000000
return_piflp_if_err_drop_cnt [0x000000DC] = 0x00000000
return_piflp_if_chnl_drop_cnt [0x000000E0] = 0x00000000
return_snf_pb_err_drop_cnt [0x000000E4] = 0x00006538
return_snf_pkt_type_err_drop_cnt [0x000000E8] = 0x61308845
Cisco IOS CMTS Cable Command Reference
CBL-1640 OL-15510-15
Cable Commands: show ch through show cr
show controller integrated-cable
return_spilp_if_err_drop_cnt [0x000000EC] = 0x00000000
return_pifrx_traffic_mux_drop_cnt [0x000000F0] = 0x00000000
return_piflp_traffic_mux_drop_cnt [0x000000F4] = 0x00000000
return_snf_traffic_mux_drop_cnt [0x000000F8] = 0x00000000
return_spilp_traffic_mux_drop_cnt [0x000000FC] = 0x00000000
return_pifrx_fifo_overflow_drop_cnt [0x00000100] = 0x00000000
return_piflp_fifo_overflow_drop_cnt [0x00000104] = 0x00000000
return_snf_fifo_overflow_drop_cnt [0x00000108] = 0x00000000
return_spilp_fifo_overflow_drop_cnt [0x0000010C] = 0x00000000
return_pifrx_if_par_err_cnt [0x00000110] = 0x00000000
return_pifrx_if_len_err_cnt [0x00000114] = 0x00000000
return_pifrx_fifo_ecc_1berr_cnt [0x00000118] = 0x00000000
return_piflp_fifo_ecc_1berr_cnt [0x0000011C] = 0x00000000
return_snf_fifo_ecc_1berr_cnt [0x00000120] = 0x00000000
return_spilp_fifo_ecc_1berr_cnt [0x00000124] = 0x00000000
JIB3_DS DLM registers (base address 0xF8890000)
dlm_int_isr_0 [0x00000000] = 0x00000005
dlm_int_ier_0 [0x00000004] = 0x00000000
dlm_cnt_local_ts_reg [0x00000064] = 0x5B00EB07
dlm_cfg_tss_comp_reg [0x00000068] = 0x00000027
dlm_cfg_tss_ctrl_reg [0x0000006C] = 0x00000000
dlm_cfg_tss_cmd_reg [0x00000070] = 0x00000000
dlm_cnt_ts_load_cnt [0x000000BC] = 0x00000000
dlm_cnt_ts_chk_failed_cnt [0x000000C4] = 0x00000000
dlm_cnt_tss_perr_cnt [0x000000C8] = 0x00000000
dlm_cnt_load_ts_reg [0x000000D0] = 0x003F52EF
JIB3_DS SEQ registers (base address 0xF8892000)
seq_int_err0 [0x00000000] = 0x0000000F
seq_int_ier0 [0x00000004] = 0x000FFFFF
seq_int_err3 [0x00000030] = 0x00000000
seq_int_ier3 [0x00000034] = 0x00000001
seq_int_fatal_err [0x00000040] = 0x00000000
seq_tp_sel [0x00000050] = 0x00000000
seq_tp [0x00000054] = 0x00000000
seq_cfg_en [0x00000060] = 0x00000001
seq_cfg_sync_timer_sel [0x00000064] = 0x00000004
seq_cfg_sync_timer_data [0x00000068] = 0x00000000
seq_cfg_sync_sa_sel [0x0000006C] = 0x00000004
seq_cfg_sync_sa_data_lo [0x00000070] = 0x70CC0B91
seq_cfg_sync_sa_data_hi [0x00000074] = 0x00000000
seq_cfg_tkb_timer_sel [0x00000078] = 0x00000014
seq_cfg_tkb_timer_data [0x0000007C] = 0x00000000
seq_cfg_tkb_max [0x00000080] = 0x00000000
seq_hwdbg_dpv_proc_table_addr [0x00000090] = 0x00000000
seq_hwdbg_dpv_ptr_mod_table [0x00000094] = 0x00000000
seq_hwdbg_dpv_timestamp_table [0x00000098] = 0x00000000
seq_hwdbg_dpv_hcs_table [0x0000009C] = 0x00000000
seq_cnt_blkram_oecc_err_stat [0x000000A4] = 0x00000000
seq_cnt_tran_mpeg_stat [0x000000A8] = 0xFFFFFFFF
seq_cnt_tran_mpeg_sync_stat [0x000000AC] = 0x00000000
seq_cnt_tran_only_sync_stat [0x000000B0] = 0x00000000
seq_cnt_tran_dpv_stat [0x000000B8] = 0x00000000
JIB3_DS QM registers (base address 0xF8893000)
qm_int_isr0 [0x00000000] = 0x00000000
qm_int_ier0 [0x00000004] = 0x0000007F
qm_int_isr1 [0x00000010] = 0x00000000
qm_int_ier1 [0x00000014] = 0x000FFFFF
qm_int_fat_err_isr [0x00000040] = 0x00000000
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1641
Cable Commands: show ch through show cr
show controller integrated-cable
qm_tst_tp_sel [0x00000050] = 0x00000000
qm_tst_tp [0x00000054] = 0x00000000
qm_cfg_chnl_rst_0 [0x00000060] = 0x00000000
qm_cfg_ctl [0x0000006C] = 0x00000011
qm_cfg_sqf_fac_addr [0x0000008C] = 0x00000014
qm_cfg_sqf_fac_data [0x00000090] = 0x00000000
qm_cfg_bond_chnl_map_addr [0x00000094] = 0x00000020
qm_cfg_bond_chnl_map_data_lo [0x00000098] = 0x00000000
qm_cfg_flt_thr_addr [0x000000A4] = 0x0000024F
qm_cfg_flt_thr_data [0x000000A8] = 0x00000000
qm_cfg_repl_addr [0x000000AC] = 0x0000002D
qm_cfg_repl_data_lo [0x000000B0] = 0x00000000
qm_hwdbg_buf_mag_addr [0x000000BC] = 0x00000000
qm_hwdbg_wptr_data_lo [0x000000C0] = 0x00000C60
qm_hwdbg_wptr_data_mi [0x000000C4] = 0x00016080
qm_hwdbg_wptr_data_hi [0x000000C8] = 0x000012A0
qm_hwdbg_rptr_data_lo [0x000000CC] = 0x00000C60
qm_hwdbg_rptr_data_mi [0x000000D0] = 0x00016080
qm_hwdbg_rptr_data_hi [0x000000D4] = 0x000012A0
qm_hwdbg_qulen_data_lo [0x000000D8] = 0x00000000
qm_hwdbg_qulen_data_mi [0x000000DC] = 0x00000000
qm_hwdbg_qulen_data_hi [0x000000E0] = 0x00000000
qm_hwdbg_contex_data [0x000000E4] = 0x00000000
qm_cfg_dir_stat_addr [0x000000E8] = 0x0000004E
qm_cnt_dir_pkt_stat [0x000000EC] = 0x00000000
qm_cnt_dir_byte_stat [0x000000F0] = 0x00000000
qm_cfg_qam_stat_addr [0x000000F4] = 0x0000004C
qm_cnt_qam_chnl_pkt_stat [0x000000F8] = 0x00000000
qm_cnt_qam_chnl_byte_stat [0x000000FC] = 0x00000000
qm_cnt_qam_chnl_sync_stat [0x00000100] = 0x00000000
qm_cnt_bpram_ovrflw_stat [0x00000108] = 0x00000000
qm_cnt_que_ovrflw_stat [0x0000010C] = 0x00000000
qm_cnt_good_bpi_pkt_stat [0x00000110] = 0x6130886C
qm_cnt_bad_bpi_pkt_stat [0x00000114] = 0x000000FF
qm_cnt_bpram_out_good_pkt_stat [0x0000011C] = 0xC38C8639
qm_cnt_bpram_out_dir_pkt_stat [0x00000120] = 0x213DFA0E
qm_cnt_bpram_out_bonded_pkt_stat [0x00000124] = 0x3486CDA6
qm_cnt_replicated_pkt_stat [0x00000128] = 0x8399F7DB
qm_cnt_bpram_bad_type_pkt_stat [0x00000134] = 0x00000000
qm_cnt_bpram_bad_eop_pkt_stat [0x00000138] = 0x00000000
qm_cnt_bpram_bad_dir_pkt_stat [0x0000013C] = 0x00000000
qm_cnt_bpram_bad_bonded_pkt_stat [0x00000140] = 0x00000000
qm_cnt_bpram_oecc_err_pkt_stat [0x00000144] = 0x00000000
qm_cnt_bpram_bad_pkt_stat [0x00000148] = 0x000000FF
qm_cnt_wr_good_pkt_stat [0x0000014C] = 0xC38C863A
qm_cnt_wr_bad_pkt_stat [0x00000150] = 0x00000000
qm_cnt_drop_bad_pkt_stat [0x00000154] = 0x000000FF
qm_cnt_drop_ovrflw_pkt_stat [0x00000158] = 0x00000000
qm_cnt_rd_pkt_stat [0x0000015C] = 0xC38C8664
qm_cnt_rd_mpeg_stat [0x00000160] = 0xFFFFFFFF
qm_cnt_rd_mpeg_sync_stat [0x00000164] = 0x06A0FC65
qm_cnt_rd_mpeg_only_sync_stat [0x00000168] = 0x0620376C
qm_cnt_tran_pkt_stat [0x00000170] = 0xC38C8664
qm_cnt_tran_oecc_err_pkt_stat [0x00000174] = 0x00000000
qm_cnt_tran_mpeg_stat [0x00000178] = 0xFFFFFFFF
qm_cnt_tran_mpeg_sync_stat [0x0000017C] = 0x06A0FC65
qm_cnt_tran_mpeg_only_sync_stat [0x00000180] = 0x0620376C
qm_cnt_tran_dpv_stat [0x00000188] = 0x00000000
qm_rldram_ext_ecc [0x00000198] = 0x00000000
qm_rldram_cfg [0x0000019C] = 0x00101544
qm_rldram_ctrl [0x000001A0] = 0x00100389
qm_rldram_status [0x000001A4] = 0x03DF7C03
qm_rldram_cal_match_win_h [0x000001A8] = 0x00000000
qm_rldram_cal_match_win_l [0x000001AC] = 0x7FFFFFFF
Cisco IOS CMTS Cable Command Reference
CBL-1642 OL-15510-15
Cable Commands: show ch through show cr
show controller integrated-cable
JIB3_DS PG registers (base address 0xF8898000)
pg_mod [0x00000050] = 0x00000000
pg_dhs [0x00000054] = 0x00000000
pg_ipg [0x0000005C] = 0x00000000
pg_num [0x00000058] = 0x00000000
pg_payload_length [0x00000060] = 0x00000000
pg_payload_value [0x00000064] = 0x00000000
pg_pkt_hdr_prog_0 [0x00000068] = 0x00000000
pg_pkt_hdr_prog_1 [0x0000006C] = 0x00000000
pg_pkt_hdr_1 [0x00000070] = 0x00000000
pg_pkt_hdr_2 [0x00000074] = 0x00000000
pg_pkt_hdr_3 [0x00000078] = 0x00000000
pg_pkt_hdr_4 [0x0000007C] = 0x00000000
pg_pkt_hdr_5 [0x00000080] = 0x00000000
pg_pkt_hdr_6 [0x00000084] = 0x00000000
JIB3_DS PMBIST registers (base address 0xF8899000)
pmbist_ena_addr [0x00000060] = 0x00000002
pmbist_din_addr [0x00000064] = 0x00000000
pmbist_dout_addr [0x0000006C] = 0x00008101
pmbist_trgt_select_addr [0x00000074] = 0x00000000
pmbist_ff_status [0x00000078] = 0x00000000
pmbist_num_wr_fr_pmbist [0x0000007C] = 0x00000000
pmbist_num_rd_fr_pmbist [0x00000080] = 0x00000000
pmbist_um_wr_2cmd_ff [0x00000084] = 0x00000000
pmbist_num_rd_2cmd_ff [0x00000088] = 0x00000000
pmbist_num_rd_rtn_pmbist [0x0000008C] = 0x00000000
pmbist_num_wr_2dram [0x00000090] = 0x00000000
pmbist_num_rd_2dram [0x00000094] = 0x00000000
pmbist_num_rd_fr_dram [0x00000098] = 0x00000000
DS PHY Configuration of Controller 0:
---------------------
Base Frequency = 555000000Hz
RF-Power = 52.0dBmV
Annex = B Modulation = 256QAM
Channel Status Interleave
------- ------ ----------
0 Active 32
1 Active 32
2 Active 32
3 Active 32
DS_PHY PLL set for Annex-B
DS PHY Device Information:
-------------------
Remora Version = 3.10
UPX SW Version = 0x10D
Upconverter Type:Unknown
UPX Part Number =
Device Status:
--------------
UPX Alarm Status = 0x3FF
UPX Alarm Mask = 0x19000
Remora registers (base address 0xF8900000)
------------------------------------------
Remora General Registers (0xF8900000):
--------------------------------------
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1643
Cable Commands: show ch through show cr
show controller integrated-cable
revision [0x00000000] = 0x00000003
hw_fpga_rev_id [0x00000004] = 0x0000000A
erp_scratch_pad0 [0x00000008] = 0x00000000
erp_scratch_pad1 [0x0000000C] = 0x00000000
Remora Reset and DCM Lock Registers (0xF8900100):
-----------------------------------------------
reset_ctrl [0x00000100] = 0x00000000
dcm_lock [0x00000104] = 0x0000000F
Remora Configuration Registers (0xF8900200):
--------------------------------------------
port_cfg[0] [0x00000200] = 0x00155549
port_cfg[1] [0x00000204] = 0x00155548
port_cfg[2] [0x00000208] = 0x00155548
port_cfg[3] [0x0000020C] = 0x00155548
port_cfg[4] [0x00000210] = 0x00155548
core_config_status [0x00000214] = 0x00000020
port_rm2tififo_prog_flags[0] [0x00000218] = 0xBBA20C0D
port_rm2tififo_prog_flags[1] [0x0000021C] = 0xBBA20C0D
port_rm2tififo_prog_flags[2] [0x00000220] = 0xBBA20C0D
port_rm2tififo_prog_flags[3] [0x00000224] = 0xBBA20C0D
port_rm2tififo_prog_flags[4] [0x00000228] = 0xBBA20C0D
Remora DFT/Pattern Inject Registers (0xF8900300):
-------------------------------------------------
alt_sym_tst_mode [0x00000300] = 0x00005A69
alt_sym_tst_en_reg [0x00000304] = 0x00000000
qdr_mem_test_en_reg [0x00000308] = 0x00000000
qdr_mem_test_rd_wr_reg [0x0000030C] = 0x00000A12
ready_for_data_input [0x00000318] = 0x0000001F
Remora ECC Registers (0xF8900400):
----------------------------------
debug_cfg [0x00000400] = 0x00000000
sniff_frame_cnt [0x00000404] = 0x00000000
ecc_parity_conf_reg [0x00000408] = 0x00000003
ecc_uncorrect_data_log_reg [0x0000040C] = 0x00002814
ecc_uncorrect_log_reg [0x00000410] = 0x00000020
ecc_correctable_data_log_reg [0x00000414] = 0x00002C14
ecc_correctable_log_reg [0x00000418] = 0x00000028
qdr_ecc_corr_cnt_reg [0x0000041C] = 0x00000000
fatal_err_log [0x00000420] = 0x00000000
err_inj_reg [0x00000424] = 0x00000000
Remora QDR Registers (0xF8900500):
----------------------------------
qdr_phy_idelayctrl_rst_reg [0x00000500] = 0x00000000
qdr_phy_idelayctrl_rdy_err_reg [0x00000504] = 0x00000261
qdr_phy_cal_tap_dly_reg [0x00000508] = 0x00000ADB
qdr_phy_idelayctrl_ctrl_reg [0x0000050C] = 0x00000002
qdr_init_ctrl_reg [0x00000510] = 0x801FFFFF
Remora Interrupt Status Registers (0xF8900600):
-----------------------------------------------
glb_int_stat_reg [0x00000600] = 0x00000000
int_stat_gr_reg[0] [0x00000604] = 0x00000000
int_stat_gr_reg[1] [0x00000608] = 0x00000000
int_stat_gr_reg[2] [0x0000060C] = 0x00000000
int_stat_gr_reg[3] [0x00000610] = 0x00000000
int_stat_gr_reg[4] [0x00000614] = 0x00000000
misc_int_stat_reg [0x00000618] = 0x00000001
fatal_err_src_reg [0x0000061C] = 0x00000000
port_local_interrupt_enable[0] [0x00000620] = 0x0001FFFF
Cisco IOS CMTS Cable Command Reference
CBL-1644 OL-15510-15
Cable Commands: show ch through show cr
show controller integrated-cable
port_local_interrupt_enable[1] [0x00000624] = 0x0001FFFF
port_local_interrupt_enable[2] [0x00000628] = 0x0001FFFF
port_local_interrupt_enable[3] [0x0000062C] = 0x0001FFFF
port_local_interrupt_enable[4] [0x00000630] = 0x0001FFFF
misc_int_en_reg [0x00000634] = 0x00001FF8
fatal_err_en_reg [0x00000638] = 0x00000EFF
port_local_interrupt_override[0] [0x0000063C] = 0x00000000
port_local_interrupt_override[1] [0x00000640] = 0x00000000
port_local_interrupt_override[2] [0x00000644] = 0x00000000
port_local_interrupt_override[3] [0x00000648] = 0x00000000
port_local_interrupt_override[4] [0x0000064C] = 0x00000000
misc_int_override [0x00000650] = 0x00000000
fatal_err_override [0x00000654] = 0x00000000
Remora Counts Registers (0xF8900800):
-------------------------------------
illegal_ch_num_pkt_drop_count [0x00000800] = 0x00000000
fifo_full_mpeg_pkt_drop_count_hi [0x00000804] = 0x00000000
fifo_full_mpeg_pkt_drop_count_lo [0x00000808] = 0x00000000
channel_mpeg_pkt_count[0] [0x0000080C] = 0x00000EE7
channel_mpeg_pkt_count[1] [0x00000810] = 0x00000E8C
channel_mpeg_pkt_count[2] [0x00000814] = 0x00000839
channel_mpeg_pkt_count[3] [0x00000818] = 0x000009DF
channel_mpeg_pkt_count[4] [0x0000081C] = 0x00000000
channel_mpeg_pkt_count[5] [0x00000820] = 0x00000000
channel_mpeg_pkt_count[6] [0x00000824] = 0x00000000
channel_mpeg_pkt_count[7] [0x00000828] = 0x00000000
channel_mpeg_pkt_count[8] [0x0000082C] = 0x00000000
channel_mpeg_pkt_count[9] [0x00000830] = 0x00000000
channel_mpeg_pkt_count[10] [0x00000834] = 0x00000000
channel_mpeg_pkt_count[11] [0x00000838] = 0x00000000
channel_mpeg_pkt_count[12] [0x0000083C] = 0x00000000
channel_mpeg_pkt_count[13] [0x00000840] = 0x00000000
channel_mpeg_pkt_count[14] [0x00000844] = 0x00000000
channel_mpeg_pkt_count[15] [0x00000848] = 0x00000000
channel_mpeg_pkt_count[16] [0x0000084C] = 0x00000000
channel_mpeg_pkt_count[17] [0x00000850] = 0x00000000
channel_mpeg_pkt_count[18] [0x00000854] = 0x00000000
channel_mpeg_pkt_count[19] [0x00000858] = 0x00000000
port_re_timestamp_count[0] [0x0000085C] = 0x97979796
port_re_timestamp_count[1] [0x00000860] = 0x00000000
port_re_timestamp_count[2] [0x00000864] = 0x00000000
port_re_timestamp_count[3] [0x00000868] = 0x00000000
port_re_timestamp_count[4] [0x0000086C] = 0x00000000
port_rx_fifo_overflow_drop_count[0] [0x00000870] = 0x00000000
port_rx_fifo_overflow_drop_count[1] [0x00000874] = 0x00000000
port_rx_fifo_overflow_drop_count[2] [0x00000878] = 0x00000000
port_rx_fifo_overflow_drop_count[3] [0x0000087C] = 0x00000000
port_rx_fifo_overflow_drop_count[4] [0x00000880] = 0x00000000
channel_jib_if_pkt_count[0] [0x00000884] = 0x4AFC8612
channel_jib_if_pkt_count[1] [0x00000888] = 0x44C96772
channel_jib_if_pkt_count[2] [0x0000088C] = 0x42A048EA
channel_jib_if_pkt_count[3] [0x00000890] = 0x43E61FF6
channel_jib_if_pkt_count[4] [0x00000894] = 0x00000000
channel_jib_if_pkt_count[5] [0x00000898] = 0x00000000
channel_jib_if_pkt_count[6] [0x0000089C] = 0x00000000
channel_jib_if_pkt_count[7] [0x000008A0] = 0x00000000
channel_jib_if_pkt_count[8] [0x000008A4] = 0x00000000
channel_jib_if_pkt_count[9] [0x000008A8] = 0x00000000
channel_jib_if_pkt_count[10] [0x000008AC] = 0x00000000
channel_jib_if_pkt_count[11] [0x000008B0] = 0x00000000
channel_jib_if_pkt_count[12] [0x000008B4] = 0x00000000
channel_jib_if_pkt_count[13] [0x000008B8] = 0x00000000
channel_jib_if_pkt_count[14] [0x000008BC] = 0x00000000
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1645
Cable Commands: show ch through show cr
show controller integrated-cable
channel_jib_if_pkt_count[15] [0x000008C0] = 0x00000000
channel_jib_if_pkt_count[16] [0x000008C4] = 0x00000000
channel_jib_if_pkt_count[17] [0x000008C8] = 0x00000000
channel_jib_if_pkt_count[18] [0x000008CC] = 0x00000000
channel_jib_if_pkt_count[19] [0x000008D0] = 0x00000000
Remora Timestamp Registers (0xF8900900):
----------------------------------------
local_1024_ts_ctrl [0x00000900] = 0x00000039
local_1024_current_ts [0x00000904] = 0xC354FFA0
local_1024_tcc_ts_latch [0x00000908] = 0x7291125F
doc_ts_offset_ch_0_1 [0x0000090C] = 0x04AF04AF
doc_ts_offset_ch_2_3 [0x00000910] = 0x04AF04AF
doc_ts_offset_ch_4_5 [0x00000914] = 0x04F704F7
doc_ts_offset_ch_6_7 [0x00000918] = 0x04F704F7
doc_ts_offset_ch_8_9 [0x0000091C] = 0x04F704F7
doc_ts_offset_ch_10_11 [0x00000920] = 0x04F704F7
doc_ts_offset_ch_12_13 [0x00000924] = 0x04F704F7
doc_ts_offset_ch_14_15 [0x00000928] = 0x04F704F7
doc_ts_offset_ch_16_17 [0x0000092C] = 0x04F704F7
doc_ts_offset_ch_18_19 [0x00000930] = 0x04F704F7
Remora PRATE/SRATE Registers (0xF8900A00):
------------------------------------------
port_prate_regs[0].prate_ctrl [0x00000A00] = 0x00000003
port_prate_regs[0].prate_m_prime_lo [0x00000A04] = 0x0005971E
port_prate_regs[0].prate_n_prime_lo [0x00000A08] = 0x08AA5B88
port_prate_regs[0].prate_m_prime_hi [0x00000A0C] = 0x00000000
port_prate_regs[1].prate_ctrl [0x00000A10] = 0x00000003
port_prate_regs[1].prate_m_prime_lo [0x00000A14] = 0x00000191
port_prate_regs[1].prate_n_prime_lo [0x00000A18] = 0x00037E78
port_prate_regs[1].prate_m_prime_hi [0x00000A1C] = 0x00000000
port_prate_regs[2].prate_ctrl [0x00000A20] = 0x00000003
port_prate_regs[2].prate_m_prime_lo [0x00000A24] = 0x00000191
port_prate_regs[2].prate_n_prime_lo [0x00000A28] = 0x00037E78
port_prate_regs[2].prate_m_prime_hi [0x00000A2C] = 0x00000000
port_prate_regs[3].prate_ctrl [0x00000A30] = 0x00000003
port_prate_regs[3].prate_m_prime_lo [0x00000A34] = 0x00000191
port_prate_regs[3].prate_n_prime_lo [0x00000A38] = 0x00037E78
port_prate_regs[3].prate_m_prime_hi [0x00000A3C] = 0x00000000
port_prate_regs[4].prate_ctrl [0x00000A40] = 0x00000003
port_prate_regs[4].prate_m_prime_lo [0x00000A44] = 0x00000191
port_prate_regs[4].prate_n_prime_lo [0x00000A48] = 0x00037E78
port_prate_regs[4].prate_m_prime_hi [0x00000A4C] = 0x00000000
port_srate_regs[0].srate_ctrl [0x00000A50] = 0x00000003
port_srate_regs[0].srate_mn [0x00000A54] = 0x004E0095
port_srate_regs[1].srate_ctrl [0x00000A58] = 0x00000003
port_srate_regs[1].srate_mn [0x00000A5C] = 0x0191032C
port_srate_regs[2].srate_ctrl [0x00000A60] = 0x00000003
port_srate_regs[2].srate_mn [0x00000A64] = 0x0191032C
port_srate_regs[3].srate_ctrl [0x00000A68] = 0x00000003
port_srate_regs[3].srate_mn [0x00000A6C] = 0x0191032C
port_srate_regs[4].srate_ctrl [0x00000A70] = 0x00000003
port_srate_regs[4].srate_mn [0x00000A74] = 0x0191032C
The following example shows a typical display of the show controller integrated-cable command and
the association keyword:
Router# show controller integrated-Cable 7/1/0 association
WB Association Info for 7/1 No of WB 30
WB BG Bundle NB NB chan Reserved Total
channel ID num channel ID CIR CIR
Wideband-Cable7/1/0:0 1057 1 Cable7/1/0 121 0 21751500
Cisco IOS CMTS Cable Command Reference
CBL-1646 OL-15510-15
Cable Commands: show ch through show cr
show controller integrated-cable
Multicast 0 21751500
Wideband-Cable7/1/3:0 1153 1 Cable7/1/3 133 0 12481000
Multicast 0 12481000
The following example shows a typical display of the show controller integrated-cable command and
the brief keyword:
Router# show controllers integrated-Cable 6/0/0 brief
Integrated Cable Controller 6/0/0:
----------------------------------
Channel 1 Annex = B Modulation = 256 QAM
Channel 2 Annex = B Modulation = 256 QAM
Channel 3 Annex = B Modulation = 256 QAM
Channel 4 Annex = B Modulation = 256 QAM
Jib3-DS Device Information:
---------------------------
Jib3-DS Version = 2.2.1.8
SW Rev ID = 0x00020002 HW Rev ID = 0x00010008
Device Type: Coldplay
Driver State: 3
Channel Resources:
------------------
Total Non-bonded Channels..........= 20
Per-Controller Non-bonded Channels = 4
Total Bonded Channels..............= 32
Per-Controller Bonded Channels.....= 6
Slot-Wide Resources:
--------------------
Number of PHS Rules...........= 12K (0x3000)
Number of BPI Table Entries...= 24K (0x6000)
Number of Service Flows.......= 64K (0x10000)
DS PHY Device Information:
-------------------
Remora Version = 3.10
UPX SW Version = 0x10D
Upconverter Type:Unknown
UPX Part Number =
Device Status:
--------------
UPX Alarm Status = 0x3FF
UPX Alarm Mask = 0x19000
The following example shows a typical display of the show controller integrated-cable command and
the bpi-entry keyword:
Router# show controller integrated-cable 7/1/4 bpi-entry 3
BPI index:3 segment:0 key_no:3 said:2 key_seq:7 AES
Even 5A4B-68E8-5948-FD84-F5E2-1D28-311C-37D8
Iv 4E33-379E-6FCF-9A8E-01CB-AC95-5B4D-AE76
Odd A871-76EA-1D3E-02F8-5EDA-8A8E-1F15-52E6
Iv 6F62-765C-C9E7-DB8A-6FA5-91E8-BE41-3075
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1647
Cable Commands: show ch through show cr
show controller integrated-cable
Example of the show controller integrated-cable Command that displays BPI key information stored on the
Cisco UBR-MC20X20V line card from Cisco IOS Release 12.2(33)SCD onwards.
The following is a sample output of the show controller integrated-cable command with the bpi-entry
keyword:
Router# show controller integrated-cable 6/0/0 bpi-entry 1
BPI Index: 1 Segment: 0
Even Key: Valid, Odd Key: Valid
Key Sequence Number: 1 Security Association: 0x2
Key Type: DES
Even Key: 1CE8-45A1-1903-E5 IV: 1513-236D-1FF7-046E
Odd Key: 10EC-6DB2-5441-EC IV: 07C7-1089-0E34-026B
The following example provides information about all controllers using the show controller
integrated-cable command and the wideband keyword:
Router# show controller integrated-cable 7/1/4 wideband
WB BG WB Host Primary
channel ID Slot/Subslot BG
Wideband-Cable7/1/4:0 1185 7/1 Yes
Wideband-Cable7/1/4:1 1186 7/1 Yes
Wideband-Cable7/1/4:2 1187 7/1 Yes
Wideband-Cable7/1/4:3 1188 7/1 Yes
Wideband-Cable7/1/4:4 1189 7/1 Yes
Wideband-Cable7/1/4:5 1190 7/1 Yes
The following example provides information about all controllers using the show controller
integrated-cable command and the config keyword:
Router# show controllers integrated-Cable 6/0/0 config
Integrated Cable Controller 6/0/0:
----------------------------------
Channel 1 Annex = B Modulation = 256 QAM
Channel 2 Annex = B Modulation = 256 QAM
Channel 3 Annex = B Modulation = 256 QAM
Channel 4 Annex = B Modulation = 256 QAM
Jib3-DS Device Information:
---------------------------
Jib3-DS Version = 2.2.1.8
SW Rev ID = 0x00020002 HW Rev ID = 0x00010008
Device Type: Coldplay
Driver State: 3
Channel Resources:
------------------
Total Non-bonded Channels..........= 20
Per-Controller Non-bonded Channels = 4
Total Bonded Channels..............= 32
Per-Controller Bonded Channels.....= 6
Slot-Wide Resources:
--------------------
Number of PHS Rules...........= 12K (0x3000)
Number of BPI Table Entries...= 24K (0x6000)
Number of Service Flows.......= 64K (0x10000)
Sniffer Configuration:
Cisco IOS CMTS Cable Command Reference
CBL-1648 OL-15510-15
Cable Commands: show ch through show cr
show controller integrated-cable
----------------------
Non-Bonded Channel Mask = 0x00000000
Bonded Channel Mask.....= 0x00000000
Sniff All Enable........= False
Configured Sniffer MAC Addresses:
Entry MAC Address Enabled
----- --------------- -------
0 0000.0000.0000 False
1 0000.0000.0000 False
2 0000.0000.0000 False
3 0000.0000.0000 False
4 0000.0000.0000 False
5 0000.0000.0000 False
6 0000.0000.0000 False
7 0000.0000.0000 False
8 0000.0000.0000 False
9 0000.0000.0000 False
10 0000.0000.0000 False
11 0000.0000.0000 False
12 0000.0000.0000 False
13 0000.0000.0000 False
14 0000.0000.0000 False
15 0000.0000.0000 False
Replication Table:
------------------
Replication Entry Index Channel Mask
----------------------- ------------
41 0x0000000F
42 0x0000000F
43 0x0000000F
44 0x0000000F
Configured Bonding Groups:
--------------------------
Bonded Channel Channels in Bonding Group
-------------- -------------------------
00 0, 1, 2, 3
Sync Configuration:
-------------------
Channel MAC Address Interval
------- -------------- --------
0 001d.70cc.0b90 10 ms
1 001d.70cc.0b90 10 ms
2 001d.70cc.0b90 10 ms
3 001d.70cc.0b90 10 ms
DS PHY Configuration of Controller 0:
---------------------
Base Frequency = 555000000Hz
RF-Power = 52.0dBmV
Annex = B Modulation = 256QAM
Channel Status Interleave
------- ------ ----------
0 Active 32
1 Active 32
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1649
Cable Commands: show ch through show cr
show controller integrated-cable
2 Active 32
3 Active 32
DS_PHY PLL set for Annex-B
The following example provides information about all controllers using the show controller
integrated-cable command and the counters keyword:
Router# show controller integrated-Cable card 7/1 counters rf-channel
Controller RF MPEG MPEG MPEG Sync MAP/UCD
Chan Packets bps Mbps Packets Packets
Tx Tx Tx
7/1/0 0 510617849 1411052 1.411052 45424209 894786143
7/1/0 1 511430476 1415614 1.415614 45424208 894786138
7/1/0 2 510750271 1412707 1.412707 45424208 894786121
7/1/0 3 512009268 1416818 1.416818 45424207 894786108
7/1/1 0 268915155 743427 0.74347 45424206 223046013
7/1/1 1 0 0 0.0 0 0
7/1/1 2 0 0 0.0 0 0
7/1/1 3 0 0 0.0 0 0
7/1/2 0 0 0 0.0 0 0
7/1/2 1 0 0 0.0 0 0
7/1/2 2 0 0 0.0 0 0
7/1/2 3 0 0 0.0 0 0
7/1/3 0 269847377 746886 0.746886 45424206 223769698
7/1/3 1 269850587 746936 0.746936 45424205 223769696
7/1/3 2 269851105 746886 0.746886 45424204 223769690
7/1/3 3 269868256 747036 0.747036 45424199 223769663
7/1/4 0 0 0 0.0 0 0
7/1/4 1 0 0 0.0 0 0
7/1/4 2 0 0 0.0 0 0
7/1/4 3 0 0 0.0 0 0
Router# show controllers integrated-Cable 6/0/0 counters wb-channel
Controller WB channel Tx packets Tx octets
6/0/0 0 881249714 466143984373
6/0/0 1 0 0
6/0/0 2 0 0
6/0/0 3 0 0
6/0/0 4 0 0
6/0/0 5 0 0
The following example provides information about all controllers using the show controller
integrated-cable command and the errors keyword:
Router# show controllers integrated-Cable 6/0/0 errors
Rx SPI Error Counters:
----------------------
Non-Droppable Errors Channel 0 = 00 FIFO Pkt Drop Count Channel 0 = 00000000
Non-Droppable Errors Channel 1 = 00 FIFO Pkt Drop Count Channel 1 = 00000000
Non-Droppable Errors Channel 2 = 00 FIFO Pkt Drop Count Channel 2 = 00000000
Non-Droppable Errors Channel 3 = 00 Dropped Bytes = 00000000
Tx SPI Error Counters:
----------------------
DIP2 Errors = 00 Illegal Src Pattern Errs = 00
EOP Abort Pkts Channel 0 = 00000000 EOP Abort Bytes Channel 0 = 00000000
EOP Abort Pkts Channel 1 = 00000000 EOP Abort Bytes Channel 1 = 00000000
EOP Abort Pkts Channel 2 = 00000000 EOP Abort Bytes Channel 2 = 00000000
EOP Abort Pkts Channel 3 = 00000000 EOP Abort Bytes Channel 3 = 00000000
Cisco IOS CMTS Cable Command Reference
CBL-1650 OL-15510-15
Cable Commands: show ch through show cr
show controller integrated-cable
DOCSIS Processor Error Counters:
--------------------------------
EFC and Stats Errors = 00000000 DOCSIS Engine Errors = 00025934
PHS Errors = 00000000 Parser Errors = 00000000
Output Packet Errors = 00000000 Dropped Packets = 00000000
Input Packet Errors = 00000000 ECC Errors = 00000000
BPI Error Counters:
-------------------
Bad Input Pkts = 22 Single-bit ECC Errors = 0
Bad Output Pkts = 22
Queue Manager Error Counters:
-----------------------------
BPRAM Bad End of Packets..= 00000000 Bonded Map Errors............= 00000000
BPRAM Overflows...........= 00000000 BPRAM Bad Packet Type Errors = 00000000
Directed Map Error Counts = 00000000 BPRAM ECC Errors.............= 00000000
RLDRAM ECC Errors.........= 00000000 Queue Overflows..............= 00000000
Sequencer Error Counters:
-------------------------
BlkRAM ECC Errors = 00000000
ERP Error Counters:
-------------------
Processor Bus Errored Address = 0x00000000
Return Interface Error Counters:
--------------------------------
Phys If Rx FIFO Oflow Drops = 00000000 Phys If LB FIFO Oflow Drops = 00000000
Sniffer FIFO Oflow Drops....= 00000000 Phys If Rx Parity Errors....= 00000000
Phys If Length Errors.......= 00000000 Phys If Rx FIFO ECC Errors..= 00000000
Phys If LB FIFO ECC Errors..= 00000000 Sniffer FIFO ECC Errors.....= 00000000
SPI LB FIFO ECC Errors......= 00000000
Jib3-DS (Coldplay) interrupt events
count
current total bursts Event name
21 25921 0 DOCSIS Processing Block: DSID Valid Error
Internal error packet buffer:
-----------------------------
IPH Header:
Packet type......... = 0x00
Flags............... = 0x00
Packet Length....... = 33015 (0x80F7)
DOCSIS Header Length = 11
Replication Index... = 0
Stats Index......... = 0x0546
Flags2.............. = 0x01040000
Service Flow........ = 0x00000000
Packet Body:
0x010500E1 0x4411C0FA 0x00895500 0x118072C7
0x6A001D70 0xCC0BE208 0x0045B800 0xCA000000
0x003F1121 0x42AC2200 0x63AC2200 0x82C004C0
0x0200B600 0x008000F1 0x318FF541 0x1BA16AE2
0xB303AF17 0x1652643F 0x4498F48E 0xE278F16B
0x167521EC 0x3CBF34DD 0xDCBEA10E 0x0B5AA70C
0xE6B9B77F 0x8E3590ED 0x4EC9388A 0x9B886A51
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1651
Cable Commands: show ch through show cr
show controller integrated-cable
Internal magic number error packet buffer:
------------------------------------------
No magic number errored packet available
The following example provides information about all controllers using the show controller
integrated-cable command and the fpga_version keyword:
Router# show controllers integrated-Cable 7/0/0 fpga_version
2020 CARD FPGA VERSION
CORABI FPGA : 0.53
SPARROW FPGA : 0.309
WAXBILL FPGA : 1.7D
COLDPLAY FPGA : 2.2.1.D
REMORA FPGA : 0.1.0.14
FAUNA FPGA : 0.8.0.3
FLORA FPGA : 0.6.0.7
The following example provides information about all controllers using the show controller
integrated-cable command and the iofpga keyword:
Router# show controllers integrated-Cable 7/0/0 iofpga
SPARROW PHY IOFPGA Registers - Address 0xF8800000:
OFFSET REGISTER VALUE
0x00 Revision 0x00000309
0x08 DS RF Control 0x80000003
0x0C FFT Process Low 0x80007006
0x1C DCM Lock status 0x00077411
0x20 UPX SPI Control 0x00000000
0x24 UPX SPI Respond 0x00000703
0xB0 BCM 3140 SPI Start 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000
0xC4 BCM 3140 SPI Done 0x00000000 0x00000000 0x00000000 0x00000000
0x00000000
0xD8 BCM3140 Reset 0x000003FF
0x100 FATAL Interrupt 0x00002000
0x104 FATAL Interrupt Enable 0x001FD8FF
0x108 HIGH Priority Interrupt 0x00000000
0x10C HIGH Priority Interrupt Enable 0x00000000
0x110 Low Priority Interrupt 0x00100000
0x114 Low Priority Interrupt Enable 0x03E03C00
0x118 CPU LB Data Parity Error 0x00000000
0x200 Fauna ERP Interrupt Status 0x00000000
0x204 Flora ERP Interrupt Status 0x00000000
0x208 Coldplay ERP Interrupt Status 0x00000000
0x20C Remora ERP Interrupt Status 0x00000000
0x210 VGA SPI RF Channel Selection 0x00000000
0x214 VGA SPI RW Gain 0x0000009E
0x218 VGA SPI Write Gain(raven) 0x00000000
0x220 VGA Enable 0x000FFFFF
0x300 Fauna Reset 0x00000003
0x304 Flora Reset 0x00000003
0x308 Coldplay Reset 0x00000003
0x30C Remora Reset 0x00000007
0x310 Upstream LED 0x00003C00
0x380 Downstream Density License LED 0x00000000
** Sparrow PHY I/O FPGA counters ****
Spurious FFT Interrupts: 0 Spurious FFT CHIP ID: 0 FFT RDY CLEAR Err: 0
FFT Data Ready: 2A6
UPX: SPI 0 Non-fatal 0 Boot OK 3
BCM3140: SPIA 0 SPIB 0 SPIC 0 SPID 0 SPIE 0
Cisco IOS CMTS Cable Command Reference
CBL-1652 OL-15510-15
Cable Commands: show ch through show cr
show controller integrated-cable
Non fatal US JIB Flora: 1 US JIB Fauna: 1
Non fatal DS JIB Coldplay: 1
Non fatal Remora FPGA: 1
US Port (BCM3140 channels):
0: 0 1: 0 2: 0 3: 0
4: 0 5: 0 6: 0 7: 0
8: 0 9: 0 10: 0 11: 0
12: 0 13: 0 14: 0 15: 0
16: 0 17: 0 18: 0 19: 0
The following example provides information about all controllers using the show controller
integrated-cable command and the mapping keyword:
Router# show controllers integrated-Cable 6/0/0 mapping rf-channel
Ctrlr RF MC MC Rem. WB WB WB Rem.
channel BW % Ratio channel BW % Ratio
6/0/0 0 33 1 6/0/0:0 63 1
6/0/0 1 33 1 6/0/0:0 63 1
6/0/0 2 33 1 6/0/0:0 63 1
6/0/0 3 33 1 6/0/0:0 63 1
Router# show controllers integrated-Cable 6/0/0 mapping wb-channel
Load for five secs: 18%/1%; one minute: 11%; five minutes: 13%
Time source is NTP, *15:07:17.566 EDT Sun Mar 21 2010
Ctrlr WB RF BW % Remaining
channel channel Ratio
6/0/0 0 6/0/0:0 63 1
6/0/0:1 63 1
6/0/0:2 63 1
6/0/0:3 63 1
The following example provides information about all controllers using the show controller
integrated-cable command and the registers keyword:
Router# show controllers integrated-Cable 6/0/0 registers
JIB3_DS BPI registers (base address 0xF8880000)
bpi_int_isr_0 [0x00000000] = 0x00000000
bpi_int_ier_0 [0x00000004] = 0x0000000F
glb_int_isr_0 [0x00000010] = 0x00000000
glb_int_ier_0 [0x00000014] = 0x000003FF
glb_int_isr_1 [0x00000020] = 0x00000000
glb_int_ier_1 [0x00000024] = 0x000003FF
bpi_int_fesr_0 [0x00000040] = 0x00000000
bpi_tst_tp_sel_reg [0x00000050] = 0x00000000
bpi_tst_tp_reg [0x00000054] = 0x00000000
bpi_cnt_good_packet_in_cnt [0x00000064] = 0x00045B37
bpi_cnt_bad_packet_in_cnt [0x00000068] = 0x0000000D
bpi_cnt_good_packet_out_cnt [0x0000006C] = 0x00045B37
bpi_cnt_bad_packet_out_cnt [0x00000070] = 0x0000000D
bpi_ecc_sbit_err_cnt [0x00000074] = 0x00000000
glb_sw_rev_id [0x00000078] = 0x00020002
glb_hw_rev_id [0x0000007C] = 0x00010008
frz_reg [0x00000080] = 0x00000000
frz_en [0x00000084] = 0x00000001
glb_dcm_status [0x00000088] = 0x00000007
glb_sw_rst [0x0000008C] = 0x00000000
JIB3_DS ERP registers (base address 0xF8881000)
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1653
Cable Commands: show ch through show cr
show controller integrated-cable
erp_irq_src_reg [0x00000000] = 0x00000000
erp_irq_en_reg [0x00000004] = 0x80000FFF
erp_tp_sel_reg [0x00000050] = 0x00000000
erp_tp_reg [0x00000054] = 0x00000000
erp_cfg_reg [0x00000060] = 0x00000000
erp_err_record_reg [0x00000064] = 0x00000000
erp_err_addr_record_reg [0x00000068] = 0x00000000
erp_err_wd_record_reg [0x0000006C] = 0x00000000
erp_proc_err_addr_record_reg [0x00000090] = 0x00000000
JIB3_DS RX SPI registers (base address 0xF8882000)
rxspi_irq_src_reg [0x00000000] = 0x00000000
rxspi_irq_en_reg [0x00000004] = 0x000001FF
rxspi_ferr_src_reg [0x00000040] = 0x00000000
rxspi_testpoint_sel_reg [0x00000050] = 0x00000000
rxspi_testpoint_reg [0x00000054] = 0x00000000
rxspi_rst_cntl_reg [0x00000060] = 0x00000000
rxspi_cntl_status_reg [0x00000064] = 0x00000005
rxspi_cfg_cntl_reg [0x00000068] = 0x00000021
rxspi_afthres_reg [0x0000006C] = 0x01C00180
rxspi_cal_dur_reg [0x00000070] = 0x00030000
rxspi_non_drop_err_cnt_reg [0x00000088] = 0x00000000
rxspi_drop_byte_cnt_reg [0x0000008C] = 0x00000000
rxspi_rx_byte_cnt_reg[0] [0x000000B0] = 0x01A499EF
rxspi_rx_byte_cnt_reg[1] [0x000000B4] = 0x00CF4ED0
rxspi_rx_byte_cnt_reg[2] [0x000000B8] = 0x0001F030
rxspi_rx_pkt_cnt_reg[0] [0x000000C0] = 0x0001D242
rxspi_rx_pkt_cnt_reg[1] [0x000000C4] = 0x0002828C
rxspi_rx_pkt_cnt_reg[2] [0x000000C8] = 0x00000684
rxspi_fifo_pkt_drop_cnt_reg[0] [0x000000E0] = 0x00000000
rxspi_fifo_pkt_drop_cnt_reg[1] [0x000000E4] = 0x00000000
rxspi_fifo_pkt_drop_cnt_reg[2] [0x000000E8] = 0x00000000
rxspi_calendar_table_reg[0] [0x00000800] = 0x00000000
rxspi_calendar_table_reg[1] [0x00000804] = 0x00000001
rxspi_calendar_table_reg[2] [0x00000808] = 0x00000002
rxspi_calendar_table_reg[3] [0x0000080C] = 0x00000003
JIB3_DS TX SPI registers (base address 0xF8883000)
txspi_irq_src_reg [0x00000000] = 0x00000000
txspi_irq_en_reg [0x00000004] = 0x0000001F
txspi_ferr_src_reg [0x00000040] = 0x00000000
txspi_testpoint_sel_reg [0x00000050] = 0x00000000
txspi_testpoint_reg [0x00000054] = 0x00000000
txspi_rst_cntl_reg [0x00000060] = 0x00000000
txspi_cntl_status_reg [0x00000064] = 0x00000009
txspi_cfg_cntl_reg [0x00000068] = 0x00000001
txspi_afthres_reg [0x0000006C] = 0x01EC01E8
txspi_cal_dur_reg [0x00000070] = 0x00040000
txspi_train_cntl_reg [0x00000074] = 0x00000000
txspi_nonfatalerr_cnt_reg [0x00000080] = 0x00000000
txspi_eop_abort_pkt_cnt_reg[0] [0x00000090] = 0x00000000
txspi_eop_abort_pkt_cnt_reg[1] [0x00000094] = 0x00000000
txspi_eop_abort_pkt_cnt_reg[2] [0x00000098] = 0x00000000
txspi_eop_abort_pkt_cnt_reg[3] [0x0000009C] = 0x00000000
txspi_eop_abort_byte_cnt_reg[0] [0x000000A0] = 0x00000000
txspi_eop_abort_byte_cnt_reg[1] [0x000000A4] = 0x00000000
txspi_eop_abort_byte_cnt_reg[2] [0x000000A8] = 0x00000000
txspi_eop_abort_byte_cnt_reg[3] [0x000000AC] = 0x00000000
txspi_tx_byte_cnt_reg[0] [0x000000C0] = 0x00000000
txspi_tx_byte_cnt_reg[1] [0x000000C4] = 0x00000000
txspi_tx_byte_cnt_reg[2] [0x000000C8] = 0x00000000
Cisco IOS CMTS Cable Command Reference
CBL-1654 OL-15510-15
Cable Commands: show ch through show cr
show controller integrated-cable
txspi_tx_byte_cnt_reg[3] [0x000000CC] = 0x00000000
txspi_tx_pkt_cnt_reg[0] [0x00000100] = 0x00000000
txspi_tx_pkt_cnt_reg[1] [0x00000104] = 0x00000000
txspi_tx_pkt_cnt_reg[2] [0x00000108] = 0x00000000
txspi_tx_pkt_cnt_reg[3] [0x0000010C] = 0x00000000
txspi_calendar_table_reg[0] [0x00000800] = 0x00000000
txspi_calendar_table_reg[1] [0x00000804] = 0x00000001
txspi_calendar_table_reg[2] [0x00000808] = 0x00000002
txspi_calendar_table_reg[3] [0x0000080C] = 0x00000003
txspi_calendar_table_reg[4] [0x00000810] = 0x00000004
JIB3_DS DOC registers (base address 0xF8884000)
doc_int_err0 [0x00000000] = 0x00000000
doc_int_err0_ier [0x00000004] = 0xFFBFBFFD
doc_int_err1 [0x00000010] = 0x00000000
doc_int_err1_ier [0x00000014] = 0x003FFFF8
doc_int_fesr [0x00000040] = 0x00000000
doc_test_sel [0x00000050] = 0x00000000
doc_testpoint [0x00000054] = 0x00000000
doc_cfg_ctrl [0x00000060] = 0x031A0000
doc_err_cap_ctrl [0x00000064] = 0x001F0001
doc_err_cap_addr [0x00000068] = 0x00000020
doc_err_cap_data [0x0000006C] = 0x000080F7
doc_seg_num [0x00000070] = 0x00000001
doc_wb_chan_stats_sel [0x00000074] = 0x00000077
doc_wb_pkt_cnt [0x00000078] = 0x00000000
doc_wb_byte_cnt [0x0000007C] = 0x00000000
doc_wb_police_sel [0x00000080] = 0x00000001
doc_wb_police_data [0x00000084] = 0x00000000
doc_wb_police_intv [0x00000088] = 0x00000000
doc_nb_chan_stats_sel [0x0000008C] = 0x0000004C
doc_nb_pkt_cnt [0x00000090] = 0x00000000
doc_nb_byte_cnt [0x00000094] = 0x00000000
doc_nb_police_sel [0x00000098] = 0x00000001
doc_nb_police_data [0x0000009C] = 0x00000000
doc_nb_police_intv [0x000000A0] = 0x00000000
doc_int_doc_cnt [0x000000D4] = 0x00000000
doc_int_ecc_sbiterr_cnt [0x000000D8] = 0x00000000
doc_pkt_good_in_cnt [0x000000DC] = 0x00045B5C
doc_pkt_good_out_cnt [0x000000E0] = 0x00045B39
doc_pkt_err_in_cnt [0x000000E4] = 0x00000000
doc_pkt_err_out_cnt [0x000000E8] = 0x00000023
doc_pkt_drop_cnt [0x000000EC] = 0x00000000
doc_efc_all_cnt [0x000000F0] = 0x00000000
doc_efc_hi_cnt [0x000000F4] = 0x00000000
doc_efc_me_cnt [0x000000F8] = 0x00000000
doc_efc_lo_cnt [0x000000FC] = 0x00000000
doc_efc_ch_sel [0x00000100] = 0x00000000
doc_efc_debug_ctrl [0x00000104] = 0x00000000
doc_rldram_ext_ecc [0x00000114] = 0x00000000
doc_rldram_cfg [0x00000118] = 0x00101544
doc_rldram_ctrl [0x0000011C] = 0x00100389
doc_rldram_status [0x00000120] = 0x039D7403
doc_rldram_blk_clr [0x00000124] = 0x0B7FFFFF
doc_rldram_cal_match_win_h [0x00000128] = 0x00000000
doc_rldram_cal_match_win_l [0x0000012C] = 0x1FFFFFFF
doc_rldram_ecc_err_rec_addr [0x00000130] = 0x00000000
doc_magic_num_err_pkt_ctrl [0x00000150] = 0x00000000
doc_magic_num_err_pkt_addr [0x00000154] = 0x00000001
doc_magic_num_err_pkt_data [0x00000158] = 0x00000000
JIB3_DS RIF registers (base address 0xF8885000)
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1655
Cable Commands: show ch through show cr
show controller integrated-cable
rif_int_err0 [0x00000000] = 0x00000000
rif_int_ier0 [0x00000004] = 0x00000007
rif_int_fesr0 [0x00000040] = 0x00000000
rif_tp_sel [0x00000050] = 0x00000000
rif_tp [0x00000054] = 0x00000000
rif_cfg_ctrl [0x00000060] = 0x00000000
rif_cnt_in_mpeg_cnt [0x00000064] = 0x000A6226
rif_cnt_out_good_mpeg_cnt [0x00000068] = 0x000A6226
rif_cnt_out_bad_mpeg_cnt [0x0000006C] = 0x00000000
rif_cnt_drop_mpeg_cnt [0x00000070] = 0x00000000
rif_1bit_ecc_err_stat [0x00000074] = 0x00000000
JIB3_DS RTN registers (base address 0xF8886000)
return_int_isr [0x00000000] = 0x00000000
return_int_ier [0x00000004] = 0x000001FF
return_int_fesr [0x00000040] = 0x00000000
return_tp_sel [0x00000050] = 0x00000000
return_tp [0x00000054] = 0x00000000
return_ctrl_reg [0x00000060] = 0x00000000
return_pif_loopback_chnl [0x00000064] = 0x00000000
return_sniffer_nonbonded_en [0x00000068] = 0x00000000
return_sniffer_bonded_en [0x0000006C] = 0x00000000
return_spi_chnl_sel [0x00000070] = 0x0000013A
return_err_drop_en [0x00000074] = 0x0000000F
return_snf_macda_cfg_addr [0x00000078] = 0x0000000F
return_snf_macda_cfg_data_hi [0x0000007C] = 0x00000000
return_snf_macda_cfg_data_lo [0x00000080] = 0x00000000
return_in_pifrx_good_cnt [0x000000A0] = 0x00000000
return_in_pifrx_bad_cnt [0x000000A4] = 0x00000000
return_in_piflp_good_cnt [0x000000A8] = 0x000A6224
return_in_piflp_bad_cnt [0x000000AC] = 0x00000000
return_in_sniffer_good_cnt [0x000000B0] = 0x00045B3A
return_in_sniffer_bad_cnt [0x000000B4] = 0x00000023
return_in_spi_loop_good_cnt [0x000000B8] = 0x00000000
return_in_spi_loop_bad_cnt [0x000000BC] = 0x00000000
return_out_spi0_cnt [0x000000C0] = 0x00000000
return_out_spi1_cnt [0x000000C4] = 0x00000000
return_out_spi2_cnt [0x000000C8] = 0x00000000
return_out_spi3_cnt [0x000000CC] = 0x00000000
return_out_spi4_cnt [0x000000D0] = 0x00000000
return_pifrx_if_par_err_drop_cnt [0x000000D4] = 0x00000000
return_pifrx_if_len_err_drop_cnt [0x000000D8] = 0x00000000
return_piflp_if_err_drop_cnt [0x000000DC] = 0x00000000
return_piflp_if_chnl_drop_cnt [0x000000E0] = 0x00000000
return_snf_pb_err_drop_cnt [0x000000E4] = 0x00000023
return_snf_pkt_type_err_drop_cnt [0x000000E8] = 0x00045B3A
return_spilp_if_err_drop_cnt [0x000000EC] = 0x00000000
return_pifrx_traffic_mux_drop_cnt [0x000000F0] = 0x00000000
return_piflp_traffic_mux_drop_cnt [0x000000F4] = 0x00000000
return_snf_traffic_mux_drop_cnt [0x000000F8] = 0x00000000
return_spilp_traffic_mux_drop_cnt [0x000000FC] = 0x00000000
return_pifrx_fifo_overflow_drop_cnt [0x00000100] = 0x00000000
return_piflp_fifo_overflow_drop_cnt [0x00000104] = 0x00000000
return_snf_fifo_overflow_drop_cnt [0x00000108] = 0x00000000
return_spilp_fifo_overflow_drop_cnt [0x0000010C] = 0x00000000
return_pifrx_if_par_err_cnt [0x00000110] = 0x00000000
return_pifrx_if_len_err_cnt [0x00000114] = 0x00000000
return_pifrx_fifo_ecc_1berr_cnt [0x00000118] = 0x00000000
return_piflp_fifo_ecc_1berr_cnt [0x0000011C] = 0x00000000
return_snf_fifo_ecc_1berr_cnt [0x00000120] = 0x00000000
return_spilp_fifo_ecc_1berr_cnt [0x00000124] = 0x00000000
JIB3_DS DLM registers (base address 0xF8890000)
Cisco IOS CMTS Cable Command Reference
CBL-1656 OL-15510-15
Cable Commands: show ch through show cr
show controller integrated-cable
dlm_int_isr_0 [0x00000000] = 0x00000004
dlm_int_ier_0 [0x00000004] = 0x00000000
dlm_cnt_local_ts_reg [0x00000064] = 0x8D7DF4CD
dlm_cfg_tss_comp_reg [0x00000068] = 0x00000027
dlm_cfg_tss_ctrl_reg [0x0000006C] = 0x00000000
dlm_cfg_tss_cmd_reg [0x00000070] = 0x00000000
dlm_cnt_ts_load_cnt [0x000000BC] = 0x00000000
dlm_cnt_ts_chk_failed_cnt [0x000000C4] = 0x00000000
dlm_cnt_tss_perr_cnt [0x000000C8] = 0x00000000
dlm_cnt_load_ts_reg [0x000000D0] = 0x003F52EF
JIB3_DS SEQ registers (base address 0xF8892000)
seq_int_err0 [0x00000000] = 0x0000000F
seq_int_ier0 [0x00000004] = 0x000FFFFF
seq_int_err3 [0x00000030] = 0x00000000
seq_int_ier3 [0x00000034] = 0x00000001
seq_int_fatal_err [0x00000040] = 0x00000000
seq_tp_sel [0x00000050] = 0x00000000
seq_tp [0x00000054] = 0x00000000
seq_cfg_en [0x00000060] = 0x00000001
seq_cfg_sync_timer_sel [0x00000064] = 0x00000014
seq_cfg_sync_timer_data [0x00000068] = 0x00000000
seq_cfg_sync_sa_sel [0x0000006C] = 0x00000014
seq_cfg_sync_sa_data_lo [0x00000070] = 0x00000000
seq_cfg_sync_sa_data_hi [0x00000074] = 0x00000000
seq_cfg_tkb_timer_sel [0x00000078] = 0x00000015
seq_cfg_tkb_timer_data [0x0000007C] = 0x00000000
seq_cfg_tkb_max [0x00000080] = 0x00000000
seq_hwdbg_dpv_proc_table_addr [0x00000090] = 0x00000001
seq_hwdbg_dpv_ptr_mod_table [0x00000094] = 0x00000000
seq_hwdbg_dpv_timestamp_table [0x00000098] = 0x00000000
seq_hwdbg_dpv_hcs_table [0x0000009C] = 0x00000000
seq_cnt_blkram_oecc_err_stat [0x000000A4] = 0x00000000
seq_cnt_tran_mpeg_stat [0x000000A8] = 0x000A6224
seq_cnt_tran_mpeg_sync_stat [0x000000AC] = 0x00000000
seq_cnt_tran_only_sync_stat [0x000000B0] = 0x00000000
seq_cnt_tran_dpv_stat [0x000000B8] = 0x00000000
JIB3_DS QM registers (base address 0xF8893000)
qm_int_isr0 [0x00000000] = 0x00000000
qm_int_ier0 [0x00000004] = 0x0000007F
qm_int_isr1 [0x00000010] = 0x00000000
qm_int_ier1 [0x00000014] = 0x000FFFFF
qm_int_fat_err_isr [0x00000040] = 0x00000000
qm_tst_tp_sel [0x00000050] = 0x00000000
qm_tst_tp [0x00000054] = 0x00000000
qm_cfg_chnl_rst_0 [0x00000060] = 0x00000000
qm_cfg_ctl [0x0000006C] = 0x00000011
qm_cfg_sqf_fac_addr [0x0000008C] = 0x00000015
qm_cfg_sqf_fac_data [0x00000090] = 0x00000000
qm_cfg_bond_chnl_map_addr [0x00000094] = 0x00000020
qm_cfg_bond_chnl_map_data_lo [0x00000098] = 0x00000000
qm_cfg_flt_thr_addr [0x000000A4] = 0x00000250
qm_cfg_flt_thr_data [0x000000A8] = 0x00000000
qm_cfg_repl_addr [0x000000AC] = 0x00000000
qm_cfg_repl_data_lo [0x000000B0] = 0x00000000
qm_hwdbg_buf_mag_addr [0x000000BC] = 0x00000001
qm_hwdbg_wptr_data_lo [0x000000C0] = 0x00014F60
qm_hwdbg_wptr_data_mi [0x000000C4] = 0x000033A0
qm_hwdbg_wptr_data_hi [0x000000C8] = 0x00000AA0
qm_hwdbg_rptr_data_lo [0x000000CC] = 0x00014F60
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1657
Cable Commands: show ch through show cr
show controller integrated-cable
qm_hwdbg_rptr_data_mi [0x000000D0] = 0x000033A0
qm_hwdbg_rptr_data_hi [0x000000D4] = 0x00000AA0
qm_hwdbg_qulen_data_lo [0x000000D8] = 0x00000000
qm_hwdbg_qulen_data_mi [0x000000DC] = 0x000000E7
qm_hwdbg_qulen_data_hi [0x000000E0] = 0x00000000
qm_hwdbg_contex_data [0x000000E4] = 0x00000000
qm_cfg_dir_stat_addr [0x000000E8] = 0x0000004E
qm_cnt_dir_pkt_stat [0x000000EC] = 0x00000000
qm_cnt_dir_byte_stat [0x000000F0] = 0x00000000
qm_cfg_qam_stat_addr [0x000000F4] = 0x0000004C
qm_cnt_qam_chnl_pkt_stat [0x000000F8] = 0x00000000
qm_cnt_qam_chnl_byte_stat [0x000000FC] = 0x00000000
qm_cnt_qam_chnl_sync_stat [0x00000100] = 0x00000000
qm_cnt_bpram_ovrflw_stat [0x00000108] = 0x00000000
qm_cnt_que_ovrflw_stat [0x0000010C] = 0x00000000
qm_cnt_good_bpi_pkt_stat [0x00000110] = 0x00045B3C
qm_cnt_bad_bpi_pkt_stat [0x00000114] = 0x0000000D
qm_cnt_bpram_out_good_pkt_stat [0x0000011C] = 0x000BD95D
qm_cnt_bpram_out_dir_pkt_stat [0x00000120] = 0x00028918
qm_cnt_bpram_out_bonded_pkt_stat [0x00000124] = 0x00000029
qm_cnt_replicated_pkt_stat [0x00000128] = 0x000A0738
qm_cnt_bpram_bad_type_pkt_stat [0x00000134] = 0x00000000
qm_cnt_bpram_bad_eop_pkt_stat [0x00000138] = 0x00000000
qm_cnt_bpram_bad_dir_pkt_stat [0x0000013C] = 0x00000000
qm_cnt_bpram_bad_bonded_pkt_stat [0x00000140] = 0x00000000
qm_cnt_bpram_oecc_err_pkt_stat [0x00000144] = 0x00000000
qm_cnt_bpram_bad_pkt_stat [0x00000148] = 0x0000000D
qm_cnt_wr_good_pkt_stat [0x0000014C] = 0x000BD95D
qm_cnt_wr_bad_pkt_stat [0x00000150] = 0x00000000
qm_cnt_drop_bad_pkt_stat [0x00000154] = 0x0000000D
qm_cnt_drop_ovrflw_pkt_stat [0x00000158] = 0x00000000
qm_cnt_rd_pkt_stat [0x0000015C] = 0x000BD933
qm_cnt_rd_mpeg_stat [0x00000160] = 0x000A6226
qm_cnt_rd_mpeg_sync_stat [0x00000164] = 0x00008140
qm_cnt_rd_mpeg_only_sync_stat [0x00000168] = 0x00007E93
qm_cnt_tran_pkt_stat [0x00000170] = 0x000BD95E
qm_cnt_tran_oecc_err_pkt_stat [0x00000174] = 0x00000000
qm_cnt_tran_mpeg_stat [0x00000178] = 0x000A6226
qm_cnt_tran_mpeg_sync_stat [0x0000017C] = 0x00008140
qm_cnt_tran_mpeg_only_sync_stat [0x00000180] = 0x00007E93
qm_cnt_tran_dpv_stat [0x00000188] = 0x00000000
qm_rldram_ext_ecc [0x00000198] = 0x00000000
qm_rldram_cfg [0x0000019C] = 0x00101544
qm_rldram_ctrl [0x000001A0] = 0x00100389
qm_rldram_status [0x000001A4] = 0x03DF7C03
qm_rldram_cal_match_win_h [0x000001A8] = 0x00000000
qm_rldram_cal_match_win_l [0x000001AC] = 0x7FFFFFFF
JIB3_DS PG registers (base address 0xF8898000)
pg_mod [0x00000050] = 0x00000000
pg_dhs [0x00000054] = 0x00000000
pg_ipg [0x0000005C] = 0x00000000
pg_num [0x00000058] = 0x00000000
pg_payload_length [0x00000060] = 0x00000000
pg_payload_value [0x00000064] = 0x00000000
pg_pkt_hdr_prog_0 [0x00000068] = 0x00000000
pg_pkt_hdr_prog_1 [0x0000006C] = 0x00000000
pg_pkt_hdr_1 [0x00000070] = 0x00000000
pg_pkt_hdr_2 [0x00000074] = 0x00000000
pg_pkt_hdr_3 [0x00000078] = 0x00000000
pg_pkt_hdr_4 [0x0000007C] = 0x00000000
pg_pkt_hdr_5 [0x00000080] = 0x00000000
pg_pkt_hdr_6 [0x00000084] = 0x00000000
Cisco IOS CMTS Cable Command Reference
CBL-1658 OL-15510-15
Cable Commands: show ch through show cr
show controller integrated-cable
JIB3_DS PMBIST registers (base address 0xF8899000)
pmbist_ena_addr [0x00000060] = 0x00000002
pmbist_din_addr [0x00000064] = 0x00000000
pmbist_dout_addr [0x0000006C] = 0x00008101
pmbist_trgt_select_addr [0x00000074] = 0x00000000
pmbist_ff_status [0x00000078] = 0x00000000
pmbist_num_wr_fr_pmbist [0x0000007C] = 0x00000000
pmbist_num_rd_fr_pmbist [0x00000080] = 0x00000000
pmbist_um_wr_2cmd_ff [0x00000084] = 0x00000000
pmbist_num_rd_2cmd_ff [0x00000088] = 0x00000000
pmbist_num_rd_rtn_pmbist [0x0000008C] = 0x00000000
pmbist_num_wr_2dram [0x00000090] = 0x00000000
pmbist_num_rd_2dram [0x00000094] = 0x00000000
pmbist_num_rd_fr_dram [0x00000098] = 0x00000000
Remora registers (base address 0xF8900000)
------------------------------------------
Remora General Registers (0xF8900000):
--------------------------------------
revision [0x00000000] = 0x00000003
hw_fpga_rev_id [0x00000004] = 0x0000000A
erp_scratch_pad0 [0x00000008] = 0x00000000
erp_scratch_pad1 [0x0000000C] = 0x00000000
Remora Reset and DCM Lock Registers (0xF8900100):
-----------------------------------------------
reset_ctrl [0x00000100] = 0x00000000
dcm_lock [0x00000104] = 0x0000000F
Remora Configuration Registers (0xF8900200):
--------------------------------------------
port_cfg[0] [0x00000200] = 0x00155549
port_cfg[1] [0x00000204] = 0x00155548
port_cfg[2] [0x00000208] = 0x00155548
port_cfg[3] [0x0000020C] = 0x00155548
port_cfg[4] [0x00000210] = 0x00155548
core_config_status [0x00000214] = 0x00000020
port_rm2tififo_prog_flags[0] [0x00000218] = 0xBBA20C0D
port_rm2tififo_prog_flags[1] [0x0000021C] = 0xBBA20C0D
port_rm2tififo_prog_flags[2] [0x00000220] = 0xBBA20C0D
port_rm2tififo_prog_flags[3] [0x00000224] = 0xBBA20C0D
port_rm2tififo_prog_flags[4] [0x00000228] = 0xBBA20C0D
Remora DFT/Pattern Inject Registers (0xF8900300):
-------------------------------------------------
alt_sym_tst_mode [0x00000300] = 0x00005A69
alt_sym_tst_en_reg [0x00000304] = 0x00000000
qdr_mem_test_en_reg [0x00000308] = 0x00000000
qdr_mem_test_rd_wr_reg [0x0000030C] = 0x00000A12
ready_for_data_input [0x00000318] = 0x0000001F
Remora ECC Registers (0xF8900400):
----------------------------------
debug_cfg [0x00000400] = 0x00000000
sniff_frame_cnt [0x00000404] = 0x00000000
ecc_parity_conf_reg [0x00000408] = 0x00000003
ecc_uncorrect_data_log_reg [0x0000040C] = 0x00002814
ecc_uncorrect_log_reg [0x00000410] = 0x00000020
ecc_correctable_data_log_reg [0x00000414] = 0x00002C14
ecc_correctable_log_reg [0x00000418] = 0x00000028
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1659
Cable Commands: show ch through show cr
show controller integrated-cable
qdr_ecc_corr_cnt_reg [0x0000041C] = 0x00000000
fatal_err_log [0x00000420] = 0x00000000
err_inj_reg [0x00000424] = 0x00000000
Remora QDR Registers (0xF8900500):
----------------------------------
qdr_phy_idelayctrl_rst_reg [0x00000500] = 0x00000000
qdr_phy_idelayctrl_rdy_err_reg [0x00000504] = 0x00000261
qdr_phy_cal_tap_dly_reg [0x00000508] = 0x00000ADB
qdr_phy_idelayctrl_ctrl_reg [0x0000050C] = 0x00000002
qdr_init_ctrl_reg [0x00000510] = 0x801FFFFF
Remora Interrupt Status Registers (0xF8900600):
-----------------------------------------------
glb_int_stat_reg [0x00000600] = 0x00000000
int_stat_gr_reg[0] [0x00000604] = 0x00000000
int_stat_gr_reg[1] [0x00000608] = 0x00000000
int_stat_gr_reg[2] [0x0000060C] = 0x00000000
int_stat_gr_reg[3] [0x00000610] = 0x00000000
int_stat_gr_reg[4] [0x00000614] = 0x00000000
misc_int_stat_reg [0x00000618] = 0x00000001
fatal_err_src_reg [0x0000061C] = 0x00000000
port_local_interrupt_enable[0] [0x00000620] = 0x0001FFFF
port_local_interrupt_enable[1] [0x00000624] = 0x0001FFFF
port_local_interrupt_enable[2] [0x00000628] = 0x0001FFFF
port_local_interrupt_enable[3] [0x0000062C] = 0x0001FFFF
port_local_interrupt_enable[4] [0x00000630] = 0x0001FFFF
misc_int_en_reg [0x00000634] = 0x00001FF8
fatal_err_en_reg [0x00000638] = 0x00000EFF
port_local_interrupt_override[0] [0x0000063C] = 0x00000000
port_local_interrupt_override[1] [0x00000640] = 0x00000000
port_local_interrupt_override[2] [0x00000644] = 0x00000000
port_local_interrupt_override[3] [0x00000648] = 0x00000000
port_local_interrupt_override[4] [0x0000064C] = 0x00000000
misc_int_override [0x00000650] = 0x00000000
fatal_err_override [0x00000654] = 0x00000000
Remora Counts Registers (0xF8900800):
-------------------------------------
illegal_ch_num_pkt_drop_count [0x00000800] = 0x00000000
fifo_full_mpeg_pkt_drop_count_hi [0x00000804] = 0x00000000
fifo_full_mpeg_pkt_drop_count_lo [0x00000808] = 0x00000000
channel_mpeg_pkt_count[0] [0x0000080C] = 0x00001118
channel_mpeg_pkt_count[1] [0x00000810] = 0x0000106B
channel_mpeg_pkt_count[2] [0x00000814] = 0x00000913
channel_mpeg_pkt_count[3] [0x00000818] = 0x00000A6D
channel_mpeg_pkt_count[4] [0x0000081C] = 0x00000000
channel_mpeg_pkt_count[5] [0x00000820] = 0x00000000
channel_mpeg_pkt_count[6] [0x00000824] = 0x00000000
channel_mpeg_pkt_count[7] [0x00000828] = 0x00000000
channel_mpeg_pkt_count[8] [0x0000082C] = 0x00000000
channel_mpeg_pkt_count[9] [0x00000830] = 0x00000000
channel_mpeg_pkt_count[10] [0x00000834] = 0x00000000
channel_mpeg_pkt_count[11] [0x00000838] = 0x00000000
channel_mpeg_pkt_count[12] [0x0000083C] = 0x00000000
channel_mpeg_pkt_count[13] [0x00000840] = 0x00000000
channel_mpeg_pkt_count[14] [0x00000844] = 0x00000000
channel_mpeg_pkt_count[15] [0x00000848] = 0x00000000
channel_mpeg_pkt_count[16] [0x0000084C] = 0x00000000
channel_mpeg_pkt_count[17] [0x00000850] = 0x00000000
channel_mpeg_pkt_count[18] [0x00000854] = 0x00000000
channel_mpeg_pkt_count[19] [0x00000858] = 0x00000000
port_re_timestamp_count[0] [0x0000085C] = 0xA6A5A6A6
port_re_timestamp_count[1] [0x00000860] = 0x00000000
Cisco IOS CMTS Cable Command Reference
CBL-1660 OL-15510-15
Cable Commands: show ch through show cr
show controller integrated-cable
port_re_timestamp_count[2] [0x00000864] = 0x00000000
port_re_timestamp_count[3] [0x00000868] = 0x00000000
port_re_timestamp_count[4] [0x0000086C] = 0x00000000
port_rx_fifo_overflow_drop_count[0] [0x00000870] = 0x00000000
port_rx_fifo_overflow_drop_count[1] [0x00000874] = 0x00000000
port_rx_fifo_overflow_drop_count[2] [0x00000878] = 0x00000000
port_rx_fifo_overflow_drop_count[3] [0x0000087C] = 0x00000000
port_rx_fifo_overflow_drop_count[4] [0x00000880] = 0x00000000
channel_jib_if_pkt_count[0] [0x00000884] = 0x00038EA2
channel_jib_if_pkt_count[1] [0x00000888] = 0x00031ADE
channel_jib_if_pkt_count[2] [0x0000088C] = 0x0001B869
channel_jib_if_pkt_count[3] [0x00000890] = 0x00020053
channel_jib_if_pkt_count[4] [0x00000894] = 0x00000000
channel_jib_if_pkt_count[5] [0x00000898] = 0x00000000
channel_jib_if_pkt_count[6] [0x0000089C] = 0x00000000
channel_jib_if_pkt_count[7] [0x000008A0] = 0x00000000
channel_jib_if_pkt_count[8] [0x000008A4] = 0x00000000
channel_jib_if_pkt_count[9] [0x000008A8] = 0x00000000
channel_jib_if_pkt_count[10] [0x000008AC] = 0x00000000
channel_jib_if_pkt_count[11] [0x000008B0] = 0x00000000
channel_jib_if_pkt_count[12] [0x000008B4] = 0x00000000
channel_jib_if_pkt_count[13] [0x000008B8] = 0x00000000
channel_jib_if_pkt_count[14] [0x000008BC] = 0x00000000
channel_jib_if_pkt_count[15] [0x000008C0] = 0x00000000
channel_jib_if_pkt_count[16] [0x000008C4] = 0x00000000
channel_jib_if_pkt_count[17] [0x000008C8] = 0x00000000
channel_jib_if_pkt_count[18] [0x000008CC] = 0x00000000
channel_jib_if_pkt_count[19] [0x000008D0] = 0x00000000
Remora Timestamp Registers (0xF8900900):
----------------------------------------
local_1024_ts_ctrl [0x00000900] = 0x00000039
local_1024_current_ts [0x00000904] = 0xF5D27575
local_1024_tcc_ts_latch [0x00000908] = 0x7291125F
doc_ts_offset_ch_0_1 [0x0000090C] = 0x04AF04AF
doc_ts_offset_ch_2_3 [0x00000910] = 0x04AF04AF
doc_ts_offset_ch_4_5 [0x00000914] = 0x04F704F7
doc_ts_offset_ch_6_7 [0x00000918] = 0x04F704F7
doc_ts_offset_ch_8_9 [0x0000091C] = 0x04F704F7
doc_ts_offset_ch_10_11 [0x00000920] = 0x04F704F7
doc_ts_offset_ch_12_13 [0x00000924] = 0x04F704F7
doc_ts_offset_ch_14_15 [0x00000928] = 0x04F704F7
doc_ts_offset_ch_16_17 [0x0000092C] = 0x04F704F7
doc_ts_offset_ch_18_19 [0x00000930] = 0x04F704F7
Remora PRATE/SRATE Registers (0xF8900A00):
------------------------------------------
port_prate_regs[0].prate_ctrl [0x00000A00] = 0x00000003
port_prate_regs[0].prate_m_prime_lo [0x00000A04] = 0x0005971E
port_prate_regs[0].prate_n_prime_lo [0x00000A08] = 0x08AA5B88
port_prate_regs[0].prate_m_prime_hi [0x00000A0C] = 0x00000000
port_prate_regs[1].prate_ctrl [0x00000A10] = 0x00000003
port_prate_regs[1].prate_m_prime_lo [0x00000A14] = 0x00000191
port_prate_regs[1].prate_n_prime_lo [0x00000A18] = 0x00037E78
port_prate_regs[1].prate_m_prime_hi [0x00000A1C] = 0x00000000
port_prate_regs[2].prate_ctrl [0x00000A20] = 0x00000003
port_prate_regs[2].prate_m_prime_lo [0x00000A24] = 0x00000191
port_prate_regs[2].prate_n_prime_lo [0x00000A28] = 0x00037E78
port_prate_regs[2].prate_m_prime_hi [0x00000A2C] = 0x00000000
port_prate_regs[3].prate_ctrl [0x00000A30] = 0x00000003
port_prate_regs[3].prate_m_prime_lo [0x00000A34] = 0x00000191
port_prate_regs[3].prate_n_prime_lo [0x00000A38] = 0x00037E78
port_prate_regs[3].prate_m_prime_hi [0x00000A3C] = 0x00000000
port_prate_regs[4].prate_ctrl [0x00000A40] = 0x00000003
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1661
Cable Commands: show ch through show cr
show controller integrated-cable
port_prate_regs[4].prate_m_prime_lo [0x00000A44] = 0x00000191
port_prate_regs[4].prate_n_prime_lo [0x00000A48] = 0x00037E78
port_prate_regs[4].prate_m_prime_hi [0x00000A4C] = 0x00000000
port_srate_regs[0].srate_ctrl [0x00000A50] = 0x00000003
port_srate_regs[0].srate_mn [0x00000A54] = 0x004E0095
port_srate_regs[1].srate_ctrl [0x00000A58] = 0x00000003
port_srate_regs[1].srate_mn [0x00000A5C] = 0x0191032C
port_srate_regs[2].srate_ctrl [0x00000A60] = 0x00000003
port_srate_regs[2].srate_mn [0x00000A64] = 0x0191032C
port_srate_regs[3].srate_ctrl [0x00000A68] = 0x00000003
port_srate_regs[3].srate_mn [0x00000A6C] = 0x0191032C
port_srate_regs[4].srate_ctrl [0x00000A70] = 0x00000003
port_srate_regs[4].srate_mn [0x00000A74] = 0x0191032C
TW_UBR10k_34.13#
The following example provides information about all controllers using the show controller
integrated-cable command and the status keyword:
Router# show controllers integrated-Cable 6/0/0 status
Load for five secs: 9%/0%; one minute: 11%; five minutes: 13%
Time source is NTP, *15:07:31.309 EDT Sun Mar 21 2010
Jib3-DS Status:
---------------
Rx SPI..............: OK
Tx SPI..............: OK
DCM Status..........: OK
ERP Status..........: OK
DOCSIS RLDRAM Status: OK
QM RLDRAM Status....: OK
DS PHY Device Information:
-------------------
Remora Version = 3.10
UPX SW Version = 0x10D
Upconverter Type:Unknown
UPX Part Number =
Device Status:
--------------
UPX Alarm Status = 0x3FF
UPX Alarm Mask = 0x19000
Table 160 describes the fields displayed in the show controller integrated-cable command output with
various keywords (as described in preceding examples).
Table 160 show controller integrated-cable Field Descriptions
Field Description
WB channel Wideband channel number.
BG ID Bonding group ID.
Bundle num Bundle number.
NB channel Narrowband channel number.
NB chan ID Narrowband channel ID.
Reserved CIR Reserved committed information rate (CIR) value.
Total CIR Total committed information rate (CIR) value.
Cisco IOS CMTS Cable Command Reference
CBL-1662 OL-15510-15
Cable Commands: show ch through show cr
show controller integrated-cable
Table 160 show controller integrated-cable Field Descriptions (continued)
Field Description
Controller Chan Controller channel number.
RF Packets RF packets.
MPEG bps MPEG value in bps.
MPEG mbps MPEG value in Mbps.
MPEG Packets MPEG packets.
Sync Packets Synchronization packets.
MAP/UCD MAP/ UCD value
Tx Packets Tx packets
Tx Octets Tx octets
Offset Memory offset
Register Line card registers
Value Register values.
BPI Index Baseline Privacy Interface (BPI) index number.
Segment Hardware segment being used by DOCSIS MAC.
Even Key Current value of the Even Key in the BPI entry.
Odd Key Current value of the Odd Key in the BPI entry.
Key Sequence Number Key sequence number.
Security Association Security association identifier.
Key Type The type of key stored based on the encryption algorithm (Data
Encryption Standard [DES] or Advanced Encryption Standard [AES]).
Related Commands Command Description
cable Enables static or dynamic bandwidth sharing for a modular cable (MC)
rf-bandwidth-percent interface.
cable upstream Maps an upstream port to a physical port on the Cisco UBR-MC20X20V
connector cable interface line card for use with a particular downstream.
show controller cable Displays information about the interface controllers for a cable interface
on the Cisco CMTS router.
show hw-module bay Displays information about the wideband channels or RF channels on a
Wideband SPA.
show interface cable Displays the current configuration and status of a cable interface.
Cisco IOS CMTS Cable Command Reference
OL-15510-15 CBL-1663
Cable Commands: show ch through show cr
show controllers cable
show controllers cable
To display information about the interface controllers on a cable interface on the Cisco CMTS router,
use the show controllers cable command in user EXEC or privileged EXEC mode.
show controllers cable {slot/port| slot/subslot//port} [downstream | upstream [port] | [ipc]
[mem-stat] [memory] [proc-cpu]
Cisco IOS Release 12.2(33)SCE and later
show controllers cable {slot/cable-interface-index| slot/subslot//cable-interface-index}
[downstream | upstream [upstream-index] | [ipc] [mem-stat] [memory] [proc-cpu]
Syntax Description slot Slot where the 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 uBR7100 series router—The valid value is 1.
subslot (Cisco uBR10012 only) Secondary subslot of the cable interface
line card. The valid slots are 0 or 1.
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.
downstream (Optional) Displays the downstream interface status.
upstream (Optional) Displays the upstream interface status.
port (Optional) Specifies the desired upstream port. Valid values start
with 0 for the first upstream port on the cable interface line card.
upstream-index (Optional) Specifies the desired index for the upstream port. Valid
values for the Cisco uBR-MC20X20V and Cisco uBR-MC5X20
line cards range from 0 to 3.
ipc (Optional) Displays the Inter-Process Communication (IPC)
information between different line cards.
mem-stat (Optional) Displays the output from the show memory statistics
command that contains a summary of memory statistics for a
Broadband Processing Engine (BPE) cable interface line card.
Cisco IOS CMTS Cable Command Reference
CBL-1664 OL-15510-15
Cable Commands: show ch through show cr
show controllers cable
memory (Optional) Displays the output from the show memory command
that contains a summary of memory statistics, including the
memory as it is allocated per process, for a BPE cable interface
line card.
proc-cpu (Optional) Displays the output from the show processes cpu
command that contains the processor status for a BPE cable
interface line card.
Command Modes User EXEC, Privileged EXEC (#)
Command History Release Modification
11.3 NA This command was introduced.
12.0(2)XC This command was modified to show a number of additional fields.
12.1(5)EC1 Support was added for the Cisco uBR7100 series router, including
information about the Cisco uBR
You might also like
- Command Reference, Cisco IOS XE 17.15.x (Catalyst 9400 Switches)No ratings yetCommand Reference, Cisco IOS XE 17.15.x (Catalyst 9400 Switches)2,468 pages
- Configuration Register Information For The CiscoNo ratings yetConfiguration Register Information For The Cisco2,142 pages
- Cisco Mobility Express Command Reference, Release 8.3100% (1)Cisco Mobility Express Command Reference, Release 8.31,158 pages
- Cisco IOS Command Summary, Volume 1 of 3 (Release 12.2)No ratings yetCisco IOS Command Summary, Volume 1 of 3 (Release 12.2)734 pages
- Cisco IOS Configuration Fundamentals Configuration Guide100% (2)Cisco IOS Configuration Fundamentals Configuration Guide514 pages
- Qos Command Reference, Cisco Ios Release 15.2 (2) E (Catalyst 2960-X Switch)No ratings yetQos Command Reference, Cisco Ios Release 15.2 (2) E (Catalyst 2960-X Switch)120 pages
- Cisco IOS IP Command Reference Part 1 of 3No ratings yetCisco IOS IP Command Reference Part 1 of 3448 pages
- Avast 2050 License Faker by ZeNiX 2014-03-14 enNo ratings yetAvast 2050 License Faker by ZeNiX 2014-03-14 en1 page
- CIsco IOS Configuration Fundamentals Command ReferenceNo ratings yetCIsco IOS Configuration Fundamentals Command Reference974 pages
- Cisco IOS Interface and Hardware Component Command Reference PDFNo ratings yetCisco IOS Interface and Hardware Component Command Reference PDF2,524 pages
- Catalyst 4500 Series Switch Cisco IOS Software Configuration GuideNo ratings yetCatalyst 4500 Series Switch Cisco IOS Software Configuration Guide608 pages
- T1/E1 Digital Voice Port Adapter Installation and ConfigurationNo ratings yetT1/E1 Digital Voice Port Adapter Installation and Configuration96 pages
- Cisco 2650XM Gateway-PBX Interoperability: Ericsson MD110 PBX Using Q.931 BRI Interfaces To An H.323 GatewayNo ratings yetCisco 2650XM Gateway-PBX Interoperability: Ericsson MD110 PBX Using Q.931 BRI Interfaces To An H.323 Gateway7 pages
- Coping With Stress in Middle and Late Adolescence100% (1)Coping With Stress in Middle and Late Adolescence11 pages
- Tutorial Chapter 7 Inventory ManagementNo ratings yetTutorial Chapter 7 Inventory Management31 pages
- How To Choose ESC For Racing Drones, Mini Quad and Quadcopters - Oscar Liang100% (1)How To Choose ESC For Racing Drones, Mini Quad and Quadcopters - Oscar Liang19 pages
- 09-Ingl - Mouse Manta Apego Plana-SaschaNo ratings yet09-Ingl - Mouse Manta Apego Plana-Sascha3 pages
- LIC - Jeevan Akshay VII - Sales Brochure - 4 Inch X 9 Inch - Eng - SingleNo ratings yetLIC - Jeevan Akshay VII - Sales Brochure - 4 Inch X 9 Inch - Eng - Single12 pages
- Arts-Based Research As A Place To Inquiring and Thinking The Unthinkable in Academia and BeyondNo ratings yetArts-Based Research As A Place To Inquiring and Thinking The Unthinkable in Academia and Beyond6 pages
- Capacity Planning and Docsis Traffic EngineeringNo ratings yetCapacity Planning and Docsis Traffic Engineering11 pages
- 03-09-01 Spectrum Analyzer CNR Versus CMT SNRNo ratings yet03-09-01 Spectrum Analyzer CNR Versus CMT SNR2 pages
- LEARN MPLS FROM SCRATCH PART-A: A Beginner's Guide to Next Level of NetworkingFrom EverandLEARN MPLS FROM SCRATCH PART-A: A Beginner's Guide to Next Level of NetworkingNo ratings yet
- Hybrid Computing for BLDC Speed Control and Stability AnalysisFrom EverandHybrid Computing for BLDC Speed Control and Stability AnalysisNo ratings yet
- ISA Certified Automation Professional (CAP) Associate: Certification Exam Prep: 500 Practice Exam Questions and ExplanationsFrom EverandISA Certified Automation Professional (CAP) Associate: Certification Exam Prep: 500 Practice Exam Questions and ExplanationsNo ratings yet
- Alcatel-Lucent Service Routing Architect (SRA) Self-Study Guide: Preparing for the BGP, VPRN and Multicast ExamsFrom EverandAlcatel-Lucent Service Routing Architect (SRA) Self-Study Guide: Preparing for the BGP, VPRN and Multicast ExamsNo ratings yet
- PLC: Programmable Logic Controller – Arktika.: EXPERIMENTAL PRODUCT BASED ON CPLD.From EverandPLC: Programmable Logic Controller – Arktika.: EXPERIMENTAL PRODUCT BASED ON CPLD.No ratings yet
- Exploring BeagleBone: Tools and Techniques for Building with Embedded LinuxFrom EverandExploring BeagleBone: Tools and Techniques for Building with Embedded Linux4/5 (2)
- LEARN MPLS FROM SCRATCH PART-B: A Beginners guide to next level of networkingFrom EverandLEARN MPLS FROM SCRATCH PART-B: A Beginners guide to next level of networkingNo ratings yet
- CISCO PACKET TRACER LABS: Best practice of configuring or troubleshooting NetworkFrom EverandCISCO PACKET TRACER LABS: Best practice of configuring or troubleshooting NetworkNo ratings yet
- Network Security All-in-one: ASA Firepower WSA Umbrella VPN ISE Layer 2 SecurityFrom EverandNetwork Security All-in-one: ASA Firepower WSA Umbrella VPN ISE Layer 2 SecurityNo ratings yet
- Network with Practical Labs Configuration: Step by Step configuration of Router and Switch configurationFrom EverandNetwork with Practical Labs Configuration: Step by Step configuration of Router and Switch configurationNo ratings yet
- WAN TECHNOLOGY FRAME-RELAY: An Expert's Handbook of Navigating Frame Relay NetworksFrom EverandWAN TECHNOLOGY FRAME-RELAY: An Expert's Handbook of Navigating Frame Relay NetworksNo ratings yet
- BICSI RCDD Registered Communications Distribution Designer Exam Prep And Dumps RCDD-001 Exam Guidebook Updated QuestionsFrom EverandBICSI RCDD Registered Communications Distribution Designer Exam Prep And Dumps RCDD-001 Exam Guidebook Updated QuestionsNo ratings yet
