Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 03-IGMP Configuration Commands | 73.53 KB |
Chapter 1 IGMP Configuration Commands
1.1 IGMP Configuration Commands
1.1.10 igmp lastmember-queryinterval
1.1.12 igmp-report enhance enable
1.1.14 igmp timer other-querier-present
1.2 IGMP Proxy Configuration Commands
Chapter 1 IGMP Configuration Commands
1.1 IGMP Configuration Commands
1.1.1 debugging igmp
debugging igmp { all | event | host | packet | timer }
undo debugging igmp { all | event | host | packet | timer }
Parameters
all: All types of IGMP debugging information.
event: Debugging information of IGMP events.
host: Debugging information of IGMP hosts.
packet: Debugging information of IGMP packets.
timer: Debugging information of IGMP timers.
Use the debugging igmp command to enable IGMP debugging functions.
Use the undo debugging igmp command to disable the debugging functions.
By default, IGMP debugging functions are disabled.
Examples
# Enable all types of IGMP debugging.
<H3C> debugging igmp all
1.1.2 display igmp group
display igmp group [ group-address | interface vlan-interface interface-number ]
Parameters
group-address: Address of the multicast group.
vlan-interface interface-number: VLAN interface number.
Use the display igmp group command to view the member information of the IGMP multicast group.
You can view the information of a multicast group or a member in the multicast group. The information displayed contains the multicast groups which the downstream hosts join through IGMP or through command line.
Related commands: igmp host-join.
Examples
# Display the IGMP group members in a directly-connected subnet.
<H3C> display igmp group
LoopBack0 (20.20.20.20): Total 3 IGMP Groups reported:
Group Address Last Reporter Uptime Expires
225.1.1.1 20.20.20.20 00:02:04 00:01:15
225.1.1.3 20.20.20.20 00:02:04 00:01:15
225.1.1.2 20.20.20.20 00:02:04 00:01:17
Table 1-1 Description on the fields of the display igmp group command
|
Field |
Description |
|
Group address |
Multicast group address |
|
Last Reporter |
The host last reporting to join the multicast group |
|
Uptime |
Time elapsed since multicast group is discovered (hh: mm: ss). |
|
Expires |
Specifies when the member will be removed from the multicast group (hh: mm: ss). |
1.1.3 display igmp interface
Syntax
display igmp interface [ vlan-interface interface-number ]
View
Any view
Parameters
vlan-interface interface-number: VLAN interface number of the router, used to specify the interface. If no interface is provided, information about all the interfaces running IGMP will be displayed.
Description
Use the display igmp interface command to view the IGMP configuration and running information on an interface.
Examples
# View the IGMP configuration and running information on all interfaces.
<H3C> display igmp interface
Vlan-interface1 (10.153.17.99):
IGMP is enabled
Current IGMP version is 2
Value of query interval for IGMP(in seconds): 60
Value of other querier time out for IGMP(in seconds): 120
Value of maximum query response time for IGMP(in seconds): 10
Value of robust count for IGMP: 2
Value of startup query interval for IGMP(in seconds): 15
Value of last member query interval for IGMP(in seconds): 1
Value of query timeout for IGMP version 1(in seconds): 400
Querier for IGMP: 10.153.17.99 (this router)
IGMP group limit is 1024
No IGMP group reported
Table 1-2 Description on the fields of the display igmp interface command
|
Field |
Description |
|
IGMP version |
IGMP version |
|
query interval |
General query interval |
|
querier timeout |
Querier timeout time |
|
max query response time |
Maximum query response time |
|
robust count |
IGMP robust count, namely the number of times IGMP querier sends IGMP specific group query packet when it receives an IGMP Leave packet from a host |
|
startup query interval |
Startup query interval |
|
last member query interval |
Interval at which the IGMP querier sends IGMP specific group query packets when it receives an IGMP leave packet from a host |
|
query timeout |
Query timeout for IGMP V1 |
|
Policy to accept IGMP reports |
Filter policy for the IGMP multicast group to control the access to the IP multicast group |
|
Querier for IGMP |
IGMP querier |
|
IGMP group limit |
Quantity limit of IGMP groups added to the interface. After the limit is reached, the router does not process the IGMP join messages |
1.1.4 igmp enable
Syntax
undo igmp enable
View
VLAN interface view
Parameters
None
Description
Use the igmp enable command to enable IGMP on the interface.
Use the undo igmp enable command to disable IGMP on the interface.
By default, IGMP is disabled on the interface.
You must enable the multicast function before this command can work, and you must use this command first before you can configure other IGMP features.
Related commands: multicast routing-enable.
Caution:
l If the VLAN VPN is enabled on a port, the IGMP Snooping feature cannot be enabled on the VLAN to which the port belongs, and the IGMP feature cannot be enabled on the corresponding interface.
l If IGMP Snooping feature is enabled on a VLAN, or IGMP is enabled on the interface, you cannot add VLAN VPN enabled ports into the VLAN, and vice versa.
Examples
# Enable IGMP on VLAN-interface 10.
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] interface vlan-interface 10
[H3C-Vlan-interface10] igmp enable
1.1.5 igmp fast-leave
Syntax
igmp fast-leave [ vlan { vlan-id [ to vlan-id ] } &<1-10> ]
undo igmp fast-leave [ vlan { vlan-id [ to vlan-id ] } &<1-10> ]
View
Ethernet port view, system view
Parameters
vlan-id: VLAN ID, which you want to configure the IGMP Snooping fast leave feature on. The value range is from 1 to 4094.
Description
Use the igmp fast-leave command to enable IGMP fast leave on ports or VLANs.
Use the undo igmp fast-leave command to disable IGMP fast leave.
Fast leave is disabled by default.
An IGMP-enabled Layer 3 switch removes a fast leave-enabled port from the multicast forwarding table entry immediately and stops to forward packets of the group to the port when the port receives an IGMP leave packet.
You can optionally specify multiple vlan keywords for the igmp fast-leave command, through which you can enable IGMP fast leave in corresponding VLANs. If you do not specify the vlan keyword, IGMP fast leave is enabled in all VLANs. As mentioned earlier, the igmp fast-leave command can be executed in both system view and Ethernet port view. When you execute the command in system view, fast leave is enabled on all ports of the specified VLANs. Otherwise, it is only enabled on the current port in the specified VLANs.
& Note:
l Fast leaves that are configured in system view and Ethernet port view operate separately.
l Fast leave works on all ports of the specified VLANs if you configure it in system view. However, it only works on the current port (for example, when a trunk port belongs to multiple VLANs) in the specified VLANs if you configure it in Ethernet port view.
Caution:
l Fast leave configured for a port takes effect only when the VLAN to which the port belongs is IGMP-enabled.
l Fast leave does not work if the corresponding specified VLANs do not exist, the port does not belongs to any of the specified VLANs, or the VLANs do not have IGMP enabled.
l You can enable multicast routing globally by executing the multicast routing-enable command before you configure the fast leave feature.
l Disabling globally-enabled multicast routing results in all existing IGMP fast leave-related configurations being cleared.
l When you configure IGMP fast leave on aggregation ports, the configuration takes effect only on primary aggregation ports.
l If you add an IGMPv1 host of the same multicast group to the port, or configure a static host of the same multicast group by using the igmp host-join command, the switch does not remove the port when the port receives an IGMP Leave packet of the multicast group even you enable IGMP fast leave for the port.
Examples
# Enable IGMP fast leave on Ethernet 2/1/1 in VLAN 5 only.
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] interface Ethernet2/1/1
[H3C-Ethernet2/1/1] igmp fast-leave vlan 5
# Disable IGMP fast leave on Ethernet 2/1/1 in all VLANs.
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] interface Ethernet2/1/1
[H3C-Ethernet2/1/1] undo igmp fast-leave
# Enable IGMP fast leave on all Ethernet ports in VLAN 5.
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] igmp fast-leave vlan 5
# Enable IGMP fast leave for all Ethernet ports except those in VLAN 5.
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] igmp fast-leave
[H3C] undo igmp fast-leave vlan 5
# Disable IGMP fast leave in all VLANs.
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] undo igmp fast-leave
1.1.6 igmp group-limit
igmp group-limit limit
undo igmp group-limit
Parameters
limit: Quantity of multicast groups, in the range of 0 to 512.
Use the igmp group-limit command to limit multicast groups to be added on an interface. After the limit is reached, the device does not process IGMP join messages.
Use the undo igmp group-limit command to restore the default setting.
By default, the maximum number is 512.
The latest configuration overwrites the previous one if you run the command for a second time.
& Note:
This command can be successfully executed only when the number of multicast groups on the current interface is less than the specified upper limit.
Examples
# Limit the maximum number of IGMP groups to be added on VLAN-interface10 to 100.
System View: return to User View with Ctrl+Z.
[H3C] interface vlan-interface 10
[H3C-Vlan-interface10] igmp group-limit 100
1.1.7 igmp group-policy
Syntax
igmp group-policy acl-number
undo igmp group-policy
View
VLAN view
Parameters
acl-number: Number of a basic ACL, in the range of 2,000 to 2,999.
Description
Use the igmp group-policy command to reference an ACL for filtering multicast groups on a specified VLAN so as to control the access to IP multicast groups. You can reference only one ACL for each VLAN, and the newly configured ACL will overwrite the previous one.
Use the undo igmp group-policy command to cancel the configuration.
By default, no ACL is referenced in a VLAN. In this case, a host can join any multicast group.
After an ACL for filtering multicast groups is configured in a VLAN, the multicast groups that are not permitted by the ACL cannot be created.
Examples
# Create a basic ACL numbered 2001. (Define destination multicast addresses using the source IP address field in ACL rules.)
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] acl number 2001
[H3C-acl-basic-2001] rule 0 permit source 224.1.1.1 0
[H3C-acl-basic-2001] quit
# Create VLAN 2.
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] vlan 2
# Reference ACL 2001 for filtering multicast groups in VLAN 2.
[H3C-vlan2] igmp group-policy 2001
1.1.8 igmp host-join port
igmp host-join group-address port interface-type interface- number [ to { interface-type interface- number ]
undo igmp host-join group-address port { interface-type interface-number [ to { interface-type interface- number ]
Parameters
group-address: Multicast address of the multicast group that an interface will join.
interface-type interface-number [ to interface-type interface-number ]: Specifies the port under the interface.
Use the igmp host-join command to enable a port in the interface of an Ethernet switch to join a multicast group.
Use the undo igmp host-join command to disable the configuration.
By default, an interface does not join any multicast group.
Related commands: igmp group-policy.
Examples
# Add Ethernet 2/1/1 under VLAN-interface 10 to the multicast group 225.0.0.1.
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] interface vlan-interface 10
[H3C-Vlan-interface10] igmp host-join 225.0.0.1 port Ethernet 2/1/1
1.1.9 igmp host-join vlan
Syntax
igmp host-join group-address vlan vlan-id
undo igmp host-join group-address vlan vlan-id
View
Ethernet port view
Parameters
group-address: Address of the multicast group to be joined.
vlan-id: VLAN which the port belongs to.
Description
Use the igmp host-join vlan command to make an Ethernet join a multicast group.
Use the undo igmp host-join vlan command to cancel the configuration.
By default, an Ethernet port does not join any multicast group.
Related commands: igmp group-policy.
Examples
# Add Ethernet 2/1/1 to the multicast group 225.0.0.1
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] interface vlan-interface 10
[H3C-Vlan-interface10] igmp enable
[H3C-Vlan-interface10] quit
[H3C] interface Ethernet 2/1/1
[H3C-Ethernet2/1/1] port access vlan 10
[H3C-Ethernet2/1/1] igmp host-join 225.0.0.1 vlan 10
1.1.10 igmp lastmember-queryinterval
igmp lastmember-queryinterval seconds
undo igmp lastmember-queryinterval
Parameters
seconds: Interval in seconds at which the IGMP querier sends IGMP group query messages after it receives the IGMP Leave message from the host, in the range of 1 to 5, with a default of 1.
Use the igmp lastmember-queryinterval command to set the time interval at which IGMP query router sends the IGMP group query message after it receives the IGMP Leave message from the host.
Use the undo igmp lastmember-queryinterval command to restore the default value.
This command is valid only when the querier runs IGMPv2. If the host runs IGMPv1, it does not send an IGMP Leave message when it leaves a group. Therefore, this command is invalid for the IGMP querier.
Related commands: igmp robust-count, display igmp interface.
Examples
# Set the query interval to 3 seconds on VLAN-interface10.
System View: return to User View with Ctrl+Z.
[H3C] interface vlan-interface 10
[H3C-Vlan-interface10] igmp lastmember-queryinterval 3
1.1.11 igmp max-response-time
igmp max-response-time seconds
undo igmp max-response-time
Parameters
seconds: Maximum response time in seconds in IGMP query messages, in the range from 1 to 25.
Use the igmp max-response-time command to configure the maximum response time contained in the IGMP query messages.
Use the undo igmp max-response-time command to restore the default value.
By default, the maximum query response time is 10 seconds.
The maximum query response time determines the period for a router to detect there are no more directly connected group members in a LAN.
Related commands: display igmp group.
Examples
# Set the maximum response time carried in host-query message to 8 seconds.
System View: return to User View with Ctrl+Z.
[H3C] interface vlan-interface 10
[H3C-Vlan-interface10] igmp max-response-time 8
1.1.12 igmp-report enhance enable
Syntax
igmp-report enhance enable
igmp-report enhance disable
View
System view
Parameters
None
Description
Use the igmp-report enhance enable command to enable the compatibility control function of the switch.
Use the igmp-report enhance disable command to disable the function.
With the compatibility control function enabled, the switch processes the protocol packet with the destination IP address 224.0.0.1 among IGMP Report packets. Otherwise, the switch drops this kind of packets.
By default, the compatibility control function of the switch is disabled.
This command is often executed after IGMP or IGMP Spooning protocol is enabled in the system.
Related commands: igmp, igmp-snooping
Examples
# Enable the compatibility control function of the switch.
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] igmp-report enhance enable
1.1.13 igmp robust-count
igmp robust-count robust-value
undo igmp robust-count
Parameters
robust-value: IGMP robust value, number of times the IGMP query router sends IGMP group query message after it receives the IGMP Leave message from the host. The value range is 2 to 5.
Use the igmp robust-count command to set the number of times the IGMP query router sends IGMP group query message after it receives the IGMP Leave message from the host.
Use the undo igmp robust-count command to restore the default value.
By default, the IGMP robust value is 2.
Related commands: igmp lastmember-queryinterval, display igmp interface.
Examples
# Set the robust value to 3 on VLAN-interface 10.
System View: return to User View with Ctrl+Z.
[H3C] interface vlan-interface 10
[H3C-Vlan-interface10] igmp robust-count 3
1.1.14 igmp timer other-querier-present
igmp timer other-querier-present seconds
undo igmp timer other-querier-present
Parameters
seconds: IGMP querier presence timer length in seconds, in the range of 1 to 131070.
Use the igmp timer other-querier-present command to configure the IGMP querier presence timer length.
Use the undo igmp timer other-querier-present command to restore the default value.
By default, the value is twice the IGMP query message interval, namely, 120 seconds.
On a shared network, namely, there are multiple multicast routers on the same network segment; the query router (querier for short) sends query messages periodically on the interface. If a non-querier receives no query messages within the valid period, the non-querier will consider the previous querier invalid and become a querier.
In IGMP version 1, the selection of a querier is determined by the multicast routing protocol. In IGMP version 2, the router with the lowest IP address on the shared network segment acts as the querier.
Related commands: igmp timer query, display igmp interface.
Examples
# Set the IGMP querier presence timer length to 300 seconds.
System View: return to User View with Ctrl+Z.
[H3C] interface vlan-interface 10
[H3C-Vlan-interface10] igmp timer other-querier-present 300
1.1.15 igmp timer query
igmp timer query seconds
undo igmp timer query
Parameters
seconds: Interval in seconds at which a router transmits IGMP query messages, in the range of 1 to 65535.
Use the igmp timer query command to configure the interval at which a router interface sends IGMP query messages.
Use the undo igmp timer query command to restore the default value.
By default, the interval is 60 seconds.
A multicast router periodically sends IGMP query messages to check whether there are multicast group members on the network. The query interval can be modified according to the practical conditions of the network.
Related commands: igmp timer other-querier-present.
Examples
# Set the IGMP query message interval to 150 seconds on VLAN-interface 2.
System View: return to User View with Ctrl+Z.
[H3C] interface vlan-interface 2
[H3C-Vlan-interface2] igmp timer query 150
1.1.16 igmp version
igmp version { 1 | 2 }
undo igmp version
Parameters
1: IGMP version 1.
2: IGMP version 2. The default IGMP version is 2.
Use the igmp version command to specify the version of IGMP that a router uses.
Use the undo igmp version command to restore the default value.
The system does not support automatic switching between different IGMP versions. Therefore, all routers on a subnet must be configured to run the same IGMP version.
Examples
# Run IGMP Version 1 on VLAN-interface 10.
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] interface vlan-interface 10
[H3C-Vlan-interface10] igmp version 1
1.1.17 reset igmp group
reset igmp group { all | interface vlan-interface interface-number { all | group-address [ group-mask ] } }
Parameters
all: All IGMP groups.
interface vlan-interface interface-number: VLAN virtual interface type and number.
group-address: IGMP group address.
group-mask: Subnet mask of the IGMP group address.
Use the reset igmp group command to delete an existing IGMP group from the interface. The deleted group can added again on the interface.
Examples
# Delete all IGMP groups on all the interfaces.
<H3C> reset igmp group all
# Delete all IGMP groups on the VLAN-interface 10.
<H3C> reset igmp group interface Vlan-interface10 all
# Delete the group 225.0.0.1 from the VLAN-interface 10.
<H3C> reset igmp group interface Vlan-interface10 225.0.0.1
# Delete the IGMP groups ranging from 225.1.1.0 to 225.1.1.255 on the VLAN-interface 10.
<H3C> reset igmp group interface Vlan-interface10 225.1.1.0 255.255.255.0
1.2 IGMP Proxy Configuration Commands
1.2.1 igmp proxy
Syntax
igmp proxy interface-type interface-number
undo igmp proxy
View
Interface view
Parameters
interface-type: Proxy interface type.
interface-number: Proxy interface number.
Description
Use the igmp proxy command to enable IGMP proxy for the VLAN interface and specify the IGMP proxy interface of the VLAN interface.
Use the undo igmp proxy command to remove IGMP proxy configuration.
By default, IGMP proxy is disabled on the interface.
Caution:
l You need to enable IGMP for a VLAN interface before executing the igmp proxy command in its VLAN interface view.
l If IGMP is not enabled on the specified proxy interface, you can configure this command but it will not take effect.
l If you configure the IGMP proxy interface for a VLAN interface multiple times, the latest configured IGMP proxy interface will take effect.
l A VLAN interface cannot be the IGMP proxy interface for two or more other VLAN interfaces simultaneously.
Examples
# Enable IGMP proxy on VLAN-interface 100 and specify VLAN-interface 200 to be its IGMP proxy interface.
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] interface vlan-interface 100
[H3C-Vlan-interface100] igmp enable
[H3C-vlan-interface100] igmp proxy vlan-interface 200
