IGMP Commands on Cisco ASR 9000 Series Router

This chapter describes the commands used to configure and monitor IPv4 multicast protocol on Cisco ASR 9000 Series Routers .

To use commands of this module, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using any command, contact your AAA administrator for assistance.

The commands in this chapter apply to the Internet Group Management Protocol (IGMP), versions 1, 2, and 3.

For detailed information about multicast routing concepts, configuration tasks, and examples, refer to the Implementing Multicast Routing on Cisco IOS XR Software configuration module in Multicast Configuration Guide for Cisco ASR 9000 Series Routers .

access-group (IGMP)

To set limits on an interface for multicast-group join requests by hosts, use the access-group command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.

access-group access-list

Syntax Description

access-list

Number or name of a standard IP access list. Range is 1 to 99.

Command Default

No default behavior or values

Command Modes

IGMP interface configuration

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

If this command is not specified in router Internet Group Management Protocol (IGMP) configuration mode, the interface accepts all multicast join requests by hosts.

Task ID

Task ID

Operations

multicast

read, write

Examples

In the following example, hosts serviced by GigabitEthernet interface 0/1/0/1 can join only group 225.2.2.2:


RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# ipv4 access-list mygroup permit 225.2.2.2 0.0.0.0
RP/0/RSP0/CPU0:router(config)# router igmp
RP/0/RSP0/CPU0:router(config-igmp)# interface GigE 0/1/0/1
RP/0/RSP0/CPU0:router(config-igmp-default-if)# access-group mygroup
RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# ipv4 access-list mygroup permit 225.2.2.2 0.0.0.0
RP/0/RSP0/CPU0:router(config)# router igmp
RP/0/RSP0/CPU0:router(config-igmp)# interface GigE 0/1/0/1
RP/0/RSP0/CPU0:router(config-igmp-default-if)# access-group mygroup

clear igmp counters

To clear IGMP traffic statistics, use the clear igmp counters command in EXEC mode.

clear igmp [ipv4 vrf vrf-name | vrf vrf-name] counters

Syntax Description

ipv4

(Optional) Specifies IPv4 addressing. IPv4 is the default for Internet Group Management Protocol (IGMP) groups.

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

After IGMP statistics are cleared, statistics begin incrementing again.

Task ID

Task ID

Operations

multicast

execute

Examples

The following example shows sample output before and after clearing IGMP traffic statistics:


RP/0/RSP0/CPU0:routershow igmp traffic

IGMP Traffic Counters
Elapsed time since counters cleared: 00:00:19

                                  Received        Sent
Valid IGMP Packets                       0          12
Queries                                  0           3
Reports                                  0           9
Leaves                                   0           0
Mtrace packets                           0           0
DVMRP packets                            0           0
PIM packets                              0           0

Errors:
Malformed Packets                                    0
Bad Checksums                                        0
Socket Errors                                        0
Bad Scope Errors                                     0
Auxiliary Data Len Errors 0
Subnet Errors                                        0
Packets dropped due to invalid socket                0
Packets which couldn't be accessed                   0
Other packets drops                                  0 

RP/0/RSP0/CPU0:routerclear igmp counters 

RP/0/RSP0/CPU0:routershow igmp traffic 

IGMP Traffic Counters
Elapsed time since counters cleared: 00:00:12

                                  Received        Sent
Valid IGMP Packets                       0           1
Queries                                  0           1
Reports                                  0           0
Leaves                                   0           0
Mtrace packets                           0           0
DVMRP packets                            0           0
PIM packets                              0           0

Errors:
Malformed Packets                                    0
Bad Checksums                                        0
Socket Errors                                        0
Bad Scope Errors                                     0
Auxiliary Data Len Errors                            0
Subnet Errors                                        0
Packets dropped due to invalid socket                0
Packets which couldn't be accessed                   0
Other packets drops                                  0

clear igmp group

To clear Internet Group Management Protocol (IGMP) groups on one or all interfaces, use the clear igmp group command in EXEC mode.

clear igmp [ipv4 vrf vrf-name | vrf vrf-name] group [ip-address | type interface-path-id]

Syntax Description

ipv4

(Optional) Specifies IPv4 addressing. IPv4 is the default for IGMP groups.

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

ip-address

(Optional) IP hostname or group address.

type

(Optional) Interface type. For more information, use the question mark (?) online help function.

interface-path-id

(Optional) Physical interface or virtual interface.

Note

 

Use the show interfaces command to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (?) online help function.

Command Default

If no group address is specified, all IGMP groups are cleared.

Command Modes

EXEC

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

To clear all IGMP groups, use the clear igmp group command without using an argument. To clear a particular group, use the ip-address or type interface-path-id arguments.

The following groups cannot be cleared:

  • 224.0.0.2
  • 224.0.0.13
  • 224.0.0.22
  • 224.0.0.40

Task ID

Task ID

Operations

multicast

execute

Examples

The following example uses the show igmp groups command to display the IGMP Connected Group Membership, the clear igmp group command to clear address 239.1.1.1, and the show igmp groups command again to display the updated list.


RP/0/RSP0/CPU0:routershow igmp groups tenGigE 0/4/0/0 

IGMP Connected Group Membership
Group Address   Interface                     Uptime    Expires   Last Reporter
224.0.0.2       TenGigE0/4/0/0                3w6d      never     10.114.8.44
224.0.0.5       TenGigE0/4/0/0                3w6d      never     10.114.8.44
224.0.0.6       TenGigE0/4/0/0                3w6d      never     10.114.8.44
224.0.0.13      TenGigE0/4/0/0                3w6d      never     10.114.8.44
224.0.0.22      TenGigE0/4/0/0                3w6d      never     10.114.8.44

RP/0/RSP0/CPU0:routerclear igmp groups tenGigE 0/4/0/0

RP/0/RSP0/CPU0:routershow igmp groups tenGigE 0/4/0/0

IGMP Connected Group Membership
Group Address   Interface                     Uptime    Expires   Last Reporter
224.0.0.2       TenGigE0/4/0/0                3w6d      never     10.114.8.44
224.0.0.5       TenGigE0/4/0/0                3w6d      never     10.114.8.44
224.0.0.6       TenGigE0/4/0/0                3w6d      never     10.114.8.44
224.0.0.13      TenGigE0/4/0/0                3w6d      never     10.114.8.44
224.0.0.22      TenGigE0/4/0/0                3w6d      never     10.114.8.44

clear igmp reset

To clear all Internet Group Management Protocol (IGMP) membership entries and reset connection in the Multicast Routing Information Base (MRIB), use the clear igmp reset command in EXEC mode.

clear igmp [ipv4 vrf vrf-name | vrf vrf-name] reset

Syntax Description

ipv4

(Optional) Specifies IPv4 addressing. IPv4 is the default for IGMP groups.

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

Every IGMP group membership that IGMP learns is downloaded to the MRIB database.

The clear igmp reset command is used to clear all information from the IGMP topology table and reset the MRIB connection.


Note


This command is reserved to force synchronization of IGMP and MRIB entries when communication between the two components is malfunctioning.


Task ID

Task ID

Operations

multicast

execute

Examples

The following example shows how to clear the group memberships in MRIB:


RP/0/RSP0/CPU0:router# clear igmp reset

clear igmp unicast-qos-adjust

To clear IGMP unicast rate adjustment database, use the clear igmp unicast-qos-adjust command in the EXEC mode.

clear igmp unicast-qos-adjust { rate | statistics } interface { type | interface_path_id }

Syntax Description

rate

Specifies the rate programmed in QoS.

statistics

Specifies the unicast rate adjustment statistics.

interface

Specifies the interface specific rate.

type

Interface type. For more information, use the question mark (?) online help function.

interface-path-id

Either a physical interface instance or a virtual interface instance as follows:

  • Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation.
    • rack: Chassis number of the rack.

    • slot: Physical slot number of the modular services card or line card.

    • module: Module number. A physical layer interface module (PLIM) is always 0.

    • port: Physical port number of the interface.

    Note

     

    In references to a Management Ethernet interface located on a route processor card, the physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0. Example: interface MgmtEth0/RP1/CPU0/0.

  • Virtual interface instance. Number range varies depending on interface type.

For more information about the syntax for the router, use the question mark (?) online help function.

Command Default

Clears all unicast qos adjust parameters.

Command Modes

EXEC mode

Command History

Release Modification

Release 4.2.0

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation

multicast

exec

Examples

This is an example of using the clear igmp unicast-qos-adjust command:



RP/0/RSP0/CPU0:router# clear igmp unicast-qos-adjust rate interface Loopback 1

explicit-tracking

