Table Of Contents
Cable Commands: show a through show cable l
show application-buckets
show bridge cable-modem
show cable admission-control
show cable arp-filter
show cable bundle
show cable bundle multicast
show cable burst-profile
show cable calls
show cable clock
show cable clock dti counters
show cable clock dti status
show cable device access-group
show cable dsg
show cable dsg tunnel
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 xconnect
show cable leasequery-filter
show cable load-balance
show cable load-balance docsis-group
show cable logging
Cable Commands: show a through show cable l
Revised: November 13, 2009, OL-15510-10
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
|
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
|
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-32 describes the significant fields shown in the display.
Table 0-32 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 admission-control
To display the current admission control 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]
Syntax Description
global
|
(Optional) Displays the following information:
• Parameters that have been configured for admission control
• Number of requests that have crossed minor, major, and critical levels for each resource
|
interface slot/port | slot/subslot/port
|
(Optional) Allows you to display admission control information for the specified interface or port. This includes the following:
• Values for US throughput resources
• Values for DS throughput resources
The Cisco universal broadband routers differ in slot selection as follows:
• slot/subslot/port—For the Cisco uBR10012 router, slot can range from 5 to 8, subslot can be 0 or 1, and port can be 0 to 4 (depending on the cable interface)
• slot/port—On the Cisco uBR7246VXR router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
|
all
|
(Optional) Displays information for all interfaces configured for Admission Control on the Cisco CMTS.
|
Defaults
There are no default behaviors or values.
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 or interface cable or DS channel bonding.
|
Usage Guidelines
This command offers flexible syntax that enables display of Admission Control as specifically configured on the Cisco CMTS. Refer to examples for additional information.
Examples
The following example illustrates upstream and downstream Admission Control information for the specified cable interface:
Router# show cable admission-control interface 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
Table 33 describes the significant fields in the display above.
Table 33 show cable admission-control Field Descriptions for Upstream and Downstream Throughput
Field
|
Description
|
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,
|
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.
|
# of Times
|
Number of times traffic has crossed this threshold since the counters on the Cisco CMTS were last cleared.
|
Exclusive Level
|
Percentage of exclusive throughput that is reserved for the corresponding traffic type on the Cisco CMTS. Applies to downstream or upstream traffic.
|
# of Times
|
Number of times traffic has crossed this threshold since the counters on the Cisco CMTS were last cleared.
|
Non-Excls Level
|
Percentage of non-exclusive throughput configured on the Cisco CMTS. Commonly used with Best Effort (lowest priority) traffic.
|
Curr Reserv
|
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). Values in this field can be as follows:
• U—Upstream
• I—Interface
• G—Global
|
The following example illustrates all Admission Control information for the specified upstream port:
Router# show cable admission-control interface c8/0/1 upstream all
US Sched Class Minor # of Major # of Excls # of Non-Ex Curr. Conf
Port type Name Level Times Level Times Level Times Level Reserv Level
0 UGS - 23 0 27 0 30 0 5 22 U
0 RTPS - 12 0 15 0 20 0 7 10 U
1 UGS name1 30 10 35 10 40 9 5 34 I
The following example illustrates upstream and downstream Admission Control information for the specified interface:
Router# show cable admission-control interface c8/0/1
Resource - Upstream Bandwidth
-------------------------------
Sched Class Minor # of Major # of Exclusive # of Non-Excls
Type Name Level Times Level Times Level Times Level
BE - 16 21 18 20 20 100 5
Resource - Downstream Bandwidth
----------------------------------------
Flow Minor # of Major # of Excls # of Non-Excls Curr. Conf
Type Level Times Level Times Level Times Level Reserv Level
voice 35 10 40 8 45 6 0 38 I
The following example illustrates all Admission Control information for the specified upstream port:
Router# show cable admission-control interface w1/0/0:5
Configured AC Max Reservable Bandwidth = 14000000 bps
Resource - Downstream Bandwidth
-----------------------------
Bucket Names Minor # of Major # of Excls # of Non-Ex Curr. Curr. Conf # of
No Level Times Level Times Level Times Level Resv Ovrsb Level Rejec
1 5 1312 7 1262 45 0 0 31 0 I 36
8 5 31 7 29 49 11 5 79 25 I 0
Table 34 describes the significant fields in the display above.
Table 34 show cable admission-control Field Descriptions for Upstream and Downstream Throughput
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.
|
# of Times
|
Number of times traffic has crossed this threshold since the counters on the Cisco CMTS were last cleared.
|
Excls Level
|
Percentage of exclusive throughput that is reserved for the corresponding traffic type on the Cisco CMTS. Applies to downstream or upstream traffic.
|
# of Times
|
Number of times traffic has crossed this threshold since the counters on the Cisco CMTS were last cleared.
|
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). Values in this field can be as follows:
• U—Upstream
• I—Interface
• G—Global
|
# of Rejec
|
Number of rejections.
|
The following example illustrates upstream and downstream Admission Control information with the global keyword:
Router# show cable admission-control global
Resource Minor # times Major # times Critical # times Current
cpu-5sec 50% 0 70% 0 90% 0 0
proc-mem 50% 0 70% 0 90% 0 0
io-mem 50% 1 60% 1 70% 1 75
total-mem 50% 0 70% 0 90% 0 0
Number of Packetcable voice calls = 80/100 (maximum)
Resource - Upstream Bandwidth
----------------------------------------
Sched Class Minor # of Major # of Exclusive # of Non-Excls
Type Name Level Times Level Times Level Times Level
UGS name1 7 2 10 2 15 0 4
UGS name2 10 1 15 1 20 1 4
Resource - Downstream Bandwidth
----------------------------------------
Flow Minor # of Major # of Exclusive # of Non-Excls
Type Level Times Level Times Level Times Level
Table 35 describes the significant fields for the global keyword used in the example above.
Table 35 show cable admission-control Field Descriptions with global Keyword
Field
|
Description
|
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, Admission Control 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 (BPEs)
|
cable admission-control event
|
Configures and enables Admission Control event types on the Cisco CMTS.
|
cable admission-control ds-bandwidth
|
Configures Admission Control downstream bandwidth thresholds on the Cisco CMTS.
|
cable admission-control 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 Admission Control upstream bandwidth thresholds on the Cisco CMTS.
|
clear cable admission control counters
|
Clears all Admission Control resource counters on the Cisco CMTS.
|
debug cable admission-control
|
Enables automatic Admission Control troubleshooting processes on the Cisco CMTS.
|
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-36 describes the fields shown in the display.
Table 0-36 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-37 describes the fields shown in the display.
Table 0-37 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 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-38 describes the fields shown in the show cable bundle command display.
Table 0-38 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-39 describes the fields shown in the show cable burst-profile command display.
Table 0-39 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 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 40 describes the significant fields shown in the display.
Table 40 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 41 describes the significant fields shown in the display.
Table 41 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-42 describes the fields that are shown in the show cable device access-group display:
Table 0-42 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 43 describes the major fields shown in the show cable dsg command:
Table 43 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 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 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 44 describes the fields shown in the show cable fiber-node command display.
Table 44 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 45 describes the fields shown in the show cable load-balance command display when the spectrum keyword is used.
Table 45 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 46 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 46 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 47 describes the output fields.
Table 47 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 interface line cards. For example, the sort-time option sorts all of the flap entries on the first cable interface line card (c5/0/0), then the entries on the second card (c5/1/0), 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 48 describes the significant fields shown in the display.
Table 48 show cable flap-list Command Field Descriptions
Field
|
Description
|
Mac Addr
|
MAC address for the CM.
|
CableIF
|
Cable interface line card, including upstream, for this CM.
|
Ins
|
Number of times the CM comes up and inserts itself into the network. It can indicate intermittent downstream sync loss or DHCP or modem registration problems.
|
Hit
|
Number of times the CM responds to MAC layer keepalive messages. (The minimum hit rate is once per 30 seconds. It can indicate intermittent upstream, laser clipping, or common-path distortion.
|
Miss
|
Number of times the CM misses the MAC layer keepalive message. An 8 percent miss rate is normal for the Cisco cable interface line cards. It can indicate intermittent upstream, laser clipping, or common-path distortion.
|
CRC
|
Number of cyclic redundancy check (CRC) errors from this CM. It can indicate intermittent upstream, laser clipping, or common-path distortion.
|
P-Adj
|
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.
|
Flap
|
Sum of P-Adj and Ins values. CMs with high flap counts have high SIDs and might not register.
|
Time
|
Most recent time that the CM dropped the connection.
|
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 WB RF channel
number] [QAM | MDD]
Syntax Description
cable slot/subslot/port
|
(Optional) Displays information for all CMs on the specified cable interface on a Cisco uBR10012 router, where:
• slot—Specifies the chassis slot number of the cable interface line card. Valid slots are 5 to 8.
• subslot—Specifies the secondary slot number of the cable interface line card. Valid subslots are 0 or 1.
• port—Specifies the downstream port number. Valid ports are 0 to 4, depending on the cable interface line card.
|
modular-cable slot/bay/port
|
(Optional) Displays information for all CMs on the specified modular cable interface on a Cisco uBR10012 router, where
• slot—The slot where a SIP resides. On the Cisco uBR10012 router, slots 1 and 3 can be used for SIPs.
• bay—The bay in a SIP where a SPA is located. Valid values are 0 (upper bay) and 1 (lower bay).
• port—Specifies the interface number on the SPA.
|
WB RF channel number
|
(Optional) Specifies the wideband RF channel number.
|
QAM
|
(Optional) Specifies the number of QAM flaps.
|
MDD
|
(Optional) Specifies the number of MDD flaps.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCB
|
This command was introduced.
|
Usage Guidelines
None
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 user EXEC or 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 = 5 to 8
• subslot = 0 or 1
• port = 0 to 4 (depending on the cable interface)
|
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
User EXEC, 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 49 describes the fields displayed by the show cable hop and show cable hop upstream commands.
Table 49 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 50 describes the fields displayed by the show cable hop threeshold command.
Table 50 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 51 describes the fields displayed by the show cable hop history command.
Table 51 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-52 describes the fields that are shown in the show cable host access-group display:
Table 0-52 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.
|
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
ubr10k2apatil#show cable ipc-stats
Start: 03:27:29 PDT Fri Oct 9 2009
End : 03:28:22 PDT Fri Oct 9 2009
Total: 0 days 00 hrs 00 mins 53 secs (53 seconds)
entity app io s/s reqid idx: pkts bytes lastEvt totalDur maxDur lastMax
(sec) (msec) (msec) (sec)
rp-lc c10k TxReq 1/0 10241 1: 1 24 17
rp-lc c10k TxReq 1/0 10 14: 11 704 0
rp-lc c10k TxReq 2/1 10 14: 10 640 4
rp-lc c10k TxReq 3/0 10 14: 10 640 4
rp-lc c10k TxReq 3/1 10 14: 11 704 0
rp-lc c10k TxReq 4/0 10 14: 10 640 3
rp-lc c10k TxReq 6/0 10252 2: 10 9376 13
rp-lc c10k TxReq 6/0 10 14: 11 704 0
rp-lc c10k TxReq 6/1 10252 2: 1 88 53
rp-lc c10k TxReq 6/1 10 14: 11 704 0
rp-lc c10k TxReq 7/0 10252 2: 7 696 5
rp-lc c10k TxReq 7/0 10 14: 11 704 1
rp-lc c10k RxRsp 1/0 10241 1: 1 4 17 0 0
rp-lc c10k RxReq 1/0 10241 1: 60 21816 0 0 0
rp-lc c10k RxReq 1/0 10 14: 11 704 0 0 0
rp-lc c10k RxReq 2/1 10241 1: 26 13468 1 0 0
rp-lc c10k RxReq 2/1 10 14: 10 640 4 0 0
rp-lc c10k RxReq 3/0 10241 1: 20 1340 5 0 0
rp-lc c10k RxReq 3/0 10 14: 10 640 4 0 0
rp-lc c10k RxReq 3/1 10 14: 11 704 0 0 0
rp-lc c10k RxReq 4/0 10241 1: 20 1340 9 0 0
rp-lc c10k RxReq 4/0 10 14: 10 640 3 0 0
rp-lc c10k RxReq 6/0 10252 2: 13 27080 0 0 0
rp-lc c10k RxReq 6/0 10 14: 11 748 0 0 0
rp-lc c10k RxReq 6/1 10252 2: 1 68 25 0 0
rp-lc c10k RxReq 6/1 10 14: 11 748 0 0 0
rp-lc c10k RxReq 7/0 10252 2: 11 24548 3 0 0
rp-lc c10k RxReq 7/0 10 14: 11 748 1 0 0
rp-lc pnego TxReq 6/0 14 6: 3 363 13
rp-lc pnego TxReq 6/1 14 6: 1 30 53
rp-lc pnego TxReq 7/0 14 6: 2 62 13
rp-lc plfm RxReq 6/0 24 17: 1 12 37 0 0
rp-lc plfm RxReq 6/0 27 20: 11 1144 0 0 0
rp-lc plfm RxReq 6/0 28 21: 484 19360 0 0 0
rp-lc plfm RxReq 6/1 24 17: 1 12 25 0 0
rp-lc plfm RxReq 7/0 24 17: 1 12 45 0 0
rp-lc plfm RxReq 7/0 27 20: 10 1040 3 0 0
rp-lc plfm RxReq 7/0 28 21: 440 17600 3 0 0
rp-lc docsis TxReq 7/0 118 110: 10 80 5
rp-lc hccp TxReq 6/0 8 8: 8 8416 13
rp-lc hccp RxReq 6/0 2 2: 1 28 13 0 0
enQ: 10 pkts max Q size 9 at 13 sec ago
deQ: 10 pkts max delay 24 msec at 13 sec ago
delay between ( 0, 10) msec: 6 pkts
delay between ( 10, 20) msec: 3 pkts
delay between ( 20, 30) msec: 1 pkts
delay between ( 0, 1) sec : 10 pkts
enQ: 1 pkts max Q size 1 at 53 sec ago
deQ: 1 pkts max delay 0 msec at 53 sec ago
delay between ( 0, 10) msec: 1 pkts
delay between ( 0, 1) sec : 1 pkts
enQ: 7 pkts max Q size 1 at 5 sec ago
deQ: 7 pkts max delay 48 msec at 13 sec ago
delay between ( 0, 10) msec: 1 pkts
delay between ( 10, 20) msec: 5 pkts
delay between ( 40, 50) msec: 1 pkts
delay between ( 0, 1) sec : 7 pkts
enQ: 236 pkts max Q size 3 at 5 sec ago
deQ: 236 pkts max delay 4 msec at 35 sec ago
delay between ( 0, 10) msec: 236 pkts
delay between ( 0, 1) sec : 236 pkts
enQ: 25 pkts max Q size 1 at 0 sec ago
deQ: 25 pkts max delay 0 msec at 0 sec ago
delay between ( 0, 10) msec: 25 pkts
delay between ( 0, 1) sec : 25 pkts
Table 48 describes the fields displayed by the show cable ipc-stats command.
Table 53 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 54 describes the fields shown in the display.
Table 54 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 55 describes the fields shown in the display.
Table 55 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 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]
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) Specifies the MAC address for a cable modem.
|
customer customer-name
|
(Optional) Specifies the customer name.
|
state
|
(Optional) Specifies the state of all 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.
|
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
Table 56 describes the fields shown in the show cable l2-vpn xconnect command display.
Table 56 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
|
Cable interface for the MPLS pseudowire.
|
SID
|
Service ID.
|
STATE
|
State of all virtual circuits.
|
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 [requests-filtered [minimum-requests] ] ]
show cable leasequery-filter [cable 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 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
|
(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 [minimum-requests]
|
(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 for minimum-requests is 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 for the Cisco uBR7100 series, Cisco uBR7246VXR, and Cisco uBR10012 universal broadband routers.
|
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 example shows 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 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:
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 that have had 10 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
Related Commands
Command
|
Description
|
cable arp
|
Activates the cable Address Resolution Protocol (ARP).
|
cable arp filter
|
Controls the number of ARP requests and replies that are forwarded on a cable interface.
|
cable source-verify
|
Enables verification of IP addresses for cable modems (CMs) and customer premises equipment (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 per each service ID (SID) on an upstream.
|
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]]
Syntax Description
group n
|
(Optional) Specifies the number of the load balancing group to be displayed. The valid range is from 1 to 336. The range from 1 to 80 is reserved for legacy load balancing group (LBG). The range from 81 to 336 is reserved for DOCSIS LBGs. The default is to display information for all load balancing groups.
|
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
|
Defaults
Displays information for all load balancing groups for each cable interface and its current load and load balancing status.
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
|
The fiber-node-validation parameter was added to the command.
|
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 of 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% --- --- ---
The following is a sample output of 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
The following is a sample output of 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 57 describes the fields shown in the show cable load-balance command displays.
Table 57 show cable load-balance Field Descriptions (default display)
Field
|
Description
|
Fields for the Default Displays and load Option
|
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 load balancing group as configured using the cable load-balance group interval command.
|
Method
|
Load balancing method used for the load balancing group as configured using the cable load-balance group (global configuration) command.
|
Threshold
|
Thresholds configured for this load balancing group:
• M = Minimum
Minimum difference in the number of cable modems or service flows that can exist on two interfaces in the group before cable modems are moved between the interfaces. If the imbalance between interfaces is below this value, cable modems are not moved. This field contains a value only when the group is configured for the modems or service flows method of load balancing. (This value is configured using the load minimum option of the cable load-balance group threshold command.)
• S = Static
Minimum difference in the percentage of total load that must exist between interfaces in a load balancing group before the Cisco CMTS performs static load balancing. When the load between interfaces is greater than this value, cable modems that are in the process of registering with the CMTS are moved between interfaces until the load difference is again below this value. (This value is configured using the load option of the cable load-balance group threshold command.)
• E = Enforce
Minimum difference in the percentage of total load that must exist between interfaces in a load balancing group before the Cisco CMTS performs dynamic load balancing and begins moving cable modems that are currently online. When the difference in load between two interfaces falls below this value, the CMTS stops dynamic load balancing and performs static load balancing. (This value is configured using the enforce option of the cable load-balance group threshold command.)
• U = Ugs
Percentage of the bandwidth that is allocated for Unsolicited Grant Services (UGS) traffic, such as Voice-over-IP (VoIP), that is in use on an interface because the CMTS moves cable modems that are online with active UGS service flows. (This value is configured using the ugs option of the cable load-balance group threshold command.)
• P = PacketCable MultiMedia (PCMM)
• Percentage of the reserved bandwidth threshold. Above this level, cable modems with active PCMM service flows participate in load balancing. The default threshold is 70%.
|
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:
|