01-common multicast configuration commands

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


1-1


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.


Command Manual Common Multicast ConfigurationQuidway S8500 Series Routing Switches

1-2 Huawei Proprietary and Confidential Copyright (c) Huawei Technologies Co., Ltd

Caution:

z 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.

z 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%.

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.




1-3

By default, the debugging function is disabled.

Examples

# Enable the multicast packet forwarding debugging function.

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.

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




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.

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.

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):




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.




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.

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} ] *




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.

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




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 pktsForwarded 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.

display multicast routing-table




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)



Downstream interface list: NULL

(4.4.4.4, 239.255.2.2)



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




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.

system-view


[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.

system-view


[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




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.

system-view


[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.




Caution:

z 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.

z If multicast suppression is enabled, broadcast packets are also suppressed at the same time, while broadcast suppression does not work on multicast packets.

z 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%.

system-view


[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.




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.

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.

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




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.

reset multicast routing-table 225.5.4.3

Table of ContentsChapter 1 Common Multicast Configuration Commands1.1 Common Multicast Configuration Commands1.1.1 broadcast-suppression1.1.2 debugging multicast forwarding1.1.3 debugging multicast kernel-routing1.1.4 debugging multicast status-forwarding1.1.5 display mpm forwarding-table1.1.6 display mpm group1.1.7 display multicast forwarding-table1.1.8 display multicast routing-table1.1.9 multicast route-limit1.1.10 multicast routing-enable1.1.11 multicast-suppression1.1.12 reset multicast forwarding-table1.1.13 reset multicast routing-table

01-common multicast configuration commands

Documents