Table Of Contents
Cable Commands: show a through show cable l
show application-buckets
show bridge cable-modem
show cable acfe controller
show cable acfe interface
show cable acfe summary
show cable active-reman
show cable admission-control
show cable arp-filter
show cable bgsync
show cable bundle
show cable bundle multicast
show cable burst-profile
show cable calls
show cable cgd-associations
show cable clock
show cable clock dti counters
show cable clock dti status
show cable device access-group
show cable dsg
show cable dsg cfr
show cable dsg host
show cable dsg static-group bundle
show cable dsg tg
show cable dsg tunnel
show cable dsg tg
show cable dsg tunnel
show cable dynamic-qos trace
show cable fiber-node
show cable filter
show cable flap-list
show cable flap-list wb-rf
show cable hop
show cable host access-group
show cable ib-ipc
show cable ipc-stats
show cable l2-vpn dot1q-vc-map
show cable l2-vpn vc-map
show cable l2-vpn xconnect
show cable leasequery-filter
show cable licenses all
show cable load-balance
show cable load-balance docsis-group
show cable logging
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
|
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
|
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
For bucket 3, Name Gaming
Related Commands
Command
|
Description
|
cable admission-control ds-bandwidth
|
Sets minor, major and exclusive thresholds for downstream voice or data bandwidth for each or all interfaces on the Cisco CMTS
|
cable admission-control preempt priority-voice
|
Changes the default PacketCable Emergency 911 call 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 us-bandwidth
|
Configures global or interface-level upstream 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 flow-categorization
|
Displays service flow categorization results, enabled when a 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 admission-control reservation
|
Displays service flows, categorizations, and bandwidth consumption on the Cisco CMTS, for the specified interface, and the specified service flow direction.
|
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
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.
|
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.
|
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
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
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 interface
|
Displays fairness across DOCSIS interfaces statistics of a specific interface.
|
show cable acfe summary
|
Displays fairness across DOCSIS interfaces status and statistics.
|
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
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
Router# show cable acfe interface wideband-Cable 1/0/0:1
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
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 controller
|
Displays fairness across DOCSIS interfaces controller statistics.
|
show cable acfe summary
|
Displays fairness across DOCSIS interfaces status and statistics.
|
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
EIR Rebalance period (secs): 5
EIR Rebalance invocations: 32416
CIR Acquire invocations: 1
CIR Acquire rate/limit: 100/100
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.
|
Related Commands
Command
|
Description
|
cable acfe enable
|
Enables Fairness Across DOCSIS Interfaces feature on the CMTS router.
|
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
[slot_index 1]: work_slot:3/0, active_slot:3/0, is_protect:FALSE, is_standby
[slot_index 2]: work_slot:5/0, active_slot:5/0, is_protect:FALSE, is_standby
[slot_index 3]: work_slot:5/1, active_slot:5/1, is_protect:TRUE , is_standby
[slot_index 4]: work_slot:6/0, active_slot:6/0, is_protect:FALSE, is_standby
[slot_index 5]: work_slot:6/1, active_slot:6/1, is_protect:FALSE, is_standby
[slot_index 6]: work_slot:7/0, active_slot:7/0, is_protect:FALSE, is_standby
[slot_index 7]: work_slot:7/1, active_slot:7/1, is_protect:FALSE, is_standby
[slot_index 8]: work_slot:8/0, active_slot:8/0, is_protect:FALSE, is_standby
[slot_index 9]: work_slot:8/1, active_slot:8/1, is_protect:FALSE, is_standby
-------------------------------------------------------------
Active Reman info on LC 5/1:
[slot_index 0]: work_slot:1/0, active_slot:1/0, is_protect:FALSE, is_standby
[slot_index 1]: work_slot:3/0, active_slot:3/0, is_protect:FALSE, is_standby
[slot_index 2]: work_slot:5/0, active_slot:5/0, is_protect:FALSE, is_standby
[slot_index 3]: work_slot:5/1, active_slot:5/1, is_protect:TRUE , is_standby
[slot_index 4]: work_slot:6/0, active_slot:6/0, is_protect:FALSE, is_standby
[slot_index 5]: work_slot:6/1, active_slot:6/1, is_protect:FALSE, is_standby
[slot_index 6]: work_slot:7/0, active_slot:7/0, is_protect:FALSE, is_standby
[slot_index 7]: work_slot:7/1, active_slot:7/1, is_protect:FALSE, is_standby
[slot_index 8]: work_slot:8/0, active_slot:8/0, is_protect:FALSE, is_standby
[slot_index 9]: work_slot:8/1, active_slot:8/1, is_protect:FALSE, is_standby
-------------------------------------------------------------
Active Reman info on LC 6/0:
[slot_index 0]: work_slot:1/0, active_slot:1/0, is_protect:FALSE, is_standby
[slot_index 1]: work_slot:3/0, active_slot:3/0, is_protect:FALSE, is_standby
[slot_index 2]: work_slot:5/0, active_slot:5/0, is_protect:FALSE, is_standby
[slot_index 3]: work_slot:5/1, active_slot:5/1, is_protect:TRUE , is_standby
[slot_index 4]: work_slot:6/0, active_slot:6/0, is_protect:FALSE, is_standby
[slot_index 5]: work_slot:6/1, active_slot:6/1, is_protect:FALSE, is_standby
[slot_index 6]: work_slot:7/0, active_slot:7/0, is_protect:FALSE, is_standby
[slot_index 7]: work_slot:7/1, active_slot:7/1, is_protect:FALSE, is_standby
[slot_index 8]: work_slot:8/0, active_slot:8/0, is_protect:FALSE, is_standby
[slot_index 9]: work_slot:8/1, active_slot:8/1, is_protect:FALSE, is_standby
-------------------------------------------------------------
Active Reman info on LC 7/0:
[slot_index 0]: work_slot:1/0, active_slot:1/0, is_protect:FALSE, is_standby
[slot_index 1]: work_slot:3/0, active_slot:3/0, is_protect:FALSE, is_standby
[slot_index 2]: work_slot:5/0, active_slot:5/0, is_protect:FALSE, is_standby
[slot_index 3]: work_slot:5/1, active_slot:5/1, is_protect:TRUE , is_standby
[slot_index 4]: work_slot:6/0, active_slot:6/0, is_protect:FALSE, is_standby
[slot_index 5]: work_slot:6/1, active_slot:6/1, is_protect:FALSE, is_standby
[slot_index 6]: work_slot:7/0, active_slot:7/0, is_protect:FALSE, is_standby
[slot_index 7]: work_slot:7/1, active_slot:7/1, is_protect:FALSE, is_standby
[slot_index 8]: work_slot:8/0, active_slot:8/0, is_protect:FALSE, is_standby
[slot_index 9]: work_slot:8/1, active_slot:8/1, is_protect:FALSE, is_standby
-------------------------------------------------------------
Active Reman info on LC 8/0:
[slot_index 0]: work_slot:1/0, active_slot:1/0, is_protect:FALSE, is_standby
[slot_index 1]: work_slot:3/0, active_slot:3/0, is_protect:FALSE, is_standby
[slot_index 2]: work_slot:5/0, active_slot:5/0, is_protect:FALSE, is_standby
[slot_index 3]: work_slot:5/1, active_slot:5/1, is_protect:TRUE , is_standby
[slot_index 4]: work_slot:6/0, active_slot:6/0, is_protect:FALSE, is_standby
[slot_index 5]: work_slot:6/1, active_slot:6/1, is_protect:FALSE, is_standby
[slot_index 6]: work_slot:7/0, active_slot:7/0, is_protect:FALSE, is_standby
[slot_index 7]: work_slot:7/1, active_slot:7/1, is_protect:FALSE, is_standby
[slot_index 8]: work_slot:8/0, active_slot:8/0, is_protect:FALSE, is_standby
[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
[slot_index 1]: work_slot:3/0, active_slot:3/0, is_protect:FALSE, is_standby
[slot_index 2]: work_slot:5/0, active_slot:5/0, is_protect:FALSE, is_standby
[slot_index 3]: work_slot:5/1, active_slot:5/1, is_protect:TRUE , is_standby
[slot_index 4]: work_slot:6/0, active_slot:6/0, is_protect:FALSE, is_standby
[slot_index 5]: work_slot:6/1, active_slot:6/1, is_protect:FALSE, is_standby
[slot_index 6]: work_slot:7/0, active_slot:7/0, is_protect:FALSE, is_standby
[slot_index 7]: work_slot:7/1, active_slot:7/1, is_protect:FALSE, is_standby
[slot_index 8]: work_slot:8/0, active_slot:8/0, is_protect:FALSE, is_standby
[slot_index 9]: work_slot:8/1, active_slot:8/1, is_protect:FALSE, is_standby
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 | slot/subslot/port
|
Displays admission control information for the specified interface. This 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.
|
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
Resource - Upstream Bandwidth
-----------------------------
Thresholds applicable to upstream ports with no interface level
Bucket Minor Major Exclusive Non-Excls
No Level Level Level Level
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
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 #
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 #
Available Guaranteed Bonus BW (bps): 2531250
Available Non-guaranteed Bonus BW (bps): 10125000
WB Multicast CIR Utilization
Bkt SFAC BW Rsvd CIR Reject #
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
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
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
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
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
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
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
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
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.
|
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 event
|
Counter increments once for every cable modem that crosses a threshold 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 event
|
Configures and enables AC event types.
|
cable admission-control ds-bandwidth
|
Configures AC downstream bandwidth thresholds.
|
cable admission-control max-reserved-bandwidth
|
Defines the maximum reserved bandwidth per bonding group for all service flows that are allowed by the Cisco CMTS.
|
cable admission-control us-bandwidth
|
Configures AC upstream bandwidth thresholds.
|
clear cable admission control counters
|
Clears all AC resource counters.
|
debug cable admission-control
|
Enables automatic AC troubleshooting processes.
|
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 number]
|
(Optional) Displays the Service IDs (SIDs) that are generating or forwarding 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 number]
|
(Optional) Displays the Service IDs (SIDs) that are generating or forwarding 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 number]
|
(Optional) Displays the Service IDs (SIDs) that are generating or filtering 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.
|
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
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.
|
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
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
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
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
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
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.
|
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 background sync packets: 3584
Bg sync data IPC lost packets: 0
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.
|
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
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
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.
|
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
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.
|
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, 12.0(6)SC, 12.1(2)EC1
|
This command was removed and replaced with the show cable 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
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 modulation-profile
|
Configures a spectrum group to use a specified frequency.
|
show cable hop
|
Displays CM configuration settings.
|
show cable modulation-profile
|
Displays the currently defined modulation profiles.
|
show interface cable sid
|
Displays cable interface information.
|
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
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:
Interface ActiveHiPriCalls ActiveAllCalls PostHiPriCallCMs RecentHiPriCMs
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:
Interface ActiveHiPriCalls ActiveAllCalls PostHiPriCallCMs RecentHiPriCMs
Related Commands
Command
|
Description
|
cable high-priority-call-window
|
Sets the call window (in minutes) during which the Cisco CMTS maintains records of Emergency 911 calls.
|
show cable modem calls
|
Displays voice call information for a particular cable modem.
|
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 and Cisco uBR-MC20X20V line cards:
Router# show cable cgd-associations
CGD Host Resource DS Channels Upstreams (AllUS) Active Remote DS
Note
In the AllUS field, Yes indicates all the upstream channels are associated with the downstream channels in the MAC domain. If the AllUS field is blank, all the upstream channels are not associated with the downstream channels.
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
|
Association of upstream channels in the MAC domain.
|
(AllUS)
|
Association of all upstream channels with downstream 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 downstream-service-group
|
Displays the MAC Domain Downstream Service Group information for a primary downstream channel.
|
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, 12.2(4)BC1
|
This command was supported for the Cisco uBR10012 universal broadband 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.
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:
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:
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
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:
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
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.
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
-------------------------------------------
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
Cisco RF Gateway 10
The following example shows the TCC DTI client and server statistic counts information:
DTI Client status: TCC 13
Client clock type : ITU type 1
Client firmware version : 7
Client timestamp : 657519453
Client phase correction : 65535
Client normal time : 65535
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
DTI Client Port 1 Status:
-------------------------
-- Connected server information ---
Server status : Active free-run
Root Server clock type : ITU type 3
Root Server source : none
Client Performance Stable : yes
Client Cable advance Valid : yes
DTI Client Port 2 Status:
-------------------------
DTI Client status: TCC 14
Client clock type : ITU type 1
Client firmware version : 7
Client timestamp : 672169320
Client phase correction : 65535
Client normal time : 65535
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
DTI Client Port 1 Status:
-------------------------
DTI Client Port 2 Status:
-------------------------
-- Connected server information ---
Server status : Active free-run
Root Server clock type : ITU type 3
Root Server source : none
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:
-------------------------
Table 49 describes the significant fields shown in the display.
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
Root Server clock type : ITU type 3
Root Server source : none
Client Performance Stable : yes
Client Cable advance Valid : yes
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
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.
|
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.
|
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
Active TCC card in slot 1/1
-------------------------------------------
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
Related Commands
Command
|
Description
|
show cable clock
|
Displays clock reference status information for the clock card.
|
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
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
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.
|
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.
|
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
The following example shows a typical display for the show cable dsg stats command:
Router# show cable dsg stats
DSG statistics information
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
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
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
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
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
Router# show cable dsg stats vendor CCC
DSG statistics information
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
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.
|
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.
|
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
1010 en yes yes no 232.10.10.10 dsg-server-b
2000 en yes yes no 232.10.11.0 dsg-server-c
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
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
Error Code : 0(DSG_CFR_ERR_NONE)
Src Hostname : dsg-server-a
Src Hostname IP : 40.0.0.30
Error Code : 0(DSG_CFR_ERR_NONE)
Src Hostname : dsg-server-b
Src Hostname IP : 40.0.0.40
Error Code : 0(DSG_CFR_ERR_NONE)
Src Hostname : dsg-server-c
Src Hostname IP : 40.0.0.50
Error Code : 0(DSG_CFR_ERR_NONE)
Src Hostname : non-exist-hostname
Error Code : 0(DSG_CFR_ERR_NONE)
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
Error Code : 0(DSG_CFR_ERR_NONE)
Src Hostname : dsg-server-b
Src Hostname IP : 40.0.0.40
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.
|
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.
|
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
dsgserver6 235.5.5.5 1 21:41 08/01/2011
dsgserver7 235.0.0.2 1 21:41 08/01/2011
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
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
cable dsg cfr 4 dest-ip aaabbccc priority 0 src-ip cccdddeee disable
cable dsg cfr 4 dest-ip aaabbccc priority 0 src-ip cccdddeee disable
dsgserver4 235.0.0.2 1 21:41 08/01/2011
cable dsg cfr 24 dest-ip g2 priority 0 disable
dsgserver5 235.0.0.3 1 21:41 08/01/2011
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.
|
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.
|
Related Commands
Command
|
Description
|
cable dsg cfr
|
Enables Advanced-mode DOCSIS Set-Top Gateway (A-DSG) classifiers on the Cisco CMTS router.
|
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
----- ----- ----- ------ ---- ------ ---------------
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
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
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
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
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
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
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.
|
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 dsg downstream
|
Displays A-DSG configuration and status information for downstream interfaces.
|
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
verbose Show DSG tunnel detail information
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
2 en 0100.5e01.011e 2 en Cable6/0 2 en 2 NDS-CA
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
6 dis 0100.5e01.0146 Cable6/0 6 en 6 SA-CA
7 dis 0100.5e01.0150 7 en Cable6/1 8 en 7 SA-APP
8 en 0100.5e01.0119 8 en NDS-DNLD
9 en 0100.5e01.0133 MOTO-DNLD
10 en 0100.5e01.0147 SA-DNLD
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
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
5 en 0002.0002.0002 2 5 en C5/0 5 en 2 DSG-Rate2
6 en 0002.0002.0003 2 9 en C5/0 6 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
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
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
8 MAC Addr 1111.1111.1111
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
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
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
MAC Addr : 0100.5e01.0114
Client Id Type : CA System ID: 0951
Client Id Type : Broadcast
Client Id Type : MAC Addr: 1111.1111.1111
Client Id Type : Application ID: 0001
Client Id Type : CA System ID: 0701
Client Id Type : Application ID: 0006
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
MAC Addr : 0100.5e01.0001
Client Id Type : MAC Addr 0100.5e00.0001
Client Id Type : Application ID 0x0951
Client Id Type : Broadcast Unspecified
Client Id Type : Broadcast 4
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 dsg downstream
|
Displays A-DSG configuration and status information for downstream interfaces.
|
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
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
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
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
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
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
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.
|
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 dsg downstream
|
Displays A-DSG configuration and status information for downstream interfaces.
|
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 ?
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
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
2 en 0100.5e01.011e 2 en Cable6/0 2 en 2 NDS-CA
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
6 dis 0100.5e01.0146 Cable6/0 6 en 6 SA-CA
7 dis 0100.5e01.0150 7 en Cable6/1 8 en 7 SA-APP
8 en 0100.5e01.0119 8 en NDS-DNLD
9 en 0100.5e01.0133 MOTO-DNLD
10 en 0100.5e01.0147 SA-DNLD
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
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
5 en 0002.0002.0002 2 5 en C5/0 5 en 2 DSG-Rate2
6 en 0002.0002.0003 2 9 en C5/0 6 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
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
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
8 MAC Addr 1111.1111.1111
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
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
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
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
MAC Addr : 0100.5e01.0114
Client Id Type : CA System ID: 0951
Client Id Type : Broadcast
Client Id Type : MAC Addr: 1111.1111.1111
Client Id Type : Application ID: 0001
Client Id Type : CA System ID: 0701
Client Id Type : Application ID: 0006
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
MAC Addr : 0100.5e01.0001
Client Id Type : MAC Addr 0100.5e00.0001
Client Id Type : Application ID 0x0951
Client Id Type : Broadcast Unspecified
Client Id Type : Broadcast 4
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 dsg downstream
|
Displays A-DSG configuration and status information for downstream interfaces.
|
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.
|
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.
|
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
downstream Modular-Cable 1/0/0: 0-3
upstream Cable 7/1: 10-19
FN Config Status: Configured (status flags = 0x01)
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.
|
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.
|
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
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
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
The following shows typical output for the verbose form of this command:
Router# show cable filter group 10 index 10 verbose
Source IP Address : 10.7.7.7/16
Destination IP Address : 10.8.8.8/16
IP ToS (Mask, Value) : 1, 2
TCP/UDP Source Port : 2000
TCP/UDP Destination Port : 3000
TCP Flags (mask, value) : 0, 0
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
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
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
254 128Y Use Verbose Use Verbose drop active
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
Source IPv6 address : 2001:33::20B:BFFF:FEA9:741F/128
Destination IPv6 address : 2001:1::224/128
Table 62 describes the output fields.
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
Matches: Source IPv6 address
|
• Source IP address—IPv4 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.
• 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
Matches: Destination IPv6 address
|
• Destination IP address—IPv4 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.
• 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.
|
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.
|
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.
|
12.0(7)XR and 12.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.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
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.
|
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.
|
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
|
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).
|
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 the 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 modem
|
Displays information about all CMs on an interface or about a particular CM.
|
show cable modem flap
|
Displays flap list statistics for one or more cable modems.
|
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 |
integrated-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.
|
integrated-cable slot/bay/port
|
(Optional) Displays information for all CMs on the specified integrated 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
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
-------- ------- ------- ------- ------- ----- ------- -------
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 flap
|
Displays flap list statistics for one or more cable modems.
|
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.
|
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:
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
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.
|
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.
|
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 hop period
|
Changes the minimum time between frequency hops.
|
cable spectrum-group hop threshold
|
Specifies a frequency hop threshold for a spectrum group.
|
cable upstream hop-priority
|
Configures the priority of the corrective actions to be taken when a frequency hop is necessary due to ingress noise on the upstream.
|
cable upstream modulation-profile
|
Configures up to three modulation profiles to an upstream port to activate Dynamic Upstream Modulation.
|
cable upstream threshold
|
Configures the upstream for the CNR and FEC threshold values to be used in determining the allowable noise levels.
|
cable upstream threshold hysteresis
|
Configures a hysteresis value to be used in conjunction with the dynamic 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 access-group
|
Displays the statistics for the host behind the CM.
|
show cable modem
|
Displays CM configuration settings.
|
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
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
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.
|
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
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
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)
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
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
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
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
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
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
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
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
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
Table 1 describes the fields displayed by the show cable ipc-stats command.
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.
|
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.
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
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
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
Cable Interface : Cable5/0
Ethernet Interface : GigabitEthernet2/0
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.
|
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
Cable Interface : Cable6/0/0
Downstream CFRID[SFID] : 2[24]
Ethernet Interface : GigabitEthernet4/0/0
Total US pkt Discards : 0
Total US byte Discards : 0
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
Cable Interface : Cable6/0/0
DUT Control/CMIM : Enable/0xFFFFFFFF
Downstream CFRID[SFID] : 2[24]
Ethernet Interface : GigabitEthernet4/0/0
Total US pkt Discards : 0
Total US byte Discards : 0
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 [SFID]
|
Downstream classifiers (classifier identifiers) and corresponding 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.
|
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 Discards
|
Total number of packets and bytes dropped on the upstream to the Layer 2 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 Discards
|
Total number of packets and bytes dropped on the downstream from the Layer 2 tunnel by this CM.
|
Related Commands
Command
|
Description
|
cable l2-vpn-service dot1q
|
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 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 default-nsi
|
Configures an Ethernet Network System Interface for Layer 2 VPN support over cable.
|
debug cable l2-vpn
|
Displays debugging messages for the Layer 2 mapping of cable modems to particular PVCs or VLANs.
|
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
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
0001.0203.0405 ATM3/0.2 1/2 Cable5/0 3 0
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 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.
|
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.
|
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 customer-name
|
(Optional) Specifies the 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
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
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
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
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
Cable Interface : Cable5/0/1
Backup enable delay : 0 seconds
Backup disable delay : 0 seconds
Peer IP Address (Active) : 10.8.8.8
Total US bytes : 586227332
Total US pkts discards : 0
Total US bytes discards : 0
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.
|
Related Commands
Command
|
Description
|
show xconnect
|
Displays information about attachment circuits and pseudowires.
|
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, 12.2(15)BC2b
|
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)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.
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
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 leasequery-filter downstream
|
Controls the number of DHCP lease query messages that are sent for unknown IP addresses on all cable downstream interfaces on the Cisco CMTS router.
|
cable source-verify leasequery-filter upstream
|
Controls the number of DHCP lease query messages that are sent for unknown IP addresses for each SID on an upstream.
|
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
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
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.
|
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.
|
12.2(33)SCG
|
A new column in the output displays the group index for the legacy LBG.
|
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% --- --- ---
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 LBG. The Group Index column identifies the mapping between the legacy LBG 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% --- --- ---
Interface State Group Utilization Reserved Modems Flows Weight
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
Interface State Group Target
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/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/U3 up 1 Cable5/0/4/U2
Mo1/0/0:0 (555 MHz) down 1
Target interface State Transfers
Complete Pending Retries Failures
Cable5/0/3 (459 MHz) up 3 1 0 0
Cable5/0/4 (465 MHz) up 0 0 0 0
Mo1/0/0:0 (555 MHz) down 0 0 0 0
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
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 LBG.
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
DOCSIS load-balancing load
Interface State Group Utilization Rsvd NBCM WB/UB Flows Weight
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
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
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
Interface State Group Target
In7/0/0:0 (573 MHz) up 2 In7/0/0:2 (585 MHz) [enforce]
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/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/1 (0 MHz) down 514
Target interface State Transfers
Complete Pending Retries Failures
In7/0/0:0 (573 MHz) up 1 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: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
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
Table 1 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 LBG 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.
|
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.
|
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 LBG as configured using the cable load-balance group interval command.
|
Method
|
Load balancing method used for the LBG 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%.
|
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.
|
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 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 balancing group should use for load balancing operations.
|
show cable load-balance docsis-group
|
Displays real time configurational, statistical, and operational information of the load balancing operations on the router.
|
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 slot/subslot/cable-interface-index
|
Specifies the MAC domain interface of the fiber node.
• 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.
• 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.
|
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
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
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
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
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 Operating Mode
|
NBCM Total
|
WB/UB Total
|
Flows
|
Downstream (DS)
|
Upstream (US)
|
DS
|
US
|
DS
|
US
|
Non-MRC mode (online, NB CM)
|
Count primary
|
Count single US
|
Not counted
|
Not counted
|
Count service flow (SF) of primary
|
Count SF of single US
|
MRC mode only (w-online, WB CM)
|
Not counted
|
Count single US
|
Count primary and secondary
|
Count single US
|
Not counted
|
Count SF of single US
|
MTC mode (UB online, UB CM)
|
Not counted
|
Not counted
|
Count primary and secondary
|
Count all TCS channels
|
Not counted
|
Not counted on upstream 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
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/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
Cable1/0 (453 MHz) up 82 Cable1/1 (459 MHz) [enforce]
Cable1/1 (459 MHz) 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
Note
The priority for an excluded modem is displayed as "!".
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
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
Primary DS MAC Address RCC-ID
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
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 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
Interface State Group Utilization Reserved Modems Flows Weight
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
Interface State Group Target
Cable1/0 (453 MHz) up 82 Cable1/1 (459 MHz) [enforce]
Cable1/1 (459 MHz) initial 82
Target interface State Transfers
Complete Pending Retries Failures
Cable1/0 (453 MHz) up 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
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 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
DOCSIS load-balancing load
Interface State Group Utilization Rsvd NBCM WB/UB Flows Weight
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
Interface State Group Target
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/U2 up 81 Cable7/0/0/U1 [enforce]
Cable7/0/0/U3 up 81 Cable7/0/0/U1 [enforce]
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/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/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/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/U2 up 81 Mo1/0/0:3/U1 [enforce]
Mo1/0/0:3/U3 up 81 Mo1/0/0:3/U1 [enforce]
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:1 (507 MHz) up 17 0 0 0
Mo1/0/0:2 (513 MHz) up 19 0 0 0
Mo1/0/0:3 (519 MHz) up 9 0 0 0
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
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
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
DOCSIS load-balancing load
Interface State Group Utilization Rsvd NBCM WB/UB Flows Weight
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
DOCSIS load-balancing load
Interface State Group Utilization Rsvd NBCM WB/UB Flows Weight
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
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
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
Interface State Group Target
Mo6/1/0:0 (405 MHz) initial 82
Mo6/1/0:0 (405 MHz) initial 44290
Mo6/1/0:0/U0 initial 44290
Mo6/1/0:0/U1 initial 44290
Mo6/1/0:0/U2 initial 44290
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/U1 up 81 Cable7/0/0/U0
Mo1/0/0:0 (501 MHz) up 81
Mo1/0/0:0 (501 MHz) up 48129
Mo1/0/0:0/U1 up 81 Mo1/0/0:0/U0
Mo1/0/0:1 (507 MHz) up 81
Mo1/0/0:1 (507 MHz) up 48129
Mo1/0/0:1/U1 up 81 Mo1/0/0:1/U0
Mo1/0/0:2 (513 MHz) up 81
Mo1/0/0:2 (513 MHz) up 48129
Mo1/0/0:2/U1 up 81 Mo1/0/0:2/U0
Mo1/0/0:3 (519 MHz) up 81
Mo1/0/0:3 (519 MHz) up 48129
Mo1/0/0:3/U1 up 81 Mo1/0/0:3/U0
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/U7 initial 55808
Mo1/0/0:5 (531 MHz) initial 55808
Mo1/0/0:5/U7 initial 55808
Mo1/0/0:6 (537 MHz) up 55808
Mo1/0/0:6/U7 initial 55808
Mo1/0/0:7 (543 MHz) up 55808
Mo1/0/0:7/U7 initial 55808
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:1 (507 MHz) up 23 0 0 0
Mo1/0/0:2 (513 MHz) up 21 0 0 0
Mo1/0/0:3 (519 MHz) up 10 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/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/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/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/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/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/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/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
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/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/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/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/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/U7 initial 0 0 0 0
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
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.
|
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.
|
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.
|
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 " ", 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 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.
|
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.
|
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.
|
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 docsis-group
|
Creates a DOCSIS LBG on the Cisco CMTS.
|
cable load-balance docsis-policy
|
Creates a DOCSIS policy and associates an existing rule and tag with the policy.
|
cable load-balance docsis-enable
|
Enables or disables DOCSIS load balancing on the Cisco CMTS.
|
cable load-balance rule
|
Creates a rule to prevent the CM from disabling or enabling load balancing.
|
cable tag
|
Creates a tag to associate it with DOCSIS policies and groups.
|
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
|
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
Total buffer size (bytes): 1000000
Used buffer size (bytes) : 36968
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
Cable logging: BADIPSOURCE Enabled
Total buffer size (bytes): 1000000
Used buffer size (bytes) : 36968
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)
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 CommandsThe following is a sample output
cable logging badipsource
|
Logs error messages about bad IP source addresses on the cable interfaces.
|
cable logging downstream-index
|
Logs messages about the downstream indexes.
|
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.
|