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

S1720, S2700, S5700, and S6720 V200R011C10

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

Command Support

Product Support
S1720 Not supported.
S2700 Not supported.
S5700 Supported by all models excluding the S5700S-LI, S5700LI, and S5710-X-LI.
S6720

Supported.

NOTE:

Only S5720EI, S5720HI, S6720EI, and S6720S-EI support the multicast multi-instance feature.

display default-parameter mrm

Function

The display default-parameter mrm command displays the default configurations for multicast routing management (MRM).

Format

display default-parameter mrm

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

This command displays only the default configurations, regardless of whether MRM parameters are changed. Therefore, you can use this command to check which parameters have been modified.

Example

# Display default configurations for MRM.

<HUAWEI> display default-parameter mrm
  System View Default Configurations:
  -----------------------------------
  Load splitting rule: disabled
  Load-splitting-timer: 1800 s
  Route selection rule: preference-preferred
  Multi-topology: disabled

  Interface View Default Configurations:
  --------------------------------------
  Minimum TTL: 1
  Reject inbound data: disabled
  Reject outbound data: disabled
  Multicast load-splitting weight: 1
Table 8-89  Description of the display default-parameter mrm command output

Item

Description

System View Default Configurations

Default configurations for multicast routing management (MRM) in the system view.

Load splitting rule

Whether multicast load splitting is configured. By default, multicast load splitting is not configured. To configure multicast load splitting, run the multicast load-splitting command.

Load-splitting-timer

Default value of the multicast load splitting balancing timer. By default, the value is 1800s. You can run the multicast load-splitting-timer command to set the value of the multicast load splitting balancing timer.

Route selection rule

RPF route selection rule. By default, RPF route selection is based on the preference of the routing protocol.

Interface View Default Configurations

Default configurations for multicast routing management (MRM) in the interface view.

Minimum TTL

Minimum TTL value for multicast packet forwarding.

Reject inbound data

Whether the interface is disabled from receiving multicast packets.

Reject outbound data

Whether the interface is disabled from forwarding multicast packets.

Multicast load-splitting weight

Multicast load splitting weight of the interface. By default, the multicast load splitting weight of an interface is 1. You can run the multicast load-splitting weight command to set the value of the multicast load splitting weight.

display migp routing-table

Function

The display migp routing-table command displays brief information about the MIGP routing table.

Format

display migp routing-table [ ip-address [ mask-length | mask ] ] [ verbose ]

Parameters

Parameter Description Value
ip-address Specifies a destination IP address. The address is in dotted decimal notation.
mask Indicates a mask. The mask is in dotted decimal notation.
mask-length Specifies the length of the mask. The value is a decimal integer ranging from 0 to 32.
verbose Displays detailed information about active routes and inactive routes. If the parameter is not specified, only brief information about active routes is displayed. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

This command displays the MIGP routing table. You can specify parameters in the command to view specified routes.

Example

# Display brief information about the MIGP routing table.

<HUAWEI> display migp routing-table
Route Flags: R - relay, D - download to fib
------------------------------------------------------------------------------
Routing Tables: MIGP
         Destinations : 4        Routes : 4

Destination/Mask    Proto  Pre  Cost     Flags NextHop         Interface

10.4.4.4/32         OSPF   10   3              10.0.1.1        Vlanif100
10.5.5.5/32         OSPF   10   4              10.0.1.1        Vlanif100
10.0.3.0/24         OSPF   10   3              10.0.1.1        Vlanif100
192.168.3.0/24      OSPF   10   4              10.0.1.1        Vlanif100
Table 8-90  Description of the display migp routing-table command output

Item

Description

Route Flags

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

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

Routing Tables: MIGP

MIGP 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

Routing protocol that learns a route.

Pre

Route preference.

Cost

Route cost.

Flags

Route flags in the header of the routing table.

NextHop

Next hop of a route.

Interface

Outbound interface to a reachable next hop.

# Display detailed information about the MIGP routing table.

<HUAWEI> display migp routing-table verbose
Route Flags: R - relay, D - download to fib
------------------------------------------------------------------------------
Routing Table : MIGP
         Destinations : 5        Routes : 5


Destination: 10.4.4.4/32
     Protocol: ISIS            Process ID: 1
   Preference: 15                    Cost: 20
      NextHop: 10.0.1.1         Interface: Vlanif100
        State: Active Adv             Age: 00h34m26s

Destination: 10.5.5.5/32
     Protocol: ISIS            Process ID: 1
   Preference: 15                    Cost: 30
      NextHop: 10.0.1.1         Interface: Vlanif100
        State: Active Adv             Age: 00h34m26s

Destination: 10.0.2.0/24
     Protocol: ISIS            Process ID: 1
   Preference: 15                    Cost: 20
      NextHop: 10.0.1.1         Interface: Vlanif100
        State: Active Adv             Age: 00h34m26s

Destination: 10.0.3.0/24
     Protocol: ISIS            Process ID: 1
   Preference: 15                    Cost: 30
      NextHop: 10.0.1.1         Interface: Vlanif100
        State: Active Adv             Age: 00h34m27s

Destination: 192.168.3.0/24
     Protocol: ISIS            Process ID: 1
   Preference: 15                    Cost: 40
      NextHop: 10.0.1.1         Interface: Vlanif100
        State: Active Adv             Age: 00h34m28s
Table 8-91  Description of the display migp routing-table verbose command output

Item

Description

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

Preference of a route.

Cost

Indicates the route cost.

NextHop

Next hop of a route.

Interface

Outbound interface of a route.

State:

Status of routes, which can be:
  • Active: indicates routes in the Active state.

  • Invalid: indicates invalid routes.

  • Inactive: indicates routes in the Inactive state.

  • NoAdv: indicates routes that cannot be advertised.

  • Adv: indicates routes that can be advertised.
  • Del: indicates routes to be deleted.

  • GotQ: indicates routes that are relayed successfully.

  • WaitQ: indicates routes that are not relayed successfully yet.

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

Age

Time that elapsed since a route is generated.

display migp routing-table statistics

Function

The display migp routing-table statistics command displays the statistics about the MIGP routing table.

Format

display migp routing-table statistics

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Integrated route statistics contain the total number of routes added or deleted through protocols and the total number of active or inactive routes with deletion flags but are not deleted.

Example

# Display the statistics about routes in the MIGP routing table.

<HUAWEI> display migp routing-table statistics
Proto     total      active      added        deleted      freed
          routes     routes      routes       routes       routes
OSPF      0          0           0            0            0
IS-IS     5          5           45           40           40
Total     5          5           45           40           40
Table 8-92  Description of the display migp routing-table statistics command output

Item

Description

Proto

Routing protocol.

total routes

Total number of routes in the current routing table.

active routes

Number of active routes in the routing table.

added routes

Number of routes (active and inactive) added to the routing table.

deleted routes

Number of routes deleted from the routing table.

freed routes

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

display mrt routing-table

Function

The display mrt routing-table command displays MRT routes.

Format