To configure explicit host tracking under Internet Group Management Protocol (IGMP) Version 3 , use the explicit-tracking command in the appropriate configuration mode. To disable explicit host tracking, use the no form of this command.

explicit-tracking [access-list | disable]

Syntax Description

access-list

(Optional) Access list that specifies the group range for host tracking.

disable

(Optional) Disables explicit host tracking on a specific interface. This option is available only in interface configuration mode.

Command Default

If this command is not specified in IGMP configuration mode, then explicit host tracking is disabled.

Command Modes

IGMP VRF configuration

IGMP interface configuration

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

By default, IGMP supports Version 3, unless a Version 2 or Version 1 IGMP host message is detected in the network. For backward compatibility, IGMP downgrades to run at the IGMP version level that is installed.

This feature allows the router to achieve minimal leave latencies when hosts leave a multicast group or channel. To monitor IGMP membership of hosts, use the show igmp groups command in EXEC mode.

In router configuration mode, the explicit-tracking command enables explicit host tracking for all interfaces.To disable explicit tracking for all interfaces, use the no form of the command from IGMP configuration mode. To disable the feature on specific interfaces, use the explicit-tracking command in interface configuration mode with the disable keyword, as shown in the following example.


Note


If you configure this command in IGMP VRF configuration mode, parameters are inherited by all new and existing interfaces. However, you can override these parameters on individual interfaces from IGMP interface configuration mode.


Task ID

Task ID

Operations

multicast

read, write

Examples

The following example shows how to enable explicit host tracking for the access list named router1 on all interfaces and how to disable explicit host tracking for a specific GigabitEthernet interface:


RP/0/RSP0/CPU0:router(config)# router igmp
RP/0/RSP0/CPU0:router(config-igmp)# explicit-tracking router1
RP/0/RSP0/CPU0:router(config-igmp)# interface GigabitEthernet 0/1/0/0
RP/0/RSP0/CPU0:router(config-igmp-default-if)# explicit-tracking disable

igmp accounting

To enable accounting feature under igmp, use the igmp accounting command in the Global Configuration mode. To disable this feature, use the no form of this command.

igmp accounting { max-history | number_of_days}

Syntax Description

max-history

Sets the maximum history for the accounting in days.

number_of_days

Specifies the number of days the history has to be retained. This value ranged from 1 to 365.

Command Default

If max-history is not specified, then the default is 0 days, which indicates that there was no history saved.

Command Modes

Global Configuration mode

Command History

Release Modification

Release 4.2.0

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation

multicast

read, write

Examples

This is an example of configuring the igmp accounting command in the Global Configuration mode:


RP/0/RSP0/CPU0:router # configure
RP/0/RSP0/CPU0:router(config)# router igmp accounting max-history 67

igmp explicit-tracking

To configure explicit host tracking under Internet Group Management Protocol (IGMP) Version 3, use the igmp explicit-tracking command in the dynamic-template configuration mode. To disable explicit host tracking, use the no form of this command.

igmp explicit-tracking access_list_name

Syntax Description

access_list_name

Specifies the access list tracking group range.

Command Default

None

Command Modes

Dynamic template configuration mode

Command History

Release Modification

Release 4.2.0

This command was introduced.

Usage Guidelines

Use the dynamic-template type ppp command to enter dynamic template type ppp configuration mode.

Task ID

Task ID Operation

multicast

read, write

Examples

This is an example of configuring the igmp explicit-tracking command in the dynamic-template configuration mode:


RP/0/RSP0/CPU0:router# configure 
RP/0/RSP0/CPU0:router(config)# dynamic-template
RP/0/RSP0/CPU0:router(config-dynamic-template)# type ppp foo
RP/0/RSP0/CPU0:router(config-dynamic-template-type)# igmp explicit-tracking igmp1

igmp query-interval

To configure the frequency at which the Cisco IOS XR Software sends Internet Group Management Protocol (IGMP) host-query messages, use the igmp query-interval command in the dynamic-template configuration mode. To disable this feature, use the no form of this command.

igmp query-interval seconds

Syntax Description

seconds

Specifies the frequency used to send IGMP host-query messages and ranges between 1 to 3600.

Command Default

The default query-interval value is 60s.

Command Modes

Dynamic template configuration mode

Command History

Release Modification

Release 4.2.0

This command was introduced.

Usage Guidelines

Use the dynamic-template type ppp command to enter dynamic template type ppp configuration mode.

Task ID

Task ID Operation

multicast

read, write

Examples

This is the example of configuring the igmp query-interval command in the dynamic-template configuration mode:


RP/0/RSP0/CPU0:router# configure 
RP/0/RSP0/CPU0:router(config)# dynamic-template
RP/0/RSP0/CPU0:router(config-dynamic-template)# type ppp foo
RP/0/RSP0/CPU0:router(config-dynamic-template-type)# igmp query-interval 60

igmp query-max-response-time

To configure the maximum response time advertised in Internet Group Management Protocol (IGMP) queries, use the igmp query-max-response-time command in the dynamic-template configuration mode. To disable this feature, use the no form of this command.

igmp query-max-response-time seconds

Syntax Description

seconds

Specifies the maximum response time, in seconds, advertised in IGMP queries, and ranges between 1 to 12.

Command Default

The default query-max-response-time is 10 seconds.

Command Modes

Dynamic template configuration mode

Command History

Release Modification

Release 4.2.0

This command was introduced.

Usage Guidelines

Use the dynamic-template type ppp command to enter dynamic template type ppp configuration mode.

Task ID

Task ID Operation

multicast

read, write

Examples

This is the example of configuring the igmp query-max-response-time command in the dynamic-template configuration mode:


RP/0/RSP0/CPU0:router# configure 
RP/0/RSP0/CPU0:router(config)# dynamic-template
RP/0/RSP0/CPU0:router(config-dynamic-template)# type ppp foo
RP/0/RSP0/CPU0:router(config-dynamic-template-type)# igmp query-max-response-time 12

join-group

To have the router join a multicast group, use the join-group command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.

join-group group-address [source-address]

Syntax Description

group-address

Address of the multicast group. This is a multicast IP address group in IPv4 format

  • IP address as defined in the Domain Name System (DNS) hosts table or with the domain IPv4 host in the format A.B.C.D .

source-address

(Optional) Source address of the multicast group to include in IPv4 prefixing format

  • IP address as defined in the Domain Name System (DNS) hosts table or with the domain IPv4 host in the format A.B.C.D .

Command Default

No multicast group memberships are predefined. If not specified, include is the default.

Command Modes

IGMP interface configuration

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

The join-group command permits the IP packets that are addressed to the group address to pass to the IP client process in the Cisco IOS XR software.

If all the multicast-capable routers that you administer are members of a multicast group, pinging that group causes all routers to respond. This command can be a useful administrative and debugging tool.

Another reason to have a router join a multicast group is when other hosts on the network are prevented from correctly answering IGMP queries. When the router joins the multicast group, upstream devices learn multicast routing table information for that group and keep the paths for that group active.


Caution


Joining a multicast group can result in a significant performance impact, because all subscribed multicast packets are punted to the route processor.


Task ID

Task ID

Operations

multicast

read, write

Examples

In the following example, the router joins multicast group 225.2.2.2:


		RP/0/RSP0/CPU0:router(config)# router igmp
		RP/0/RSP0/CPU0:router(config-igmp)# interface GigabitEthernet 0/1/0/0
		RP/0/RSP0/CPU0:router(config-igmp-default-if)# join-group 225.2.2.2
		
		 

The join-group command can have an include/exclude mode for IGMPv3 interfaces as shown in the following example:


RP/0/RSP0/CPU0:router(config)#router igmp 
RP/0/RSP0/CPU0:router(config-igmp)#int gigabitEthernet 0/5/0/1 RP/0/RSP0/CPU0:router(config-igmp-default-if)#join-group ?
A.B.C.D  IP group address
RP/0/RSP0/CPU0:router(config-igmp-default-if)#join-group 225.0.0.0 ?
A.B.C.D  Source address to include
exclude  Exclude the only following source address include  Include only the following source address <cr> 
RP/0/RSP0/CPU0:router(config-igmp-default-if)#join-group 225.0.0.0 10.10.10.10 ?
<cr>
RP/0/RSP0/CPU0:router(config-igmp-default-if)#join-group 225.0.0.0 ?
A.B.C.D  Source address to include
exclude  Exclude the only following source address 
include Include only the following source address <cr> 
RP/0/RSP0/CPU0:router(config-igmp-default-if)#join-group 225.0.0.0

maximum groups

To configure the maximum number of groups used by Internet Group Management Protocol (IGMP) and accepted by a router, use the maximum groups command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.

