Ethernet switches serve as routers when an IP multicast protocol is running on them. The routers mentioned here refer to common routers and Layer 3 Ethernet switches running an IP multicast protocol.

1.1 GMRP Configuration Commands

1.1.1 display gmrp statistics

Syntax

display gmrp statistics [ interface interface-list ]

View

Any view

Parameters

interface interface-list: Specifies Ethernet port list, expressed as interface-list={ interface-type interface-number [ to { interface-type interface-number } ] }&<1-10>.

Description

Use the display gmrp statistics command to view the statistics information about GMRP.

This command is used for displaying the statistics information about GMRP, including the list of ports with GMRP enabled, GMRP status information, GMRP failed registrations and last origin of GMRP packet data unit (PDU).

If an interface is specified, the system displays the GMRP statistics information of the specified interface.

Examples

# Display the statistics information about GMRP on Ethernet 1/0/1.

<H3C> display gmrp statistics interface Ethernet1/0/1

GMRP statistics on port Ethernet1/0/1

Gmrp Status : Enabled

Gmrp Running :Yes

Gmrp Failed Registrations : 0

Gmrp Last Pdu Origin : 0000-0000-0000

1.1.2 display gmrp status

Syntax

display gmrp status

View

Any view

Parameters

None

Description

Use the display gmrp status command to view the status of global GMRP.

Examples

# Display the status of global GMRP.

<H3C> display gmrp status

GMRP is enabled

1.1.3 gmrp

Syntax

gmrp

undo gmrp

View

System view, Ethernet port view

Parameters

None

Description

Use the gmrp command to enable GMRP globally or enable GMRP on a port.

Use the undo gmrp command to disable GMRP globally or disable GMRP on a port..

By default, GMRP is disabled globally and on each port.

Executed in system view, this command will enable the global GMRP. After performing this command in Ethernet port view, GMRP will be enabled on a port.

Before enabling GMRP on a port, you shall enable GMRP globally.

Related commands: display gmrp status, display gmrp statistics.

Examples

# Enable GMRP globally.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] gmrp

GMRP is enabled globally.

Chapter 2 IGMP Snooping Configuration Commands

2.1 IGMP Snooping Configuration Commands

2.1.1 display igmp-snooping configuration

Syntax

display igmp-snooping configuration

View

Any view

Parameters

None

Description

Use the display igmp-snooping configuration command to display IGMP Snooping configuration information.

When IGMP Snooping is enabled on a switch, this command displays the following information: IGMP Snooping status, aging time of the router port, maximum query response timeout time, and aging time of multicast group member ports.

Related commands: igmp-snooping.

Examples

# Display IGMP Snooping configuration information on a switch.

<H3C> display igmp-snooping configuration

Enable IGMP-Snooping.

The router port timeout is 105 second(s).

The max response timeout is 1 second(s).

The host port timeout is 260 second(s).

The above information shows: IGMP Snooping is enabled, the aging time of the router port is 105 seconds, the maximum query response timeout time is one second, and the aging time of multicast group member ports is 260 seconds.

2.1.2 display igmp-snooping group

Syntax

display igmp-snooping group [ vlan vlan-id ]

View

Any view

Parameters

vlan-id: ID of the specified VLAN.

Description

Use the display igmp-snooping group command to display information about the IP multicast groups and MAC multicast groups in a specific VLAN (with vlan vlan-id specified) or all VLANs (without vlan vlan-id specified).

This command displays the following information: VLAN ID, router port, IP multicast group address, member ports included in the IP multicast group, MAC multicast group, MAC multicast group address, and member ports included in the MAC multicast group.

Examples

# Display information about the multicast groups in VLAN 2.

<H3C> display igmp-snooping group vlan 2

Total 1 IP Group(s).

Total 1 MAC Group(s).

Vlan(id):2.

Total 1 IP Group(s).

Total 1 MAC Group(s).

Static router port(s):

Dynamic router port(s):

IP group(s):the following ip group(s) match to one mac group.

IP group address:225.1.1.1

Host port(s):GigabitEthernet2/0/1

MAC group(s):

MAC group address:0100-5e01-0101

Host port(s):GigabitEthernet2/0/1

The information above means:

l Multicast groups exist in VLAN 2.

l The address of the IP multicast group is 255.1.1.1.

2.1.3 display igmp-snooping statistics

Syntax

display igmp-snooping statistics

View

Any view

Parameters

None

Description

Use the display igmp-snooping statistics command to display IGMP Snooping message statistics.

This command displays the following information: the numbers of received IGMP general query messages, received IGMP group-specific query messages, received IGMPv1 report messages, received IGMPv2 report messages, received IGMP leave messages and received IGMP error messages, and the number of sent IGMP group-specific query messages.

Related commands: igmp-snooping.

Examples

# Display IGMP Snooping message statistics.

<H3C> display igmp-snooping statistics

Received IGMP general query packet(s) number:0.

Received IGMP specific query packet(s) number:0.

Received IGMP V1 report packet(s) number:0.

Received IGMP V2 report packet(s) number:0.

Received IGMP leave packet(s) number:0.

Received error IGMP packet(s) number:0.

Sent IGMP specific query packet(s) number:0.

The information above shows that IGMP Snooping-enabled switches receive:

l zero IGMP general query messages

l zero IGMP group-specific query messages

l zero IGMPv1 report messages

l zero IGMPv2 report messages

l zero IGMP leave messages

l zero IGMP error messages

IGMP Snooping-enabled switches send:

l zero IGMP specific query messages

2.1.4 display multicast-vlan

Syntax

display multicast-vlan [ vlan-id ]

View

Any view

Parameters

vlan-id: ID of the specified VLAN.

Description

Use the display multicast-vlan command to display the configuration information of the multicast VLAN.

If the vlan-id argument is not provided when the command is executed, the configuration information of all the VLANs in the network is displayed.

Examples

# Display the configuration information of multicast VLAN 2.

<H3C> display multicast-vlan 2

multicast vlan 2's subvlan list:

Vlan 1024

The information above means:

l Multicast VLAN 2 exists

l VLAN 1024 is the subvlan of multicast VLAN 2

2.1.5 igmp-snooping

Syntax

igmp-snooping { enable | disable }

View

System view

Parameters

enable: Enables the IGMP Snooping feature.

disable: Disables the IGMP Snooping feature.

Description

Use the igmp-snooping enable command to enable the IGMP Snooping feature.

Use the igmp-snooping disable command to disable the IGMP Snooping feature.

By default, the IGMP Snooping feature is disabled.

Examples

# Enable the IGMP Snooping feature on the switch.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] igmp-snooping enable

Enable IGMP-Snooping ok.

2.1.6 igmp-snooping fast-leave

Syntax

igmp-snooping fast-leave [ vlan vlan-list ]

undo igmp-snooping fast-leave [ vlan vlan-list ]

View

System view, Ethernet port view

Parameters

vlan-list: Multiple VLANs in the form of vlan-list = { vlan-id [ to vlan-id ] } & < 1-10 >. The vlan-id argument is the ID of a VLAN, in the range of 1 to 4094. &<1-10> means that you can provide this argument repeatedly for up to ten times.

Description

Use the igmp-snooping fast-leave command to enable the IGMP fast leave feature.

Use the undo igmp-snooping fast-leave command to disable the IGMP fast leave feature.

By default, the IGMP fast leave feature is disabled.

Normally, when a port receives an IGMP Leave message, the IGMP Snooping-enabled switch does not immediately remove the port from the multicast group, but sends a group-specific query message. If no response is received in a given period, it then removes the port from the multicast group.

If this command is executed, when a port receives an IGMP Leave message, the IGMP Snooping-enabled switch directly removes the port from the multicast group. When the port has only one user, the IGMP fast leave feature can save bandwidth.

& Note:

l This feature is applicable to only IGMPv2-enabled clients.

l When this feature is enabled, if one of the multiple users on a port leaves, the multicast services for the other users in the same multicast group may be interrupted.

Examples

# Enable the IGMP fast leave feature on Ethernet1/0/1.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface Ethernet 1/0/1

[H3C-Ethernet1/0/1] igmp-snooping fast-leave

2.1.7 igmp-snooping group-limit

Syntax

igmp-snooping group-limit limit [ vlan vlan-list [ overflow-replace ] | overflow-replace ]

undo igmp-snooping group-limit [ vlan vlan-list ]

View

Ethernet port view

Parameters

limit: Maximum number of multicast groups the port can join, in the range of 1 to 256.

overflow-replace: Permits a new multicast group to replace an existing multicast group. The multicast group with the lowest IP address is replaced preferentially.

Description

Use the igmp-snooping group-limit command to define the maximum number of multicast groups the port can join.

Use the undo igmp-snooping group-limit command to restore the default setting.

By default, there is no limit on the number of multicast groups the port can join.

Examples

# Allow Ethernet1/0/1 to join up to 200 multicast groups.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface Ethernet 1/0/1

[H3C-Ethernet1/0/1] igmp-snooping group-limit 200

2.1.8 igmp-snooping group-policy

Syntax

igmp-snooping group-policy acl-number [ vlan vlan-list ]

undo igmp-snooping group-policy [ vlan vlan-list ]

View

System view, Ethernet port view

Parameters

acl-number: Basic ACL number, in the range of 2000 to 2999.

Description

Use the igmp-snooping group-policy command to configure an IGMP Snooping filtering ACL.

Use the undo igmp-snooping group-policy command to remove the IGMP Snooping filtering ACL.

By default, no IGMP Snooping filtering ACL is configured.

You can use the IGMP Snooping filter feature to configure multicast filtering ACLs for users connected to different switch ports so as to limit the multicast programs the users can access. With this feature enabled, you can treat different VoD users differently by allowing them to access the multicast programs in different multicast groups.

In practice, when a user orders a multicast program, an IGMP host report message is generated. When the message arrives at the switch, the switch examines the multicast filtering ACL configured on the access port to determine whether the port can join the corresponding multicast group or not. If yes, it adds the port to the forwarding port list of the multicast group. If not, it drops the IGMP host report message and does not forward the corresponding data stream to the port. In this way, you can control the multicast programs that users can access.

