No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

Command Reference

CloudEngine 8800, 7800, 6800, and 5800 V200R002C50

This document describes all the configuration commands of the device, including the command function, syntax, parameters, views, default level, usage guidelines, examples, and related commands.
Rate and give feedback :
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
Multicast Route Management (IPv4) Commands

Multicast Route Management (IPv4) Commands

NOTE:

The CE6810LI does not support this feature.

display mrt routing-table

Function

The display mrt routing-table command displays MRT routes.

Format

display mrt routing-table [ ip-address [ mask | mask-length ] [ longer-match ] ] [ verbose ]

Parameters

Parameter Description Value
ip-address Specifies a destination IP address. The address is in dotted decimal notation.
mask Specifies mask. The mask is in dotted decimal notation.
mask-length Specifies mask length. It is an integer ranging from 0 to 32.
longer-match Displays routing information that exactly matches the specified destination IP address and mask. -
verbose Displays detailed information about active and inactive routes. If the parameter verbose is not specified, detailed information about active routes is displayed. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can specify different parameters to view specific routing information.

Example

# Display information about all MRT routes.

<HUAWEI> display mrt routing-table
Route Flags: R - relay, D - download to fib
------------------------------------------------------------------------------
Routing Tables: MRT
         Destinations : 1        Routes : 1
 
Destination/Mask  Proto  Pre  Cost  Flags  NextHop  Interface
 
  10.5.5.1/32     MSR    255     0     R   10.1.1.1  Vlanif100
Table 10-64  Description of the display mrt routing-table command output

Item

Description

Route Flags

Route flag that identifies the attribute of a route.
  • R: indicates an iterated route.

  • D: indicates that the route is downloaded to the FIB table.

Routing Tables: MRT

IMRT routing table.

Destinations

Total number of destination networks or hosts.

Routes

Total number of routes.

Destination/Mask

Address and mask length of the destination network or host.

Proto

Protocol that learns a route.

Pre

Route preference.

Cost

Route cost.

Flags

Route flag in the header of the routing table.

NextHop

Next hop of a route.

Interface

Outbound interface to a reachable next hop.

# Display the detailed information of the specified routes.

<HUAWEI> display mrt routing-table 10.12.12.12 verbose
Route Flags: R - relay, D - download to fib
------------------------------------------------------------------------------
Routing Table : MRT
Summary Count : 1

Destination: 10.12.12.12/32
      Protocol: MSR            Process ID: 0
   Preference: 1                     Cost: 0
      NextHop: 10.11.11.12      Neighbour: 0.0.0.0
        State: Active Adv Relied      Age: 00h04m49s
          Tag: 0                   Priority: low
        Label: NULL                 QoSInfo: 0x0
   IndirectID: 0x80000002
 RelayNextHop: 0.0.0.0            Interface: Vlanif100
     TunnelID: 0x0                    Flags: R
Table 10-65  Description of the display mrt routing-table verbose command output

Item

Description

Routing Table: MRT

MRT routing table.

Summary Count

Number of the destination network and host.

Destination

Address and mask length of the destination network or host.

Protocol

Routing protocol that learns a route.

Process ID

Process ID of the routing protocol.

Preference

Route preference.

Cost

Route cost.

NextHop

Next hop of a route.

Neighbour

Address of the neighbor.

State

Status of routes:
  • Active: indicates active routes.

  • Invalid: indicates invalid routes.

  • Inactive: indicates inactive routes.

  • NoAdv: indicates the routes that cannot be advertised.

  • Adv: indicates the routes that can be advertised.

  • Del: indicates the routes to be deleted.

  • Relied: indicates the route that finds the next hop and outbound interface or the route that finds the tunnel during packet forwarding.
  • WaitQ: indicates the route that does not find the next hop or outbound interface or the route that does not find the tunnel.

  • Stale.: indicates the routes with the stale flag. The routes are used in GR.

Age

Time that elapsed since a route is generated.

Tag

Administrative tag for routes.

Priority

Priority of a route.

Label

MPLS label allocated to a route.

QoSInfo

QoS information.

IndirectID

ID of the indirect next hop.

RelayNextHop

Relay next hop.