maximum groups number

Syntax Description

number

Maximum number of groups accepted by a router. Range is 1 to 75000.

Command Default

number : 50000

Command Modes

IGMP configuration

IGMP VRF configuration

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

When configuring this command within IGMP VRF configuration mode, you may either use the default (unspecified) VRF or a specific VRF by specifying its name.

The maximum combined number of groups on all interfaces can be 75000. After the maximum groups value is met, all additional memberships learned are ignored. The maximum number includes external and local membership.

The following groups obtain local membership on each interface when multicast is enabled and are added into the group totals for each interface: 224.0.0.13 (for PIM), 224.0.0.22 and 224.0.0.2 (for IGMP).

You cannot use the maximum groups command to configure the maximum number of groups below the number of existing groups. For instance, if the number of groups is 39, and you set the maximum number of groups to 10, the configuration is rejected.

Although Cisco IOS XR Software Release 3.9.0 supports 40,000 groups per interface, the ASR9000 router supports a maximum of 16,000 multicast routes per system.

Furthermore, you can use the maximum groups per-interface command to configure the maximum number of groups for each interface accepted by a router.

Task ID

Task ID

Operations

multicast

read, write

Examples

The following example shows how to display the number of groups (39) and the maximum number of groups configured (50000) . Through use of the maximum groups command, a configuration is committed to change the maximum number of groups to 40. Before and after configuration, the show igmp summary command is used to confirm the configuration change:


RP/0/RSP0/CPU0:router# show igmp summary 

IGMP summary

Robustness Value 2
No. of Group x Interfaces 61
Maximum number of Group x Interfaces 50000

Supported Interfaces   : 18
Unsupported Interfaces : 2
Enabled Interfaces     : 18
Disabled Interfaces    : 2

Interface                 Grp No    Max Grp No
MgmtEth0/RSP0/CPU0/0       0         25000 
Loopback0                 4         25000 
Bundle-Ether24            3         25000 
Bundle-Ether28            3         25000 
Bundle-Ether28.1          3         25000 
Bundle-Ether28.2          3         25000 
Bundle-Ether28.3          3         25000 
MgmtEth0/RP1/CPU0/0       0         25000 
GigabitEthernet0/1/5/0    3         25000 
GigabitEthernet0/1/5/1    5         25000 
GigabitEthernet0/1/5/2    5         25000 
GigabitEthernet0/1/0/1    5         25000 
GigabitEthernet0/1/4/2    3         25000 
GigabitEthernet0/6/5/1    3         25000 
GigabitEthernet0/6/5/2    3         25000 
GigabitEthernet0/6/5/7    3         25000 
GigabitEthernet0/6/0/1    3         25000 
GigabitEthernet0/6/4/4    3         25000 
GigabitEthernet0/6/4/5    3         25000 
GigabitEthernet0/6/4/6    3         25000 

RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# router igmp
RP/0/RSP0/CPU0:router(config-igmp)# maximum groups 65
RP/0/RSP0/CPU0:router(config-igmp)# commit

RP/0/RSP0/CPU0:router:May 13 12:26:59.108 : config[65704]: %LIBTARCFG-6-COMMIT : Configuration committed 
by user 'cisco'.   Use 'show commit changes 1000000025' to view the changes. 

RP/0/RSP0/CPU0:router# show igmp summary 

Robustness Value 2
No. of Group x Interfaces 61
Maximum number of Group x Interfaces 65

Supported Interfaces   : 18
Unsupported Interfaces : 2
Enabled Interfaces     : 18
Disabled Interfaces    : 2

Interface                 Grp No    Max Grp No
MgmtEth0/RSP0/CPU0/0       0         25000 
Loopback0                 4         25000 
Bundle-Ether28            3         25000 
Bundle-Ether28.1          3         25000 
Bundle-Ether28.2          3         25000 
Bundle-Ether28.3          3         25000 
MgmtEth0/RP1/CPU0/0       0         25000 
GigabitEthernet0/1/5/0    3         25000 
GigabitEthernet0/1/5/1    5         25000 
GigabitEthernet0/1/5/2    5         25000 
GigabitEthernet0/6/5/1    3         25000 
GigabitEthernet0/6/5/2    3         25000 
GigabitEthernet0/6/5/7    3         25000 

maximum groups-per-interface

To configure the maximum number of groups for each interface accepted by a router, use the maximum groups-per-interface command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.

maximum groups-per-interface number

Syntax Description

number

Maximum number of groups accepted by a router for each interface. Range is 1 to 16000.

Command Default

number : 20000

Command Modes

IGMP configuration

IGMP VRF configuration

IGMP interface configuration

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

The following groups obtain local membership on each interface when multicast is enabled and are added into the group totals for each interface: 224.0.0.13 (for Protocol Independent Multicast [PIM]), 224.0.0.22 and 224.0.0.2 (for Internet Group Management Protocol [IGMP]). The number of groups for each interface reflects both external and local group membership.


Note


You cannot use the maximum groups-per-interface command to configure the maximum number of groups for each interface below the number of existing groups on an interface. For example, if the number of groups is 39, and you set the maximum number of groups to 10, the configuration is rejected.


When you use the maximum groups-per-interface command for a specific interface, it overrides the inheritance property of this command specified under IGMP configuration mode.

Task ID

Task ID

Operations

multicast

read, write

Examples

The following example shows how to display the maximum number of groups for each interface. A configuration is committed to change the maximum number of groups for each interface to 12. Before and after configuration, use the show igmp summary command to confirm the configuration change:


RP/0/RSP0/CPU0:router# show igmp summary 

IGMP summary

Robustness Value 2
No. of Group x Interfaces 61
Maximum number of Group x Interfaces 50000

Supported Interfaces   : 18
Unsupported Interfaces : 2
Enabled Interfaces     : 18
Disabled Interfaces    : 2

Interface                 Grp No    Max Grp No
MgmtEth0/RSP0/CPU0/0       0         25000 
Loopback0                 4         25000 
Bundle-Ether28            3         25000 
Bundle-Ether28.1          3         25000 
Bundle-Ether28.2          3         25000 
Bundle-Ether28.3          3         25000 
MgmtEth0/RP1/CPU0/0       0         25000 
GigabitEthernet0/1/5/0    3         25000 
GigabitEthernet0/1/5/1    5         25000 
GigabitEthernet0/1/5/2    5         25000 
GigabitEthernet0/6/5/1    3         25000 
GigabitEthernet0/6/5/2    3         25000 
GigabitEthernet0/6/5/7    3         25000 

RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# router igmp
RP/0/RSP0/CPU0:router(config-igmp)# maximum groups-per-interface 5
RP/0/RSP0/CPU0:router(config-igmp)# commit


RP/0/RSP0/CPU0:router# show igmp summary 

Robustness Value 2
No. of Group x Interfaces 61
Maximum number of Group x Interfaces 65

Supported Interfaces   : 18
Unsupported Interfaces : 2
Enabled Interfaces     : 18
Disabled Interfaces    : 2

Interface                 Grp No    Max Grp No
MgmtEth0/RSP0/CPU0/0       0         5     
Loopback0                 4         5     
Bundle-Ether28            3         5     
Bundle-Ether28.1          3         5     
Bundle-Ether28.2          3         5     
Bundle-Ether28.3          3         5     
MgmtEth0/RP1/CPU0/0       0         5     
GigabitEthernet0/1/5/0    3         5     
GigabitEthernet0/1/5/1    5         5     
GigabitEthernet0/1/5/2    5         5     
GigabitEthernet0/6/5/1    3         5     
GigabitEthernet0/6/5/2    3         5     
GigabitEthernet0/6/5/7    3         5     

The following example shows how to configure all interfaces with 3000 maximum groups per interface except GigabitEthernet interface 0/4/0/0, which is set to 4000:


RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# router igmp
RP/0/RSP0/CPU0:router(config-igmp)# maximum groups-per-interface 3000
RP/0/RSP0/CPU0:router(config-igmp)# interface GigabitEthernet 0/4/0/0
RP/0/RSP0/CPU0:router(config-igmp-default-if)# maximum groups-per-interface 4000
IGMP summary

Robustness Value 2
No. of Group x Interfaces 61
Maximum number of Group x Interfaces 50000

Supported Interfaces   : 18
Unsupported Interfaces : 2
Enabled Interfaces     : 18
Disabled Interfaces    : 2

