Command Manual Common Multicast Configuration
Quidway S8500 Series Routing Switches Table of Contents
Huawei Proprietary and Confidential
Copyright (c) Huawei Technologies Co., Ltd
i
Table of Contents
Chapter 1 Common Multicast Configuration Commands ......................................................... 1-1
1.1 Common Multicast Configuration Commands................................................................... 1-1
1.1.1 broadcast-suppression............................................................................................ 1-1
1.1.2 debugging multicast forwarding .............................................................................. 1-2
1.1.3 debugging multicast kernel-routing......................................................................... 1-2
1.1.4 debugging multicast status-forwarding ................................................................... 1-2
1.1.5 display mpm forwarding-table ................................................................................. 1-2
1.1.6 display mpm group.................................................................................................. 1-2
1.1.7 display multicast forwarding-table........................................................................... 1-2
1.1.8 display multicast routing-table................................................................................. 1-2
1.1.9 multicast route-limit ................................................................................................. 1-2
1.1.10 multicast routing-enable........................................................................................ 1-2
1.1.11 multicast-suppression ........................................................................................... 1-2
1.1.12 reset multicast forwarding-table ............................................................................ 1-2
1.1.13 reset multicast routing-table.................................................................................. 1-2
Command Manual Common Multicast Configuration
Quidway S8500 Series Routing Switches
Chapter 1 Common Multicast Configuration
Commands
Huawei Proprietary and Confidential
Copyright (c) Huawei Technologies Co., Ltd
1-1
Chapter 1 Common Multicast Configuration
Commands
1.1 Common Multicast Configuration Commands
1.1.1 broadcast-suppression
Syntax
broadcast-suppression { ratio | bandwidth bandwidth }
undo broadcast-suppression
View
Ethernet port view
Parameters
ratio: Maximum wire speed ratio in percents of the broadcast traffic allowed on the port.
The value range is 1 to 100, and the default value is 50. The smaller the ratio is, the
smaller the broadcast traffic is allowed to pass.
bandwidth: Broadcast suppression bandwidth in Mbps on the port. The value ranges
from 1 to the maximum value of port bandwidth.
Description
Use the broadcast-suppression command to set the broadcast suppression ratio or
broadcast suppression bandwidth.
Use the undo broadcast-suppression command to restore the default setting.
The default broadcast suppression ratio is 50%.
You can use the broadcast-suppression command repeatedly. The effective
broadcast suppression ratio is the one last updated.
Chapter 1 Common Multicast Configuration
Commands
Command Manual Common Multicast Configuration
Quidway S8500 Series Routing Switches
1-2 Huawei Proprietary and Confidential
Copyright (c) Huawei Technologies Co., Ltd
Caution:
You cannot enable both broadcast suppression and multicast suppression
simultaneously on the same card. Namely, once you have enabled broadcast
suppression on some ports of a card, you cannot enable multicast suppression on
the other ports of the card, and vice versa.
If multicast suppression is enabled, broadcast packets are also suppressed at the
same time, while broadcast suppression does not work on multicast suppression.
Related commands: multicast-suppression.
Examples
# Set the broadcast suppression ratio to 40%.
<Quidway> system-view
System View: return to User View with Ctrl+Z.
[Quidway] interface ethernet 2/1/1
[Quidway-Ethernet2/1/1] broadcast-suppression 40
# Set the broadcast suppression bandwidth to 40 Mbps.
[Quidway-Ethernet2/1/1] broadcast-suppression bandwidth 40
# Disable broadcast suppression.
[Quidway-Ethernet2/1/1] undo broadcast-suppression
1.1.2 debugging multicast forwarding
Syntax
debugging multicast forwarding
undo debugging multicast forwarding
View
User view
Parameters
None
Description
Use the debugging multicast forwarding command to enable the multicast packet
forwarding debugging function.
Use the undo debugging multicast forwarding command to disable the debugging
function.
Command Manual Common Multicast Configuration
Quidway S8500 Series Routing Switches
Chapter 1 Common Multicast Configuration
Commands
Huawei Proprietary and Confidential
Copyright (c) Huawei Technologies Co., Ltd
1-3
By default, the debugging function is disabled.
Examples
# Enable the multicast packet forwarding debugging function.
<Quidway> debugging multicast forwarding
1.1.3 debugging multicast kernel-routing
Syntax
debugging multicast kernel-routing
undo debugging multicast kernel-routing
View
User view
Parameters
None
Description
Use the debugging multicast kernel-routing command to enable the multicast kernel
routing debugging function.
Use the undo debugging multicast kernel-routing command to disable the
debugging function.
By default, the multicast kernel routing debugging function is disabled.
Examples
# Enable the multicast kernel routing debugging function.
<Quidway> debugging multicast kernel-routing
1.1.4 debugging multicast status-forwarding
Syntax
debugging multicast status-forwarding
undo debugging multicast status-forwarding
View
User view
Parameters
None
Chapter 1 Common Multicast Configuration
Commands
Command Manual Common Multicast Configuration
Quidway S8500 Series Routing Switches
1-4 Huawei Proprietary and Confidential
Copyright (c) Huawei Technologies Co., Ltd
Description
Use the debugging multicast status-forwarding command to enable the multicast
forwarding status debugging function.
Use the undo debugging multicast status-forwarding command to disable the
debugging function.
By default, the multicast forwarding status debugging function is disabled.
Examples
# Enable the multicast forwarding status debugging function.
<Quidway> debugging multicast status-forwarding
1.1.5 display mpm forwarding-table
Syntax
display mpm forwarding-table [ group-address | source-address ]
View
Any view
Parameters
group-address: Multicast group address, used to specify a multicast group, ranging
from 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 view the multicast forwarding
table entries with port numbers.
When a group address or a source address is specified, this command shows only the
matched (S, G) entry; otherwise, this command shows all entries.
Related commands: display multicast forwarding-table.
Examples
# View the multicast forwarding table entries with port numbers.
<Quidway> display mpm forwarding-table
Multicast Forwarding Cache Table
Total 1 entry (entries)
00001. (10.11.113.110, 226.1.1.1)
in-vlan Vlan1
2 out-vlan(s):
Command Manual Common Multicast Configuration
Quidway S8500 Series Routing Switches
Chapter 1 Common Multicast Configuration
Commands
Huawei Proprietary and Confidential
Copyright (c) Huawei Technologies Co., Ltd
1-5
Vlan20
Ethernet5/1/33
Vlan10
Ethernet5/1/31
Total 1 entry(entries) Listed
Table 1-1 Description on the fields of the display mpm forwarding-table command
Field Description
Multicast Forwarding Cache
Table
Multicast forwarding cache table
Total 1 entry (entries) Total number of entries
00001 Sequence number of entries
(10.11.113.110, 226.1.1.1) (s,g), namely (source address, group address)
in-vlan Vlan1
The in-VLAN of the multicast forwarding table is
VLAN 1
2 out-vlan(s): The multicast forwarding table has two out-VLANs
Vlan20
Ethernet5/1/33
Vlan10
Ethernet5/1/31
The first out-VLAN is VLAN 20, of which the egress
port is Ethernet 5/1/33
The second out-VLAN is VLAN 10, of which the
egress port is Ethernet5/1/31
Total 1 entry(entries) Listed Totally one (S, G) entry is listed.
1.1.6 display mpm group
Syntax
display mpm group [ vlan vlan-id [ ip-address ] ]
View
Any view
Parameters
vlan vlan-id: Specifies the VLAN the desired multicast group information resides in. If
no VLAN ID is provided, the command displays the information of the multicast groups
in all the VLANs.
ip-address: IP address of the desired multicast group.
Chapter 1 Common Multicast Configuration
Commands
Command Manual Common Multicast Configuration
Quidway S8500 Series Routing Switches
1-6 Huawei Proprietary and Confidential
Copyright (c) Huawei Technologies Co., Ltd
Description
Use the display mpm group command to display the information about the IP
multicast groups or MAC multicast groups in a specified VLAN or all VLANs.
Examples
# Display the information of multicast groups in VLAN 10.
<Quidway> display mpm group vlan 10
Total 1 IP Group(s).
Total 1 MAC Group(s).
Vlan(id):10.
Total 1 IP Group(s).
Total 1 MAC Group(s).
Router port(s):
IP group(s):the following ip group(s) match to one mac group.
IP group address:230.45.45.1
Host port(s):Ethernet4/1/1
MAC group(s):
MAC group address:0100-5e2d-2d01
Host port(s):Ethernet4/1/1
Table 1-2 Description on the fields of the display mpm group command
Field Description
Vlan(id) ID of the specified VLAN
Router port(s) Router port
IP group(s) IP multicast group
IP group address IP address of the IP multicast group
Host port(s) Host port of the IP multicast group
MAC group(s) MAC multicast group
MAC group address Address of the MAC multicast group
Host port(s) Member port(s) of the MAC multicast group
1.1.7 display multicast forwarding-table
Syntax
display multicast forwarding-table [ group-address [ mask { mask | mask-length } ] |
source-address [ mask { mask | mask-length } ] | incoming-interface { interface-type
interface-number | null null-interface-number | register} ] *
Command Manual Common Multicast Configuration
Quidway S8500 Series Routing Switches
Chapter 1 Common Multicast Configuration
Commands
Huawei Proprietary and Confidential
Copyright (c) Huawei Technologies Co., Ltd
1-7
View
Any view
Parameters
group-address: Multicast group address, used to specify a multicast group, ranging
from 224.0.0.0 to 239.255.255.255.
source-address: Unicast IP address of the multicast source.
incoming-interface: Incoming interface of the multicast forwarding table entry.
interface-type interface-number: Interface type and interface number.
null: Incoming-interface is null.
null-interface-number: The only null interface number is 0.
register: Registered interface of PIM-SM.
Description
Use the display multicast forwarding-table command to view the information of
multicast forwarding table.
Related commands: display multicast routing-table
Examples
# View the multicast forwarding table information.
<Quidway> display multicast forwarding-table
Multicast Forwarding Cache Table
Total 2 entries
00001. (4.4.4.4, 224.2.254.84), iif Vlan-interface1, 0 oifs
Matched 240 pkts, Wrong If 0 pkts
Forwarded 232 pkts
00002. (4.4.4.4, 224.2.149.17), iif Vlan-interface1, 1 oifs
List of outgoing interface:
01: Vlan-interface2
Matched 236 pkts, Wrong If 0 pkts
Forwarded 233 pkts
Matched 2 entries
Table 1-3 Description on fields of the display multicast forwarding-table command
Field Description
Multicast Forwarding Cache Table Multicast forwarding cache table
Total 2 entries Total number of entries
00002 Sequence number of entries
Chapter 1 Common Multicast Configuration
Commands
Command Manual Common Multicast Configuration
Quidway S8500 Series Routing Switches
1-8 Huawei Proprietary and Confidential
Copyright (c) Huawei Technologies Co., Ltd
Field Description
(4.4.4.4, 224.2.149.17) (s,g), source IP address and multicast group
iif Vlan-interface1, 1 oifs
Multicast forwarding cache table has an
incoming interface VLAN-interface 1 and one
outgoing interface
List of outgoing interface:
01: Vlan-interface2
The list of outgoing interfaces has only one
outgoing interface Vlan-interface 2
Matched 236 pkts, Wrong If 0 pkts
Forwarded 233 pkts
236 matched packets; 0 matched packets
means wrong; 233 forwarded packets
Matched 2 entries Two matched entries
1.1.8 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
vlan-interface | register } ]*
View
Any view
Parameters
group-address: Multicast group address, used to specify a multicast group and display
the corresponding routing table information of the group. The value ranges from
224.0.0.0 to 239.255.255.255.
source-address: Unicast IP address of the multicast source.
incoming-interface: Incoming interface of the multicast route entry.
vlan-interface interface-number: VLAN interface number.
register: Register interface of PIM-SM.
Description
Use the display multicast routing-table command to view the information of IP
multicast routing table.
Related commands: display multicast forwarding-table.
Examples
# View the route entry information in the multicast routing table.
<Quidway> display multicast routing-table
Command Manual Common Multicast Configuration
Quidway S8500 Series Routing Switches
Chapter 1 Common Multicast Configuration
Commands
Huawei Proprietary and Confidential
Copyright (c) Huawei Technologies Co., Ltd
1-9
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:
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 1-4 Description on the fields of the display multicast routing-table command
Field Description
Multicast Routing Table Multicast routing table
Total 3 entries Three entries in total
(4.4.4.4, 224.2.149.17) (s, g) entry
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
Multicast routing table lasts 1516 and
times out in 272 seconds.
Upstream interface vlan-interface 1 (its
IP address is 4.4.4.6).
Downstream interface list: has an
interface Vlan-interface 2 (its IP address
is 2.2.2.4). The downstream interface is
configured with IGMP groups.
Matched 3 entries
Three entries in total meeting the
requirement
1.1.9 multicast route-limit
Syntax
multicast route-limit limit
Chapter 1 Common Multicast Configuration
Commands
Command Manual Common Multicast Configuration
Quidway S8500 Series Routing Switches
1-10 Huawei Proprietary and Confidential
Copyright (c) Huawei Technologies Co., Ltd
undo multicast route-limit
View
System view
Parameters
limit: Capacity threshold for a multicast routing table.
Description
Use the multicast route-limit command to set the capacity threshold for a multicast
routing table. Routers will discard the newly added (S, G) entries whenever the chosen
threshold is exceeded.
Use the undo multicast route-limit command to restore the capacity threshold to the
default value.
By default, the capacity threshold for a multicast routing table is 512.
Examples
# Set the capacity threshold for a multicast routing table to 128.
<Quidway> system-view
System View: return to User View with Ctrl+Z.
[Quidway] multicast route-limit 128
# Set the capacity threshold for a multicast routing table to 1000. The current capacity is
512, and the interface card in slot 5 does not support this new threshold setting.
<Quidway> system-view
System View: return to User View with Ctrl+Z.
[Quidway] multicast route-limit 1000
Slot 5 does not support the limit, configuration failed.
1.1.10 multicast routing-enable
Syntax
multicast routing-enable
undo multicast routing-enable
View
System view
Parameters
None
Command Manual Common Multicast Configuration
Quidway S8500 Series Routing Switches
Chapter 1 Common Multicast Configuration
Commands
Huawei Proprietary and Confidential
Copyright (c) Huawei Technologies Co., Ltd
1-11
Description
Use the multicast routing-enable command to enable multicast routing.
Use the undo multicast routing-enable command to disable multicast routing.
By default, multicast routing is disabled.
Related commands: pim dm, pim sm.
Examples
# Enable multicast routing.
<Quidway> system-view
System View: return to User View with Ctrl+Z.
[Quidway] multicast routing-enable
1.1.11 multicast-suppression
Syntax
multicast-suppression { ratio | bandwidth bandwidth }
undo multicast-suppression
View
Ethernet port view
Parameters
ratio: Maximum wire speed ratio in percents of the multicast traffic allowed on the port.
The value range is 1 to 100, and the default value is 50. The smaller the ratio is, the
smaller the multicast traffic is allowed to pass.
bandwidth: Multicast suppression bandwidth in Mbps on the port. The value ranges
from 1 to the maximum value of port bandwidth.
Description
Use the multicast-suppression command to set the multicast suppression ratio or
multicast suppression bandwidth.
Use the undo multicast-suppression command to disable the multicast suppression
function.
The default multicast suppression ratio is 100%.
You can use the multicast-suppression command repeatedly. The effective multicast
suppression ratio value is the one last updated.
Chapter 1 Common Multicast Configuration
Commands
Command Manual Common Multicast Configuration
Quidway S8500 Series Routing Switches
1-12 Huawei Proprietary and Confidential
Copyright (c) Huawei Technologies Co., Ltd
Caution:
You cannot enable both broadcast suppression and multicast suppression
simultaneously on the same card. Namely, once you have enabled broadcast
suppression on some ports of a card, you cannot enable multicast suppression on
the other ports of the card, and vice versa. Although the commands are based on
ports, the mutual exclusion between these two commands is based on cards.
If multicast suppression is enabled, broadcast packets are also suppressed at the
same time, while broadcast suppression does not work on multicast packets.
No distinction is made between known multicast packets and unknown multicast
packets in multicast suppression.
Related commands: broadcast-suppression.
Examples
# Set the multicast suppression ratio to 40%.
<Quidway> system-view
System View: return to User View with Ctrl+Z.
[Quidway] interface ethernet 2/1/1
[Quidway-Ethernet2/1/1] multicast-suppression 40
# Set the multicast suppression bandwidth to 40 Mbps.
[Quidway-Ethernet2/1/1] multicast-suppression bandwidth 40
# Disable multicast suppression.
[Quidway-Ethernet2/1/1] undo multicast-suppression
1.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 { null null-interface-number |
interface-type interface-number } }* }
View
User view
Parameters
statistics: If it is selected, the system clears the statistic information of MFC forwarding
entries. Otherwise, the system clears MFC forwarding entries.
Command Manual Common Multicast Configuration
Quidway S8500 Series Routing Switches
Chapter 1 Common Multicast Configuration
Commands
Huawei Proprietary and Confidential
Copyright (c) Huawei Technologies Co., Ltd
1-13
all: All MFC forward entries.
group-address: Multicast group address.
group-mask: Mask of multicast group address
group-mask-length: Mask length of multicast group address.
source-address: Source address.
source-mask: Mask of source address.
source-mask-length: Mask length of source address.
incoming-interface: Specifies incoming interface for the multicast forwarding entry.
null: Incoming-interface is null.
null-interface-number: The only number is 0.
interface-type interface-number: Interface type and interface number.
Description
Use the reset multicast forwarding-table command to clear MFC forwarding entries
or the statistic information of MFC forwarding entries.
There is no requirement on the order of source address and group address in the
command, as long as they both are valid addresses. The system prompts error
information if you type in an invalid address.
Related commands: reset pim routing-table, reset multicast routing-table, display
multicast forwarding-table.
Examples
# Clear the forwarding entry with the multicast group address of 225.5.4.3 from the
MFC forwarding table.
<Quidway> reset multicast forwarding-table 225.5.4.3
# Clear statistic information of the forwarding entry with the multicast group address of
225.5.4.3 from the MFC forwarding table.
<Quidway> reset multicast forwarding-table statistics 225.5.4.3
1.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 vlan-interface interface-number } * }
View
User view
Chapter 1 Common Multicast Configuration
Commands
Command Manual Common Multicast Configuration
Quidway S8500 Series Routing Switches
1-14 Huawei Proprietary and Confidential
Copyright (c) Huawei Technologies Co., Ltd
Parameters
all: All route entries in the core multicast routing table.
group-address: Multicast group address.
group-mask: Mask of multicast group address
group-mask-length: Mask length of multicast group address.
source-address: Source address.
source-mask: Mask of source address.
source-mask-length: Mask length of source address.
incoming-interface: Specifies incoming interface for the multicast forwarding entry.
vlan-interface interface-number: VLAN interface number.
Description
Use the reset multicast routing-table command to clear route entries from the core
multicast routing table, as well as MFC forwarding entries.
There is no requirement on the order of source address and group address in the
command, as long as they both are valid addresses. The system prompts error
information if you type in invalid addresses.
Related commands: reset pim routing-table, reset multicast forwarding-table and
display multicast forwarding-table.
Examples
# Clear the route entry with the group address of 225.5.4.3 from the core multicast
routing table.
<Quidway> reset multicast routing-table 225.5.4.3