Interface

Outbound interface through which the next hop is reachable.

TunnelID

Tunnel ID.

Flags

Route flag in the header of the routing table.

display mrt routing-table statistics

Function

The display mrt routing-table statistics command displays statistics about the MRT routes.

Format

display mrt routing-table [ vpn-instance vpn-instance-name ] statistics

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies a VPN instance. vpn-instance-name specifies the name of the VPN instance.

The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Route statistics include:
  • Total number of routes that are added or deleted by the protocol
  • Number of active or inactive routes that are tagged for deletion but not deleted

Example

# Display statistics about routes in the MRT routing table.

<HUAWEI> display mrt routing-table statistics
Summary Prefixes : 0
Proto     total      active      added        deleted      freed
          routes     routes      routes       routes       routes
MSTATIC   1          0           1            0            0
Table 10-66  Description of the display mrt routing-table statistics command output

Item

Description

Summary Prefixes

Total number of route prefixes.

Proto

Routing protocol.

total routes

Total number of routes in the routing table.

active routes

Number of active routes in the routing table.

added routes

Number of active and inactive routes added in the routing table.

deleted routes

Number of routes to be deleted from the routing table.

freed routes

Number of routes that are permanently deleted from the routing table.

display mrt routing-table vpn-instance

Function

The display mrt routing-table vpn-instance command displays the MRT routing table of a VPN instance.

Format

display mrt routing-table vpn-instance vpn-instance-name [ ip-address [ mask | mask-length ] [ longer-match ] ] [ verbose ]

Parameters

Parameter Description Value
vpn-instance-name Specifies a VPN instance. vpn-instance-name specifies the name of the VPN instance.

The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

ip-address Specifies a destination IP address. The address is in dotted decimal notation.
mask Specifies mask. The mask is in dotted decimal notation.
mask-length Specifies mask length. The value is a decimal integer that ranges from 0 to 32.
longer-match Displays only routes that match the specified network or mask. -
verbose Displays detailed information about active and inactive routes. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can specify different parameters to view the specific routing information.

Example

# Display the MRT routing table of the IPv4 VPN instance named vpn1.

<HUAWEI> display mrt routing-table vpn-instance vpn1
Route Flags: R - relay, D - download to fib
------------------------------------------------------------------------------
Routing Tables: MSR
         Destinations : 1        Routes : 1
 
Destination/Mask  Proto  Pre  Cost  Flags  NextHop  Interface
 
  10.5.5.1/32     MSR    255    0     R    10.1.1.1    Vlanif100
Table 10-67  Description of the display mrt routing-table vpn-instance command output

Item

Description

Route Flags

Route flag that identifies the attribute of a route.
  • R: indicates an iterated route.

  • D: indicates that the route is downloaded to the FIB table.

Routing Tables: MSR

MRT routing table.

Destinations

Total number of destination networks or hosts.

Routes

Total number of routes.

Destination/Mask

Address and mask length of the destination network or host.

Proto

Protocol through which routes are learned.

Pre

Route preference.

Cost

Route cost.

Flags

Route flag in the header of the routing table.

NextHop

Next hop of a route.

Interface

Outbound interface to a reachable next hop.

display multicast boundary

Function

The display multicast boundary command displays the multicast boundary configured on an interface.

Format

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

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies a VPN instance. vpn-instance-name specifies the name of the VPN instance.

The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

all-instance Specifies all the instances. -
group-address Specifies a multicast group address. The address is in dotted decimal notation. The value ranges from 224.0.1.0 to 239.255.255.255.
mask Specifies the mask of the multicast group address. The mask is in dotted decimal notation.
mask-length Specifies the mask length of the multicast group address. The value is a decimal integer that ranges from 4 to 32.
interface interface-type interface-number Specifies the type and the number of an interface. The parameter is used to specify an interface. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

This command enables you to check the boundary of a PIM-SM network. When some hosts cannot receive multicast data, you can use this command to check whether the problem is caused by multicast boundary configuration.

Example

# Display the boundaries configured on all the interfaces in the public network instance.