Interface                 Grp No    Max Grp No
MgmtEth0/RP0/CPU0/0       0         25000 
Loopback0                 4         25000 
Bundle-POS24              3         25000 
Bundle-Ether28            3         25000 
Bundle-Ether28.1          3         25000 
Bundle-Ether28.2          3         25000 
Bundle-Ether28.3          3         25000 
MgmtEth0/RP1/CPU0/0       0         25000 
GigabitEthernet0/1/5/0    3         25000 
GigabitEthernet0/1/5/1    5         25000 
GigabitEthernet0/1/5/2    5         25000 
POS0/1/0/1                5         25000 
POS0/1/4/2                3         25000 
GigabitEthernet0/6/5/1    3         25000 
GigabitEthernet0/6/5/2    3         25000 
GigabitEthernet0/6/5/7    3         25000 
POS0/6/0/1                3         25000 
POS0/6/4/4                3         25000 
POS0/6/4/5                3         25000 
POS0/6/4/6                3         25000 

RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# router igmp
RP/0/RSP0/CPU0:router(config-igmp)# maximum groups-per-interface 5
RP/0/RSP0/CPU0:router(config-igmp)# commit
RP/0/RSP0/CPU0:router# show igmp summary

Robustness Value 2
No. of Group x Interfaces 61
Maximum number of Group x Interfaces 65

Supported Interfaces   : 18
Unsupported Interfaces : 2
Enabled Interfaces     : 18
Disabled Interfaces    : 2

Interface                 Grp No    Max Grp No
MgmtEth0/RP0/CPU0/0       0         5     
Loopback0                 4         5     
Bundle-POS24              3         5     
Bundle-Ether28            3         5     
Bundle-Ether28.1          3         5     
Bundle-Ether28.2          3         5     
Bundle-Ether28.3          3         5     
MgmtEth0/RP1/CPU0/0       0         5     
GigabitEthernet0/1/5/0    3         5     
GigabitEthernet0/1/5/1    5         5     
GigabitEthernet0/1/5/2    5         5     
POS0/1/0/1                5         5     
POS0/1/4/2                3         5     
GigabitEthernet0/6/5/1    3         5     
GigabitEthernet0/6/5/2    3         5     
GigabitEthernet0/6/5/7    3         5     
POS0/6/0/1                3         5     
POS0/6/4/4                3         5     
POS0/6/4/5                3         5     
POS0/6/4/6                3         5 

RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# router igmp
RP/0/RSP0/CPU0:router(config-igmp)# maximum groups-per-interface 3000
RP/0/RSP0/CPU0:router(config-igmp)# interface POS 0/4/0/0
RP/0/RSP0/CPU0:router(config-igmp-default-if)# maximum groups-per-interface 4000

nsf lifetime (IGMP)

To configure the maximum time for the nonstop forwarding (NSF) timeout on the Internet Group Management Protocol (IGMP) process, use the nsf lifetime command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.

nsf lifetime seconds

Syntax Description

seconds

Maximum time for NSF mode. Range is 10 to 3600 seconds.

Command Default

seconds : 60

Command Modes

IGMP configuration

IGMP VRF configuration

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

The IGMP NSF process is triggered by the restart of the IGMP process. While in IGMP NSF mode, the Multicast Routing Information Base (MRIB) purges the routes installed by the previous IGMP process when the IGMP NSF process times out.

The IGMP NSF lifetime is the period for IGMP to relearn all the host membership of the attached network through membership queries and reports. During this NSF period, PIM continues to maintain forwarding state for the local members while IGMP recovers their membership reports.

Additionally, IGMP recovers the internal receiver state from Local Packet Transport Services (LPTS) for IP group member applications (including the Session Announcement Protocol (SAP) Listener) and updates the MRIB.

Task ID

Task ID

Operations

multicast

read, write

Examples

The following example shows how to set the IGMP NSF timeout value to 120 seconds:


RP/0/RSP0/CPU0:router(config)# router igmp
RP/0/RSP0/CPU0:router(config-igmp)# nsf lifetime 120 

query-interval

To configure the frequency at which the Cisco IOS XR Software sends Internet Group Management Protocol (IGMP) host-query messages, use the queryinterval command in the appropriate configuration mode. To return to the default frequency, use the no form of this command.

query-interval seconds

Syntax Description

seconds

Frequency used to send IGMP host-query messages. Range is 1 to 3600.

Command Default

If this command is not specified in interface configuration mode, the interface adopts the query interval parameter specified in IGMP configuration mode.

If this command is not specified in IGMP configuration mode, the query interval time is 60 seconds.

Command Modes

IGMP VRF configuration

IGMP interface configuration

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

Multicast routers send host membership query messages (host-query messages) to discover which multicast groups have members on the attached networks of the router. Hosts respond with IGMP report messages indicating that they want to receive multicast packets for specific groups (that is, that the host wants to become a member of the group). Host-query messages are addressed to the all-hosts multicast group, which has the address 224.0.0.1, and has an IP time-to-live (TTL) value of 1.

The designated router for a LAN is the only router that sends IGMP host-query messages:

  • For IGMP Version 1 (only), the designated router is elected according to the multicast routing protocol that runs on the LAN.
  • For IGMP Versions 2 and 3, , the designated querier is the lowest IP-addressed multicast router on the subnet.

If the router hears no queries for the timeout period (controlled by the query-timeout command), it becomes the querier.


Note


Changing the value of the seconds argument may severely impact network performance. A short query interval may increase the amount of traffic on the attached network, and a long query interval may reduce the querier convergence time.



Note


If you configure the query-interval command in IGMP configuration mode, parameters are inherited by all new and existing interfaces. You can override these parameters on individual interfaces from interface configuration mode.


Task ID

Task ID

Operations

multicast

read, write

Examples

This example shows how to change the frequency at which the designated router sends IGMP host-query messages to 2 minutes:


RP/0/RSP0/CPU0:router(config)# router igmp 
RP/0/RSP0/CPU0:router(config-igmp)# interface gigabitEthernet

0/1/0/0 
RP/0/RSP0/CPU0:router(config-igmp-default-if)# query-interval 120

query-max-response-time

To configure the maximum response time advertised in Internet Group Management Protocol (IGMP) queries, use the querymax-response-time command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.

query-max-response-time seconds

Syntax Description

seconds

Maximum response time, in seconds, advertised in IGMP queries. Range is 1 to 12.

Command Default

If this command is not specified in interface configuration mode, the interface adopts the maximum response time parameter specified in IGMP configuration mode.

If this command is not specified in IGMP configuration mode, the maximum response time is 10 seconds.

Command Modes

IGMP VRF configuration

IGMP interface configuration

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

The query-max-response-time command is not supported on IGMP Version 1.

This command is used to control the maximum response time for hosts to answer an IGMP query message. Configuring a value less than 10 seconds enables the router to prune groups much faster, but this action results in network burstiness because hosts are restricted to a shorter response time period.

If you configure this command in IGMP configuration mode, parameters are inherited by all new and existing interfaces. You can override these parameters on individual interfaces in interface configuration mode.


Note


If the hosts do not read the maximum response time in the query message correctly, group membership might be pruned inadvertently. Therefore, the hosts must know to respond faster than 10 seconds (or the value you configure).


Task ID

Task ID

Operations

multicast

read, write

Examples

The following example shows how to configure a maximum response time of 8 seconds:


RP/0/RSP0/CPU0:router(config)# router igmp 
RP/0/RSP0/CPU0:router(config-igmp)# interface gigabitEthernet 0/1/0/0 
RP/0/RSP0/CPU0:router(config-igmp-default-if)# query-max-response-time 8

query-timeout

To configure the timeout value before the router takes over as the querier for the interface, use the query-timeout command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.

query-timeout seconds

Syntax Description

seconds

Number of seconds that the router waits after the previous querier has stopped querying before it takes over as the querier. Range is 60 to 300.

Command Default

If this command is not specified in interface configuration mode, the interface adopts the timeout value parameter specified in IGMP VRF configuration mode. If this command is not specified in IGMP VRF configuration mode, the maximum response time is equal to twice the query interval set by the query-interval command.

Command Modes

IGMP VRF configuration

IGMP interface configuration

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

The query timeout command is not supported on Internet Group Management Protocol (IGMP) Version 1.

By default, the router waits twice the query interval specified by the query-interval command, after which, if the router has heard no queries, it becomes the querier. By default, the query interval is 60 seconds, which means that the query timeout value defaults to 120 seconds.

If you configure a query timeout value less than twice the query interval, routers in the network may determine a query timeout and take over the querier without good reason.


Note


If you configure this command in IGMP configuration mode, parameters are inherited by all new and existing interfaces. You can override these parameters on individual interfaces in interface configuration mode.


Task ID

Task ID

Operations

multicast

read, write

Examples

The following example shows how to configure the router to wait 30 seconds from the time it received the last query before it takes over as the querier for the interface:


