No relevant resource is found in the selected language.

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

Reminder

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

upgrade

Command Reference

CloudEngine 8800, 7800, 6800, and 5800 V200R002C50

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

Multicast Route Management (IPv6) Commands

NOTE:

The CE6880EI, CE6810LI and CE5855EI do not support this feature.

display multicast ipv6 boundary

Function

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

Format

display multicast ipv6 boundary [ ipv6-group-address [ ipv6-group-mask-length ] ] [ interface interface-type interface-number ]

Parameters

Parameter Description Value
ipv6-group-address Specifies an IPv6 multicast group address to display the corresponding multicast routing table. The address is a 32-digit hexadecimal number, in the format X:X:X:X:X:X:X:X. An IPv6 multicast address starts with FF.
ipv6-group-mask-length Specifies the mask length of the IPv6 multicast group address. The value is an integer that ranges from 8 to 128.
interface interface-type interface-number Specifies the type and number of an interface. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

This command enables you to check the boundary of a PIM-SM (IPv6) 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 ipv6 boundary
IPv6 multicast boundary information
Total: 1
 Interface           Boundary
 Vlanif100           FF02::/64
Table 10-76  Description of the display multicast ipv6 boundary command output

Item

Description

IPv6 multicast boundary information

IPv6 multicast boundary.

Total: 1

Total number of IPv6 multicast boundaries.

Interface

Name of the interface configured with multicast boundary.

Boundary

Multicast group with the interface as the boundary.

display multicast ipv6 fib

Function

The display multicast ipv6 fib command displays the IPv6 multicast forwarding table.

Format

display multicast ipv6 fib [ source ipv6-source-address | group ipv6-group-address | incoming-interface { interface-type interface-number | register } ] *

display multicast ipv6 fib group ipv6-group-address source ipv6-source-address port-info

Parameters

Parameter Description Value
source ipv6-source-address Specifies the IPv6 address of a multicast source. The address is a 32-digit hexadecimal number, in the format X:X:X:X:X:X:X:X.
group ipv6-group-address Specifies the IPv6 address of a multicast group. The address is a 32-digit hexadecimal number, in the format X:X:X:X:X:X:X:X. An IPv6 multicast address starts with FF.
incoming-interface Indicates the incoming interface of an IPv6 multicast forwarding entry. -
interface-type interface-number Specifies the type and number of an interface. -
register Indicates the register interface of PIM-SM. -
port-info Displays accurate interface information in the specified multicast forwarding entries, including Layer 2 outbound interfaces.
NOTE:

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

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

During IPv6 multicast routing and forwarding, routing information generated by IPv6 multicast routing protocols is saved in an IPv6 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 IPv6 multicast forwarding table to guide multicast data forwarding.

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

NOTE:

The output does not show the real-time statistics.

Example

# Display the IPv6 multicast forwarding table.

<HUAWEI> display multicast ipv6 fib
IPv6 Multicast Forwarding Table
Total 1 entry, 1 matched
 
1.(FC00:1::3, FF1E::1)
     Index   : 4775
     Flags   : 0
     Timeout : 00:03:29
     Incoming interface : Vlanif881
     Outgoing interfaces: 1 
       1: Vlanif887
     Matched packets :954900 packets(9549000 bytes)
     Wrong interface :0 packets
     Forwarded       :954900 packets(9549000 bytes) 
Table 10-77  Description of the display multicast ipv6 fib command output

Item

Description

IPv6 Multicast Forwarding Table

IPv6 multicast forwarding table.

Total 1 entry, 1 matched

Total forwarding entries and total eligible forwarding entries.

1

Number of the (S, G) entry.

(FC00:1::3, FF1E::1)

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

Index

Unique multicast forwarding entry in the MFIB table. MCID is used to rapidly search the multicast forwarding table.

Flags

Status flag of the (S, G) entry.

Timeout

Remaining time of the (S, G) entry.

Incoming interface

Incoming interface of the (S, G) entry.

Outgoing interfaces

Outgoing interface list, including the outgoing interface number and name.

Matched packets

Number of multicast packets and bytes that match the (S, G) entry.

Wrong interface

Number of packets with an incorrect incoming interface.

Forwarded

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

display multicast ipv6 routing-table

Function

The display multicast ipv6 routing-table command displays information about an IPv6 multicast routing table.

Format

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

Parameters