<HUAWEI> display multicast boundary
Multicast boundary information of VPN instance: public net
Total: 1 
 Interface           Boundary
 Vlanif100           225.1.1.0/24
Table 10-68  Description of the display multicast boundary command output

Item

Description

Multicast boundary information of VPN instance

VPN instance to which multicast boundary information belongs.

Total: 1

Total number of multicast boundaries configured on a switch.

Interface

Interface configured with a multicast boundary.

Boundary

Information about the multicast boundary address.

Related Topics

display multicast ip fib

Function

The display multicast ip fib command displays the multicast forwarding table.

Format

display multicast ip fib [ [ vpn-instance vpn-instance-name ] [ group group-address | source source-address | incoming-interface { interface-type interface-number | register } ]* | all-vpn-instance ]

display multicast ip fib group group-address [ source source-address ] port-info

display multicast ip fib vpn-instance vpn-instance-name group group-address source source-address port-info

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies a VPN instance. vpn-instance-name specifies the name of the VPN instance.

The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

all-vpn-instance Indicates all the instances. -
group group-address Specifies a multicast group address. The address is in dotted decimal notation and ranges from 224.0.1.0 to 239.255.255.255.
source source-address Specifies the mask of the multicast source address. The mask is in dotted decimal notation.
incoming-interface Indicates the inbound interface of a multicast forwarding entry. -
interface-type interface-number Specifies the type and the number of an interface. -
register Indicates the register interface of a multicast forwarding entry. -
port-info Displays accurate interface information in the specified multicast forwarding entries, including Layer 2 outbound interfaces.
NOTE:

Layer 2 outbound interfaces are displayed in the specified multicast forwarding entries only if IGMP snooping has been enabled in the VLAN corresponding to the specified VLANIF interface.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

During multicast routing and forwarding, routing information generated by multicast routing protocols is saved in a multicast routing table. The switch selects the optimal multicast routes from the routing table according to multicast routing and forwarding policies, and then delivers the selected multicast routes to the multicast forwarding table to guide multicast data forwarding.

You can use the display multicast ip fib command to check whether multicast forwarding entries have been generated and whether multicast data can be forwarded normally.

NOTE:

The output does not show the real-time statistics.

Example

# Display the multicast forwarding table.

If the device is running PIM-SM, the following information is displayed:
<HUAWEI> display multicast ip fib
Multicast Forwarding Table of VPN-Instance: public net 
Total 1 entry, 1 matched 

1.(10.10.10.2, 225.0.0.1) 
     Index : 17 
     Flags : 1 
     Timeout: 00:00:00 
     Incoming interface : Vlanif10 
     Outgoing Interfaces: 2 
       1: Vlanif20 
       2: Vlanif30 
     Matched packets :34640 packets(3602664 bytes) 
     Wrong interface :0 packets 
     Forwarded       :34640 packets(3602664 bytes) 
If the device is running Bidir-PIM, the following information is displayed:
<HUAWEI> display multicast ip fib
Multicast Forwarding Table of VPN-Instance: public net 
Total 1 entry, 1 matched 

1.(*, 225.0.0.1) 
     Protocol: bidir-pim 
     Flag : 1 
     Incoming interfaces: 2 
       1: Vlanif10 
       2: Vlanif20 
     Outgoing interfaces: 2 
       1: Vlanif10 
       2: Vlanif20 
Table 10-69  Description of the display multicast ip fib command output

Item

Description

Multicast Forwarding Table of VPN-Instance

VPN instance to which the multicast forwarding table corresponds

Total 1 entry, 1 matched

Total number of forwarding entries and number of eligible forwarding entries

1

Sequence number of the (*,G) or (S, G) entry

(10.10.10.2, 225.0.0.1)

(S, G) entry in the multicast forwarding table

Index

Uniquely identifies the multicast forwarding entry in the MFIB table. Index is used to rapidly search the multicast forwarding table.

Protocol

Protocol that generates the multicast forwarding entries.

Flags

Indicates the status flag of the (*,G) or (S, G) entry.

Timeout

Remaining time of the (S, G) entry

Incoming interface

Incoming interface of the (*,G) or (S, G) entry

Outgoing interface