RP/0/RSP0/CPU0:router(config)# router igmp 
RP/0/RSP0/CPU0:router(config-igmp)# interface gigabitEthernet 0/1/0/0 
RP/0/RSP0/CPU0:router(config-igmp-default-if)# query-timeout 30

robustness-count

To set the robustness variable to tune for expected packet loss on a network, use the robustness-count command in the appropriate configuration mode. To return to the default setting, use the no form of this command.

robustness-count count

Syntax Description

count

Value of the robustness count variable. Range is 2 to 10 packets.

Command Default

Default is 2 packets.

Command Modes

IGMP VRF configuration

IGMP interface configuration

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

IGMP is a soft-state protocol. State must be periodically refreshed or it times out. At a robustness-count command setting, for example, of 4, a network might lose three IGMP packets related to some specific state yet still maintain the state. If, however, a network lost more than three IGMP packets in the sequence, the state would time out. You might then consider changing the robustness-count setting to maintain state.

Task ID

Task ID

Operations

multicast

read, write

Examples

The following example illustrates the use of the robustness-count command:


RP/0/RSP0/CPU0:router(config)# configure
RP/0/RSP0/CPU0:router(config)# router igmp
RP/0/RSP0/CPU0:router(config-igmp)# robustness-count 2

router

To disable or enable Internet Group Management Protocol (IGMP) membership tracking, use the router command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.

router {disable | enable}

Syntax Description

disable

Turns off IGMP membership tracking.

enable

Turns on IGMP membership tracking.

Command Default

If this command is not specified in IGMP VRF configuration mode, router functionality is enabled on all interfaces.

Command Modes

IGMP interface configuration

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

The router command is used to enable and disable the IGMP router functionality on a specific interface. For instance, IGMP stops queries from an interface when the router functionality is disabled on that interface. Disabling IGMP router functionality does not prevent local group membership from being announced through the group membership report.


Note


This command is useful if you want to disable or enable IGMP interfaces that have been previously enabled through the multicast-routing command.


Task ID

Task ID

Operations

multicast

read, write

Examples

The following example shows how to enable IGMP membership tracking functionality on all multicast enabled interfaces, except Packet-over-SONET/SDH (POS) interface 0/1/0/0:


RP/0/RSP0/CPU0:router(config)# router igmp 
RP/0/RSP0/CPU0:router(config-igmp)# interface gigabitEthernet 0/1/0/0 
RP/0/RSP0/CPU0:router(config-igmp-default-if)# router enable

router igmp

To enter Internet Group Management Protocol (IGMP) configuration mode, use the router igmp command in

global

configuration mode. To return to the default behavior, use the no form of this command.

router igmp

Syntax Description

This command has no keywords or arguments.

Command Default

No default behavior or values

Command Default

Global configuration

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

From IGMP VRF configuration mode, you can configure the maximum response time advertised in IGMP queries and modify the host query interval.


Note


The IGMP process is turned on when the router igmp command or the multicast-routing command is initiated.


Task ID

Task ID

Operations

multicast

read, write

Examples

The following example shows how to enter IGMP configuration mode:


RP/0/RSP0/CPU0:router(config)# router igmp
RP/0/RSP0/CPU0:router(config-igmp)# 

router igmp vrf

To configure route-policy to be used to map the bandwidth profile, use the router igmp vrf command in the Global Configuration mode. To disable this feature, use the no form of this command.

router igmp vrf vrf_name {traffic | profile | profile_name}

Syntax Description

vrf_name

Specifies the VRF name.

traffic

Configures IGMP traffic variables.

profile

Configures route-policy to be used to map the bandwidth profile.

profile_name

Specifies the profile name.

Command Default

None

Command Modes

Global Configuration mode

Command History

Release Modification

Release 4.2.0

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation

multicast

read, write

Examples

This is an example of configuring the router igmp vrf command in the Global Configuration mode:


RP/0/RSP0/CPU0:router # configure
RP/0/RSP0/CPU0:router(config)# router igmp vrf vrf1
RP/0/RSP0/CPU0:router(config)# router igmp vrf vrf1 traffic profile prof-name

show igmp groups

To display the multicast groups that are directly connected to the router and that were learned through Internet Group Management Protocol (IGMP), use the show igmp groups command in

EXEC

mode.

show igmp [vrf vrf-name] groups [group-address | type interface-path-id | not-active | summary] [detail] [explicit]

Syntax Description

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

group-address

(Optional) Address or name of the multicast group. An address is a multicast IP address in four-part dotted-decimal notation. A name is as defined in the Domain Name System (DNS) hosts table.

type

(Optional) Interface type. For more information, use the question mark (?) online help function.

interface-path-id

(Optional) Either a physical interface or a virtual interface.

Note

 

Use the show interfaces command in EXEC mode to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (?) online help function.

not-active

(Optional) Displays group joins that are not processed.

summary

(Optional) Displays the total number of (* , G) and (S, G) states in IGMP.

detail

(Optional) Displays detail information such as IGMP Version 3 source list, host, and router mode.

explicit

(Optional) Displays explicit tracking information.

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

If you omit all optional arguments, the show igmp groups command displays (by group address and interface name) all the multicast memberships that the directly connected networks have subscribed.

Task ID

Task ID

Operations

multicast

read

Examples

The following is sample output from the show igmp groups command on a specific (tenGigE) interface:


RP/0/RSP0/CPU0:router# show igmp groups tenGigE 0/4/0/0

IGMP Connected Group Membership
Group Address   Interface                     Uptime    Expires   Last Reporter
224.0.0.2       TenGigE0/4/0/0                3w6d      never     10.114.8.44
224.0.0.5       TenGigE0/4/0/0                3w6d      never     10.114.8.44
224.0.0.6       TenGigE0/4/0/0                3w6d      never     10.114.8.44
224.0.0.13      TenGigE0/4/0/0                3w6d      never     10.114.8.44
224.0.0.22      TenGigE0/4/0/0                3w6d      never     10.114.8.44

This table describes the significant fields shown in the display.

Table 1. show igmp groups Field Descriptions

Field

Description

Group Address

Address of the multicast group.

Interface

Interface through which the group is reachable.

Uptime

How long (in hours, minutes, and seconds) this multicast group has been known.

Expires

How long (in hours, minutes, and seconds) until the entry is removed from the IGMP groups table.

Last Reporter

Last host to report being a member of the multicast group.

show igmp interface

To display Internet Group Management Protocol (IGMP) multicast-related information about an interface, use the show igmp interface command in EXEC

mode.

show igmp [vrf vrf-name] interface [type inteface-path-id | state-on | state-off]

Syntax Description

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

type

(Optional) Interface type. For more information, use the question mark (?) online help function.

interface-path-id

(Optional) Either a physical interface or a virtual interface.

Note

 

Use the show interfaces command in EXEC mode to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (?) online help function.

state-on

(Optional) Displays all interfaces with IGMP enabled.

state-off

(Optional) Displays all interfaces with IGMP disabled.

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

If you omit the optional arguments, the show igmp interface command displays information about all interfaces.

Task ID

Task ID

Operations

multicast

read

Examples

The following is sample output from the show igmp interface command:


RP/0/RSP0/CPU0:router# show igmp interface

Loopback0 is up, line protocol is up
  Internet address is 10.144.144.144/32
  IGMP is enabled on interface
  Current IGMP version is 3
  IGMP query interval is 60 seconds
  IGMP querier timeout is 125 seconds
  IGMP max query response time is 10 seconds
  Last member query response interval is 1 seconds
  IGMP activity: 3 joins, 0 leaves
  IGMP querying router is 10.144.144.144 (this system)
TenGigE0/4/0/0 is up, line protocol is up
  Internet address is 10.114.8.44/24
  IGMP is enabled on interface
  Current IGMP version is 3
  IGMP query interval is 60 seconds
  IGMP querier timeout is 125 seconds
  IGMP max query response time is 10 seconds
  Last member query response interval is 1 seconds
  IGMP activity: 9 joins, 4 leaves
  IGMP querying router is 10.114.8.11 
Bundle-Ether16.162 is up, line protocol is up
  Internet address is 10.194.8.44/24
  IGMP is disabled on interface
Bundle-Ether16.163 is up, line protocol is up
  Internet address is 10.194.12.44/24
  IGMP is disabled on interface
GigabitEthernet0/1/0/2 is up, line protocol is up
  Internet address is 10.147.4.44/24
  IGMP is enabled on interface
  Current IGMP version is 3
  IGMP query interval is 60 seconds
  IGMP querier timeout is 125 seconds
  IGMP max query response time is 10 seconds
  Last member query response interval is 1 seconds
  IGMP activity: 6 joins, 0 leaves
  IGMP querying router is 10.147.4.44 (this system)