display mrt routing-table [ vpn-instance vpn-instance-name ] [ ip-address [ mask | mask-length ] ] [ 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 must be an existing 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. It is an integer ranging from 0 to 32.
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 8-93  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 8-94  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 must be an existing 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
Proto     total      active      added        deleted      freed
          routes     routes      routes       routes       routes
MSTATIC   1          0           1            0            0
Table 8-95  Description of the display mrt routing-table statistics command output

Item

Description

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 must be an existing 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 8-96  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 mtrace statistics

Function

The display mtrace statistics command displays statistics about multicast trace (Mtrace) packets.

Format

display mtrace statistics

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To collect statistics about Mtrace traffic generated in a certain period, clear the original statistics.

Example

# Display statistics about the current Mtrace traffic.

<HUAWEI> display mtrace statistics
Mtrace statistics:
 Type          Send        Receive        Invalid
 Query         10          5              0
 Request       20          4              0
 Response      3           7              1
Table 8-97  Description of the display mtrace statistics command output

Item

Description

Type

Indicates the types of Mtrace packets. The types are as follows:
  • Query: IGMP-Tracert-Query packets.

  • Request: IGMP-Tracert-Request packets.

  • Response: IGMP-Tracert-Response packets.

Send

Indicates the number of sent packets.

Receive

Indicates the number of received packets.

Invalid

Indicates the number of invalid packets.

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 must be an existing 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.

<HUAWEI> display multicast boundary
Multicast boundary information 
Total 1 Multicast IPv4 boundary
 Interface           Boundary
 Vlanif100           225.1.1.0/24
Table 8-98  Description of the display multicast boundary command output

Item

Description

Multicast boundary information of

multicast boundary information.

Total 1 Multicast IPv4 boundary

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 forwarding-table

Function

The display multicast forwarding-table command displays the multicast forwarding table.

Format

display multicast [ vpn-instance vpn-instance-name | all-instance ] forwarding-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 } | { statistics | 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 must be an existing VPN instance name.
all-instance Indicates all the instances. -
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.
mask Specifies the mask of a multicast address or source address. -
group-mask Specifies the mask of the multicast group address. The mask is in dotted decimal notation.
group-mask-length Specifies the mask length of the multicast group address. The value is a decimal integer that ranges from 4 to 32.
source-address Specifies the mask of the multicast source address. The mask is in dotted decimal notation.
source-mask Specifies the mask of the multicast source address. The mask is in dotted decimal notation.
source-mask-length Specifies the mask length of the multicast source address. The value is a decimal integer that ranges from 0 to 32.
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 PIM-SM. -
outgoing-interface Indicates the outbound interface of a multicast forwarding entry. -
include Displays the (S, G) entry list that contains the specified downstream interface. -
exclude Displays the (S, G) entry list that does not contain the specified downstream interface. -
match Displays the (S, G) entry list that matches the specified interface and the (S, G) entries have only one specified interface. -
none Indicates that the downstream interface list is null. -
verbose Displays the detailed information about the multicast forwarding table. -
statistics Displays the statistics about the multicast forwarding table. -

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 forwarding-table command to check whether multicast forwarding entries have been generated and whether multicast data can be forwarded normally.

Example

# Display the multicast forwarding table.

<HUAWEI> display multicast forwarding-table
Multicast Forwarding Table
Total 1 entry, 1 matched

00001. (10.10.10.2, 225.0.0.1)
     MID: 0, Flags: ACT
     Uptime: 00:08:32, Timeout in: 00:03:26
     Incoming interface: Vlanif10
     List of 1 outgoing interfaces:
       1:  Vlanif20
           Activetime: 00:23:15
     Matched 154 packets(15378 bytes), Wrong If 0 packets
     Forwarded 154 packets(15378 bytes)
Table 8-99  Description of the display multicast forwarding-table command output

Item

Description

Multicast Forwarding Table

multicast forwarding table.

Total 1 entry, 1 matched

Total number of forwarding entries and number of eligible forwarding entries.

00001

Sequence number of the (S, G) entry.

(10.10.10.2, 225.0.0.1)

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

MID

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

Flags

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

  • ACT: indicates that an active event is triggered.
  • DUM: indicates a dummy entry.
  • MISS: indicates that the nocache time needs to be reported.
  • DROP: indicates packet dropping.
  • LTH: indicates that the traffic volume is below the threshold.
  • DEL: indicates a deleted entry.
  • RST: indicates that registration of the known timer is started.
  • 2SYNC: indicates that the entry is contained in the MFIB table but it does not exist on the device.
  • 2ADD: indicates that the entry existing on the device has not been added to the MFIB table.
  • CLR: indicates that the MFIB table is resetting.
  • L2FWD: indicates that the device forwards Layer 2 traffic in multicast mode.
  • 2ACK: indicates that the VPN instance is waiting for the ACK message from the slave main control board.
  • 2RSED: indicates that the entry is waiting for retransmission.
  • BKCLR: indicates that the MFIB table on the slave main control board is resetting.
  • 2DEL: indicates that the entry deleted from the device has not been removed from the MFIB table.
  • PDEL: indicates that the entry does not exist on the device.
  • A denotes addition; D denotes deletion; I denotes upstream update; R denotes RP update; P denotes PMBR; F denotes flag.
  • S denotes SPT; E denotes encapsulation group update; US denotes status update; CS denotes status clearing.

Uptime

Period duration of the (S, G) entry.

Timeout in

Remaining time of the (S, G) entry.

Incoming interface

Upstream interface of the (S, G) entry.

List of 1 outgoing interfaces

Downstream interface list. The contents of the downstream interface list are as follows:
  • Name and number of the outbound interface
  • The existing time of outbound interface

Matched rate: 0 packets/sec, 0 bits/sec

Rate of multicast packets matching the (S, G) entry.
NOTE:

Only the S5720HI can provide the accurate counter values.

Wrong If 0 packets

Number of multicast packets matching the (S, G) entry but are not forwarded.
NOTE:

Only the S5720HI can provide the accurate counter values.

Forwarded 154 packets(15378 bytes)

Number of packets and bytes forwarded by the (S, G) entry.
NOTE:

Only the S5720HI can provide the accurate counter values.

display multicast routing-table

Function

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

Format

display multicast [ vpn-instance vpn-instance-name | all-instance ] 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 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 | vpn-instance vpn-instance-name | 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 must be an existing 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 Indicates the (S, G) entries whose downstream interface list contains specified downstream interfaces. -
exclude Indicates the (S, G) entries whose downstream interface list does not contain specified downstream interfaces. -
match Indicates (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 
 Total 1 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 8-100  Description of the display multicast routing-table command output

Item

Description

Multicast routing table of

multicast routing information.

Total 1 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 
 Total 2 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 8-101  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 must be an existing 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 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 8-102  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 ]

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 must be an existing 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. -

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 8-103  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.

  • balance-preferred: load balancing preferred.

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

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 } [ isis process-id | ospf process-id | rip process-id | bgp | static ] [ route-policy route-policy-name ] { interface-type interface-number | gateway-address } [ preference preference ] [ order order-number ]