An ACL rule defines a multicast address or a multicast address range (for example 224.0.0.1 to 239.255.255.255) and is used to:

l Allow the port(s) to join only the multicast group(s) defined in the permit rule.

l Inhibit the port(s) from joining the multicast group(s) defined in the deny rule.

& Note:

l A port can belong to multiple VLANs. But for each VLAN on the port, you can configure only one ACL.

l If the port does not belong to the specified VLAN, the filtering ACL configured for the VLAN does not take effect on the port.

l If no ACL rule is configured in the command, the system will reject the multicast packets addressed to all the multicast groups.

l Since most devices broadcast unknown multicast packets, this feature is often used together with the unknown multicast packet drop feature to prevent multicast streams from being broadcasted to a filtered port as unknown multicast streams.

Examples

# Configure ACL 2000 to allow users on Ethernet 1/0/1 to access the multicast streams in multicast groups ranging from 225.0.0.0 to 225.255.255.255.

l Configure ACL 2000.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] acl number 2000

[H3C-acl-basic-2000] rule permit source 225.0.0.0 0.255.255.255

[H3C-acl-basic-2000] quit

l Create VLAN 2 and add Ethernet 1/0/1 port to VLAN 2.

[H3C] vlan 2

[H3C-vlan2] port Ethernet 1/0/1

Gigabit[H3C-vlan2] quit

l Configure ACL 2000 on Ethernet 1/0/1 to allow VLAN 2 to join only the IGMP multicast groups defined in ACL 2000.

[H3C] interface Ethernet 1/0/1

[H3C-Ethernet1/0/1] igmp-snooping group-policy 2000 vlan 2

[H3C-Ethernet1/0/1] quit

# Configure ACL 2001 to allow users on Ethernet 1/0/2 to access the multicast streams in any multicast group except multicast groups ranging from 225.0.0.0 to 225.0.0.255.

l Configure ACL 2001.

[H3C] acl number 2001

[H3C-acl-basic-2001] rule deny source 225.0.0.0 0.0.0.255

[H3C-acl-basic-2001] rule permit source any

[H3C-acl-basic-2001] quit

l Create VLAN 2 and add Ethernet 1/0/2 to VLAN 2.

[H3C] vlan 2

[H3C-vlan2] port Ethernet 1/0/2

[H3C-vlan2] quit

l Configure ACL 2001 on Ethernet 1/0/2 to allow VLAN 2 to join any IGMP multicast groups except those defined in ACL 2001.

[H3C] interface Ethernet 1/0/2

[H3C-Ethernet1/0/2] igmp-snooping group-policy 2001 vlan 2

2.1.9 igmp-snooping host-aging-time

Syntax

igmp-snooping host-aging-time seconds

undo igmp-snooping host-aging-time

View

System view

Parameters

seconds: Aging time of multicast group member ports, in the range of 200 to 1000 in seconds.

Description

Use the igmp-snooping host-aging-time command to configure the aging time of multicast group member port.

Use the undo igmp-snooping host-aging-time command to restore the default aging time.

By default, the aging time of multicast group member ports is 260 seconds.

The aging time of multicast group member ports determines the refresh frequency of multicast group members. In an environment where multicast group members change frequently, a relatively shorter aging time is required.

Related commands: igmp-snooping.

Examples

# Set the aging time of multicast group member ports to 300 seconds.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] igmp-snooping host-aging-time 300

2.1.10 igmp-snooping max-response-time

Syntax

igmp-snooping max-response-time seconds

undo igmp-snooping max-response-time

View

System view

Parameters

seconds: Query response timeout time, in the range of 1 to 25 in seconds.

Description

Use the igmp-snooping max-response-time command to configure the maximum query response timeout time.

Use the undo igmp-snooping max-response-time command to restore the default timeout time.

By default, the maximum query response timeout time is 10 seconds.

The configured maximum query response timeout time determines how long the switch can wait for a response to an IGMP Snooping query message.

Related commands: igmp-snooping, igmp-snooping router-aging-time.

Examples

# Set the maximum query response timeout time to 15 seconds.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] igmp-snooping max-response-time 15

2.1.11 igmp-snooping report-aggregation

Syntax

igmp-snooping report-aggregation

View

System view

Parameters

None

Description

Use the igmp-snooping report-aggregation command to enable suppression on Layer 2 multicast IGMP report messages. In an IGMP Snooping-enabled VLAN, only one IGMP report message is sent to the upstream router port during an interval.

Use the undo igmp-snooping report-aggregation command to disable suppression on Layer 2 multicast IGMP report messages.

By default, suppression on IGMP report messages is disabled.

& Note:

l IGMP snooping must be enabled globally before the suppression on IGMP report messages is enabled.

l If IGMP snooping is disabled globally, the suppression on IGMP report messages is disabled simultaneously.

Examples

# Enable suppression on Layer 2 multicast IGMP report messages on the switch.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] igmp-snooping enable

[H3C] igmp-snooping report-aggregation

2.1.12 igmp-snooping router-aging-time

Syntax

igmp-snooping router-aging-time seconds

undo igmp-snooping router-aging-time

View

System view

Parameters

seconds: Aging time of router ports, in the range of 1 to 1000 in seconds.

Description

Use the igmp-snooping router-aging-time command to configure the aging time of router ports.

Use the undo igmp-snooping router-aging-time command to restore the default aging time of router ports.

By default, the aging time of router ports is 105 seconds.

The router port here refers to the port connecting the Layer 2 switch to the router. The Layer 2 switch receives IGMP general query messages from the router through this port. The aging time of the router port must be a value about 2.5 times of the general query interval.

Related commands: igmp-snooping max-response-time, igmp-snooping.

Examples

# Set the aging time of the IGMP Snooping-enabled router port to 500 seconds.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] igmp-snooping router-aging-time 500

2.1.13 multicast-vlan enable

Syntax

multicast-vlan enable

undo multicast-vlan enable

View

VLAN view

Parameters

None

Description

Use the multicast-vlan enable command to configure the current VLAN as a multicast VLAN.

Use the undo multicast-vlan enable command to disable the current VLAN from being a multicast VLAN.

By default, multicast VLANs are disabled.

Caution:

l A multicast VLAN cannot be configured as a multicast sub-VLAN.

l A multicast sub-VLAN cannot be configured as a multicast VLAN.

l A multicast sub-VLAN cannot be configured as the sub-VLAN of other multicast VLANs.

l One multicast sub-VLAN is corresponding to only one multicast VLAN.

l If multicast routing is enabled on a VLAN interface, the corresponding VLAN cannot be configured as a multicast VLAN.

l Every ethernet switch supports up to 5 multicast VLANs,

Examples

# Configure VLAN 2 as a multicast VLAN.

<H3C> system-view

Enter system view, return to user view with Ctrl+Z

[H3C] igmp-snooping enable

[H3C] vlan 2

[H3C-vlan2] multicast-vlan enable

2.1.14 multicast-vlan subvlan

Syntax

multicast-vlan vlan-id subvlan vlan-list

undo multicast-vlan vlan-id subvlan vlan-list

View

System view

Parameters

vlan-id: ID of the specified VLAN.

vlan-list: Multiple VLANs in the form of vlan-list = { vlan-id [ to vlan-id ] } & < 1-10 >. The vlan-id argument is the ID of a VLAN, in the range of 1 to 4,094. &<1-10> means that you can provide the argument repeatedly for up to ten times.

Description

Use the multicast-vlan subvlan command to configure one or multiple VLANs as the sub-VLAN(s) of the multicast VLAN.

Use the undo multicast-vlan subvlan command to cancel the sub-VLANs of the multicast VLAN.

By default, no sub-VLAN is configured for a multicast VLAN.

Caution:

l A multicast VLAN cannot be configured as a multicast sub-VLAN.

l A multicast sub-VLAN cannot be configured as a multicast VLAN.

l A multicast sub-VLAN cannot be configured as the sub-VLAN of other multicast VLANs.

l One multicast sub-VLAN is corresponding to only one multicast VLAN.

l If multicast routing is enabled on a VLAN interface, the corresponding VLAN cannot be configured as a multicast VLAN.

Examples

# Configure VLAN 2 through VLAN 5 as the sub-VLANs of multicast VLAN 10.

<H3C> system-view

Enter system view, return to user view with Ctrl+Z

[H3C] igmp-snooping enable

[H3C] vlan 10

[H3C-vlan10] igmp-snooping enable

[H3C-vlan10] multicast-vlan enable

[H3C-vlan10] quit

[H3C] multicast-vlan 10 subvlan 2 to 5

2.1.15 reset igmp-snooping statistics

Syntax

reset igmp-snooping statistics

View

User view

Parameters

None

Description

Use the reset igmp-snooping statistics command to clear IGMP Snooping statistics.

Related commands: igmp-snooping.

Examples

# Clear IGMP Snooping statistics.

<H3C> reset igmp-snooping statistics

Chapter 3 Common IP Multicast Configuration Commands

3.1 Common IP Multicast Configuration Commands

3.1.1 display mpm forwarding-table

Syntax

display mpm forwarding-table [ group-address | source-address ]

View

Any view

Parameters

group-address: Multicast group address to specify a multicast group, in the range of 224.0.0.0 to 239.255.255.255.

source-address: IP address of the multicast source.

Description

Use the display mpm forwarding-table command to display the information about multicast forwarding tables containing port information.

Only the matched (S, G) entries are displayed when the group address or source address is specified. Otherwise, the command displays all the entries.

If you want to query the information about multicast forwarding tables without port information, you can use the display multicast forwarding-table command.

Examples

# Query the information about the multicast forwarding table containing port information.

<H3C> display mpm forwarding-table

Multicast Forwarding Cache Table

Total 1 entry(entries)

00001. (120.0.0.2, 225.0.0.2)

iif Vlan-interface1200

1 oif(s):

Vlan-interface32

GigabitEthernet3/0/19

Total 1 entry(entries) Listed

Table 3-1 describes the fields in the displayed information above:

Table 3-1 Description on the fields of the display mpm forwarding-table command

