- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
01-Common Multicast Configuration Commands | 62.63 KB |
Chapter 1 Common Multicast Configuration Commands
1.1 Common Multicast Configuration Commands
1.1.2 debugging multicast forwarding
1.1.3 debugging multicast kernel-routing
1.1.4 debugging multicast status-forwarding
1.1.5 display mpm forwarding-table
1.1.7 display multicast forwarding-table
1.1.8 display multicast routing-table
1.1.10 multicast routing-enable
1.1.12 reset multicast forwarding-table
1.1.13 reset multicast routing-table
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.
Caution:
l 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.
l 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%.
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] interface ethernet 2/1/1
[H3C-Ethernet2/1/1] broadcast-suppression 40
# Set the broadcast suppression bandwidth to 40 Mbps.
[H3C-Ethernet2/1/1] broadcast-suppression bandwidth 40
# Disable broadcast suppression.
[H3C-Ethernet2/1/1] undo broadcast-suppression
1.1.2 debugging multicast forwarding
debugging multicast forwarding
undo debugging multicast forwarding
Parameters
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.
By default, the debugging function is disabled.
Examples
# Enable the multicast packet forwarding debugging function.
<H3C> debugging multicast forwarding
1.1.3 debugging multicast kernel-routing
debugging multicast kernel-routing
undo debugging multicast kernel-routing
Parameters
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.
<H3C> debugging multicast kernel-routing
1.1.4 debugging multicast status-forwarding
debugging multicast status-forwarding
undo debugging multicast status-forwarding
Parameters
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.
<H3C> 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.
<H3C> 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):
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.
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.
<H3C> 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
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} ] *
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.
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.
<H3C> 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 |
(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
display multicast routing-table [ group-address [ mask { mask | mask-length } ] | source-address [ mask { mask | mask-length } ] | incoming-interface { interface-type vlan-interface | register } ]*
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.
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.
<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:
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
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 15’16” 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
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.
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] 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.
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] multicast route-limit 1000
Slot 5 does not support the limit, configuration failed.
1.1.10 multicast routing-enable
multicast routing-enable
undo multicast routing-enable
Parameters
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.
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] 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.
Caution:
l 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.
l If multicast suppression is enabled, broadcast packets are also suppressed at the same time, while broadcast suppression does not work on multicast packets.
l 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%.
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] interface ethernet 2/1/1
[H3C-Ethernet2/1/1] multicast-suppression 40
# Set the multicast suppression bandwidth to 40 Mbps.
[H3C-Ethernet2/1/1] multicast-suppression bandwidth 40
# Disable multicast suppression.
[H3C-Ethernet2/1/1] undo multicast-suppression
1.1.12 reset multicast forwarding-table
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 } }* }
Parameters
statistics: If it is selected, the system clears the statistic information of MFC forwarding entries. Otherwise, the system clears MFC forwarding entries.
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.
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.
<H3C> 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.
<H3C> reset multicast forwarding-table statistics 225.5.4.3
1.1.13 reset multicast routing-table
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 } * }
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.
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.