undo ip rpf-route-static [ vpn-instance vpn-instance-name ] { source-address { mask | mask-length } [ isis process-id | ospf process-id | rip process-id | bgp | static ] [ route-policy route-policy-name ] | 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 must be an existing 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.
isis process-id Specifies that matched routes must be generated by the IS-IS protocol. process-id indicates the IS-IS process ID. The value is a decimal integer that ranges from 1 to 65535.
ospf process-id Specifies that matched routes must be generated by the OSPF protocol. process-id indicates the OSPF process ID. The value is a decimal integer that ranges from 1 to 65535.
rip process-id Specifies that matched routes must be generated by the RIP protocol. process-id indicates the RIP process ID. The value is a decimal integer that ranges from 1 to 65535.
bgp Specifies that matched routes must be generated by the BGP protocol. -
static Specifies that matched routes must be static routes. -
route-policy route-policy-name Indicates the matching rule of multicast static routes. route-policy-name specifies the name of a route matching rule.

The name is a string of 1 to 40 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

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. -
order order-number Indicates the configuration order of routes in the same network segment. The value is a decimal integer that ranges from 1 to 100.
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 an 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 the lack of an RPF route. For example, when two adjacent devices run different routing protocols and 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 checks using the specified RPF interfaces so that multicast packets can be forwarded successfully.

Precautions

  • If you specify a protocol type in the ip rpf-route-static command, the switch compares the configured multicast static route with the unicast routes of the specified protocol. If protocol types of the optimal unicast route and the multicast static route are different, the switch selects the optimal unicast route as the RPF route.

  • A multicast static route is identified by three elements: source-address { mask | mask-length }, protocol type, and route-policy-name. Two multicast static routes are considered different as long as one element has different values in the two routes. A maximum of eight multicast static routes can be configured on a network segment.

  • If the next-hop interface of a multicast static route is a P2P interface, you can specify the next-hop interface in the command. If the next-hop interface is a P2MP interface, you must specify the next-hop address.

  • A multicast static route may not take effect after you configure it using the ip rpf-route-static, because the specified interface is Down. After configuring a multicast static route, you are advised to run the display multicast routing-table static command to check whether the route is configured successfully and takes effect.

Example

# Configure a multicast static route.

<HUAWEI> system-view
[HUAWEI] ip rpf-route-static 10.0.0.0 255.0.0.0 rip 1 route-policy map1 10.10.0.1

mtrace

Function

The mtrace command detects the multicast path or RPF path from a multicast source to the querier or to a destination host. The querier indicates the switch on which the mtrace command is executed.

Format

mtrace -gw last-hop-router -r receiver [ -g group ] [ [ -mr | -ur resp-dest ] | -a source-ip-address | -l [ [ stat-times ] [ -st stat-int ] ] | -m max-ttl | -q nqueries | -ts ttl | -tr ttl | -v | -w timeout | -vpn-instance vpn-instance-name ] * source source-address

mtrace -b -r receiver -g group [ [ -mr | -ur resp-dest ] | -a source-ip-address | -l [ [ stat-times ] [ -st stat-int ] ] | -m max-ttl | -q nqueries | -ts ttl | -tr ttl | -v | -w timeout | -vpn-instance vpn-instance-name ] * source source-address

mtrace -d -r receiver [ -g group ] [ [ -mr | -ur resp-dest ] | -a source-ip-address | -l [ [ stat-times ] [ -st stat-int ] ] | -m max-ttl | -q nqueries | -ts ttl | -tr ttl | -v | -w timeout | -vpn-instance vpn-instance-name ] * source source-address

mtrace -r receiver [ -g group ] [ [ -mr | -ur resp-dest ] | -l [ [ stat-times ] [ -st stat-int ] ] | -m max-ttl | -q nqueries | -ts ttl | -tr ttl | -v | -w timeout | -vpn-instance vpn-instance-name ] * source source-address

mtrace [ -g group ] [ [ -mr | -ur resp-dest ] | -l [ [ stat-times ] [ -st stat-int ] ] | -m max-ttl | -q nqueries | -ts ttl | -tr ttl | -v | -w timeout | -vpn-instance vpn-instance-name ] * source source-address

Parameters

Parameter Description Value
-l Performs Mtrace tracking for multiple times, collects traffic statistics and rate, uses detailed display mode, and ignores the configuration of -v. If -l is not specified, Mtrace tracking is performed once.
stat-times Indicates the number of times for Mtrace tracking. The value is an integer that ranges from 2 to 65535. If -l is specified while stat-times is not specified, Mtrace tracking stops after it is performed 65535 times.
-st stat-int Sets the interval at which the rate is calculated during cyclic query. The value is an integer that ranges from 10 to 60, in seconds. The default value is 10. To configure -st, configure -l first. In addition, the cyclic count must be greater than or equal to 2.
-m max-ttl Specifies the maximum number of hops to be traced. The value is an integer that ranges from 1 to 255. The default value is 255.
-mr Indicates that the response address is specified as the traced multicast group address. The -mr is applicable only when the querier resides in a multicast distribution tree.
-q nqueries Sets the number of retry times of mtrace. The value is an integer that ranges from 1 to 65535. The default value is 3.
-tr ttl Specifies the TTL value of the IGMP Tracert Response messages sent in multicast mode. The value is an integer that ranges from 1 to 255. The default value is 30.
-ts ttl Sets the maximum number of hops to be traced in hop-by-hop mode. The value is an integer that ranges from 1 to 255. The default value is 30. When Mtrace in max-hop mode fails, Mtrace automatically enters the hop-by-hop mode. The number of hops increases by one each time a new hop is traced.
-ur resp-dest Specifies the response address as a unicast address. The value of resp-dest must be a local interface address.
NOTE:

If neither -mr nor -ur resp-dest is specified, multicast address 224.0.1.32 is used as the response address.

-
-v Sets the detailed mode and exports time and statistics. -
-vpn-instance vpn-instance-name Specifies the name of a VPN instance. The value must be an existing VPN instance name.
-w timeout Specifies the timeout period to wait for an IGMP Tracert Response message. The value is an integer that ranges from 1 to 60, in seconds. The default value is 3.
-g group Specifies the multicast group address to be traced. The address cannot be a reserved group address.
-gw last-hop-router Specifies the last-hop switch address, which ensures that unicast packets can be transmitted between the querier and the last-hop switch. After this parameter is specified, the initiating mode of Mtrace is specified as last-hop. -
-d Indicates that unicast packets can be transmitted between the querier and the destination host. After this parameter is specified, the initiating mode of Mtrace is specified as destination. -
-r receiver Specifies the destination host address. The value is in dotted decimal notation.
-a source-ip-address Specifies the source address of an IGMP Tracert Query message. The value of source-ip-address must be a local interface address.
NOTE:

When you need to detect the multicast path or the RPF path from the multicast source to the querier, -a is not supported.

The value is in dotted decimal notation.
-b Indicates that the querier is directly connected to the destination host, but whether the querier is the last-hop switch is unknown. After this parameter is specified, the initiating mode of Mtrace is specified as all-router.
NOTE:
After a VPN or RPF is specified, the initiating mode of Mtrace cannot be specified as all-router.
-
source source-address Specifies the multicast source address. The value is in dotted decimal notation.

Views

All views

Default Level

0: Visit level

Usage Guidelines

Usage Scenario

During multicast troubleshooting and routine maintenance, you can run the mtrace command to collect traffic information for locating faulty nodes, which helps reduce configuration errors, perform cyclic tracert, and collect statistics on multicast flow rates.

The mtrace command format varies according to the types of paths.

  • mtrace source source-address: detects the RPF path from the multicast source to the querier.

  • mtrace -g group source source-address: detects the multicast path from the multicast source to the querier.

    The corresponding (S, G) entry must exist on the querier.

  • mtrace [ -gw last-hop-router | -d ] -r receiver source source-address: detects the RPF path from the multicast source to the destination host.

    • The querier is directly connected to the destination host, or the querier can ping the last-hop switch or detonation host in unicast mode.

    • When multiple switches are connected to the specified host, RPF paths from different switches can be different. You can specify the last-hop switch using -gw last-hop-router to uniquely define an RPF path.

  • mtrace [ -b | -gw last-hop-router | -d ] -r receiver -g group source source-address: detects the multicast path from the multicast source to the destination host.

    The corresponding (S, G) entry must exist on the querier. In addition, one of the following conditions must be met:

    • The querier is directly connected to the destination host.

    • The querier can ping the last-hop switch or the destination host in unicast mode.

    • The querier resides in the multicast path from the multicast source to the destination host. For example, the querier is the first hop switch.

When running the mtrace [ -b | -gw last-hop-router | -d ] -r receiver -g group source source-address command to detect the multicast path from a multicast source to a destination host, specify -gw last-hop-router, -b or -d, which helps implement tracking quickly and accurately.

  • -b: indicates that the querier is directly connected to the destination host.

  • -gw last-hop-router: specifies the last-hop switch address. Unicast packets can be transmitted between the querier and the last-hop switch.

  • -d: indicates that unicast packets can be transmitted between the querier and the destination host.

  • If none of the preceding three parameters are specified, Mtrace fails unless the querier resides in the multicast path from the multicast source to the destination host.

Precautions

According to draft-fenner-traceroute-ipm-01, the Router Alert option needs to be carried in the IGMP Tracert Query messages that are sent to the destination address in unicast mode and in the IGMP Tracert Response messages that sent in response in multicast mode. However, manufacturers have not reached an agreement on this issue. Packets sent from a Huawei switch carry the Router Alert option. If Huawei switches need to communicate with devices that do not support the Router Alert option, use -gw to specify the last-hop address and -ur to specify the unicast response address.

The parameter vpn-instance is used on the PE to initiate a multicast VPN probe.

Example

  • Detect the RPF path from a multicast source to the querier.

# Detect the RPF path from the multicast source 10.1.0.1 to the querier 10.1.5.1.

<HUAWEI> mtrace source 10.1.0.1
 Press Ctrl+C to break multicast traceroute facility
 From the receiver(10.1.5.1), trace reverse path to source (10.1.0.1) according to RPF rules

 Num  Reverse-Path    FwdTTL Protocol
  0   10.1.5.1
 -1   10.1.5.1        1      PIM
 -2   10.1.2.1        1      PIM
  In maximum-hop mode, received the response message, and multicast traceroute finished.
  • Detect the multicast path from a multicast source to the querier.

# Detect the multicast path from the multicast source 10.1.0.1 to the querier 10.1.5.1. The group address is 225.0.0.1, the cyclic count is 2, and the interval at which the rate is calculated is 10s.

<HUAWEI> mtrace -g 225.0.0.1 -l 2 -st 10 source 10.1.0.1
 Press Ctrl+C to break multicast traceroute facility
 From the receiver(10.1.5.1), trace (10.1.0.1, 225.0.0.1)'s reverse path according to multicast routing-table
 In calculating-rate mode, current statistic times is: 1

 -1 10.1.5.1
   Incoming Interface Address: 10.1.5.1 Input packets rate: 0
   Outgoing Interface Address: 0.0.0.0 Output packets rate: 0xffffffff
   Forwarding Cache (10.1.0.1, 225.0.0.1) Forwarding packets rate: 0

 -2 10.1.2.1
   Incoming Interface Address: 10.1.2.1 Input packets rate: 0
   Outgoing Interface Address: 10.1.5.2 Output packets rate: 0
   Forwarding Cache (10.1.0.1, 225.0.0.1) Forwarding packets rate: 0

 -3 10.1.0.1
   Incoming Interface Address: 10.1.0.1 Input packets rate: 0
   Outgoing Interface Address: 10.1.2.2 Output packets rate: 0
   Forwarding Cache (10.1.0.1, 225.0.0.1) Forwarding packets rate: 0
 ********************************************************
  In calculating-rate mode, reach the demanded number of statistic,and multicast 
  traceroute finished.
  • Detect the RPF path from the multicast source to the destination host.

# Detect the RPF path from the multicast source 10.1.0.1 to the destination host 10.1.6.4. The last hop address is 10.1.6.3, unicast packets can be transmitted, and the time and statistics are displayed in detail.

<HUAWEI> mtrace -gw 10.1.6.3 -r 10.1.6.4 -v source 10.1.0.1
 Press Ctrl+C to break multicast traceroute facility
 From the receiver(10.1.6.4), trace reverse path to source (10.1.0.1) according to RPF rules

 Num  Reverse-Path    FwdTTL Protocol
  0   10.1.6.4
 -1   10.1.5.1        1      PIM
   Incoming Interface Address: 10.1.5.1
   Outgoing Interface Address: 10.1.6.3
   Previous-Hop Router Address: 10.1.5.2
   Input packet count on incoming interface: 0
   Output packet count on outgoing interface: 0
   Total number of packets for this source-group pair: 0xffffffff
   Forwarding TTL: 1
   Forwarding Code: NO_ERROR
 -2   10.1.2.1        1      PIM
   Incoming Interface Address: 10.1.2.1
   Outgoing Interface Address: 10.1.5.2
   Previous-Hop Router Address: 10.1.2.2
   Input packet count on incoming interface: 0
   Output packet count on outgoing interface: 0
   Total number of packets for this source-group pair: 0xffffffff
   Forwarding TTL: 1
   Forwarding Code: NO_ERROR
 -3   10.1.0.1        1      PIM
   Incoming Interface Address: 10.1.0.1
   Outgoing Interface Address: 10.1.2.2
   Previous-Hop Router Address: 0.0.0.0
   Input packet count on incoming interface: 0
   Output packet count on outgoing interface: 0
   Total number of packets for this source-group pair: 0xffffffff
   Forwarding TTL: 1
   Forwarding Code: NO_ERROR
  In maximum-hop mode, received the response message, and multicast traceroute finished.
  • Detect the multicast path from the multicast source to the destination host.

# Detect the multicast path from the multicast source 10.1.0.1 to the destination 225.0.0.1. The destination host address is 10.1.6.4, the querier is directly connected to the destination host, the response address is the default value 224.0.1.32, and the TTL value of a Response packet is 5.

<HUAWEI> mtrace -b -r 10.1.6.4 -g 225.0.0.1 -tr 5 source 10.1.0.1
 Press Ctrl+C to break multicast traceroute facility
 From the receiver(10.1.6.4), trace (10.1.0.1, 225.0.0.1)'s reverse path according to multicast routing-table

 Num  Reverse-Path    FwdTTL Protocol
  0   10.1.6.4
 -1   10.1.5.1        1      PIM
 -2   10.1.2.1        1      PIM
 -3   10.1.0.1        1      PIM
  In maximum-hop mode, received the response message, and multicast traceroute finished.

# Detect the multicast path from the multicast source 10.1.0.1 to the destination 225.0.0.1. The destination host address is 10.1.6.4, the last hop address is 10.1.6.3, unicast packets are reachable, the number of cyclic times is 2, and the interval at which the rate is calculated is 12s.

<HUAWEI> mtrace -gw 10.1.6.3 -r 10.1.6.4 -g 225.0.0.1 -l 2 -st 12 source 10.1.0.1
 Press Ctrl+C to break multicast traceroute facility
 From the receiver(10.1.6.4), trace (10.1.0.1, 225.0.0.1)'s reverse path according to multicast routing-table
 In calculating-rate mode, current statistic times is: 1

 -1 10.1.5.1
   Incoming Interface Address: 10.1.5.1 Input packets rate: 0
   Outgoing Interface Address: 10.1.6.3 Output packets rate: 0
   Forwarding Cache (10.1.0.1, 225.0.0.1) Forwarding packets rate: 0

 -2 10.1.2.1
   Incoming Interface Address: 10.1.2.1 Input packets rate: 0
   Outgoing Interface Address: 10.1.5.2 Output packets rate: 0
   Forwarding Cache (10.1.0.1, 225.0.0.1) Forwarding packets rate: 0

 -3 10.1.0.1
   Incoming Interface Address: 10.1.0.1 Input packets rate: 0
   Outgoing Interface Address: 10.1.2.2 Output packets rate: 0
   Forwarding Cache (10.1.0.1, 225.0.0.1) Forwarding packets rate: 0
 ********************************************************
  In calculating-rate mode, reach the demanded number of statistic, and multicast
 traceroute finished.
Table 8-104  Description of the mtrace command output

Item

Description

Press Ctrl+C to break multicast traceroute facility

The ongoing Mtrace test is terminated after you press Ctrl+C.

From the receiver (10.1.6.4), trace reverse path to source (10.1.0.1) according to RPF rules

The RPF path from destination host 10.1.6.4 to multicast source 10.1.0.1 is detected.

From the receiver (10.1.6.4), trace (10.1.0.1, 225.0.0.1)'s reverse path according to multicast routing-table

The transmission path of multicast data (10.1.0.1, 225.0.0.1) from the destination host 10.1.6.4 to the source is tested.

Num

Number of traced hops.

Reverse-Path

Reverse path of multicast traffic.

FwdTTL

Minimum TTL value for multicast packet forwarding.

Protocol

Multicast routing protocol used on the switch.

-1 10.1.5.1 1 PIM

The address of the last hop is 10.1.5.1, the minimum TTL value for multicast forwarding is 1, and the multicast routing protocol used on the switch is PIM.

In calculating-rate mode, current statistic times is: 1

The rate is calculated for the first time in the calculating rate mode.

-1 10.1.5.1

Last hop with the address as 10.1.5.1 in calculating rate mode.

Incoming Interface Address: 10.1.5.1 Input packets rate: 0

Multicast inbound interface address and the inbound packet rate on the inbound interface in calculating rate mode.

Outgoing Interface Address: 0.0.0.0 Output packets rate: 0xffffffff

Multicast outbound interface address and the outbound packet rate on the outbound interface in calculating rate mode.

Forwarding Cache (10.1.0.1, 225.0.0.1) Forwarding packets rate: 0

Rate for a switch to forward multicast packets of the (S, G) entry in calculating rate mode.

In maximum-hop mode, received the response message, and multicast traceroute finished.

IGMP Tracert Response messages are received in maximum hop tracking mode.

In calculating-rate mode, reach the demanded number of statistic, and multicast traceroute finished.

Mtrace is complete in calculating rate mode when the required number of calculating times is reached.

mtrace query-policy

Function

The mtrace query-policy command enables a device to filter IGMP-Tracert-Query packets in unicast mode based on the source address of these packets.

The undo mtrace query-policy command cancels the filtering of IGMP-Tracert-Query packets.

By default, the switch does not filter IGMP-Tracert-Query packets.

Format

mtrace query-policy [ basic-acl-number ]

undo mtrace query-policy

Parameters

Parameter Description Value
basic-acl-number Specifies the number of the basic ACL. This ACL defines the address range of a trusted querier. According to this ACL, the last hop switch rejects the IGMP-Tracert-Query packets sent by an invalid querier. The value is an integer ranging from 2000 to 2999.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

The source address of IGMP-Tracert-Query packets in unicast mode is the local interface address. Before you create an ACL rule, create an ACL.

Run this command on the switch that is connected to the host.

  • This command takes effect only on the last hop switch, which is not the querier.

  • This command filters only the IGMP-Tracert-Query packets encapsulated in unicast IP packets.

  • This command is not applicable to the tracking initiated from the querier.

When you run the mtrace query-policy command on the last hop switch, note the following points:

  • If basic-acl-number is not specified, the last hop switch does not reject IGMP-Tracert-Query packets in unicast mode.

  • If basic-acl-number is specified but the ACL is not defined on the switch, the last hop switch rejects any IGMP-Tracert-Query packet in unicast mode.

  • If basic-acl-number is specified and this ACL is defined on the switch, only the IGMP-Tracert-Query packets allowed by the ACL can be received.

Example

# Apply the querier filtering rules to the last hop switch.

<HUAWEI> system-view
[HUAWEI] mtrace query-policy 2000

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

GE interface view, XGE interface view, 40GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view, tunnel 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.

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 GE0/0/1 as the boundary of group 239.2.0.0/16.
<HUAWEI> system-view
[HUAWEI] multicast routing-enable
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo portswitch
[HUAWEI-GigabitEthernet0/0/1] multicast boundary 239.2.0.0 16

multicast cpu-forward disable

Function

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

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

By default, software forwarding for multicast packets is enabled.

Format

multicast cpu-forward disable

undo multicast cpu-forward disable

Parameters

None.

Views

System 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 forwards packets based on hardware. Soft forwarding for multicast packets must be disabled on the switch to prevent packet loss and disorder caused by the low forwarding speed and first packet cache mechanism of soft forwarding.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command.

Example

# Disable software forwarding for multicast packets.

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

multicast forwarding-table downstream-limit

Function

The multicast forwarding-table downstream-limit command sets the maximum number of downstream nodes of an entry in the multicast forwarding table.

The undo multicast forwarding-table downstream-limit command restores the default setting.

By default, the maximum number of downstream nodes of an entry is 128.

Format

multicast forwarding-table downstream-limit limit

undo multicast forwarding-table downstream-limit

Parameters

Parameter Description Value
limit Indicates the maximum number of downstream nodes of an entry in the forwarding table. The value of ranges from 0 to 128.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the switch receives a multicast packet, it copies the packet for each downstream node in the matching multicast forwarding entry. If the switch has a large number of multicast forwarding entries or each entry has many downstream nodes, many system resources are consumed. To reduce the load on the switch, limit the maximum number of downstream nodes in each multicast forwarding entry.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command.

Precautions

If the configured number is smaller than the current number, the excessive downstream nodes are not deleted immediately, and must be deleted by the multicast routing protocol. In addition, no new downstream node can be added to the entry in the forwarding table.

Example

# Set the maximum number of downstream nodes of an entry in the forwarding table to 32.

<HUAWEI> system-view
[HUAWEI] multicast routing-enable
[HUAWEI] multicast forwarding-table downstream-limit 32

multicast forwarding-table route-limit

Function

The multicast forwarding-table route-limit command sets the limit on the number of entries in the multicast forwarding table.

The undo multicast forwarding-table route-limit command restores the default value of the limit.

By default, the limit on the number of entries in the multicast forwarding table is 1022 on S5720LI and S5720S-LI, 1024 on S5720SI and S5720S-SI, 1536 on S5730SI, S5730S-EI, S6720LI, S6720S-LI, S6720SI and S6720S-SI, and 4096 on S5720EI, S5720HI, S6720EI, and S6720S-EI.

Format

multicast forwarding-table route-limit limit

undo multicast forwarding-table route-limit

Parameters

Parameter Description Value
limit Specifies the limit on the number of entries in the multicast forwarding table.

The value is an integer that ranges from 0 to 1022 on S5720LI and S5720S-LI, from 0 to 1024 on S5720SI and S5720S-SI, from 0 to 1536 on S5730SI, S5730S-EI, S6720LI, S6720S-LI, S6720SI and S6720S-SI, and from 0 to 4096 on S5720EI, S5720HI, S6720EI, and S6720S-EI.

NOTE:

The value range of S5720HI is expanded after the high specification mode is configured for multicast forwarding using the set multicast forwarding-table super-mode command. The actual value range depends on the specification of the device.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Excessive multicast forwarding entries will exhaust the memory of the switch. To prevent this problem, use the multicast forwarding-table route-limit command to limit the number of entries in the multicast forwarding table.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command.

Precautions

If you set the limit on the number of entries in the multicast forwarding table after multicast services are deployed on a switch, ensure that the limit is greater than or equal to the number of current forwarding entries. Otherwise, faults may occur.

It is recommended that you set this limit based on the actual network environment before deploying multicast services on the switch.

If the configured limit is smaller than the number of existing entries, the excessive entries are not deleted immediately. The configured limit takes effect in the following cases:

Example

# Set the limit on the number of the entries in the forwarding table to 60.

<HUAWEI> system-view
[HUAWEI] multicast routing-enable
[HUAWEI] multicast forwarding-table route-limit 60

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-preferred | stable-preferred | group | source | source-group }