Outbound interface of the (*, G) or (S, G) entry. Outbound interface information in PIM-SM entries includes:

  • Name and number of the outbound interface
  • Number of packets with an incorrect incoming interface
  • Forwarded multicast traffic, in bytes
NOTE:

The statistics only show whether the multicast traffic is active. When there is active multicast traffic, the system displays non-0 values no matter whether outbound interfaces are available.

Display accurate outbound interface information in multicast forwarding entries.
<HUAWEI> display multicast ip fib group 225.0.0.1 port-info
Multicast Forwarding Table of VPN-Instance: public net 
Total 1 entry, 1 matched 

1.(*, 225.0.0.1) 
     Protocol: bidir-pim 
     Flag : 1 
     Incoming interfaces: 2 
       1: Vlanif10 
       2: Vlanif20 
     Outgoing interfaces: 2 
       1: Vlanif10 
       2: Vlanif20 
       IGMP Snooping port in VLAN 20:
          1: 10GE1/0/1
Table 10-70  Description of the display multicast ip fib group 225.0.0.1 port-info command output

Item

Description

IGMP Snooping port in VLAN 20

Layer 2 outbound interfaces in VLAN 20.

display multicast routing-table

Function

The display multicast routing-table command displays information about a multicast routing table.

Format

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

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

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies a VPN instance. vpn-instance-name specifies the name of the VPN instance.

The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

all-instance Specifies all the instances. -
group-address Indicates the multicast group address. The address is in dotted decimal notation. The value ranges from 224.0.1.0 to 239.255.255.255.
mask { group-mask | group-mask-length } Indicates the mask of the multicast group address.
  • group-mask: The address is in dotted decimal notation. The value ranges from 240.0.0.0 to 255.255.255.255.
  • group-mask-length: The value is an integer that ranges from 4 to 32
source-address Indicates the multicast source address. The address is in dotted decimal notation.
mask { source-mask | source-mask-length } Indicates the mask of the specified source address.
  • source-mask: The address is in dotted decimal notation. The value ranges from 0.0.0.0 to 255.255.255.255.
  • source-mask-length: The value is an integer that ranges from 0 to 32
incoming-interface Indicates the upstream interface of a multicast routing entry. -
interface-type interface-number Indicates the type and the number of an interface. -
register Indicates the register interface of a multicast routing entry. -
outgoing-interface Indicates the downstream interface of a multicast routing entry. -
include Displays the (S, G) entries whose downstream interface list contains specified downstream interfaces. -
exclude Displays the (S, G) entries whose downstream interface list does not contain specified downstream interfaces. -
match Displays the (S, G) entries whose the downstream interface list contains only one interface that is the same as a specified downstream interface. -
none Indicates that the downstream interface list is null. -
outgoing-interface-number Indicates the number of downstream interfaces of multicast routing entries. -
number Specifies the number of downstream interfaces. The value is an integer that ranges from 0 to 2048.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display multicast routing-table command is used to display the information of a multicast routing table.

Example

# Display the corresponding routing entry of a multicast group in the multicast routing table.
<HUAWEI> display multicast routing-table
 Multicast routing table of VPN instance: public net
 Total 0 (*, G) entry; 1 (S, G) entry

 00001: (192.168.0.2, 227.0.0.1)
       Uptime: 00:00:28
       Upstream Interface: Vlanif10
       List of 2 downstream interfaces
           1:  Vlanif20
           2:  Vlanif30
Table 10-71  Description of the display multicast routing-table command output

Item

Description

Total 0 (*, G) entry; 1 (S, G) entry

Number of eligible routing entries.

00001:

Sequence number of the (S, G) entry.

(192.168.0.2, 227.0.0.1)

(S, G) entry in the multicast routing table.

Uptime

Time that elapsed since the (S, G) entry was generated.

Upstream Interface

Upstream interface of the (S, G) entry.

List of 2 downstream interfaces

Downstream interface list.

