- Table of Contents
-
- 09-Multicast Command Reference
- 00-Preface
- 01-IGMP snooping commands
- 02-Multicast routing and forwarding commands
- 03-IGMP commands
- 04-PIM commands
- 05-MSDP commands
- 06-Multicast VPN commands
- 07-MLD snooping commands
- 08-IPv6 multicast routing and forwarding commands
- 09-MLD commands
- 10-IPv6 PIM commands
- Related Documents
-
Title | Size | Download |
---|---|---|
08-IPv6 multicast routing and forwarding commands | 296.24 KB |
Contents
IPv6 multicast routing and forwarding commands
acl (IPv6 multicast flow policy view)
bandwidth (IPv6 multicast flow policy view)
display ipv6 multicast boundary
display ipv6 multicast fast-forwarding cache
display ipv6 multicast flow-policy info
display ipv6 multicast forwarding df-info
display ipv6 multicast forwarding event
display ipv6 multicast forwarding-table
display ipv6 multicast forwarding-table df-list
display ipv6 multicast routing-table
display ipv6 multicast routing-table static
display ipv6 multicast rpf-info
flow-ucmp unicast reserve-bandwidth (IPv6 MRIB view)
ipv6 multicast flow-ucmp unicast reserve-bandwidth
ipv6 multicast forwarding-table cache-unknown per-entry
ipv6 multicast forwarding-table cache-unknown total
load-splitting (IPv6 MRIB view)
longest-match (IPv6 MRIB view)
reset ipv6 multicast fast-forwarding cache
reset ipv6 multicast forwarding event
reset ipv6 multicast forwarding-table
reset ipv6 multicast routing-table
IPv6 multicast routing and forwarding commands
acl (IPv6 multicast flow policy view)
Use acl to configure the multicast group range in which an IPv6 multicast flow policy takes effect.
Use undo acl to restore the default.
Syntax
acl { ipv6-acl-number | name ipv6-acl-name }
undo acl
Default
An IPv6 multicast flow policy does not take effect on any multicast groups.
Views
IPv6 multicast flow policy view
Predefined user roles
network-admin
Parameters
ipv6-acl-number: Specifies an IPv6 basic or advanced ACL by its number, in the range of 2000 to 3999. If the ACL does not exist or does not have contain rules, the IPv6 multicast flow policy does not take effect on any multicast groups.
name ipv6-acl-name: Specifies an IPv6 basic or advanced ACL by its name. The acl-name argument is a case-insensitive string of 1 to 63 characters and must begin with an English letter. To avoid confusion, make sure the argument is not all. If the ACL does not exist or does not have contain rules, the IPv6 multicast flow policy does not take effect on any multicast groups.
Usage guidelines
This command is not supported by the default IPv6 multicast flow policy.
If a multicast group matches the ACL specified in an IPv6 multicast flow policy, the estimated bandwidth configured in the policy is used for the multicast flows of the multicast group.
In a basic ACL rule, the source parameter specifies a multicast group range. Among the other optional parameters, only the fragment keyword and the time-range time-range-name option take effect.
In an advanced ACL rule, the source parameter specifies a multicast source range, and the destination parameter specifies a multicast group range. Among the other optional parameters, only the fragment keyword and the time-range time-range-name option take effect.
An ACL rule containing the vpn-instance vpn-instance option does not take effect.
If you execute this command multiple times, the most recent configuration takes effect.
Example
# Configure an IPv6 multicast flow policy to take effect on the multicast group range FF03::101/128.
<Sysname> system-view
[Sysname] acl ipv6 basic 2000
[Sysname-acl-ipv6-basic-2000] rule permit source ff03::101 128
[Sysname-acl-ipv6-basic-2000] quit
[Sysname] ipv6 multicast routing
[Sysname-mrib6] flow-policy name abc
[Sysname-mrib6-flow-policy-abc] acl 2000
Related commands
flow-policy (IPv6 MRIB view)
bandwidth (IPv6 multicast flow policy view)
Use bandwidth to set the estimated bandwidth for IPv6 multicast flows.
Use undo bandwidth to restore the default.
Syntax
bandwidth bandwidth { gbps | kbps | mbps }
undo bandwidth
Default
The estimated bandwidth for IPv6 multicast flows is 0.
Views
IPv6 multicast flow policy view
Predefined user roles
network-admin
Parameters
bandwidth: Specifies the estimated bandwidth in the range of 1 to 10000.
gbps: Specifies Gbps as the bandwidth unit.
kbps: Specifies kbps as the bandwidth unit.
Mbps: Specifies Mbps as the bandwidth unit.
Usage guidelines
The estimated bandwidth is selected for IPv6 multicast flows as follows:
1. If the multicast group of an IPv6 multicast flow matches the ACL specified in a custom IPv6 multicast flow policy, the estimated bandwidth configured in the policy is selected for the multicast flow.
2. If the multicast group of an IPv6 multicast flow does not match an ACL in any custom IPv6 multicast flow policy, the estimated bandwidth configured in the default policy is selected for the multicast flow.
3. If the default policy is not created or the estimated bandwidth is not configured in the default policy, the estimated bandwidth for the multicast flow is 0.
Example
# Set the estimated bandwidth to 200 Mbps for IPv6 multicast flow policy abc.
<Sysname> system-view
[Sysname] ipv6 multicast routing
[Sysname-mrib6] flow-policy name abc
[Sysname-mrib6-flow-policy-abc] bandwidth 200 mbps
Related commands
flow-policy (IPv6 MRIB view)
delete ipv6 rpf-route-static
Use delete ipv6 rpf-route-static to delete all static IPv6 multicast routes.
Syntax
delete ipv6 rpf-route-static [ vpn-instance vpn-instance-name ]
Views
System view
Predefined user roles
network-admin
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command deletes all static IPv6 multicast routes on the public network.
Usage guidelines
This command deletes all static IPv6 multicast routes. To delete a single static IPv6 multicast route, use the undo ipv6 rpf-route-static command.
Examples
# Delete all static IPv6 multicast routes on the public network.
<Sysname> system-view
[Sysname] delete ipv6 rpf-route-static
This will erase all ipv6 multicast static routes and their configurations, you must reconfigure all ipv6 static routes.
Are you sure?[Y/N]:y
Related commands
ipv6 rpf-route-static
display ipv6 mrib interface
Use display ipv6 mrib interface to display information about interfaces maintained by the IPv6 MRIB.
Syntax
display ipv6 mrib [ vpn-instance vpn-instance-name ] interface [ interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays information about interfaces maintained by the IPv6 MRIB on the public network.
interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays information about all interfaces maintained by the IPv6 MRIB.
Examples
# Display information about interfaces maintained by the IPv6 MRIB on the public network.
<Sysname> display ipv6 mrib interface
Interface: GigabitEthernet0/0/1
Index: 0x00004444
Current state: up
MTU: 1500
Type: BROADCAST
Protocol: PIM-DM
PIM protocol state: Enabled
Address list:
1. Local address : FE80:7:11::1/10
Remote address: ::
Reference : 1
State : NORMAL
Table 1 Command output
Field |
Description |
Interface |
Interface name. |
Index |
Index number of the interface. |
Current state |
Current status of the interface: up or down. |
MTU |
MTU value. |
Type |
Interface type: · BROADCAST—Broadcast link interface. · P2P—P2P interface. · LOOP—Loopback interface. · REGISTER—Register interface. · NBMA—NBMA interface. · MTUNNEL—Multicast tunnel interface. This field is empty if the interface is Null 0. |
Protocol |
Protocol running on the interface: PIM-DM, PIM-SM, MLD, or PROXY. |
PIM protocol state |
Whether IPv6 PIM is enabled: Enabled or Disabled. |
Address list |
Interface address list. |
Local address |
Local IP address. |
Remote address |
Remote end IP address. This field is displayed only when the interface is vlink type. |
Reference |
Number of times that the address has been used. |
State |
Status of the interface address: NORMAL or DEL. |
display ipv6 multicast boundary
Use display ipv6 multicast boundary to display IPv6 multicast boundary information.
Syntax
display ipv6 multicast [ vpn-instance vpn-instance-name ] boundary { group [ ipv6-group-address [ prefix-length ] ] | scope [ scope-id ] } [ interface interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays IPv6 multicast boundary information on the public network.
group: Displays the IPv6 multicast boundary information for the specified groups.
ipv6-group-address: Specifies an IPv6 multicast group address in the range of FFxy::/16, where "x" and "y" represent any hexadecimal numbers in the range of 0 to F. If you do not specify an IPv6 multicast group, this command displays IPv6 multicast boundary information for all IPv6 multicast groups.
prefix-length: Specifies an address prefix length in the range of 8 to 128. The default is 128.
scope: Displays the IPv6 multicast group boundary information in the admin-scoped zone.
scope-id: Specifies an admin-scope zone by its ID in the range of 3 to 15, which is identified by the scope field in the IPv6 multicast group address. If you do not specify an admin-scoped zone, this command displays IPv6 multicast boundary information for all IPv6 admin-scoped zones.
interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays IPv6 multicast boundary information for all interfaces.
Examples
# Display IPv6 multicast boundary information of all IPv6 multicast groups for all interfaces on the public network.
<Sysname> display ipv6 multicast boundary group
Boundary Interface
FF1E::/64 GE0/0/1
# Display IPv6 multicast boundary information in all IPv6 admin-scope zones for all interfaces on the public network.
<Sysname> display ipv6 multicast boundary scope
Boundary Interface
3 GigabitEthernet0/0/1
Table 2 Command output
Field |
Description |
Boundary |
IPv6 multicast group or IPv6 admin-scoped zone associated with the IPv6 multicast boundary. |
Interface |
Boundary interface associated with the IPv6 multicast boundary. |
ipv6 multicast boundary
display ipv6 multicast fast-forwarding cache
Use display ipv6 multicast fast-forwarding cache to display IPv6 multicast fast forwarding entries.
Syntax
display ipv6 multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache [ ipv6-source-address | ipv6-group-address ] * [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays IPv6 multicast fast forwarding entries on the public network.
ipv6-source-address: Specifies an IPv6 multicast source address.
ipv6-group-address: Specifies an IPv6 multicast group address. The value range for this argument is FFxy::/16 (excluding FFx1::/16 and FFx2::/16), where "x" and "y" represent any hexadecimal numbers in the range of 0 to F.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays IPv6 multicast fast forwarding entries for the MPU.
Examples
# Display IPv6 multicast fast forwarding entries on the public network.
<Sysname> display ipv6 multicast fast-forwarding cache
Total 1 entries, 1 matched
(FE1F:60::200, FF0E::1)
Status : Enabled
Source port: 2001 Destination port: 2002
Protocol : 2 Flag : 0x2
Incoming interface: GigabitEthernet0/0/3
List of 1 outgoing interfaces:
GigabitEthernet0/0/2
Status: Enabled Flag: 0x14
Table 3 Command output
Field |
Description |
Total 1 entries, 1 matched |
Total number of (S, G) entries, and the total number of matching (S, G) entries. |
(FE1F:60::200, FF0E::1) |
(S, G) entry. |
Protocol |
Protocol number. |
Flag |
Flag for the (S, G) entry or the outgoing interface of the entry. This field displays one flag or the sum of multiple flags. In this example, the value 0x2 means that the entry has only one flag 0x2. The value 0x14 means that the outgoing interface has flags 0x10 and 0x4. The following flags are available for an entry: · 0x1—The entry is created because of packets passed through between cards. · 0x2—The entry is added by IPv6 multicast forwarding. The following flags are available for an outgoing interface: · 0x1—The interface is added to the entry because of packets passed through between cards. · 0x2—The interface is added to an existing entry. · 0x4—The MAC address of the interface is needed for fast forwarding. · 0x8—The interface is an outgoing interface associated with the incoming VLAN or super VLAN interface. · 0x10—The interface is associated with the entry. · 0x20—The interface is to be deleted. |
Status |
Status of the (S, G) entry or the outgoing interface: · Enabled—Available. · Disabled—Unavailable. |
Incoming interface |
Incoming interface of the (S, G) entry. |
List of 1 outgoing interfaces |
Outgoing interface list of the (S, G) entry. |
Related commands
reset ipv6 multicast fast-forwarding cache all
display ipv6 multicast flow-policy info
Use display ipv6 multicast flow-policy info to display link selection information for IPv6 multicast flow policies.
Syntax
display ipv6 multicast [ vpn-instance vpn-instance-name ] flow-policy info [ interface interface-type interface-number | source source-address | group group-address | policy { default | name policy-name } ] *
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays link selection information for IPv6 multicast flow policies on the public network.
interface interface-type interface-number: Displays link selection information for IPv6 multicast flow policies on an interface.
source source-address: Displays link selection information for IPv6 multicast flow policies for a multicast source.
group group-address: Displays link selection information for IPv6 multicast flow policies for a multicast group. The value range for the group-address argument is FFxy::/16, where "x" and "y" represent any hexadecimal numbers in the range of 0 to F.
policy default: Specifies the default IPv6 multicast flow policy.
policy name policy-name: Specifies a custom IPv6 multicast flow policy by its name, a case-insensitive string of 1 to 63 characters.
Usage guidelines
If you do not specify the source, group, or policy parameter, this command displays link selection information for all IPv6 multicast flow policies.
Examples
# Display link selection information for all IPv6 multicast flow policies on the public network.
<Sysname> display ipv6 multicast flow-policy info
Total 2 interfaces, 2 matched
GigabitEthernet0/0/1:
Available bandwidth: 100000k
Used bandwidth: 30M (30%)
Total 4 entries, 4 matched
Flow bandwidth: 5M
Total 2 entries, 2 matched
(100::1, ff03::101)
Flow policy: video1
(100::1, ff03::101)
Flow policy: audio2
Flow bandwidth: 10M
Total 2 entries, 2 matched
(100::1, ff03::111)
Flow policy: audio1
(100::1, ff03::112)
Default flow policy
GigabitEthernet0/0/2:
Available bandwidth: 100000k
Used bandwidth: 10M (10%)
Total 1 entries, 1 matched
Flow bandwidth: 10M
Total 1 entries, 1 matched
(100::1, ff03::103)
Flow policy: video3
Table 4 Command output
Field |
Description |
Total 2 interfaces, 2 matched |
Total number of interfaces enabled with IPv6 PIM and number of matching interfaces. |
Available bandwidth |
Total available multicast bandwidth on the interface. |
Used bandwidth |
Used multicast bandwidth in percentage on the interface. |
Total 4 entries, 4 matched |
Total number of (S, G) entries that have selected the interface as an upstream interface and number of matching (S, G) entries. |
Flow bandwidth |
Estimated bandwidth configured in an IPv6 multicast flow policy. |
Total 1 entries, 1 matched |
Total number of (S, G) entries for the IPv6 multicast flow policy and number of matching (S, G) entries. |
(100::1, ff03::101) |
(S, G) entry for the IPv6 multicast flow. |
Flow policy |
Name of the custom IPv6 multicast flow policy. |
Default flow policy |
Name of the default IPv6 multicast flow policy. |
Related commands
ipv6 flow-ucmp unicast reserved-bandwidth
display ipv6 multicast forwarding df-info
Use display ipv6 multicast forwarding df-info to display DF information.
Syntax
display ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding df-info [ ipv6-rp-address ] [ verbose ] [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays information about DFs on the public network.
ipv6-rp-address: Specifies an IPv6 BIDIR-PIM RP by its IPv6 address.
verbose: Displays detailed information. If you do not specify this keyword, the command displays brief information about DFs.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays DF information for the MPU.
Usage guidelines
In an IPv6 BIDIR-PIM domain, only the DF on each subnet can forward IPv6 multicast data destined for an IPv6 multicast group toward the RP of the group. For more information about DFs, see IP Multicast Configuration Guide.
Examples
# Display brief DF information on an ADVPN network.
<Sysname> display ipv6 multicast forwarding df-info
Total 1 RPs, 1 matched
00001. RP address: 2::2
Flags: 0x0
Uptime: 00:00:14
RPF interface: LoopBack0
List of 2 DF interfaces:
1: Tunnel2, FE80::1
2: Tunnel2, FE80::3
# Display brief information about DFs on the public network.
<Sysname> display ipv6 multicast forwarding df-info
Total 1 RPs, 1 matched
00001. RP address: 7:11::1
Flags: 0x0
Uptime: 01:46:40
RPF interface: GigabitEthernet0/0/1
List of 1 DF interface:
1: GigabitEthernet0/0/2
# Display detailed information about DFs on the public network.
<Sysname> display ipv6 multicast forwarding df-info verbose
Total 1 RPs, 1 matched
00001. RP address: 7:11::1
MID: 2, Flags: 0x0
Uptime: 00:03:53
Product information: 0x7a2f762f, 0x718fee9f, 0x4b82f137, 0x71c32184
RPF interface: GigabitEthernet0/0/1
Product information: 0xa567d6fc, 0xadeb03e3
Tunnel information: 0xdfb107d4, 0x7aa5d510
List of 1 DF interface:
1: GigabitEthernet0/0/2
Product information: 0xa986152b, 0xb74a9a2f
Tunnel information: 0x297ca208, 0x76985b89
Table 5 Command output
Field |
Description |
Total 1 RPs, 1 matched |
Total number of RPs, and the total number of matching RPs. |
00001 |
Sequence number of the entry to which the RP is designated. |
RP address |
IPv6 address of the RP. |
MID |
ID of the entry to which the RP is designated. Each entry to which the RP is designated has a unique MID. |
Flags |
Entry flag. This field displays one flag or the sum of multiple flags. In this example, the value 0x0 means that the entry has only one flag 0x0. The following flags are available for an entry: · 0x0—The entry is in correct state. · 0x4—The entry fails to update. · 0x8—DF interface information fails to update for the entry. · 0x40—The entry is to be deleted. · 0x100—The entry is being deleted. · 0x200—The entry is in GR state. |
Uptime |
Length of time for which the entry has been up. |
RPF interface |
RPF interface to the RP. |
List of 1 DF interfaces |
DF interface list. |
Tunnel2, FE80::1 |
ADVPN tunnel interface, and the IPv6 link-local address of the remote end. |
display ipv6 multicast forwarding event
Use display ipv6 multicast forwarding event to display statistics of IPv6 multicast forwarding events.
Syntax
display ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding event [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays statistics of IPv6 multicast forwarding events on the public network.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays statistics of IPv6 multicast forwarding events for the MPU.
Examples
# Display statistics of IPv6 multicast forwarding events on the public network.
<Sysname> display ipv6 multicast forwarding event
Total active events sent: 0
Total inactive events sent: 0
Total NoCache events sent: 2
Total NoCache events dropped: 0
Total WrongIF events sent: 0
Total WrongIF events dropped: 0
Total SPT switch events sent: 0
NoCache rate limit: 1024 packets/s
WrongIF rate limit: 1 packets/10s
Total timer of register suppress timeout: 0
Field |
Description |
Total active events sent |
Number of times that entry-active events have been sent. |
Total inactive events sent |
Number of times that entry-inactive events have been sent. |
Total NoCache events sent |
Number of times that NoCache events have been sent. |
Total NoCache events dropped |
Number of times that NoCache events have been dropped. |
Total WrongIF events sent |
Number of times that WrongIF events have been sent. |
Total WrongIF events dropped |
Number of times that WrongIF events have been dropped. |
Total SPT switch events sent |
Number of times that SPT-switch events have been sent. |
NoCache rate limit |
Rate limit for sending NoCache events, in pps. |
WrongIF rate limit |
Rate limit for sending WrongIF events, in packets per 10 seconds. |
Total timer of register suppress timeout |
Number of times that the registration suppression has timed out in total. |
Related commands
reset ipv6 multicast forwarding event
display ipv6 multicast forwarding-table
Use display ipv6 multicast forwarding-table to display IPv6 multicast forwarding entries.
Syntax
display ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding-table [ ipv6-source-address [ prefix-length ] | ipv6-group-address [ prefix-length ] | incoming-interface interface-type interface-number | outgoing-interface { exclude | include | match } interface-type interface-number | slot slot-number | statistics ] *
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays IPv6 multicast forwarding entries on the public network.
ipv6-source-address: Specifies an IPv6 multicast source address.
ipv6-group-address: Specifies an IPv6 multicast group address in the range of FFxy::/16, where "x" and "y" represent any hexadecimal numbers in the range of 0 to F.
prefix-length: Specifies an address prefix length. The default value is 128. For an IPv6 multicast group address, the value range for this argument is 8 to 128. For an IPv6 multicast source address, the value range for this argument is 0 to 128.
incoming-interface: Specifies the IPv6 forwarding entries that contain the specified incoming interface.
interface-type interface-number: Specifies an interface by its type and number.
outgoing-interface: Specifies the IPv6 forwarding entries that contain the specified outgoing interface.
exclude: Specifies the IPv6 forwarding entries that do not contain the specified interface in the outgoing interface list.
include: Specifies the IPv6 forwarding entries that contain the specified interface in the outgoing interface list.
match: Specifies the IPv6 forwarding entries that contain only the specified interface in the outgoing interface list.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays IPv6 multicast forwarding entries for the MPU.
statistics: Displays statistics for the IPv6 multicast forwarding table.
Examples
# Display IPv6 multicast forwarding entries on an ADVPN network.
<Sysname> display ipv6 multicast forwarding-table
Total 1 entries, 1 matched
00001. (1::1, ff0e::1)
Flags: 0x0
Uptime: 00:08:32, Timeout in: 00:03:26
Incoming interface: Tunnel1, FE80::20:11
List of 1 outgoing interfaces:
1: Tunnel1, FE80::20:12
2: Tunnel1, FE80::20:13
Matched 19648 packets(20512512 bytes), Wrong If 0 packet
Forwarded 19648 packets(20512512 bytes)
# Display IPv6 multicast forwarding entries on the public network.
<Sysname> display ipv6 multicast forwarding-table
Total 1 entries, 1 matched
00001. (1::1, ff0e::1)
Flags: 0x0
Uptime: 00:08:32, Timeout in: 00:03:26
Incoming interface: GigabitEthernet0/0/1
List of 1 outgoing interfaces:
1: GigabitEthernet0/0/2
Matched 19648 packets(20512512 bytes), Wrong If 0 packets
Forwarded 19648 packets(20512512 bytes)
Table 7 Command output
Field |
Description |
Total 1 entries, 1 matched |
Total number of (S, G) entries, and the total number of matching (S, G) entries. |
00001 |
Sequence number of the (S, G) entry. |
(1::1, ff0e::1) |
(S, G) entry. |
Flags |
Entry flag. This field displays one flag or the sum of multiple flags. In this example, the value 0x0 means that the entry has only one flag 0x0. The following flags are available for an entry: · 0x0—The entry is in correct state. · 0x1—The entry is in inactive state. · 0x2—The entry is null. · 0x4—The entry fails to update. · 0x8—The outgoing interface information fails to update for the entry. · 0x20—A register outgoing interface is available. · 0x40—The entry is to be deleted. · 0x80—The entry is in registration suppression state. · 0x100—The entry is being deleted. · 0x200—The entry is in GR state. · 0x400—The entry has the VLAN interface of the super VLAN. · 0x800—The entry has the associated ND entry for the IPv6 multicast source address. · 0x4000000—The entry is created by the MLD proxy. · 0x20000000—The entry is an IPv6 BIDIR-PIM forwarding entry. |
Uptime |
Length of time for which the (S, G) entry has been up. |
Timeout in |
Length of time in which the (S, G) entry will time out. |
Incoming interface |
Incoming interface of the (S, G) entry. |
Incoming sub-VLAN |
Incoming sub-VLAN of the super VLAN when the incoming interface of the (S, G) entry is the VLAN interface of this super VLAN. |
Outgoing sub-VLAN |
Outgoing sub-VLAN of the super VLAN when the incoming interface of the (S, G) entry is the VLAN interface of this super VLAN. |
List of 1 outgoing interfaces |
Outgoing interface list of the (S, G) entry. |
Sub-VLAN |
Outgoing sub-VLAN of the super VLAN when the outgoing interface of the (S, G) entry is the VLAN interface of this super VLAN. |
Tunnel1, FE80::20:12 |
ADVPN tunnel interface, and the IPv6 link-local address of the remote end. |
Matched 19648 packets (20512512 bytes), Wrong If 0 packet |
Number of packets (bytes) that match the (S, G) entry, and number of packets with incoming interface errors. The numbers are displayed as 0 if an outgoing interface of the (S, G) entry is on the specified slot. |
Forwarded 19648 packets (20512512 bytes) |
Number of packets (bytes) that have been forwarded. The numbers are displayed as 0 if an outgoing interface of the (S, G) entry is on the specified slot. |
reset ipv6 multicast forwarding-table
display ipv6 multicast forwarding-table df-list
Use display ipv6 multicast forwarding-table df-list to display information about the DF list in IPv6 multicast forwarding entries.
Syntax
display ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding-table df-list [ ipv6-group-address ] [ verbose ] [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays information about the DF list in IPv6 multicast forwarding entries on the public network.
ipv6-group-address: Specifies an IPv6 multicast address. The value range for this argument is FFxy::/16 (excluding FFx1::/16 and FFx2::/16), where "x" and "y" represent any hexadecimal numbers in the range of 0 to F.
verbose: Displays detailed information. If you do not specify this keyword, the command displays brief information.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays information about the DF list in IPv6 multicast forwarding entries for the MPU.
Examples
# Display brief information about the DF list in IPv6 multicast forwarding entries on the public network.
<Sysname> display ipv6 multicast forwarding-table df-list
Total 1 entries, 1 matched
00001. (::, FF1E::1)
List of 1 DF interfaces:
1: GigabitEthernet0/0/1
# Display detailed information about the DF list in IPv6 multicast forwarding entries on the public network.
<Sysname> display ipv6 multicast forwarding-table df-list verbose
Total 1 entries, 1 matched
00001. (::, FF1E::1)
List of 1 DF interfaces:
1: GigabitEthernet0/0/1
Product information: 0x347849f6, 0x14bd6837
Tunnel information: 0xc4857986, 0x128a9c8f
Table 8 Command output
Field |
Description |
Total 1 entries, 1 matched |
Total number of entries, and the total number of matching entries. |
00001 |
Sequence number of the entry. |
(::, FF1E::1) |
(*, G) entry. |
List of 1 DF interfaces |
DF interface list. |
display ipv6 multicast routing-table
Use display ipv6 multicast routing-table to display IPv6 multicast routing entries.
Syntax
display ipv6 multicast [ vpn-instance vpn-instance-name ] routing-table [ ipv6-source-address [ prefix-length ] | ipv6-group-address [ prefix-length ] | incoming-interface interface-type interface-number | outgoing-interface { exclude | include | match } interface-type interface-number ] *
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays IPv6 multicast routing entries on the public network.
ipv6-source-address: Specifies an IPv6 multicast source address.
ipv6-group-address: Specifies an IPv6 multicast group address in the range of FFxy::/16, where "x" and "y" represent any hexadecimal numbers in the range of 0 to F.
prefix-length: Specifies an address prefix length. The default is 128. For an IPv6 multicast group address, the value range for this argument is 8 to 128. For an IPv6 multicast source address, the value range for this argument is 0 to 128.
incoming-interface: Displays the IPv6 routing entries that contain the specified incoming interface.
interface-type interface-number: Specifies an interface by its type and number.
outgoing-interface: Displays the IPv6 routing entries that contain the specified outgoing interface.
exclude: Displays the IPv6 routing entries that do not contain the specified interface in the outgoing interface list.
include: Displays the IPv6 routing entries that contain the specified interface in the outgoing interface list.
match: Displays the IPv6 routing entries that contain only the specified interface in the outgoing interface list.
Usage guidelines
IPv6 multicast routing entries are the basis of IPv6 multicast forwarding. You can use this command to view the establishment state of (S, G) entries.
Examples
# Display IPv6 multicast routing entries on an ADVPN network.
<Sysname> display ipv6 multicast routing-table
Total 1 entries
00001. (2001::2, FFE3::101)
Uptime: 00:00:14
Upstream Interface: Tunnel1, FE80::20:11
List of 2 downstream interfaces
1: Tunnel1, FE80::20:12
2: Tunnel1, FE80::20:13
# Display IPv6 multicast routing entries on the public network.
<Sysname> display ipv6 multicast routing-table
Total 1 entries
00001. (2001::2, FFE3::101)
Uptime: 00:00:14
Upstream Interface: GigabitEthernet0/0/1
List of 2 downstream interfaces
1: GigabitEthernet0/0/2
2: GigabitEthernet0/0/3
Table 9 Command output
Field |
Description |
Total 1 entries |
Total number of (S, G) entries. |
00001 |
Sequence number of the (S, G) entry. |
(2001::2, FFE3::101) |
(S, G) entry. |
Uptime |
Length of time for which the (S, G) entry has been up. |
Upstream Interface |
Upstream interface at which the (S, G) packets should arrive. |
List of 2 downstream interfaces |
List of downstream interfaces that forward (S, G) packets. |
Tunnel11, FE80::20:12 |
ADVPN tunnel interface, and the IPv6 link-local address of the remote end. |
reset ipv6 multicast routing-table
display ipv6 multicast routing-table static
Use display ipv6 multicast routing-table static to display static IPv6 multicast routing entries.
Syntax
display ipv6 multicast [ vpn-instance vpn-instance-name ] routing-table static [ ipv6-source-address [ prefix-length ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays static IPv6 multicast routing entries on the public network.
ipv6-source-address: Specifies an IPv6 multicast source address.
prefix-length: Specifies the address prefix length in the range of 0 to 128. The default is 128.
Usage guidelines
This command displays only valid static IPv6 multicast routing entries.
Examples
# Display static IPv6 multicast routing entries on the public network.
<Sysname> display ipv6 multicast routing-table static
Destinations: 2 Routes: 4
Destination/Prefix: 2::100/128
Pre: 10
RPF neighbor Interface
100::2 GE0/0/1
125:0:3::3 GE0/0/2
Destination/Prefix: 3::100/128
Pre: 20
RPF neighbor Interface
100::3 GE0/0/3
125:0:3::4 GE0/0/4
Table 10 Command output
Field |
Description |
Destinations |
Number of IPv6 multicast destination addresses. |
Routes |
Number of routes. |
Destination/Mask |
Destination address and its prefix length. |
Pre |
Route preference. |
RPF neighbor |
IPv6 address of the RPF neighbor to the reachable destination. |
Interface |
Outgoing interface to the reachable destination. |
display ipv6 multicast rpf-info
Use display ipv6 multicast rpf-info to display RPF information for an IPv6 multicast source.
Syntax
display ipv6 multicast [ vpn-instance vpn-instance-name ] rpf-info ipv6-source-address [ ipv6-group-address ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays RPF information for an IPv6 multicast source on the public network.
ipv6-source-address: Specifies an IPv6 multicast source address.
ipv6-group-address: Specifies an IPv6 multicast group address in the range of FFxy::/16 (excluding FFx1::/16 and FFx2::/16), where "x" and "y" represent any hexadecimal numbers in the range of 0 to F.
Examples
# Display RPF information for IPv6 multicast source 2001::101 on the public network.
<Sysname> display ipv6 multicast rpf-info 2001::101
RPF information about source 2001::101:
RPF interface: GigabitEthernet0/0/1, RPF neighbor: FE80::A01:101:1
Referenced prefix/prefix length: 2001::/64
Referenced route type: igp
Route selection rule: preference-preferred
Load splitting rule: disable
Source AS: 0
C-multicast route target: 0x0000000000000000
Table 11 Command output
Field |
Description |
RPF information about source 2001::101 |
RPF information of the IPv6 multicast source 2001::101. |
RPF interface |
Type and number of the RPF interface. |
RPF neighbor |
IPv6 address (link-local address) of the RPF neighbor. |
Referenced prefix/prefix length |
Referenced route and its prefix length. |
Referenced route type |
Type of the referenced route: · igp—IPv6 IGP unicast route. · egp—IPv6 EGP unicast route. · unicast (direct) —IPv6 directly connected unicast route. · unicast—Other IPv6 unicast route, such as IPv6 unicast static route. · mbgp—IPv6 MBGP route. |
Route selection rule |
RPF route selection rule: · Route preference. · Longest prefix match. |
Load splitting rule |
Whether load splitting is enabled. |
Source AS |
AS number of the source-side PE. |
C-multicast route target |
Route target attribute value of the C-multicast route. |
display ipv6 multicast forwarding-table
display ipv6 multicast routing-table
flow-policy (IPv6 MRIB view)
Use flow-policy to create an IPv6 multicast flow policy and enter its view, or enter the view of an existing IPv6 multicast flow policy.
Use undo flow-policy to delete IPv6 multicast flow policies.
Syntax
flow-policy { default | name policy-name }
undo flow-policy { all | default | name policy-name }
Default
No IPv6 multicast flow policies exist.
Views
IPv6 MRIB view
Predefined user roles
network-admin
Parameters
default: Specifies the default IPv6 multicast flow policy.
policy name policy-name: Specifies a custom IPv6 multicast flow policy by its name, a case-insensitive string of 1 to 63 characters.
all: Deletes all IPv6 multicast flow policies.
Usage guidelines
Operating mechanism
The device selects the link with the smallest bandwidth usage as the optimal link if the following conditions exist:
· ECMP routes between the device and an upstream device.
· The multicast load-splitting mode is flow-ucmp.
If two links have the same bandwidth usage, the link with the higher next-hop IPv6 address is selected.
The bandwidth usage is calculated according to the following formula: Bandwidth usage = (Used bandwidth+Estimated bandwidth)/(Total interface bandwidth x (1–Unicast reserved bandwidth)).
· The estimated bandwidth is configured by the bandwidth command in IPv6 multicast flow policy view.
· The total interface bandwidth is configured by the bandwidth command in interface view.
· The unicast reserved bandwidth is configured by the flow-ucmp unicast reserve-bandwidth or ipv6 multicast flow-ucmp unicast reserve-bandwidth command.
For this command to take effect, you must configure the multicast load-splitting mode as flow-ucmp.
Adding, deleting, or modifying an IPv6 multicast flow policy does not affect the link selection results of existing multicast flows and affects link selection for only new multicast flows. Before configuring the multicast load-splitting mode as flow-ucmp, you must plan the configuration of an IPv6 multicast flow policy and the unicast reserved bandwidth configuration.
The change of link bandwidth and the change in the number of ECMP routes do not affect the route selection of existing multicast flows.
This feature does not affect multicast source-side link selection, link selection in IPv6 PIM-DM, RPT link selection in IPv6 PIM-SM, or local RP link selection.
If both IPv4 and IPv6 multicast flows exist in the network, increase the unicast reserved bandwidth as needed to avoid congestion.
Examples
# Create an IPv6 multicast flow policy named abc and enter its view.
<Sysname> system-view
[Sysname] ipv6 multicast routing
[Sysname-mrib6] flow-policy name abc
# Create the default IPv6 multicast flow policy and enter its view.
<Sysname> system-view
[Sysname] ipv6 multicast routing
[Sysname-mrib6] flow-policy default
Related commands
acl (IPv6 multicast flow policy)
bandwidth
display ipv6 multicast flow-policy info
flow-ucmp unicast reserve-bandwidth (IPv6 MRIB view)
Use flow-ucmp unicast reserve-bandwidth to set the global IPv6 unicast reserved bandwidth percentage.
Use undo flow-ucmp unicast reserve-bandwidth to restore the default.
Syntax
flow-ucmp unicast reserve-bandwidth percentage
undo flow-ucmp unicast reserve-bandwidth
Default
The global IPv6 unicast reserved bandwidth percentage is not set.
Views
IPv6 MRIB view
Predefined user roles
network-admin
Parameters
percentage: Specifies the global IPv6 unicast reserved bandwidth percentage in the range of 1 to 100.
Usage guidelines
For this command to take effect, you must configure the multicast load-splitting mode as flow-ucmp.
Execute this command when IPv6 unicast traffic and IPv6 multicast traffic coexist in the network. The available bandwidth for multicast traffic is calculated based on the total interface bandwidth and the configured IPv6 unicast reserved bandwidth percentage. For example, if the total interface bandwidth is 100 kbps and the IPv6 unicast reserved bandwidth percentage is 20% (20 kbps), the available bandwidth for multicast traffic is 80 kbps.
The flow-ucmp unicast reserve-bandwidth command takes effect on all interfaces, and the ipv6 multicast flow-ucmp unicast reserve-bandwidth command takes effect only on the current interface. If you execute both commands, the latter has higher priority.
Example
# Set the global IPv6 unicast reserved bandwidth percentage to 50%.
<Sysname> system-view
[Sysname] ipv6 multicast routing
[Sysname-mrib6] flow-ucmp unicast reserve-bandwidth 50
Related commands
ipv6 multicast flow-ucmp unicast reserve-bandwidth
ipv6 mtrace-service port
Use ipv6 mtrace-service port to specify the UDP port number used by IPv6 mtrace.
Use undo ipv6 mtrace-service port to restore the default.
Syntax
ipv6 mtrace-service port number
undo ipv6 mtrace-service port
Default
IPv6 mtrace uses UDP port number 10240.
Views
System view
Predefined user roles
network-admin
Parameters
number: Specifies a UDP port number to be used by IPv6 mtrace, in the range of 1024 to 49151.
Usage guidelines
For successful IPv6 mtrace, do not specify a UDP port number used by other modules.
You must specify the same UDP port number on all devices on the traced path. Additionally, the specified UDP port number must be the same as that specified in the mtrace v2 command.
Examples
# Specify 12345 as the UDP port number used by IPv6 mtrace.
<Sysname> system-interview
[sysname] ipv6 mtrace-service port 12345
Related commands
mtrace v2 ipv6
ipv6 multicast boundary
Use ipv6 multicast boundary to configure an IPv6 multicast forwarding boundary.
Use undo ipv6 multicast boundary to delete an IPv6 multicast forwarding boundary.
Syntax
ipv6 multicast boundary { ipv6-group-address prefix-length | scope { scope-id | admin-local | global | organization-local | site-local } }
undo ipv6 multicast boundary { ipv6-group-address prefix-length| all | scope { scope-id | admin-local | global | organization-local | site-local } }
Default
An interface is not an IPv6 multicast forwarding boundary.
Views
Interface view
Predefined user roles
network-admin
Parameters
ipv6-group-address: Specifies an IPv6 multicast group address in the range of FFxy::/16, where "x" and "y" represent any hexadecimal numbers in the range of 0 to F.
prefix-length: Specifies the address prefix length in the range of 8 to 128.
all: Specifies all IPv6 multicast boundaries configured on the interface.
scope-id: Specifies the ID of an admin-scoped zone, in the range of 3 to 15, which is identified by the scope field in the IPv6 multicast group address.
admin-local: Specifies the scoped zone as admin-local, which has a scope ID of 4.
global: Specifies the scoped zone as global, which has a scope ID of 14.
organization-local: Specifies the scoped zone as organization-local, which has a scope ID of 8.
site-local: Specifies the scoped zone as site-local, which has a scope ID of 5.
Usage guidelines
A multicast forwarding boundary sets the boundary condition for the IPv6 multicast groups in the specified address range. If the destination address of an IPv6 multicast packet matches the set boundary condition, the packet is not forwarded.
An interface can act as a forwarding boundary for multiple IPv6 multicast groups in different address ranges. You can implement this by using this command on the interface for each multicast address range. These multicast groups must be in the same scope. The latest configuration of a scope overwrites the previous one.
You do not need to enable IPv6 multicast routing before you execute this command.
Assume that Set A and Set B are both IPv6 multicast forwarding boundary sets with different address ranges, and that B is a subset of A. A takes effect on the interface no matter whether A is configured earlier or later than B.
Examples
# Configure GigabitEthernet 0/0/1 as the forwarding boundary of IPv6 multicast groups in the range of FF03::/16.
<Sysname> system-view
[Sysname] interface gigabitethernet 0/0/1
[Sysname-GigabitEthernet0/0/1] ipv6 multicast boundary ff03:: 16
# Configure GigabitEthernet 0/0/1 as the forwarding boundary of IPv6 multicast groups in the admin-local scope.
<Sysname> system-view
[Sysname] interface gigabitethernet 0/0/1
[Sysname-GigabitEthernet0/0/1] ipv6 multicast boundary scope 4
Related commands
display ipv6 multicast boundary
ipv6 multicast flow-ucmp unicast reserve-bandwidth
Use ipv6 multicast flow-ucmp unicast reserve-bandwidth to set the IPv6 unicast reserved bandwidth percentage on an interface.
Use undo ipv6 multicast flow-ucmp unicast reserve-bandwidth to restore the default.
Syntax
ipv6 multicast flow-ucmp unicast reserve-bandwidth percentage
undo ipv6 multicast flow-ucmp unicast reserve-bandwidth
Default
The IPv6 unicast reserved bandwidth percentage is not set on an interface.
Views
Interface view
Predefined user roles
network-admin
Parameters
percentage: Specifies the IPv6 unicast reserved bandwidth percentage in the range of 1 to 100.
Usage guidelines
For this command to take effect, you must use the load-splitting command to configure the multicast load-splitting mode.
Execute this command when IPv6 unicast traffic and IPv6 multicast traffic coexist in the network. The available bandwidth for multicast traffic is calculated based on the total interface bandwidth and the configured IPv6 unicast reserved bandwidth percentage. For example, if the total interface bandwidth is 100 kbps and the IPv6 unicast reserved bandwidth percentage is 20% (20 kbps), the available bandwidth for multicast traffic is 80 kbps.
The flow-ucmp unicast reserve-bandwidth command takes effect on all interfaces, and the ipv6 multicast flow-ucmp unicast reserve-bandwidth command takes effect only on the current interface. If you execute both commands, the latter has higher priority.
Example
# Set the IPv6 unicast reserved bandwidth percentage to 50% on GigabitEthernet 0/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 0/0/1
[Sysname-GigabitEthernet0/0/1] ipv6 multicast flow-ucmp unicast reserve-bandwidth 50
Related commands
ipv6 flow-ucmp unicast reserve-bandwidth
ipv6 multicast forwarding-table cache-unknown per-entry
Use ipv6 multicast forwarding-table cache-unknown per-entry to set the maximum number of unknown IPv6 multicast packets that can be cached for an (S, G) entry.
Use undo ipv6 multicast forwarding-table cache-unknown per-entry to restore the default.
Syntax
ipv6 multicast forwarding-table cache-unknown per-entry per-entry-limit
undo ipv6 multicast forwarding-table cache-unknown per-entry
Default
The device can cache only one unknown IPv6 multicast packet for an (S, G) entry.
Views
System view
Predefined user roles
network-admin
Parameters
per-entry-limit: Specifies the maximum number of unknown IPv6 multicast packets that can be cached for an (S, G) entry. The value range for this argument is 0 to 256. If you set the value to 0, the device cannot cache unknown IPv6 multicast packets.
Examples
# Set the maximum number to 20 for unknown IPv6 multicast packets that can be cached for an (S, G) entry.
<Sysname> system-view
[Sysname] ipv6 multicast forwarding-table cache-unknown per-entry 20
Related commands
ipv6 multicast forwarding-table cache-unknown total
ipv6 multicast forwarding-table cache-unknown total
Use ipv6 multicast forwarding-table cache-unknown total to set the maximum number of all unknown IPv6 multicast packets that can be cached.
Use undo multicast forwarding-table cache-unknown total to restore the default.
Syntax
ipv6 multicast forwarding-table cache-unknown total total-limit
undo ipv6 multicast forwarding-table cache-unknown total
Default
The device can cache 1024 unknown IPv6 multicast packets in total.
Views
System view
Predefined user roles
network-admin
Parameters
total-limit: Specifies the maximum number of all unknown IPv6 multicast packets that can be cached. The value range for this argument is 0 to 65535. If you set the value to 0, the device cannot cache unknown IPv6 multicast packets.
Usage guidelines
As a best practice, set the value in this command to be far greater than the value set in the ipv6 multicast forwarding-table cache-unknown per-entry command.
Examples
# Set the maximum number to 10000 for all unknown IPv6 multicast packets that can be cached.
<Sysname> system-view
[Sysname] ipv6 multicast forwarding-table cache-unknown total 10000
Related commands
ipv6 multicast forwarding-table cache-unknown per-entry
ipv6 multicast routing
Use ipv6 multicast routing to enable IPv6 multicast routing and enter IPv6 MRIB view.
Use undo ipv6 multicast routing to disable IPv6 multicast routing.
Syntax
ipv6 multicast routing [ vpn-instance vpn-instance-name ]
undo ipv6 multicast routing [ vpn-instance vpn-instance-name ]
Default
IPv6 multicast routing is disabled.
Views
System view
Predefined user roles
network-admin
parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command enables IPv6 multicast routing on the public network.
Usage guidelines
Other Layer 3 IPv6 multicast commands take effect only when IPv6 multicast routing is enabled on the public network or for the VPN instance to which the device belongs.
The device does not forward any IPv6 multicast packets before IPv6 multicast routing is enabled.
Examples
# Enable IPv6 multicast routing on the public network, and enter IPv6 MRIB view.
<Sysname> system-view
[Sysname] ipv6 multicast routing
[Sysname-mrib6]
# Enable IPv6 multicast routing for VPN instance mvpn, and enter IPv6 MRIB view.
<Sysname> system-view
[Sysname] ipv6 multicast routing vpn-instance mvpn
[Sysname-mrib6-mvpn]
ipv6 rpf-route-static
Use ipv6 rpf-route-static to configure a static IPv6 multicast route.
Use undo ipv6 rpf-route-static to delete a static IPv6 multicast route.
Syntax
ipv6 rpf-route-static [ vpn-instance vpn-instance-name ] ipv6-source-address prefix-length { ipv6-rpf-nbr-address | interface-type interface-number } [ description text ] [ preference preference ]
undo ipv6 rpf-route-static [ vpn-instance vpn-instance-name ] ipv6-source-address prefix-length { ipv6-rpf-nbr-address | interface-type interface-number }
Default
No static IPv6 multicast routes exist.
Views
System view
Predefined user roles
network-admin
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command configures a static IPv6 multicast route on the public network.
ipv6-source-address: Specifies an IPv6 multicast source address.
prefix-length: Specifies the address prefix length in the range of 0 to 128. The default is 128.
ipv6-rpf-nbr-address: Specifies an RPF neighbor by its IPv6 address.
interface-type interface-number: Specifies an interface by its type and number. The interface connects the RPF neighbor.
description text : Specifies the description of the static IPv6 multicast route, a case-sensitive string of 1 to 60 characters. The description can include blank spaces and special characters except for the question mark (?).
preference: Sets a route preference in the range of 1 to 255. The default is 1.
Usage guidelines
If the interface connected to an RPF neighbor is a point-to-point interface, you must specify the interface by its type and number.
If the interface connected to an RPF neighbor is not a point-to-point interface, you must specify the interface by its IP address. This type of interfaces includes Layer 3 Ethernet, Layer 3 aggregate, loopback, and VLAN interfaces.
The configured static IPv6 multicast route might not take effect when one of the following conditions exists:
· The outgoing interface iteration fails.
· The specified interface is not in the public network or the same VPN instance as the current interface.
· The specified interface is not a point-to-point interface.
· The specified interface is down.
If multiple static IPv6 multicast routes within the same IPv6 multicast source address range are available, only the one with the highest route preference can become active. You can use the display ipv6 multicast routing-table static command to verify that the configured static IPv6 multicast route has taken effect.
The undo ipv6 rpf-route-static command deletes the specified static IPv6 multicast route. To delete all static IPv6 multicast routes, use the delete ipv6 rpf-route-static command.
Examples
# Configure a static IPv6 multicast route to IPv6 multicast source 101::0/64 and specify the interface with IP address 106::7 as the RPF neighbor on the public network.
<Sysname> system-view
[Sysname] ipv6 rpf-route-static 101::0 64 106::7
Related commands
delete ipv6 rpf-route-static
display ipv6 multicast routing-table static
load-splitting (IPv6 MRIB view)
Use load-splitting to enable IPv6 multicast load splitting.
Use multicast load-splitting to restore the default.
Syntax
load-splitting { balance-ecmp | balance-ucmp | ecmp | flow-ucmp | source | source-group | ucmp }
undo load-splitting
Default
IPv6 multicast load splitting is disabled.
Views
IPv6 MRIB view
Predefined user roles
network-admin
Parameters
balance-ecmp: Enables IPv6 multicast load balancing based on ECMP paths. Multicast traffic is evenly distributed among ECMP paths.
balance-ucmp: Enables IPv6 multicast load balancing based on links. Multicast traffic is evenly distributed among links.
ecmp: Enables IPv6 multicast load splitting based on ECMP paths.
flow-ucmp: Enables IPv6 multicast load splitting based on the bandwidth usage of multicast flows.
source: Enables IPv6 multicast load splitting based on IPv6 multicast source.
source-group: Enables IPv6 multicast load splitting based on IPv6 multicast source and group.
ucmp: Enables IPv6 multicast load splitting based on link bandwidth.
Usage guidelines
This command does not take effect on IPv6 BIDIR-PIM.
To use the flow-ucmp multicast load-splitting mode, you must first configure an IPv6 multicast flow policy and the IPv6 unicast reserved bandwidth percentage. Adding, deleting, or modifying an IPv6 multicast flow policy does not affect the link selection results of existing IPv6 multicast flows and affects link selection for only new IPv6 multicast flows.
On a network with ECMP routes, specify the balance-ecmp, ecmp, flow-ucmp, source, or source-group keyword. On a network with UCMP routes, specify the balance-ucmp or ucmp keyword.
· If you specify the ecmp keyword, adding or deleting ECMP routes severely affects IPv6 multicast forwarding.
· If you specify the source or source-group keyword, adding or deleting ECMP routes slightly affects IPv6 multicast forwarding. Specify either of the keywords on a network with unstable equal cost links.
· If you specify the balance-ecmp or balance-ucmp keyword, the device uses a polling mechanism for IPv6 multicast load balancing. ECMP or UCMP-based IPv6 multicast load balancing provides better stability and balance than ECMP or UCMP-based IPv6 multicast load sharing.
· If you specify the flow-ucmp keyword, adding or deleting ECMP routes slightly affects IPv6 multicast forwarding. Specify this keyword on a network with unstable equal-cost links. It provides better stability and balance than the ucmp multicast load-sharing mode.
Examples
# Enable IPv6 multicast load splitting based on IPv6 multicast source on the public network.
<Sysname> system-view
[Sysname] ipv6 multicast routing
[Sysname-mrib6] load-splitting source
longest-match (IPv6 MRIB view)
Use longest-match to specify the longest prefix match principle for RPF route selection.
Use undo longest-match to restore the default.
Syntax
longest-match
undo longest-match
Default
Route preference is used for RPF route selection. The route with the highest route preference is used as the RPF route.
Views
IPv6 MRIB view
Predefined user roles
network-admin
Usage guidelines
This command enables the device to use the matching route with the longest prefix as the RPF route.
Examples
# Specify the longest prefix match principle for RPF route selection on the public network.
<Sysname> system-view
[Sysname] ipv6 multicast routing
[Sysname-mrib6] longest-match
mtrace v2 ipv6
Use mtrace v2 ipv6 to trace an IPv6 multicast path through mtrace2.
Syntax
mtrace v2 ipv6 [ vpn-instance vpn-instance-name ] { source-address | group-address } * [ destination address | port number | wait-time time | max-hop count ] * [ verbose ]
Views
Any view
Predefined user roles
network-admin
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command traces an IPv6 multicast path on the public network.
source-address: Specifies an IPv6 multicast source by its IPv6 address.
group-address: Specifies an IPv6 multicast group by its IPv6 address. The value range for this argument is FFxy::/16 (excluding FFx1::/16 and FFx2::/16), where "x" and "y" represent any hexadecimal numbers from 0 to F.
destination address: Specifies the destination address of IPv6 mtrace. The default destination address is FF02::2.
port number: Specifies a UDP port number for IPv6 mtrace, in the range of 1024 to 49151. The default value is 10240.
wait-time time: Specifies the length of time that the client waits for a Reply message. The value range for the time argument is 1 to 65535 seconds and the default value is 10 seconds. If the client does not receive a Reply message within the waiting time, the client initiates a hop-by-hop IPv6 mtrace.
max-hop count: Specifies the maximum number of the hops to be traced. The value range for the count argument is 1 to 255 and the default value is 255. If the maximum number of hops is reached on a device, the device directly sends a Reply message to the client and the mtrace is terminated.
verbose: Displays detailed information about IPv6 mtrace. If you do not specify this keyword, the command displays brief information about IPv6 mtrace.
Usage guidelines
To perform a non-group-specific mtrace, specify an IPv6 multicast source and a destination. The mtrace starts from the destination and ends at the device directly connected to the source.
To perform a non-source-specific mtrace, specify an IPv6 multicast group and a destination. The mtrace starts from the destination and ends at the RP associated with the group.
To perform a source-and-group-specific mtrace, specify both an IPv6 multicast source and an IPv6 multicast group. If you also specify a destination, the mtrace starts from the destination and ends at the device directly connected to the source. If you do not specify a destination, the mtrace starts from the upstream device of the client and ends at the device directly connected to the source.
An IPv6 mtrace process stops if the maximum number of the hops to be traced is reached.
If the client does not receive a Reply message within the waiting time, the client initiates a hop-by-hop mtrace to determine which device on the path encountered an error. It sends a Query message with the hops field set to 1 and waits for a Reply message. If the client receives a Reply message within the waiting time, it sends a Query message with the hops field value increased by 1 and waits for a Reply message. This process continues until the client does not receive a Reply message within the waiting time any more.
Examples
# Use mtrace2 to trace the path along which IPv6 multicast data of group FF1E::1 travels from source 10::7 to destination 50::5 and display brief mtrace information.
<Sysname> mtrace v2 ipv6 10::7 ff1e::1 destination 50::5
Mtrace from 10::7 to 50::5 via group ff1e::1, 255 hops at most, press
CTRL_C to break.
Querying full reverse path...
Hop Local address Protocol Time Fwd code
0 50::1 PIM-SM(OSPF) 50 s NO_ERROR
-1 40::1 PIM-SM(OSPF) 40 s NO_ERROR
-2 30::1 PIM-SM(OSPF) 60 s NO_ERROR
-3 20::1 PIM-SM(OSPF) 55 s NO_ERROR
-4 10::1 PIM-SM(OSPF) 30 s NO_ERROR
Table 12 Command output
Field |
Description |
Hop |
Number of the hop. 0 represents the last hop, -1 represents the hop before the last hop, and so on. |
Local address |
IPv6 address of this hop on the traced path. |
Protocol |
Multicast routing protocol used between this device and the previous-hop device: · PIM-SM. · PIM-DM. Unicast routing protocol used between this device and the previous-hop device: · LOCAL—Direct route. · STATIC ROUTE—Static route. · RIP. · ISIS. · OSPF. · BGP. |
Time |
Length of time used to transmit an mtrace message between this device and the previous-hop device, in seconds. |
Fwd code |
Forwarding code or error code: · NO_ERROR—No error. · WRONG_IF—The interface on which the mtrace message arrives is not in the outgoing interface list of the multicast data. · PRUNE_SENT—This device has sent a prune message to the upstream device. · PRUNE_RCVD—This device has received a prune message from the downstream device. · SCOPED—A multicast border is configured on the incoming interface or outgoing interface of the multicast data. · NO_ROUTE—This device does not have any route for the source or the RP. · WRONG_LAST_HOP—This device is not the expected last-hop device. · REACHED_RP—This device is the RP for the (*, G) multicast data. · RPF_IF—The mtrace message arrived on the RPF interface for the multicast data. · NO_MULTICAST—The mtrace message arrived on an interface that is not enabled with IP multicast. · NO_SPACE—No space is available for inserting a response data block in the packet. |
# Use mtrace2 to trace the path along which IPv6 multicast data of group FF1E::1 travels from source 10::7 to destination 50::5 and display detailed mtrace information.
<Sysname> mtrace v2 ipv6 10::7 ff1e::1 destination 50::5 verbose
Mtrace from 10::7 to 50::5 via group ff1e::1, 255 hops at most, use query
ID 12345, client port 50001, press CTRL_C to break.
Querying full reverse path...
0: Incoming interface ID: 1501
Outgoing interface ID: 1502
Local address: 50::1
Remote address: FE80::A27B:99FF:FECB:207
Input multicast packets: 111
Output multicast packets: 111
Forwarded packets for the (S, G) pair: 22
Multicast protocol in use: PIM-SM
Unicast protocol in use: OSPF
Forwarding code: NO_ERROR
Time used (s): 50
-1: Incoming interface ID: 1601
Outgoing interface ID: 1602
Local address: 40::1
Remote address: FE80::A27B:99FF:FECB:206
Input multicast packets: 111
Output multicast packets: 111
Forwarded packets for the (S, G) pair: 22
Multicast protocol in use: PIM-SM
Unicast protocol in use: OSPF
Forwarding code: NO_ERROR
Time used (s): 50
Table 13 Command output
Field |
Description |
n |
Number of the hop. 0 represents the last hop, -1 represents the hop before the last hop, and so on. |
Incoming interface ID |
Index of the incoming interface of the IPv6 multicast data. |
Outgoing interface ID |
Index of the outgoing interface of the IPv6 multicast data. |
Local address |
IPv6 address of this hop on the traced path. |
Remote address |
IPv6 address of the upstream device. |
Input multicast packets |
Statistics of packets received on the incoming interface of the IPv6 multicast data. |
Output multicast packets |
Statistics of packets forwarded through the outgoing interface of the IPv6 multicast data. |
Forwarded packets for the (S, G) pair |
Statistics of forwarded (S, G) packets. |
Multicast protocol in use |
Multicast routing protocol running on the incoming interface of the multicast data. |
Unicast protocol in use |
Unicast routing protocol running on the incoming interface of the multicast data. |
Forwarding code |
Forwarding code or error code: · NO_ERROR—No error. · WRONG_IF—The interface on which the mtrace message arrives is not in the outgoing interface list of the multicast data. · PRUNE_SENT—This device has sent a prune message to the upstream device. · PRUNE_RCVD—This device has received a prune message from the downstream device. · SCOPED—A multicast border is configured on the incoming interface or outgoing interface of the multicast data. · NO_ROUTE—This device does not have any route for the source or the RP. · WRONG_LAST_HOP—This device is not the expected last-hop device. · REACHED_RP—This device is the RP for the (*, G) multicast data. · RPF_IF—The mtrace message arrived on the RPF interface for the multicast data. · NO_MULTICAST—The mtrace message arrived on an interface that is not enabled with IP multicast. · NO_SPACE—No space is available for inserting a response data block in the packet. |
Time used (s) |
Length of time for transmitting the mtrace message from the previous-hop device to this device. |
Related commands
ipv6 mtrace-service port
reset ipv6 multicast fast-forwarding cache
Use reset ipv6 multicast fast-forwarding cache to clear IPv6 multicast fast forwarding entries.
Syntax
reset ipv6 multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache { { ipv6-source-address | ipv6-group-address } * | all } [ slot slot-number ]
Views
User view
Predefined user roles
network-admin
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command clears IPv6 multicast fast forwarding entries on the public network.
ipv6-source-address: Specifies an IPv6 multicast source address.
ipv6-group-address: Specifies an IPv6 multicast group address. The value range for this argument is FFxy::/16 (excluding FFx1::/16 and FFx2::/16), where "x" and "y" represent any hexadecimal numbers in the range of 0 to F.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command clears IPv6 multicast fast forwarding entries for the MPU.
all: Specifies all IPv6 multicast fast forwarding entries.
Examples
# Clear all IPv6 multicast fast forwarding entries on the public network.
<Sysname> reset ipv6 multicast fast-forwarding cache all
# Clear the IPv6 multicast fast forwarding entry for IPv6 multicast source and group (FE1F:20::2, FF0E::1) on the public network.
<Sysname> reset ipv6 multicast fast-forwarding cache fe1f:20::2 ff0e::1
Related commands
display ipv6 multicast fast-forwarding cache
reset ipv6 multicast forwarding event
Use reset ipv6 multicast forwarding event to clear statistics for IPv6 multicast forwarding events.
Syntax
reset ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding event
Views
User view
Predefined user roles
network-admin
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command clears statistics for the IPv6 multicast forwarding events on the public network.
Examples
# Clear statistics for the IPv6 multicast forwarding events on the public network.
<Sysname> reset ipv6 multicast forwarding event
Related commands
display ipv6 multicast forwarding event
reset ipv6 multicast forwarding-table
Use reset ipv6 multicast forwarding-table to clear IPv6 multicast forwarding entries.
Syntax
reset ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding-table { { ipv6-source-address [ prefix-length ] | ipv6-group-address [ prefix-length ] | incoming-interface { interface-type interface-number } } * | all }
Views
User view
Predefined user roles
network-admin
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command clears IPv6 multicast forwarding entries on the public network.
ipv6-source-address: Specifies an IPv6 multicast source address.
ipv6-group-address: Specifies an IPv6 multicast group address in the range of FFxy::/16, where "x" and "y" represent any hexadecimal numbers in the range of 0 to F.
prefix-length: Specifies the address prefix length. The default value is 128. For an IPv6 multicast group address, the value range for this argument is 8 to 128. For an IPv6 multicast source address, the value range for this argument is 0 to 128.
incoming-interface: Specifies the IPv6 multicast forwarding entries that contain the specified incoming interface.
interface-type interface-number: Specifies an interface by its type and number.
all: Specifies all IPv6 multicast forwarding entries.
Usage guidelines
When you clear an IPv6 multicast forwarding entry, the associated IPv6 multicast routing entry is also cleared.
Examples
# Clear IPv6 multicast forwarding entries for IPv6 multicast group FF0E::1 on the public network.
<Sysname> reset ipv6 multicast forwarding-table ff0e::1
display ipv6 multicast forwarding-table
reset ipv6 multicast routing-table
Use reset ipv6 multicast routing-table to clear IPv6 multicast routing entries.
Syntax
reset ipv6 multicast [ vpn-instance vpn-instance-name ] routing-table { { ipv6-source-address [ prefix-length ] | ipv6-group-address [ prefix-length ] | incoming-interface interface-type interface-number } * | all }
Views
User view
Predefined user roles
network-admin
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command clears IPv6 multicast routing entries on the public network.
ipv6-source-address: Specifies an IPv6 multicast source address.
ipv6-group-address: Specifies an IPv6 multicast group address in the range of FFxy::/16, where "x" and "y" represent any hexadecimal numbers in the range of 0 to F.
prefix-length: Specifies an address prefix length. The default is 128. For an IPv6 multicast group address, the value range for this argument is 8 to 128. For an IPv6 multicast source address, the value range for this argument is 0 to 128.
incoming-interface: Specifies the IPv6 multicast routing entries that contain the specified incoming interface.
interface-type interface-number: Specifies an interface by its type and number.
all: Specifies all IPv6 multicast routing entries.
Usage guidelines
When you clear an IPv6 multicast routing entry, the associated IPv6 multicast forwarding entry is also cleared.
Examples
# Clear IPv6 multicast routing entries for IPv6 multicast group FF03::101 on the public network.
<Sysname> reset ipv6 multicast routing-table ff03::101
Related commands
display ipv6 multicast routing-table