undo multicast load-splitting

Parameters

Parameter Description Value
balance-preferred Indicates balance-preferred load splitting. This policy is applicable to the scenario where hosts frequently join or leave groups, which requires automatic load adjustment. -
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, a 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.

Follow-up Procedure

Because the forwarding capabilities of equal-cost routes are different from the actual load distribution situation on the equal-cost routes, even load splitting cannot meet network requirements in some scenarios. Then, you can run the multicast load-splitting weight command to configure the multicast load splitting weight on the interface to realize unbalanced load splitting.

Precautions

The five load splitting policies are mutually exclusive. It is recommended that you use a fixed load splitting policy based on the actual situation on your network. The balance-preferred or stable-preferred policy is preferred.

If PIM-DM is enabled in the current public network instance, the balance-preferred or stable-preferred policy cannot be used.

Example

# Configure group address-based load splitting.
<HUAWEI> system-view
[HUAWEI] multicast routing-enable
[HUAWEI] multicast load-splitting group

multicast load-splitting weight

Function

The multicast load-splitting weight command sets the multicast load splitting weight for an interface.

The undo multicast load-splitting weight command restores the default setting.

By default, the multicast load splitting weight of an interface is 1.

Format

multicast load-splitting weight weight-value

undo multicast load-splitting weight