Field	Description
Multicast Forwarding Cache Table	Multicast forwarding table
Total 1 entries	Total number of entries
00001	Serial number of an entry
(120.0.0.2, 225.0.0.2)	(S, G), namely, (source address, group address)
iif Vlan-interface1200	The incoming VLAN of the multicast forwarding table is VLAN 1200.
1 oif(s):	There are one outgoing VLANs in the multicast forwarding table.
Vlan-interface32 GigabitEthernet3/0/19	The outgoing VLAN is VLAN 32, with the outgoing port GigabitEthernet3/0/19
Total 1 entry(entries) Listed	One (S, G) entry is listed.

3.1.2 display mpm group

Syntax

display mpm group [ vlan vlan-id [ ip-address ] ]

View

Any view

Parameters

vlan vlan-id: Specifies the VLAN where the multicast group to be viewed resides. If this keyword is not specified, the command displays the multicast group information in all VLANs.

ip-address: IP address of the multicast group to be viewed.

Description

Use the display mpm group command to display the information about the IP multicast groups and MAC multicast groups in the specified VLAN or all the VLANs on the switch.

The displayed information includes:

l VLAN ID

l Router port

l Address of the IP multicast group

l Member ports in the IP multicast group

l MAC multicast group

l Address of the MAC multicast group

l Member ports in the MAC multicast group

Caution:

l The fields of this command are similar to those of the display igmp group command, except that the information of the specific ports is added.

l The fields of this command are the same as those of the display igmp-snooping group command except that the VLANs to be viewed are of different attributes.

l The display igmp-snooping group command displays the information about ports joining in layer-2 multicast groups in IGMP Snooping-enabled VLANs, while the display mpm group command displays the information about ports joining in layer-3 multicast groups in IGMP-enabled VLANs.

Examples

# Display the information about multicast groups in VLAN 2.

<H3C> display mpm group vlan 1200

Total 2 IP Group(s).

Total 2 MAC Group(s).

Vlan(id):1200.

Total 2 IP Group(s).

Total 2 MAC Group(s).

Static router port(s):

Dynamic router port(s):

IP group(s):the following ip group(s) match to one mac group.

IP group address:228.0.0.1

Host port(s):GigabitEthernet2/0/12

MAC group(s):

MAC group address:0100-5e00-0001

Host port(s):GigabitEthernet2/0/12

IP group(s):the following ip group(s) match to one mac group.

IP group address:228.0.0.0

Host port(s):GigabitEthernet2/0/12

MAC group(s):

MAC group address:0100-5e00-0000

Host port(s):GigabitEthernet2/0/12

Table 3-2 Description on the fields of the display mpm group command

Field	Description
Vlan(id):	Multicast groups in the specified VLAN
Static router port(s):	Static router port(s):
Dynamic router port(s):	Dynamic router port(s):
IP group(s): the following ip group(s) match to one mac group.	IP multicast groups: the following IP multicast groups match the same MAC multicast group.
IP group address:	The addresses of the IP multicast group.
Host port(s):	The host port in the IP multicast group:
MAC group address:	The address of the MAC multicast group:

3.1.3 display multicast forwarding-table

Syntax

display multicast forwarding-table [ group-address [ mask { group-mask | mask-length } ] | source-address [ mask { group-mask | mask-length } ] | incoming-interface { interface-type interface-number ] register } ]*

View

Any view

Parameters

group-address: Address of the specified multicast group, in the range of 224.0.0.0 to 239.255.255.255.

source-address: Unicast IP address of the multicast source.

incoming-interface: Specifies the incoming interface of the specified multicast forwarding entry.

register: Specifies the registration VLAN interface of the PIM-SM protocol.

Description

Use the display multicast forwarding-table command to display the information about MAC forwarding tables.

Related commands: display multicast routing-table.

Examples

# Display the information about MAC forwarding tables.

<H3C> display multicast forwarding-table

Multicast Forwarding Cache Table

Total 1 entry: 0 entry created by IP, 1 entry created by protocol

00001. (10.0.0.4, 225.1.1.1), iif Vlan-interface2, 0 oifs,

Protocol Create

Matched 122 pkts(183000 bytes), Wrong If 0 pkts

Forwarded 122 pkts(183000 bytes)

Total 1 entry Listed

Table 3-3 describes the displayed information above.

Table 3-3 Description on the fields of the display multicast forwarding-table command

Field	Description
Multicast Forwarding Cache Table	Multicast forwarding table
Total 1 entries	Total number of entries
00001	Serial number of an entry
(10.0.0.4, 225.1.1.1)	(S, G), namely, (source address, group address)
iif Vlan-interface2, 0 oifs	The incoming interface of the multicast forwarding table is VLAN-interface 2, and the multicast forwarding table does not have any outgoing interface.
Matched 122 pkts(183000 bytes), Wrong If 0 pkts Forwarded 122 pkts(183000 bytes)	122 packets which are of 183,000 bytes match the (S, G) entry, and 0 wrong packet matches the (S, G) entry. 122 packets which are of 183,000 bytes are forwarded.

3.1.4 display multicast routing-table

Syntax

display multicast routing-table [ group-address [ mask { mask | mask-length } ] | source-address [ mask { mask | mask-length } ] | incoming-interface { interface-type interface-number | register } ]*

View

Any view

Parameters

group-address: Multicast group address to specify a multicast group whose routing table information is to be viewed, in the range of 224.0.0.0 to 239.255.255.255.

source-address: Unicast IP address of the multicast source.

incoming-interface: Specifies the incoming interface of the multicast routing entry.

register: Specifies the registration interface for PIM-SM.

Description

Use the display multicast routing-table command to display the information about the IP multicast routing table.

This command is used to display the information about the multicast routing table, while the display multicast forwarding-table command is used to display the information about the multicast forwarding table.

Examples

# Query the information about the routing entries corresponding to the multicast group 225.1.1.1.1 in the multicast routing table.

<H3C> display multicast routing-table

Multicast Routing Table

Total 3 entries

(4.4.4.4, 224.2.149.17)

Uptime: 00:15:16, Timeout in 272 sec

Upstream interface: Vlan-interface1(4.4.4.6)

Downstream interface list:

1 oifs

Vlan-interface2(2.2.2.4), Protocol 0x1: IGMP

(4.4.4.4, 224.2.254.84)

Uptime: 00:15:16, Timeout in 272 sec

Upstream interface: Vlan-interface1(4.4.4.6)

Downstream interface list: NULL

(4.4.4.4, 239.255.2.2)

Uptime: 00:02:57, Timeout in 123 sec

Upstream interface: Vlan-interface1(4.4.4.6)

Downstream interface list: NULL

Matched 3 entries

Table 3-4 describes the fields in the displayed information.

Table 3-4 Description on the fields of the display multicast routing-table command

Field	Description
Multicast Routing Table	Multicast routing table
Total 3 entries	There are 3 entries in all in the multicast routing table.
(4.4.4.4, 224.2.149.17)	(S, G) entry of the multicast routing table
Uptime: 00:15:16, Timeout in 272 sec Upstream interface: Vlan-interface1(4.4.4.6) Downstream interface list: Vlan-interface2(2.2.2.4), Protocol 0x1: IGMP	The entry is up for 15 minutes and 16 seconds, and it times out in 272 seconds. The IP address of the upstream interface is 4.4.4.6. Downstream interface list: The IP address of the downstream interface vlan-interface 2 is 2.2.2.4. The downstream interface is added by the IGMP protocol.
Matched 3 entries	Three entries match the configuration.

3.1.5 display multicast-source-deny

Syntax

display multicast-source-deny [ interface interface-type [ interface-number ] ]

View

Any view

Parameters

interface-type: Port type.

interface-number: Port number.

Description

Use the display multicast-source-deny command to display the configuration information about the multicast source port check.

When you use this command to display the information about ports:

l If you specify neither the port type nor the port number, the multicast source port check information about all the ports on the switch is displayed.

l If you specify the port type only, the multicast source port check information about all ports of this type is displayed.

l If you specify both the port type and the port number, the multicast source port check information about the specified port is displayed.

Examples

# Display the multicast source port suppression state of Ethernet 1/0/1.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] display multicast-source-deny Ethernet 1/0/1

# Display the multicast source port suppression state of all the 100M Ethernet ports.

[H3C] display multicast-source-deny interface Ethernet

3.1.6 multicast route-limit

Syntax

multicast route-limit limit

undo multicast route-limit

View

System view

Parameters

limit: Limit on the capacity of the multicast routing table, in the range of 0 to 1,024.

Description

Use the multicast route-limit command to limit the capacity of the multicast routing table. The router will drop the protocol packets and data packets of the new (S, G) if the multicast routing table capacity is exceeded.

Use the undo multicast route-limit command to restore the default capacity of the multicast routing table.

The limit on the multicast routing table capacity is 256 by default.

If the number of existing routing entries exceeds the limit to be configured, the existing entries in the routing table will not be removed. Instead, the system will prompt that the number of existing routing entries is more than the limit to be configured.

If you execute this command again, the new configuration will overwrite the existing configuration.

Examples

# Set the limit on the capacity of the multicast routing table to 100.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] multicast route-limit 100

3.1.7 multicast routing-enable

Syntax

multicast routing-enable

undo multicast routing-enable

View

System view

Parameters

None

Description

Use the multicast routing-enable command to enable the IP multicast routing feature.

Use the undo multicast routing-enable command to disable the IP multicast routing feature.

The IP multicast routing feature is disabled by default.

Examples

# Enable the IP multicast routing feature.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] multicast routing-enable

3.1.8 multicast static-router-port

Syntax

multicast static-router-port interface-type interface-number

undo multicast static-router-port interface-type interface-number

View

VLAN view

Parameters

interface-type: Port type.

interface-number: Port number.

Description

Use the multicast static-router-port command to specify the Ethernet port as the static router port of the current VLAN.

Use the undo multicast static-router-port command to disable the static router port configuration.

By default, no static router port is configured for the VLAN.

Caution:

l Up to 256 static router ports can be configured in a system.

l Reflection ports cannot be configured as static router ports.

l A port in a multicast sub-VLAN cannot be configured as a static router port.

Examples

# Configure Ethernet1/0/1 in VLAN 2 as a static router port.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] vlan 2

[H3C-vlan2] multicast static-router-port Ethernet 1/0/1

3.1.9 multicast static-router-port vlan

Syntax