# Display the number of downstream interfaces of the multicast routing entries.
<HUAWEI> display multicast routing-table outgoing-interface-number
Multicast routing table of VPN-Instance: public net
 Total 0 (*, G) entry; 2 (S, G) entries

 00001. (10.1.1.22, 232.1.1.1)
       Uptime: 00:00:07
       Upstream Interface: Vlanif10
       List of 20 downstream interfaces

 00002. (10.1.1.22, 232.1.2.1)
       Uptime: 00:00:07
       Upstream Interface: Vlanif20
       List of 20 downstream interfaces
Table 10-72  Description of the display multicast routing-table outgoing-interface-number command output

Item

Description

List of 20 downstream interfaces

Number of downstream interfaces in multicast routing entries.

display multicast routing-table static

Function

The display multicast routing-table static command displays the multicast static routes.

Format

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

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies a VPN instance. vpn-instance-name specifies the name of the VPN instance.

The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

config Displays the configuration of the multicast static routes. -
source-address Specifies a multicast source address. The address is in dotted decimal notation.
mask Specifies the mask of the multicast source address. The mask is in dotted decimal notation.
mask-length Specifies the mask length of the multicast source address. The value is an integer that ranges from 0 to 32.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To check whether multicast RPF static routes are configured successfully, run the display multicast routing-table static command.

Example

# Display all multicast static routes in the public network instance on the switch.
<HUAWEI> display multicast routing-table static
 
Multicast Routing Table
Routes : 1

 Mroute 10.1.0.0/24
          Interface = Vlanif100       RPF Neighbor = 10.1.2.2
          Matched routing protocol = ospf, process-id = 100, Route-policy = none
          Preference = 1, Order = 1
 Running Configuration = ip rpf-route-static 10.1.0.0 24 ospf 100 10.1.2.2 order 1
Table 10-73  Description of the display multicast routing-table static command output

Item

Description

Multicast Routing Table

Multicast routing table.

Routes

Number of routes.

Mroute

Source address and mask length of a multicast route.

Interface

Outbound interface of the reachable multicast source.

RPF Neighbor

Neighbor IP address through which the source address is reachable.

Matched routing protocol

Matching unicast route type, which can be:
  • IS-IS
  • RIP
  • OSPF
  • BGP
  • Unicast static route

process-id

Process ID of a routing protocol.

Route-policy

Routing policy. The source address of a route must match the routing policy.

Preference

Preference of a route.

Order

Order of a route.

Running Configuration

Command line for configuring a static route.

Related Topics

display multicast rpf-info

Function

The display multicast rpf-info command displays the Reverse Path Forwarding (RPF) routes of a specified IPv4 multicast source or source/group.

Format

