vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command deletes all static multicast routes on the public network.

Usage guidelines

This command deletes all static multicast routes. To delete a specified static multicast route, use the undo ip rpf-route-static command.

Examples

# Delete all static multicast routes on the public network.

<Sysname> system-view

[Sysname] delete ip rpf-route-static

This will erase all multicast static routes and their configurations, you must reconfigure all static routes.

Are you sure?[Y/N]:y

Related commands

ip rpf-route-static

display mrib interface

Use display mrib interface to display information about interfaces maintained by the MRIB.

Syntax

display mrib [ vpn-instance vpn-instance-name ] interface [ interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays information about interfaces maintained by the MRIB on the public network.

interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays information about all interfaces maintained by the MRIB.

Examples

# Display information about interfaces maintained by the MRIB on the public network.

<Sysname> display mrib interface

Interface: Ten-GigabitEthernet3/1/1

Index: 0x00004444

Current state: up

MTU: 1500

Type: BROADCAST

Protocol: PIM-DM

PIM protocol state: Enabled

Address list:

1. Local address : 8.12.0.2/16

Remote address: 0.0.0.0

Reference : 1

State : NORMAL

Interface: Multicast-UA0

Index: 0xd0000001

Current state: up

MTU: 0

Type: MUA

Protocol: IGMP

PIM protocol state: Disabled

User ID: 0x1

VLAN ID: 100

Second VLAN ID: 10

Access type: IPoE

Access interface: Ten-GigabitEthernet3/1/1.1

Address list:

1. Local address : 127.1.1.11/32

Remote address: 0.0.0.0

Reference : 3

State : NORMAL

Table 1 Command output

Field	Description
Interface	Interface name.
Index	Index number of the interface.
Current state	Current status of the interface: up or down.
MTU	MTU value.
Type	Interface type: · BROADCAST—Broadcast link interface. · P2P—P2P interface. · LOOP—Loopback interface. · REGISTER—Register interface. · NBMA—NBMA interface. · MTUNNEL—Multicast tunnel interface. · MUA—Multicast-UA interface. This field is empty if the interface is Null 0.
Protocol	Protocol running on the interface: PIM-DM, PIM-SM, IGMP, PROXY, or MD.
PIM protocol state	Whether PIM is enabled: Enabled or Disabled.
User-ID	ID of the multicast user on the interface.
VLAN ID	Outer VLAN ID or the only VLAN ID in the multicast user's packets. This field is not displayed if the user's packets are not tagged with VLAN IDs.
Second VLAN ID	Inner VLAN ID in the multicast user's packets. This field is not displayed if the user's packets are not tagged with VLAN IDs.
Access type	Access type of the multicast user: · IPoE. · PPP.
Access interface	Physical interface through which the multicast user accesses the network.
Address list	Interface address list.
Local address	Local IP address.
Remote address	Remote end IP address. This field is displayed only when the interface is vlink type.
Reference	Number of times that the address has been referenced.
State	Status of the interface address: NORMAL or DEL.

display multicast boundary

Use display multicast boundary to display multicast boundary information.

Syntax

display multicast [ vpn-instance vpn-instance-name ] boundary [ group-address [ mask-length | mask ] ] [ interface interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays multicast boundary information on the public network.

group-address: Specifies a multicast group by its IP address in the range of 224.0.0.0 to 239.255.255.255. If you do not specify a multicast group, this command displays multicast boundary information for all multicast groups.

mask-length: Specifies an address mask length in the range of 4 to 32. The default is 32.

mask: Specifies an address mask. The default is 255.255.255.255.

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays multicast boundary information for all interfaces.

Examples

# Display information about all multicast boundaries on the public network.

<Sysname> display multicast boundary

Boundary Interface

224.1.1.0/24 XGE3/1/1

239.2.2.0/24 XGE3/1/2

Table 2 Command output

Field	Description
Boundary	Multicast group associated with the multicast boundary.
Interface	Boundary interface associated with the multicast boundary.

Related commands

multicast boundary

display multicast fast-forwarding cache

Use display multicast fast-forwarding cache to display multicast fast forwarding entries.

Syntax

In standalone mode:

display multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache [ source-address | group-address ] * [ slot slot-number [ cpu cpu-number ] ]

In IRF mode:

display multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache [ source-address | group-address ] * [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays multicast fast forwarding entries on the public network.

source-address: Specifies a multicast source address.

group-address: Specifies a multicast group address in the range of 224.0.1.0 to 239.255.255.255.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays multicast fast forwarding entries on the active MPU. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays multicast fast forwarding entries on the global active MPU. (In IRF mode.)

cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.

Examples

# Display multicast fast forwarding entries on the public network.

<Sysname> display multicast fast-forwarding cache

Total 1 entries, 1 matched

(60.1.1.200, 225.0.0.2)

Status : Enabled

Source port: 2001 Destination port: 2002

Protocol : 2 Flag : 0x2

Incoming interface: Ten-GigabitEthernet3/1/3

List of 1 outgoing interfaces:

Ten-GigabitEthernet3/1/2

Status: Enabled Flag: 0x14

Table 3 Command output

Field	Description
Total 1 entries, 1 matched	Total number of (S, G) entries in the multicast fast forwarding table, and the total number of matching (S, G) entries.
(60.1.1.200, 225.0.0.2)	(S, G) entry.
Protocol	Protocol number.
Flag	Flag of the (S, G) entry or the outgoing interface in the entry. This field displays one flag or the sum of multiple flags. In this example, the value 0x2 means that the entry has only one flag 0x2. The value 0x14 means that the interface has flags 0x4 and 0x10. The following flags are available for an entry: · 0x1—The entry is created because of packets passed through between cards. · 0x2—The entry is added by multicast forwarding. The following flags are available for an outgoing interface: · 0x1—The interface is added to the entry because of packets passed through between cards. · 0x2—The interface is added to an existing entry. · 0x4—The MAC address of the interface is needed for fast forwarding. · 0x8—The interface is an outgoing interface associated with the incoming VLAN or super VLAN interface. · 0x10—The interface is associated with the entry. · 0x20—The interface is to be deleted.
Status	Status of the (S, G) entry or the outgoing interface: · Enabled—Available. · Disabled—Unavailable.
Incoming interface	Incoming interface of the (S, G) entry.
List of 1 outgoing interfaces	Outgoing interface list of the (S, G) entry.

Related commands

reset multicast fast-forwarding cache all

display multicast flow-statistic

Use display multicast flow-statistic to display multicast traffic statistics.

Syntax

display multicast flow-statistic source source-address group group-address interface interface-type interface-number [ s-vlan svlan-id [ c-vlan cvlan-id ] ] { inbound | outbound }

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

source-address: Specifies a multicast source address.

group-address: Specifies a multicast group address in the range of 224.0.1.0 to 239.255.255.255.

interface interface-type interface-number: Specifies an interface by its type and number.

s-vlan svlan-id: Specifies an outer VLAN ID in the range of 1 to 4094.

c-vlan cvlan-id: Specifies an inner VLAN ID in the range of 1 to 4094.

inbound: Specifies the inbound direction.

outbound: Specifies the outbound direction.

Usage guidelines

If you do not specify the s-vlan svlan-id or c-vlan cvlan-id option, this command displays multicast traffic statistics for all VLANs.

You can use this command to view multicast traffic statistics on each device on the multicast forwarding path to locate where a forwarding failure occurs. For example, you can use this command to determine which device causes serious packet loss in an IPTV network.

To view multicast traffic statistics of an aggregate interface, specify the aggregate interface for the interface interface-type interface-number option. If you specify a member port of an aggregate interface for the interface interface-type interface-number option, no multicast traffic statistics will be displayed.

Examples

# Display inbound multicast traffic statistics from 110.11.0.2 to 225.0.0.1 on Ten-GigabitEthernet 3/1/1.

<Sysname> display multicast flow-statistic source 110.11.0.2 group 225.0.0.1 interface ten-gigabitethernet 3/1/1 inbound

Matched 512 packets in 2 seconds, 128 packets/sec.

Matched 20480 bytes in 2 seconds, 10240 bytes/sec.

display multicast forwarding event

Use display multicast forwarding event to display statistics of multicast forwarding events.

Syntax

In standalone mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding event [ slot slot-number [ cpu cpu-number ] ]

In IRF mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding event [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays statistics of the multicast forwarding events on the public network.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays statistics of multicast forwarding events on the active MPU. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays statistics of multicast forwarding events on the global active MPU. (In IRF mode.)

cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.

Examples

# Display statistics of multicast forwarding events on the public network.

<Sysname> display multicast forwarding event

Total active events sent: 0

Total inactive events sent: 0

Total NoCache events sent: 2

Total NoCache events dropped: 0

Total WrongIF events sent: 0

Total WrongIF events dropped: 0

Total SPT switch events sent: 0

NoCache rate limit: 1024 packets/s

WrongIF rate limit: 1 packets/10s

Total timer of register suppress timeout: 0

Table 4 Command output

Field	Description
Total active events sent	Number of times that entry-active events have been sent.
Total inactive events sent	Number of times that entry-inactive events have been sent.
Total NoCache events sent	Number of times that NoCache events have been sent.
Total NoCache events dropped	Number of times that NoCache events have been dropped.
Total WrongIF events sent	Number of times that WrongIF events have been sent.
Total WrongIF event dropped	Number of times that WrongIF events have been dropped.
Total SPT switch events sent	Number of times that SPT-switch events have been sent.
NoCache rate limit	Rate limit for sending NoCache events, in pps.
WrongIF rate limit	Rate limit for sending WrongIF events, in packets per 10 seconds.
Total timer of register suppress timeout	Number of times that the registration suppression has timed out in total.

Related commands

reset multicast forwarding event

display multicast forwarding-table

Use display multicast forwarding-table to display multicast forwarding entries.

Syntax

In standalone mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding-table [ source-address [ mask { mask-length | mask } ] | group-address [ mask { mask-length | mask } ] | incoming-interface interface-type interface-number | outgoing-interface { exclude | include | match } interface-type interface-number | slot slot-number [ cpu cpu-number ] | statistics ] *

In IRF mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding-table [ source-address [ mask { mask-length | mask } ] | group-address [ mask { mask-length | mask } ] | incoming-interface interface-type interface-number | outgoing-interface { exclude | include | match } interface-type interface-number | chassis chassis-number slot slot-number [ cpu cpu-number ] | statistics ] *

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays multicast forwarding entries on the public network.

source-address: Specifies a multicast source address.

group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.

mask-length: Specifies an address mask length. The default value is 32. For a multicast group address, the value range for this argument is 4 to 32. For a multicast source address, the value range for this argument is 0 to 32.

mask: Specifies an address mask. The default value is 255.255.255.255.

incoming-interface: Specifies the multicast forwarding entries that contain the specified incoming interface.

interface-type interface-number: Specifies an incoming interface by its type and number.

outgoing-interface: Specifies the multicast forwarding entries that contain the specified outgoing interface.

exclude: Specifies the multicast forwarding entries that do not contain the specified interface in the outgoing interface list.

include: Specifies the multicast forwarding entries that contain the specified interface in the outgoing interface list.

match: Specifies the forwarding entries that contain only the specified interface in the outgoing interface list.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays multicast forwarding entries on the active MPU. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays multicast forwarding entries on the global active MPU. (In IRF mode.)

cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.

statistics: Displays statistics for the multicast forwarding table.

Examples

# Display multicast forwarding entries on the public network.

<Sysname> display multicast forwarding-table

Total 1 entries, 1 matched

00001. (172.168.0.2, 227.0.0.1)

Flags: 0x0

Uptime: 00:08:32, Timeout in: 00:03:26

Incoming interface: Ten-GigabitEthernet3/1/1

Backup incoming interface: Ten-GigabitEthernet3/1/3

List of 1 outgoing interface:

1: Ten-GigabitEthernet3/1/2 (inactive)

Matched 19648 packets(20512512 bytes), Wrong If 0 packet

Forwarded 0 packets(0 bytes)

Table 5 Command output

Field	Description
Total 1 entries, 1 matched	Total number of (S, G) entries, and the total number of matching (S, G) entries.
00001	Sequence number of the (S, G) entry.
(172.168.0.2,227.0.0.1)	(S, G) entry.
Flags	Entry flag. This field displays one flag or the sum of multiple flags. In this example, the value 0x0 means that the entry has only one flag 0x0. The following entries are available for an entry: · 0x0—The entry is in correct state. · 0x1—The entry is in inactive state. · 0x2—The entry is null. · 0x4—The entry fails to update. · 0x8—Outgoing interface information fails to update for the entry. · 0x10—Data-group information fails to update for the entry. · 0x20—A register outgoing interface is available. · 0x40—The entry is to be deleted. · 0x80—The entry is in registration suppression state. · 0x100—The entry is being deleted. · 0x200—The entry is in GR state. · 0x800—The entry has the associated ARP entry for the multicast source address. · 0x400000—The entry is created by the IGMP proxy.
Uptime	Length of time for which the (S, G) entry has been up.
Timeout in	Length of time in which the (S, G) entry will expire.
Incoming interface	Incoming interface of the (S, G) entry. This field indicates the primary incoming interface if the (S, G) entry has a backup incoming interface.
Backup incoming interface	Backup incoming interface of the (S, G) entry. If the primary incoming interface of the (S, G) entry fails, multicast data arrived at the backup incoming interface will be forwarded to receivers.
List of 1 outgoing interfaces	Outgoing interface list of the (S, G) entry. An outgoing interface marked with (inactive) indicates that the interface does not participate in multicast forwarding.
Matched 19648 packets(20512512 bytes), Wrong If 0 packet	Number of packets (bytes) that match the (S, G) entry, and number of packets with incoming interface errors. The numbers are displayed as 0 if an outgoing interface of the (S, G) entry is on the specified slot.
Forwarded 19648 packets(20512512 bytes)	Number of packets (bytes) that have been forwarded. The numbers are displayed as 0 if an outgoing interface of the (S, G) entry is on the specified slot.

Related commands

reset multicast forwarding-table

display multicast global pim sm statistics

Use display multicast global pim sm statistics to display the configuration and statistics for global PIM entry limits in PIM-SM mode.

Syntax

display multicast global pim sm statistics

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display the configuration and statistics for global PIM entry limits in PIM-SM mode.

<Sysname> display multicast global pim sm statistics

PIM-SM Number Limit Threshold(Upper Lower)

-----------------------------------------------------------------

(*, G) 4 2000 80 50

(S, G) 0 1000 80 70

------------------------------------------------------------------

Table 6 Command output

Field	Description
Number	Number of PIM entries that has been created.
Limit	Maximum number of PIM entries allowed.
Threshold(Upper Lower)	Upper limit and lower limit of PIM entries that cause log messages to be generated.

Related commands

multicast global limit pim sm

display multicast routing-table

Use display multicast routing-table to display multicast routing entries.

Syntax

display multicast [ vpn-instance vpn-instance-name ] routing-table [ source-address [ mask { mask-length | mask } ] | group-address [ mask { mask-length | mask } ] | incoming-interface interface-type interface-number | outgoing-interface { exclude | include | match } interface-type interface-number ] *

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

source-address: Specifies a multicast source address.

group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.

mask: Specifies an address mask. The default is 255.255.255.255.

incoming-interface: Specifies the multicast routing entries that contain the specified incoming interface.

interface-type interface-number: Specifies an interface by its type and number.

outgoing-interface: Specifies the multicast routing entries that contain the specified outgoing interface.

exclude: Specifies the multicast routing entries that do not contain the specified interface in the outgoing interface list.

include: Specifies the multicast routing entries that contain the specified interface in the outgoing interface list.

match: Specifies the multicast routing entries that contain only the specified interface in the outgoing interface list.

Usage guidelines

Multicast routing entries are the basis of multicast forwarding. You can use this command to view the establishment state of (S, G) entries.

Examples

# Display multicast routing entries on the public network.

<Sysname> display multicast routing-table

Total 1 entries

00001. (172.168.0.2, 227.0.0.1)

Uptime: 00:00:28

Upstream Interface: Ten-GigabitEthernet3/1/1

Backup Upstream Interface: Ten-GigabitEthernet3/1/4

List of 2 downstream interfaces

1: Ten-GigabitEthernet3/1/2

2: Ten-GigabitEthernet3/1/3

Table 7 Command output

Field	Description
Total 1 entries	Total number of (S, G) entries.
00001	Sequence number of the (S, G) entry.
(172.168.0.2, 227.0.0.1)	(S, G) entry.
Uptime	Length of time for which the (S, G) entry has been up.
Upstream Interface	Upstream interface at which (S, G) packets should arrive. This field indicates the primary upstream interface if the (S, G) entry has a backup upstream interface.
Backup incoming interface	Backup upstream interface of the (S, G) entry. If the primary upstream interface of the (S, G) entry fails, multicast data arrived at the backup upstream interface will be forwarded to receivers.
List of 2 downstream interfaces	List of downstream interfaces that need to forward (S, G) packets.

Related commands

reset multicast routing-table

display multicast routing-table static

Use display multicast routing-table static to display static multicast routing entries.

Syntax

display multicast [ vpn-instance vpn-instance-name ] routing-table static [ source-address { mask-length | mask } ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays static multicast routing entries on the public network.

source-address: Specifies a multicast source address.

mask-length: Specifies an address mask length in the range of 0 to 32.

mask: Specifies an address mask.

Usage guidelines

This command displays only valid static multicast routing entries.

Examples

# Display static multicast routing entries on the public network.

<Sysname> display multicast routing-table static

Destinations: 3 Routes: 4

Destination/Mask Pre RPF neighbor Interface

1.1.0.0/16 10 7.12.0.1 XGE3/1/1

7.11.0.1 XGE3/1/2

2.2.2.0/24 20 7.11.0.1 XGE3/1/3

3.3.3.3/32 50 7.12.0.1 XGE3/1/4

Table 8 Command output

Field	Description
Destinations	Number of the multicast destination addresses.
Routes	Number of routes.
Destination/Mask	Destination address and its mask length.
Pre	Route preference.
RPF neighbor	IP address of the RPF neighbor to the reachable destination.
Interface	Outgoing interface to the reachable destination.

display multicast rpf-info

Use display multicast rpf-info to display RPF information for a multicast source.

Syntax

display multicast [ vpn-instance vpn-instance-name ] rpf-info source-address [ group-address ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays RPF information for a multicast source on the public network.

source-address: Specifies a multicast source address.

group-address: Specifies a multicast group address in the range of 224.0.1.0 to 239.255.255.255.

Examples

# Display RPF information for multicast source 192.168.1.55 on the public network.

<Sysname> display multicast rpf-info 192.168.1.55

RPF information about source 192.168.1.55:

RPF interface: Ten-GigabitEthernet3/1/1, RPF neighbor: 10.1.1.1

Backup RPF interface: Ten-GigabitEthernet3/1/2, backup RPF neighbor: 2.2.2.2

Referenced route/mask: 192.168.1.0/24

Referenced route type: igp

Route selection rule: preference-preferred

Load splitting rule: disable

Source AS: 0

C-multicast route target: 0x0000000000000000

Table 9 Command output

Field	Description
RPF interface	Name of the RPF interface. This field indicates the primary RPF interface if the RPF route has a backup RPF interface.
Backup RPF interface	Name of the backup RPF interface.
RPF neighbor	IP address of the RPF neighbor. This field indicates the IP address of the primary RPF neighbor if the RPF route has a backup RPF neighbor.
backup RPF neighbor	IP address of the backup RPF neighbor.
Referenced route/mask	Referenced route and its mask length.
Referenced route type	Type of the referenced route: · igp—IGP unicast route. · egp—EGP unicast route. · unicast (direct)—Directly connected unicast route. · unicast—Other unicast routes, such as static unicast route. · multicast static—Static multicast route. · mbgp—MBGP route.
Route selection rule	Rule for RPF route selection: · Route preference. · Longest prefix match.
Load splitting rule	Status of the load splitting rule: enable or disable.
Source AS	AS number of the source-side PE.
C-multicast route target	Route target attribute value of the C-multicast route.

Related commands

display multicast forwarding-table

display multicast routing-table

ip rpf-route-static

Use ip rpf-route-static to configure a static multicast route.

Use undo ip rpf-route-static to delete a static multicast route.

Syntax

ip rpf-route-static [ vpn-instance vpn-instance-name ] source-address { mask-length | mask } { rpf-nbr-address | interface-type interface-number } [ preference preference ] [ description text ]

undo ip rpf-route-static [ vpn-instance vpn-instance-name ] source-address { mask-length | mask } { rpf-nbr-address | interface-type interface-number }

Default

No static multicast routes exist.

Views

System view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command configures a static multicast route on the public network.

source-address: Specifies a multicast source address.

mask-length: Specifies an address mask length in the range of 0 to 32.

mask: Specifies an address mask.

rpf-nbr-address: Specifies an RPF neighbor by its IP address.

interface-type interface-number: Specifies an interface by its type and number. The interface connects the RPF neighbor.

preference: Sets a route preference in the range of 1 to 255. The default value is 1.

description text : Specifies the description of the static multicast route, a case-sensitive string of 1 to 60 characters. The description can include blank spaces and special characters except for the question mark (?).

Usage guidelines

If the interface connected to an RPF neighbor is a point-to-point interface, you must specify the interface by its type and number.

If the interface connected to an RPF neighbor is not a point-to-point interface, you must specify the interface by its IP address. This type of interfaces includes Layer 3 Ethernet, Layer 3 aggregate, VLAN, and Loopback interfaces.

The configured static multicast route might not take effect when one of the following conditions exists:

· The outgoing interface iteration fails.

· The specified interface is not in the public network or the same VPN instance as the current interface.

· The specified interface is not a point-to-point interface.

· The specified interface is down.

If multiple static multicast routes within the same multicast source address range are available, only the one with the highest route preference can become active. You can use the display multicast routing-table static command to verify that the configured static multicast route has taken effect.

The undo ip rpf-route-static command deletes the specified static multicast route, but the delete ip rpf-route-static command deletes all static multicast routes.

Examples

# Configure a static multicast route to multicast source 10.1.1.0/24 and specify the interface with IP address 192.168.1.23 as the RPF neighbor on the public network.

<Sysname> system-view

[Sysname] ip rpf-route-static 10.1.1.0 24 192.168.1.23

Related commands

delete ip rpf-route-static

display multicast routing-table static

load-splitting (MRIB view)

Use load-splitting to enable multicast load splitting.

Use undo load-splitting to restore the default.

Syntax

load-splitting { balance-ecmp | balance-ucmp | ecmp | source | source-group | ucmp }

undo load-splitting

Default

Load splitting of multicast traffic is disabled.

Views

MRIB view

Predefined user roles

network-admin

Parameters

balance-ecmp: Enables multicast load balancing based on ECMP paths. Multicast traffic is evenly distributed among ECMP paths.

balance-ucmp: Enables multicast load balancing based on links. Multicast traffic is evenly distributed among links.

ecmp: Enables multicast load splitting based on ECMP paths.

source: Enables multicast load splitting based on multicast sources.

source-group: Enables multicast load splitting based on multicast sources and groups.

ucmp: Enables multicast load splitting based on links.

Usage guidelines

On a network with ECMP routes, specify the balance-ecmp, ecmp, source, or source-group keyword. On a network with UCMP routes, specify the balance-ucmp or ucmp keyword.

· If you specify the ecmp keyword, adding or deleting ECMP routes severely affects multicast forwarding.

· If you specify the source or source-group keyword, adding or deleting ECMP routes slightly affects multicast forwarding. Specify either of the keywords on a network with unstable equal cost links.

· If you specify the balance-ecmp or balance-ucmp keyword, the device uses a polling mechanism for multicast load balancing. ECMP or UCMP-based multicast load balancing provides better stability and balance than ECMP or UCMP-based multicast load sharing.

Examples

# Enable load splitting based on multicast source on the public network.

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] load-splitting source

longest-match (MRIB view)

Use longest-match to specify the longest prefix match principle for RPF route.

Use undo longest-match to restore the default.

Syntax

longest-match

undo longest-match

Default

Route preference is used for RPF route selection. The route with the highest preference is used as the RPF route.

Views

MRIB view

Predefined user roles

network-admin

Usage guidelines

This command enables the device to use the matching route with the longest prefix as the RPF route.

Examples

# Specify the longest prefix match principle for RPF route selection on the public network.

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] multicast longest-match

multicast boundary

Use multicast boundary to configure a multicast forwarding boundary.

Use undo multicast boundary to delete a multicast forwarding boundary.

Syntax

multicast boundary group-address { mask-length | mask }

undo multicast boundary { group-address { mask-length | mask } | all }

Default

No multicast forwarding boundaries are configured on an interface.

Views

Interface view

Predefined user roles

network-admin

Parameters

group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.

mask-length: Specifies an address mask length in the range of 4 to 32.

mask: Specifies an address mask.

all: Specifies all forwarding boundaries configured on the interface.

Usage guidelines

A multicast forwarding boundary sets the boundary condition for the multicast groups in the specified address range. If the destination address of a multicast packet matches the set boundary condition, the packet is not forwarded.

You can configure an interface as a multicast forwarding boundary for different multicast group ranges by executing this command multiple times on the interface.

You do not need to enable IP multicast routing before you execute this command.

Assume that Set A and Set B are multicast forwarding boundary sets with different address ranges, and B is a subset of A. A takes effect on the interface no matter whether A is configured earlier or later than B.

This configuration does not affect users that come online through an interface configured with multicast access control. Such users can still join multicast groups specified for the multicast forwarding boundary.

Examples

# Configure Ten-GigabitEthernet 3/1/1 as the forwarding boundary of multicast groups in the range of 239.2.0.0/16.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/1/1

[Sysname-Ten-GigabitEthernet3/1/1] multicast boundary 239.2.0.0 16

Related commands

display multicast boundary

multicast forwarding-table cache-unknown per-entry

Use multicast forwarding-table cache-unknown per-entry to set the maximum number of unknown multicast packets that can be cached for an (S, G) entry.

Use undo multicast forwarding-table cache-unknown per-entry to restore the default.

Syntax

multicast forwarding-table cache-unknown per-entry per-entry-limit

undo multicast forwarding-table cache-unknown per-entry

Default

The device can cache only one unknown multicast packet for an (S, G) entry.

Views

System view

Predefined user roles

network-admin

Parameters

per-entry-limit: Specifies the maximum number of unknown multicast packets that can be cached for an (S, G) entry. The value range for this argument is 0 to 256. If you set the value to 0, the device cannot cache unknown multicast packets.

Examples

# Set the maximum number to 20 for unknown multicast packets that can be cached for an (S, G) entry.

<Sysname> system-view

[Sysname] multicast forwarding-table cache-unknown per-entry 20

Related commands

multicast forwarding-table cache-unknown total

Use multicast forwarding-table cache-unknown total to set the maximum number of all unknown multicast packets that can be cached.

Use undo multicast forwarding-table cache-unknown total to restore the default.

Syntax

multicast forwarding-table cache-unknown total total-limit

undo multicast forwarding-table cache-unknown total

Default

The device can cache 1024 unknown multicast packets in total.

Views

System view

Predefined user roles

network-admin

Parameters

total-limit: Specifies the maximum number of all unknown multicast packets that can be cached. The value range for this argument is 0 to 65535. If you set the value to 0, the device cannot cache unknown multicast packets.

Usage guidelines

As a best practice, set the value in this command to be far greater than the value set in the multicast forwarding-table cache-unknown per-entry command.

Examples

# Set the maximum number to 10000 for all unknown multicast packets that can be cached.

<Sysname> system-view

[Sysname] multicast forwarding-table cache-unknown total 10000

Related commands

multicast forwarding-table cache-unknown per-entry

multicast frr mode

Use multicast frr mode to set the multicast FRR mode.

Use undo multicast frr mode to restore the default.

Syntax

multicast frr mode [ by-entry | by-iif ]

undo multicast frr mode

Default

The multicast FRR mode is by-entry.

Views

System view

Predefined user roles

network-admin

Parameters

by-entry: Specifies the by-entry mode. In this mode, multicast FRR periodically monitors multicast traffic on primary and backup incoming interfaces by entry.

by-iif: Specifies the by-incoming interface mode. In this mode, multicast FRR periodically monitors multicast traffic for different (S, G) entries by pair of primary and backup incoming interfaces.

Usage guidelines

With multicast FRR enabled, the device will add a primary incoming interface and a backup incoming interface for each (S, G) entry and (*, G) entry during entry creation. It will periodically monitor multicast traffic on the primary and backup incoming interfaces of all entries. If no multicast traffic is detected on the primary incoming interface, the device determines that the primary incoming interface fails and uses the backup incoming interface for multicast forwarding.

As a best practice, set the multicast FRR mode to by-incoming interface if the device has a large number of multicast entries and most entries have the same primary and backup incoming interfaces.

In the current software version, only PIM supports multicast FRR. For more information about PIM FRR, see PIM configuration in IP Multicast Configuration Guide.

Examples

# Set the multicast FRR mode to by-incoming interface.

<Sysname> system-view

[Sysname] multicast frr mode by-iif

Related commands

rpf-frr enable

multicast frr monitor cycle

Use multicast frr monitor cycle to set the primary/backup link monitoring interval for multicast FRR.

Use undo multicast frr monitor cycle to restore the default.

Syntax

multicast frr monitor cycle monitor-time

undo multicast frr monitor cycle

Default

The primary/backup link monitoring interval is 200 milliseconds.

Views

System view

Predefined user roles

network-admin

Parameters

monitor-time: Specifies the primary/backup link monitoring interval in milliseconds. Valid values are 10, 20, 40, 100, 200, and 500.

Usage guidelines

Before executing this command, execute the rpf-frr enable or c-multicast frr command to enable PIM FRR or MVPN FRR.

As a best practice to prevent the CPU from being overloaded, set the monitoring interval to a larger value if there are many multicast entries. As a best practice to prevent the device from determining link failures mistakenly when the multicast traffic rate is small, also set the monitoring interval to a larger value if there are many multicast entries.

Examples

# Set the primary/backup link monitoring interval to 20 milliseconds.

<Sysname> system-view

[Sysname] multicast frr monitor cycle 20

Related commands

c-multicast frr

rpf-frr enable

multicast frr wtr

Use multicast frr wtr to configure traffic switchback from the backup link to the primary link for multicast FRR.

Use undo multicast frr wtr to restore the default.

Syntax

multicast frr wtr { wtr-time | disable }

undo multicast frr wtr

Default

Traffic switchback is disabled and the wait-to-restore (WTR) time is 600 seconds.

Views

System view

Predefined user roles

network-admin

Parameters

wtr-time: Specifies the wait-to-restore (WTR) time in the range of 60 to 1800 seconds.

disable: Disables traffic switchback.

Usage guidelines

Before executing this command, execute the rpf-frr enable or c-multicast frr command to enable PIM FRR or MVPN FRR.

To prevent multicast traffic from being switched back before the multicast entries are created for the primary link, do not set too short a wait-to-restore (WTR) time.

Multicast packets might be lost or duplicate multicast packets might exist during a traffic switchback. As a best practice, do not configure traffic switchback for multicast services requiring high reliability.

Examples

# Set the WTR time to 800 seconds.

<Sysname> system-view

[Sysname] multicast frr wtr 800

Related commands

c-multicast frr

rpf-frr enable

multicast global limit pim sm

Use multicast global limit pim sm to configure global PIM entry limits in PIM-SM.

Use undo multicast global limit pim sm to restore the default.

Syntax

multicast global limit pim sm { source-group-number | star-group-number } limit-count [ alarm-threshold upper-limit upper-limit lower-limit lower-limit ]

undo multicast global limit pim sm { source-group-number | star-group-number }

Default

The number of PIM entries is not limited.

Views

System view

Predefined user roles

network-admin

Parameters

star-group-number: Limits the number of (*,G) entries.

source-group-number: Limits the number of (S,G) entries.

limit-count: Specifies the maximum number of PIM entries allowed, in the range of 1 to 16384.

alarm-threshold upper-limit upper-limit: Specifies the upper limit of PIM entries that causes a log message to be generated. The upper-limit argument specifies a percentage of the maximum number of PIM entries allowed. The default is 80. As a best practice, do not configure a value greater than 95.

alarm-threshold lower-limit lower-limit: Specifies the lower limit of PIM entries that causes a log message to be generated. The lower-limit argument specifies a percentage of the maximum number of PIM entries allowed. The default is 70. The value for the lower-limit argument must be smaller than or equal to the value for the upper-limit argument. As a best practice to avoid generating log messages frequently, do not configure a value smaller than 10.

Usage guidelines

When an illegal user launches an attack by using multicast data or protocol (IGMP or PIM) packets, a large number of multicast routing entries might be generated, causing high memory or CPU usage. This command can protect the device by limiting the number of PIM entries.

When the number of global PIM entries reaches the limit, new PIM entries cannot be created and a log message is generated. The log messages are sent to the information center for processing. With the information center, you can set log message filtering and output rules, including output destinations. For more information about the information center, see Network Management and Monitoring Configuration Guide.

Static (*,G) entries, static (S,G) entries, and ASM default group entries are not affected by this function.

Examples

# Set the maximum number of (S,G) entries allowed to 1000.

<Sysname> system-view

[Sysname] multicast global limit pim sm source-group-number 1000

# Set the maximum number of (*,G) entries allowed to 2000, the upper limit for generating a log message to 80%, and the lower limit for generating a log message to 70%.

<Sysname> system-view

[Sysname] multicast global limit pim sm star-group-number 2000 alarm-threshold upper-limit 80 lower-limit 70

Related commands

display multicast global pim sm statistics

multicast routing

Use multicast routing to enable IP multicast routing and enter MRIB view.

Use undo multicast routing to disable IP multicast routing.

Syntax

multicast routing [ vpn-instance vpn-instance-name ]

undo multicast routing [ vpn-instance vpn-instance-name ]

Default

IP multicast routing is disabled.

Views

System view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command enables IP multicast routing on the public network.

Usage guidelines

Other Layer 3 multicast commands take effect only when IP multicast routing is enabled on the public network or for a VPN instance.

The device does not forward multicast packets before IP multicast routing is enabled.

Examples

# Enable IP multicast routing on the public network, and enter the MRIB view of the public network.

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib]

# Enable IP multicast routing for VPN instance mvpn, and enter the MRIB view of the VPN instance.

<Sysname> system-view

[Sysname] multicast routing vpn-instance mvpn

[Sysname-mrib-mvpn]

multicast rpf-fail-pkt flooding

Use multicast rpf-fail-pkt flooding to enable the device to flood RPF-check-failed multicast data packets in all VLANs.

Use multicast rpf-fail-pkt flooding to restore the default.

Syntax

multicast rpf-fail-pkt flooding

undo multicast rpf-fail-pkt flooding

Default

RPF-check-failed multicast data packets are not flooded in VLANs.

Views

System view

Predefined user roles

network-admin

Usage guidelines

You do not need to enable IP multicast routing before you execute this command.

For this command to take effect, you must clear all multicast forwarding entries after executing this command. To clear multicast forwarding entries, use the reset multicast forwarding-table command.

Examples

# Enable the device to flood RPF-check-failed multicast data packets.

<Sysname> system-view

[Sysname] multicast rpf-fail-pkt flooding

Related commands

reset multicast forwarding-table

multicast rpf-fail-pkt trap-to-cpu

Use multicast rpf-fail-pkt trap-to-cpu to enable the device to send RPF-check-failed multicast data packets to the CPU.

Use undo multicast rpf-fail-pkt trap-to-cpu to restore the default.

Syntax

multicast rpf-fail-pkt trap-to-cpu

undo multicast rpf-fail-pkt trap-to-cpu

Default

RPF-check-failed multicast data packets are not sent to the CPU.

Views

System view

Predefined user roles

network-admin

Usage guidelines

You do not need to enable IP multicast routing before you execute this command.

For this command to take effect, you must clear all multicast forwarding entries after executing this command. To clear multicast forwarding entries, use the reset multicast forwarding-table command.

Examples

# Enable the device to send multicast data packets that fail the RPF check to the CPU.

<Sysname> system-view

[Sysname] multicast rpf-fail-pkt trap-to-cpu

Related commands

reset multicast forwarding-table

reset multicast fast-forwarding cache

Use reset multicast fast-forwarding cache to clear multicast fast forwarding entries.

Syntax

In standalone mode:

reset multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache { { source-address | group-address } * | all } [ slot slot-number [ cpu cpu-number ] ]

In IRF mode:

reset multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache { { source-address | group-address } * | all } [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]

Views

User view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command clears multicast fast forwarding entries on the public network.

source-address: Specifies a multicast source address.

group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command clears multicast fast forwarding entries on the active MPU. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command clears multicast fast forwarding entries on the global active MPU. (In IRF mode.)

cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.

all: Specifies all multicast fast forwarding entries.

Examples

# Clear all multicast fast forwarding entries on the public network.

<Sysname> reset multicast fast-forwarding cache all

# Clear the multicast fast forwarding entry for multicast source and group (20.0.0.2, 225.0.0.2) on the public network.

<Sysname> reset multicast fast-forwarding cache 20.0.0.2 225.0.0.2

Related commands

display multicast fast-forwarding cache

reset multicast forwarding event

Use reset multicast forwarding event to clear statistics for multicast forwarding events.

Syntax

reset multicast [ vpn-instance vpn-instance-name ] forwarding event

Views

User view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command clears statistics for the multicast forwarding events on the public network.

Examples

# Clear statistics for multicast forwarding events on the public network.

<Sysname> reset multicast forwarding event

Related commands

display multicast forwarding event

reset multicast forwarding-table

Use reset multicast forwarding-table to clear multicast forwarding entries.

Syntax

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

Views

User view

Predefined user roles

network-admin

Parameters

source-address: Specifies a multicast source address.

group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.

mask: Specifies an address mask. The default is 255.255.255.255.

incoming-interface: Specifies the multicast forwarding entries that contain the specified incoming interface.

interface-type interface-number: Specifies an incoming interface by its type and number.

all: Specifies all multicast forwarding entries.

Usage guidelines

When you clear a multicast forwarding entry, the associated multicast routing entry is also cleared.

Examples

# Clear multicast forwarding entries for multicast group 225.5.4.3 on the public network.

<Sysname> reset multicast forwarding-table 225.5.4.3

Related commands

display multicast forwarding-table

reset multicast routing-table

Use reset multicast routing-table to clear multicast routing entries.

Syntax

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

Views

User view

Predefined user roles

network-admin

Parameters

source-address: Specifies a multicast source address.

group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.

mask: Specifies an address mask. The default is 255.255.255.255.

incoming-interface: Specifies the routing entries that contain the specified incoming interface.

interface-type interface-number: Specifies an incoming interface by its type and number.

all: Specifies all multicast routing entries.

Usage guidelines

When you clear a multicast routing entry, the associated multicast forwarding entry is also cleared.

Examples

# Clear multicast routing entries for multicast group 225.5.4.3 on the public network.

<Sysname> reset multicast routing-table 225.5.4.3

Related commands

display multicast routing-table

snmp-agent trap enable mrib

Use snmp-agent trap enable mrib to enable SNMP notifications for multicast routing and forwarding.

Use undo snmp-agent trap enable mrib to disable SNMP notifications for multicast routing and forwarding.

Syntax

snmp-agent trap enable mrib [ entry-exceed | entry-exceed-clear ] *

undo snmp-agent trap enable mrib [ entry-exceed | entry-exceed-clear ] *

Default

SNMP notifications for multicast routing and forwarding are enabled.

Views

System view

Predefined user roles

network-admin

Parameters

entry-exceed: Specifies notifications about the number of multicast routing entries reaching the maximum number.

entry-exceed-clear: Specifies notifications about the number of multicast routing entries falling below the maximum number.

Usage guidelines

If you do not specify an optional keyword, this command enables or disables multicast routing and forwarding to generate SNMP notifications.

The maximum number of multicast routing entries is the value of the limit-count argument in the multicast global limit command or the maximum number supported by the device, whichever is smaller.

To report critical multicast routing and forwarding events to an NMS, enable SNMP notifications for multicast routing and forwarding. For multicast routing and forwarding event notifications to be sent correctly, you must also configure SNMP on the device. For more information about SNMP configuration, see Network Management and Monitoring Configuration Guide.

Examples

# Disable SNMP notifications for multicast routing and forwarding.

<Sysname> system-view

[Sysname] undo snmp-agent trap enable mrib

Related commands

multicast global limit

08-IP Multicast Command Reference

display mrib interface

display multicast forwarding event

multicast rpf-fail-pkt flooding

reset multicast routing-table

snmp-agent trap enable mrib

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