multicast static-router-port vlan vlan-id

undo multicast static-router-port vlan vlan-id

View

Ethernet port view

Parameters

vlan-id: VLAN ID, in the range of 1 to 4094.

Description

Use the multicast static-router-port vlan command to specify the current port in the VLAN as a static router port.

Use the undo multicast static-router-port vlan command to disable the static router port configuration.

By default, an Ethernet port is not specified as a static router port.

Caution:

l Up to 256 static router ports can be configured in a system.

l Reflection ports cannot be configured as static router ports.

l A port in a multicast sub-VLAN cannot be configured as a static router port.

Examples

# Configure Ethernet1/0/1 in VLAN 2 as a static router port.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface Ethernet 1/0/1

[H3C-Ethernet1/0/1] multicast static-router-port vlan 2

3.1.10 multicast wrongif-holdtime

Syntax

multicast wrongif-holdtime seconds

undo multicast wrongif-holdtime

View

System view

Parameters

seconds: Holdtime to prevent wrongif packets being reported to the CPU, in the range of 0 to 300 seconds. During the configuration, if the seconds argument is less than 15, the system sets the holdtime to 15; if the seconds argument is more than 15, the system sets the holdtime to the multiples of 15 according to the user-defined range. For example, if you set the seconds argument to 14, the system sets the holdtime to 15; if you set the seconds argument to 16, the system sets the holdtime to 30; if you set the seconds argument to 31, the system sets the holdtime to 45, and so on.

Description

Use the multicast wrongif-holdtime command to set the holdtime to prevent wrongif packets being reported to the CPU.

Use the undo multicast wrongif-holdtime command to restore the default holdtime.

By default, the holdtime to prevent wrongif packets being reported to the CPU is 15 seconds.

When the switch receives a multicast packet, the switch will search the multicast forwarding entry according to the source address and destination address of the packet. If the matched forwarding entry is found and the packet is received on the right ingress of the forwarding entry, the packet will be forwarded according to the forwarding entry. If the packet is not received on the right ingress of the forwarding entry, the packet is regarded as a wrongif packet. The wrongif packet will be reported to the CPU.

In some networks, plenty of wrongif packets will be reported to the CPU of the switch, thus aggravating the workload of the switch. In this case, you can configure the holdtime of wrongif packets, so that the wrongif packets will be dropped instead of being forwarded to the CPU of the switch, and the CPU will be prevented from being stricken by too many packets.

In the configured holdtime, wrongif packets are not reported to the CPU, so that the CPU can be prevented from being stricken by too many multicast packets.

Examples

# Set the holdtime of wrongif packets to 60 seconds.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] multicast wrongif-holdtime 60

3.1.11 multicast-source-deny

Syntax

multicast-source-deny enable [ interface interface-list ]

undo multicast-source-deny enable [ interface interface-list ]

View

System view, Ethernet port view

Parameters

interface-list: Specifies Ethernet port list, expressed in the form of interface-list = { { interface-type interface-number | interface-name } [ to { interface-type interface-number | interface-name } ] }&<1-10>. The interface-number argument refers to one single Ethernet port, expressed in the form of interface-number = { interface-type interface-number | interface-name }, where the interface-type argument refers to the port type, the interface-number argument refers to the port number, and the interface-name argument refers to the port name. For meanings and value ranges of the interface-type argument, the interface-number argument and the interface-name argument, refer to the parameters in the section “Port Basic Configuration” in this manual.

Description

Use the multicast-source-deny enable command to enable the multicast source port suppression feature.

Use the undo multicast-source-deny enable command to restore the default setting.

By default, the multicast source port suppression feature is disabled on all the ports.

The multicast source port suppression feature can filter multicast packets on the unauthorized multicast source port in order to avoid the case that the user connected to the port sets the multicast server privately.

In the system view, if the interface-list argument is not specified, the multicast source port suppression feature is enabled globally, that is, the feature is enabled on all the ports of the switch; if the interface-list argument is specified, the multicast source port suppression feature is enabled on the specified ports. In Ethernet port view, the interface-list argument cannot be specified in the command and you can use the command to enable the multicast source port suppression feature on the current port only.

Examples

# Enable the multicast source port suppression feature on all the ports of the switch.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] multicast-source-deny enable

# Enable the multicast source port suppression feature on Ethernet 1/0/1 through Ethernet 1/0/10 and Ethernet 1/0/12.

[H3C] multicast-source-deny enable interface Ethernet 1/0/1 to Ethernet 1/0/10 Ethernet 1/0/12

3.1.12 reset multicast forwarding-table

Syntax

reset multicast forwarding-table [ statistics ] { all | { group-address [ mask { group-mask | group-mask-length } ] | source-address [ mask { source-mask | source-mask-length } ] | incoming-interface interface-type interface-number } * }

View

User view

Parameters

statistics: Clears the statistics information about MFC forwarding entries if this keyword is specified. Otherwise, MFC forwarding entries will be cleared.

all: Refers to all MFC forwarding entries.

group-address: Group address.

group-mask: Mask of the group address.

group-mask-length: Mask length for the group address.

source-address: Source address.

source-mask: Mask of the source address.

source-mask-length: Mask length for the source address.

incoming-interface: Specifies the incoming interface of the forwarding entry.

interface-type interface-number: VLAN interface type and VLAN interface number.

Description

Use the reset multicast forwarding-table command to clear MFC forwarding entries or the statistics information about MFC forwarding entries.

The order of the group-address argument and the source-address argument can be turned over. However, you must input valid group addresses and source addresses. Otherwise, the system prompts error.

Related commands: reset pim routing-table, reset multicast routing-table, display multicast forwarding-table.

Examples

# Clear the forwarding entries with the group address 225.5.4.3 in the MFC forwarding table.

<H3C> reset multicast forwarding-table 225.5.4.3

# Clear the statistics information about the forwarding entries with the group address 225.5.4.3 in the MFC forwarding table.

<H3C> reset multicast forwarding-table statistics 225.5.4.3

3.1.13 reset multicast routing-table

Syntax

reset multicast routing-table { all | { group-address [ mask { group-mask | group-mask-length } ] | source-address [ mask { source-mask | source-mask-length } ] | incoming-interface interface-type interface-number } * }

View

User view

Parameters

all: Specifies all routing entries in the core multicast routing table.

group-address: Group address.

group-mask: Mask for the group address.

group-mask-length: Mask length for the group address.

source-address: Source address.

source-mask: Mask of the source address.

source-mask-length: Mask length of the source address.

incoming-interface: Specifies the incoming interface of the routing entry.

interface-type interface-number: VLAN interface type and VLAN interface number.

Description

Use the reset multicast routing-table command to clear the routing entries in the core multicast routing table and remove the corresponding forwarding entries in the MFC forwarding table.

Related commands: reset pim routing-table, reset multicast forwarding-table, display multicast forwarding-table.

Examples

# Clear the routing entries with the group address 225.5.4.3 from the core multicast routing table.

<H3C> reset multicast routing-table 225.5.4.3

Chapter 4 Multicast MAC Address Entry Configuration Commands

4.1 Multicast MAC Address Entry Configuration Commands

4.1.1 display mac-address multicast

Syntax

display mac-address multicast [ count ]

View

Any view

Parameters

count: Specifies the number of MAC address entries.

Description

Use the display mac-address multicast static command to display the multicast MAC address entry/entries configured on the switch.

Executing this command with the count keyword will display the information about the number of multicast MAC address entries configured on the switch.

Examples

# Display all the multicast MAC address entries manually added in VLAN 1.

<H3C> display mac-address multicast count

1 mac address(es) found

4.1.2 mac-address multicast interface

Syntax

mac-address multicast mac-address interface interface-list vlan vlan-id

undo mac-address multicast [ mac-address [ interface interface-list ] vlan vlan-id ]

View

System view

Parameters

mac-address: Multicast MAC address.

vlan-id: VLAN ID.

interface-list: Forwarding port list, in the format of { { interface-type interface-number } [ to { interface-type interface-number } ] }&<1-10>. Where, the interface-type argument is a port type, the interface-number argument is a port number (refer to the parameter description of the interface command in the Port Basic Configuration Commands in this manual), to is used to specify a port range, and &<1-10> means you can totally specify up to 10 ports and port ranges.

Description

Use the mac-address multicast command to manually create a multicast MAC address entry.

Use the undo mac-address multicast command to remove a multicast MAC address entry.

Each multicast MAC address entry contains: multicast address, forwarding port, VLAN ID, and so on.

Related commands: display mac-address multicast static.

Examples

# Create a multicast MAC address entry belonging to VLAN 1, with the multicast address being 0100-5e0a-0805, and forwarding port being Ethernet 1/0/1.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] mac-address multicast 0100-5e0a-0805 interface Ethernet 1/0/1 vlan 1

Chapter 5 IGMP Configuration Commands

5.1 IGMP Configuration Commands

5.1.1 display igmp group

Syntax

display igmp group [ group-address | interface interface-type interface-number ]

View

Any view

Parameters

group-address: Address of a multicast group.

interface-type interface-number: VLAN interface type and VLAN interface number of the router. This argument is used to specify a VLAN interface.

Description

Use the display igmp group command to view the member information of the IGMP multicast group.

You can specify to view the information of a group or the member information of the multicast group on a VLAN interface. The displayed information contains the multicast groups joining by the downstream hosts through IGMP and the multicast groups joining statically through command lines.

Related commands: igmp host-join.

Examples

# View the member information of multicast groups in the directly-connected subnetwork.

<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 5-1 Description on the fields of the display igmp group command

Field	Description
Group address	Multicast group address
Last Reporter	The last host reporting to join in the multicast group
Uptime	Time since the multicast group is discovered (hh: mm: ss).
Expires	Specifies when the member will be removed from the IGMP multicast group (hh: mm: ss).

5.1.2 display igmp interface

Syntax

display igmp interface [ interface-type interface-number ]

View

Any view

Parameters

interface-type interface-number: VLAN interface type and VLAN interface number of the router. This argument is used to specify a VLAN interface. If this argument is not specified, the information about all the VLAN interfaces running IGMP is displayed.

Description

Use the display igmp interface command to view the IGMP configuration information and running information on a VLAN interface.

