Table Of Contents
IGMP Static Group Range Support
Information About IGMP Static Group Range Support
IGMP Static Group Range Support Overview
Class Maps for IGMP Static Group Range Support
General Procedure for Configuring IGMP Group Range Support
Additional Guidelines for Configuring IGMP Static Group Range Support
Benefits of IGMP Static Group Range Support
How to Configure IGMP Static Group Range Support
Configuring IGMP Static Group Range Support
Verifying IGMP Static Group Range Support
Configuration Examples for IGMP Static Group Range Support
Configuring IGMP Static Group Support: Example
Verifying IGMP Static Group Support: Example
Feature Information for IGMP Static Group Range Support
IGMP Static Group Range Support
First Published: July 10, 2006Last Updated: November 20, 2009The IGMP Static Group Range Support feature introduces the capability to configure group ranges in class maps and attach class maps to the ip igmp static-group command. This feature is an enhancement that simplifies the administration of networks with devices that require many interfaces to be configured with many different ip igmp static-group command configurations.
Finding Feature Information
Your software release may not support all the features documented in this module. For the latest feature information and caveats, see the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the "Feature Information for IGMP Static Group Range Support" section.
Use Cisco Feature Navigator to find information about platform support and Cisco IOS and Catalyst OS software image support. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Contents
•Information About IGMP Static Group Range Support
•How to Configure IGMP Static Group Range Support
•Configuration Examples for IGMP Static Group Range Support
•Feature Information for IGMP Static Group Range Support
Information About IGMP Static Group Range Support
To configure the IGMP Static Group Range Support feature, you should understand the following concepts:
•IGMP Static Group Range Support Overview
•Class Maps for IGMP Static Group Range Support
•Benefits of IGMP Static Group Range Support
IGMP Static Group Range Support Overview
Prior to the introduction of the IGMP Static Group Range Support feature in Cisco IOS software, the ip igmp static-group command did not provide an option to specify group ranges. Administering devices that required many ip igmp static-group command configurations was challenging in some network environments, because each static group had to be configured individually with the ip igmp static-group command, which resulted in configurations that were excessively long and difficult to manage.
The IGMP Static Group Range Support feature introduces the capability to configure group ranges in class maps and attach class maps to the ip igmp static-group command. This feature is an enhancement that simplifies the administration of networks with devices that require many interfaces to be configured with many different ip igmp static-group command configurations.
Class Maps for IGMP Static Group Range Support
A class is a way of identifying a set of packets based on its contents. A class is designated through class maps. Typically, class maps are used to create traffic policies. Traffic policies are configured using the modular quality of service (QoS) command-line interface (CLI) (MQC). The normal procedure for creating traffic policies entails defining a traffic class (using the class-map command), creating a traffic policy (using the policy-map command), and attaching the policy to an interface (using the service-policy command).
Note Although this feature uses the MQC to define class maps, the procedure for configuring Internet Group Management Protocol (IGMP) static group class maps is different from the normal procedure used to create class maps for configuring QoS traffic policies. See the "General Procedure for Configuring IGMP Group Range Support" section for more information.
The IGMP Static Group Range Support feature introduces a type of class map that is used to define group ranges, group addresses, SSM channels, and SSM channel ranges. Once created, the class map can be attached to interfaces.
General Procedure for Configuring IGMP Group Range Support
To configure the IGMP Static Group Range Support feature, you would complete the following procedure:
1. Create an IGMP static group class map (using the class-map type multicast-flows command).
2. Define the group entries associated with the class map (using the group command).
3. Attach the class map to an interface (using the ip igmp static-group command).
The class-map type multicast-flows command is used to enter multicast-flows class-map configuration mode to create or modify an IGMP static group class map.
Unlike QoS class maps, which are defined by specifying numerous match criteria, IGMP static group class maps are defined by specifying multicast groups entries (group addresses, group ranges, Source Specific Multicast (SSM) channels, and SSM channel ranges). The following forms of the group command are entered from multicast-flows class-map configuration mode to define group entries to associate with the class map:
•group group-address
Defines a group address to be associated with an IGMP static group class map.
•group group-address to group-address
Defines a range of group addresses to be associated with an IGMP static group class map.
•group group-address source source-address
Defines an SSM channel to be associated with an IGMP static group class map.
•group group-address to group-address source source-address
Defines a range of SSM channels to be associated with an IGMP static group class map.
Unlike QoS class maps, IGMP static group range class maps are not configured in traffic policies. Rather, the ip igmp static-group command has been extended to support IGMP static group ranges. After creating an IGMP static group class map, you can attach the class map to interfaces using the ip igmp static-group command with the class-map keyword and class-map-name argument. Once a class map is attached to an interface, all group entries defined in the class map become statically connected members on the interface and are added to the IGMP cache and IP multicast route (mroute) table.
Additional Guidelines for Configuring IGMP Static Group Range Support
•Only one IGMP static group class map can be attached to an interface.
•If an IGMP static group class map is modified (that is, if group entries are added to or removed from the class map using the group command), the group entries that are added to or removed from the IGMP static group class map are added to or deleted from the IGMP cache and the mroute table, respectively.
•If an IGMP static group class map is replaced on an interface by another class map using the ip igmp static-group command, the group entries associated with old class map are removed, and the group entries defined in the new class map are added to the IGMP cache and mroute table.
•The ip igmp static-group command accepts an IGMP static group class map for the class-map-name argument, regardless of whether the class map configuration exists. If a class map attached to an interface does not exist, the class map remains inactive. Once the class map is configured, all group entries associated with the class map are added to the IGMP cache and mroute table.
•If a class map is removed from an interface using the no form of the ip igmp static-group command, all group entries defined in the class map are removed from the IGMP cache and mroute tables.
Benefits of IGMP Static Group Range Support
The IGMP Static Group Range Support feature provides the following benefits:
•Simplifies the administration of devices that require many interfaces to be configured with many different ip igmp static-group command configurations by introducing the capability to configure group ranges in class maps and attach class maps to the ip igmp static-group command.
•Reduces the number of commands required to administer devices that require many ip igmp static-group command configurations.
How to Configure IGMP Static Group Range Support
This procedure contains the following tasks:
•Configuring IGMP Static Group Range Support (required)
•Verifying IGMP Static Group Range Support (optional)
Configuring IGMP Static Group Range Support
The IGMP Static Group Range Support feature is an enhancement that simplifies the administration of devices that require many interfaces to be configured with many different ip igmp static-group command configurations by introducing the capability to configure group ranges in class maps and attach class maps to the ip igmp static-group command.
Perform this task to configure IGMP static group class maps and attach class maps to the ip igmp static-group command.
Note Although the IGMP Static Group Range Support feature uses the MQC to define class maps, the procedure for configuring IGMP static group class maps is different from the normal procedure used to create class maps for configuring QoS traffic policies. For more information about IGMP static group class maps, including configuration guidelines, see the "Class Maps for IGMP Static Group Range Support" section.
SUMMARY STEPS
1. enable
2. configure terminal
3. class-map type multicast-flows class-map-name
4. group group-address [to group-address] [source source-address]
5. Repeat Step 4 to add group entries to the class map in Step 3.
6. Repeat Step 3 to Step 5, if you want to create additional class maps.
7. exit
8. interface type number
9. ip igmp static-group class-map class-map-name
10. Repeat Step 8 and 9, if you want to attach class maps to additional interfaces.
11. end
DETAILED STEPS
Verifying IGMP Static Group Range Support
Perform this optional task to verify the contents of IGMP static group class maps configurations, and to confirm that all group entries defined in class maps were added to the IGMP cache and the mroute table after you attach class maps to interfaces.
SUMMARY STEPS
1. show ip igmp static-group class-map [interface [type number]]
2. show ip igmp groups [group-name | group-address | interface-type interface-number] [detail]
3. show ip mroute
DETAILED STEPS
Step 1 show ip igmp static-group class-map [interface [type number]]
Use this command to display the contents of IGMP static group class maps and the interfaces using class maps:
•Specify the interface keyword to filter the output to display only the interfaces using class maps.
•Specify the interface keyword and the type number arguments to filter the output to display only the class map attached to a particular interface.
The following is sample output from the show ip igmp static-group class-map command:
Router# show ip igmp static-group class-map
Class-map static1Group address range 228.8.8.7 to 228.8.8.9Group address 232.8.8.7, source address 10.1.1.10Interfaces using the classmap:Loopback0Class-map staticGroup address range 232.7.7.7 to 232.7.7.9, source address 10.1.1.10Group address 227.7.7.7Group address range 227.7.7.7 to 227.7.7.9Group address 232.7.7.7, source address 10.1.1.10Interfaces using the classmap:Ethernet3/1The following is sample output from the show ip igmp static-group class-map command with the interface keyword:
Router# show ip igmp static-group class-map interface
Loopback0Class-map attached: static1Ethernet3/1Class-map attached: staticThe following is sample output from the show ip igmp static-group class-map command with the interface keyword and type number arguments:
Router# show ip igmp static-group class-map interface Ethernet 3/1
Ethernet3/1Class-map attached: staticStep 2 show ip igmp groups [group-name | group-address | interface-type interface-number] [detail]
Use this command to display the multicast groups with receivers that are directly connected to the router and that are learned through IGMP.
When verifying an IGMP static group range configuration, use this command after attaching a class map to confirm that the group entries defined in the class map were added to the IGMP cache.
The following is sample output from the show ip igmp groups command:
Router# show ip igmp groups
IGMP Connected Group MembershipGroup Address Interface Uptime Expires Last Reporter232.7.7.7 Ethernet3/1 00:00:09 stopped 0.0.0.0232.7.7.9 Ethernet3/1 00:00:09 stopped 0.0.0.0232.7.7.8 Ethernet3/1 00:00:09 stopped 0.0.0.0227.7.7.7 Ethernet3/1 00:00:09 stopped 0.0.0.0227.7.7.9 Ethernet3/1 00:00:09 stopped 0.0.0.0227.7.7.8 Ethernet3/1 00:00:09 stopped 0.0.0.0224.0.1.40 Ethernet3/2 01:44:50 00:02:09 10.2.2.5224.0.1.40 Loopback0 01:45:22 00:02:32 10.3.3.4Step 3 show ip mroute
Use this command to display the contents of the mroute table.
When verifying an IGMP static group range configuration, use this command after attaching a class map to confirm that group entries defined in the class map were added to the mroute table.
The following is sample output from the show ip mroute command:
Router# show ip mroute
IP Multicast Routing TableFlags: D - Dense, S - Sparse, B - Bidir Group, s - SSM Group, C - Connected,L - Local, P - Pruned, R - RP-bit set, F - Register flag,T - SPT-bit set, J - Join SPT, M - MSDP created entry,X - Proxy Join Timer Running, A - Candidate for MSDP Advertisement,U - URD, I - Received Source Specific Host Report, Z - Multicast TunnelY - Joined MDT-data group, y - Sending to MDT-data groupOutgoing interface flags: H - Hardware switched, A - Assert winnerTimers: Uptime/ExpiresInterface state: Interface, Next-Hop or VCD, State/Mode(10.1.1.10, 232.7.7.7), 00:00:17/00:02:42, flags: sTIIncoming interface: Ethernet3/2, RPF nbr 10.2.2.5Outgoing interface list:Ethernet3/1, Forward/Sparse-Dense, 00:00:17/00:02:42(10.1.1.10, 232.7.7.9), 00:00:17/00:02:42, flags: sTIIncoming interface: Ethernet3/2, RPF nbr 10.2.2.5Outgoing interface list:Ethernet3/1, Forward/Sparse-Dense, 00:00:17/00:02:42(10.1.1.10, 232.7.7.8), 00:00:18/00:02:41, flags: sTIIncoming interface: Ethernet3/2, RPF nbr 10.2.2.5Outgoing interface list:Ethernet3/1, Forward/Sparse-Dense, 00:00:18/00:02:41(*, 227.7.7.7), 00:00:18/00:02:41, RP 10.2.2.6, flags: SJCIncoming interface: Ethernet3/2, RPF nbr 10.2.2.6Outgoing interface list:Ethernet3/1, Forward/Sparse-Dense, 00:00:18/00:02:41(*, 227.7.7.9), 00:00:18/00:02:41, RP 10.2.2.6, flags: SJCIncoming interface: Ethernet3/2, RPF nbr 10.2.2.6Outgoing interface list:Ethernet3/1, Forward/Sparse-Dense, 00:00:18/00:02:41(*, 227.7.7.8), 00:00:18/00:02:41, RP 10.2.2.6, flags: SJCIncoming interface: Ethernet3/2, RPF nbr 10.2.2.6Outgoing interface list:Ethernet3/1, Forward/Sparse-Dense, 00:00:18/00:02:41(*, 224.0.1.40), 00:01:40/00:02:23, RP 10.2.2.6, flags: SJCLIncoming interface: Ethernet3/2, RPF nbr 10.2.2.6Outgoing interface list:Loopback0, Forward/Sparse-Dense, 00:01:40/00:02:23
Configuration Examples for IGMP Static Group Range Support
This section provides the following configuration examples:
•Configuring IGMP Static Group Support: Example
•Verifying IGMP Static Group Support: Example
Configuring IGMP Static Group Support: Example
The following example shows how to configure a class map and attach the class map to an interface. In this example, a class map named static is configured and attached to Ethernet interface 3/1.
class-map type multicast-flows staticgroup 227.7.7.7group 232.7.7.7 to 232.7.7.9 source 10.1.1.10group 232.7.7.7 source 10.1.1.10group 227.7.7.7 to 227.7.7.9...!interface Ethernet3/1ip address 192.168.1.2 255.255.255.0ip pim sparse-dense-modeip igmp static-group class-map static!Verifying IGMP Static Group Support: Example
The following is sample output from the show ip igmp static-group class-map command. In this example, the output displays the contents of the IGMP static group class map named static (the class map configured in the "Configuring IGMP Static Group Support: Example" section).
Router# show ip igmp static-group class-map
Class-map staticGroup address range 227.7.7.7 to 227.7.7.9Group address 232.7.7.7, source address 10.1.1.10Group address range 232.7.7.7 to 232.7.7.9, source address 10.1.1.10Group address 227.7.7.7Interfaces using the classmap:Ethernet3/1The following is sample output from the show ip igmp groups command. In this example, the command is issued to confirm that the group entries defined in the class map named static (the class map configured in the "Configuring IGMP Static Group Support: Example" section) were added to the IGMP cache.
Router# show ip igmp groups
IGMP Connected Group MembershipGroup Address Interface Uptime Expires Last Reporter232.7.7.7 Ethernet3/1 00:00:09 stopped 0.0.0.0232.7.7.9 Ethernet3/1 00:00:09 stopped 0.0.0.0232.7.7.8 Ethernet3/1 00:00:09 stopped 0.0.0.0227.7.7.7 Ethernet3/1 00:00:09 stopped 0.0.0.0227.7.7.9 Ethernet3/1 00:00:09 stopped 0.0.0.0227.7.7.8 Ethernet3/1 00:00:09 stopped 0.0.0.0224.0.1.40 Ethernet3/2 01:44:50 00:02:09 10.2.2.5224.0.1.40 Loopback0 01:45:22 00:02:32 10.3.3.4The following is sample output from the show ip mroute command. In this example, the command is issued to confirm that the group entries defined in the class map named static (the class map configured in the "Configuring IGMP Static Group Support: Example" section) were added to the mroute table.
Router# show ip mroute
IP Multicast Routing TableFlags: D - Dense, S - Sparse, B - Bidir Group, s - SSM Group, C - Connected,L - Local, P - Pruned, R - RP-bit set, F - Register flag,T - SPT-bit set, J - Join SPT, M - MSDP created entry,X - Proxy Join Timer Running, A - Candidate for MSDP Advertisement,U - URD, I - Received Source Specific Host Report, Z - Multicast TunnelY - Joined MDT-data group, y - Sending to MDT-data groupOutgoing interface flags: H - Hardware switched, A - Assert winnerTimers: Uptime/ExpiresInterface state: Interface, Next-Hop or VCD, State/Mode(10.1.1.10, 232.7.7.7), 00:00:17/00:02:42, flags: sTIIncoming interface: Ethernet3/2, RPF nbr 10.2.2.5Outgoing interface list:Ethernet3/1, Forward/Sparse-Dense, 00:00:17/00:02:42(10.1.1.10, 232.7.7.9), 00:00:17/00:02:42, flags: sTIIncoming interface: Ethernet3/2, RPF nbr 10.2.2.5Outgoing interface list:Ethernet3/1, Forward/Sparse-Dense, 00:00:17/00:02:42(10.1.1.10, 232.7.7.8), 00:00:18/00:02:41, flags: sTIIncoming interface: Ethernet3/2, RPF nbr 10.2.2.5Outgoing interface list:Ethernet3/1, Forward/Sparse-Dense, 00:00:18/00:02:41(*, 227.7.7.7), 00:00:18/00:02:41, RP 10.2.2.6, flags: SJCIncoming interface: Ethernet3/2, RPF nbr 10.2.2.6Outgoing interface list:Ethernet3/1, Forward/Sparse-Dense, 00:00:18/00:02:41(*, 227.7.7.9), 00:00:18/00:02:41, RP 10.2.2.6, flags: SJCIncoming interface: Ethernet3/2, RPF nbr 10.2.2.6Outgoing interface list:Ethernet3/1, Forward/Sparse-Dense, 00:00:18/00:02:41(*, 227.7.7.8), 00:00:18/00:02:41, RP 10.2.2.6, flags: SJCIncoming interface: Ethernet3/2, RPF nbr 10.2.2.6Outgoing interface list:Ethernet3/1, Forward/Sparse-Dense, 00:00:18/00:02:41(*, 224.0.1.40), 00:01:40/00:02:23, RP 10.2.2.6, flags: SJCLIncoming interface: Ethernet3/2, RPF nbr 10.2.2.6Outgoing interface list:Loopback0, Forward/Sparse-Dense, 00:01:40/00:02:23Additional References
The following sections provide references related to the IGMP Static Group Range Support feature.
Related Documents
Related Topic Document TitleIP multicast commands: complete command syntax, command modes, command history, defaults, usage guidelines, and examples
Cisco IOS IP Multicast Command Reference
Standards
Standard TitleNo new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature.
—
MIBs
RFCs
RFC TitleNo new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified by this feature.
—
Technical Assistance
Feature Information for IGMP Static Group Range Support
Table 1 lists the release history for this feature.
For information on a feature in this technology that is not documented here, see the "IP Multicast Features Roadmap."
Not all commands may be available in your Cisco IOS software release. For release information about a specific command, see the command reference documentation.
Use Cisco Feature Navigator to find information about platform support and software image support. Cisco Feature Navigator enables you to determine which Cisco IOS and Catalyst OS software images support a specific software release, feature set, or platform. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Note Table 1 lists only the Cisco IOS software release that introduced support for a given feature in a given Cisco IOS software release train. Unless noted otherwise, subsequent releases of that Cisco IOS software release train also support that feature.
CCDE, CCENT, CCSI, Cisco Eos, Cisco HealthPresence, Cisco IronPort, the Cisco logo, Cisco Nurse Connect, Cisco Pulse, Cisco SensorBase, Cisco StackPower, Cisco StadiumVision, Cisco TelePresence, Cisco Unified Computing System, Cisco WebEx, DCE, Flip Channels, Flip for Good, Flip Mino, Flipshare (Design), Flip Ultra, Flip Video, Flip Video (Design), Instant Broadband, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn, Cisco Capital, Cisco Capital (Design), Cisco:Financed (Stylized), Cisco Store, Flip Gift Card, and One Million Acts of Green are service marks; and Access Registrar, Aironet, AllTouch, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Lumin, Cisco Nexus, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, Continuum, EtherFast, EtherSwitch, Event Center, Explorer, Follow Me Browsing, GainMaker, iLYNX, IOS, iPhone, IronPort, the IronPort logo, Laser Link, LightStream, Linksys, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, PCNow, PIX, PowerKEY, PowerPanels, PowerTV, PowerTV (Design), PowerVu, Prisma, ProConnect, ROSA, SenderBase, SMARTnet, Spectrum Expert, StackWise, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0910R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.
© 2006-2009 Cisco Systems, Inc. All rights reserved.