display multicast [ vpn-instance vpn-instance-name | all-instance ] rpf-info source-address [ group-address ] [ rpt | spt ] [ verbose ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies a VPN instance. vpn-instance-name specifies the name of the VPN instance.

The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

all-instance Indicates all the instances. -
source-address Specifies the address of a multicast source, used to display the information of RPF routing corresponding to the source. The address is in dotted decimal notation.
group-address Specifies the multicast group address, used to display the information of RPF routing corresponding to the source/group. The address is in dotted decimal notation and ranges from 224.0.1.0 to 239.255.255.255.
rpt Displays the RPF routing information corresponding to a specified source or source/group on the shared RP-tree. -
spt Displays the RPF routing information corresponding to a specified source or source/group on the shortest path tree. -
verbose Displays detailed routing information. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The RPF route with the source-address as the destination address is an optimal route selected from unicast routes, multicast static routes, MBGP routes, and MIGP routes. You can use the display multicast rpf-info command to check the RPF route to the specified source or source-group.

Example

# Display all RPF routes to the source address 192.168.0.1.
<HUAWEI> display multicast rpf-info 192.168.0.1
 VPN-Instance: public net
 RPF information about source: 192.168.0.1
     RPF interface: Vlanif100, RPF neighbor: 10.1.5.2
     Referenced route/mask: 192.168.0.0/24
     Referenced route type: unicast
     Route selection rule: preference-preferred
     Load splitting rule: disable
Table 10-74  Description of the display multicast rpf-info command output

Item

Description

RPF information about source

Multicast source to which the multicast RPF path belongs.

RPF interface

RPF interface.

RPF neighbor

RPF neighbor.

Referenced route/mask

Referenced route and its mask.

Referenced route type

Referenced route types:
  • unicast: unicast routes

  • MBGP: MBGP routes

  • mstatic: multicast static routes

  • MIGP: MIGP routes

Route selection rule

RPF route selection rules:
  • preference-preferred: selecting routes based on the preference of the routing protocols

  • longest-match: selecting routes based on the longest matching rule

Load splitting rule

Load splitting rules:
  • disable: load splitting disabled.

  • stable-preferred: stable-preferred load splitting.

  • source: load splitting based on source addresses.

  • group: load splitting based on group addresses.

  • source-group: load splitting based source and group addresses.

# Display details about the RPF route to multicast source 10.100.100.100.
<HUAWEI> display multicast rpf-info 10.100.100.100 verbose
 VPN-Instance: public net
 RPF information about source: 10.100.100.100 
     RPF used topology: default
     RPF interface: Vlanif20, RPF neighbor: 10.113.113.117                 
     Referenced route/mask: 10.100.100.100/32                                  
     Referenced route type: unicast 
     Route selection rule: preference-preferred 
     Load splitting rule: balance-preferred                                      
 Total route information about source 10.100.100.100 
     Destination/Mask   Proto   Pre Cost   NextHop         Interface
     10.100.100.100/32  unicast 15  10     10.0.0.7        Vlanif10  
     10.100.100.100/32  unicast 15  10     10.111.111.7    Vlanif12
     10.100.100.100/32  unicast 15  10     10.113.113.7    Vlanif20
Table 10-75  Description of the display multicast rpf-info source-address verbose command output

Item

Description

RPF used topology

Topology used by the RPF route.

Total route information about source 10.100.100.100

Information about all routes towards source 10.100.100.100.

Destination/Mask

Destination address and mask of a route towards the source.

Proto

Type of the routing protocol from which an RPF route is originated.

Pre

RPF route preference.

Cost

Cost of the route towards the specified source.

NextHop

Next hop address towards the specified source.

Interface

Outbound interface towards the specified source.

ip rpf-route-static

Function

The ip rpf-route-static command configures a multicast static route.

The undo ip rpf-route-static command deletes a multicast static route.

By default, no multicast static route is configured.

Format

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

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

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies a VPN instance. vpn-instance-name specifies the name of the VPN instance.

The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

source-address Specifies the address of a multicast source. The address is in dotted decimal notation.
mask Indicates the address mask of the multicast source. The address mask is in dotted decimal notation.
mask-length Specifies the mask length of the multicast source address. The value is a decimal integer that ranges from 0 to 32.
interface-type interface-number Specifies the type and the number of an interface, used to specify an interface. -
gateway-address Specifies the address of the gateway. -
preference preference Indicates the preference of routes. The greater the value is, the lower the preference is. The value is a decimal integer that ranges from 1 to 255. By default, it is 1.
all Indicates all multicast static routes in the multicast static routing table. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A multicast static route specifies an RPF interface or RPF neighbor for multicast packets from a specified multicast source. You can configure a multicast static route to:

  • Change an RPF route.

    If you want an interface to receive multicast data packets from a specified multicast source but the interface is not the RPF interface for the multicast source, configure a multicast static route to specify this interface as the RPF interface for the multicast source. When the switch receives multicast data packets from the multicast source, it performs RPF check using the configured RPF route. Packets sent from the source to the switch through other interfaces fail the RPF check.

  • Connect RPF routes.

    If the unicast route on a network segment is incomplete, multicast packets cannot be forwarded due to lack of an RPF route. For example, when two adjacent devices run different routing protocols but the routing protocols do not import routes from each other, packets cannot be forwarded between the two devices. In this case, you can configure RPF static routes on the devices. The devices can perform RPF check using the specified RPF interfaces so that multicast packets can be forwarded successfully.

Precautions
  • When configuring a multicast static route, configure the next hop interface in the command if the type of the next hop interface is P2P. If the next hop interface is not P2P, configure it in the next hop address form.

  • A multicast static route configured using the ip rpf-route-static command may not take effect if the outbound interface fails to be iterated or the specified interface is Down. Therefore, after running this command, you are advised to run the display ip routing-table protocol static command to check whether the configuration is successful or the configured multicast static route is effective.

Example

# Configure a multicast static route.

<HUAWEI> system-view
[~HUAWEI] ip rpf-route-static 10.0.0.0 255.0.0.0 10.10.0.1

multicast boundary

Function

The multicast boundary command configures a multicast boundary for a single administrative range.

The undo multicast boundary command deletes the configured multicast boundary.

By default, no multicast boundary is configured on an interface.

Format

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

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

Parameters

Parameter Description Value
group-address Specifies the address of a multicast group, used to specify a multicast group and configure the forwarding range of the multicast packets for the group. The address is in dotted decimal notation and ranges from 224.0.1.0 to 239.255.255.255.
mask Indicates the mask of a specified group address. The mask is in dotted decimal notation.
mask-length Indicates the mask length of a specified group address. The value is an integer that ranges from 4 to 32.
all Deletes all the multicast boundaries configured on an interface. -

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Data of some multicast groups needs to be forwarded within a specified range. For example, each BSR administrative domain serves a specific group address range, and data packets sent from multicast sources to these groups need to be forwarded within the matching administrative domain. After a multicast boundary is configured for specified multicast groups on an interface, multicast packets sent to these groups cannot be forwarded through the interface. This restricts multicast forwarding within a range.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

To configure the boundary for different multicast groups, you can repeat the command on the same interface.

A and B are the forwarding boundary sets of the multicast group range to be configured, and B is a subset of A. If A is first configured on an interface, B cannot be configured. If you configure A on the interface that has been configured with B, B is replaced by A.

Example

# Configure VLANIF100 as the boundary of group 239.2.0.0/16.
<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] multicast boundary 239.2.0.0 16
# Configure 10GE1/0/1 as the boundary of group 239.2.0.0/16.
<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] undo portswitch
[*HUAWEI-10GE1/0/1] multicast boundary 239.2.0.0 16