Parameters

Parameter Description Value
weight-value Specifies the multicast load splitting weight of an interface. The value is an integer that ranges from 0 to 32.

Views

GE interface view, XGE interface view, 40GE interface view, Eth-Trunk interface view, GE sub-interface view, XGE sub-interface view, 40GE sub-interface view, Eth-Trunk sub-interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When a stable-preferred or balance-preferred multicast splitting policy is configured, you can run this command to set load splitting weights for interfaces to realize unbalanced load splitting. The larger weight value an interface has, the more multicast routing entries have it as the upstream interface.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command.

Precautions

This command is applicable only when the multicast load splitting policy is set to stable-preferred or balance-preferred.

When the multicast load splitting weight on an interface is 0, the routes that have this interface as the upstream interface do not take part in load splitting.

Example

# Set the multicast load splitting weight on VLANIF100 to 10.
<HUAWEI> system-view
[HUAWEI] multicast routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] multicast load-splitting weight 10
# Set the multicast load splitting weight on GE0/0/1 to 10.
<HUAWEI> system-view
[HUAWEI] multicast routing-enable
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo portswitch
[HUAWEI-GigabitEthernet0/0/1] multicast load-splitting weight 10

multicast load-splitting-timer

Function

The multicast load-splitting-timer command sets a load splitting timer.

