-
Cisco IOS CMTS Cable Software Configuration Guide, Release 12.2SC
- Part 1: Cisco CMTS Router Basics
- Part 2: Advanced Mode DOCSIS Set-Top Gateway
-
Part 3: Cable Interface: Downstream and Upstream Features
-
Configuring Downstream Cable Interface Features on the Cisco CMTS Routers
-
Configuring Upstream Cable Interface Features on the Cisco CMTS Routers
-
CM Steering on the Cisco CMTS Routers
-
DOCSIS 2.0 A-TDMA Modulation Profiles for the Cisco CMTS Routers
-
DOCSIS 3.0 Downstream Bonding for Bronze Certification
-
Dynamic Bandwidth Sharing on the Cisco CMTS Router
-
IGMP-Triggered VDOC Broadcast Support on the Cisco CMTS Routers
-
Load Balancing and Dynamic Channel Change on the Cisco CMTS Routers
-
RSVP-Based Video on Demand Support Over DOCSIS
-
M-CMTS DEPI Control Plane
-
S-CDMA and Logical Channel Support on the Cisco CMTS Routers
-
Spectrum Management and Advanced Spectrum Management for the Cisco CMTS Routers
-
Support for Extended Frequency Ranges
-
Upstream Channel Bonding
-
Upstream Scheduler Mode for the Cisco CMTS Routers
-
Wideband Modem Resiliency
-
- Part 4: Cable Interface: Security Features
- Part 5: Cable Monitoring Features
- Part 6: Cisco CMTS Router Services
- Part 7: High Availability Features
-
Part 8: Layer 2 and VPN Features
-
Cisco uBR7200 Series MPLS VPN Cable Enhancements
-
EtherChannel on the Cisco CMTS Routers
-
Generic Routing Encapsulation on the Cisco CMTS Routers
-
L2VPN Support Over Cable
-
MPLS Pseudowire for Cable L2VPN
-
Point-to-Point Protocol over Ethernet Support on the Cisco CMTS Routers
-
Service Flow Mapping to MPLS-VPN on the Cisco CMTS Routers
-
Transparent LAN Service over Cable
-
- Part 9: Layer 3 and Interface Bundle Features
- Part 10: PacketCable and PacketCable Multimedia Features
- Part 11: QoS Features
-
Part 12: Traffic Management and Other Management Features
-
Control Point Discovery for the Cisco CMTS Routers
-
IPDR Streaming Protocol on the Cisco CMTS Routers
-
Managing Cable Modems on the Hybrid Fiber-Coaxial Network
-
Maximum CPE or Host Parameters for the Cisco CMTS Routers
-
PXF Divert Rate Limit Enhancement on the Cisco CMTS Routers
-
Subscriber Management Packet Filtering for DOCSIS 2.0
-
Subscriber Traffic Management for the Cisco CMTS Routers
-
Usage Based Billing for the Cisco CMTS Routers
-
-
Part 13: Troubleshooting on the Cisco CMTS Routers
-
Cable IPC Statistics Collection Tool
-
Cisco CMTS Static CPE Override
-
Flap List Troubleshooting for the Cisco CMTS Routers
-
GOLD Health Monitoring for the Cisco UBR10012 Universal Broadband Router
-
Resolving Common Image Installation Problems
-
SEA Health Monitoring for the Cisco UBR10012 Routers
-
Troubleshooting the System
-
- Part 14: Appendix A
- Part 15: Appendix B
-
Glossary
Table Of Contents
Advanced-Mode DOCSIS Set-Top Gateway 1.2 for the Cisco CMTS Routers
Prerequisites for Advanced-Mode DSG Issue 1.2
Restrictions for Advanced-Mode DSG Issue 1.2
Command-line Interface Restrictions
DSG Configuration File Transfer Operations
Multicast Configuration Restrictions
NAT for DSG Unicast-only Mapping
Information About Advanced-Mode DSG Issue 1.2
How to Configure Advanced-Mode DSG Issue 1.2
Configuring Global Tunnel Group Settings for Advanced-Mode DSG 1.2
Global DSG 1.2 Tunnel Settings
Adding DSG Tunnel Group to a Subinterface
Configuring the DSG Client Settings for Advanced-Mode DSG 1.2
Configuring Downstream DSG 1.2 Settings for Advanced-Mode DSG 1.2
Configuring Additional Features for Advanced-mode DOCSIS Set-Top Gateway 1.2 on the Cisco CMTS
Configuring IP Multicast Operations
Configuring NAT to Support Unicast Messaging
Configuring WAN Interfaces for Multicast Operations
Configuring a Standard IP Access List for Packet Filtering
Configuring a Standard IP Access List for Multicast Group Filtering
How to Monitor and Debug the Advanced-mode DOCSIS Set-Top Gateway Feature
Displaying Global Configurations for Advanced-Mode DSG 1.2
show cable dsg tunnel 1 statistics
Displaying Interface-level Configurations for Advanced-Mode DSG 1.2
show cable dsg tunnel interfaces
show interface cable dsg downstream
show interfaces cable dsg downstream
show interfaces cable dsg downstream dcd
show interfaces cable dsg downstream tg
show interfaces cable dsg downstream tunnel
show interfaces c5/0 dsg downstream tunnel
Debugging Advanced-Mode DSG 1.2
Configuration Examples for Advanced-Mode DSG Issue 1.2
Feature Information for Advanced-Mode DSG 1.2 for the Cisco CMTS Routers
Advanced-Mode DOCSIS Set-Top Gateway 1.2 for the Cisco CMTS Routers
First Published: Cisco IOS Release 12.3(17a)BC2
Last Updated: August 25, 2009
Note
Cisco IOS Release 12.2(33)SCA integrates support for this feature on the Cisco CMTS routers. This feature is also supported in Cisco IOS Release 12.3BC, and this document contains information that references many legacy documents related to Cisco IOS 12.3BC. In general, any references to Cisco IOS Release 12.3BC also apply to Cisco IOS Release 12.2SC. For the latest information on Cisco CMTS router support in Cisco IOS Release 12.2SC, refer to the Cross-Platform Release Notes for Cisco Universal Broadband Routers in Cisco IOS Release 12.2SC.
Cisco IOS Release 12.3(17a)BC2 introduces certified support for Advanced-Mode DOCSIS Set-Top Gateway (A-DSG) Issue 1.2. DSG Issue 1.2 introduces support for the latest DOCSIS Set-Top specification from CableLabs™, to include the following enhancements:
•
http://www.cablelabs.com/specifications/archives/CM-SP-DSG-I05-050812.pdf
•
•
Cisco A-DSG 1.2 is certified by CableLabs™, and is a powerful tool in support of latest industry innovations. A-DSG 1.2 offers substantial support for enhanced DOCSIS implementation in the Broadband Cable environment. The set-top box (STB) dynamically learns the overall environment from the Cisco Cable Modem Termination System (CMTS), to include MAC address, traffic management rules, and classifiers.
Finding Feature Information
Your software release may not support all the features documented in this module. For the latest feature information and caveats, see the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the "Feature Information for Advanced-Mode DSG 1.2 for the Cisco CMTS Routers" section.
Use Cisco Feature Navigator to find information about platform support and Cisco IOS, Catalyst OS, and Cisco IOS XE software image support. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Contents
•
•
•
•
•
•
•
•
Prerequisites for Advanced-Mode DSG Issue 1.2
The A-DSG for the Cisco CMTS Routers feature is supported on the Cisco CMTS routers in Cisco IOS Release 12.3BC and 12.2SC. Table 1 shows the hardware compatibility prerequisites for this feature.
Restrictions for Advanced-Mode DSG Issue 1.2
Cisco IOS release 12.3(17a)BC2, or a later 12.3BC release, must be installed on the Cisco universal broadband router. This section contains additional restrictions that are specific to A-DSG 1.2 on the Cisco CMTS.
•
•
•
•
Command-line Interface Restrictions
The following DSG configuration commands, supported prior to Cisco IOS Releases 12.3(17a)BC2, are not supported for A-DSG 1.2. Refer to the "Additional References" section for information relating to DSG 1.1 and earlier supporting commands.
•
•
•
•
•
•
DSG Configuration File Transfer Operations
DSG 1.2 does not support the copying of a DSG configuration file from a TFTP server, file system, or bootflash to the running configuration.
Previously, with DSG 1.1, when copying the DSG configuration file from a file system or TFTP server to the running configuration, DSG rule error checking may disable a previously configured and valid DSG tunnel configuration. This issue has not been observed in DSG 1.1 when loading the DSG configuration file from the startup configuration, as during a reload.
Multicast Configuration Restrictions
As with earlier versions of DSG Issues 0.9 and 1.0, IP multicasting must be configured for correct operation of A-DSG 1.2. Specifically, IP multicast routing must be set in global configuration. Also, IP PIM must be configured on all WAN interfaces and cable interfaces that are to carry multicast traffic.
A-DSG 1.2 creates changes to the running configuration, requiring the ip igmp static-group command for each multicast group that passes DSG traffic. For this reason, this configuration cannot be deleted in manual fashion once set, in order to sustain normal DSG 1.2 operations.
Refer to the "Configuring Global Tunnel Group Settings for Advanced-Mode DSG 1.2" section and the "Configuring IP Multicast Operations" section for additional Multicast information and global configurations supporting DSG.
NAT for DSG Unicast-only Mapping
A-DSG 1.2 supports multicast IP addressing. However, DSG 1.2 also supports unicast IP destination addresses. On the Cisco uBR7246VXR router, DSG 1.2 support is provided with the configuration of Network Address Translation (NAT) on the router, to include these settings:
•
•
•
The unicast IP address is the unicast destination IP address of the DSG packets arriving at the Cisco CMTS. The multicast IP address is the new destination IP address that is configured to map to one or a set of DSG tunnel(s).
PIM and SSM for Multicast
When using Source Specific Multicast (SSM) operation in conjunction with A-DSG 1.2, the following system-wide configuration command must be specified:
•
Refer to the "Configuring IP Multicast Operations" section.
Subinterfaces
A-DSG 1.2 supports subinterfaces on the Cisco CMTS starting from Cisco IOS Release 12.2(33)SCB4.
Information About Advanced-Mode DSG Issue 1.2
A-DSG 1.2 offers substantial upgrades over A-DSG 1.1 and earlier Basic DSG on the Cisco CMTS. DSG 1.2 offers these new or enhanced capabilities:
•
•
•
•
•
•
•
DSG 1.2 Clients
DSG 1.2 supports the DSG client and agent functions outlined by the CableLabs™ DOCSIS Set-top Gateway (DSG) Interface Specification, CM-SP-DSG-I05-050812.
DSG 1.2 Agents
DSG 1.2 supports the DSG client and agent functions outlined by the CableLabs™ DOCSIS Set-top Gateway (DSG) Interface Specification, CM-SP-DSG-I05-050812.
How to Configure Advanced-Mode DSG Issue 1.2
Advanced-mode DSG Issue 1.2 entails support for DSG tunnel configuration, to include global, WAN-side, and interface-level settings in support of Multicast. This section contains the following procedures supporting A-DSG 1.2 in Cisco IOS Release 12.3(17a)BC2, and later Cisco IOS releases supporting Cisco Universal Broadband routers:
•
•
•
•
•
•
•
•
•
•
Configuring Global Tunnel Group Settings for Advanced-Mode DSG 1.2
This procedure configures global and interface-level commands on the Cisco CMTS to enable DSG 1.2 tunnel groups. Later DSG 1.2 configurations build on these settings.
Global DSG 1.2 Tunnel Settings
This procedure sets and enables global configurations to support both DSG 1.2 clients and agents. Additional procedures provide additional settings for DSG 1.2 clients and agents.
Prerequisites
Cisco IOS Release 12.3(17a)BC or a later DSG-supporting release must be installed previously on the Cisco CMTS.
Restrictions
Cisco IOS Release 12.3(17a)BC or a later DSG-supporting release must be installed previously on the Cisco CMTS.
SUMMARY STEPS
1.
2.
3.
4.
5.
6.
7.
8.
9.
DETAILED STEPS
Examples
The following example illustrates global upstream configurations implemented with the above commands:
Router> enableRouter# configure terminalRouter(config)# cable dsg tg 1 channel 1 priority 1 enableRouter(config)# cable dsg tg 1 channel 1 ucid 1Router(config)# cable dsg tg 1 channel 1 vendor-param 1Router(config)# Ctrl^ZRouter#Troubleshooting Tips
Refer to debug and show commands in the "How to Monitor and Debug the Advanced-mode DOCSIS Set-Top Gateway Feature" section.
What to Do Next
Refer to additional procedures in this section to complete the configuration of A-DSG 1.2 on the Cisco CMTS:
•
•
Adding DSG Tunnel Group to a Subinterface
This procedure adds a DSG tunnel group to a subinterface using the cable dsg tg group-id command . After the configuration, corresponding IP IGMP static joins are created and forwarding to DSG traffic starts.
Note
Prerequisites
Cisco IOS Release 12.2(33)SCB4 or a later DSG-supporting release must be installed previously on the Cisco CMTS.
Restrictions
You can associate a DSG tunnel group to only one subinterface within the same bundle interface.
SUMMARY STEPS
1.
2.
3.
4.
5.
DETAILED STEPS
Examples
The following example shows how to add a DSG tunnel group to a subinterface:
Router> enableRouter# configure terminalRouter(config)# interface bundle 11.2Router(config-subif)# cable dsg tg 1Router(config-subif)# endRouter#Configuring the DSG Client Settings for Advanced-Mode DSG 1.2
Once the global configurations and DSG client configurations are set for DSG 1.2 on the Cisco CMTS, use the following procedure to continue DSG 1.2 client configurations.
Prerequisites
Cisco IOS Release 12.3(17a)BC or a later DSG-supporting release must be installed previously on the Cisco CMTS.
Restrictions
Cisco IOS Release 12.3(17a)BC or a later DSG-supporting release must be installed previously on the Cisco CMTS.
SUMMARY STEPS
1.
2.
3.
4.
5.
6.
7.
DETAILED STEPS
Examples
The following example illustrates global configuration of DSG 1.2 on the Cisco CMTS, supporting the specified settings shown. Global configuration may vary, but this example is representative of a typical configuration:
Router(config)# cable dsg vendor-param 1 vendor 1 oui 000001 value 010101Router(config)# cable dsg client-list 1 id-index 1 mac-addr abcd.abcd.abcdRouter(config)# cable dsg tg 1 channel 1Router(config)# cable dsg tunnel 1 mac-addr 0abc.0abc.0abc tg 1 clients 1Router(config)# cable dsg cfr 1 dest-ip 224.225.225.225 tunnel 1 dest-port 40 50 priority 2 src-ip 1.11.37.0 src-prefix-len 24Router(config)# cable dsg timer 1 Tdsg1 4 Tdsg2 600 Tdsg3 300 Tdsg4 1800Router(config)# cable dsg chan-list 1 index 1 freq 471000000Troubleshooting Tips
Refer to debug and show commands in the "How to Monitor and Debug the Advanced-mode DOCSIS Set-Top Gateway Feature" section.
What to Do Next
Refer to additional procedures in this section to complete the configuration of A-DSG 1.2 on the Cisco CMTS:
•
Configuring Downstream DSG 1.2 Settings for Advanced-Mode DSG 1.2
When the global and client configurations are set for DSG 1.2 on the Cisco CMTS, use the following procedure to continue with DSG 1.2 downstream configurations.
Prerequisites
Cisco IOS Release 12.3(17a)BC or a later DSG-supporting release must be installed previously on the Cisco CMTS.
Restrictions
Cisco IOS Release 12.3(17a)BC or a later DSG-supporting release must be installed previously on the Cisco CMTS.
SUMMARY STEPS
1.
2.
3.
4.
5.
6.
7.
8.
9.
DETAILED STEPS
Examples
The following example illustrates downstream settings configured for DSG 1.2 on the Cisco CMTS:
cable downstream dsg chan-list 1cable downstream dsg timer 1cable downstream dsg tg 1 channel 1The following example illustrates DSG rules associated with the same A-DSG tunnel and the same list of classifiers:
cable dsg cfr 1 dest-ip 224.2.1.1 tunnel 1cable dsg cfr 2 dest-ip 224.2.1.2 tunnel 1cable dsg cfr 3 dest-ip 224.2.1.3 tunnel 1...Downstream 1
cable downstream dsg rule 2 clients 1 tunnel 1cable downstream dsg rule 2 cfr 2 3...Downstream 2
This setting below is the same tunnel as rule 2 of downstream 1.
cable downstream dsg rule 1 clients 1 tunnel 1...The setting below must be the same classifier list as rule 2 of downstream 1
cable downstream dsg rule 1 cfr 2 3..Troubleshooting Tips
Refer to debug and show commands in the "How to Monitor and Debug the Advanced-mode DOCSIS Set-Top Gateway Feature" section.
What to Do Next
Refer to additional configuration options and monitoring procedures in this document.
Configuring Additional Features for Advanced-mode DOCSIS Set-Top Gateway 1.2 on the Cisco CMTS
See the following sections for how to enable, configure, disable, and monitor the Advanced-mode DOCSIS Set-Top Gateway feature:
•
•
•
•
•
Configuring IP Multicast Operations
This section describes how to configure the operation of IP multicast transmissions on the cable and WAN interfaces on the Cisco CMTS. You should perform this configuration on each cable interface being used for DSG traffic and for each WAN interface that is connected to a network controller or Conditional Access (CA) server that is forwarding IP multicast traffic.
SUMMARY STEPS
1.
2.
3.
4.
5.
6.
7.
8.
9.
DETAILED STEPS
Step 1
configure terminal
Example:Router# configure terminal
Router(config)#
Enters global configuration mode.
Step 2
ip multicast-routing
Example:Router(config)# ip multicast-routing
Router(config)#
Enables multicast routing on the router.
Step 3
ip pim ssm [vrf vrf-name] ssm {default | range access-list}
Example:Router(config)# ip pim ssm range 4
Defines the Source Specific Multicast (SSM) range of IP multicast addresses. To disable the SSM range, use the no form of this command.
•
•
•
•
Note
For additional information about the ip pim ssm command, refer to the following document on Cisco.com:
•
http://www.cisco.com/en/US/docs/ios/12_3t/ip_mcast/command/reference/123tip3r.html
Step 4
ip cef [distributed] [accounting type | load-sharing algorithm algorithm | table type | traffic-statistics]
Example:Router(config)# ip cef
Enables Cisco Express Forwarding (CEF) on the route processor card. To disable CEF, use the no form of this command.
For additional information about the ip cef command, refer to the following document on Cisco.com:
•
http://www.cisco.com/en/US/docs/ios/12_3/switch/command/reference/swtch_r.html
Step 5
interface interface
Example:Router(config)# interface cable 3/0
Router(config-if)#
Enters interface configuration mode for each cable interface or WAN interface being used for DSG traffic.
Step 6
ip pim {dense-mode | sparse-mode | sparse-dense-mode}
Example:Router(config-if)# ip pim dense-mode
Router(config-if)#
Enables Protocol Independent Multicast (PIM) on the cable interface, which is required to use the DSG feature:
•
•
•
Note
Step 7
ip multicast rate-limit out group-list access-list rate
Example:Router(config-if)# ip multicast rate-limit out group-list 10 2048
Router(config-if)#
(Optional) Enables multicast rate-limiting on the cable interface, using the following parameters:
•
•
Step 8
ip mroute-cache
Example:Router(config-if)# ip mroute-cache
Router(config-if)#
(Optional) Enables IP multicast fast switching, also known as multicast distributed switching (MDS), on the interface.
Note
Step 9
exit
Example:Router(config-if)# exit
Router#
Exits interface configuration mode and returns to privileged EXEC mode.
Examples
The following example illustrates globally configured A-DSG 1.2 settings in support of Multicast routing for SSM-type DSG configuration:
Router(config)# ip multicast-routingRouter(config)# ip pim ssmRouter(config)# ip cefThe following example illustrates WAN-side interface configurations for A-DSG 1.2 and access control lists for inbound packet filtering:
Router(config-if)# ip pimRouter(config-if)# ip mroute-cacheRouter(config-if)# ip access-group 1 inThe following example illustrates interface-level configuration supporting Multicast IP routing traffic in advanced-mode DSG 1.2, with access control lists for inbound packet filtering:Router(config-if)# ip pim sparse-modeRouter(config-if)# ip mroute-cacheRouter(config-if)# ip igmp access-group 1Configuring NAT to Support Unicast Messaging
This section describes how to configure a Cisco CMTS router for Network Address Translation (NAT) to enable the use of IP unicast addresses for DSG messaging. This allows the Cisco CMTS router to translate incoming IP unicast addresses into the appropriate IP multicast address for the DSG traffic.
For the Cisco uBR10012 router, A-DSG 1.2 can use an external router that is close to the Cisco CMTS to support unicast messaging. In this case, the nearby router must support NAT, and then send the address-translated multicast IP packets to the Cisco CMTS.
Tip
Note
SUMMARY STEPS
1.
2.
3.
4.
5.
6.
7.
8.
9.
DETAILED STEPS
Step 1
configure terminal
Example:Router# configure terminal
Router(config)#
Enters global configuration mode.
Step 2
interface wan-interface
Example:Router(config)# interface FastEthernet0/0
Router(config-if)#
Enters interface configuration mode for the specified WAN interface.
Step 3
ip nat outside
Example:Router(config-if)# ip nat outside
Router(config-if)#
Configures the WAN interface as the "outside" (public) NAT interface.
Step 4
interface cable interface
Example:Router(config-if)# interface cable 3/0
Router(config-if)#
Enters interface configuration mode for the specified cable interface.
Note
Step 5
ip address ip-address mask secondary
Example:Router(config-if)# ip address 192.168.18.1 255.255.255.0 secondary
Router(config-if)#
Configures the cable interface with an IP address and subnet that should match the unicast address being used for DSG traffic. This IP address and its subnet must not be used by any other cable interfaces, cable modems, or any other types of traffic in the cable network.
Step 6
ip nat inside
Example:Router(config-if)# ip nat inside
Router(config-if)#
Configures the cable interface as the "inside" (private) NAT interface.
Step 7
exit
Example:Router(config-if)# exit
Router(config)#
Exits interface configuration mode and returns to global configuration mode.
Step 8
ip nat inside source static ip-multicast-address cable-ip-address
Example:Router(config)# ip nat inside source static 224.3.2.1 192.168.18.2
Router(config)#
Maps the unicast IP address assigned to the cable interface to the multicast address that should be used for the DSG traffic.
•
•
Note
Step 9
exit
Example:Router(config)# exit
Router#
Exits global configuration mode and returns to privileged EXEC mode.
Configuring WAN Interfaces for Multicast Operations
In addition to basic WAN interface configuration on the Cisco CMTS, described in other documents, the following WAN interface commands should be configured on the Cisco CMTS to support IP multicast operations with A-DSG 1.2, as required.
•
•
•
These commands are described in the "Configuring IP Multicast Operations" section, and in the following documents on Cisco.com.
For additional information about the ip pim command, refer to the following document on Cisco.com:
•
http://www.cisco.com/en/US/docs/ios/12_3/ipmulti/command/reference/iprmc_r.html
For additional information about the ip pim ssm command, refer to the following document on Cisco.com:
•
http://www.cisco.com/en/US/docs/ios/12_3t/ip_mcast/command/reference/ip3_i2gt.html
For additional information about the ip cef command, refer to the following document on Cisco.com:
•
http://www.cisco.com/en/US/docs/ios/12_3/switch/command/reference/swtch_r.html
Configuring a Standard IP Access List for Packet Filtering
This section describes how to configure a standard IP access list so that only authorized traffic is allowed on the cable interface.
Tip
SUMMARY STEPS
1.
2.
3.
4.
5.
6.
7.
DETAILED STEPS
Step 1
configure terminal
Example:Router# configure terminal
Router(config)#
Enters global configuration mode.
Step 2
access-list access-list permit group-ip-address [mask]
Example:Router(config)# access-list 90 permit 228.1.1.1
Router(config)#
Creates an access list specifying that permits access to the specific multicast address that matches the specified group-ip-address and mask.
•
•
•
Step 3
access-list access-list deny group-ip-address [mask]
Example:Router(config)# access-list 90 deny 224.0.0.0 15.255.255.255
Router(config)#
Configures the access list that denies access to any multicast address that matches the specified group-ip-address and mask.
•
•
•
Step 4
access-list access-list deny any
Example:Router(config)# access-list 90 deny any
Router(config)#
Configures the access list so that it denies access to any IP addresses other than the ones previously configured.
Step 5
interface cable interface
Example:Router(config)# interface cable 3/0
Router(config-if)#
Enters interface configuration mode for the specified cable interface.
Step 6
ip access-group access-list
Example:Router(config-if)# ip access-group 90
Router(config-if)#(Optional, but recommended) Configures the interface with the access list, so that packets are filtered by the list before being accepted on the interface.
•
Note
Note
Step 7
exit
Example:Router(config-if)# exit
Router#
Exits interface configuration mode and returns to Privileged EXEC mode.
Configuring a Standard IP Access List for Multicast Group Filtering
This section describes how to configure a standard IP access list so that non-DOCSIS devices, such as DSG set-top boxes, can access only the authorized multicast group addresses and DSG tunnels.
Tip
SUMMARY STEPS
1.
2.
3.
4.
5.
6.
7.
DETAILED STEPS
Step 1
configure terminal
Example:Router# configure terminal
Router(config)#
Enters global configuration mode.
Step 2
access-list access-list permit group-ip-address [mask]
Example:Router(config)# access-list 90 permit 228.1.1.1
Router(config)#
Creates an access list specifying that permits access to the specific multicast address that matches the specified group-ip-address and mask.
•
•
•
Step 3
access-list access-list deny group-ip-address [mask]
Example:Router(config)# access-list 90 deny 224.0.0.0 15.255.255.255
Router(config)#
Configures the access list that denies access to any multicast address that matches the specified group-ip-address and mask.
•
•
•
Step 4
access-list access-list deny any
Example:Router(config)# access-list 90 deny any
Router(config)#
Configures the access list so that it denies access to any IP addresses other than the ones previously configured.
Step 5
interface cable interface
Example:Router(config)# interface cable 3/0
Router(config-if)#
Enters interface configuration mode for the specified cable interface.
Step 6
ip igmp access-group access-list [version]
Example:Router(config-if)# ip igmp access-group 90
Router(config-if)#(Optional, but recommended) Configures the interface to accept traffic only from the associated access list, so that only authorized devices are allowed to access the DSG tunnels.
•
•
Step 7
exit
Example:Router(config-if)# exit
Router#
Exits interface configuration mode and returns to privileged EXEC mode.
How to Monitor and Debug the Advanced-mode DOCSIS Set-Top Gateway Feature
This section describes the following commands that you can use to monitor and display information about the Advanced-mode DOCSIS Set-Top Gateway feature:
•
•
•
Displaying Global Configurations for Advanced-Mode DSG 1.2
The following show commands are enhanced in Cisco IOS Release 12.3(17a)BC2 to support A-DSG 1.2 on the Cisco CMTS. These commands display globally-configured or interface-level DSG settings, status, statistics, and multiple types of DSG 1.2 tunnel information.
•
•
•
•
•
•
•
•
•
•
•
show cable dsg tunnel
To display tunnel MAC address, state, tunnel group id, classifiers associated to tunnel and its state, use the show cable dsg tunnel command in privileged EXEC mode. This command also displays the number of interfaces to which a tunnel is associated, the clients associated, and the QoS service class name for all the configured tunnels.
The following example illustrates this command:
Router# show cable dsg tunneltunnel TG cfr tunnel rule client serviceid state mac-addr id id state I/F id state listId class1 en 0100.5e01.0001 1 1 en C5/0 1 en 1 DSG-Rate16 en7 en8 en2 en 0100.5e01.0002 1 2 en C5/0 2 en 23 en 0100.5e01.0003 1 3 en C5/0 3 en 34 en 0002.0002.0001 2 4 en C5/0 4 en 1C5/1 1 en 15 en 0002.0002.0002 2 5 en C5/0 5 en 2 DSG-Rate2C5/1 2 en 26 en 0002.0002.0003 2 9 en C5/0 6 en 21C5/1 3 en 21show cable dsg tunnel ID
To display information for a given DSG tunnel, use the show cable dsg tunnel command, specifying the tunnel for which to display information.
show cable dsg tunnel tunnel-id [cfr | clients | interfaces | statistics | verbose]
•
•
•
•
•
The below example illustrates this command for DSG Tunnel 1:
Router# show cable dsg tunnel 1tunnel TG cfr tunnel rule client serviceid state mac-addr id id state I/F id state listId class1 en 0100.5e01.0001 1 1 en C5/0 1 en 1 DSG-Rate16 en7 en8 enThe below example illustrates detailed information about all the classifiers associated to the specified tunnel.
Router# show cable dsg tunnel 1 cfrtunnel cfr cfr cfr destination ip source ip srcPre d_port d_portid id state pri address address length start end1 1 en 0 230.1.0.1 0.0.0.0 32 0 655356 en 0 231.1.1.6 0.0.0.0 32 0 655357 en 0 231.1.1.7 0.0.0.0 32 0 655358 en 0 231.1.1.8 0.0.0.0 32 0 65535The below example illustrates detailed information about all the clients associated to the specified tunnel.
Router# show cable dsg tunnel 1 clientstunnel client client client client vendorid listId id id type address group1 1 1 MAC Addr 0100.5e00.00012 Application ID 0x09513 Broadcast Unspecified4 Broadcast 4The below example illustrates all DSG interfaces and rules associated to the specified tunnel.
Router# show cable dsg tunnel 1 interfacestunnel downstream ruleid interface id4 Cable5/0 4Cable5/1 1show cable dsg tunnel 1 statistics
The below example illustrates packet statistics information about the specified tunnel.
Router# show cable dsg tunnel 1 statisticstunnel cfr cfr destination ip source ip total totalid id state address address forwarded received1 1 en 230.1.0.1 0.0.0.0 0 06 en 231.1.1.6 0.0.0.0 0 07 en 231.1.1.7 0.0.0.0 0 08 en 231.1.1.8 0.0.0.0 0 0The below example illustrates all detailed information about the specified tunnel.
Router# show cable dsg tunnel 1 verboseTunnel ID : 1State : enableMAC Addr : 0100.5e01.0001TG Id : 1Cfr Id : 1State : enablePriority : 0Dest IP : 230.1.0.1Src IP : 0.0.0.0Src Prefix Length : 32Dest Port Start : 0Dest Port End : 65535Forwarded : 0Received : 0Cfr Id : 6State : enablePriority : 0Dest IP : 231.1.1.6Src IP : 0.0.0.0Src Prefix Length : 32Dest Port Start : 0Dest Port End : 65535Forwarded : 0Received : 0Cfr Id : 7State : enablePriority : 0Dest IP : 231.1.1.7Src IP : 0.0.0.0Src Prefix Length : 32Dest Port Start : 0Dest Port End : 65535Forwarded : 0Received : 0Cfr Id : 8State : enablePriority : 0Dest IP : 231.1.1.8Src IP : 0.0.0.0Src Prefix Length : 32Dest Port Start : 0Dest Port End : 65535Forwarded : 0Received : 0Client List Id : 1Client Id : 1Client Id Type : MAC Addr 0100.5e00.0001Client Id : 2Client Id Type : Application ID 0x0951Client Id : 3Client Id Type : Broadcast UnspecifiedClient Id : 4Client Id Type : Broadcast 4Interface : Cable5/0Rule Id : 1The below example illustrates configured parameters for all DSG tunnel groups.
Router# show cable dsg tgTG Chan TG Rule Vendor UCIDid id state I/F pri Param list1 1 en C5/0 16 1 1 2 3 41 2 en 02 1 en C5/0 11 2C5/12 2 en 0The below example displays the same information as above for the specified tunnel group.
Router# show cable dsg tg 1 channel 1TG Chan TG Rule Vendor UCIDid id state I/F pri Param list1 1 en C5/0 16 1 1 2 3 4The below example illustrates detailed information for the specified tunnel group.
Router# show cable dsg tg 1 channel 1 verboseTG: 1 Chan: 1 state: en pri: 16 Vendor: 1 UCID: 1 2 3 4rule tunnel cfr clientsI/F id state id state mac-addr id state dest-ip In-DCD listIdC5/0 1 en 1 en 0101.5e01.0001 1 en 230.1.0.1 yes 16 en 231.1.1.6 no7 en 231.1.1.7 no8 en 231.1.1.8 no2 en 2 en 0101.5e01.0002 2 en 230.1.0.2 yes 23 en 3 en 0101.5e01.0003 3 en 230.1.0.3 yes 3To display a tunnel group attached to a subinterface, use the show running-config interface command in privileged EXEC mode, as shown in the example below:
Router# show running-config interface bundle 11.2!interface Bundle11.2ip address 4.4.2.1 255.255.255.0no ip unreachablesip pim sparse-modeip igmp static-group 230.1.1.30no cable ip-multicast-echocable dsg tg 61endDisplaying Interface-level Configurations for Advanced-Mode DSG 1.2
The following show commands are enhanced in Cisco IOS Release 12.3(17a)BC2 to support A-DSG 1.2 on the Cisco CMTS. These commands display interface-level configurations.
•
•
•
•
•
•
•
show cable dsg tunnel interfaces
To display all interfaces and DSG rules for the associated tunnel, use the show cable dsg tunnel interfaces command in privileged EXEC mode.
show cable dsg tunnel (tunnel-id) interfaces
The following example illustrates this command:
Router# show cable dsg tunnel 1 interfacestunnel downstream ruleid interface id4 Cable5/0 4Cable5/1 1show interface cable dsg downstream
To display information for downstream DSG 1.2 interfaces, use the show interface cable dsg downstream command in privileged EXEC mode. The following example illustrates syntax options for this command.
show interface cable {slot/port | slot/subslot/port} dsg downstream [tunnel | tg | dcd]
Keywords for this command include the following:
•
•
•
show interfaces cable dsg downstream
To display DSG downstream interface configuration information, to include the number of DSG tunnels, classifiers, clients, and vendor-specific parameters, use the show interfaces cable dsg downstream command in privileged EXEC mode.
show interfaces cable {slot/port | slot/subslot/port} dsg downstream
The following example illustrates this command supporting DSG 1.2:
Router# show interfaces c5/0 dsg downstreamchan chFreq chan timer init oper twoWay oneWay num num num num numlist index freq index timeout timeout timer timer rule tunnel cfr client vsp1 1 471 1 4 600 300 1800 6 6 3 4 22 4773 4834 583show interfaces cable dsg downstream dcd
To display DCD statistics for the given downstream, use the show interfaces cable dsg downstream dcd command in privileged EXEC mode. This command only displays DCD Type/Length/Value information if the debug cable dsg command is previously enabled.
show interfaces cable {slot/port | slot/subslot/port} dsg downstream dcd
The following example illustrates DCD statistics information supporting DSG 1.2:
Router# show interfaces c5/0 dsg downstream dcddcd dcd num of dcd num of dcd num of dcd num ofstate Tx sent fail change cnt fragmenten on 6502 0 28 1Router# debug cable dsgCMTS DSG debugging is onRouter#Router# show interfaces c5/0 dsg downstream dcddcd dcd num of dcd num of dcd num of dcd num ofstate Tx sent fail change cnt fragmenten on 6512 0 28 1Router#02:08:42: DCD TLV last sent:32360101 01020110 03040102 03040412 02060100 5E000001 04020951 0100010200040506 01005E01 00010602 00012B08 08030000 01010101 170F0202 0001050100090605 04E60100 01322801 01020201 10030401 02030404 0403020A BC050601005E0100 02060200 022B0808 03000001 01010117 0F020200 02050100 09060504E6010002 32280101 03020110 03040102 03040404 04020123 05060100 5E01000306020003 2B080803 00000101 0101170F 02020003 05010009 060504E6 0100033238010104 02010B04 12020601 005E0000 01040209 51010001 02000405 060002000200012B 09080300 00010102 01022B09 08030000 02010201 02322A01 010502010B040403 020ABC05 06000200 0200022B 09080300 00010102 01022B09 0803000002010201 02324601 01060201 0B042002 06002100 21000102 06002100 2100020206002100 21000302 06002100 21000405 06000200 0200032B 09080300 0001010201022B09 08030000 02010201 02332801 041C12E3 C001041C 6E714001 041CC9FEC0010422 BFDFC002 02000403 02025804 02012C05 020708show interfaces cable dsg downstream tg
To display DSG tunnel group parameters, and rule information applying to the tunnel group, to include tunnels and tunnel states, classifiers, and client information, use the show interfaces cable dsg downstream tg command in privileged EXEC mode. You can display information for a specific tunnel, if specified.
show interfaces cable {slot/port | slot/subslot/port} dsg downstream tg [channel channel-id]
The following example illustrates typical information displayed with this command in DSG 1.2:
Router# show interfaces c5/0 dsg downstream tgTG: 1 Chan: 1 state: en pri: 16 Vendor: 1 UCID: 1 2 3 4rule tunnel cfr clientI/F id state id state mac-addr id state dest-ip In-DCD listIdC5/0 1 en 1 en 0101.5e01.0001 1 en 230.1.0.1 yes 16 en 231.1.1.6 no7 en 231.1.1.7 no8 en 231.1.1.8 no2 en 2 en 0101.5e01.0002 2 en 230.1.0.2 yes 23 en 3 en 0101.5e01.0003 3 en 230.1.0.3 yes 3TG: 2 Chan: 1 state: en pri: 11 Vendor: 2 UCID:rule tunnel cfr clientI/F id state id state mac-addr id state dest-ip In-DCD listIdC5/0 4 en 4 en 0002.0002.0001 4 en 230.2.2.1 no 15 en 5 en 0002.0002.0002 5 en 230.2.2.2 no 26 en 6 en 0002.0002.0003 9 en 231.1.1.9 no 21The following examples displays the same type of information as above for the given tunnel group.
Router# show interfaces c5/0 dsg downstream tg 1 channel 1TG: 1 Chan: 1 state: en pri: 16 Vendor: 1 UCID: 1 2 3 4rule tunnel cfr clientI/F id state id state mac-addr id state dest-ip In-DCD listIdC5/0 1 en 1 en 0101.5e01.0001 1 en 230.1.0.1 yes 16 en 231.1.1.6 no7 en 231.1.1.7 no8 en 231.1.1.8 no2 en 2 en 0101.5e01.0002 2 en 230.1.0.2 yes 23 en 3 en 0101.5e01.0003 3 en 230.1.0.3 yes 3show interfaces cable dsg downstream tunnel
To display tunnel information associated with the downstream, use the show interfaces cable dsg downstream tunnel command in privileged EXEC mode.
show interfaces cable {slot/port | slot/subslot/port} dsg downstream tunnel
The following example illustrates interface information for the DSG downstream tunnel in DSG 1.2:
Router# show interfaces c5/0 dsg downstream tunneltunnel TG cfr rule client serviceid state mac-addr id id state id state listId class1 en 0100.5e01.0001 1 1 en 1 en 1 DSG-Rate16 en7 en8 en2 en 0100.5e01.0002 1 2 en 2 en 23 en 0100.5e01.0003 1 3 en 3 en 34 en 0002.0002.0001 2 4 en 4 en 15 en 0002.0002.0002 2 5 en 5 en 2 DSG-Rate26 en 0002.0002.0003 2 9 en 6 en 21show interfaces c5/0 dsg downstream tunnel
To display DSG tunnel information associated with the downstream, use the show interfaces dsg downstream tunnel command in privileged EXEC mode:
show interfaces cslot/port dsg downstream tunnel tunnel-id
The following example illustrates information for the specified interface and tunnel:
Router# show interfaces c5/0 dsg downstream tunnel 1Router# show interfaces c5/0 dsg downstream tunneltunnel TG cfr rule client serviceid state mac-addr id id state id state listId class1 en 0100.5e01.0001 1 1 en 1 en 1 DSG-Rate16 en7 en8 enDebugging Advanced-Mode DSG 1.2
The following commands enable debugging and troubleshooting DSG-specific issues for A-DSG 1.2. To enable debugging for DSG 1.2 on the Cisco CMTS, use the debug cable dsg command in privileged EXEC mode:
debug cable dsg [dcd | pkt]
This command has the following three forms and purposes:
•
•
•
Configuration Examples for Advanced-Mode DSG Issue 1.2
This configuration example, supporting A-DSG 1.2 in Cisco IOS Release 12.3(17a)BC2, illustrates a sample DSG network featuring these components:
•
•
•
•
Each Cisco CMTS is configured as follows, and the remainder of this topic describes example configurations that apply to this architecture.
CMTS Headend #1
•
•
•
•
–
–
CMTS Headend #2
•
•
•
•
–
–
Example of Two DSG Tunnels with MAC DA Substitution
In this configuration, and given the two Cisco CMTS Headends cited above, below are the two sets of DSG rules, with each set applying to each Cisco CMTS, in respective fashion.
These settings apply to DSG #1 and two downstreams:
•
•
•
These settings apply to DSG Rule #2 and two downstreams:
•
•
•
DSG Example with Regionalization Per Downstream
In this configuration, and given the two Cisco CMTS Headends cited earlier in this topic, below are two downstream rules that can be configured in this architecture, for example:
•
–
–
–
•
–
–
–
DSG Example with Regionalization Per Upstream
In this configuration, and given the two Cisco CMTS Headends cited earlier in this topic, below are two upstream rules that can be configured in this architecture, for example:
•
–
–
–
–
•
–
–
–
–
Example of Two DSG Tunnels with Full Classifiers and MAC DA Substitution
In this configuration, and given the two Cisco CMTS Headends cited above, below are the two sets of DSG rules, with each set applying to each Cisco CMTS, in respective fashion.
These settings apply to DSG #1:
•
•
•
•
•
•
•
•
These settings apply to DSG Rule #2:
•
•
•
•
•
•
•
•
Example of One DSG Tunnel Supporting IP Multicast from Multiple DSG Servers
In this configuration, and given the two Cisco CMTS Headends cited earlier in this topic, below is an example of one DSG Tunnel with multiple DSG servers supporting IP Multicast:
•
•
•
•
•
–
–
–
•
–
–
–
Additional References
The following sections provide references related to A-DSG 1.2.
Related Documents
Cisco CMTS Commands
Cisco IOS CMTS Cable Command Reference
http://www.cisco.com/en/US/docs/ios/cable/command/reference/cbl_book.html
Internetworking Terms and Acronyms
Internetworking Terms and Acronyms
http://www.cisco.com/en/US/docs/internetworking/terms_acronyms/ita.html
Standards
CableLabs™ DOCSIS Set-top Gateway (DSG) Interface Specification, CM-SP-DSG-I05-050812
http://www.cisco.com/en/US/docs/internetworking/terms_acronyms/ita.html
MIBs
MIBs additions and enhancements supporting A-DSG 1.2, to include DOCS-DSG-IF-MIB
Cisco CMTS Universal Broadband Router MIB Specifications Guide
http://www.cisco.com/en/US/docs/cable/cmts/mib/reference/guide/mibv5ubr.html
To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL:
Cisco MIB Locator
RFCs
No new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified by this feature.
—
Technical Assistance
Feature Information for Advanced-Mode DSG 1.2 for the Cisco CMTS Routers
Table 2 lists the release history for this feature.
Not all commands may be available in your Cisco IOS software release. For release information about a specific command, see the command reference documentation.
Use Cisco Feature Navigator to find information about platform support and software image support. Cisco Feature Navigator enables you to determine which Cisco IOS and Catalyst OS software images support a specific software release, feature set, or platform. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Note
CCDE, CCENT, CCSI, Cisco Eos, Cisco HealthPresence, Cisco Ironport, the Cisco logo, Cisco Lumin, Cisco Nexus, Cisco Nurse Connect, Cisco Stackpower, Cisco StadiumVision, Cisco TelePresence, Cisco Unified Computing System, Cisco WebEx, DCE, Flip Channels, Flip for Good, Flip Mino, Flip Video, Flip Video (Design), Flipshare (Design), Flip Ultra, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn, Cisco Store, and Flip Gift Card are service marks; and Access Registrar, Aironet, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0907R)
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.
© 2009 Cisco Systems, Inc. All rights reserved.