multicast cpu-forward disable

Function

The multicast cpu-forward disable command disables soft forwarding for multicast packets.

The undo multicast cpu-forward disable command restores the default configuration.

By default, soft forwarding for multicast packets is enabled.

Format

multicast cpu-forward disable

undo multicast cpu-forward disable

Parameters

None.

Views

System view, VPN instance view, VPN IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In most cases, the switch forwards packets based on software before the hardware forwarding is completed. After that, the switch forwards packets based on hardware.

Soft forwarding for multicast packets must be disabled on the switch to prevent the low forwarding speed and first packet cache mechanism of soft forwarding from causing disorder of the first packet transmitted at a high speed.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

In the scenario where Fast Channel Change (FCC) is enabled, it is recommended that you use the multicast cpu-forward disable command to disable soft forwarding for multicast packets.

Example

# Disable soft forwarding for multicast packets.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] multicast cpu-forward disable

multicast invalid-packet

Function

The multicast invalid-packet command sets the maximum number of invalid multicast protocol packets that can be stored on the switch.

The undo multicast invalid-packet command deletes the set maximum number of invalid multicast protocol packets that can be stored on the switch.

By default, the switch can save a maximum of 10 invalid packets for each specific multicast protocol.

Format

multicast invalid-packet { igmp | mdt | msdp | pim } max-count max-number

undo multicast invalid-packet { igmp | mdt | msdp | pim }

Parameters

Parameter Description Value
igmp Sets the maximum number of invalid IGMP messages. -
mdt Sets the maximum number of invalid multicast VPN messages. -
msdp Sets the maximum number of invalid MSDP messages. -
pim Sets the maximum number of invalid PIM messages. -
max-count max-number Sets the maximum number of invalid multicast protocol packets that can be stored on a device. The value is an integer ranging from 1 to 100.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

If multicast entries fail to be generated or peer relationships fail to be set up, you can enable the switch to store invalid multicast protocol packets and view statistics and details of the invalid multicast protocol packets. Based on the command output, you can locate and rectify faults.

Example

# Set the maximum number of invalid IGMP messages that can be stored on the switch to 20.

<HUAWEI> system-view
[~HUAWEI] multicast invalid-packet igmp max-count 20

multicast load-splitting