Examples

# View the IGMP configuration information and running information of all VLAN 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

Policy to accept IGMP reports: none

Querier for IGMP: 10.153.17.99 (this router)

IGMP group limit is 256

No IGMP group reported

Table 5-2 Description on the fields of the display igmp interface command

Field	Description
IGMP version	IGMP version
query interval	Interval of general query
querier timeout	Timeout time of the querier
max query response time	Maximum query response time
robust count	IGMP robust count, that is, the times of sending IGMP group-specific query messages after the IGMP querier receives an IGMP leave message from a host
startup query interval	The startup interval of IGMP to send query messages
last member query interval	The interval of sending IGMP group-specific query messages when the IGMP querier receives the IGMP leave messages from the host
query timeout	Query timeout time in IGMPv1
Policy to accept IGMP reports	The filtering policy of the IGMP multicast group to control the access to IP multicast groups
Querier for IGMP	IGMP querier
IGMP group limit	Limit on the number of IGMP groups added to the VLAN interface. The router does not process new IGMP messages when the number of IGMP messages exceeds the limit

5.1.3 igmp enable

Syntax

igmp enable

undo igmp enable

View

VLAN interface view

Parameters

None

Description

Use igmp enable command to enable IGMP on the VLAN interface.

Use the undo igmp enable command to disable IGMP on the VLAN interface.

By default, IGMP is disabled on a VLAN interface. .

These commands do not take effect until the multicast routing feature is enabled. Start to configure other IGMP features after this configuration.

Related commands: multicast routing-enable.

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

5.1.4 igmp group-limit

Syntax

igmp group-limit limit

undo igmp group-limit

View

VLAN interface view

Parameters

limit: Quantity of multicast groups, in the range of 0 to 256.

Description

Use the igmp group-limit command to limit the number of multicast groups on the VLAN interface. The router does not process new messages when number of IGMP groups exceeds the limit.

Use the undo igmp group-limit command to restore the default setting.

By default, 256 IGMP groups are added to a VLAN interface.

The new configuration overwrites the old one if you run the command for a second time.

Caution:

l New groups cannot be added when the number of IGMP multicast groups has exceeded the configured limit.

l If the number of existing multicast groups on an interface is more than the configured limit, the system will remove some old groups automatically to satisfy the configured limit.

Examples

# Limit the maximum number of IGMP groups on VLAN-interface10 to 100.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface Vlan-interface 10

[H3C-Vlan-interface10] igmp group-limit 100

5.1.5 igmp group-policy

Syntax

igmp group-policy acl-number [ 1 | 2 | port interface-list ]

undo igmp group-policy [ port interface-list ]

View

VLAN interface view

Parameters

acl-number: Basic IP ACL number, defining a multicast group range. The value ranges from 2000 to 2999.

1: IGMPv1.

2: IGMPv2. If IGMP version is not specified, IGMPv2 will be used by default.

port: Limits the IGMP messages passing the port and matching with the ACL rules.

interface-list: Forwarding port list in the form of interface-list = { interface-type interface-number [ to { interface-type interface-number } ] }&<1-10>. The interface-type argument refers to the port type, and the interface-number argument refers to the port number. For the meanings and ranges of the two arguments, refer to the parameter descriptions in part “Port Basic Configuration” in this manual.

Description

Use the igmp group-policy command to set the filter of multicast groups on the VLAN interface to control the access to IP multicast groups.

Use undo igmp group-policy command to remove the filter configured.

By default, no filter is configured, that is, a host can join any multicast group.

If you do not want the hosts on the network that the VLAN interface is on to join some multicast groups and receive packets from the multicast groups, use this command to limit the range of the multicast groups serviced by the VLAN interface.

Related commands: igmp host-join.

Caution:

Ethernet ports must belong to the igmp-group-policy-enabled VLAN interfaces only.

Examples

# Configure the access-list 2000.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] acl number 2000

[H3C-acl-basic-2000] rule permit source 225.0.0.0 0.255.255.255

[H3C-acl-basic-2000] quit

# Configure that only the hosts matching ACL 2000 rules on VLAN-interface10 can be added to the multicast group whose IGMP version is specified to 2.

[H3C] interface Vlan-interface 10

[H3C-Vlan-interface10] igmp group-policy 2000 2

5.1.6 igmp group-policy vlan

Syntax

igmp group-policy acl-number vlan vlan-id

undo igmp group-policy vlan vlan-id

View

Port view

Parameters

acl-number: Basic IP ACL number, defining a multicast group range. The value ranges from 2000 to 2999.

vlan-id: ID of the VLAN to which the port belongs.

Description

Use the igmp group-policy vlan command to set the filter of multicast groups on the port to control the access to the IP multicast groups.

Use the undo igmp group-policy vlan command to remove the configured filter.

By default, no filter is configured, that is, a host can join any multicast group.

This command has the same function with the igmp group-policy command. Note that the port with the igmp group-policy command enabled must belong to the specified VLAN, and IGMP must be enabled on this port; otherwise, the configuration does not function.

Related commands: igmp group-policy, igmp host-join vlan, gmp host-join port.

Examples

# Configure that only the hosts matching ACL 2000 rules on Ethernet1/0/1 in VLAN-interface10 can be added to the multicast group.

<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 0/1

[H3C-Ethernet0/1] port access vlan 10

[H3C-Ethernet0/1] igmp group-policy 2000 vlan 10

5.1.7 igmp host-join port

Syntax

igmp host-join group-address port interface-list

undo igmp host-join group-address port interface-list

View

VLAN interface view

Parameters

group-address: Multicast address of the multicast group that an interface will join.

port: Specifies the port in the VLAN interface.

Description

Use the igmp host-join port command to enable a port in the VLAN interface of a switch to join a multicast group.

Use undo igmp host-join port command to disable the configuration.

By default, VLAN interfaces of a switch do not belong to any multicast group.

Related commands: igmp group-policy.

Examples

# Add Ethernet 1/0/1 in VLAN-interface10 to the multicast group at 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 1/0/1

5.1.8 igmp host-join vlan

Syntax

igmp host-join group-address vlan vlan-id

undo igmp host-join group-address vlan vlan-id

View

Port view

Parameters

group-address: Multicast address of the multicast group that an interface will join.

vlan-id: ID of the VLAN to which the port belongs.

Description

Use the igmp host-join vlan command to enable an Ethernet port to join a multicast group.

Use the undo igmp host-join vlan command to disable the configuration.

By default, an Ethernet port does not join any multicast group.

Related commands: igmp group-policy.

Examples

# Add Ethernet 1/0/1 in VLAN-interface10 to 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 0/1

[H3C-Ethernet0/1] port access vlan 10

[H3C-Ethernet0/1] igmp host-join 225.0.0.1 vlan 10

5.1.9 igmp lastmember-queryinterval

Syntax

igmp lastmember-queryinterval seconds

undo igmp lastmember-queryinterval

View

VLAN interface view

Parameters

seconds: Interval for the IGMP querier to send IGMP group-specific query messages when it receives IGMP leave messages from the host. It is in the range of 1 second to 5 seconds.

Description

Use the igmp lastmember-queryinterval command to set the interval for the IGMP querier to send IGMP group-specific query messages when it receives IGMP leave messages from the host.

Use the undo igmp lastmember-queryinterval command to restore the default value.

The interval for the IGMP querier to send IGMP group-specific query messages is one second by default.

In the shared network, that is, a same network segment including multiple hosts and multicast routers, the query router (also known as querier) is responsible for maintaining the IGMP group membership on the VLAN interface. When an IGMPv2 host leaves a group, it sends an IGMP leave message.

When receiving the IGMP leave message, the IGMP querier must send the IGMP group-specific query messages for specified times (by the robust-value argument in the igmp robust-count command, with default value as 2) in a specified time interval (by the seconds argument in the igmp lastmember-queryinterval command, with default value as 1 second). If other hosts interested in the specified group receive the IGMP query message from the IGMP query router, they will send back the IGMP Membership Report message within the specified maximum response time interval. If it receives the IGMP Membership Report message within the defined period (equal to robust-value ´ seconds), the IGMP query router continues to maintain the membership of this group. When receiving no IGMP Membership Report message from any host within the defined period, the IGMP query router considers it as timeout and stops membership maintenance for the group.

This command is only available on the IGMP query router running IGMPv2. For the host running IGMPv1, this command cannot take effect because the host does not send any IGMP leave message when it leaves a group.

Related commands: igmp robust-count, display igmp interface.

Examples

# Set the query interval on VLAN-interface10 to 3 seconds.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface Vlan-interface 10

[H3C-Vlan-interface10] igmp lastmember-queryinterval 3

5.1.10 igmp max-response-time

Syntax

igmp max-response-time seconds

undo igmp max-response-time

View

VLAN interface view

Parameters

seconds: Maximum response time in the IGMP query messages in second in the range of 1 to 25. By default, the value is 10 seconds.

Description

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.

The maximum query response time is 10 seconds by default.

The maximum query response time determines the period for a router to quickly detect that there are no more directly connected group members in a LAN.

Related commands: display igmp group.

Examples

# Set the query maximum response time carried in host-query messages to 8 seconds.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface Vlan-interface 10

[H3C-Vlan-interface10] igmp max-response-time 8

5.1.11 igmp proxy

Syntax

igmp proxy Vlan-interface interface-number

undo igmp proxy

View

Interface view

Parameters

interface-number: Proxy interface number.

Description

Use the igmp proxy command to specify an interface of the Layer 3 endpoint switch as the IGMP proxy interface of another interface.

Use the undo igmp proxy command to disable this configuration.

The IGMP proxy feature is disabled by default.

You must enable the PIM protocol on the interface first before enabling the igmp proxy command on the interface. Only one IGMP proxy interface can be configured for an interface.

If the IGMP proxy feature is configured on the same interface for multiple times, the latest configuration takes effect.

Related commands: pim neighbor-policy.

Caution:

Only one IGMP proxy interface can be configured for an interface.

Examples

# Configure VLAN-interface 2 as the IGMP proxy interface of VLAN-interface 1 on the Layer 3 switch.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] multicast routing-enable

[H3C] interface vlan-interface 1