The undo multicast load-splitting-timer command restores the default setting.

By default, the value of a load splitting timer is 1800 seconds.

Format

multicast load-splitting-timer interval

undo multicast load-splitting-timer

Parameters

Parameter Description Value
interval Specifies the value of the load splitting timer. The value is an integer ranging from 10 to 1800, in seconds.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In stable-preferred load splitting or balance-preferred load splitting mode, entries may not be well-balanced among paths because of the addition or deletion of entries, change of load splitting weights of the paths, or change of equal-cost routes. In such a case, the device will balance entries after a certain waiting time to reduce the impact of frequent changes on the system.

Currently, setting a load splitting timer to change the waiting time before balancing entries is supported.
  • If the network is stable, for example, when entries are not deleted or added frequently or equal-cost routes are not changed frequently, set the load splitting timer value to a smaller value so that entries can be balanced rapidly. The recommended value is 300 to 600 seconds.

  • If the network is not stable, for example, when entries are deleted or added frequently or equal-cost routes are changed frequently, set the load splitting timer value to a greater value to reduce the impact of frequent entry changes on the system and network stability. The recommended value is 1200 to 1800 seconds.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command.

Example

# Set a load splitting timer to 100 seconds.

<HUAWEI> system-view
[HUAWEI] multicast routing-enable
[HUAWEI] multicast load-splitting-timer 100

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.

Example

# Select routes according to the longest match on the switch.

<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 public network instance or a VPN instance. If multicast services are running in the instance, 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.

<HUAWEI> system-view
[HUAWEI] multicast routing-enable

ping multicast

Function

The ping multicast command enables a device to detect the reserved members in the network segment, simulates the common group traffic, triggers the establishment of a distribution tree, and checks whether the network can normally bear multicast services.

Format

ping multicast [ -c count | -h ttl-value | -i interface-type interface-number | -m time | -p pattern | -q | -s packetsize | -t timeout | -tos tos-value | -v ] * host

Parameters

Parameter Description Value
-c count Specifies the number of times for sending ICMP Echo Request messages. The value is an integer that ranges from 1 to 65535. The default value is 5.
-h ttl-value Sets the TTL value of an ICMP Echo Request message. The value is an integer that ranges from 1 to 255. The default value is 255.
-i interface-type interface-number Sets the outgoing interface that sends ICMP Echo Request messages.
  • When the Mping destination group address is a reserved multicast group address, -i must be specified.
  • When the Mping destination group address is a common multicast group address, -i cannot be specified.
-
-m time Specifies the time to wait before sending the next ICMP Echo Request message.

Each time the source sends an ICMP Echo Request message using the ping multicast command, the source waits a period of time (2000 ms by default) before sending the next ICMP Echo Request message. You can set the time to wait before sending the next ICMP Echo Request message using the parameter time. In the case of poor network condition, the value should be equal to or larger than 2000, in milliseconds.

The value is an integer that ranges from 1 to 10000, in milliseconds. The default value is 2000.
-p pattern Specifies the padding byte of ICMP Echo Request messages.

After the padding byte of the ICMP Echo Request message is set, the destination host can identify a certain ICMP Echo Reply message.

The value ranges from 0 to FFFFFFFF, in the hexadecimal format. By default, the padding starts from 0x01, and continues in ascending order.
-q Indicates that only statistics are displayed.

When -q is specified in the ping multicast command, only the number of sent and received packets, packet loss rate, and the minimum, average, and maximum RTTs are displayed.

By default, all information is displayed.
-s packetsize Sets the length of an ICMP Echo Request message, excluding the IP or ICMP header. The value is an integer that ranges from 20 to 8100, in bytes. The default value is 56.
-t timeout Specifies the timeout period to wait for an ICMP Echo Reply message after an ICMP Echo Request message is sent.

After the ping multicast command is run, the source sends an ICMP Echo Request message to a destination and waits for an ICMP Echo Reply message. If the destination, after receiving the ICMP Echo Request message, returns an ICMP Echo Reply message to the source within the period specified by the parameter timeout, the destination is reachable. If the destination does not return an ICMP Echo Reply message within the specified period, the source displays a message indicating that the message times out.

Normally, the source receives an ICMP Echo Reply message within 1 to 10 seconds after sending an ICMP Echo Request message. If the transmission speed is low, properly prolong the timeout period.

The value is an integer that ranges from 0 to 65535, in milliseconds. The default value is 2000.
-tos tos-value Specifies the ToS value of the sent ICMP Echo Request messages. The value is an integer that ranges from 0 to 255. The default value is 196.
-v Displays all received ICMP Echo Reply messages.
  • If -v is not specified, the system displays the received ICMP Echo Reply messages of the user.
  • If -v is specified, the system displays all received ICMP Echo Reply messages.
By default, only ICMP Echo Reply messages of the user are displayed.
host Specifies the destination address of an ICMP Echo Request message, also called the Mping destination group address. It includes reserved group addresses and common group addresses.

Views

All views

Default Level

0: Visit level

Usage Guidelines

Usage Scenario

The ping multicast command is used to check a multicast network in the following scenarios:

Scenario 1: When configuring the destination group address host as a reserved group address, you can run the ping multicast command to check which reserved multicast members reside on the network segment of the outbound interface. In this scenario, the TTL of an ICMP Echo Request message cannot be set.