GigabitEthernet0/1/0/8 is up, line protocol is up
  Internet address is 10.146.4.44/24
  IGMP is enabled on interface
  Current IGMP version is 3
  IGMP query interval is 60 seconds
  IGMP querier timeout is 125 seconds
  IGMP max query response time is 10 seconds
  Last member query response interval is 1 seconds
  IGMP activity: 5 joins, 0 leaves
  IGMP querying router is 10.146.4.44 (this system)
GigabitEthernet0/1/0/18 is up, line protocol is up
  Internet address is 10.194.4.44/24
  IGMP is enabled on interface
  Current IGMP version is 3
  IGMP query interval is 60 seconds
  IGMP querier timeout is 125 seconds
  IGMP max query response time is 10 seconds
  Last member query response interval is 1 seconds
  IGMP activity: 7 joins, 2 leaves
  IGMP querying router is 10.194.4.19 
GigabitEthernet0/1/0/23 is up, line protocol is up
  Internet address is 10.114.4.44/24
  IGMP is enabled on interface
  Current IGMP version is 3
  IGMP query interval is 60 seconds
  IGMP querier timeout is 125 seconds
  IGMP max query response time is 10 seconds
  Last member query response interval is 1 seconds
  IGMP activity: 9 joins, 4 leaves
  IGMP querying router is 10.114.4.11 
GigabitEthernet0/1/0/27 is up, line protocol is up
  Internet address is 10.145.4.44/24
  IGMP is enabled on interface
  Current IGMP version is 3
  IGMP query interval is 60 seconds
  IGMP querier timeout is 125 seconds
  IGMP max query response time is 10 seconds
  Last member query response interval is 1 seconds
  IGMP activity: 7 joins, 2 leaves
  IGMP querying router is 10.145.4.44 (this system)

This table describes the significant fields shown in the display.

Table 2. show igmp interface Field Descriptions

Field

Description

Loopback0 is up, line protocol is up

Interface type, number, and status.

Internet address is

Internet address of the interface and subnet mask being applied to the interface, as specified with the address command.

IGMP is enabled on interface

Indicates whether IGMP router functionality has been enabled on the interface.

Note

 

Multicast protocols do not run on Management Ethernet interfaces even if they are enabled with the CLI.

IGMP query interval is 60 seconds

Interval at which the Cisco IOS XR software software sends Protocol Independent Multicast (PIM) query messages, as specified with the query-interval command.

IGMP querier timeout is...

Timeout that is set by nonquerier routers. When this timeout expires, the nonquerier routers begin to send queries.

IGMP max query response time is...

Query response time, in seconds, that is used by administrators to tune the burstiness of IGMP messages on the network. This is the maximum time within which a response to the query is received.

Last member query response is...

Query response time in seconds since a host replied to a query that was sent by the querier.

IGMP activity:

Total number of joins and total number of leaves received.

IGMP querying router is 239.122.41.51 (this system)

Indicates the elected querier on the link.

show igmp nsf

To display the state of the nonstop forwarding (NSF) operation in Internet Group Management Protocol (IGMP), use the show igmp nsf command in EXEC mode

.

show igmp [vrf vrf-name] nsf

Syntax Description

old-output

(Optional) Displays the old show output—available for backward compatibility.

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

The show igmp nsf command displays the current multicast NSF state for IGMP. The NSF state that is displayed may be either normal or activated for NSF. The activated state indicates that recovery is in progress due to an IGMP failure. The total NSF timeout and time remaining are displayed until NSF expiration.

Task ID

Task ID

Operations

multicast

read

Examples

The following is sample output from the show igmp nsf command:


RP/0/RSP0/CPU0:router# show igmp nsf 

IGMP_AFD 
Non-Stop Forwarding Status: Multicast routing state: Normal


NSF Lifetime
:       00:01
:00

This table describes the significant fields shown in the display.

Table 3. show igmp nsf Field Descriptions

Field

Description

Multicast routing state

Multicast NSF status of IGMP (Normal or Non-Stop Forwarding Activated).

NSF Lifetime

Timeout for IGMP NSF. IGMP remains in the NSF state, recovering the IGMP route state through IGMP reports for this period of time, before making the transition back to the normal state and signaling the Multicast Routing Information Base (MRIB).

NSF Time Remaining

If IGMP NSF state is activated, the time remaining until IGMP reverts to Normal mode displays.

show igmp nsr

To display the nonstop routing (NSR) information in Internet Group Management Protocol (IGMP), use the show igmp nsr command in EXEC mode

.

show igmp [ ipv4| ipv6 ] ipv4| ipv6 nsr

Syntax Description

ipv4

(Optional) Specifies IPv4 address prefixes.

ipv6

(Optional) Specifies IPv6 address prefixes

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 5.2.2

This command was introduced.

Usage Guidelines

The show igmp nsr command displays the current multicast NSR information for IGMP. The NSR state that is displayed may be either normal or activated for NSR. The activated state indicates that recovery is in progress due to an IGMP failure. The total NSR timeout and time remaining are displayed until NSR expiration.

Task ID

Task ID

Operations

multicast

read

Examples

The following is sample output from the show igmp nsr command:


RP/0/RSP0/CPU0:router# show igmp nsr

IGMP NSR Data :-
NSR State                      : Not Ready (uptime 4w0d)
Converged with collaborators   : Y
Partner connection state       : Not-coverged/Down
RMF Notif done                 : Y
Last RMF ready notified        : Never [0]
Last RMF not ready notifed     : 4w0d [1]
Last partner process conn up   : Never [0]
Last partner process conn down : Never [0]

This table describes the significant fields shown in the display.

Table 4. show igmp nsr Field Descriptions

Field

Description

NSR State

Multicast Non-Stop Routing State: Ready or Not Ready

Converged with collaborators

Yes or No

Partner connection state

Converged/Yes or Non-converged/No

RMF Notif done

RMF notification whether activated: Yes or No

Last RMF ready notified

The Time when the last RMF ready notification was received: Yes, No, or Never.

The number in the brackets indicate the number of times the RMF ready notification was received.

Last RMF not ready notified

The Time when the last RMF not ready notification was received: Yes, No, or Never.

The number in the brackets indicate the number of times the RMF ready notification was received.

show igmp summary

To display group membership information for Internet Group Management Protocol (IGMP), use the show igmp summary command in EXEC mode

.

show igmp [vrf vrf-name] summary

Syntax Description

old-output

(Optional) Displays the old show output—available for backward compatibility.

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

The show igmp summary command is used to display the total group membership. The value for number of groups is the total number of group members on all interfaces. The value for maximum number of groups is the total number of external and local members possible for all interfaces. The maximum number of groups and the default value for the maximum number of groups is 50000 members. The maximum number of groups for each interface, and the default value for the maximum number of groups for each interface, is 25000 members.

Task ID

Task ID

Operations

multicast

read

Examples

The following example shows the number of groups for each interface that are IGMP members and the maximum number of groups that can become members on each interface:


RP/0/RSP0/CPU0:router# show igmp summary

IGMP summary

Robustness Value 2
No. of Group x Interfaces 61
Maximum number of Group x Interfaces 65

Supported Interfaces   : 18
Unsupported Interfaces : 2
Enabled Interfaces     : 18
Disabled Interfaces    : 2


Interface 

Grp No 

 Max Grp No
Bundle-Ether28.1          3         5     
MgmtEth0/RSP0/CPU0/0 

0 
        5     
Loopback0 

        4 
        5     
MgmtEth0/RP1/CPU0/0       0         5     
Bundle-Ether28         
   3         5     
Bundle-Ether28         

3 
        5     
Bundle-Ether28.1       

3 
        5     
Bundle-Ether28.2 

3 
        5     
Bundle-Ether28.3 
         3         5     
MgmtEth0
/RP1
/CPU0
/0 

    0 
        5     
GigabitEthernet0/1
/5/0 
   3         5     
GigabitEthernet0/1
/5/1 

5 
        5     
GigabitEthernet0
/1
/5
/2 

5 
        5     
GigabitEthernet0
/6/5
/1 
   3         5     
GigabitEthernet0
/6/5
/2 
   3         5     
GigabitEthernet0
/6/5
/7 
   3         5     

This table describes the significant fields shown in the display.

Table 5. show igmp summary Field Descriptions

Field

Description

No. of Group x Interfaces

Number of multicast groups that are joined through the interface.

Maximum number of Group x Interfaces

Maximum number of multicast groups that can be joined through the interface.

Supported Interfaces

Interfaces through which the multicast groups are reachable.

Unsupported Interfaces