[H3C-Vlan-interface1] igmp enable

[H3C- Vlan-interface1] igmp proxy vlan-interface 2

5.1.12 igmp report-aggregation

Syntax

igmp report-aggregation

undo igmp report-aggregation

View

System view

Parameters

None

Description

Use the igmp report-aggregation command to enable suppression on Layer 3 multicast IGMP report messages. On an IP-multicast-routing-enabled switch, the VLAN interface receives only the first IGMP report message from a multicast group in a query interval.

Use the undo igmp report-aggregation command to disable suppression on Layer 3 multicast IGMP report messages.

By default, suppression on IGMP report messages is disabled.

& Note:

l You must enable IP multicast routing globally before configuring suppression on IGMP report messages.

l If IP multicast routing is disabled globally, suppression on IGMP report messages is disabled simultaneously.

Examples

# Enable suppression on Layer 3 multicast IGMP report messages on the switch.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] multicast routing-enable

[H3C] igmp report-aggregation

5.1.13 igmp robust-count

Syntax

igmp robust-count robust-value

undo igmp robust-count

View

VLAN interface view

Parameters

robust-value: IGMP robust value, times of sending the IGMP group-specific query messages after the IGMP querier receives the IGMP Leave message from the host. It is in the range of 2 times to 5 times.

Description

Use the igmp robust-count command to set the times of sending the IGMP group query message after the IGMP query router receives the IGMP Leave message from the host.

Use the undo igmp robust-count command to restore the default value.

By default, an IGMP querier sends IGMP group-specific query messages twice.

In the shared network, that is, a same network segment including multiple hosts and multicast routers, the query router is responsible for maintaining the IGMP group membership on the interface. When an IGMPv2 host leaves a group, it sends an IGMP Leave message. When receiving the IGMP Leave message, the IGMP query router must send the IGMP group-specific query message for specified times (by the robust-value argument in the igmp robust-count command, with default value as 2) in a specified time interval (by the seconds argument in the igmp lastmember-queryinterval command, with default value as 1 second). If other hosts interested in the specific group receive the IGMP group-specific query messages from the IGMP query router, they will send back the IGMP Membership Report messages within the specified maximum response time. If it receives the IGMP Membership Report messages within the defined period (equal to robust-value ´ seconds), the IGMP query router continues to maintain the membership of this group. When receiving no IGMP Membership Report message from any host within the defined period, the IGMP query router considers it as timeout and stops membership maintenance for the group.

This command is only available on the IGMP query router running IGMPv2. For the host running IGMPv1, this command cannot take effect because the host does not send IGMP Leave messages when it leaves a group.

Related commands: igmp lastmember-queryinterval, display igmp interface.

Examples

# Set the robust value of the VLAN-interface 10 to 3.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface Vlan-interface 10

[H3C-Vlan-interface10] igmp robust-count 3

5.1.14 igmp timer other-querier-present

Syntax

igmp timer other-querier-present seconds

undo igmp timer other-querier-present

View

VLAN interface view

Parameters

seconds: Presence time of the IGMP querier, in the range of 1 to 131,070 in seconds.

Description

Use the igmp timer other-querier-present command to configure the presence time of the IGMP querier.

Use the undo igmp timer other-querier-present command to restore the default value.

By default, the presence time of the IGMP querier is twice the value of IGMP query message interval, that is, 120 seconds.

On a shared network with multiple multicast routers on the same network segment, the query router (querier for short) takes charge of sending query messages periodically on the interface. If other non-queriers receive no query messages within the valid period, the router will consider the previous querier to be invalid and the router itself becomes a querier.

In IGMPv1, querier selection is determined by the multicast routing protocol. In IGMPv2, 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 querier to expire after 300 seconds.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface Vlan-interface 10

[H3C-Vlan-interface10] igmp timer other-querier-present 300

5.1.15 igmp timer query

Syntax

igmp timer query seconds

undo igmp timer query

View

VLAN interface view

Parameters

seconds: Interval at which a router transmits IGMP query messages, in the range of 1 to 65,535 seconds.

Description

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, a router interface transmits IGMP query messages at the interval of 60 seconds.

A multicast router periodically sends out IGMP query messages to attached segments to find hosts that belong to different multicast groups. The query interval can be modified according to the practical conditions of the network.

Related commands: igmp timer other-querier-present.

Examples

# Configure VLAN-interface 2 to transmit host-query messages every 150 seconds.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface Vlan-interface 2

[H3C-Vlan-interface2] igmp timer query 150

5.1.16 igmp version

Syntax

igmp version { 1 | 2 }

undo igmp version

View

VLAN interface view

Parameters

1: IGMPv1.

2: IGMPv2.

Description

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 default IGMP version is IGMPv2.

IGMP version on a router cannot be switched automatically. All routers on a subnet must adopt the same IGMP version.

Examples

# Run IGMPv1 on VLAN-interface10.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface Vlan-interface 10

[H3C-Vlan-interface10] igmp version 1

5.1.17 reset igmp group

Syntax

reset igmp group { all | interface interface-type interface-number { all | group-address [ group-mask ] } }

View

User view

Parameters

all: Specifies all IGMP groups.

interface-type interface-number: VLAN interface type and VLAN interface number.

group-address: IGMP group address.

group-mask: Mask of IGMP group address.

Description

Use the reset igmp group command to remove an existing IGMP group from the VLAN interface. The removed group can be added to the VLAN interface again.

Examples

# Remove all IGMP groups on all the VLAN interfaces.

<H3C> reset igmp group all

# Remove all IGMP groups on VLAN-interface10.

<H3C> reset igmp group interface Vlan-interface10 all

# Remove the group 225.0.0.1 from VLAN-interface10.

<H3C> reset igmp group interface Vlan-interface10 225.0.0.1

# Remove the IGMP groups ranging from 225.1.1.0 to 225.1.1.255 on VLAN-interface10.

<H3C> reset igmp group interface Vlan-interface10 225.1.1.0 255.255.255.0

Chapter 6 PIM Configuration Commands

6.1 PIM Configuration Commands

6.1.1 bsr-policy

Syntax

bsr-policy acl-number

undo bsr-policy

View

PIM view

Parameters

acl-number: ACL number adopted in BSR filtering policy, in the range of 2,000 to 2,999.

Description

Use the bsr-policy command to limit the range of legal BSRs to prevent BSR proofing.

Use the undo bsr-policy command to restore the default setting, that is, no range limit is set and all received messages are taken as legal.

In the PIM SM network using BSR (bootstrap router) mechanism, every router can set itself as C-BSR (candidate BSR) and take the authority to advertise RP information in the network once it wins in the BSR election. To prevent malicious BSR proofing in the network, the following two measures need to be taken:

l Prevent the router from being spoofed by hosts though faking legal BSR messages to modify RP mapping. BSR messages are multicast messages with their TTL values being 1, so this type of attacks often strike edge routers. Fortunately, BSRs are inside the network, while assaulting hosts are outside, therefore neighbor and RPF checks can be used to guard against this type of attacks.

l If a router in the network is manipulated by an attacker, or an illegal router is accessed into the network, the attacker may set itself as a C-BSR and try to win the BSR election to gain the authority to advertise RP information within the network. Since the router configured as a C-BSR shall propagate BSR messages, which are multicast messages sent hop by hop with TTL as 1, throughout the network, then the network will be affected as long as the peer routers do not receive these BSR messages. One solution is to configure the bsr-policy command on each router to define the legal BSR range, for example, only 1.1.1.1/32 and 1.1.1.2/32 can be BSR, thus the routers cannot receive or forward BSR messages other than these two. Even legal BSRs cannot contest with them.

Problems may still exist if a legal BSR is attacked, though these two measures can effectively guarantee high BSR security.

The source keyword in the rule command is translated into the BSR address in the bsr-policy command.

Related commands: acl, rule.

Examples

# Configure BSR filtering policy on routers to specify 101.1.1.1/32 as the only legal BSR.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] multicast routing-enable

[H3C] pim

[H3C-pim] bsr-policy 2000

[H3C-pim] quit

[H3C] acl number 2000

[H3C-acl-basic-2000] rule 0 permit source 101.1.1.1 0

6.1.2 c-bsr

Syntax

c-bsr interface-type interface-number hash-mask-len [ priority ]

undo c-bsr

View

PIM view

Parameters

interface-type interface-number: Specifies the VLAN interface. The candidate BSR is configured on the VLAN interface. PIM-SM must be enabled on the VLAN interface first.

hash-mask-len: Length of the mask. The operation of searching RP is performed after performing “and” operation using the mask and the multicast address. The value ranges from 0 to 32.

priority: Priority of the candidate BSR. The larger the value of the priority, the higher the priority of the BSR. The value ranges from 0 to 255. By default, the priority is 0.

Description

Use the c-bsr command to configure a candidate BSR.

Use the undo c-bsr command to remove the candidate BSR configured.

By default, no candidate BSR is set.

During candidate BSR configuration, a larger bandwidth should be guaranteed since a great amount of information will be exchanged between BSR and other devices in the PIM domain.

Related commands: pim sm.

Examples

# Configure the switch as a candidate BSR with priority 2 (and the C-BSR address is designated as the IP address of VLAN-interface10).

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] multicast routing-enable

[H3C] pim

[H3C-pim] c-bsr vlan-interface 10 24 2

6.1.3 c-rp

Syntax

c-rp interface-type interface-number [ group-policy acl-number | priority priority-value ]*

undo c-rp { interface-type interface-number | all }

View

PIM view

Parameters

interface-type interface-number: Specifies the VLAN interface whose IP address is advertised as a candidate RP address.

acl-number: Number of the basic ACL that defines a group range, which is the service range of the advertised RP. The value ranges from 2000 to 2999.

priority-value: Priority value of the candidate RP, in the range of 0 to 255. A larger value corresponds to a lower priority level.

all: Removes all candidate RP configurations.

Description

Use the c-rp command to configure the router to advertise itself as a candidate RP to the BSR.

Use the undo c-rp command to remove the configuration.

By default, no candidate RP is configured, and the value of RP priority is 0.

During candidate RP configuration, a relatively large bandwidth should be reserved for the router and other devices in the PIM domain.

Related commands: c-bsr.