Function

The multicast load-splitting command enables load splitting among multicast routes.

The undo multicast load-splitting command restores the default configuration.

By default, load splitting among multicast routes is disabled.

Format

multicast load-splitting { balance-ucmp | stable-preferred | group | source | source-group }

undo multicast load-splitting

Parameters

Parameter Description Value
balance-ucmp Indicates link bandwidth-based load splitting. This policy is applicable to the scenario in which links have different bandwidth. -
stable-preferred Indicates stable-preferred load splitting. This policy is applicable to stable multicast networking. -
group Indicates group address-based load splitting. This policy is applicable to the scenario of one source to multiple groups. -
source Indicates source address-based load splitting. This policy is applicable to the scenario of multiple sources to one group. -
source-group Indicates source and group addresses-based load splitting. This policy is applicable to the scenario of multiple sources to multiple groups. -

Views

System view, VPN instance view, VPN IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, if there are multiple equal-cost routes to a multicast source, the switch applies the following route selection rules during RPF check:

  • If the equal-cost routes are in the same routing table, for example, unicast routing table, multicast static routing table, or MBGP routing table, the switch selects the route with the largest next-hop address as the RPF route.
  • If the equal-cost routes are in different routing tables, the switch selects the route with the highest preference. If the routes have the same preference, the switch selects the route with the longest mask length. If the routes have the same preference and mask length, the switch uses certain algorithm to select a route as the RPF route.

No matter which rule is used, the switch selects only one route as the RPF route. To enable multicast data to be forwarded through multiple paths, run the multicast load-splitting command to configure multicast load splitting. After multicast load splitting is configured, the switch uses the specified load splitting policy to distribute multicast data among multiple paths. This function improves quality of multicast forwarding.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

The five load splitting policies are mutually exclusive.
  • If balance-ucmp is specified, the switch automatically adjusts and balances traffic based on link bandwidth, implementing unequal load splitting.
  • If stable-preferred is specified, the switch automatically adjusts and balances the entries when equal-cost routes are added or deleted. However, when multicast routing entries are deleted or load splitting weights on the interfaces are changed, the switch does not automatically adjust the entries on the equal-cost routes.

  • If group, source, or source-group is specified, fixed algorithms are used for load splitting. When multicast routing entries and network configurations are stable, RPF interfaces and RPF neighbors stay unchanged.

This command is mutually exclusive with the pim dm command.

Example

# Configure group address-based load splitting in the public network instance.
<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] multicast load-splitting group

multicast longest-match

Function

The multicast longest-match command configures the switch to select the RPF route based on the longest matching rule.

The undo multicast longest-match command restores the default configuration.

By default, the switch selects the route with the highest preference as the RPF route.

Format

multicast longest-match

undo multicast longest-match

Parameters

None

Views

System view, VPN instance view, VPN IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, the switch selects the RPF route based on route preference. This command changes the route selection policy used by the switch during RPF check. After you run this command, the switch selects the RPF route with the longest mask. If multiple routes have the same mask length, the switch selects the route with the highest preference.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Example

# Select routes according to the longest match on the switch in the public network instance.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] multicast longest-match

multicast routing-enable

Function

The multicast routing-enable command enables the multicast routing function.

The undo multicast routing-enable command restores the default configuration.

By default, the multicast routing function is disabled.

Format

multicast routing-enable

undo multicast routing-enable

Parameters

None

Views

System view, VPN instance view, VPN IPv4 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Before configuring Layer 3 multicast, you must enable the multicast routing function globally. Layer 3 multicast protocols (such as PIM and IGMP) and other Layer 3 multicast functions can be configured only after multicast routing is enabled.

Precautions

The undo multicast routing-enable command deletes all multicast configurations of the device. If multicast services are running on the device, the multicast services are interrupted when this command is executed. To restore multicast services on the instance, you must re-configure the corresponding commands.

Example

# Enable multicast routing globally or in the public network instance.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
Translation
Download
Updated: 2019-03-21

Document ID: EDOC1000166501

Views: 43742

Downloads: 330

Average rating:
This Document Applies to these Products
Related Documents
Related Version
Share
Previous Next