Parameter Description Value
ipv6-source-address Specifies the IPv6 address of a multicast source. The address is a 32-digit hexadecimal number, in the format X:X:X:X:X:X:X:X.
mask ipv6-source-mask-length Specifies the mask length of a multicast source address. The value is an integer that ranges from 0 to 128.
ipv6-group-address Specifies the IPv6 address of a multicast group. The address is a 32-digit hexadecimal number, in the format X:X:X:X:X:X:X:X. An IPv6 multicast address starts with FF.
mask ipv6-group-mask-length Specifies the mask length of an IPv6 multicast group address. The value is an integer that ranges from 8 to 128.
incoming-interface Indicates the incoming interface of a multicast forwarding entry. -
interface-type interface-number Specifies the type and number of an interface. -
register Indicates the register interface of IPv6 PIM-SM. -
outgoing-interface Indicates the outgoing interface of a multicast forwarding entry. -
include Displays the (S, G) entries whose downstream interface list contains specified outgoing interfaces. -
exclude Displays the (S, G) entries whose downstream interface list does not contain specified outgoing interfaces. -
match Displays (S, G) entries whose the downstream interface list contains only one interface that is the same as a specified outgoing interface. If no interface is specified, the (S, G) entry with the null downstream interface list is displayed.
none Displays the routing entry without a downstream interface. -
outgoing-interface-number Displays the number of the outgoing interfaces of multicast routing entries. -
number Specifies the number of outgoing interfaces. The value is an integer that ranges from 0 to 2048.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display multicast ipv6 routing-table command to view the IPv6 multicast routing table, including the multicast source address, multicast group address, upstream interface, and downstream interface list.

Example

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

 00001: (FC00::2, FFE3::1)
       Uptime: 00:00:14
       Upstream Interface: Vlanif10
       List of 1 downstream interface
           1:  Vlanif20
Table 10-78  Description of the display multicast ipv6 routing-table command output

Item

Description

Multicast routing table of VPN instance: public net

Indicates the VPN instance to which the multicast routing information corresponds.

Total 1 entry

Number of (*, G) and (S, G) entries.

00001

Sequence number of the (S, G) entry.

(FC00::2, FFE3::1)

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

Uptime

Period during which the (S, G) entry exists.

Upstream Interface

Upstream interface of the (S, G) entry.

List of 1 downstream interface

Downstream interface list.

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

 00001: (FC00::55, FF33::1)
       Uptime: 00:00:05
       Upstream Interface: Vlanif10
       List of 2 downstream interfaces
Table 10-79  Description of the display multicast ipv6 routing-table outgoing-interface-number command output

Item

Description

List of 2 downstream interfaces

Number of the outgoing interfaces of IPv6 multicast routing entries.

display multicast ipv6 rpf-info

Function

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

Format

display multicast ipv6 rpf-info ipv6-source-address [ ipv6-group-address ] [ rpt | spt ] [ verbose ]

Parameters

Parameter Description Value
ipv6-source-address Specifies the IPv6 address of a multicast source, used to display the information of RPF routing corresponding to the source. The address is a 32-digit hexadecimal number, in the format X:X:X:X:X:X:X:X.
ipv6-group-address Specifies the IPv6 address of a multicast group, used to display the information of RPF routing corresponding to the group. The address is a 32-digit hexadecimal number, in the format X:X:X:X:X:X:X:X. An IPv6 multicast address starts with FF.
rpt Displays the RPF routing information corresponding to a specified source or group on the RPT. -
spt Displays the RPF routing information corresponding to a specified source or group on the SPT. -
verbose Displays detailed routing information. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

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

Example

# Display all RPF routes to the source address FC00::101.
<HUAWEI> display multicast ipv6 rpf-info fc00::101
 VPN-Instance: public net
 RPF information about source: FC00::101
     RPF interface: Vlanif100
     Referenced route/mask: FC00::/64
     Referenced route type: unicast
     Load splitting rule: disabled
Table 10-80  Description of the display multicast ipv6 rpf-info command output

Item

Description

RPF information about source

Indicates the multicast source to which RPF information belongs.

RPF interface

Indicates the RPF interface.

Referenced route/mask

Indicates the referenced route and its mask.

Referenced route type

Indicates the referenced route type.

Load splitting rule

Load splitting rules:
  • disable: load splitting disabled.

  • balance-ucmp: balance-preferred load splitting. This policy selects (*, G) or (S, G) entries according to forwarding capabilities of outbound interfaces in the equal-cost routes.

  • stable-preferred: stable-preferred load splitting.

  • source: source address-based load splitting.

  • group: group address-based load splitting.

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

# Display detailed information about the RPF route to source FC00::.

<HUAWEI> display multicast ipv6 rpf-info fc00:: verbose
 VPN-Instance: public net
 RPF information about source: FC00::
     RPF used topology: default
     RPF interface: Vlanif100, RPF neighbor: FE80:4000::7 
     Referenced route/mask: FC00::/64                                           
     Referenced route type: unicast
     Load splitting rule: balance-preferred                                     
 Total route information about source FC00::
 1. Referenced interface: Vlanif10
    Referenced route/mask: FC00::/64
    Referenced route type: unicast
    Referenced route preference: 15
    Referenced route cost: 20
    Referenced route nexthop: FE80:3000::7   
 2. Referenced interface: Vlanif20
    Referenced route/mask: FC00::/64 
    Referenced route type: unicast
    Referenced route preference: 15
    Referenced route cost: 20
    Referenced route nexthop: FE80::2E0:CBFF:FE53:8242
 3. Referenced interface: Vlanif100
    Referenced route/mask: FC00::/64
    Referenced route type: unicast
    Referenced route preference: 15
    Referenced route cost: 20
    Referenced route nexthop: FE80:4000::7