Examples

# Configure the switch to advertise to the BSR that the switch itself is the C-RP in the PIM domain. Basic ACL 2000 defines the range of groups related to the RP. The address of C-RP is designated as the IP address of VLAN-interface10.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] multicast routing-enable

[H3C] acl number 2000

[H3C-acl-basic-2000] rule permit source 225.0.0.0 0.255.255.255

[H3C] pim

[H3C-pim] c-rp vlan-interface 10 group-policy 2000

6.1.4 crp-policy

Syntax

crp-policy acl-number

undo crp-policy

View

PIM view

Parameters

acl-number: ACL number adopted in C-RP filtering policy, ranging from 3000 to 3999.

Description

Use the crp-policy command to limit the range of legal C-RP, as well as target service group range of each C-RP, and prevent C-RP proofing.

Use the undo crp-policy command to restore the default setting, that is, no range limit is set and all received messages are taken as legal.

In a PIM SM network using BSR mechanism, every router can set itself as C-RP (candidate rendezvous point) serving particular groups. If elected as a RP, a C-RP becomes the RP serving the current group range.

In BSR mechanism, a C-RP router unicasts C-RP information to the BSR, which then propagates the C-RP information throughout the network by means of BSR message.

To prevent C-RP spoofing, you need to configure the crp-policy command on the BSR to limit legal C-RP range and their service group ranges. Since each C-BSR has the chance to become BSR, you must configure the same filtering policy on each C-BSR router.

This command uses the ACLs numbered between 3000 and 3999. The source keyword in the rule command is translated into a C-RP address in the crp-policy command, and the destination keyword into the service group range of this C-RP address. For the received C-RP messages, only when their C-RP addresses match the source keyword and their service group address range is the subset of that in the ACL, can the C-RP be considered as matched.

Related commands: acl, rule.

Examples

# Configure C-RP filtering policy on the C-BSR routers, allowing only 1.1.1.1/32 to function as the C-RP to serve only the group range 225.1.0.0/16.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] multicast routing-enable

[H3C] pim

[H3C-pim] crp-policy 3000

[H3C-pim] quit

[H3C] acl number 3000

[H3C-acl-adv-3000] rule 0 permit source 1.1.1.1 0 destination 225.1.0.0 0.0.255.255

6.1.5 display pim bsr-info

Syntax

display pim bsr-info

View

Any view

Parameters

None

Description

Use the display pim bsr-info command to view the BSR information.

Related commands: c-bsr, c-rp.

Examples

# Display the BSR information.

<H3C> display pim bsr-info

Current BSR Address: 20.20.20.30

Priority: 0

Mask Length: 30

Expires: 00:01:55

Local host is BSR

Table 6-1 Description on the fields of the display pim bsr-info command

Field	Description
BSR	Bootstrap router
Priority	Priority of the BSR
Mask Length: 30	Length of the mask
Expires: 00:01:55	Value of the timer

6.1.6 display pim interface

Syntax

display pim interface [ interface-type interface-number ]

View

Any view

Parameters

interface-type interface-number: Interface type and interface number, used to specify a VLAN interface.

Description

Use the display pim interface command to view the PIM configuration information of the VLAN interface.

If neither the VLAN interface type nor the VLAN interface number is specified, the PIM configuration information of all VLAN interfaces is displayed; if both the VLAN interface type and the VLAN interface number are specified, the PIM configuration information about the specified VLAN interface is displayed.

Examples

# Display the PIM configuration information about the specified VLAN interface.

<H3C> display pim interface

PIM information of VLAN-interface 2:

IP address of the interface is 10.10.1.20

PIM is enabled on interface

PIM version is 2

PIM mode is Sparse

PIM query interval is 30 seconds

PIM neighbor limit is 128

PIM neighbor policy is none

Total 1 PIM neighbor on interface

PIM DR(designated router) is 10.10.1.20

Table 6-2 Description on the fields of the display pim interface command

Field	Description
PIM version	Version of PIM
PIM mode	PIM mode enabled on the VLAN interface (DM or SM)
PIM query interval	Hello message interval
PIM neighbor limit	Limit on the number of PIM neighbors on the VLAN interface. No neighbor can be added any more when the limit is reached.
PIM neighbor policy	Filtering policy of the PIM neighbors on the current interface
PIM DR	Designated router

6.1.7 display pim neighbor

Syntax

display pim neighbor [ interface interface-type interface-number ]

View

Any view

Parameters

interface-type interface-number: Interface type and interface number, used to specify the VLAN interface.

Description

Use the display pim neighbor command to view the PIM neighbor information discovered by the VLAN interface of the switch. If the VLAN interface parameter is specified, only the PIM neighbor information about the specified VLAN interface is displayed.

Examples

# Display the PIM neighbor information discovered by the VLAN interface of the switch.

<H3C> display pim neighbor

Neighbor’s Address Interface Name Uptime Expires

8.8.8.6 VLAN-interface10 00:00:16 00:01:30

Table 6-3 Description on the fields of the display pim neighbor command

Field	Description
Neighbor’s Address	Neighbor address
Interface name	Number of the VLAN interface where the neighbor is discovered
Uptime	Time passed since the multicast group has been discovered
Expires	Specifies when the neighbor will be removed from the group table

6.1.8 display pim routing-table

Syntax

display pim routing-table [ { { *g [ group-address [ mask { mask-length | mask } ] ] | **rp [ rp-address [ mask { mask-length | mask } ] ] } | { group-address [ mask { mask-length | mask } ] | source-address [ mask { mask-length | mask } ] } * } | incoming-interface { interface-type interface-number | null } | { dense-mode | sparse-mode } ] *

View

Any view

Parameters

**rp: Specifies an (*, *, RP) route entry.

*g: Specifies an (*, G) route entry.

mask: IP address mask.

mask-length: Length of IP address mask.

rp-address: Address of the RP.

group-address: Address of the multicast group.

source-address: IP address of the multicast source.

incoming-interface interface-type interface-number: Views the route entries whose incoming VLAN interface is the specified VLAN interface.

null: Specifies the VLAN interface type as Null.

dense-mode: Specifies the multicast routing protocol as PIM-DM.

sparse-mode: Specifies the multicast routing protocol as PIM-SM.

Description

Use the display pim routing-table command to view the information about the PIM multicast routing table.

The displayed information about the PIM multicast routing table includes the SPT information and RPF information.

Examples

# Display the information about the PIM multicast routing table.

<H3C> display pim routing-table

PIM-SM Routing Table

Total 0 (*,*,RP)entry, 0 (*,G)entry, 2 (S,G)entries

(192.168.1.2, 224.2.178.130),

Protocol 0x20: PIMSM, Flag 0x4: SPT

UpTime: 23:59, Timeout after 196 seconds

Upstream interface: VLAN-interface2, RPF neighbor: NULL

Downstream interface list: NULL

(192.168.1.2, 224.2.181.90),

Protocol 0x20: PIMSM, Flag 0x4: SPT

UpTime: 23:59, Timeout after 196 seconds

Upstream interface: VLAN-interface2, RPF neighbor: NULL

Downstream interface list: NULL

Total 2 entries listed

Table 6-4 Description on the fields of the display routing-table command

Field	Description
RP	Rendezvous point
(S,G)	(source address, multicast group)
PIM-SM	PIM sparse mode
SPT	Shortest path tree
RPF	Reverse path forwarding

6.1.9 display pim rp-info

Syntax

display pim rp-info [ group-address ]

View

Any view

Parameters

group-address: Address of the group to be displayed. If no multicast group is specified, the RP information about all multicast groups will be displayed.

Description

Use the display pim rp-info command to view the RP information of the specified multicast group.

In addition, this command can also display the BSR and static RP information.

Examples

# View the RP information of the specified multicast group

<H3C> display pim rp-info

PIM-SM RP-SET information:

BSR is: 4.4.4.6

Group/MaskLen: 224.0.0.0/4

RP 4.4.4.6

Version: 2

Priority: 0

Uptime: 00:39:50

Expires: 00:01:40

Table 6-5 Description on the fields of the display pim rp-info command

Field	Description
PIM-SM RP-SET information:	Combination of RP information sets
BSR is: 4.4.4.6	BSR is the VLAN interface of 4.4.4.6 in the network
Group/MaskLen: 224.0.0.0/4 RP 4.4.4.6 Version: 2 Priority: 0 Uptime: 00:39:50 Expires: 00:01:40	The RP with group address being 224.0.0.0 and mask length being 4 is the virtual interface of the IP address 4.4.4.6. The priority of the version 2 RP is 0. It is up for 39 minutes and 50 seconds and expires in one minute and forty seconds.

6.1.10 pim

Syntax

pim

undo pim

View

System view

Parameters

None

Description

Use the pim command to enter PIM view to configure the global PIM parameters. You cannot use the pim command to enable PIM.

Use the undo pim command to exit PIM view to system view and clear the global PIM configuration parameters.

Examples

# Enter PIM view.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] multicast routing-enable

[H3C] pim

[H3C-pim]

6.1.11 pim bsr-boundary

Syntax

pim bsr-boundary

undo pim bsr-boundary

View

VLAN interface view

Parameters

None

Description

Use the pim bsr-boundary command to configure a VLAN interface of the switch as the PIM domain boundary.

Use the undo pim bsr-boundary command to remove the configured PIM domain boundary.

The switch does not set any PIM domain boundary by default.

After you use this command to set a PIM domain boundary on a VLAN interface, all Bootstrap messages cannot cross this domain boundary. However, the other PIM packets can pass this domain boundary. In this way, you can divide the network running PIM-SM into multiple domains, each of which uses a different Bootstrap router.

Note that you cannot use this command to set up a multicast boundary. Instead, what you use this command to set up is just a PIM Bootstrap message boundary.

Related commands: c-bsr.

Examples

# Configure a domain boundary on VLAN-interface10.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] multicast routing-enable

[H3C] interface Vlan-interface 10

[H3C-Vlan-interface10] pim bsr-boundary

6.1.12 pim dm

Syntax

pim dm

undo pim dm

View

VLAN interface view

Parameters

None

Description

Use the pim dm command to enable PIM-DM.

Use the undo pim dm command to disable PIM-DM.