Number of unsupported interfaces.

Enabled Interfaces

Number of enabled interfaces.

Disabled Interfaces

Number of disabled interfaces.

show igmp ssm map

To query the source-specific mapping (SSM) state, use the show igmp ssm map command in

EXEC mode

.

show igmp [vrf vrf-name] ssm map [group-address] [detail]

Syntax Description

vrf

(Optional) Specifies a VPN routing and forwarding (VRF) instance to be queried.

vrf-name

(Optional) Specifies the name of the specific VRF instance.

group-address

(Optional) Specifies the address of the SSM group for which to obtain the mapping state.

detail

(Optional) Displays detailed source information.

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Task ID

Task ID

Operations

multicast

read

Examples

The following example illustrates the use of the show igmp ssm map command:


RP/0/RSP0/CPU0:router# show igmp ssm map 232.1.1.1 


232.1.1.1 is static with 1 source

show igmp traffic

To display all the Internet Group Management Protocol (IGMP) traffic-related counters, use the show igmp traffic command in EXEC mode

.

show igmp [vrf vrf-name] traffic

Syntax Description

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

Command Default

No default behavior or values

Command Modes

EXEC

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

The show igmp traffic command is used to display the state of all counters for IGMP traffic. It gives information about the length of time the counters have been active and the count of different types of IGMP packets received, such as queries, leaves, and reports. Also, this command keeps a count of all the erroneous IGMP packets received.

Task ID

Task ID

Operations

multicast

read

Examples

The following is sample output from the show igmp traffic command:


RP/0/RSP0/CPU0:router# show igmp traffic 

IGMP Traffic Counters
Elapsed time since counters cleared: 15:27:38

                                  Received        Sent
Valid IGMP Packet                     2784        5576
Queries                               0           2784
Reports                               2784        2792
Leaves                                0           0
Mtrace packets                        0           0
DVMRP packets                         0           0
PIM packets                           0           0

Errors:
Malformed Packets                                 0
Bad Checksums                                     0
Socket Errors                                     0
Bad Scope Errors                                  0
Auxiliary Data Len Error                          0
Subnet Errors                                     0
Packets dropped due to invalid socket             0
Packets which couldn’t be accessed                0

This table describes the significant fields shown in the display for the show igmp traffic command.

Table 6. show igmp traffic Field Descriptions

Field

Description

Valid IGMP Packet

Total number of valid protocol packets sent and received. Valid packet types include:

  • Queries
  • Membership reports
  • Leaves

Queries

Total number of query packets sent and received. IP Multicast routers send queries to determine the multicast reception state of neighboring interfaces.

Reports

Total number of membership report packets received. Membership reports indicate either the current multicast reception state of a neighboring interface or a change to that state.

Leaves

Total number of leaves received. A leave group packet indicates a neighboring interface no longer has multicast reception state for a particular group.

Mtrace packets

Total number of Mtrace packets sent and received. Mtrace traces the route from a receiver to a source using a particular multicast address.

DVMRP packets

Total number of Distance Vector Multicast Routing Protocol (DVMRP) packets sent and received. DVMRP is an Internet routing protocol that provides a mechanism for connectionless datagram delivery to a group of hosts across an internetwork. This protocol dynamically generates IP multicast delivery trees using Reverse Path Multicasting. Packet type 0x13 indicates a DVMRP packet.

PIM packets

Total number of sent and received Protocol Independent Multicast (PIM) packets.

Malformed Packets

Total number of malformed packets received. A malformed packet is a packet smaller than the smallest valid protocol packet.

Bad Checksums

Total number of packets received with a bad protocol header checksum.

Socket Errors

Total number of read and write failures on the protocol socket.

Bad Scope Errors

Total number of packets received with an invalid multicast scope.

Note

 

IGMP has no invalid scopes; this counter, therefore, never increments in IGMP.

Auxiliary Data Len Errors

Total number of packets received with a non-zero auxilary data length.

Subnet Errors

Total number of packets received that were not sourced on the same subnet as the router.

DVMRP and MTRACE packets received are not checked for this error as they may be validly sourced from a different subnet.

Packets dropped due to invalid socket

Total number of packets dropped due to an invalid socket.

Packets which couldn’t be accessed

Total number of packets that could not be sent or received.

This might occur if:

  • Packet buffer does not form a valid protocol packet.
  • IP header is not written to the packet.
  • Outgoing packet interface handle was not set.
  • Errors occurred calculating the protocol checksum.

Other Packet Drops

Packets dropped for any other reason.

show igmp unicast-qos-adjust statistics

To show the statistics of the unicast-qos-adjusted feature, use the show igmp unicast-qos-adjust statistics command in the EXEC mode.

show igmp unicast-qos-adjust statistics[ interface type interface-path-id ]

Syntax Description

interface

(Optional). Displays the interface specific information such as name of the interface, number of flows adjusted, total rate adjusted, and uptime after first adjustment, in a tabular format. If the interface is specified, then the interface specific statistics are displayed with table of 5 latest updates.

|

Specifies the output modifiers.

Command Default

None

Command Modes

EXEC mode

Command History

Release Modification

Release 4.2.0

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation

multicast

read

Examples

This is the sample output of the show igmp unicast-qos-adjust statistics command:


RP/0/RSP0/CPU0:router# show igmp unicast-qos-adjust statistics

The show igmp unicast-qos-adjust statistics output is as follows:


Mon Feb  4 08:47:01.640 GMT

IGMP to QoS Batch stats
Current Queue count                           : 0
Last IGMP-to-QOS Batch count                  : 0
Last IGMP-to-QOS Batch errors                 : 0
Interfaces added to queue(all batches)        : 0
Interfaces removed from queue(all batches)    : 0

IGMP to QoS message send stats
Number of Send Success                        : 1
Number of Send Error COMMS                    : 0
Number of Send Error Partial                  : 0
Time elapsed since last download              : 3w0d

Resync stats
Is RESYNC required                            : No
Is RESYNC REQUEST received                    : No
Is RESYNC START message sent                  : No
Has Mark&Sweep happened anytime               : Yes
Time elapsed since last mark and sweep        : 3w0d

This table describes the significant fields shown in the display.

Table 7. show igmp unicast-qos-adjust statistics Field Descriptions

Field

Description

IGMP to QoS Batch stats

Specifies the batch statistics details for IGMP to QoS, such as current queue count, batch counter, batch errors, number of interfaces added to the queue, and the number of interfaces removed from the queue.

IGMP to QoS message send stats

Specifies the send statistics details for IGMP to QoS, such as number of send messages that was successful, number of send messages that had errored, number of send messages that had partially errored, and time elapsed since the last download.

Resync stats

Specifies the detailed information on the resynchronization statistics, such as whether resync is required, if the resync request was received, if the resync start message was sent, if mark and sweep for the resync has taken place, and time elapsed since the last mark and sweep.

show igmp vrf

To show the igmp vrf specific information, use the show igmp vrf command in the EXEC mode.

show igmp vrf vrf_name {groups | interface | nsf | ranges | ssm | summary | traffic | unicast-qos-adjusted}

Syntax Description

vrf

Shows the vrf information for igmp unicast qos shaper.

vrf_name

Specifies the vrf name.

groups

Shows the igmp group membership information.

interface

Shows igmp interface information.

nsf

Shows igmp nsf status.

ranges

Shows igmp group-map ranges.

ssm

Shows ssm related information.

summary

Shows igmp summary information.

traffic

Show igmp traffic counters.

unicast-qos-adjusted

Shows igmp unicast qos shaper.

Command Default

None

Command Modes

EXEC mode

Command History

Release Modification

Release 4.2.0

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation

multicast

read

Examples

This is the sample output of the show igmp vrf command:


RP/0/RSP0/CPU0:router#show igmp vrf vrf1 summary

The show igmp vrf vrf1 summary output is as follows:


Thu Feb  7 10:02:24.457 GMT
Robustness Value 2
No. of Group x Interfaces 10
Maximum number of Group x Interfaces 50000

Supported Interfaces   : 2
Unsupported Interfaces : 0
Enabled Interfaces     : 2
Disabled Interfaces    : 0

MTE tuple count        : 0

Interface                       Number  Max #
                                          Groups  Groups
BVI1                                       7       10
Loopback1001                    3       25000

RP/0/RSP0/CPU0:router#show igmp vrf vrf1 interface bvi1

Thu Feb  7 10:02:48.231 GMT

