Table Of Contents
Advanced-mode DOCSIS Set-Top Gateway 1.1 for the Cisco CMTS
Prerequisites for Advanced-mode DOCSIS Set-Top Gateway
General Prerequisites for A-DSG 1.1
IP Multicast Prerequisites for A-DSG 1.1
IP Unicast Prerequisites for A-DSG 1.1
DSG Configuration File Transfer Operations
DSG Configuration for Cable Per Physical Downstream Static Multicast Support
Resolved Caveats in Cisco IOS Release 12.3(13a)BC
Information About Advanced-mode DOCSIS Set-Top Gateway
A-DSG 1.1 Features and Enhancements for the Cisco CMTS
A-DSG 1.1 and CISCO-CABLE-DSG-IF-MIB
A-DSG 1.1 Downstream Channel Descriptor (DCD)
General Feature Overview for DOCSIS Set-Top Gateway
Basic Structure of the A-DSG 1.1 Network
Using Point of Deployment Modules and DSG Tunnels
Primary Benefits of DOCSIS Set-Top Gateway
How to Configure Advanced-mode DOCSIS Set-Top Gateway 1.1 on the Cisco CMTS
Configuring Global A-DSG 1.1 Settings for the Cisco CMTS
Configuring A-DSG 1.1 Interface Settings for the Cisco CMTS
Configuring Additional Features for Advanced-mode DOCSIS Set-Top Gateway 1.1 on the Cisco CMTS
Configuring Cable Per Physical Downstream Static Multicast Support (optional)
Configuring IP IGMP Static-Group
Configuring IP Multicast Operations
Configuring NAT to Support Unicast Messaging (optional)
Configuring WAN Interfaces for MultiCast Operations
Configuring a Standard IP Access List for Packet Filtering (Optional)
Configuring a Standard IP Access List for Multicast Group Filtering (Optional)
How to Monitor the Advanced-mode DOCSIS Set-Top Gateway Feature
Displaying Advanced-mode DOCSIS Set-Top Gateway Tunnel Configurations
Examples from DSG 1.0 and Cisco IOS Release 12.3(9)
Configuration Examples for Advanced-mode DOCSIS Set-Top Gateway
A-DSG 1.1 Global Configuration Examples
A-DSG 1.1 Cable Interface Configuration Examples
Unicast Messaging Configuration Example
Packet Filtering Access List Configuration Example
IP Multicast Access List Configuration Example
IP Multicast Rate-Limiting Access List Configuration Example
Cisco IOS Release 12.3(13a)BC System Messages
Command Reference for Advanced-mode DSG Issue 1.1
cable downstream dsg chan-list
cable downstream dsg dcd-enable
cable downstream dsg vendor-param
show interface cable dsg downstream
Advanced-mode DOCSIS Set-Top Gateway 1.1 for the Cisco CMTS
This document describes the Advanced-mode DOCSIS Set-Top Gateway (A-DSG) Issue 1.1 on the Cisco Cable Modem Termination System (CMTS), commencing with Cisco IOS release 12.3(13a)BC.
DSG is a CableLabs® specification that allows cable headend equipment such as the Cisco CMTS to provide a class of cable services known as out-of-band (OOB) messaging. OOB messaging is sent to set-top boxes (STBs) over existing Data-over-Cable Service Interface Specifications (DOCSIS) cable networks.
A-DSG 1.1 allows cable Multiple System Operators (MSOs) and other service providers to combine both DOCSIS and Set-top Box (STB) operations over a single, open and vendor-independent network without requiring any changes to the existing DOCSIS network infrastructure. A-DSG 1.1 introduces several additional and powerful enhancements to the Cisco CMTS and subscriber networks using DSG technology, described further in this document.
Note
Cisco IOS Release 12.3(13a)BC introduces a brand new command-line interface (CLI) and associated commands to support Advanced-mode DSG 1.1. These commands are not interoperable with the CLI commands supporting DSG Issue 1.0 and earlier issues prior to Cisco IOS Release 12.3(13a)BC.
When installed on the Cisco router, Cisco IOS Release 12.3(13a)BC converts any pre-existing DSG 1.0 configuration in the startup configuration to A-DSG 1.1 configuration in the running configuration. Cisco IOS 12.3(13a)BC does not support nor run DSG 1.0 configuration, nor does A-DSG 1.1 support the DSG 1.0 SNMP MIB on the 12.3(13a)BC IOS images.
Feature Specifications for Advanced-mode DOCSIS Set-Top Gateway
Finding Support Information for Platforms and Cisco IOS Software Images
Use Cisco Feature Navigator to find information about platform support and Cisco IOS software image support. Access Cisco Feature Navigator at http://tools.cisco.com/ITDIT/CFN/jsp/index.jsp. You must have an account on Cisco.com. If you do not have an account or have forgotten your username or password, click Cancel at the login dialog box and follow the instructions that appear.
Contents
•
•
•
•
•
•
•
Prerequisites for Advanced-mode DOCSIS Set-Top Gateway
This section describes prerequisites for Advanced-mode DSG 1.1.
•
•
•
General Prerequisites for A-DSG 1.1
•
•
•
Refer to the release notes for your Cisco CMTS for additional Cisco IOS information.
Advanced-mode DSG 1.1 (A-DSG 1.1) supports features that are currently described in the CableLabs® DOCSIS CM-SP-DSG-I03-041124 specification, which has a current state of "Issued." Refer to the "A-DSG 1.1 Features and Enhancements for the Cisco CMTS" section.
For additional information about CableLabs® DSG specifications, refer to the following resource:
•
http://www.cablemodem.com/specifications/gateway.html
IP Multicast Prerequisites for A-DSG 1.1
•
•
–
–
–
•
•
•
Tip
IP Unicast Prerequisites for A-DSG 1.1
•
•
Restrictions for A-DSG 1.1
This section describes restrictions for Advanced-mode DSG 1.1, as supported in Cisco IOS release 12.3(13a)BC:
•
•
•
•
•
Additional security configuration must be applied to verify packets in the upstream are valid. Such configurations should include the following steps:
1.
2.
3.
4.
5.
In this configuration, the DSG access group should be as follows:
–
–
–
–
–
–
DSG Restrictions
The following restrictions apply when using DSG configuration:
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.
DSG Configuration for Cable Per Physical Downstream Static Multicast Support
Cable Per Physical Downstream Static Multicast support was first enabled on DSG in Cisco IOS Release 12.3(13a)BC.
Beginning with Cisco IOS 12.3(21)BC, the following a new CLI is enabled for the Cable Per Physical Downstream Static Multicast feature:
cable igmp static-group <multicast group>This CLI will only exist on Slave interfaces and, in order to eliminate any confusion with the DSG configuration, will only be display at "show run" if configured via a CLI. If this new CLI is configured by DSG, the CLI will remain hidden for that particular multicast group.
Note
Note
Resolved Caveats in Cisco IOS Release 12.3(13a)BC
This document will cite Caveats resolved in Cisco IOS release 12.3(13a)BC. However, such Caveats are listed in the following release note documents on Cisco.com:
•
•
http://www.cisco.com/en/US/docs/cable/cmts/ubr7200/release/notes/12_3bc/123BCu72.html
Information About Advanced-mode DOCSIS Set-Top Gateway
This section contains the following topics, and describes the Advanced-mode DOCSIS Set-Top Gateway feature for the Cisco CMTS, with emphasis on Advanced-mode DSG Issue 1.1 (A-DSG):
•
•
•
A-DSG 1.1 Features and Enhancements for the Cisco CMTS
A-DSG 1.1 and Cisco IOS Release 12.3(13a)BC introduce a significant and powerful set of features to MSOs and the Cisco CMTS. These features represent a significant change from DSG 1.0 and earlier DSG issues. Architectural and configuration changes unique to A-DSG 1.1 emphasize the following:
•
A-DSG 1.1 and CISCO-CABLE-DSG-IF-MIB
Cisco IOS Release 12.3(13a)BC does not support the CISCO-CABLE-DSG-IF-MIB. Support for this MIB requires Cisco IOS Release 12.3(9a)BC.
A-DSG 1.1 Tunnels
The A-DSG Agent (the Cisco CMTS) allows the mapping of an IP multicast address to a DSG tunnel MAC address.
Multiple IP multicast addresses can be mapped to a single tunnel, but a specific IP multicast address can only be mapped to one tunnel.
A-DSG tunnels are configured in global configuration mode. Then, classifiers are created with tunnel associations, also in global configuration mode. The association maps an IP multicast address to the tunnel MAC address. Interface configurations then construct the DCD messages that contain both global and interface information about the A-DSG 1.1 tunnel.
When removing the A-DSG tunnel configuration, all DSG classifiers, rules, and classifiers in the rule configuration associated to that tunnel must be unlinked.
For configuration information, refer to the "Configuring Global A-DSG 1.1 Settings for the Cisco CMTS" section.
A-DSG 1.1 Classifiers
A classifier for A-DSG 1.1 is used to provide additional layer 3 and layer 4 filtering for the DSG tunnel. The A-DSG multicast software module applies the classifier parameters to incoming packets received from the A-DSG server in order to assign packets to the appropriate A-DSG tunnel.
Note
Before changing the classifier tunnel association to another DSG tunnel, if a classifier is associated to a rule, then you must remove the classifier that is associated with the rule.
For configuration information, refer to the "Configuring Global A-DSG 1.1 Settings for the Cisco CMTS" section.
A-DSG 1.1 Downstream Channel Descriptor (DCD)
Unlike earlier issues of DSG, Advanced-mode DSG (A-DSG) uses a DOCSIS MAC Management Message called the Downstream Channel Descriptor (DCD) message, and this DCD message manages the DSG Tunnel traffic. The DCD message is sent once per second on each downstream and is used by the DSG Client to determine which tunnel and classifier to use.
The DCD has a DSG address table located in the DOCSIS MAC management message. The primary difference between DSG 1.0 (and earlier issues) and A-DSG 1.1 is that advanced mode uses DCD messages to manage the DSG tunnels.
The DCD message contains a group of DSG Rules and DSG Classifiers, including the following:
•
•
•
•
•
•
•
This collection of DSG rules and classifiers in the DCD message is known as the DSG Address Table. The DCD message is sent by DSG Agent (Cisco CMTS) once per second on each downstream.
The DCD message provides several functions, such as the following:
•
•
•
•
•
The maximum DCD message length is no more than the minimum of 1522 bytes long or the MTU size. If the DCD message length is greater, the DCD message is fragmented and the DCD message is sent in pieces. In that case, the A-DSG agent needs to space out the DCD fragment within one second.
A-DSG 1.1 supports the CableLabs® DOCSIS CM-SP-DSG-I03-041124 specification, with these primary differences between DSG 1.0 and A-DSG 1.1:
•
•
For global configuration information, refer to the "Configuring Global A-DSG 1.1 Settings for the Cisco CMTS" section.
For interface configuration information, refer to the "Configuring A-DSG 1.1 Interface Settings for the Cisco CMTS" section.
A-DSG 1.1 Process
The Advanced DSG 1.1 processor handles the construction and transmission of the DCD message on each downstream. A DCD timer is defined for each downstream and it is initialized during startup. The timer is started when the interface is up and DCD is enabled. The Advanced DCD process wakes up when the timer expires and handles the DCD processing.
For global and timer configuration information, refer to the "Configuring Global A-DSG 1.1 Settings for the Cisco CMTS" section.
For interface configuration information, refer to the "Configuring A-DSG 1.1 Interface Settings for the Cisco CMTS" section.
A-DSG 1.1 Rule
The parameters associated with the DSG rule are used by the DSG Client to determine which DSG Tunnel to receive and if there are any classifiers to apply. DSG rules are included in the DCD message. All the DSG parameters i.e. tunnels, classifiers, client ID list, vendor specific parameters, and UCID range must be configured before it can be associated to the DSG rule. When removing the rule configuration, the global configuration of the tunnel and classifiers associated to that rule should remain same.
For global and timer configuration information, refer to the "Configuring Global A-DSG 1.1 Settings for the Cisco CMTS" section.
For interface configuration information, refer to the "Configuring A-DSG 1.1 Interface Settings for the Cisco CMTS" section.
General Feature Overview for DOCSIS Set-Top Gateway
The Advanced-mode DOCSIS Set-Top Gateway (DSG) feature allows the Cisco CMTS to provide a class of cable services known as out-of-band (OOB) messaging to set-top boxes (STBs) over existing DOCSIS networks. This allows MSOs and other service providers to combine both DOCSIS and STB operations over one, open, vendor-independent network, without any change to the existing network or cable modems.
Out-of-Band Messaging
Out-of-band (OOB) messages allow network control and management messages to be sent to customer premises equipment (CPE) devices, without interfering with the normal data traffic flow. OOB messages also have an advantage over in-band messages in that OOB messages are not dependent on the type of traffic or applications being sent over the network. This allows new OOB messages to be developed and implemented, without requiring any corresponding changes in the network application software.
Previously, OOB messages have been carried over dedicated channels that use proprietary video standards such as SCTE/DVS-167, SCTE/DVS-178, and DVB-RCCL/DAVIC-RCC. These existing systems have the following limitations:
•
•
•
To respond to these limitations, the CableLabs consortium developed the DSG specification to provide a multi-vendor solution that works with both legacy STB and DOCSIS transport paths. This allows MSOs and other service providers to use their legacy systems and STBs over their existing DOCSIS cable plants, while still preparing for DSG-capable STBs that support applications such as Video-on-Demand (VoD), online gaming and other interactive services.
DSG systems allow a wide variety of OOB messages, such as the following standard messages, in addition to generic and vendor-defined messages:
•
•
•
Basic Structure of the A-DSG 1.1 Network
The Advanced-mode DOCSIS Set-Top Gateway feature implements the DSG specification on the Cisco CMTS platform, allowing a Cisco CMTS to support both STBs and cable modems over the existing DOCSIS cable network. The CMTS creates a one-way IP datagram channel, called a DSG tunnel, to transport OOB messages to the STBs, allowing the consolidation of cable modem and STB traffic over the same DOCSIS downstream channel.
A typical DSG network contains the following components:
•
•
•
•
•
•
•
The CA servers transmit OOB messages on the network using multicast IP packets, which are received by STBs that are members of the appropriate multicast groups.
Figure 1 shows a typical DSG network.
Figure 1 DSG Network Diagram
Using Point of Deployment Modules and DSG Tunnels
CA vendors typically provide a Point of Deployment (POD) security module to each set-top box customer. Each POD contains a unique ID and a unique X.509 digital certificate that allows the CA/POD vendor's provisioning systems to securely identify and authenticate each set-top box.
Having securely identified and authenticated a set-top box, the CA/POD vendor transmits the OOB messages to the STB over a DSG tunnel, which is an IP multicast datagram stream carried over the DOCSIS downstream channel. Each DSG tunnel is identified by a well-known Ethernet unicast address that is reserved and published by the CA/POD vendor.
The CA/POD vendors can use the different DSG tunnels to provide different services. For example, one CA/POD vendor could define one tunnel for an Electronic Program Guide (EPG), another tunnel for conditional access (CA) programming, a third tunnel for emergency alerts, and a fourth tunnel for software upgrades. Other vendors can define their tunnels in different ways to provide other services.
DSG Addressing
The Advanced-mode DOCSIS Set-Top Gateway feature uses the following types of addressing to ensure that the proper OOB messages are delivered to the appropriate STBs:
•
•
The Cisco CMTS router supports an unlimited number of destination multicast addresses, which can be mapped to MAC addresses as follows:
•
•
Note
DSG Operation
DSG maps traffic based on the incoming multicast address or a well-known unicast address. The Cisco CMTS performs the following functions when the CMTS receives an OOB packet from the CA servers over the IP network:
1.
2.
3.
4.
5.
Primary Benefits of DOCSIS Set-Top Gateway
The Advanced-mode DOCSIS Set-Top Gateway feature provides the following benefits to cable MSOs, service providers, and their partners and customers.
Part of CableLabs Specifications
The Advanced-mode DOCSIS Set-Top Gateway feature is a CableLabs (http://www.cablelabs.com) specification allows cable MSOs and service providers to create and deploy new interactive services over existing cable networks. Providers can introduce new services, without impacting their existing customers.
Supports Existing DOCSIS Cable Networks
The Advanced-mode DOCSIS Set-Top Gateway feature interoperates with existing DOCSIS-capable networks that can support new interactive services, such as VoD and online gaming, that are expected to become available on cable networks in the future. DOCSIS cable operators can deploy innovative interactive services using the best of the available advanced STB products and middleware and applications software, while still preserving their investment in existing headend systems.
Provides Additional Services
The Advanced-mode DOCSIS Set-Top Gateway feature allows cable operators to offer Internet access, e-mail, chat services, and other high-bandwidth services, in addition to the existing STB services (such as EPG and CA). Providers can deliver high-speed data services to their cable TV subscribers using the DOCSIS network.
Provides the Capability to Use Multiple CA/POD Vendors
The Advanced-mode DOCSIS Set-Top Gateway feature allows cable operators to offer services from many CA/POD vendors, as opposed to existing networks that typically limit the operator to only one vendor per network. This allows greater flexibility in combining or sharing operations between operators or providers.
Uses Standard DOCSIS Networks
The Advanced-mode DOCSIS Set-Top Gateway feature uses existing DOCSIS 1.0, DOCSIS 1.1, and DOCSIS 2.0 networks. MSOs and other service providers can continue to create open-standard, vendor-independent DOCSIS networks, without having to maintain legacy STB systems that could disrupt DOCSIS operations.
Simplifies Network Operations and Cost
MSOs and other service providers can use one simplified return channel architecture to support both STBs and DOCSIS cable modems, instead of using two separate return channels. This lowers the complexity of managing CPE devices and requires less investment in headend equipment, which in turn lowers the overall operations and support costs.
Supports Higher Density of STBs
Depending on the CMTS platform, the higher bandwidth available in DOCSIS networks allows MSOs and other service providers to support a higher maximum number of STBs per headend system.
How to Configure Advanced-mode DOCSIS Set-Top Gateway 1.1 on the Cisco CMTS
This section contains two procedures, both of which are required to enable and configure A-DSG 1.1 on the Cisco CMTS:
•
•
Configuring Global A-DSG 1.1 Settings for the Cisco CMTS
Global configuration commands for A-DSG 1.1 configure the following settings on the Cisco CMTS:
•
•
•
•
These global A-DSG settings and parameters are uniquely identified by A-DSG indexes. The indexes are then used with interface commands to define DCD messages. The interface commands define the DSG rules, tunnel traffic, and parameters to include in the DCD message. The following procedure describes global configuration for A-DSG 1.1, to precede interface configuration.
SUMMARY STEPS
1.
2.
3.
4.
5.
6.
7.
8.
9.
DETAILED STEPS
What to Do Next
After global settings are defined for A-DSG 1.1, interface configurations must complete the configuration on the Cisco CMTS. Refer to the "Configuring A-DSG 1.1 Interface Settings for the Cisco CMTS" section.
For additional information about global configuration commands, refer to the "Command Reference for Advanced-mode DSG Issue 1.1" section.
Configuring A-DSG 1.1 Interface Settings for the Cisco CMTS
A-DSG 1.1 parameters are uniquely identified by A-DSG indexes in global configuration mode. Then, those indexes are used with the interface commands in this section to define DCD messages. These interface commands define the DSG rules, tunnel traffic, and additional parameters to include in the DCD message.
Prerequisites
Global configurations for A-DSG 1.1 must be defined and enabled on the Cisco CMTS in order to complete A-DSG 1.1 interface configurations and A-DSG operation.
SUMMARY STEPS
1.
2.
3.
5.
7.
8.
DETAILED STEPS
Examples
The 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....
Configuring Additional Features for Advanced-mode DOCSIS Set-Top Gateway 1.1 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 Cable Per Physical Downstream Static Multicast Support (optional)
This section describes how to configure support for Cable per physical downstream Static Multicast on the Cisco CMTS. Doing so will enable the Cisco CMTS to control the replication of static IP multicast streams within a cable bundle.
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_3/ipmulti/command/reference/ip3_m1g.html
Step 4
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 5
ip pim version 3
Example:Router(config-if)# ip igmp version 3
Router#
Enables IGMPv3 on this interface. The default version of IGMP is set to Version 2.
Step 6
ip igmp static-group {* | group-address [source {source-address | ssm-map}] | class-map class-map-name}
Example:Router(config-if)# ip igmp static-group {* | 232.1.1.7 [source {232 | ssm-map}] | class-map static1}
Router#
Configure static group membership entries on the cable interface.
Step 7
cable igmp static-group [multicast group] source [source IP] [subinterface number]
Example:Router(config-if)# cable igmp static-group 232.1.1.1 source 10.1.1.1
Controls the replication of static IP multicast streams within a cable bundle.
This command can only be configured on cable physical interface as part of a Cable Bundle group.
This command, by itself, does not take any effect. It must be configure with the ip igmp static-group command, which is configured at Bundle interface.
The [source IP] option is used for SSM group range, as defined in ip pim ssm CLI. This is similar to the ip igmp static-group command usage.
The [subinteface number] option must be used if there are multiple Bundle subinterfaces (Bundle1.1, Bundle 1.2, etc.)
Note
Step 8
cable bundle n
Example:Router(config-if)# cable bundle 1
Router#
Configures the cable interface to be a slave bundle for the specified bundle group.
•
Step 9
exit
Example:Router(config-if)# exit
Router#
Exits interface configuration mode and returns to privileged EXEC mode.
Configuring IP IGMP Static-Group
This section describes how to configure ip igmp static-group on the Cisco CMTS. Doing so will enable the Cisco CMTS to be a statically connected member of the specified group on the interface.
SUMMARY STEPS
1.
2.
3.
4.
5.
6.
7.
8.
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_3/ipmulti/command/reference/ip3_m1g.html
Step 4
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 5
ip pim version 3
Example:Router(config-if)# ip igmp version 3
Router#
Enables IGMPv3 on this interface. The default version of IGMP is set to Version 2.
Step 6
ip igmp static-group {* | group-address [source {source-address | ssm-map}] | class-map class-map-name}
Example:Router(config-if)# ip igmp static-group {* | 232.1.1.7 [source {232 | ssm-map}] | class-map static1}
Router#
Configure static group membership entries on the cable interface.
Step 7
cable bundle n
Example:Router(config-if)# cable bundle 1
Router#
Configures the cable interface to be a slave bundle for the specified bundle group.
•
Step 8
exit
Example:Router(config-if)# exit
Router#
Exits interface configuration mode and returns to privileged EXEC mode.
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_3/ipmulti/command/reference/ip3_m1g.html
Step 4
ip cef [distributed] [accounting type | load-sharing algorithm algorithm | table type | traffic-statistics]
Example:Router(config)#
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/swi_i1.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.
Configuring NAT to Support Unicast Messaging (optional)
This section describes how to configure a Cisco CMTS router for Network Address Translation (NAT) so as 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.1 can also use an external router that is close to the Cisco CMTS to support unicast messaging. I n 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" NAT (private) 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.1, 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/ip3_m1g.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_3/ipmulti/command/reference/ip3_m1g.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/swi_i1.html
Configuring a Standard IP Access List for Packet Filtering (Optional)
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: Standard Access lists only allow one address to be specified in the earlier step. If you apply an outbound access-list with only the multicast address of the tunnel denied, then the DSG traffic is not allowed to pass.
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 (Optional)
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 the Advanced-mode DOCSIS Set-Top Gateway Feature
This section describes the following procedures that you can use to monitor and display information about the Advanced-mode DOCSIS Set-Top Gateway feature:
•
Displaying Advanced-mode DOCSIS Set-Top Gateway Tunnel Configurations
To display the mapping table for a specific DSG tunnel, use the show cable dsg tunnel command in privileged EXEC mode. You can display information about DSG statistics and about DSG tunnels. The examples in another section provide typical displays of each command.
Refer to the "Configuration Examples for Advanced-mode DOCSIS Set-Top Gateway" section for additional information.
The following example displays the mapping table for all DSG 1.1 tunnel MAC addresses in Cisco IOS Release 12.3(9a)BC:
Router# show cable dsg tunnelGroup-ip Src-ip Tunnel-MAC Interface Packets CA-vendor239.0.0.112 * 0010.18ff.ff00 Cable6/0 0 nds239.0.0.113 * 0010.18ff.ff00 Cable6/0 0 nds224.1.1.1 * 0001.0001.0001 Cable6/0 0 abc224.1.1.2 * 0001.0001.0002 Cable6/0 0 abc224.1.1.3 * 0001.0001.0003 Cable6/0 0 abc224.1.1.4 * 0001.0001.0004 Cable6/0 0 abc224.1.1.5 * 0001.0001.0005 Cable6/0 0 abc224.1.1.6 * 0001.0001.0006 Cable6/0 0 T5 t6The following example displays the statistics for all DSG 1.1 vendor tunnels in Cisco IOS Release 12.3(9a)BC:
Router# show cable dsg statsVendor: bg, Tunnel count: 80004.0004.0004229.4.4.4Cable8/1/0 Resolves: 27 Rcv/Fwd/Drp: 0/0/00001.0001.0002229.1.1.2Cable8/1/0 Resolves: 19 Rcv/Fwd/Drp: 0/0/00001.0001.0003229.1.1.3Cable8/1/0 Resolves: 11 Rcv/Fwd/Drp: 0/0/00001.0001.0004229.1.1.4Cable8/1/0 Resolves: 11 Rcv/Fwd/Drp: 0/0/00001.0001.0005229.1.1.5Cable8/1/0 Resolves: 11 Rcv/Fwd/Drp: 0/0/00001.0001.0006229.1.1.6Cable8/1/0 Resolves: 11 Rcv/Fwd/Drp: 0/0/00001.0001.0007229.1.1.7Cable8/1/0 Resolves: 11 Rcv/Fwd/Drp: 0/0/00001.0001.0008229.1.1.8Cable8/1/0 Resolves: 11 Rcv/Fwd/Drp: 0/0/0Vendor: t, Tunnel count: 80000.0000.0001230.0.0.1Cable8/1/0 Resolves: 11 Rcv/Fwd/Drp: 0/0/00000.0000.0002230.0.0.2Cable8/1/0 Resolves: 11 Rcv/Fwd/Drp: 0/0/00000.0000.0003230.0.0.3Cable8/1/0 Resolves: 11 Rcv/Fwd/Drp: 0/0/00000.0000.0004230.0.0.4Cable8/1/0 Resolves: 11 Rcv/Fwd/Drp: 0/0/00000.0000.0005230.0.0.5Cable8/1/0 Resolves: 11 Rcv/Fwd/Drp: 0/0/00000.0000.0006230.0.0.6Cable8/1/0 Resolves: 11 Rcv/Fwd/Drp: 0/0/00000.0000.0007230.0.0.7Cable8/1/0 Resolves: 11 Rcv/Fwd/Drp: 0/0/00000.0000.0008230.0.0.8Cable8/1/0 Resolves: 11 Rcv/Fwd/Drp: 0/0/0Vendor: bg2, Tunnel count: 70001.0002.0008229.1.2.8Cable8/1/0 Resolves: 11 Rcv/Fwd/Drp: 0/0/00001.0002.0007229.1.2.7Cable8/1/0 Resolves: 11 Rcv/Fwd/Drp: 0/0/00001.0002.0005229.1.2.5Cable8/1/0 Resolves: 11 Rcv/Fwd/Drp: 0/0/00001.0002.0004229.1.2.4Cable8/1/0 Resolves: 11 Rcv/Fwd/Drp: 0/0/00001.0002.0003229.1.2.3Cable8/1/0 Resolves: 11 Rcv/Fwd/Drp: 0/0/00001.0002.0002229.1.2.2Cable8/1/0 Resolves: 11 Rcv/Fwd/Drp: 0/0/00001.0002.0001229.1.2.1Cable8/1/0 Resolves: 11 Rcv/Fwd/Drp: 0/0/0Vendor: nds, Tunnel count: 1dead.beaf.fefe239.0.0.113Cable8/1/0 Resolves: 39 Rcv/Fwd/Drp: 0/0/0Router#The following example illustrates the show cable dsg tunnel command for A-DSG 1.1 on the Cisco uBR10012 router:
show cable dsg <tunnel mac addr | interface>============================================Tunnel ClassifierMAC Addr Interface Srv-Class Dst-IP Pri Src-IP Packets0004.0004.0004 C8/1/0 srvclassA 229.4.4.4 0 100.1.1.1 99229.4.4.5 1 100.1.1.2 99The following example illustrates the show cable dsg rule command for DSG Issue 1.1 on the Cisco uBR10012 router:
Router# show cable dsg rule c8/1/0Rule UCID Client Tunnel Vender ClassifierID Pri Interface Range ID ID ID Dst-IP Pri Src-IP1 1 C8/1/0 1-4 1 1 1 229.4.4.4 0 100.1.1.1 229.4.4.5 1 100.1.1.2The following example illustrates the show cable dsg rule command for DSG Issue 1.1 on the Cisco uBR10012 router:
show cable dsg rule <interface>===============================Rule UCID Client Tunnel Vender ClassifierID Pri Interface Range ID ID ID Dst-IP Pri Src-IP1 1 C8/1/0 1-4 1 1 1 229.4.4.4 0100.1.1.1229.4.4.5 1100.1.1.2The following example illustrates the show cable dsg rule command for DSG Issue 1,1 on the Cisco uBR10012 router:
show cable dsg stats <tunnel mac addr | interface>==================================================0004.0004.0004 229.4.4.4 C8/1/0 DCD Sent: 99 DCD Change Count: 7Resolves: 10 Rcv/Fwd/Drp: 0/0/0Examples from DSG 1.0 and Cisco IOS Release 12.3(9)
The following example displays the statistics for the specified DSG 1.0 vendor tunnel in Cisco IOS Release 12.3(9a)BC:
Router# show cable dsg stats 0001.0001.0001DSG statistics informationVendor name is abc, tunnel MAC is 0001.0001.0001Group address is 224.1.1.1, source address is *Interface is Cable6/0, mapping entry is used 0Received 0 packets, forwarded 0 packetsDropped 0 packets
Note
The following example displays the mapping table for the specified DSG 1.0 tunnel MAC address:
Router# show cable dsg tunnel 0009.0009.0009Group-ip Src-ip Tunnel-MAC Interface Packets CA-vendor224.13.13.1 * 0009.0009.0009 Cable5/0 0 AAA224.12.12.1 * 0009.0009.0009 Cable5/0 0 AAAThe following examples illustrate show cable dsg commands with Cisco IOS Release 12.3(9a)BC and DSG Issue 1.0 with enhanced syntax on a Cisco uBR10012 router:
Router# show cable dsg stats 0050.4d00.0002DSG statistics informationDSG keepalive is setVendor name is nds, tunnel MAC is 0050.4d00.0002Group address is 224.1.2.3, source address is *Interface is Cable6/0, interface Cable6/0 is bundle mastermapping entry is used 85Received 0 packets, forwarded 0 packetsDropped 0 packetsThe following examples illustrate show cable dsg commands with Cisco IOS Release 12.3(9a)BC and DSG Issue 1.0 with enhanced syntax on a Cisco uBR7246VXR router:
Router# show cable dsg tunnelGroup-ip Src-ip Tunnel-MAC Interface Packets CA-vendor224.1.2.3 * 0050.4d00.0002 Cable6/0 0 ndsRouter# show cable dsg tunnel 0050.4d00.0002Group-ip Src-ip Tunnel-MAC Interface Packets CA-vendor224.1.2.3 * 0050.4d00.0002 Cable6/0 0 ndsRouter# show cable dsg statsDSG statistics informationDSG keepalive is setVendor: nds, Tunnel count: 1Vendor name is nds, tunnel MAC is 0050.4d00.0002Group address is 224.1.2.3, source address is *Interface is Cable6/0, interface Cable6/0 is bundle mastermapping entry is used 85Received 0 packets, forwarded 0 packetsDropped 0 packetsExamples from DSG Issue 0.9
The following examples illustrate show cable dsg commands with Cisco IOS Release 12.3(9a)BC and DSG Issue 0.9:
Router# show cable dsg ?keepalive Show DSG keepalive statusstats Show statistics information of DSGtunnel Show DSG tunnel tableRouter# show cable dsg keepaliveDSG keeplive is disabled, keepalives transmitted: 0Router# show cable dsg statsVendor: bg, Tunnel count: 10004.0004.0004229.4.4.4Cable8/1/0 Resolves: 0 Rcv/Fwd/Drp: 0/0/0Router# show cable dsg tunnelDst-ip Src-ip Tunnel-MAC Interface Packets Vendor229.4.4.4 * 0004.0004.0004 Cable8/1/0 0 bgRouter# show cable dsg tunnel ?H.H.H A DSG tunnel MAC addressvendor Show dsg tunnels for the specific vendor| Output modifiers<cr>Router# show cable dsg tunnel 0004.0004.0004Dst-ip Src-ip Tunnel-MAC Interface Packets Vendor229.4.4.4 * 0004.0004.0004 Cable8/1/0 0 bgRouter# show cable dsg tunnelDst-ip: Src-ip: Tunnel-MAC: interface: packets: vendor:229.2.0.99 * 1111.1111.1111 Cable4/0 123 bg229.7.5.99 10.10.2.56 1111.2222.2222 Cable5/0 1 bg229.7.5.98 * 1111.2222.2222 Cable3/0 4003 bgRouter# show cable dsg statVendor: bg, Tunnel count: 21111.1111.1111229.2.0.99Cable4/0 Resolves: 4 Rcv/Fwd/Drp: 323/323/01111.2222.2222229.7.5.99Cable5/0 Resolves: 4 Rcv/Fwd/Drp: 1/1/0229.7.5.98Cable3/0 Resolves: 180 Rcv/Fwd/Drp: 6213/6213/0Router# show cable dsg statsDSG statistics informationVendor: abc, Tunnel count: 3Vendor: cisco, Tunnel count: 4Vendor name is abc, tunnel MAC is 000d.000d.000dGroup address is 230.6.6.6, source address is *Interface is Cable3/0, mapping entry is used 2Received 0 packets, forwarded 0 packetsDropped 0 packets, last second rate 0 bits/secVendor name is abc, tunnel MAC is 000e.000e.000eGroup address is 230.7.7.7, source address is *Interface is Cable3/0, mapping entry is used 4Received 0 packets, forwarded 0 packetsDropped 0 packets, last second rate 0 bits/secVendor name is abc, tunnel MAC is 000c.000c.000cGroup address is 230.5.5.5, source address is *Interface is Cable3/0, mapping entry is used 4Received 0 packets, forwarded 0 packetsDropped 0 packets, last second rate 0 bits/secVendor name is cisco, tunnel MAC is 000b.000b.000bGroup address is 230.4.4.4, source address is *Interface is Cable3/0, mapping entry is used 4Received 0 packets, forwarded 0 packetsDropped 0 packets, last second rate 0 bits/secVendor name is cisco, tunnel MAC is 0009.0009.0009Group address is 229.1.1.1, source address is *Interface is Cable3/0, mapping entry is used 3Received 0 packets, forwarded 0 packetsDropped 0 packets, last second rate 0 bits/secVendor name is cisco, tunnel MAC is 0008.0008.0008Group address is 228.1.1.1, source address is *Interface is Cable3/0, mapping entry is used 4Received 0 packets, forwarded 0 packetsDropped 0 packets, last second rate 0 bits/secVendor name is cisco, tunnel MAC is 000a.000a.000aGroup address is 230.1.1.1, source address is *Interface is Cable3/0, mapping entry is used 6Received 242217224 packets, forwarded 180194756 packetsDropped 62022468 packets, last second rate 501414 bits/secVendor name is cisco, tunnel MAC is 000a.000a.000aGroup address is 230.1.1.1, source address is *Interface is Cable4/0, mapping entry is used 18Received 242218258 packets, forwarded 1482 packetsDropped 242216776 packets, last second rate 501414 bits/secVendor name is cisco, tunnel MAC is 000a.000a.000aGroup address is 230.1.1.1, source address is *Interface is Cable5/0.1, mapping entry is used 6Received 242218258 packets, forwarded 1534970 packetsDropped 240683288 packets, last second rate 501414 bits/sec
Note
Configuration Examples for Advanced-mode DOCSIS Set-Top Gateway
This section provides the following configuration examples for the Advanced-mode DOCSIS Set-Top Gateway feature:
•
•
•
•
•
•
•
A-DSG 1.1 Global Configuration Examples
show cable dsg tunnel
The following example illustrates configuration information with the show cable dsg tunnel command, to include tunnel MAC address, state, number of classifiers associated, number of interfaces to which tunnel is associated, number clients associated, and the QoS service class name for all the configured tunnels.
Router# show cab dsg tunneltunnel tunnel tunnel cfr cfr tunnel in rule rule client serviceid state mac-addr id state interface id state listId class1 en 0100.5e01.0114 1 en Cable5/0 1 en 211 en 7 dis 1014 en 8 dis 220 en 2Cable5/1 7 dis 108 dis 22 en 0100.5e01.0115 2 en Cable5/0 2 en 210 en3 en 0100.5e01.0128 3 en Cable5/0 3 en 34 en 0100.5e01.0133 4 en Cable5/0 4 dis 45 en 0100.5e01.013c 5 en Cable5/0 5 dis 59 en6 dis 0100.5e01.0146 6 en Cable5/0 6 dis 67 dis 0100.5e01.01508 en 0100.5e01.01199 en 0100.5e01.013310 en 0100.5e01.014711 en 2222.2222.222212 en 3333.3333.3333The following example illustrates information for a specified tunnel:
Router# show cab dsg tunnel 1tunnel tunnel tunnel cfr cfr tunnel in rule rule client serviceid state mac-addr id state interface id state listId class1 en 0100.5e01.0114 1 en Cable5/0 1 en 211 en 7 dis 1014 en 8 dis 220 en 2Cable5/1 7 dis 108 dis 24 en 411 en 2The following example illustrates information about all the classifiers associated with a given tunnel.
Router# show cab 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.1.20 0.0.0.0 32 0 6553511 en 0 224.25.25.134 0.0.0.0 32 0 6553514 en 0 230.1.1.20 0.0.0.0 32 1000 2000The following example illustrates information about all the clients associated with a given tunnel:
Router# show cab dsg tunnel 1 clientstunnel client client client clientid listId id id type address1 2 1 CA System ID: 09513 Broadcast8 MAC Addr: 1111.1111.111110 1 Application ID: 0001The following example illustrates information about all the interfaces and rules associated with a given tunnel:
Router# show cab dsg tunnel 1 interfacestunnel downstream ruleid interface id1 Cable5/0 1 7 8 20Cable5/1 7 8The following example illustrates information about the packet statistics information for a given tunnel:
Router# show cab dsg tunnel 1 statisticstunnel cfr cfr destination ip source ip total totalid id state address address forwarded received1 1 en 230.1.1.20 0.0.0.0 0 011 en 224.25.25.134 0.0.0.0 0 014 en 230.1.1.20 0.0.0.0 0 0The following example illustrates detailed information about a given tunnel:
Router#show cab dsg tunnel 1 verboseTunnel ID : 1State : enableMAC Addr : 0100.5e01.0114Cfr Id : 1State : enablePriority : 0Dest IP : 230.1.1.20Src IP : 0.0.0.0Src Prefix Length : 32Dest Port Start : 0Dest Port End : 65535Forwarded : 0Received : 0Cfr Id : 11State : enablePriority : 0Dest IP : 224.25.25.134Src IP : 0.0.0.0Src Prefix Length : 32Dest Port Start : 0Dest Port End : 65535Forwarded : 0Received : 0Cfr Id : 14State : enablePriority : 0Dest IP : 230.1.1.20Src IP : 0.0.0.0Src Prefix Length : 32Dest Port Start : 1000Dest Port End : 2000Forwarded : 0Received : 0Client List Id : 2Client Id : 1Client Id Type : CA System ID: 0951Client Id : 3Client Id Type : BroadcastClient Id : 8Client Id Type : MAC Addr: 1111.1111.1111Client List Id : 10Client Id : 1Client Id Type : Application ID: 0001Interface : Cable5/0Rule Id : 1Rule Id : 7Rule Id : 8Rule Id : 20Interface : Cable5/1Rule Id : 7Rule Id : 8A-DSG 1.1 Cable Interface Configuration Examples
The following examples illustrate cable interface configurations with the Advanced-mode DOCSIS Set-Top Gateway (DSG) 1.0 feature enabled:
Tip
The following sample configuration requires IP PIM sparse mode for the Gigabit Ethernet interface:
...ip multicast-routing...interface GigabitEthernet 1/0ip mroute-cachedescription wan interface to CA and other DSG servers...interface c6/0ip address 10.10.10.11 255.255.255.0ip pim sparse-modeip igmp static-group 239.0.0.2ip multicast rate-limit out group-listip mroute-cachecable dsg 1.2.3 239.0.0.2 CCC...
Note
The following example illustrates syntax options for the show interface cable dsg downstream command for the specified interface:
Router# sh int c6/0 dsg downstream ?dcd Show DSG downstream dcd messagerule Show DSG downstream ruletunnel Show DSG downstream tunnel| Output modifiersThe following example illustrates A-DSG 1.1 downstream configuration information and the number of tunnels, classifiers, clients and vender-specific parameters:
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 vsp12 1 930 12 2 900 300 750 9 6 4 6 12 9903 105The following example illustrates DCD statistics for the given downstream interface. DCD TLV displays if the debug cable dsg command is enabled:
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 797148 0 28 1Router# debug cable dsgCMTS DSG debugging is onRouter# 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 797163 0 28 1Router#1w3d: DCD TLV last sent:32290101 01020102 040E0302 09510100 02061111 11111111 05060100 5E01011406020001 2B050803 00001117 0F020200 01050100 09060504 E6010114 3226010102020100 040E0302 09510100 02061111 11111111 05060100 5E010115 060200020602000A 170F0202 00020501 00090605 04E60101 15170F02 02000A05 010009060504E601 010A321C 01010302 01000408 02063333 33333333 05060100 5E01012806020003 170F0202 00030501 00090605 04E60101 28322901 01140201 00040E0302095101 00020611 11111111 11050601 005E0101 14060200 012B0508 0300001133290104 058B1140 010405E6 9EC00104 06422C40 02020002 03020384 0402012C050202EE 2B050803 000011The following example illustrates A-DSG 1.1 rule state, tunnels, classifiers, client information, upstream channel ID and the number of vendors associated to a DSG rule on a given downstream interface:
Router# show interfaces c5/0 dsg downstream rulerule rule rule tunnel tunnel tunnel cfr cfr cfrIn client vspid state pri id state mac-addr id state rule listId index1 en 2 1 en 0100.5e01.0114 1 en yes 2 111 en no14 en no2 en 0 2 en 0100.5e01.0115 2 en yes 210 en yes3 en 0 3 en 0100.5e01.0128 3 en yes 34 dis 0 4 en 0100.5e01.0133 4 en no 45 dis 0 5 en 0100.5e01.013c 5 en no 59 en no6 dis 0 6 dis 0100.5e01.0146 6 en no 67 dis 0 1 en 0100.5e01.0114 1 en no 1011 en no14 en no8 dis 0 1 en 0100.5e01.0114 1 en no 211 en no14 en no20 en 0 1 en 0100.5e01.0114 1 en yes 2 111 en no14 en noThe following example illustrates the same information as above for the given DSG rule:
Router# show interfaces c5/0 dsg downstream rule 1rule rule rule tunnel tunnel tunnel cfr cfr cfrIn client vspid state pri id state mac-addr id state rule listId index1 en 2 1 en 0100.5e01.0114 1 en yes 2 111 en noThe following example illustrates syntax options for the show interface cable dsg downstream rule command for the specified interface:
Router# sh int c6/0 dsg downstream rule 1 ?cfr Show DSG downstream rule classifiersclients Show DSG downstream rule clientsverbose Show DSG downstream rule detail information| Output modifiersThe following example illustrates the list of classifiers associated to the DSG rule:
Router# show interfaces c5/0 dsg downstream rule 1 cfrrule cfr cfr cfrIn cfr destination ip source ip srcPre d_port d_portid id state rule pri address address length start end1 1 en yes 0 230.1.1.20 0.0.0.0 32 0 6553511 en no 0 224.25.25.134 0.0.0.0 32 0 6553514 en no 0 230.1.1.20 0.0.0.0 32 1000 2000The following example illustrates the list of clients associated to the DSG rule:
Router# show interfaces c5/0 dsg downstream rule 1 clientsrule rule rule client client client clientid state pri listId id id type address1 en 2 2 1 CA System ID 0x09513 Broadcast8 MAC Addr 1111.1111.111The following example illustrates detailed information about the DSG rule:
Router# show interfaces c5/0 dsg downstream rule 1 verboseRule ID : 1State : enablePriority : 2Tunnel ID : 1State : enableMAC Addr : 0100.5e01.0114Cfr Id : 1State : enablePriority : 0Dest IP : 230.1.1.20Src IP : 0.0.0.0Src Prefix Length : 32Dest Port Start : 0Dest Port End : 65535Cfr Id : 11State : enablePriority : 0Dest IP : 224.25.25.134Src IP : 0.0.0.0Src Prefix Length : 32Dest Port Start : 0Dest Port End : 65535Cfr Id : 14State : enablePriority : 0Dest IP : 230.1.1.20Src IP : 0.0.0.0Src Prefix Length : 32Dest Port Start : 1000Dest Port End : 2000Client List Id : 2Client Id : 1Client Id Type : CA System ID 0x0951Client Id : 3Client Id Type : BroadcastClient Id : 8Client Id Type : MAC Addr 1111.1111.1111vsif index : 1vsif oui : 0X11vsif value : 0XThe following example illustrates the DSG tunnel information associated with the downstream interface:
Router# show interfaces c5/0 dsg downstream tunneltunnel tunnel tunnel cfr cfr rule rule client serviceid state mac-addr id state id state listId class1 en 0100.5e01.0114 1 en 1 en 211 en 7 dis 1014 en 8 dis 220 en 22 en 0100.5e01.0115 2 en 2 en 210 en3 en 0100.5e01.0128 3 en 3 en 34 en 0100.5e01.0133 4 en 4 dis 45 en 0100.5e01.013c 5 en 5 dis 59 en6 dis 0100.5e01.0146 6 en 6 dis 6The following example illustrates DSG tunnel information associated with the downstream interface:
Router#show interfaces c5/0 dsg downstream tunnel 1tunnel tunnel tunnel cfr cfr rule rule client serviceid state mac-addr id state id state listId class1 en 0100.5e01.0114 1 en 1 en 211 en 7 dis 1014 en 8 dis 220 en 2A-DSG 1.Subinterface Configuration Example
The following example illustrates a more complex configuration with the use of subinterfaces:
version 12.2service timestamps debug uptimeservice timestamps log uptimeservice password-encryption!hostname dsg-ubr7114!logging queue-limit 100!no cable qos permission createno cable qos permission updatecable qos permission modemsip subnet-zero!!ip cef!ip multicast-routingmpls ldp logging neighbor-changes!!!interface FastEthernet0/0ip address 1.8.8.13 255.255.0.0duplex autospeed auto!interface FastEthernet0/1no ip addressshutdownduplex autospeed auto!interface Cable1/0ip address 2.75.25.1 255.255.255.0ip pim sparse-modeip helper-address 1.8.35.200cable downstream annex Bcable downstream modulation 256qamcable downstream interleave-depth 32cable downstream channel-id 0cable downstream rf-shutdowncable upstream 0 frequency 33008000cable upstream 0 power-level 0cable upstream 0 channel-width 1600000cable upstream 0 minislot-size 4cable upstream 0 modulation-profile 1no cable upstream 0 shutdowncable upstream 1 channel-width 1600000cable upstream 1 minislot-size 4cable upstream 1 modulation-profile 1cable upstream 1 shutdowncable upstream 2 channel-width 1600000cable upstream 2 minislot-size 4cable upstream 2 modulation-profile 1cable upstream 2 shutdowncable upstream 3 channel-width 1600000cable upstream 3 minislot-size 4cable upstream 3 modulation-profile 1cable upstream 3 shutdown!interface Cable1/0.1ip igmp static-group 224.11.11.1ip igmp static-group 224.12.12.1ip igmp static-group 224.3.3.2ip igmp static-group 224.3.3.3ip igmp static-group 224.3.3.6ip igmp static-group 224.3.3.7ip igmp static-group 224.3.3.8ip igmp static-group 224.3.3.9ip igmp static-group 224.3.3.18ip igmp static-group 224.3.3.19ip igmp static-group 224.3.3.20ip igmp static-group 224.3.3.21ip igmp static-group 224.3.3.22ip igmp static-group 224.3.3.93ip igmp static-group 224.3.3.97ip igmp static-group 224.3.3.95ip igmp static-group 224.3.3.98ip igmp static-group 224.5.5.8ip igmp static-group 224.5.5.10ip igmp static-group 224.3.4.12ip igmp static-group 224.3.3.25ip igmp static-group 224.4.4.1ip igmp static-group 224.5.5.5ip igmp static-group 224.5.5.11ip igmp static-group 224.5.5.12ip igmp static-group 224.5.5.13ip igmp static-group 224.5.5.14ip igmp static-group 224.5.5.15ip igmp static-group 224.5.5.16ip igmp static-group 224.6.6.7ip igmp static-group 224.6.6.9ip igmp static-group 224.6.6.10ip igmp static-group 224.6.6.11ip igmp static-group 224.7.7.1ip igmp static-group 224.8.8.1ip igmp static-group 224.8.8.2ip igmp static-group 224.8.8.10ip igmp static-group 224.9.9.1cable dsg 0009.0009.0009 224.12.12.1 sciencecable dsg 0010.0010.0010 224.11.11.1 sciencecable dsg 0001.0001.0001 224.3.3.97 ciscocable dsg 0001.0001.0001 224.3.3.98 ciscocable dsg 0001.0001.0001 224.3.3.93 ciscocable dsg 0001.0001.0001 224.3.3.95 ciscocable dsg 0006.0006.0006 224.9.9.1 microsocable dsg 0005.0005.0005 224.8.8.1 ibmcable dsg 0001.0001.0001 224.7.7.1 ciscocable dsg 0001.0001.0002 224.4.4.1 ciscocable dsg 0005.0005.0005 224.8.8.2 ibmcable dsg 0001.0001.0001 224.3.3.2 ciscocable dsg 0001.0001.0001 224.3.3.3 ciscocable dsg 1234.1234.1234 224.5.5.5 ciscocable dsg 0001.0001.0001 224.3.3.6 ciscocable dsg 0001.0001.0001 224.3.3.7 ciscocable dsg 00dd.0001.0001 224.6.6.7 ciscocable dsg 0001.0001.0001 224.3.3.8 ciscocable dsg 0001.0001.0001 224.5.5.8 ciscocable dsg 0001.0001.0001 224.3.3.9 ciscocable dsg 10dd.0001.0001 224.6.6.9 ibmcable dsg 0000.0000.0000 224.8.8.10 sciencecable dsg 0001.0001.0001 224.5.5.10 ciscocable dsg 10dd.0002.0002 224.6.6.10 ibmcable dsg 0001.0001.0001 224.3.4.12 ciscocable dsg 0003.0001.0001 224.5.5.11 ciscocable dsg 0000.0000.0001 224.6.6.11 ibmcable dsg 0033.0001.0001 224.5.5.12 ciscocable dsg 00cc.0001.0001 224.5.5.13 ciscocable dsg 00cc.0001.0001 224.5.5.14 ciscocable dsg 00cd.0001.0001 224.5.5.15 ciscocable dsg 00dd.0001.0001 224.5.5.16 ciscocable dsg 0001.0001.0001 224.3.3.18 ciscocable dsg 0001.0001.0001 224.3.3.19 ciscocable dsg 0001.0001.0001 224.3.3.20 ciscocable dsg 0001.0001.0001 224.3.3.21 ciscocable dsg 0001.0001.0001 224.3.3.22 ciscocable dsg 0001.0001.0001 224.3.3.25 cisco!interface Cable1/0.2ip igmp static-group 224.11.11.2ip igmp static-group 224.13.13.1cable dsg 0009.0009.0009 224.13.13.1 sciencecable dsg 0011.0011.0011 224.11.11.2 science!interface Ethernet3/0ip address 10.0.0.2 255.0.0.0ip pim sparse-modeduplex half!interface Ethernet3/1no ip addressshutdownduplex half!interface Ethernet3/2no ip addressshutdownduplex half!interface Ethernet3/3no ip addressshutdownduplex half!router eigrp 1auto-summary!ip default-gateway 1.8.0.1ip classlessip route 0.0.0.0 0.0.0.0 1.8.0.1ip route 1.0.0.0 255.0.0.0 1.8.0.1ip route 223.255.254.254 255.255.255.255 1.8.0.1no ip http serverno ip http secure-server!!!access-list 101 permit igmp host 10.0.0.1 host 224.3.3.1cdp run!!line con 0line aux 0line vty 0 4password labloginline vty 5 15login!scheduler allocate 3996 400Unicast Messaging Configuration Example
The following excerpt from a configuration file enables basic DSG 1.0 operations on a cable interface, using unicast IP addresses for DSG messaging. This example illustrates that the interfaces have been configured for NAT so as to enable the use of Unicast DSG addresses.
...ip multicast-routing...interface GigabitEthernet 1/0ip address 10.10.2.50 255.255.255.0ip nat outsideip mroute-cachedescription wan interface to CA and other DSG servers...interface c6/0ip address 10.10.10.11 255.255.255.0ip address 192.168.18.1 255.255.255.0 secondaryip pim sparse-modeip igmp static-group 239.0.0.2ip multicast rate-limit out group-listip mroute-cachecable dsg 1.2.3 239.0.0.2 CCCip nat inside...ip nat inside source static 239.0.0.2 192.168.18.1...
Note
Packet Filtering Access List Configuration Example
The following excerpt from a configuration for a Cisco uBR7246VXR router shows an example of an extended IP access list being used to define the type of traffic that is allowed to be transmitted on a cable interface. Access list 101 permits traffic from two known hosts, denies all other TCP and UDP traffic, and denies IGMP traffic from a particular IP multicast address. All other IP traffic is allowed. The access list is then applied to the cable interface, using the ip access-group command.
interface Cable3/0ip address 10.48.1.1 255.255.255.0ip access-group 101 outip pim sparse-modeip helper-address 1.7.29.1ip igmp static-group 230.6.6.6ip igmp static-group 230.5.5.5ip igmp static-group 230.4.4.4ip igmp static-group 230.1.1.1ip igmp static-group 228.1.1.1ip igmp static-group 229.1.1.1ip igmp static-group 230.7.7.7cable downstream annex Bcable downstream modulation 64qamcable downstream interleave-depth 32cable downstream frequency 459000000cable downstream channel-id 0cable upstream 0 frequency 17808000cable upstream 0 power-level 0cable upstream 0 channel-width 1600000cable upstream 0 minislot-size 4cable upstream 0 modulation-profile 2no cable upstream 0 rate-limitno cable upstream 0 shutdowncable upstream 1 channel-width 1600000cable upstream 1 minislot-size 4cable upstream 1 modulation-profile 1cable upstream 1 shutdowncable upstream 2 channel-width 1600000cable upstream 2 minislot-size 4cable upstream 2 modulation-profile 1cable upstream 2 shutdowncable upstream 3 channel-width 1600000cable upstream 3 minislot-size 4cable upstream 3 modulation-profile 1cable upstream 3 shutdowncable source-verifycable dhcp-giaddr primarycable dsg 000d.000d.000d 230.6.6.6 abccable dsg 000e.000e.000e 230.7.7.7 abccable dsg 000b.000b.000b 230.4.4.4 ciscocable dsg 000c.000c.000c 230.5.5.5 abccable dsg 0009.0009.0009 229.1.1.1 ciscocable dsg 0008.0008.0008 228.1.1.1 ciscocable dsg 000a.000a.000a 230.1.1.1 ciscono keepalive!access-list 101 permit udp host 11.48.1.2 anyaccess-list 101 permit udp host 11.46.1.100 anyaccess-list 101 deny udp any anyaccess-list 101 deny tcp any anyaccess-list 102 deny igmp any host 230.1.1.1access-list 102 permit ip any anyIP Multicast Access List Configuration Example
The following excerpt from a configuration for a Cisco uBR7246VXR router shows a standard IP access list being configured to allow only traffic destined for a range of particular IP multicast addresses. The access list is applied to the cable interface using the ip igmp access-group command.
interface Cable 6/0ip address 10.44.61.1 255.255.255.0 secondaryip address 10.44.51.1 255.255.255.0ip pim sparse-modeip helper-address 10.8.35.200ip igmp static-group 239.0.0.100ip igmp static-group 239.192.16.11ip igmp static-group 239.192.16.12ip igmp static-group 239.192.16.13ip igmp static-group 239.192.16.14ip igmp static-group 239.192.16.17ip igmp static-group 239.192.16.18ip igmp static-group 239.192.16.32ip igmp static-group 239.192.16.16ip igmp query-interval 65535ip igmp access-group 96cable tftp-enforcecable max-hosts 6cable bundle 3 mastercable downstream annex Bcable downstream modulation 64qamcable downstream interleave-depth 32cable downstream channel-id 1cable upstream 0 frequency 25000000cable upstream 0 power-level 0no cable upstream 0 shutdowncable upstream 1 frequency 25000000cable upstream 1 power-level 0no cable upstream 1 shutdowncable upstream 2 frequency 25000000cable upstream 2 power-level 0no cable upstream 2 shutdowncable upstream 3 frequency 25000000cable upstream 3 power-level 0no cable upstream 3 shutdowncable ip-broadcast-echocable source-verify leasetimer 100cable dhcp-giaddr policy. . .access-list 96 permit 224.0.0.0 15.255.255.255access-list 96 deny any. . .IP Multicast Rate-Limiting Access List Configuration Example
The following excerpt from a configuration for a Cisco uBR7246VXR router shows an example of IP multicast access lists being used to limit the maximum possible data rate for a number of different IP multicast addresses. This method ensures that a particular DSG tunnel does not use an excessive amount of bandwidth.
In this basic DSG 1.0 example, a number of standard IP access lists are defined to permit traffic from a particular IP multicast address. These access lists are applied to the cable interface using the ip multicast rate-limit command.
!interface Cable3/0ip address 10.48.1.1 255.255.255.0ip pim sparse-modeip multicast rate-limit out group-list 10 128ip multicast rate-limit out group-list 20 256ip multicast rate-limit out group-list 30 512ip multicast rate-limit out group-list 40 1024ip multicast rate-limit out group-list 50 128ip multicast rate-limit out group-list 60 256ip multicast rate-limit out group-list 70 512ip multicast rate-limit out group-list 80 1024ip helper-address 1.7.29.1ip igmp static-group 230.6.6.6ip igmp static-group 230.5.5.5ip igmp static-group 230.4.4.4ip igmp static-group 230.1.1.1ip igmp static-group 228.1.1.1ip igmp static-group 229.1.1.1ip igmp static-group 230.7.7.7cable downstream annex Bcable downstream modulation 64qamcable downstream interleave-depth 32cable downstream frequency 459000000cable downstream channel-id 0cable upstream 0 frequency 17808000cable upstream 0 power-level 0cable upstream 0 channel-width 1600000cable upstream 0 minislot-size 4cable upstream 0 modulation-profile 2no cable upstream 0 rate-limitno cable upstream 0 shutdowncable upstream 1 channel-width 1600000cable upstream 1 minislot-size 4cable upstream 1 modulation-profile 1cable upstream 1 shutdowncable upstream 2 channel-width 1600000cable upstream 2 minislot-size 4cable upstream 2 modulation-profile 1cable upstream 2 shutdowncable upstream 3 channel-width 1600000cable upstream 3 minislot-size 4cable upstream 3 modulation-profile 1cable upstream 3 shutdowncable source-verifycable dhcp-giaddr primarycable dsg 000d.000d.000d 230.6.6.6 abccable dsg 000e.000e.000e 230.7.7.7 abccable dsg 000b.000b.000b 230.4.4.4 ciscocable dsg 000c.000c.000c 230.5.5.5 abccable dsg 0009.0009.0009 229.1.1.1 ciscocable dsg 0008.0008.0008 228.1.1.1 ciscocable dsg 000a.000a.000a 230.1.1.1 ciscono keepalive!...access-list 10 permit 228.1.1.1access-list 20 permit 229.1.1.1access-list 30 permit 230.1.1.1access-list 40 permit 230.4.4.4access-list 50 permit 230.5.5.5access-list 60 permit 230.6.6.6access-list 70 permit 230.7.7.7access-list 80 permit 230.8.8.8...Additional References
For additional information related to the Advanced-mode DOCSIS Set-Top Gateway feature, refer to the following references.
Related Documents
Broadband Cable Command Reference
Cisco Broadband Cable Command Reference Guide, on Cisco.com:
http://www.cisco.com/en/US/docs/ios/cable/command/reference/cbl_book.htmlCisco IOS Release 12.2 Command Reference
Cisco IOS Release 12.2 configuration guides and command references, on Cisco.com:
http://www.cisco.com/en/US/products/sw/iosswrel/ps1835/products_installation_and_configuration_guides_list.htmlCisco IOS Release 12.3 Command Reference
Cisco IOS Software Release 12.3 Mainline Command References, on Cisco.com:
http://www.cisco.com/en/US/products/sw/iosswrel/ps5187/prod_command_reference_list.html
Cisco DOCSIS Set-top Technology White Paper
Cisco DOCSIS Set-top Gateway White Paper, on Cisco.com:
http://www.cisco.com/en/US/products/hw/cable/ps2217/products_white_paper09186a00801b3f0f.shtml
DOCSIS 1.1 on the Cisco CMTS
Configuring DOCSIS 1.1 on the Cisco CMTS, in the CMTS Feature Guide, on Cisco.com:
http://www.cisco.com/en/US/docs/cable/cmts/feature/guide/ufg_docs.htmlIP Access Lists Configuration Guide
Configuring IP Services, IP Addressing and Services, Cisco IOS IP Configuration Guide, Release 12.2, on Cisco.com:
http://www.cisco.com/en/US/docs/ios/12_2/ip/configuration/guide/1cfip.htmlIP Access Lists Command Reference Guide
IP Services Commands, Cisco IOS IP Command Reference, Volume 1, Addressing and Services, Release 12.2, on Cisco.com:
http://www.cisco.com/en/US/docs/ios/12_2/ipaddr/command/reference/fipras_r.htmlIP Multicast Configuration Guide
Cisco IOS IP Configuration Guide, Release 12.3 on Cisco.com:
http://www.cisco.com/en/US/docs/ios/12_3/featlist/ip_vcg.htmlIP Multicast Command Reference
Cisco IOS IP Command Reference, Volume 3 of 3: Multicast, Release 12.2 on Cisco.com:
http://www.cisco.com/en/US/docs/ios/12_2/ipmulti/command/reference/fiprmc_r.html
Standards
CableLabs DOCSIS Set-top Gateway (DSG) Interface Specification SP-DSG-I03-041124
CableLabs Data-over-Cable Service Interface Specifications Radio Frequency Interface Specification, version 1.1
CableLabs DOCSIS Set-top Gateway (DSG) Interface Specification
1 Not all supported standards are listed.
MIBs
Cisco IOS Release 12.3(9a)BC introduces SNMP support for the CISCO-CABLE-DSG-IF-MIB.
To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL:
1 Not all supported MIBs are listed.
RFCs
Technical Assistance
System Messages
Cisco IOS Release 12.3(13a)BC System Messages
This section describes system messages that support the Advanced-mode DSG 1.1 feature. These include debugging, DCD messages, DSG tunnels, IP Multicast messages, and several additional functions of A-DSG 1.1.
Debug System Messages
%DSG: a mapping entry created for 0001.0002.0003 235.5.5.5 on Cable5/1
%DSG: a mapping entry has been added on the interface Cable5/1
Explanation A DSG mapping entry is created for the interface and MAC address indicated.
Recommended Action No action is required.
%DSG: remove and free tunnel 0001.0002.0003
Explanation A DSG tunnel entry has been removed for the interface indicated.
Recommended Action No action is required.
%DSG: vendor entry BBB is freed
Explanation Vendor entry is removed
Recommended Action No action is required.
%DSG: a mapping entry freed for 235.5.5.5 0001.0002.0003 Cable5/1
%DSG: the specified DSG entry has been removed
Explanation DSG mapping is removed.
Recommended Action No action is required.
%DSG: cmts_dsg_resolve_mac 225.2.2.2 on Cable5/0
%DSG: cmts_dsg_resolve_mac is successful
Explanation CMTS is resolving a MAC address from DSG table.
Recommended Action No action is required.
%DSG: cmts_dsg_group2mac on Cable5/1
%DSG: cmts_dsg_group2mac 0001.0002.0003 is successful
Explanation CMTS is finding mac address for a group from DSG table.
Recommended Action No action is required.
%DSG: cmts_dsg_mac2group
%DSG: cmts_dsg_mac2group is successful
Explanation CMTS is finding group address for a mac address from DSG table.
Recommended Action No action is required.
%DSG: unexpected event for CMTS DSG process
Explanation When an unexpected event is sent to DSG keepalive process
Recommended Action No action is required.
%DSG: interface Cable5/0 joined the igmp static group 229.2.2.2.
Explanation If DSG entry is added
Recommended Action No action is required.
%DSG: interface Cable5/1 left the igmp static group 225.2.2.2.
Explanation Removed the entry successfully
Recommended Action No action is required.
%DSG: all tunnels have been removed on interface Cable5/1 and its subinterfaces.
Explanation If no more dsg entry on a hardware interface
Explanation No action is required.
%DSG: All DSG tunnels are removed on interface cable 5/1 and its subinterfaces.
Explanation An operator has removed a subinterface and all mapping entries on a physical interface.
Recommended Action No action is required.
Command Reference for Advanced-mode DSG Issue 1.1
This section describes the following new Cisco IOS commands that configure, monitor and troubleshoot the Advanced-mode Advanced-mode DOCSIS Set-Top Gateway (A-DSG) feature through Issue 1.1. These commands are supported in Cisco IOS Release 12.3(13a)BC and later releases in the 12.3BC release train.
Global Configuration Commands for A-DSG 1.1
Global configuration commands configure the following A-DSG 1.1 settings on the Cisco CMTS:
•
•
•
These global A-DSG parameters are uniquely identified by A-DSG indexes. The indexes are then used with interface commands to define DCD messages. The following global configuration commands are used with A-DSG 1.1 on the Cisco CMTS:
Interface Configuration Commands for A-DSG 1.1
A-DSG 1.1 indexes that are defined in global configuration mode are subsequently used in the following interface configurations and commands. These interface commands define the DSG rules, tunnel traffic, and parameters to include in the DCD message.
•
•
•
Debug Commands for A-DSG 1.1
Show Commands for A-DSG 1.1
•
Tip
http://www.cisco.com/en/US/docs/ios/cable/command/reference/cbl_book.html
All other commands used with this feature are documented in the Cisco IOS Release 12.2 and 12.3 Mainline command reference publications.
cable dsg cfr
To define and enable A-DSG 1.1 classifiers on the Cisco CMTS, use the cable dsg cfr command in global configuration mode. This command creates an index to which one or several A-DSG 1.1 classifiers apply. To remove one or more specified A-DSG 1.1 classifiers from the Cisco CMTS, use the no form of this command. To disable one or more specified A-DSG 1.1 classifiers, but retain their configuration, use the disable form of this command.
cable dsg <cfr index> dest-ip <ipaddr>
[tunnel <tunnel index>] |
[dest-ports <start> <end>] |
[priority <priority>] |
[src-ip <ipaddr>] | src-prefix-len
[enable | disable]
no cable dsg cfr <cfr index>
Syntax Description
Defaults
A-DSG 1.1 classifiers are undefined by default on the Cisco CMTS, and remain disabled by default once configured until they are enabled with the enable keyword.
Command Modes
Global configuration mode
Command History
12.3(13a)BC
This command was introduced to support A-DSG 1.1 on the Cisco uBR10012 and Cisco uBR7200 Series routers.
Usage Guidelines
A-DSG 1.1 classifiers can only be mapped to one DSG tunnel, but multiple classifiers can be mapped to one tunnel. The Cisco CMTS router applies the classifier parameters to the packets received from the DSG server in order to assign the packet to the appropriate DSG tunnel. The classifiers are also associated to the DSG rule to encode in the DCD message.
Examples
The following example illustrates A-DSG 1.1 CFR global configurations on the Cisco CMTS:
cable dsg cfr 1 dest-ip 224.10.10.101 tunnel 1 dest-port 0 65535 priority 1cable dsg cfr 2 dest-ip 224.10.10.102 tunnel 2 dest-port 0 65535 priority 1cable dsg cfr 3 dest-ip 224.10.10.103 tunnel 3 dest-port 0 65535 priority 1cable dsg cfr 4 dest-ip 224.10.10.104 tunnel 4 dest-port 0 65535 priority 1cable dsg cfr 5 dest-ip 224.10.10.105 tunnel 1 dest-port 0 65535 priority 1cable dsg cfr 6 dest-ip 224.10.10.106 tunnel 2 dest-port 0 65535 priority 1Related Commands
cable dsg chan-list
To configure the A-DSG 1.1 downstream channel list, use the cable dsg chan-list command in global configuration mode. To remove the A-DSG 1.1 channel list from the Cisco CMTS, us the no form of this command.
cable dsg chan-list <list-index> index <entry-index> freq <freq>
no cable dsg chan-list <list-index> index <entry-index> freq <freq>
Syntax Description
Defaults
A-DSG 12.1 channel lists are disabled and undefined by default.
Command Modes
Global configuration mode
Command History
12.3(13a)BC
This command was introduced to support A-DSG 1.1 on the Cisco uBR10012 and Cisco uBR7200 Series routers.
Usage Guidelines
The channel list entry created with this command can be associated to the downstream to be included in the DSG message.
Examples
The following example illustrates A-DSG 1.1 channel list global configurations on the Cisco CMTS:
cable dsg chan-list 1 index 1 freq 47000000cable dsg chan-list 1 index 2 freq 125000000cable dsg chan-list 1 index 3 freq 55500000cable dsg chan-list 2 index 1 freq 47000000cable dsg chan-list 2 index 2 freq 125000000cable dsg chan-list 2 index 3 freq 55500000Related Commands
cable dsg client-list
To configure client parameters for Advanced-mode DSG (A-DSG 1.1), use the cable dsg client-list command in global configuration mode. This command configures the client parameters and the associated DSG rule. To remove this configuration, use the no form of the command.
cable dsg client-list <client-list-id> id-index <id> {application-id | ca-system-id | mac-addr | broadcast} <value>
no cable dsg client-list <client-list-id> id-index <id> {application-id | ca-system-id | mac-addr | broadcast} <value>
Syntax Description
Defaults
Client lists for A-DSG are not configured by default.
Command Modes
Global configuration mode
Command History
12.3(13a)BC
This command was introduced to support A-DSG 1.1 on the Cisco uBR10012 and Cisco uBR7200 Series routers.
Usage Guidelines
The same DSG client identifier may be used by multiple DSG rules.
Examples
The following sample configuration illustrates global parameters for four A-DSG 1.1 client lists:
cable dsg client-list 1 id-index 1 broadcastcable dsg client-list 2 id-index 2 application-id FFFFcable dsg client-list 3 id-index 3 ca-system-id EEEEcable dsg client-list 4 id-index 4 mac-addr 0100.5e0a.0a04Related Commands
cable dsg timer
To configure the A-DSG 1.1 timer entry to be associated to the downstream channel, and encoded into the DCD message, use the cable dsg timer command in global configuration mode. To remove the cable dsg timer from the Cisco CMTS, use the no form of this command.
cable dsg timer <index> [Tdsg1 <Tdsg1>] | [Tdsg2 <Tdsg2>] | [Tdsg3 <Tdsg3>] | [Tdsg4 <Tdsg4>]
no cable dsg timer <index> [Tdsg1 <Tdsg1>] | [Tdsg2 <Tdsg2>] | [Tdsg3 <Tdsg3>] | [Tdsg4 <Tdsg4>]
Syntax Description
Defaults
The A-DSG 1.1 timer is not defined by default.
Command Modes
Global configuration mode
Command History
12.3(13a)BC
This command was introduced to support A-DSG 1.1 on the Cisco uBR10012 and Cisco uBR7200 Series routers.
Usage Guidelines
The A-DSG 1.1 timer entry can associated to the downstream to encode into the DCD message.
Examples
The following sample configuration illustrates global parameters for three A-DSG 1.1 timers:
cable dsg timer 1 Tdsg1 1 Tdsg2 2 Tdsg3 3 Tdsg4 4cable dsg timer 2 Tdsg1 2 Tdsg2 22 Tdsg3 33 Tdsg4 44cable dsg timer 3 Tdsg1 2 Tdsg2 600 Tdsg3 300 Tdsg4 1800Related Commands
cable dsg vendor param
To configure vendor-specific parameters for A-DSG 1.1, use the cable dsg vendor-param command in global configuration mode. To remove this configuration from the Cisco CMTS, use the no form of this command.
cable dsg vendor-param <group-id> vendor <vendor-index> oui <oui> value <value-in-TLV>
no cable dsg vendor-param <group-id> vendor <vendor-index> oui <oui> value <value-in-TLV>
Syntax Description
Defaults
The A-DSG 1.1 vendor is not defined by default.
Command Modes
Global configuration mode
Command History
12.3(13a)BC
This command was introduced to support A-DSG 1.1 on the Cisco uBR10012 and Cisco uBR7200 Series routers.
Usage Guidelines
The vendor-specific parameters can be associated to the downstream to encode into the DCD message.
Examples
The following sample configuration illustrates global vendor parameters for A-DSG 1.1:
cable dsg vendor-param 1 vendor 1 oui ABCDEA value 0101ABcable dsg vendor-param 2 vendor 1 oui ABCDEB value 0101ABcable dsg vendor-param 3 vendor 1 oui ABCDEC value 0101ABRelated Commands
cable dsg tunnel
To create A-DSG 1.1 tunnels, use the cable dg tunnel command in global configuration mode. The destination MAC address and Quality of Service (QoS) class must be set when using this command. To remove this configuration from the Cisco CMTS, use the no form of this command. To disable A-DSG 1.1 tunnels on the Cisco CMTS, use the disable form of this command.
cable dsg tunnel <tunnel-id> mac_addr <mac addr> | [enable | disable]
no cable dsg tunnel <tunnel-id> mac_addr <mac addr> [srv-class <service-class-name>] |
Syntax Description
Defaults
A-DSG 1.1 tunnels are not configured by default, and are disabled by default when configured.
Command Modes
Global configuration mode
Command History
12.3(13a)BC
This command was introduced to support A-DSG 1.1 on the Cisco uBR10012 and Cisco uBR7200 Series routers.
Usage Guidelines
Each tunnel is mapped to the destination MAC address and is associated with the QoS service class name.
Examples
The following sample configuration illustrates A-DSG 1.1 tunnels on the Cisco CMTS:
cable dsg tunnel 1 mac-addr 0100.5e0a.0a01cable dsg tunnel 2 mac-addr 0100.5e0a.0a02cable dsg tunnel 3 mac-addr 0100.5e0a.0a03cable dsg tunnel 4 mac-addr 0100.5e0a.0a04Related Commands
cable igmp static-group
To configure Cable per physical downstream Static Multicast support on the Cisco CMTS, use the cable igmp static-group command in global configuration mode.
cable igmp static-group [multicast group] source [source IP] [subinterface number]
Syntax Description
Command Default
Cable per physical downstream Static Multicast support is not defined by default.
Command Modes
Global configuration mode
Command History
Usage Guidelines
The Cable per physical downstream Static Multicast Support feature introduces the concept of a physical IGMP Static-Group, which is an extension of the existing logical IGMP Static-Group. The differences between the two IGMP Static-Group are as follows:
•
•
When an IGMP Static-Group is configured on a Master interface, the IGMP Static-Group will perform a check for each Slave interface in the multicast group. If the multicast group is configured as a Physical Static-Group, then only the corresponding Slave interfaces will be added to the Cable Bundle Forwarding Table. If the multicast group is configured as a Logical Static-Group, then all Slave interfaces will be added to the Cable Bundle Forwarding Table.
Note
DSG Usage
The cable igmp static-group command CLI will only be display at "show run" if it is configured via the CLI. If it is configured by DSG, the cable igmp static-group command CLI will remain hidden for a particular multicast group. This is done in order to eliminate any confusion with the current DSG configurations.
Note
Examples
The following sample configuration illustrates the cable igmp static-group command on the Cisco CMTS:
Router(config-if)# cable igmp static-group 230.1.1.1The following sample configuration illustrates the cable igmp static-group command with the source option Cisco CMTS:
Router(config-if)# cable igmp static-group 232.1.1.1 source 10.1.1.1Related Commands
cable downstream dsg chan-list
To associate the DSG channel list entry to a downstream channel, to be included in the DCD message, use the cable downstream dsg chan-list command in interface configuration mode. To remove this setting from the Cisco CMTS, us the no form of this command.
cable downstream dsg chan-list <list-index>
no cable downstream dsg chan-list <list-index>
Syntax Description
chan-list
Sets the downstream A-DSG 1.1 channel list.
list-index
Alphanumeric list index identifier.
Defaults
Channel lists are not defined by default.
Command Modes
Interface configuration mode
Command History
12.3(13a)BC
This command was introduced to support A-DSG 1.1 on the Cisco uBR10012 and Cisco uBR7200 Series routers.
Usage Guidelines
Global configurations for A-DSG 1.1 must be complete before configuring interface definitions.
Examples
The following downstream interface settings illustrate A-DSG 1.1 configurations on the Cisco CMTS:
interface Cable6/0cable downstream dsg dcd-enablecable downstream dsg chan-list 2cable downstream dsg timer 3cable downstream dsg vendor-param 2cable downstream dsg rule 1 clients 1 tunnel 1cable downstream dsg rule 1 priority 1cable downstream dsg rule 1 vendor-param 1cable downstream dsg rule 1 classifiers 1 5cable downstream dsg rule 2 clients 2 tunnel 2cable downstream dsg rule 2 priority 1Related Commands
cable downstream dsg dcd-enable
To enable DCD messages to be sent on a downstream channel, use the downstream dsg dcd-enable command in interface configuration mode. This command is used when there are no enabled rules or tunnels for A-DSG on the Cisco CMTS. To disable DCD messages, use the disable form of this command.
cable downstream dsg [ dcd-enable | dcd-disable ]
Defaults
This setting (DCD messages) is not configured by default. Once the dcd-disable keyword is configured this command remains disabled even if a rule is configured.
Command Modes
Interface configuration
Command History
12.3(13a)BC
This command was introduced to support A-DSG 1.1 on the Cisco uBR10012 and Cisco uBR7200 Series routers.
Usage Guidelines
Global configurations for A-DSG 1.1 must be complete before configuring interface definitions.
Examples
The following downstream interface settings illustrate A-DSG 1.1 configurations on the Cisco CMTS:
interface Cable6/0cable downstream dsg dcd-enablecable downstream dsg chan-list 2cable downstream dsg timer 3cable downstream dsg vendor-param 2cable downstream dsg rule 1 priority 1 clients 1 tunnel 1cable downstream dsg rule 1 vendor-param 1cable downstream dsg rule 1 classifiers 1 5cable downstream dsg rule 2 priority 1 clients 2 tunnel 2Related Commands
cable downstream dsg rule
To define and associate an A-DSG rule to the downstream channel, use the downstream dsg rule command in interface configuration mode. To disable a current configuration, use the disable form of this command. This command has the following forms:
cable downstream dsg rule <rule-id> clients <clnt-list-id> tunnel <tun-id>
cable downstream dsg rule <rule-id> priority <priority>
cable downstream dsg rule <rule-id> vendor-param <vsif-grp-id>
cable downstream dsg rule <rule-id> ucid <ucid1> | [<ucid1> <ucid2>...<ucidn>]
cable downstream dsg rule <rule-id> cfr <cfr-index> [ <cfr-index>...]
cable downstream dsg rule <rule-id> disable
Rules are disabled by default when they are created, and rules must be enabled using the following command:
no cable downstream dsg rule <rule-id> disable
Syntax Description
Defaults
This command is not configured by default.
Command Modes
Interface configuration mode
Command History
12.3(13a)BC
This command was introduced to support A-DSG 1.1 on the Cisco uBR10012 and Cisco uBR7200 Series routers.
Usage Guidelines
Global configurations for A-DSG 1.1 must be complete before configuring interface definitions.
This configuration allows association of DSG clients, vendor specific parameters, classifiers, DSG tunnel address, upstream channel identifider range, and rule priority. The downstream can be associated with more than one rule. All configured rules are included in the DCD message.
Examples
The following downstream interface settings illustrate A-DSG 1.1 configurations on the Cisco CMTS:
interface Cable6/0cable downstream dsg dcd-enablecable downstream dsg chan-list 2cable downstream dsg timer 3cable downstream dsg vendor-param 2cable downstream dsg rule 1 clients 1 tunnel 1cable downstream dsg rule 1 priority 1cable downstream dsg rule 1 vendor-param 1cable downstream dsg rule 1 classifiers 1 5cable downstream dsg rule 2 clients 2 tunnel 2cable downstream dsg rule 2 priority 1Related Commands
cable downstream dsg timer
To associate the DSG timers entry to a downstream channel, and to be included in the DCD message, use the downstream dsg timer command in interface configuration mode. To remove this setting, use the no form of this command.
cable downstream dsg timer <timer-index>
Syntax Description
Defaults
The downstream DSG timer is not configured or enabled by default.
Command Modes
Interface configuration mode
Command History
12.3(13a)BC
This command was introduced to support A-DSG 1.1 on the Cisco uBR10012 and Cisco uBR7200 Series routers.
Usage Guidelines
Global configurations for A-DSG 1.1 must be complete before configuring interface definitions.
Examples
The following downstream interface settings illustrate A-DSG 1.1 configurations on the Cisco CMTS:
interface Cable6/0cable downstream dsg dcd-enablecable downstream dsg chan-list 2cable downstream dsg timer 3cable downstream dsg vendor-param 2cable downstream dsg rule 1 priority 1 clients 1 tunnel 1cable downstream dsg rule 1 vendor-param 1cable downstream dsg rule 1 classifiers 1 5cable downstream dsg rule 2 priority 1 clients 2 tunnel 2Related Commands
cable downstream dsg vendor-param
To associate A-DSG vendor parameters to a downstream, to be included in the DCD message, use the downstream dsg vendor-param command in interface configuration mode. To remove this configuration from the Cisco CMTS, use the no form of this command.
cable downstream dsg vendor-param <vsif-grp-id>
Syntax Description
Defaults
This command is not configured by default.
Command Modes
Interface configuration mode
Command History
12.3(13a)BC
This command was introduced to support A-DSG 1.1 on the Cisco uBR10012 and Cisco uBR7200 Series routers.
Usage Guidelines
Global configurations for A-DSG 1.1 must be complete before configuring interface definitions.
Examples
The following downstream interface settings illustrate A-DSG 1.1 configurations on the Cisco CMTS:
interface Cable6/0cable downstream dsg dcd-enablecable downstream dsg chan-list 2cable downstream dsg timer 3cable downstream dsg vendor-param 2cable downstream dsg rule 1 priority 1 clients 1 tunnel 1cable downstream dsg rule 1 vendor-param 1cable downstream dsg rule 1 classifiers 1 5cable downstream dsg rule 2 priority 1 clients 2 tunnel 2Related Commands
ip igmp static-group
To configure static group membership entries on an interface, use the ip igmp static-group command in interface configuration mode. To delete static group membership entries, use the no form of this command.
ip igmp static-group {* | group-address [source {source-address | ssm-map}] | class-map class-map-name}
no ip igmp static-group {* | group-address [source {source-address | ssm-map}] | class-map class-map-name}
Syntax Description
Command Default
No static group membership entries are configured on interfaces.
Command Modes
Interface configuration.
Command History
Usage Guidelines
Use the ip igmp static-group command to configure static group membership entries on an interface. When you configure the ip igmp static-group command, packets to the group are fast-switched out the interface, provided that packets were received on the correct reverse path forwarding (RPF) interface. Once configured, static group membership entries are added to the IGMP cache and mroute table.
Configuring the ip igmp static-group command is unlike configuring the ip igmp join-group command, which allows the router to join the multicast group. This configuration of the ip igmp static-group command would cause the upstream routers to maintain the multicast routing table information for that group, which would ensure that all the paths to that multicast group are active.
If you configure the ip igmp join-group command for the same group address as the ip igmp static-group command, the ip igmp join-group command takes precedence, and the group behaves like a locally joined group.
Use the ip igmp static-group command with the ssm-map keyword to configure static traffic forwarding with SSM mapping on the last hop router. Static traffic forwarding can be used in conjunction with SSM mapping to statically forward SSM traffic for certain groups. When static traffic forwarding with SSM mapping is configured, the last hop router uses Domain Name System (DNS)-based SSM mapping to determine the sources associated with a group. The resulting (S, G) channels are then statically forwarded.
Use the ip igmp static-group class-map command with the class-map keyword and class-map-name argument to attach an IGMP static group class map to an interface. Once attached, all groups entries that are defined in the class map become static members on the interface and are added to the IGMP cache and to the mroute table.
Examples
The following example shows how to configure group address 239.100.100.101 on Ethernet interface 0:
interface ethernet 0ip igmp static-group 239.100.100.101The following example shows how to configure group address 239.1.2.1 to use SSM mapping for statically forwarded groups on Ethernet interface 0:
interface ethernet 0ip igmp static-group 239.1.2.1 source ssm-mapThe following example shows how to attach an IGMP static group range class map named static1 to GigabitEthernet interface 1/1:
interface GigabitEthernet1/1ip igmp static-group class-map static1Related Commands
debug cable dsg
To enable general, DCD or packet-related debugging for A-DSG 1.1 on the Cisco CMTS, use the debug cable dsg command in privileged EXEC mode. To disable A-DSG 1.1 debugging, us the no form of this command.
debug cable dsg [ dcd | pkt ]
no debug cable dsg
Syntax Description
dcd
(Optional) Enables DCD related debugging. Can be combined with pkt.
pkt
(Optional) Enables packet related debugging. Can be combined with dcd.
Defaults
A-DSG 1.1 debugging is disabled by default.
Command Modes
Privileged EXEC mode
Command History
12.3(13a)BC
This command was introduced to support A-DSG 1.1 on the Cisco uBR10012 and Cisco uBR7200 Series routers.
Usage Guidelines
Global configurations for A-DSG 1.1 must be complete before configuring interface definitions.
Refer to examples for illustrative variations in using this command.
Examples
If using the debug cable dsg dcd command, it shows DCD counters. If the configuration is changed, the whole DCD message content is displayed, including the MAC header. This display is derived from running information. The following sample illustrates one example:
Router# debug cable dsg dcd23:30:45: Constructing DCD for Cable4/123:30:45: Cable4/1 DCD change_count 923:30:45: Cable4/1 DCD datagram size 626, msg len 624, ehdr type_or_len 606,tlv size 59723:30:45: Cable4/1 84485 DCD msg sent, 9 change count increased, 0 fails23:30:46: Constructing DCD for Cable4/123:30:46: Cable4/1 DCD change_count 923:30:46: Cable4/1 DCD datagramsize 626, msg len 624, ehdr type_or_len 606,tlv size 59723:30:46: Cable4/1 84486 DCD msg sent, 9 change count increased, 0 fails23:31:27: DSG VSIF group id 1, vendor index 1, sense 123:31:27: vendor 1 value len 123:31:27: Cable4/1 DCD is config dirty.23:30:47: DSG VSIF group id 1, vendor index 1, sense 123:30:47: vendor 1 value len 123:30:47: Cable4/1 DCD is config dirty.23:30:47: Constructing DCD for Cable4/123:30:47: client list 1 tlv length 2, clnts_tlv_size 423:30:47: Rule 1 all cfr IDs tlv size 423:30:47: Rule 1 VSIF tlv size = 3623:30:47: Encode Cable4/1 rule 1 with tunnel 1,tlv size 6023:30:47: client list 2 tlv length 4, clnts_tlv_size 623:30:47: Rule 2 all cfr IDs tlv size 423:30:47: Encode Cable4/1 rule 2 with tunnel 2,tlv size 2623:30:47: client list 3 tlv length 4, clnts_tlv_size 623:30:47: Rule 3 all cfr IDs tlv size 423:30:47: Encode Cable4/1 rule 3 with tunnel 3,tlv size 2623:30:47: client list 4 tlv length 4, clnts_tlv_size 623:30:47: Rule 4 all cfr IDs tlv size 423:30:47: Encode Cable4/1 rule 4 with tunnel 4,tlv size 2623:30:47: client list 5 tlv length 4, clnts_tlv_size 623:30:47: Rule 5 all cfr IDs tlv size 423:30:47: Encode Cable4/1 rule 5 with tunnel 5,tlv size 2623:30:47: client list 6 tlv length 4, clnts_tlv_size 623:30:47: Rule 6 all cfr IDs tlv size 423:30:47: Encode Cable4/1 rule 6 with tunnel 6,tlv size 2623:30:47: client list 7 tlv length 4, clnts_tlv_size 623:30:47: Rule 7 all cfr IDs tlv size 423:30:47: Encode Cable4/1 rule 7 with tunnel 7,tlv size 2623:30:47: client list 8 tlv length 4, clnts_tlv_size 623:30:47: Rule 8 all cfr IDs tlv size 423:30:47: Encode Cable4/1 rule 8 with tunnel 8,tlv size 2623:30:47: client list 9 tlv length 4, clnts_tlv_size 623:30:47: Rule 9 all cfr IDs tlv size 423:30:47: Encode Cable4/1 rule 9 with tunnel 9,tlv size 2623:30:47: client list 10 tlv length 4, clnts_tlv_size 623:30:47: Rule 10 all cfr IDs tlv size 423:30:47: Encode Cable4/1 rule 10 with tunnel 10,tlv size 2623:30:47: client list 11 tlv length 8, clnts_tlv_size 1023:30:47: Rule 11 all cfr IDs tlv size 423:30:47: Encode Cable4/1 rule 11 with tunnel 11,tlv size 3023:30:47: Cable4/1 TLV size for all rules 32423:30:47: Encode Cable4/1 cfr 1, tlv size 1723:30:47: Encode Cable4/1 cfr 2, tlv size 1723:30:47: Encode Cable4/1 cfr 3, tlv size 1723:30:47: Encode Cable4/1 cfr 4, tlv size 1723:30:47: Encode Cable4/1 cfr 5, tlv size 1723:30:47: Encode Cable4/1 cfr 6, tlv size 1723:30:47: Encode Cable4/1 cfr 7, tlv size 2523:30:47: Encode Cable4/1 cfr 8, tlv size 1723:30:47: Encode Cable4/1 cfr 9, tlv size 1723:30:47: Encode Cable4/1 cfr 10, tlv size 1723:30:47: Encode Cable4/1 cfr 11, tlv size 1723:30:47: Cable4/1 DSG Addr Table tlv size = 51923:30:47: Cable4/1 downstream VSIF tlv size = 3623:30:47: Cable4/1 clnt cfg tlv size = 3823:30:47: Cable4/1 DCD change_count 1023:30:47: Cable4/1 DCD datagramsize 586, msg len 584, ehdr type_or_len 566,tlv size 55723:30:47: Cable4/1 DCD msg 0x62463F8C, size=586C2000248 000001E0 2F000001 000C31F6 F4710236 00000303 20000A01 01323A0101010201 01040201 00050601 005E0101 14060200 012B0608 03ABCABC AB2B1A0803000DF9 0A043030 30310B0D 45363031 30313238 3A303532 32321801 0102020101040403 02095105 0601005E 01011E06 02000232 18010103 02010104 0404020001050601 005E0101 28060200 03321801 01040201 01040403 02070105 0601005E01013206 02000432 18010105 02010104 04040200 02050601 005E0101 3C06020005321801 01060201 01040403 02000605 0601005E 01014606 02000632 1801010702010104 04040200 03050601 005E0101 50060200 07321801 01080201 0104040402000405 0601005E 01011906 02000832 18010109 02010104 04040200 05050601005E0101 33060200 09321801 010A0201 01040404 02000605 0601005E 0101470602000A32 1C01010B 02010104 08020600 504D0000 01050600 504D0000 010602000B170F02 02000105 01010906 0504E601 0114170F 02020002 05010109 060504E601011E17 0F020200 03050101 09060504 E6010128 170F0202 00040501 0109060504E60101 32170F02 02000505 01010906 0504E601 013C170F 02020006 05010109060504E6 01014617 17020200 07050101 090E0504 E6010150 090203E8 0A021388170F0202 00080501 01090605 04E60101 19170F02 02000905 01010906 0504E60123:30:45: DSG VSIF group id 1, vendor index 1, sense 123:30:45: vendor 1 value len 10133170F 0202000A 05010109 060504E6 01014717 0F020200 0B050101 09060504E0191986 33242B06 0803ABCA BCAB2B1A 0803000D F90A0430 3030310B 0D45363031303132 383A3035 323223:30:47: Cable4/1 84487 DCD msg sent, 10 change count increased, 0 fails23:30:48: Constructing DCD for Cable4/123:30:48: Cable4/1 DCD change_count 1023:30:48: Cable4/1 DCD datagramsize 586, msg len 584, ehdr type_or_len 566,tlv size 55723:30:48: Cable4/1 84488 DCD msg sent, 10Related Commands
Displays information about Advanced-mode DSG 1.1 on the Cisco CMTS, to include tunnel MAC address, state, number of classifiers associated, and additional information.
show interface
Displays general interface information for the specified or all interfaces. Use also the show interface cable dsg downstream command.
show cable dsg tunnel
To display information about Advanced-mode DSG 1.1 on the Cisco CMTS, to include tunnel MAC address, state, number of classifiers associated, number of interfaces to which tunnel is associated, number clients associated, and the Qos service class name for all the configured tunnels, use the show cable dsg tunnel command in privileged EXEC mode.
show cable dsg tunnel <tunnel-id> [ cfr | clients | interfaces | statistics | verbose ]
Syntax Description
Defaults
No default behaviors or values
Command Modes
Privileged EXEC mode
Command History
12.3(13a)BC
This command was introduced to support A-DSG 1.1 on the Cisco uBR10012 and Cisco uBR7200 Series routers.
Usage Guidelines
Global configurations for A-DSG 1.1 must be complete before configuring interface definitions.
Refer to the following examples for illustrative usage guidelines.
Examples
The following example displays CLI help for show cable dsg tunnel command syntax.
Router# show cable dsg tunnel 1 ?cfr Show DSG tunnel classifiersclients Show DSG tunnel clientsinterfaces Show DSG tunnel interfacesstatistics Show DSG tunnel statisticsverbose Show DSG tunnel detail information| Output modifiers<cr>The following command displays all configured tunnels for Advanced-mode DSG 1.1 on the Cisco CMTS:
Router# show cable dsg tunneltunnel tunnel tunnel cfr cfr tunnel in rule rule client serviceid state mac-addr id state interface id state listId class1 en 0100.5e01.0114 1 en Cable6/0 1 en 2 SI5 en 7 en 1011 en 8 en 214 en 20 en 2Cable6/1 1 en 43 en 34 en 411 en 22 en 0100.5e01.011e 2 en Cable6/0 2 en 2 NDS-CA10 en3 en 0100.5e01.0128 3 en Cable6/0 3 en 3 NDS-APP4 en 0100.5e01.0132 4 en Cable6/0 4 en 4 MOTO-CA5 en 0100.5e01.013c 9 en Cable6/0 5 en 5 MOTO-APPCable6/1 5 en 56 dis 0100.5e01.0146 Cable6/0 6 en 6 SA-CACable6/1 6 en 67 dis 0100.5e01.0150 7 en Cable6/1 8 en 7 SA-APP13 dis8 en 0100.5e01.0119 8 en NDS-DNLD9 en 0100.5e01.0133 MOTO-DNLD10 en 0100.5e01.0147 SA-DNLD11 en 2222.2222.222212 en 3333.3333.3333 12 enThe following example displays the same information as above but for the specified tunnel.
Router# show cable dsg tunnel 1tunnel tunnel tunnel cfr cfr tunnel in rule rule client serviceid state mac-addr id state interface id state listId class1 en 0100.5e01.0114 1 en Cable6/0 1 en 2 SI5 en 7 en 1011 en 8 en 214 en 20 en 2Cable6/1 1 en 43 en 34 en 411 en 2The following example displays detailed information about all the classifiers associated with 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 1 230.1.1.20 0.0.0.0 32 0 655355 en 1 230.1.1.60 0.0.0.0 32 0 6553511 en 1 224.25.25.134 0.0.0.0 32 0 6553514 en 0 230.1.1.20 0.0.0.0 32 1000 2000The following example displays detailed information about all the clients associated with the specified tunnels.
Router# show cable dsg tunnel 1 clientstunnel client client client clientid listId id id type address1 2 1 CA System ID 0X9513 Broadcast8 MAC Addr 1111.1111.11113 1 Application ID 0X14 1 CA System ID 0X70110 1 Application ID 0X6The following example displays all the interfaces and rules associated with the specified tunnel.
Router# sh cab dsg tunnel 1 interfacestunnel downstream ruleid interface id1 Cable6/0 1 7 8 20Cable6/1 1 3 4 11The following example displays the packets statistics information about the specified tunnel.
Router# sh cab dsg tunnel 1 statisticstunnel cfr cfr destination ip source ip total totalid id state address address forwarded received1 1 en 230.1.1.20 0.0.0.0 0 05 en 230.1.1.60 0.0.0.0 0 011 en 224.25.25.134 0.0.0.0 0 014 en 230.1.1.20 0.0.0.0 0 0The following example shows all the detailed information about the specified tunnel.
Router# sh cab dsg tunnel 1 verboseTunnel ID : 1MAC Addr : 0100.5e01.0114State : enableCfr Id : 1State : enablePriority : 1Dest IP : 230.1.1.20Src IP : 0.0.0.0Src Prefix Length : 32Dest Port Start : 0Dest Port End : 65535Forwarded : 0Received : 0Cfr Id : 5State : enablePriority : 1Dest IP : 230.1.1.60Src IP : 0.0.0.0Src Prefix Length : 32Dest Port Start : 0Dest Port End : 65535Forwarded : 0Received : 0Cfr Id : 11State : enablePriority : 1Dest IP : 224.25.25.134Src IP : 0.0.0.0Src Prefix Length : 32Dest Port Start : 0Dest Port End : 65535Forwarded : 0Received : 0Cfr Id : 14State : enablePriority : 0Dest IP : 230.1.1.20Src IP : 0.0.0.0Src Prefix Length : 32Dest Port Start : 1000Dest Port End : 2000Forwarded : 0Received : 0Client List Id : 2Client Id : 1Client Id Type : CA System ID: 0951Client Id : 3Client Id Type : BroadcastClient Id : 8Client Id Type : MAC Addr: 1111.1111.1111Client List Id : 3Client Id : 1Client Id Type : Application ID: 0001Client List Id : 4Client Id : 1Client Id Type : CA System ID: 0701Client List Id : 10Client Id : 1Client Id Type : Application ID: 0006Interface : Cable6/0Rule Id : 1Rule Id : 7Rule Id : 8Rule Id : 20Interface : Cable6/1Rule Id : 1Rule Id : 3Rule Id : 4Rule Id : 11Related Commands
Enables general, DCD or packet-related debugging.
show interface
Displays general interface information for the specified or all interfaces. Use also the show interface cable dsg downstream command.
show interface cable dsg downstream
To display interface configuration and status information for Advanced-mode DSG 1.1, use the show interface cable dsg downstream command in privileged EXEC mode.
show interface cable {slot/port | slot/subslot/port} dsg downstream
show interface cable {slot/port | slot/subslot/port} dsg downstream dcd
show interface cable {slot/port | slot/subslot/port} dsg downstream rule rule-id [ cfr | clients | verbose ]
show interface cable {slot/port | slot/subslot/port} dsg downstream tunnel tunnel-id]
Syntax Description
Defaults
No default behaviors or values.
Command Modes
Privileged EXEC mode
Command History
12.3(13a)BC
This command was introduced to support A-DSG 1.1 on the Cisco uBR10012 and Cisco uBR7200 Series routers.
Usage Guidelines
Global configurations for A-DSG 1.1 must be complete before configuring interface definitions.
Refer to the following examples for illustrative usage guidelines.
Examples
The following example illustrates A-DSG downstream configuration information and the number of DSG tunnels, classifiers, clients and vender specific parameters.
Router# sh interfaces c6/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 2 666 1 1 2 3 4 9 6 4 6 23 500The following example illustrates the DCD statistics for the given downstream channel.
DCD TLV information displays if the debug cable dsg command is active.Router# sh int c6/0 dsg downstream dcddcd num of dcd num of dcd num of dcd num ofstate sent fail change cnt fragmenten 282 0 1 1Router# sh int c6/0 dsg downstream dcddcd num of dcd num of dcd num of dcd num ofstate sent fail change cnt fragmenten 2139 0 1 1Router#00:35:58: DCD TLV last sent:32390101 01020102 040E0302 09510100 02061111 11111111 05060100 5E01011406020001 2B150803 12345612 3456789A BCDEF012 3456789A BCDEF032 2601010202010104 0E030209 51010002 06111111 11111105 0601005E 01011E06 0200020602000A32 18010103 02010104 04040200 01050601 005E0101 28060200 0332140101040201 01040403 02070105 0601005E 01013232 14010105 02010104 0404020002050601 005E0101 3C321401 01070201 01040404 02000605 0601005E 010114321E010108 02010104 0E030209 51010002 06111111 11111105 0601005E 0101143235010114 02010104 0E030209 51010002 06111111 11111105 0601005E 0101142BRouter# 15080312 34561234 56789ABC DEF01234 56789ABC DEF01715 02020001 050101090C0504E6 6F6F6F03 046F6F6F 6F170F02 02000205 01010906 0504E601 0141170F02020003 05010109 060504E6 01012817 0F020200 0A050101 09060504 E601014733230104 27B25A80 01041DCD 65000202 00010302 00020402 00030502 00042B0508030022 22Router# sh int c6/0 dsg downstream rulerule rule rule tunnel tunnel tunnel cfr cfr cfrIn client vspid state pri id state mac-addr id state dcd listId index1 en 2 1 en 0100.5e01.0114 1 en yes 2 15 en no11 en no14 en no2 en 1 2 en 0100.5e01.011e 2 en yes 210 en yes3 en 1 3 en 0100.5e01.0128 3 en yes 34 en 1 4 en 0100.5e01.0132 4 en no 45 en 1 5 en 0100.5e01.013c 9 en no 56 en 1 6 dis 0100.5e01.0146 6 27 en 1 1 en 0100.5e01.0114 1 en no 105 en no11 en no14 en no8 en 1 1 en 0100.5e01.0114 1 en no 25 en no11 en no14 en no20 en 1 1 en 0100.5e01.0114 1 en no 2 15 en no11 en no14 en no65535 dis yesThe following example displays the same information as above for the given rule.
Router# sh int c6/0 dsg downstream rule 1rule rule rule tunnel tunnel tunnel cfr cfr cfrIn client vspid state pri id state mac-addr id state dcd listId index1 en 2 1 en 0100.5e01.0114 1 en yes 2 15 en no
Guest