The reserved multicast group identifies a group of network devices (reserved multicast members) that match certain conditions. When the reserved multicast members receive ICMP Echo Request messages with the destination addresses as the reserved group addresses, they return ICMP Echo Reply messages. Common reserved group addresses are as follows:
  • 224.0.0.1: indicates all systems in the subnet.
  • 224.0.0.2: indicates all routers in the subnet.
  • 224.0.0.5: indicates OSPF IGP routers.
  • 224.0.0.13: indicates PIM routers.
NOTE:
In this scenario, -i must be specified in the ping multicast command.
Scenario 2: When setting the destination group address host as a common group address, you can run the ping multicast command to implement the following functions:
  • Simulates the multicast traffic and triggers a series of protocol processes. By viewing the multicast routing information on the switch, check whether the protocol running status is normal and whether the multicast distribution tree is correctly established.
  • Check multicast members in the network and calculate the TTL value and the RTT from the Mping initiator to multicast members. This function requires that the host support Mping and is implemented by calculating the number of ICMP Echo Reply messages sent by the destination host. Mping is performed continuously at a certain interval to calculate the network delay and route jitter.
NOTE:
In this scenario, -i cannot be specified in the ping multicast command.
You can specify different parameters in ping multicast command for different scenarios:
  • On an unstable network, you can run the ping multicast -c count -t timeout host command to check the quality of the multicast network. By analyzing the packet loss rate and average delay in the command output, you can evaluate the network quality. If the network is unreliable, set the packet transmission count (-c) and timeout (-t) to the upper limits. This makes the test result accurate.
  • You can run the ping multicast -s packetsize host to set the size of a multicast probe packet. In this way, you can check the quality of the multicast network by simulating real service datagrams. The path MTU is then obtained through multiple probes.

Prerequisites

Before running the ping multicast command, ensure that the ICMP module is working properly.

Configuration Impact

If an intermediate device is disabled from responding to ICMP messages, detection on this node fails.

Precautions

If a fault occurs in the Mping process, you can press Ctrl+C to terminate the Mping operation.

Example

# Perform Mping, specify the reserved multicast group address as 224.0.0.5 and the outbound interface as VLANIF 100, and detect the OSPF IGP router in the network segment.
<HUAWEI> ping multicast -i vlanif 100 224.0.0.5
MULTICAST PING 224.0.0.5 : 56 data bytes, press Ctrl+C to break
Reply from 10.1.1.5 : bytes=56 Sequence=1 TTL =255 time=30ms
Reply from 10.1.1.5 : bytes=56 Sequence=2 TTL =255 time=10ms
Reply from 10.1.1.5 : bytes=56 Sequence=3 TTL =255 time=10ms
Reply from 10.1.1.5 : bytes=56 Sequence=4 TTL =255 time=20ms
Reply from 10.1.1.5 : bytes=56 Sequence=5 TTL =255 time=10ms
Destination multicast address 224.0.0.5
--- Multicast ping statistics ---
5 Request packet(s) transmitted
5 Reply packet(s) received
0.00% packet loss
Round-trip min/avg/max = 10/16/40 ms

# Specify the padding field of -p.

<HUAWEI> ping multicast -i vlanif 100 -p 12345678 224.0.0.5
MULTICAST PING 224.0.0.5 : 56 data bytes, press Ctrl+C to break
The padding string: 12345678
Reply from 10.1.1.5 : bytes=56 Sequence=1 TTL =255 time=30ms
Reply from 10.1.1.5 : bytes=56 Sequence=2 TTL =255 time=10ms
Reply from 10.1.1.5 : bytes=56 Sequence=3 TTL =255 time=10ms
Reply from 10.1.1.5 : bytes=56 Sequence=4 TTL =255 time=20ms
Reply from 10.1.1.5 : bytes=56 Sequence=5 TTL =255 time=10ms
Destination multicast address 224.0.0.5
--- Multicast ping statistics ---
5 Request packet(s) transmitted
5 Reply packet(s) received
0.00% packet loss
Round-trip min/avg/max = 10/16/40 ms
Table 8-105  Description of the ping multicast command output

Item

Description

MULTICAST PING 224.0.0.5

The destination group address of Mping is 224.0.0.5.

56 data bytes

The length of the sent ICMP Echo Request message is 56 bytes.

press Ctrl+C to break

The ongoing Mping test can be terminated by pressing Ctrl+C.

The padding string: 12345678

The padding string is 12345678. If -p is not specified, the padding character string is not displayed.

Reply from 10.1.1.5: bytes=56 Sequence=1 TTL=255 time=30ms

The ICMP Echo Reply message sent from 10.1.1.5 is received. The message carries the following information:
  • bytes=56: indicates the length of the ICMP Echo Reply message.

  • Sequence=1: indicates the sequence number of the ICMP Echo Reply message.

  • TTL=255: indicates the TTL value of the ICMP Echo Reply message.

  • time=30ms: indicates the RTT, in milliseconds. If no ICMP Echo Reply message is received after the timeout period, "Request time out" is displayed.

Destination multicast address 224.0.0.5

The destination group address is 224.0.0.5.

--- Multicast ping statistics ---

5 Request packet(s) transmitted

5 Reply packet(s) received

0.00% packet loss

Round-trip min/avg/max = 10/16/40 ms

Statistics collected after the Ping test on the destination host. The statistics are as follows:
  • Number of sent ICMP Echo Request messages: 5

  • Number of received ICMP Echo Reply messages: 5

  • Percentage of non-Reply messages against total sent messages: 0.00%

  • The minimum RTT is 10 ms, the average RTT is 16 ms, and the maximum RTT is 40 ms.

reset mtrace statistics

Function

The reset mtrace statistics command clears statistics about Mtrace packets.

Format

reset mtrace statistics

Parameters

None

Views

User view

Default Level

3: Management level

Usage Guidelines

To collect statistics about Mtrace traffic generated in a certain period, reset the original statistics.

Example

# Clear statistics about the current Mtrace traffic.

<HUAWEI> reset mtrace statistics

reset multicast forwarding-table

Function

The reset multicast forwarding-table command clears the entries of the multicast forwarding table.

Format

reset multicast [ vpn-instance vpn-instance-name | all-instance ] forwarding-table all

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

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies a VPN instance. vpn-instance-name indicates the name of the VPN instance. The value must be an existing VPN instance name.
all-instance Indicates all the instances. -
all Indicates all forwarding entries of multicast forwarding tables. -
group-address Specifies the address of a multicast group. The address is in dotted decimal notation and ranges from 224.0.1.0 to 239.255.255.255.
mask Specifies the mask of a multicast group address or source address. -
group-mask Specifies the address mask of a multicast group. The address mask is in dotted decimal notation.
group-mask-length Specifies the mask length of a multicast group address. The value is an integer that ranges from 4 to 32.
source-address Specifies the address of a multicast source. The address is in dotted decimal notation.
source-mask Specifies the address mask of a multicast source. The address mask is in dotted decimal notation.
source-mask-length Specifies the mask length of the multicast source address. The value is an integer that ranges from 0 to 32.
incoming-interface Indicates the upstream interface of the forwarding entry. -
interface-type interface-number Specifies the type and the number of an interface, used to specify an interface. -
register Indicates the register interface in PIM-SM. -

Views

User view

Default Level

3: Management level

Usage Guidelines

After you run this command to delete information from the multicast forwarding table, multicast data will be interrupted for a period. Confirm the action before you use the command.

The time interval before you run the reset multicast forwarding-table command again must be longer than 30 seconds.

Example

# Delete the multicast forwarding entries of the group 225.5.4.3 from the forwarding table.

<HUAWEI> reset multicast forwarding-table 225.5.4.3

reset multicast routing-table

Function

The reset multicast routing-table command clears the entries in the multicast routing table. The corresponding forwarding entries in the forwarding table are deleted at the same time.

Format

reset multicast [ vpn-instance vpn-instance-name | all-instance ] routing-table all