BVI1 is up, line protocol is up
  Internet address is 172.16.251.1/30
  IGMP is enabled on interface
  Current IGMP version is 3
  IGMP query interval is 60 seconds
  IGMP querier timeout is 125 seconds
  IGMP max query response time is 10 seconds
  Last member query response interval is 1 seconds
  IGMP activity: 26 joins, 19 leaves
  IGMP querying router is 172.16.251.1 (this system)
  Time elapsed since last query sent 00:00:41
  Time elapsed since IGMP router enabled 3w3d
  Time elapsed since last report received 00:00:32

This table describes the significant fields shown in the display.

Table 8. show igmp vrf Field Descriptions

Field

Description

Supported Interfaces

Specifies the number of supported interfaces.

Unsupported Interfaces

Specifies the number of unsupported interfaces.

Enabled Interfaces

Specifies the number of interfaces that are enabled.

Disabled Interfaces

Specifies the number of interfaces that are disabled.

show igmp vrf vrf_name groups

To display the IGMP group membership information, use the show igmp vrf vrf_name groups command in the EXEC mode.

show igmp vrf vrf_name groups ip_address

Syntax Description

ip_address

Specifies the IP address or group address.

Command Default

No default behavior or values

Command Modes

EXEC mode

Command History

Release Modification

Release 4.2.1

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation

multicast

read

Examples


RP/0/RSP0/CPU0:router# show igmp vrf vrf1 groups 232.1.1.1
IGMP Connected Group Membership
Group Address   Interface                     Uptime    Expires   Last Reporter
232.1.1.1       tunnel-mte1                   12:39:31  never     110.110.110.110

ssm map

To map group memberships from legacy hosts in Source-Specific Multicast (SSM) groups accepted by an access control list (ACL) to a Protocol Independent Multicast (PIM)-SSM source or to configure DNS mapping for PIM-SSM sources to a set of SSM groups, use the ssm map command in the appropriate configuration mode. To revert to default behavior, use the no form of this command.

ssm map { static source-address access-list | query dns }

Syntax Description

source-address

PIM-SSM source address to be used to create a static mapping.

access-list

ACL specifying the groups to be used to create a static mapping.

query

Configure a mapping of sources to groups quering external database.

dns

Configure a DNS mapping for sources to a set of SSM groups.

Command Default

Legacy host membership reports in the SSM group range are discarded and DNS-based SSM mapping is not enabled.

Command Modes

IGMP VRF configuration

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Release 5.3.2

The keywords "query" and "DNS" were introduced to configure DNS-based SSM mapping.

Usage Guidelines

PIM-SSM requires the use of IGMPv3 (IPv4) to determine local memberships. Under normal operating conditions, IGMP discards older version group membership reports for groups in the SSM group range. This means that a host with a legacy group membership protocol is unable to receive data from a PIM-SSM source.

The ssm map static command maps an older group membership report to a set of PIM-SSM sources. If the ACL associated with a configured source accepts the SSM group, then that source is included in its set of sources for the SSM group.

Task ID

Task ID

Operations

multicast

read, write

Examples

The following example shows PIM-SSM mapping in IGMP routing configuration mode:


RP/0/RSP0/CPU0:router(config)# configuration
RP/0/RSP0/CPU0:router(config)# router igmp
RP/0/RSP0/CPU0:router(config-igmp)# ssm map static 10.0.0.1 mc2 
RP/0/RSP0/CPU0:router(config-igmp)#

static-group

To configure the router to be a statically configured member of the specified group on the interface, or to statically forward for a multicast group onto the interface, use the static-group command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.

static-group group-address [inc-mask mask count cnt] [source-address [inc-mask mask count cnt]]

Syntax Description

group-address

IP address of the multicast group in IPv4 prefixing format:

  • IP address as defined in the Domain Name System (DNS) hosts table or with the domain IPv4 host in the format A.B.C.D .

inc-mask mask

(Optional) Specifies a mask for the increment range. This is an IP address expressed range in IPv4 format. This mask is used with the group address to generate subsequent group addresses:

  • IP address as defined in the Domain Name System (DNS) hosts table or with the domain IPv4 host in the format A.B.C.D .

Note

 

This mask is used with the group address to generate subsequent group addresses.

count cnt

(Optional) Specifies a number of group addresses to generate using the increment mask. Range is 1 to 512.

source address

(Optional) Source address of the multicast group to include in IPv4 prefixing format:

  • IP address as defined in the Domain Name System (DNS) hosts table or with the domain IPv4 host in the format A.B.C.D .

Command Default

A router is not a statically connected member of an IP multicast group.

Command Modes

IGMP interface configuration

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

When you configure the static-group command, packets to the group are switched out the interface, provided that packets were received on the correct Reverse Path Forwarding (RPF) interface.

The static-group command differs from the join-group command. The join-group command allows the router to join the multicast group and draw traffic to an IP client process (that is, the route processor). If you configure both the join-group and static-group command for the same group address, the join-group command takes precedence and the group behaves like a locally joined group.


Note


The static-group command has no impact on system performance. Configuring a static-group on a loopback interface has no effect on the ASR 9000 Series Aggregation Services Router.


Task ID

Task ID

Operations

multicast

read, write

Examples

In the following example, the router statically joins two multicast groups 225.2.2.2 and 225.2.2.4 for the specific source 1.1.1.1:


RP/0/RSP0/CPU0:router(config)# router igmp
RP/0/RSP0/CPU0:router(config-igmp)# interface GigE 0/1/0/0
RP/0/RSP0/CPU0:router(config-igmp-default-if)# static-group 225.2.2.2 inc-mask 0.0.0.2 count 2 1.1.1.1

unicast-qos-adjust

To configure the IGMP QOS Shaper for subscriber unicast traffic, use the unicast-qos-adjust command in the IGMP configuration mode. To disable this feature, use the no form of this command.

unicast-qos-adjust {adjustment-delay | download-interval | holdoff}

Syntax Description

adjustment-delay

Configures the time to wait before programming rate in QOS.

download-interval

Configures the time before downloading a batch of interfaces to QOS.

holdoff

Configures the hold-off time before QOS clears the stale entries.

Command Default

None

Command Modes

IGMP configuration mode

Command History

Release Modification

Release 4.2.0

This command was introduced.

Usage Guidelines

Use the dynamic-template type ppp command to enter dynamic template type ppp configuration mode.

Task ID

Task ID Operation

multicast

read, write

Examples

This is an example of configuring the unicast-qos-adjust command in the IGMP configuration mode:


RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# router igmp
RP/0/RSP0/CPU0:router(config-igmp)# unicast-qos-adjust

version

To configure an Internet Group Management Protocol (IGMP) version for the router, use the version command in the appropriate configuration mode. To restore the default value, use the no form of this command.

version {1 | 2 | 3}

Syntax Description

1

Specifies IGMP Version 1.

2

Specifies IGMP Version 2.

3

Specifies IGMP Version 3.

Command Default

If this command is not specified in interface configuration mode, the interface adopts the IGMP version parameter specified in IGMP VRF configuration mode.

If this command is not specified in IGMP configuration mode, IGMP uses Version 3 .

Command Modes

IGMP configuration

IGMP VRF configuration

IGMP interface configuration

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

All routers on the subnet must be configured with the same version of IGMP. For example, a router running Cisco IOS XR software does not automatically detect Version 1 systems and switch to Version 1. Hosts can have any IGMP version and the router will correctly detect their presence and query them appropriately.

The query-max-response-time and query-timeout commands require IGMP Version 2 or 3.


Note


If you configure this command in IGMP configuration mode, parameters are inherited by all new and existing interfaces. You can override these parameters on individual interfaces from interface configuration mode.


Task ID

Task ID

Operations

multicast

read, write

Examples

The following example shows how to configure the router to use IGMP Version 3:


RP/0/RSP0/CPU0:router(config)# router igmp 
RP/0/RSP0/CPU0:router(config-igmp)# version 3

vrf (igmp)

To configure a virtual private network (VRF) instance, use the vrf command in IGMP routing configuration mode. To remove the VRF instance from the configuration file and restore the system to its default condition, use the no form of this command.

vrf vrf-name

Syntax Description

vrf-name

Name of the VRF instance.

Command Default

No default behavior or values.

Command Modes

IGMP configuration

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

When you use the vrf command from the IGMP routing configuration mode to configure a VRF instance, you enter the IGMP VRF configuration submode.

A VRF instance is a collection of VPN routing and forwarding tables maintained at the provider edge (PE) router.

Task ID

Task ID

Operations

multicast

read, write

Examples

The following example shows how to configure a VRF instance in IGMP configuration submode and to enter VRF configuration submode:


RP/0/RSP0/CPU0:router(config)# router igmp
RP/0/RSP0/CPU0:router(config-igmp)# vrf 
vrf_1
RP/0/RSP0/CPU0:router(config-igmp-vrf_1)#