Table 10-81  Description of the display multicast ipv6 rpf-info fc00:: verbose command output

Item

Description

RPF used topology

Indicates the topology used by the RPF route.

RPF neighbor

Indicates the RPF neighbor.

Total route information about source FC00::

Indicates total route information about source FC00::.

Referenced interface

Indicates the downstream interface.

Referenced route preference

Indicates the route preference.

Referenced route cost

Indicates the route cost.

Referenced route nexthop

Indicates the next hop of the route.

multicast ipv6 boundary

Function

The multicast ipv6 boundary command configures a multicast boundary on an interface.

The undo multicast ipv6 boundary command deletes the configured multicast boundary.

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

Format

multicast ipv6 boundary ipv6-group-address ipv6-group-mask-length

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

Parameters

Parameter Description Value
ipv6-group-address Specifies a multicast group address. The address is a 32-digit hexadecimal number, in the format X:X:X:X:X:X:X:X. An IPv6 multicast address starts with FF.
ipv6-group-mask-length Specifies the mask length of an IPv6 multicast group address. The value is an integer that ranges from 8 to 128.
all Deletes all the multicast boundaries configured on an interface. -

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Prerequisites

IPv6 multicast routing has been enabled using the multicast ipv6 routing-enable command in the system view.

IPv6 has been enabled using the ipv6 enable command in the interface view.

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 FF02::101/16.
<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] ipv6 enable
[*HUAWEI-Vlanif100] multicast ipv6 boundary FF02::101 16
# Configure 10GE1/0/1 as the boundary of group FF02::101/16.
<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] undo portswitch
[*HUAWEI-10GE1/0/1] ipv6 enable
[*HUAWEI-10GE1/0/1] multicast ipv6 boundary FF02::101 16

multicast ipv6 cpu-forward disable

Function

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

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

By default, software forwarding for IPv6 multicast packets is enabled.

Format

multicast ipv6 cpu-forward disable

undo multicast ipv6 cpu-forward disable

Parameters

None.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In most cases, the switch forwards packets using software before the hardware forwarding is completed. After that, the switch forwards packets using hardware. An FCC-compliant device can quickly forward packets based on hardware, not software.

When the switch works together with an FCC-compliant device, software forwarding for IPv6 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

IPv6 multicast routing has been enabled using the multicast ipv6 routing-enable command in the system view.

Precautions

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

Example

# Disable software forwarding for IPv6 multicast packets.

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

multicast ipv6 invalid-packet

Function

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

The undo multicast ipv6 invalid-packet command deletes the set maximum number of invalid IPv6 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 IPv6 multicast protocol.

Format

multicast ipv6 invalid-packet { mld | pim } max-count max-number

undo multicast ipv6 invalid-packet { mld | pim }

Parameters

Parameter Description Value
mld Sets the maximum number of invalid MLD messages. -
pim Sets the maximum number of invalid PIM (IPv6) messages. -
max-count max-number Sets the maximum number of invalid IPv6 multicast protocol packets that can be stored on a device. The value is an integer that ranges from 1 to 100.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

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

Example

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

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

multicast ipv6 load-splitting

Function

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

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

By default, load splitting among IPv6 multicast routes is disabled.

Format

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

undo multicast ipv6 load-splitting

Parameters

Parameter Description Value
balance-ucmp Indicates balance-preferred load splitting. This policy selects (*, G) or (S, G) entries according to forwarding capabilities of outbound interfaces in the equal-cost routes. -
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. -
stable-preferred Indicates stable-preferred load splitting. This policy is applicable to stable multicast networking. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, if there are multiple equal-cost routes to a multicast source, the device selects the route with the largest next-hop address as the RPF route. To enable multicast data to be forwarded through multiple paths, run this command to configure multicast load splitting. After multicast load splitting is configured, the device uses the specified load splitting policy to distribute multicast data among multiple paths. This function improves quality of multicast forwarding.

Prerequisites

IPv6 multicast routing has been enabled using the multicast ipv6 routing-enable command in the system view.

Example

# Configure stable-preferred IPv6 multicast load splitting in the system view.
<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] multicast ipv6 load-splitting stable-preferred

multicast ipv6 routing-enable

Function

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

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

By default, the IPv6 multicast routing function is disabled.

Format

multicast ipv6 routing-enable

undo multicast ipv6 routing-enable

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Precautions

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

Example

# Enable IPv6 multicast routing globally.

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

Document ID: EDOC1000166501

Views: 75505

Downloads: 382

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