reset multicast [ vpn-instance vpn-instance-name | all-instance ] 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 } } *

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies a VPN instance. vpn-instance-name indicates the name of the VPN instance. The value must be an existing VPN instance name.
all-instance Indicates all the instances. -
all Indicates all entries in the multicast routing table. -
group-address Specifies the address of the specified group. The address is in dotted decimal notation and ranges from 224.0.1.0 to 239.255.255.255.
mask Indicates the address mask of a multicast group or source. -
group-mask Specifies the address mask of a multicast group. The address mask is in dotted decimal notation.
group-mask-length Specifies the mask length of a multicast group address. The value is an integer that ranges from 4 to 32.
source-address Specifies the address of a specified source. The address is in dotted decimal notation.
source-mask Specifies the address mask of a multicast source, in dotted decimal notation. The address mask is in dotted decimal notation.
source-mask-length Specifies the mask length of the multicast source address. The value is an integer that ranges from 0 to 32.
incoming-interface Specifies the incoming interface of a multicast entry. -
interface-type interface-number Specifies the type and the number of an interface, used to specify an interface. -
register Indicates the register interface of PIM-SM. -

Views

User view

Default Level

3: Management level

Usage Guidelines

After you run this command to delete information from the multicast routing table, the matching entries in the multicast forwarding table are also deleted. As a result, multicast forwarding will be interrupted for a period. Confirm the action before you use the command.

Example

# Delete the entries of the group 225.5.4.3 from the multicast routing table.

<HUAWEI> reset multicast routing-table 225.5.4.3

set multicast forwarding-table super-mode

Function

The set multicast forwarding-table super-mode command configures the high specification mode for multicast forwarding. In the high specification mode, the number of multicast entries can reach the maximum value supported by the switch, which is much more than the default limit.

The undo set multicast forwarding-table super-mode command restores the default configuration.

By default, the common specification mode is used for multicast forwarding after Layer 3 multicast is configured. In this mode, the number of multicast entries cannot exceed the default limit defined on the switch.

NOTE:

Only the S5720HI supports this command.

Format

set multicast forwarding-table super-mode

undo set multicast forwarding-table super-mode

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After Layer 3 multicast is enabled, the common specification mode is used for multicast forwarding by default. This mode can meet requirements of most multicast service scenarios. In some large-scale multicast applications, a network has a large number of multicast sources to provide many channels for multicast users. In these applications, the number of multicast entries may exceed the default limit defined on a multicast device. When this occurs, some multicast entries cannot be generated. As a result, some users cannot receive the multicast data they request.

The set multicast forwarding-table super-mode command configures the high specification mode to increase the number of entries used for multicast forwarding. In high specification mode, the number of multicast entries supported by the switch is much larger than the default limit on the number of multicast entries. This mode maximizes a device's capability to support large-scale multicast applications.

Precautions

After you run this command:

  • Restart the switch for the configuration to take effect.
  • The default value of the IGMP general query interval changes from 60s to 120s. You can set the IGMP general query interval using the igmp timer query or timer query (IGMP view) command.
  • The default value of the IGMP robustness variable changes from 2 to 3. You can set the robustness variable using the igmp robust-count or robust-count (IGMP view) command.
  • The default value of the other querier present interval changes from 125s to 245s. You can set the other querier present interval using the igmp timer other-querier-present or timer other-querier-present (IGMP view) command.
  • The default value of the MLD robustness variable changes from 2 to 3. You can set the robustness variable using the mld robust-count or robust-count (MLD view) command.
  • The default interval for sending PIM-DM State-Refresh messages changes from 60s to 255s. On an IPv4 multicast network, run the state-refresh-interval (IPv4) command to set the interval for sending PIM-DM State-Refresh messages. On an IPv6 network, run the state-refresh-interval (IPv6) command to set the interval for sending PIM-DM State-Refresh messages.
  • The default interval for sending PIM Join-Prune messages changes from 210s to 300s. On an IPv4 multicast network, run the holdtime join-prune (IPv4) or pim holdtime join-prune command to set the interval for sending PIM Join-Prune messages. On an IPv6 network, run the holdtime join-prune (IPv6) or pim ipv6 holdtime join-prune command to set the interval for sending PIM Join-Prune messages.
  • Run the car command to change the rate limit for IGMP/MLD messages sent to the CPU according to the actual situations of multicast services.
  • More system resources are consumed in the high specification mode. If the number of multicast protocol packets sent to the switch increases sharply in a short time, the CPU usage of the switch becomes high.
  • It is recommended that you set the same general query interval on all the IGMP/MLD-enabled interfaces of a switch. For an IGMP-enabled interface, run the igmp timer query command in the interface view to set the general query interval. For an MLD-enabled interface, run the mld timer query command in the interface view to set the general query interval. This configuration prevents IGMP/MLD-enabled interfaces from sending Query messages at the same time, so that the switch does not have to process a large number of Report messages in a short time, which could cause a high CPU usage.
  • In a stack, if member interfaces of an Eth-trunk interface are located on member switches that support different numbers of multicast forwarding entries, the maximum number of multicast forwarding entries supported by the Eth-Trunk interface depends on the member switch that supports the least number of multicast forwarding entries. Multicast forwarding entries supported by an Eth-Trunk interface meet either of the following conditions:
    • The outbound interface of the multicast forwarding entries is the Eth-Trunk interface that has been switched to the Layer 3 mode using the undo portswitch command.
    • The Eth-Trunk interface belongs to the VLANs corresponding to the VLANIF interfaces of the multicast forwarding entries.

Example

# Configure the high specification mode for multicast forwarding.

<HUAWEI> system-view
[HUAWEI] set multicast forwarding-table super-mode
Warning: This command will modify some default multicast settings and has limitations 
in a few special scenarios. Use the command according to product manual.Continue? [Y/N]:y

set multicast-hash-mode

Function

The set multicast-hash-mode command specifies a hash algorithm for multicast forwarding.

The undo multicast-hash-mode command restores the default hash algorithm for multicast forwarding.

By default, the crc-32-lower algorithm is used.

NOTE:

Only the S5720EI, S6720EI, and S6720S-EI support this command.

Format

set multicast-hash-mode { crc-32-upper | crc-32-lower | lsb | crc-16-upper | crc-16-lower }

undo set multicast-hash-mode { crc-32-upper | crc-32-lower | lsb | crc-16-upper | crc-16-lower }

Parameters

Parameter Description
crc-32-upper

Indicates the hash algorithm based on high-order bits of CRC32.

crc-32-lower

Indicates the hash algorithm based on low-order bits of CRC32.

lsb

Indicates the hash algorithm based on the least significant bit of multicast IP addresses.

crc-16-upper

Indicates the hash algorithm based on high-order bits of CRC16.

crc-16-lower

Indicates the hash algorithm based on low-order bits of CRC16.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To improve multicast forwarding performance, the switch uses a hash algorithm to learn multicast addresses. If multiple addresses match a key value, a hash conflict occurs. A large number of hash conflicts will cause failures to learn some multicast addresses. When such a problem occurs, use an appropriate hash algorithm to reduce hash conflicts.

Precautions

An appropriate hash algorithm can reduce but not eliminate hash conflicts.

MAC addresses are distributed on a network randomly, so the system cannot determine the best hash algorithm. The default hash algorithm is the best algorithm in most cases, so changing the hash algorithm is not recommended.

After changing the hash algorithm, restart the switch for the configuration to take effect.

Example

# Set the hash algorithm for multicast forwarding to crc-32-upper.
<HUAWEI> system-view
[HUAWEI] set multicast-hash-mode crc-32-upper
Translation
Download
Updated: 2019-10-09

Document ID: EDOC1000178165

Views: 48036

Downloads: 1163

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