By default, PIM-DM is disabled.

Before enabling PIM DM, make sure that multicast routing protocol has been enabled by using the multicast routing-enable command.

Examples

# Enable PIM-DM on VLAN-interface10 of the Ethernet switch.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] multicast routing-enable

[H3C] interface Vlan-interface 10

[H3C-Vlan-interface10] pim dm

6.1.13 pim neighbor-limit

Syntax

pim neighbor-limit limit

undo pim neighbor-limit

View

VLAN interface view

Parameters

limit: Upper limit on the number of PIM neighbors on the VLAN interface, in the range of 0 to 128.

Description

Use the pim neighbor-limit command to limit the number PIM neighbors on a router interface. No neighbor can be added to the router any more when the limit is reached.

Use the undo pim neighbor-limit command to restore the default setting.

By default, the number of PIM neighbors on a VLAN interface is limited within 128.

If the number of existing PIM neighbors exceeds the configured limit, they will not be removed.

Examples

# Limit the number of PIM neighbors on VLAN-interface10 within 50.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] multicast routing-enable

[H3C] interface Vlan-interface 10

[H3C-Vlan-interface10] pim neighbor-limit 50

6.1.14 pim neighbor-policy

Syntax

pim neighbor-policy acl-number

undo pim neighbor-policy

View

VLAN interface view

Parameters

acl-number: Basic ACL number, in the range of 2000 to 2999.

Description

Use the pim neighbor-policy command to configure the router to filter the PIM neighbors on the current VLAN interface.

Use the undo pim neighbor-policy command to disable the filtering.

Only the routers matching the filtering rule in the ACL can act as a PIM neighbor of the current VLAN interface.

The new configuration overwrites the old one if you run the command for a second time.

Examples

# Configure that 10.10.1.2 can act as a PIM neighbor of VLAN-interface10, but 10.10.1.1 cannot act as a PIM neighbor of VLAN-interface 10.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] multicast routing-enable

[H3C] interface Vlan-interface 10

[H3C-Vlan-interface10] pim neighbor-policy 2000

[H3C-Vlan-interface10] quit

[H3C] acl number 2000

[H3C-acl-basic-2000] rule permit source 10.10.1.2 0

[H3C-acl-basic-2000] rule deny source 10.10.1.1 0

6.1.15 pim sm

Syntax

pim sm

undo pim sm

View

VLAN interface view

Parameters

None

Description

Use the pim sm command to enable the PIM-SM protocol.

Use the undo pim sm command to disable the PIM-SM protocol.

By default, the switch disables the PIM-SM protocol.

You must enable the PIM-SM protocol on each VLAN interface respectively. Generally, the PIM-SM protocol is enabled on each VLAN interface.

Related commands: multicast routing-enable.

Examples

# Enable the PIM-SM protocol on VLAN-interface10.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] multicast routing-enable

[H3C] interface Vlan-interface 10

[H3C-Vlan-interface10] pim sm

6.1.16 pim timer hello

Syntax

pim timer hello seconds

undo pim timer hello

View

VLAN interface view

Parameters

seconds: Interval at which a VLAN interface sends Hello messages, in the range of 1 second to 18,000 seconds.

Description

Use the pim timer hello command to set the interval at which a VLAN interface sends Hello messages.

Use the undo pim timer hello command to restore the default value of the interval.

By default, a VLAN interface sends Hello messages at the interval of 30 seconds.

When the PIM-SM protocol is enabled on a VLAN interface, the switch will periodically send Hello messages to the network devices supporting PIM. If the VLAN interface receives Hello messages, it means that the VLAN interface has neighboring network devices supporting PIM, and the VLAN interface will add the neighbors into its own neighbor list. If the VLAN interface does not receive any Hello message from a neighbor in its neighbor list within the specified time, the neighbor is considered to have left the multicast group.

Examples

# Configure VLAN-interface 10 of the switch to send Hello message at the interval of 40 seconds.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] multicast routing-enable

[H3C] interface Vlan-interface 10

[H3C-Vlan-interface10] pim timer hello 40

6.1.17 register-policy

Syntax

register-policy acl-number

undo register-policy

View

PIM view

Parameters

acl-number: Number of advanced IP ACL, defining the rule of filtering the source and group addresses. The value ranges from 3000 to 3999.

Description

Use the register-policy command to configure a RP to filter the register messages sent by the DR in the PIM-SM network and to accept the specified packets only.

Use the undo register-policy command to remove the packet filtering configuration.

Examples

# Configure RP to filter register messages from the DRs and receive only register messages whose multicast source is 10.10.0.0/16 and the multicast group 255.1.0.0/16.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] acl number 3010

[H3C-acl-adv-3010] rule permit ip source 10.10.0.0 0.0.255.255 destination 225.1.0.0 0.0.255.255

[H3C-acl-adv-3010] quit

[H3C] multicast routing-enable

[H3C] pim

[H3C-pim] register-policy 3010

6.1.18 reset pim neighbor

Syntax

reset pim neighbor { all | { neighbor-address | interface interface-type interface-number } * }

View

User view

Parameters

all: Specifies all PIM neighbors.

neighbor-address: Neighbor address.

interface interface-type interface-number: Specifies a VLAN interface.

Description

Use the reset pim neighbor command to clear all PIM neighbors or PIM neighbors on the specified VLAN interface.

Related commands: display pim neighbor.

Examples

# Clear the PIM neighbor 25.5.4.3.

<H3C> reset pim neighbor 25.5.4.3

6.1.19 reset pim routing-table

Syntax

reset pim routing-table { all | { group-address [ mask group-mask | mask-length group-mask-length ] | source-address [ mask source-mask | mask-length source-mask-length ] | { incoming-interface interface-type interface-number } } * }

View

User view

Parameters

all: Specifies all PIM route entries.

group-address: Group address.

mask group-mask: Specifies the mask for a group address.

group-mask-length: Length of the group address mask.

source-address: Source address.

mask source-mask: Specifies the mask for source address.

source-mask-length: Length of the source address mask.

incoming-interface: Specifies the incoming interface for the route entry in the PIM routing table.

interface-type interface-number: VLAN interface type and VLAN interface number to specify a VLAN interface.

Description

Use the reset pim routing-table command to clear all PIM route entries or the specified PIM route entry.

You can type in the source address first and then the group address in the command, as long as they are valid. Error information will be given if you type in invalid addresses.

l If in this command, the group-address is 224.0.0.0/4 and source-address is the RP address (where group address can have a mask, but the resulted IP address must be 224.0.0.0, and source address has no mask), then it means only the (*, *, RP) entries will be removed.

l If in this command, the group-address argument is any a group address, and the source-address argument is 0 (where the group address can have a mask, and the source address has no mask), then only the (*, G) entries will be removed.

This command shall remove not only multicast route entries from the PIM routing table, but also the corresponding route entries or forwarding entries in the core multicast routing table and multicast forwarding cache (MFC).

Related commands: reset multicast routing-table, reset multicast forwarding-table, display pim routing-table.

Examples

# Remove the route entries with group address 225.5.4.3 from the PIM routing table.

<H3C> reset pim neighbor 25.5.4.3

6.1.20 source-policy

Syntax

source-policy acl-number

undo source-policy

View

PIM view

Parameters

acl-number: Basic or advanced ACL number, in the range of 2000 to 3999.

Description

Use the source-policy command to configure the router to filter the received multicast data packets according to the source address or group address.

Use the undo source-policy command to remove the configuration.

l If source address filtering is configured, as well as basic ACLs, then the router filters the source addresses of all received multicast data packets. Those failing to match the ACL will be discarded.

l If source address filtering is configured, as well as advanced ACLs, then the router filters the source addresses and group addresses of all received multicast data packets. Those failing to match the ACL will be discarded.

When this feature is configured, the router filters not only multicast data, but also multicast data encapsulated in register message.

The new configuration overwrites the old one if you run the command for a second time.

Examples

# Set to receive the multicast data packets from source address 10.10.1.2, but discard those from 10.10.1.1.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] multicast routing-enable

[H3C] pim

[H3C-pim] source-policy 2000

[H3C-pim] quit

[H3C] acl number 2000

[H3C-acl-basic-2000] rule permit source 10.10.1.2 0

[H3C-acl-basic-2000] rule deny source 10.10.1.1 0

6.1.21 static-rp

Syntax

static-rp rp-address [ acl-number ]

undo static-rp

View

PIM view

Parameters

rp-address: Static RP address, only being legal unicast IP address.

acl-number: Basic ACL used to control the range of multicast groups served by the static RP, which ranges from 2000 to 2999. If an ACL is not specified upon configuration, static RP will serve all multicast groups; if an ACL is specified, static RP will only serve the multicast group passing the ACL.

Description

Use the static-rp command to configure a static RP.

Use the undo static-rp command to remove the configuration.

The static RP function as the backup of the dynamic RP so as to improve the network robustness. If the RP elected by BSR mechanism is valid, the static RP will not work. This command must be configured on all routers in the PIM domain and the same RP address must be configured for all routers in the domain.

The new configuration overwrites the old one if you execute the command for a second time.

Related commands: display pim rp-info.

Examples

# Configure 10.110.0.6 as a static RP.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] multicast routing-enable

[H3C] pim

[H3C-pim] static-rp 10.110.0.6

H3C S7500 Series Command Manual(Release 3100 Series)-(V1.04)

1.1.3 gmrp

Chapter 2 IGMP Snooping Configuration Commands

2.1.3 display igmp-snooping statistics

2.1.7 igmp-snooping group-limit

2.1.8 igmp-snooping group-policy

2.1.12 igmp-snooping router-aging-time

Chapter 3 Common IP Multicast Configuration Commands

3.1.5 display multicast-source-deny

Chapter 4 Multicast MAC Address Entry Configuration Commands

5.1 IGMP Configuration Commands

5.1.1 display igmp group

5.1.4 igmp group-limit

5.1.7 igmp host-join port

5.1.13 igmp robust-count

5.1.16 igmp version

5.1.17 reset igmp group

6.1 PIM Configuration Commands

6.1.5 display pim bsr-info

Cloud & AI

InterConnect

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Resources

Partner Business Management

Company Information

News & Events

Contact Us