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).
PIM (IPv6) Configuration Commands

PIM (IPv6) Configuration Commands

NOTE:

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

anycast-rp (IPv6)

Function

The anycast-rp command configures an Anycast RP and displays the Anycast-RP view or directly displays the existing Anycast-RP view.

The undo anycast-rp command deletes the configurations of an Anycast RP.

By default, no Anycast RP is configured.

Format

anycast-rp rp-address

undo anycast-rp rp-address

Parameters

Parameter Description Value
rp-address Indicates the Anycast RP address. The value must be a legal IPv6 global unicast IP address in hexadecimal notation.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a traditional PIM-SM (IPv6) domain, all multicast groups map to one RP. When the network is overloaded or traffic concentrates on an RP, the RP may be overburdened. If the RP fails, routes are converged slowly or multicast packets are forwarded over non-optimal paths.

Configuring the Anycast RP in the PIM-SM (IPv6) domain can address this problem. IPv6 routing will automatically select the topologically closest RP for each source and receiver. This releases burdens on RPs, implements RP backup, and optimizes the forwarding paths.

Prerequisites

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

Configuration Impact

If PIM (IPv6) Anycast RP is configured, after an RP receives a Register message, it checks the source address of the Register message. If the Register message is sent by the source's DR, the RP forwards the Register message to Anycast RP peers. If the Register message is sent by an Anycast RP peer, it does not forward the Register message. In such a manner, Anycast RP peers can learn source/group information from each other.

Precautions

  • The Anycast RP address must be the same as that of the elected RP on the current network.

  • Either static or dynamic RPs can be used on the network. Configuring RPs on loopback interfaces is recommended. You need to configure the same RP address on the devices to be deployed with the Anycast RP. If the dynamic RP is used on the network, before configuring an Anycast RP address, run the display pim ipv6 rp-info command to check the address of the RP on the current network.

Example

# Set the Anycast RP address to FC00:0:0:2001::1 in the PIM-IPv6 view and enter the Anycast-RP view.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] anycast-rp fc00:0:0:2001::1
[*HUAWEI-pim6-anycast-rp-fc00:0:0:2001::1]

backoff-interval (IPv6)

Function

The backoff-interval command sets the interval at which a designated forwarder (DF) sends Backoff messages.

The undo backoff-interval command restores the default configuration.

By default, a DF sends Backoff messages at intervals of 1 second.

Format

backoff-interval interval

undo backoff-interval

Parameters

Parameter Description Value
interval

Specifies the interval at which a DF sends Backoff messages.

The value is an integer that ranges from 1 to 20, in seconds.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a Bidir PIM (IPv6) network, the elected DF sends a Backoff message when it receives a superior Offer message. If the DF does not receive any Offer message within the interval for sending the next Backoff message, it sends a Pass message to notify all the multicast devices that a new DF appears. You can use this command to change the interval at which the DF sends Backoff messages.

Prerequisite

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

Precautions

This command has the same function as the pim ipv6 backoff-interval command used in the interface view, except for the applicable view. The configuration on an interface takes precedence over the configuration in the PIM-IPv6 view. If no configuration is performed on an interface, the interface inherits the configuration in the PIM-IPv6 view.

Example

# Set the interval at which the DF sends Backoff messages to 5 seconds in the PIM-IPv6 view.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] backoff-interval 5

bidir-pim (IPv6)

Function

The bidir-pim command enables IPv6 Bidirectional Protocol Independent Multicast (Bidir-PIM).

The undo bidir-pim command disables Bidir-PIM (IPv6).

By default, Bidir-PIM (IPv6) is disabled.

Format

bidir-pim

undo bidir-pim

Parameters

None

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A device can provide the Bidir-PIM (IPv6) service only after Bidir-PIM (IPv6) is enabled. Other Bidir-PIM (IPv6) configurations do not take effect until Bidir-PIM (IPv6) is enabled.

Prerequisites

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

Follow-up Procedure

Bidir-PIM (IPv6) inherits the neighbor discovery mechanism of PIM-SM (IPv6) to reduce protocol complexity. Therefore, after enabling Bidir-PIM (IPv6) globally in the PIM-IPv6 view, run the pim ipv6 sm command on interfaces to enable PIM-SM (IPv6) so that the interfaces can set up PIM (IPv6) neighbor relationships with neighboring devices.

Precautions

A multicast network does not allow routes that are destined for the same group address and generated by different PIM (IPv6) protocols. Therefore, when you enable or disable Bidir-PIM (IPv6), the system displays a message telling you that some IPv6 multicast routes may be deleted. Determine whether multicast services will be affected if IPv6 multicast routing information is deleted.

Example

# Enable Bidir-PIM (IPv6) globally.
<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] bidir-pim
Warning: Some IPv6 multicast routes will be deleted because the PIM mode has been changed.
Related Topics

bsm semantic fragmentation (IPv6)

Function

The bsm semantic fragmentation command enables BSR message fragmentation.

The undo bsm semantic fragmentation command disables BSR message fragmentation.

By default, BSR message fragmentation is not enabled.

Format

bsm semantic fragmentation

undo bsm semantic fragmentation

Parameters

None

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A BSR message carries information about all C-RPs on the network. Therefore, if there is a large number of C-RPs on the network, the length of a BSR message exceeds the MTU of the outgoing interface. As a result, the BSR message cannot be processed and RP election fails. Consequently, multicast services cannot be transmitted normally. In this case, you can enable BSR message fragmentation to ensure that the devices on the network can learn consistent RP information and MDTs can be successfully established.

Prerequisites

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

Configuration Impact

You can also configure IP fragmentation to solve the preceding problem. The difference between IP fragmentation and BSR message fragmentation is as follows:

  • If IP fragmentation is enabled, the protocol layer transmits the entire BSR message up to the IP layer regardless of the length of the BSR message. The BSR message is then fragmented at the IP layer. If one fragment is lost during transmission, the destination cannot parse the entire BSR message. As a result, the destination cannot learn RP information and MDTs cannot be established, which causes a multicast data forwarding failure.

  • If BSR message fragmentation is enabled, the protocol layer directly fragments a long BSR message. If one fragment is lost during transmission, only the information carried in this fragment is lost. As a result, only MDTs corresponding to the information carried in the lost fragments cannot be established. Since the other BSR message fragments can still reach the destination, the corresponding MDTs can be correctly established.

BSR message fragmentation is recommended because it can solve the problem faced by IP fragmentation that all fragments become unavailable due to loss of fragment information.

Precautions

Enable BSR message fragmentation on all devices on the network. If BSR message fragmentation is not enabled on some devices, RP information on these devices is inconsistent with that on other devices and MDTs cannot be established on these devices.

Example

# Enable BSR message fragmentation in the PIM-IPv6 view.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] bsm semantic fragmentation
Related Topics

bsr-policy (IPv6)

Function

The bsr-policy command specifies the range of valid bootstrap router (BSR) addresses so that the device discards BSR messages sent from addresses out of this range. This prevents BSR spoofing.

The undo bsr-policy command restores the default configuration.

By default, the range of BSR addresses is not limited, and all BSR packets are considered valid.

Format

bsr-policy { basic-acl6-number | acl6-name acl6-name }

undo bsr-policy

Parameters

Parameter Description Value
basic-acl6-number Specifies the basic ACL6 number. The ACL6 defines the filtering policy for the range of source addresses of BSR packets. The value is an integer that ranges from 2000 to 2999.
acl6-name acl6-name Specifies the name of a named basic ACL6. The value is a string of 1 to 32 case-sensitive characters except spaces. The value must start with a letter (case-sensitive).

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a PIM-SM network that applies the BSR mechanism, you can configure any switch as a C-BSR to elect the BSR. Once being elected as the BSR, the switch is responsible for advertising RP information in the network. To prevent the valid BSR from being maliciously replaced, use the following measures:

  • Attacking hosts change the RP mapping to spoof the switch by forging BSR packets.

    Solution: Such attacks often occur on edge devices because a BSR packet is a multicast packet with TTL value of 1. As the BSR is inside the network and hosts are outside the network, the switches can perform neighbor check and RPF check on the received BSR packets to prevent the attacks.

  • A switch is controlled by an attacker or an authorized switch is connected to the network. The attacker configures the switch as a C-BSR and makes the switch win the BSR election, so as to obtain the right of advertising RP information in the network.

    Solution: After the switch is configured as a C-BSR, it spreads multicast BSR packets in the network. The BSR packets have a TTL value of 1 and are forwarded hop by hop. As long as the neighboring device does not accept the BSR packets, the packets will not spread in the entire network. The solution is to use the bsr-policy command on every device in the network to specify the valid BSR range. For example, you can configure a policy to allow only switches with addresses FC00:0:0:2001::1/62 and FC00:0:0:2001::2/64 to function as BSRs. Then switches will not accept or forward BSR packets with addresses out of this range.

The two countermeasures mentioned above can partially protect BSRs in the network. If attackers control a valid BSR, it also brings problems to the network.

Prerequisites

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

Configuration Impact

After the bsr-policy command is run, the switch accepts only BSR messages matching the configured policy.

Precautions

The bsr-policy command and the acl ipv6 (system view) command are used together. In the ACL view, you can set the source address range for BSR packets by specifying the source parameter in the rule (basic ACL6 view) command.

Example

# In the PIM-IPv6 view, configure address FC00:0:0:2001::/64 as the valid BSR address range.
<HUAWEI> system-view
[~HUAWEI] acl ipv6 2001
[*HUAWEI-acl6-basic-2001] rule permit source fc00:0:0:2001:: 64
[*HUAWEI-acl6-basic-2001] quit
[*HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] bsr-policy 2001
Related Topics

c-bsr (IPv6)

Function

The c-bsr command configures a C-BSR.

The undo c-bsr command restores the default configuration.

By default, the C-BSR is not configured.

Format

c-bsr ipv6-address [ hash-length [ priority ] ]

undo c-bsr

Parameters

Parameter Description Value
ipv6-address Specifies the global IPv6 unicast address of a C-BSR.
NOTE:

To avoid frequent protocol changes caused by interface flapping, use the loopback interface address as the global IPv6 unicast address of the C-BSR.

The address is a 32-digit hexadecimal number, in the format X:X:X:X:X:X:X:X.
hash-length Specifies the hash mask length of the C-BSR. The mask is used in a hash function to calculate the RP. The value is an integer that ranges from 0 to 128. By default, the value is 126.
priority Specifies a priority of the C-BSR. A larger value indicates a higher priority. The value is an integer ranging from 0 to 255. By default, the value is 0.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

One or more C-BSRs need to be configured in a PIM-SM domain. A BSR is elected from C-BSRs. The BSR is responsible for collecting C-RP information and summarizing C-RP information into an RP-set. The RP-set is then encapsulated in a BootStrap message and advertised to all the devices in the PIM domain.

The process of BSR election is as follows:

  • Each C-BSR considers itself as the BSR of the local PIM-SM domain and uses IPv6 address of this interface as the address of the BSR to send Bootstrap messages.

  • When a C-BSR receives a Bootstrap message from other devices, it compares the BSR in the received Bootstrap message with the current BSR. The BSR with the highest priority is preferred. If BSRs have the same priority, the BSR with a larger IPv6 address is preferred. If the BSR carried in the received Bootstrap message is better than the current BSR, the C-BSR replaces its BSR address with the address of the BSR carried in the received Bootstrap message.

Prerequisites

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

Precautions

If PIM-SM (IPv6) is disabled on an interface, the interface can be configured as a C-BSR but the configuration does not take effect.

Example

# In the PIM-IPv6 view, set the IPv6 address of the C-BSR to FC00:0:0:3001::1.
<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] c-bsr fc00:0:0:3001::1

c-bsr hash-length (IPv6)

Function

The c-bsr hash-length command configures the global hash mask length of a C-BSR.

The undo c-bsr hash-length command restores the default configuration.

By default, the global hash mask length of a C-BSR is 126.

Format

c-bsr hash-length hash-length

undo c-bsr hash-length

Parameters

Parameter Description Value
hash-length Specifies the global hash mask length of a C-BSR. The value is an integer that ranges from 0 to 128.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

During dynamic RP election, if C-RPs have the same interface address mask and priority for a specified multicast group, a hash function needs to be executed to select the RP for the multicast group. The switch performs hash calculation for the group address of G, C-RP address, and hash mask length of the C-RPs with the same priority and compares the hash values. The C-RP with the greatest hash value acts as the RP for G.

The hash mask length is used to adjust the hash calculation result.

Prerequisites

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

Precautions

You can also run the c-bsr ipv6-address hash-length command in the PIM-IPv6 view configure the hash mask length while configuring a C-BSR address. The c-bsr hash-length hash-length command specifies the global hash mask length. If both the two commands are configured, the hash mask length configured by the c-bsr ipv6-address hash-length command takes effect.

Example

# In the PIM-IPv6 view, set the global hash mask length of a C-BSR to 16.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] c-bsr hash-length 16
Related Topics

c-bsr holdtime (IPv6)

Function

The c-bsr holdtime command configures the timeout period during which the C-BSR waits to receive Bootstrap messages sent by the BSR.

The undo c-bsr holdtime command restores the default configuration.

By default, the timeout period during which the C-BSR waits to receive Bootstrap messages sent by the BSR is 130s.

Format

c-bsr holdtime interval

undo c-bsr holdtime

Parameters

Parameter Description Value
interval Specifies the timeout time during which C-BSR waits for the Bootstrap message to be sent by BSR. The value is an integer that ranges from 1 to 214748364, in seconds.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a C-BSR is elected as the BSR, it periodically sends Bootstrap messages carrying its own IPv6 address and the RP-set information. The interval for sending Bootstrap messages is BS_interval, which can be configured using the c-bsr interval command.

Other C-BSRs that fail in the election are suppressed from sending Bootstrap messages and start the timer to monitor the elected BSR. The timeout period of a timer is holdtime, which can be configured using the c-bsr holdtime command.

  • If the C-BSR receives the Bootstrap messages sent by the BSR, the C-BSR refreshes the timer. The C-BSRs that fail in the election also refresh the timeout period of the BSR according to the hold time.

  • If the timer times out, the elected BSR is considered faulty. The C-BSRs that failed the previous election elect a new BSR. Services are not interrupted.

Prerequisites

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

Precautions

In actual application, all C-BSRs in the same PIM domain must use the same BS_interval and holdtime, and BS_interval must be smaller than holdtime. If C-BSRs use different BS_interval or holdtime values or if BS_interval is larger than the holdtime, the BSR changes frequently, causing multicast forwarding errors.

Example

# In the PIM-IPv6 view, set the timeout interval during which the C-BSR waits for the Bootstrap message to be sent by BSR to 150 seconds.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] c-bsr holdtime 150

c-bsr interval (IPv6)

Function

The c-bsr interval command configures the interval at which the BSR continuously sends Bootstrap messages.

The undo c-bsr interval command restores the default interval.

By default, the BSR sends Bootstrap messages at a 60-second interval.

Format

c-bsr interval interval

undo c-bsr interval

Parameters

Parameter Description Value
interval Specifies the interval at which a BSR continuously sends Bootstrap messages. The value is an integer that ranges from 1 to 107374177, in seconds.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a C-BSR is elected as the BSR, the C-BSR periodically sends Bootstrap messages carrying the IPv6 address of the C-BSR and the RP-set information to the network.

The interval for sending Bootstrap messages is BS_interval, which can be configured using the c-bsr interval command.

Other C-BSRs that fail in the election are suppressed from sending Bootstrap messages and start the timer to monitor the BSR. The timeout period of a timer is holdtime, which can be configured using the c-bsr holdtime command. The following applies to the timer:

  • If the C-BSR receives the Bootstrap messages sent by the BSR, the C-BSR refreshes the timer.

  • If the timer times out, the BSR is considered to be faulty. The C-BSRs that fail in the election triggers a new BSR election. Services are not interrupted.

Prerequisites

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

Precautions

In actual application, all C-BSRs in the same PIM domain must use the same BS_interval and holdtime, and BS_interval must be smaller than the holdtime. If C-BSRs use different BS_interval or holdtime values or BS_interval is larger than the holdtime, the BSR changes frequently, causing multicast forwarding errors.

Example

# In the PIM-IPv6 view, set the interval for the C-BSR to continuously send Bootstrap messages to 30 seconds.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] c-bsr interval 30

c-bsr priority (IPv6)

Function

The c-bsr priority command configures the global C-BSR priority.

The undo c-bsr priority command restores the default configuration.

By default, the global C-BSR priority is 0.

Format

c-bsr priority priority

undo c-bsr priority

Parameters

Parameter Description Value
priority Specifies the global priority of the C-BSR. The value is an integer that ranges from 0 to 255. A larger value indicates a higher priority.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When multiple C-BSRs participate in the BSR election in the PIM-SM domain, the following situations occur:

  • The switch with the highest priority wins in the BSR election.

  • In the case of the same priority, the switch with the largest IPv6 address wins in the BSR election.

To enable a C-BSR to function as the BSR, you can run the c-bsr priority command to increase the priority value of the C-BSR.

Prerequisites

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

Precautions

You can also run the c-bsr ipv6-address hash-length priority command in the PIM-IPv6 view to set the C-BSR priority while configuring a C-BSR. The c-bsr priority priority command sets the global priority. When both the two commands are configured, the priority configured by the c-bsr ipv6-address hash-length priority command takes effect.

Example

# In the PIM-IPv6 view, set the global C-BSR priority to 5.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] c-bsr priority 5
Related Topics

c-rp (IPv6)

Function

The c-rp command configures the switch to advertise itself as a C-RP to the BSR.

The undo c-rp command restores the default configuration.

By default, no C-RP is configured.

Format

c-rp ipv6-address [ advertisement-interval adv-interval | group-policy { basic-acl6-number | acl6-name acl6-name } | holdtime hold-interval | priority priority ] * [ bidir ]

undo c-rp ipv6-address

Parameters

Parameter Description Value
ipv6-address Specifies the global IPv6 unicast address of a C-RP.
NOTE:

To avoid frequent protocol changes caused by interface flapping, use the loopback interface address as the global IPv6 unicast address of the C-RP.

The address is a 32-digit hexadecimal number, in the format X:X:X:X:X:X:X:X.
advertisement-interval adv-interval Specifies the interval at which the C-RP sends Advertisement messages. The value is an integer that ranges from 1 to 65535, in seconds. By default, the value is 60 seconds.
group-policy basic-acl6-number Specifies the range of multicast groups that the C-RP serves. The range is limited through the ACL6. basic-acl6-number specifies the number of the basic ACL6 used to limit the range of multicast groups that the C-RP serves. The value is an integer that ranges from 2000 to 2999.
acl6-name acl6-name Specifies the name of a named basic ACL6. The value is a string of 1 to 32 case-sensitive characters except spaces. The value must start with a letter (case-sensitive).
holdtime hold-interval Specifies the holdtime period during which the C-RP sends Advertisement messages. hold-interval specifies the time remaining before the C-RP sends Advertisement messages. The value is an integer that ranges from 1 to 65535, in seconds. By default, the value is 150 seconds.
priority priority Specifies the priority of a C-RP. The value of priority indicates the priority of a C-RP. The value is an integer that ranges from 0 to 255. By default, the value is 192. The greater the value is, the lower the priority is.
bidir Configures the C-RP to serve the Bidir-PIM (IPv6) protocol. -

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

An RP is the core of a PIM-SM (IPv6) domain, and therefore a C-RP must be able to communicate with the other devices in the PIM-SM (IPv6) domain. It is recommended that you configure a C-RP on the device that aggregates multicast traffic and reserve enough bandwidth between this device and each of the other devices in the PIM-SM (IPv6) domain.

The rules used to elect an RP from multiple C-RPs are as follows:

  1. The C-RP with the longest mask length of the served group address range matching the multicast group that users have joined wins.

  2. The C-RP with highest priority wins.

  3. In case of the same priority, hash functions are operated. The C-RP with the greatest calculated value wins.

  4. If all the preceding factors are the same, the C-RP with the largest IPv6 address wins.

Prerequisites

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

Configuration Impact

The group-policy { basic-acl6-number | acl6-name acl6-name }, priority priority, holdtime hold-interval and advertisement-interval adv-interval set by using the command take precedence over the values of the global parameters configured in the PIM-IPv6 view because this command specifies an interface address. If this command is run several times on the same interface, only the latest configuration is valid.

Precautions

  • If PIM-SM (IPv6) is disabled on an interface, the interface can be configured as a C-RP but the configuration does not take effect.

  • group-policy { basic-acl6-number | acl6-name acl6-name } specifies a group range. All permitted group ranges will be advertised as the ranges of groups that the RP serves. If no group range is specified for a C-RP or a C-RP is configured to serve all addresses, the C-RP serves all multicast groups.

  • If the C-RP needs to serve Bidir-PIM (IPv6), specify the bidir keyword in the command.

Example

# In the PIM-IPv6 view, configure an interface with the IPv6 address FC00:0:0:2001::1 as a C-RP of the PIM-SM (IPv6) domain.
<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] c-rp fc00:0:0:2001::1
# In the PIM-IPv6 view, configure an interface with the IPv6 address FC00:0:0:2001::1 as a C-RP of the Bidir-PIM (IPv6) domain.
<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] c-rp fc00:0:0:2001::1 bidir

c-rp advertisement-interval (IPv6)

Function

The c-rp advertisement-interval command sets the interval at which a C-RP sends Advertisement messages.

The undo c-rp advertisement-interval command restores the default interval.

By default, a C-RP sends Advertisement messages at an interval of 60 seconds.

Format

c-rp advertisement-interval interval

undo c-rp advertisement-interval

Parameters

Parameter Description Value
interval Specifies the interval at which a C-RP sends Advertisement messages. The value ranges from 1 to 65535, in seconds.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

All C-RPs in a PIM-SM domain periodically send Advertisement messages to the same BSR. The BSR can collect the integrated RP-Set.

The c-rp advertisement-interval command sets the interval at which a C-RP sends Advertisement messages to the BSR.

Prerequisites

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

Precautions

You can also run the c-rp ipv6-address advertisement-interval interval command in the PIM-IPv6 view to configure the advertisement interval while configuring a C-RP. The c-rp advertisement-interval interval command specifies the global interval. If both the commands are configured, the interval configured by the c-rp ipv6-address advertisement-interval interval command takes effect.

Example

# In the PIM-IPv6 view, set the interval at which a C-RP sends Advertisement messages to 30s.
<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] c-rp advertisement-interval 30

c-rp holdtime (IPv6)

Function

The c-rp holdtime command configures the holdtime for a received Advertisement message on a BSR.

The undo c-rp holdtime command restores the default holdtime.

By default, the holdtime for a received Advertisement message is 150 seconds.

Format

c-rp holdtime hold-interval

undo c-rp holdtime

Parameters

Parameter Description Value
hold-interval Specifies the timeout period for a BSR to wait the Advertisement message from a C-RP. The value ranges from 1 to 65535, in seconds.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When hold-interval is set on a C-RP, the C-RP encapsulates hold-interval in an Advertisement message and sends it to the BSR. The BSR obtains this hold-interval from the message and starts the timer. If the BSR receives no Advertisement message from the C-RP within the timeout period, the BSR regards the C-RP invalid or unreachable.

Prerequisites

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

Precautions

You can also run the c-rp ipv6-address holdtime hold-interval command in the PIM-IPv6 view to configure the advertisement message holdtime while configuring a C-RP. The c-rp holdtime hold-interval configures the global holdtime for Advertisement messages. If both the two commands are configured, the holdtime configured by the c-rp ipv6-address holdtime hold-interval command takes effect.

Example

# In the PIM-IPv6 view, set the holdtime for a received Advertisement message to 100s.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] c-rp holdtime 100

c-rp priority (IPv6)

Function

The c-rp priority command configures the global C-RP priority.

The undo c-rp priority command restores the default configuration.

By default, the global C-RP priority is 192.

Format

c-rp priority priority

undo c-rp priority

Parameters

Parameter Description Value
priority Specifies the global C-RP priority. The value is an integer that ranges from 0 to 255. A larger value indicates a lower priority.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The following rules are used to elect an RP from multiple C-RPs:

  • The C-RP with the interface address that has the longest mask wins.

  • The C-RP with highest priority wins.

  • In case of the same priority, hash functions are operated. The C-RP with the greatest calculated value wins.

  • If all the preceding factors are the same, the C-RP with the largest IPv6 address wins.

To enable a C-RP to function as an RP, you can run the c-rp priority command to increase the priority of the C-RP.

Prerequisites

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

Precautions

You can also run the c-rp ipv6-address priority priority command in the PIM-IPv6 view to configure the C-RP priority while configuring a C-RP. The c-rp priority priority command specifies the global C-RP priority. If both the two commands are configured, the priority configured by the c-rp ipv6-address priority priority command takes effect.

Example

# In the PIM-IPv6 view, set the global C-RP priority to 5.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] c-rp priority 5
Related Topics

c-rp policy (IPv6)

Function

The c-rp policy command limits the range of valid C-RP addresses and the range of the multicast addresses served by a C-RP. The BSR drops the C-RP messages with addresses out of the specified range to protect valid C-RPs.

The undo c-rp policy command restores the default configuration.

By default, the BSR does not limit the range of valid C-RP addresses and the range of the multicast groups served by a C-RP. The BSR considers all the received C-RP messages valid.

Format

c-rp policy { advanced-acl6-number | acl6-name acl6-name }

undo c-rp policy

Parameters

Parameter Description Value
advanced-acl6-number Specifies the number of an advanced ACL. The ACL defines the range of the C-RP addresses and the range of the group addresses served by a C-RP. The value is an integer that ranges from 3000 to 3999.
acl6-name acl6-name Specifies the name of a named advanced ACL. The value is a string of 1 to 32 case-sensitive characters except spaces. The value must start with a letter (case-sensitive).

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a PIM SM network that uses the BSR mechanism, any switch can be configured as a C-RP to serve the multicast groups in a specified range. Each C-RP sends its information to the BSR in unicast mode. The BSR summarizes all received C-RP information as the RP-set, and floods it through BSR messages on the entire network. The local switch then works out the RP serving a specific multicast group address range according to the RP-set.

To protect valid C-RP from being spoofed, configure c-rp policy on BSR switches to limit the range of valid C-RP addresses and the range of multicast group addresses served by a C-RP. Configure the same filtering rule on each C-BSR because any C-BSR can become the BSR.

Prerequisites

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

Configuration Impact

The c-rp policy command and the acl ipv6 (system view) command are used together. In the ACL6 view, you can set the valid source address range for the C-RP by specifying the source parameter in the rule (advanced ACL6 view) command. You can set the address range of multicast groups that are served by specifying the destination parameter in the rule (advanced ACL6 view) command.

If an ACL rule is specified but no C-RP address range is set, all C-RP messages are denied.

Example

# Configure a C-RP policy on the C-BSR, which allows only the C-RP with the address FC00:0:0:2001::1/128 and allows the C-RP to serve only the multicast groups FF13::101/128.

<HUAWEI> system-view
[~HUAWEI] acl ipv6 number 3100
[*HUAWEI-acl6-advance-3100] rule permit ipv6 source fc00:0:0:2001::1 128 destination ff13::101 128
[*HUAWEI-acl6-advance-3100] quit
[*HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] c-rp policy 3100
# Use a named IPv6 ACL to configure a C-RP policy on the C-BSR: only FC00:0:0:2001::1/128 can function as the C-RP, and the C-RP is allowed to service only the multicast groups in the range of FF13::101/128.
<HUAWEI> system-view
[~HUAWEI] acl ipv6 name myacl6
[*HUAWEI-acl6-advance-myacl6] rule permit ipv6 source fc00:0:0:2001::1 128 destination ff13::101 128
[*HUAWEI-acl6-advance-myacl6] quit
[*HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] c-rp policy acl6-name myacl6
Related Topics

display multicast ipv6 global statistics

Function

The display multicast ipv6 global statistics command displays global IPv6 PIM entry restriction and statistics.

Format

display multicast ipv6 global { pim sm | bidir-pim | all } statistics

Parameters

Parameter Description Value
pim sm Displays PIM entry restriction and statistics in IPv6 PIM-SM/SSM mode. -
bidir-pim Displays PIM entry restriction and statistics in IPv6 BIDIR-PIM mode. -
all Displays PIM entry restriction and statistics in all IPv6 modes. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To check global IPv6 PIM entry restriction and statistics, run the display multicast ipv6 global statistics command.

Example

# Display IPv6 PIM entry restriction and statistics in all IPv6 modes.

<HUAWEI> display multicast ipv6 global all statistics
------------------------------------------------------------------
PIM-SM        Number        Limit         Threshold(Upper%/Lower%)
------------------------------------------------------------------
(*, G)        0             --            --                      
(S, G)        0             1000          80/70                   
------------------------------------------------------------------
------------------------------------------------------------------
BIDIR-PIM     Number        Limit         Threshold(Upper%/Lower%)
------------------------------------------------------------------
(*, G)        0             3000          90/85                   
------------------------------------------------------------------
Table 10-40  Description of the display multicast ipv6 global all statistics command output

Item

Description

PIM-SM

Type of IPv6 PIM-SM entry for which a limit takes effect. The value can be (*, G) or (S, G).

BIDIR-PIM

Type of IPv6 BIDIR-PIM entry for which a limit takes effect. The value can be (*, G).

Number

Number of created PIM entries.

Limit

Limit on the number of PIM entries. If no limit is set, -- is displayed.

Threshold(Upper%/Lower%)

Upper and lower thresholds for PIM entry alarms. If they are not set, -- is displayed.

display pim ipv6 bfd session

Function

The display pim ipv6 bfd session command displays information about PIM IPv6 BFD sessions.

Format

display pim ipv6 bfd session statistics

display pim ipv6 bfd session [ interface interface-type interface-number | neighbor ipv6-link-local-address ]*

Parameters

Parameter Description Value
statistics Displays statistics about PIM IPv6 BFD sessions. -
interface interface-type interface-number Displays information about PIM IPv6 BFD sessions on a specified interface. interface-type interface-number specifies the type and number of an interface. -
neighbor ipv6-link-local-address Displays information about PIM IPv6 BFD sessions on a specified neighbor. ipv6-link-local-address specifies the link-local address of a PIM neighbor. The value ranges from FE80:: to FE80:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF, in hexadecimal notation.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

After PIM BFD (IPv6) is configured to detect the status of PIM neighbors, a PIM IPv6 BFD session needs to be established. The display pim ipv6 bfd session command can be used to view statistics about and configurations of PIM IPv6 BFD sessions.

Precautions

The two ends of a BFD session negotiate the actual interval at which PIM IPv6 BFD packets are sent, interval at which PIM IPv6 BFD packets are received, and detection period based on the following negotiation mechanisms:
  • The formula used to calculate the interval for sending PIM IPv6 BFD packets and the formula used to calculate the interval for receiving PIM IPv6 BFD packets are as follows:
    • Interval for sending PIM IPv6 BFD packets = Max (Local min-tx-interval, Remote min-rx-interval)
    • Interval for receiving PIM IPv6 BFD packets = Max (Remote min-tx-interval, Local min-rx-interval)
  • The formula used to calculate the detection period is as follows:
    • Detection period = Remote detect-multiplier x Max (Remote min-tx-interval, Local min-rx-interval)

Example

# Display information about PIM IPv6 BFD sessions on all interfaces.

<HUAWEI> display pim ipv6 bfd session
 VPN-Instance: public net
 Total 1 BFD session Created

 Vlanif100 (FE80::7): Total 1 BFD session Created

 Neighbor        ActTx(ms) ActRx(ms) ActMulti Local/Remote State
 FE80::6         200       300       4         8211/8214   Up

# Display information about the PIM IPv6 BFD session on VLANIF 100.

<HUAWEI> display pim ipv6 bfd session interface vlanif 100
 VPN-Instance: public net

 Vlanif100 (FE80::7): Total 1 BFD session Created

 Neighbor        ActTx(ms) ActRx(ms) ActMulti Local/Remote State
 FE80::6         200       300       4         8211/8214   Up
Table 10-41  Description of the display pim ipv6 bfd session command output

Item

Description

Total 1 BFD session Created

Total number of established PIM IPv6 BFD sessions.

Vlanif100 (FE80::7)

PIM interface name (Link-local address).

Neighbor

Link-local address of a PIM neighbor.

ActTx(ms)

Actual interval for sending PIM IPv6 BFD packets.

ActRx(ms)

Actual interval for receiving PIM IPv6 BFD packets.

ActMulti

Actual detection multiplier of PIM IPv6 BFD packets.

Local/Remote

Local/remote discriminator of a PIM IPv6 BFD session.

State

Status of a PIM IPv6 BFD session:
  • Up: indicates that the BFD session is set up successfully and detection packets are periodically exchanged.

  • Init: indicates that the local end can communicate with the remote end and wants the session status to be Up.

  • Admin down: indicates that the session is in the administratively Down state (The shutdown command is run in the BFD session view).

  • Down: indicates that the BFD session is down.

# Display statistics about PIM IPv6 BFD sessions.

<HUAWEI> display pim ipv6 bfd session statistics
 VPN-Instance: public net
  Total 1 PIM BFD session in this instance.

   Total 1 PIM BFD session up.
   Total 0 PIM BFD session down.
Table 10-42  Description of the display pim ipv6 bfd session statistics command output

Item

Description

Total 1 PIM BFD session in this instance

Total number of PIM IPv6 BFD session.

Total 1 PIM BFD session up

Total number of PIM IPv6 BFD sessions in the Up state.

Total 0 PIM BFD session down

Total number of PIM IPv6 BFD sessions in the Down state, that is, the total number of PIM IPv6 BFD sessions minus the number of PIM IPv6 BFD sessions in the Up state.

display pim ipv6 bsr-info

Function

The display pim ipv6 bsr-info command displays the BSRs in a PIM-SM (IPv6) domain.

Format

display pim ipv6 bsr-info

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can use this command to check BSR configuration on a PIM-SM (IPv6) network.

Example

# Display information about BSR in the current PIM-SM (IPv6) domain. If the switch is configured with C-BSR, information about the elected BSR and C-BSR is displayed.

<HUAWEI> display pim ipv6 bsr-info
VPN-Instance: public net
 Elected AdminScoped BSR Count: 0
 Elected BSR Address: FC00:0:0:2004::2
     Priority: 0
     Hash mask length: 128
     State: Elected
     Uptime: 00:00:07
     Next BSR message scheduled at: 00:00:53
     C-RP Count: 0
 Candidate AdminScoped BSR Count: 0
 Candidate BSR Address: FC00:0:0:2004::2
     Priority: 0
     Hash mask length: 128
     State: Elected
     Wait to be BSR: 0
Table 10-43  Description of the display pim ipv6 bsr-info command output

Item

Description

Elected AdminScoped BSR Count

number of elected AdminScoped BSRs.

Elected BSR Address

IPv6 address of the elected BSR.

Priority

Priority of the BSR.

Hash mask length

Mask length in the RP hash calculation.

State

Status of the BSR.
  • Accept Preferred: No C-BSR is configured on the device and another device functions as a BSR and does not time out.

  • Accept Any: No C-BSR is configured on the device and the current BSR times out (applicable to the situation that a BSR administrative domain is set)

  • Candidate: A C-BSR is configured on a device and another device functions as a BSR.

  • Pending: The device changes from the non-BSR state to the BSR state or a C-BSR is configured on the device and the current BSR times out.

  • Elected: The device is elected as the BSR.

Uptime

Period during which the BSR exists.

Next BSR message scheduled at

Period after which the next BSR message is sent. BSR messages are sent only when the timer maintained by the elected BSR times out.

C-RP Count

Number of RPs learned through the BSR.

Candidate AdminScoped BSR Count

Number of AdminScoped C-BSRs.

Candidate BSR Address

IPv6 Address of the C-BSR.

Wait to be BSR

Whether the current C-BSR is valid. The values are as follows:
  • 0: The current C-BSR is valid. The current C-BSR takes part in the BSR election.

  • 1: The current C-BSR is invalid. The current C-BSR does not take part in the BSR election.

When the number of C-BSRs configured on the switch exceeds the threshold, the value is 1.

display pim ipv6 claimed-route

Function

The display pim ipv6 claimed-route command displays the unicast routing information used by PIM (IPv6).

Format

display pim ipv6 claimed-route [ ipv6-source-address ]

Parameters

Parameter Description Value
ipv6-source-address Specifies the IPv6 address of a multicast source. The address is in hexadecimal format.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display pim ipv6 claimed-route command displays the unicast routes used by PIM (IPv6), such as the RPF neighbors, detailed information about interfaces, route types, and route selection policy.

Example

# Display the unicast route of multicast source FC00:0:0:2001::2.

<HUAWEI> display pim ipv6 claimed-route fc00:0:0:2001::2
VPN-Instance: public net
RPF information about: FC00:0:0:2001::2 in PIM-SM routing table
    RPF interface: Vlanif100, RPF neighbor: FE80::A01:100:1
    Referenced route/mask: FC00:0:0:2001::/64
    Referenced route type: igp
    RPF-route selecting rule: preference-preferred
    The (S, G) or (*, G) list dependent on this route entry
    (FC00:0:0:2001::2, FF03::1)
Table 10-44  Description of the display pim ipv6 claimed-route command output

Item

Description

RPF information about: FC00:0:0:2001::2 in PIM-SM routing table

RPF routing information with the source address of FC00:0:0:2001::2 in the PIM-SM (IPv6) routing table

RPF interface

RPF interface in a routing entry.

RPF neighbor

RPF neighbor in a routing entry.

Referenced route/mask

Route/mask used by PIM.

Referenced route type

Type of a route.

RPF-route selecting rule

Preferred rule for selecting the RPF-route.

The (S, G) or (*, G) list dependent on this route entry

List of multicast entries based on RPF routes.

display pim ipv6 control-message counters

Function

The display pim ipv6 control-message counters command displays the number of sent and received PIM (IPv6) control messages.

Format

display pim ipv6 control-message counters message-type { probe | register | register-stop | crp }

display pim ipv6 control-message counters [ message-type { assert | hello | join-prune | bsr | backoff | offer | pass | win } | interface interface-type interface-number ] *

Parameters

Parameter Description Value
message-type Indicates the types of PIM control message. -
probe Indicates the Probe message. -
register Indicates the Register message. -
register-stop Indicates the Register-stop message. -
crp Indicates the C-RP message. -
assert Indicates the Assert message. -
hello Indicates the Hello message. -
join-prune Indicates the Join-prune message. -
bsr Indicates the BSR message. -
backoff Indicates the Backoff message. -
offer Indicates the Offer message. -
pass Indicates the Pass message. -
win Indicates the Win message. -
interface interface-type interface-number Indicates the type and number of an interface. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

When multicast forwarding fails on a PIM (IPv6) network, run the display pim control-message counters command to view statistics about protocol packets. The command output helps you locate faults.

Example

# Display the number of PIM (IPv6) control messages that were sent and received on the device.
<HUAWEI> display pim ipv6 control-message counters
 VPN-Instance: public net
 Register* - Register Anycast-RP, Probe* - Probe Anycast-RP
 ----------------------------------------------------------------------------
 PIM global control-message counters:
 MessageType      Received         Sent             Invalid          Filtered
 Register         0                0                0                0
 Register-Stop    0                0                0                0
 Probe            0                0                0                0
 C-RP             0                0                0                0
 Register*        0                0                0                0
 Probe*           0                0                0                0

 PIM control-message counters for interface: Vlanif100
 MessageType      Received         Sent             Invalid          Filtered
 Assert           0                0                0                0
 Hello            96               583              0                0
 Join-prune       0                0                0                0
 BSR              0                210              0                0
 Offer            0                0                0                0
 Backoff          0                0                0                0
 Win              0                0                0                0
 Pass             0                0                0                0
Table 10-45  Description of the display pim ipv6 control-message counters command output

Item

Description

PIM global control-message counters

Number of PIM control messages in the public network.

Message Type

Type of the control message.

Received

Number of control messages received by the current interface.

Sent

Number of control messages sent by the current interface.

Invalid

Number of invalid control packets.

Filtered

Number of control messages filtered out by the current interface.

Register

Number of Register messages.

Register-Stop

Number of Register-Stop messages.

Probe

Number of Probe messages.

C-RP

Number of Advertisement messages.

Assert

Number of Assert messages.

Hello

Number of Hello messages.

Join-prune

Number of Join/Prune messages.

BSR

Number of Bootstrap messages.

Register*

Number of Register messages for anycast RP.

Probe*

Number of Probe messages for anycast RP.

Offer

Number of Offer messages.

Backoff

Number of Backoff messages.

Win

Number of Win messages.

Pass

Number of Pass messages.

display pim ipv6 df-info

Function

The display pim ipv6 df-info command displays information about the DFs on the device.

Format

display pim ipv6 df-info [ rp rp-address | interface interface-type interface-number | verbose ] *

Parameters

Parameter Description Value
rp rp-address Displays the DF information of a specified RP. The address is a 32-digit hexadecimal number, in the format X:X:X:X:X:X:X:X.
interface interface-type interface-number Displays the DF information of a specified interface. -
verbose Displays the detailed DF information. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None

Example

# Display the DF information on the device.

<HUAWEI> display pim ipv6 df-info
 VPN-Instance: public net
 Total Number of DF = 2

 RP: FC00:0:0:1::1
 Interface           DF-Address                       DF-Uptime     Rpf-Interface
 Vlanif100           FE80::3ABA:4100:1156:6802(local) 01:06:27      N
 Vlanif200           -                                -             Y

# Display the DF information of VLANIF100.

<HUAWEI> display pim ipv6 df-info interface vlanif 100
VPN-Instance: public net
 Total Number of DF on this interface = 1

 RP: FC00:0:0:1::1
 Interface           DF-Address                       DF-Uptime     Rpf-Interface
 Vlanif100           FE80::3ABA:4100:1156:6802(local) 01:07:38      N

# Display the detailed DF information.

<HUAWEI> display pim ipv6 df-info verbose
 VPN-Instance: public net

 RP: FC00:0:0:1::1
     Interface: Vlanif100
                DF_Address: FE80::3ABA:4100:1156:6802(local)
                DF_Uptime: 01:08:20
                DF_Pref: 0
                DF_Metric: 0
                State: WIN
                Pref: 0
                Metric: 0
                RPF: N

     Interface: Vlanif200
                DF_Address: -
                DF_Uptime: -
                DF_Pref: -
                DF_Metric: -
                State: LOSE
                Pref: 0
                Metric: 0
                RPF: Y
Table 10-46  Description of the display pim ipv6 df-info command output

Item

Description

RP

RP address.

Interface

Type and number of an interface.

DF-Address

DF address, which may not be the local interface address. The DF address marked with local is the local interface address.

DF-Uptime

Time elapsed since a DF has been elected.

Rpf-Interface

Whether an interface is an RPF interface.
  • Y: yes
  • N: no

DF_Pref

A DF's route preference to the RP. The DF may not be the local device.

DF_Metric

A DF's route metric to the RP. The DF may not be the local device.

State

DF election state. The value can be:

  • WIN: The DF has won the DF election.
  • LOSE: The DF has lost the DF election.
  • BACKOFF: The DF received an Offer message with better routing information.
  • OFFER: The interface enters the DF election offer state.

Pref

The local device's route preference to the RP.

Metric

The local device's route metric to the RP.

RPF

Whether an interface is an RPF interface.
  • Y: yes
  • N: no

display pim ipv6 interface

Function

The display pim ipv6 interface command displays information about PIM (IPv6) on an interface.

Format

display pim ipv6 interface [ interface-type interface-number | up | down ] [ verbose ]

Parameters

Parameter Description Value
interface-type interface-number Indicates the type and number of an interface. -
up Indicates that the IPv6 status is Up on the PIM interface. -
down Indicates that the IPv6 status is Down on the PIM interface. -
verbose Indicates detailed information about a PIM (IPv6) interface. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

An interface enabled with PIM (IPv6) is called a PIM (IPv6) interface. The display pim ipv6 interface command is used to display information about PIM (IPv6) interfaces, including status of the PIM (IPv6) interface, the number of PIM (IPv6) neighbors, interval at which Hello messages are sent, DR priority, and DR address.

Example

# Display PIM (IPv6) information on VLANIF100.
<HUAWEI> display pim ipv6 interface vlanif 100
 VPN-Instance: public net
 Interface           State NbrCnt HelloInt   DR-Pri     DR-Address
 Vlanif100            up    0      30         1         FE80::2E0:3FFF:FE27:AE01(local)
Table 10-47  Description of the display pim ipv6 interface command output

Item

Description

Interface

Name of the PIM (IPv6) interface.

State

Status of the PIM (IPv6) interface, up or down.

NbrCnt

Number of PIM (IPv6) neighbors on the interface.

HelloInt

Interval for sending Hello messages, in seconds.

DR-Pri

DR priority.

DR-Address

DR address.

# Display detailed information about PIM (IPv6) on VLANIF100.

<HUAWEI> display pim ipv6 interface vlanif 100 verbose
 VPN-Instance: public net
 Interface: Vlanif100, FE80::2E0:3FFF:FE27:AE01
     PIM version: 2
     PIM mode: Sparse
     PIM state: up
     PIM DR: FE80::2E0:3FFF:FE27:AE01 (local)
     PIM DR Priority (configured): 1
     PIM neighbor count: 0
     PIM hello interval: 30 s
     PIM LAN delay (negotiated): 500 ms
     PIM LAN delay (configured): 500 ms
     PIM hello override interval (negotiated): 2500 ms
     PIM hello override interval (configured): 2500 ms
     PIM Silent: disabled
     PIM neighbor tracking (negotiated): disabled
     PIM neighbor tracking (configured): disabled
     PIM generation ID: 0x18FF94EC
     PIM require-GenID: disabled
     PIM hello hold interval: 105 s
     PIM assert hold interval: 180 s
     PIM triggered hello delay: 5 s
     PIM J/P interval: 60 s
     PIM J/P hold interval: 210 s
     PIM BSR domain border: disabled
     PIM BFD: disabled
     PIM dr-switch-delay timer : not configured
     PIM offer-interval: 100 ms
     PIM election-robust-count: 3
     PIM backoff-interval: 1 s
     Number of routers on link not using DR priority: 0
     Number of routers on link not using LAN delay: 0
     Number of routers on link not using neighbor tracking: 1
     ACL of PIM neighbor policy: myacl6
     ACL of PIM ASM join policy: 2000
     ACL of PIM SSM join policy: -
     ACL of PIM join policy: -
     PIM ipsec: disabled
Table 10-48  Description of the display pim ipv6 interface verbose command output

Item

Description

PIM version

Version number of PIM (IPv6) enabled on the interface.

PIM mode

PIM mode.

PIM state

Status of the PIM (IPv6) interface, up or down.

PIM DR

DR address on the interface.

PIM DR Priority (configured)

Configured DR priority on the interface.

PIM neighbor count

Number of PIM (IPv6) neighbors on the interface.

PIM hello interval

Interval for sending Hello messages.

PIM LAN delay (negotiated)

Negotiated delay for transmitting packets on the interface.

PIM LAN delay (configured)

Configured delay for transmitting packets on the interface.

PIM hello override interval (negotiated)

Negotiated override interval on the interface.

PIM hello override interval (configured)

Configured override interval on the interface.

PIM Silent

Whether the PIM Silent (IPv6) function is enabled on the interface.

PIM neighbor tracking (negotiated)

Whether the PIM (IPv6) neighbor tracking function is enabled on the interface after negotiation.

PIM neighbor tracking (configured)

Whether the PIM (IPv6) neighbor tracking function is configured on the interface.

PIM generation ID

Generation ID option on the interface.

PIM require-GenID

Whether the function of rejecting the Hello messages without the Generation ID option is enabled.

PIM hello hold interval

Interval for the receiver of the Hello message to keep its neighbor reachable.

PIM assert hold interval

Interval for sending Assert messages.

PIM triggered hello delay

Maximum random delay for triggering Hello messages.

PIM J/P interval

Interval for the interface to send Join/Prune messages.

PIM J/P hold interval

Period for holding the Join/Prune status on the interface.

PIM BSR domain border

Whether the BSR domain border is configured on the interface.

PIM BFD

Whether PIM BFD (IPv6) is enabled.

PIM dr-switch-delay timer

DR switching delay.

PIM offer-interval

Interval at which the interface sends Offer messages.

This field is displayed only when Bidir-PIM (IPv6) is enabled.

PIM election-robust-count

DF election robustness variable on the interface.

This field is displayed only when Bidir-PIM (IPv6) is enabled.

PIM backoff-interval

Interval between a better Offer message received on the interface and a Pass message sent from the interface.

This field is displayed only when Bidir-PIM (IPv6) is enabled.

Number of routers on link not using DR priority

Number of switches that do not use DR priority in all the network segments connected to the interface.

Number of routers on link not using LAN delay

Number of switches that do not use LAN delay in all the network segments connected to the interface.

Number of routers on link not using neighbor tracking

Number of switches that are not enabled with the neighbor tracing function in the network segment where the interface resides.

ACL of PIM neighbor policy

Neighbor filtering policy configured on the interface.

ACL of PIM ASM join policy

ASM Join information filtering policy configured on the interface.

ACL of PIM SSM join policy

SSM Join information filtering policy configured on the interface.

ACL of PIM join policy

Join information filtering policy configured on the interface.

PIM ipsec

Whether PIM IPSec (IPv6) is configured in the PIM-IPv6 view or interface view, and the SA policy name if PIM IPSec (IPv6) is configured. The value can be:
  • PIM ipsec: enabled(sa-name: sa1)

    Security association sa1 has been configured to authenticate all PIM (IPv6) protocol packets using the ipsec sa (PIM-IPv6 view) command in the PIM-IPv6 view or the pim ipv6 ipsec sa command in the interface view. If the SA is configured in the interface view, the configuration on the interface is displayed. Otherwise, the configuration in the PIM-IPv6 view is displayed.

  • PIM hello ipsec: enabled(sa-name: sa1)

    Security association sa1 has been configured to authenticate only PIM Hello (IPv6) packets using the hello ipsec sa (IPv6) command in the PIM-IPv6 view or the pim ipv6 hello ipsec sa command in the interface view. If the SA is configured in the interface view, the configuration on the interface is displayed. Otherwise, the configuration in the PIM-IPv6 view is displayed.

  • PIM ipsec: disabled

    PIM IPSec (IPv6) is not configured in the PIM-IPv6 view or interface view.

display pim ipv6 invalid-packet

Function

The display pim ipv6 invalid-packet command displays statistics about invalid PIM (IPv6) messages received by a device and details of these messages.

Format

display pim ipv6 invalid-packet [ interface interface-type interface-number | message-type { assert | bsr | hello | join-prune | offer | backoff | win | pass } ] *

display pim ipv6 invalid-packet message-type { crp | register | register-stop }

display pim ipv6 invalid-packet [ packet-number ] verbose

Parameters

Parameter Description Value
interface interface-type interface-number Displays statistics about invalid PIM (IPv6) messages received by a specified interface. interface-type interface-number specifies the interface type and interface number. -
message-type Displays statistics about invalid PIM (IPv6) messages of a specific type. -
assert Displays statistics about invalid Assert messages. -
bsr Displays statistics about invalid BSR messages. -
hello Displays statistics about invalid Hello messages. -
join-prune Displays statistics about invalid Join/Prune messages. -
offer Displays statistics about invalid Offer messages. -
backoff Displays statistics about invalid Backoff messages. -
win Displays statistics about invalid Win messages. -
pass Displays statistics about invalid Pass messages. -
crp Displays statistics about invalid C-RP messages. -
register Displays statistics about invalid Register messages. -
register-stop Displays statistics about invalid Register-Stop messages. -
packet-number Displays details of a specified number of invalid PIM (IPv6) messages recently received. The value is an integer that ranges from 1 to 100. By default, details of all the invalid PIM (IPv6) messages currently stored are displayed.
verbose Displays details of invalid PIM (IPv6) messages. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

When a fault occurs on a PIM (IPv6) network, use the display pim ipv6 invalid-packet command to check statistics and details about invalid PIM (IPv6) packets. The command output can help you locate the fault.

If PIM (IPv6) entries fail to be generated on a multicast network, you can run the display pim ipv6 invalid-packet command first to check whether devices have received invalid PIM (IPv6) messages. If the command output contains statistics about invalid PIM (IPv6) messages, run the display pim ipv6 invalid-packet [ packet-number ] verbose command to view details of invalid PIM (IPv6) messages to locate the fault.

Example

# Display statistics about invalid PIM (IPv6) messages received by a device.

<HUAWEI> display pim ipv6 invalid-packet

             Statistics of invalid packets for public net:                      
--------------------------------------------------------------------            
PIM Register invalid packet:
Invalid Multicast Source: 0           Invalid Multicast Group : 0
Invalid Dest Addr       : 0

PIM Register-Stop invalid packet:
Invalid Multicast Source: 0           Invalid Multicast Group : 0
Invalid Dest Addr       : 0           IP Source not RP        : 0

PIM CRP invalid packet:
Invalid Dest Addr       : 0           Invalid CRP Addr        : 0
Fault Length            : 0           CRP Adv Fault Length    : 0
Invalid Multicast Group : 0

PIM Assert invalid packet:
Invalid Dest Addr       : 0           Invalid IP Source Addr  : 0
Invalid Multicast Source: 0           Invalid Multicast Group : 0

PIM BSR invalid packet:
Bad Payload             : 0           Fault Length            : 0
Bad Scope Mask          : 0           Invalid Multicast Group : 0
Not CBSR But BSR        : 0           Invalid BSR Addr        : 0
Fault Hash Length       : 0           Invalid IP Source Addr  : 0

PIM Hello invalid packet:
Invalid Addr List       : 0           Fault Length            : 0
Bad Holdtime Length     : 0           Bad LanPruneDelay Length: 0
Bad DrPriority Length   : 0           Bad GenID Length        : 0
Invalid Dest Addr       : 0           Invalid IP Source Addr  : 0

PIM Join/Prune invalid packet:
Invalid Multicast Source: 0           Invalid Multicast Group : 0
Invalid Up Neighbor     : 0           Invalid IP Source Addr  : 0
Invalid Dest Addr       : 0           Fault Length            : 0  

PIM Offer invalid packet:
Invalid Dest Addr       : 0           Invalid RP Addr         : 0

PIM Backoff invalid packet:
Invalid Dest Addr       : 0           Invalid RP Addr         : 0
Invalid Offer Addr      : 0

PIM Pass invalid packet:
Invalid Dest Addr       : 0           Invalid RP Addr         : 0
Invalid New Winner Addr : 0

PIM Win invalid packet:
Invalid Dest Addr       : 0           Invalid RP Addr         : 0
-------------------------------------------------------------------- 
Table 10-49  Description of the display pim ipv6 invalid-packet command output

Item

Description

Fault Length

Number of messages with invalid lengths.

PIM Register invalid packet

Number of PIM Register messages.

Invalid Multicast Source

Number of messages with invalid multicast source addresses.

Invalid Multicast Group

Number of messages with invalid multicast group addresses.

Invalid Dest Addr

Number of messages with invalid destination addresses.

PIM Register-Stop invalid packet

Number of invalid Register-Stop messages.

IP Source not RP

Number of messages whose source addresses are not the RP address.

PIM CRP invalid packet

Number of invalid C-RP messages.

Invalid CRP Addr

Number of messages with invalid C-RP addresses.

CRP Adv Fault Length

Number of messages with CRP Adv fields of invalid lengths.

PIM Assert invalid packet

Number of invalid Assert messages.

Invalid IP Source Addr

Number of messages with invalid source addresses.

PIM BSR invalid packet

Number of invalid BSR messages.

Bad Payload

Number of messages with invalid payloads.

Bad Scope Mask

Number of messages with invalid scope masks.

Not CBSR But BSR

Number of messages received from non-C-BSRs.

Invalid BSR Addr

Number of messages with invalid BSR addresses.

Fault Hash Length

Number of messages whose hash mask fields of invalid lengths.

PIM Hello invalid packet

Number of invalid Hello messages.

Invalid Addr List

Number of messages with invalid address lists.

Bad Holdtime Length

Number of messages whose Holdtime fields are of invalid lengths.

Bad LanPruneDelay Length

Number of messages whose LanPruneDelay fields are of invalid lengths.

Bad DrPriority Length

Number of messages with DrPriority fields of invalid lengths.

Bad GenID Length

Number of messages with GenerationID fields of invalid lengths.

PIM Join/Prune invalid packet

Number of invalid Join/Prune messages.

Invalid Up Neighbor

Number of messages with invalid upstream neighbors.

PIM Offer invalid packet

Invalid Offer messages.

PIM Backoff invalid packet

Invalid Backoff messages.

Invalid Offer Addr

Offer messages with invalid addresses.

PIM Pass invalid packet

Invalid Pass messages.

Invalid New Winner Addr

Messages with invalid new winner address.

PIM Win invalid packet

Invalid Win messages.

# Display details of one invalid PIM (IPv6) message recently received lately.

<HUAWEI> display pim ipv6 invalid-packet 1 verbose
       Detailed information of invalid packets
-----------------------------------------------------
Packet information (Index 1):
-----------------------------------------------------
Interface           :  Vlanif100
Time                :  2012-06-01 20:04:35 UTC-08:00
Message Length      :  26
Invalid Type        :  Invalid Multicast Source
0000: 25 00 96 77 01 00 00 20 e1 01 01 01 01 00 e0 00
0010: 00 00 80 00 00 64 00 00 00 00
-----------------------------------------------------
Table 10-50  Description of the display pim ipv6 invalid-packet 1 verbose command output

Item

Description

Detailed information of invalid packets

Details about invalid PIM (IPv6) messages.

Packet information (Index 1)

Sequence number of an invalid PIM (IPv6) message (numbered in the opposite order).

Interface

Number of interfaces that receive the invalid PIM (IPv6) message.

Time

Time when the invalid SPT switch message was received, in any of the following formats:
  • YYYY-MM-DD HH:MM:SS

  • YYYY-MM-DD HH:MM:SS UTC±HH:MM DST

  • YYYY-MM-DD HH:MM:SS UTC±HH:MM

  • YYYY-MM-DD HH:MM:SS DST

The format UTC±HH:MM indicates that a time zone was configured with the clock timezone command; DST indicates that the daylight saving time is configured through clock daylight-saving-time command.

Message Length

Length of the invalid PIM (IPv6) message.

Invalid Type

Type of the invalid PIM (IPv6) message.

0000: 25 00 96 77 01 00 00 20 e1 01 01 01 01 00 e0 00

0010: 00 00 80 00 00 64 00 00 00 00

Contents of the invalid PIM (IPv6) message.

display pim ipv6 neighbor

Function

The display pim ipv6 neighbor command displays information about PIM (IPv6) neighbors.

Format

display pim ipv6 neighbor [ ipv6-link-local-address | interface interface-type interface-number | verbose ] *

Parameters

Parameter Description Value
ipv6-link-local-address Specifies the IPv6 link-local address of a neighbor. The value ranges from FE80:: to FE80:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF, in hexadecimal notation.
interface interface-type interface-number Specifies the type and number of an interface. -
verbose Indicates the details of PIM neighbors. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display pim ipv6 neighbor command displays PIM (IPv6) neighbor information, including the number of PIM (IPv6) neighbors and DR priorities of neighbors. You can adjust PIM (IPv6) neighbor relationships according to the command output.

Example

# Display detailed information about PIM (IPv6) neighbors on VLANIF100.
<HUAWEI> display pim ipv6 neighbor interface vlanif 100 verbose
 VPN-Instance: public net

 Total Number of Neighbors on this interface  = 1

Neighbor: FE80::FFE0:FFFF:FE4A:8E04
     Interface: Vlanif100
     Uptime: 00:01:18
     Expiry time: 00:01:31
     DR Priority: 1
     Generation ID: 0x7751638D
     Holdtime: 105 s
     LAN delay: 500 ms
     Override interval: 2500 ms
     Neighbor tracking: disabled
     PIM BFD-session: N
     PIM BIDIR: Y
     Neighbor Secondary Address(es):
     FC00:0:0:2004::2
Table 10-51  Description of the display pim ipv6 neighbor command output

Item

Description

Total Number of Neighbors on this interface

Total number of PIM (IPv6) neighbors on an interface.

Neighbor

Address of a PIM (IPv6) neighbor.

Interface

Interface where the PIM (IPv6) neighbor resides.

Uptime

How long has the PIM (IPv6) neighbor been in Up state.

Expiry time

How soon the PIM (IPv6) neighbor will time out.

DR Priority

DR priority of the PIM (IPv6) neighbor.

Generation ID

Indicates the randomly generated 32-bit value of PIM (IPv6) neighbor.

Holdtime

Keepalive period of the PIM (IPv6) neighbor.

LAN delay

Delay in transmitting Prune messages.

Override interval

Interval for overriding the Prune action.

Neighbor tracking

Whether the neighbor tracking neighbor function is enabled.

PIM BFD-session

Whether a BFD session is set up.

PIM BIDIR

Whether Bidir-PIM (IPv6) is enabled.

Neighbor Secondary Address (es)

IPv6 address of the neighbor.

display pim ipv6 routing-table

Function

The display pim ipv6 routing-table command displays the PIM (IPv6) multicast routing table.

Format

display pim ipv6 routing-table [ ipv6-source-address [ mask mask-length ] | ipv6-group-address [ mask mask-length ] | flags flag-value | fsm | incoming-interface { interface-type interface-number | register } | mode { sm | ssm } | outgoing-interface { exclude | include | match } { interface-type interface-number | none | register } ] * [ outgoing-interface-number [ number ] ]

display pim ipv6 routing-table brief [ ipv6-source-address [ mask mask-length ] | ipv6-group-address [ mask mask-length ] | incoming-interface { interface-type interface-number | register } ] *

display pim ipv6 routing-table [ ipv6-group-address [ mask mask-length ] ] { rpf-interface interface-type interface-number | mode bidir } * [ outgoing-interface { include | exclude | match } { interface-type interface-number | none } | flags flag-value | fsm ] * [ 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.
ipv6-group-address Specifies the IPv6 address of 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.
mask mask-length Specifies the mask length of a multicast source or group. The value is an integer. The mask length of a multicast source ranges from 0 to 128. The mask length of a multicast group ranges from 8 to 128.
flags flag-value Displays of routing entries of a specified type. flag-value specifies the flag of a routing entry. -
fsm Displays detailed information about the finite state machine (FSM). -
incoming-interface Displays the routing entry with the specified upstream interface. -
interface-type interface-number Specifies the type and number of an interface. -
register Displays the register interface. -
rpf-interface Indicates the RPF interface. -
sm Displays PIM-SM (IPv6) routing entries. -
ssm Displays PIM-SSM (IPv6) routing entries. -
bidir Displays Bidir-PIM (IPv6) routing entries. -
outgoing-interface { exclude | include | match } Displays the routing entries with or without a specified outbound interface.
  • exclude: displays the entries that do not contain the specified interface.
  • include: displays the entries that contain the specified interface.
  • match: displays the entries match the specified interface.
-
none Displays the routing entry without the downstream interface. -
outgoing-interface-number Displays the number of the outbound interfaces of routing entries. -
number Specifies the number of the outbound interfaces to be queried. The value is an integer that ranges from 0 to 2048.
brief Displays only the name of upstream interface and the number of downstream interfaces of routing entries. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can use this command to:
  • Check whether PIM (IPv6) has been configured successfully on the network.
  • Check the inbound interfaces, outbound interfaces, flags, and other information in the routing entries to identify failure points when forwarding errors occur on the PIM (IPv6) network.

The PIM (IPv6) routing table includes both (*, G) and (S, G) entries. (*, G) entries are used to set up a rendezvous point tree (RPT), and (S, G) entries are used to set up a shortest path tree (SPT).

Table 10-52 lists the values of the flags flag-value parameter.

Table 10-52  Values of the flag-value parameter

Item

Description

act

Indicates that the multicast routing entry at which actual data arrives exists.

del

Indicates the multicast routing entry to be deleted.

excl

Indicates the multicast routing entry with the exclude flag.

exprune

Indicates that the entry on the RPT is pruned and no receiver on the RPT requests the information sent by the source.

ext

Indicates routing entries that contain downstream interfaces provided by other multicast routing protocols.

loc

Indicates routing entries on the switch directly connected to the network segment where the source resides.

niif

Indicates routing entries with unknown upstream interfaces.

nonbr

Indicates that the routing entry of the upstream neighbor address (link-local address) towards the RP or the source is not found.

none

Indicates routing entries without any flag.

rpt

Indicates the routing entries that are on the RPT but do not use the RPT data.

sg_rcvr

Indicates that the (S, G) receiver of S exists on the local switch and PIM (IPv6) is the owner of the downstream interface.

sgjoin

Indicates that the (S, G) receiver of S exists on the local switch and PIM (IPv6) is not the owner of the downstream interface.

spt

Indicates routing entries on the shortest path tree (SPT).

swt

Indicates routing entries during the SPT switchover.

upchg

Indicates a route change has occurred. The current entry uses the original upstream interface to forward data and waits for data received from a new interface.

wc

Indicates a (*, G) entry.

Example

# Display the PIM (IPv6) multicast routing table.

If the device is running PIM-SM (IPv6), the following information is displayed:

<HUAWEI> display pim ipv6 routing-table
 VPN-Instance: public net
 Total 1 (*, G) entry; 1 (S, G) entry

 (*, FFE3::1)
     RP: FC00:0:0:1::1
     Protocol: pim-sm, Flag: WC
     UpTime: 00:57:31
     Upstream interface: NULL
         Upstream neighbor: NULL
         RPF prime neighbor: NULL
     Downstream interface(s) information:
     Total number of downstreams: 1
         1: Vlanif10
             Protocol: static, UpTime: 00:57:31, Expires: never

 (FC00:0:0:2001::2, FFE3::1)
     RP: FC00:0:0:1::1
     Protocol: pim-sm, Flag: ACT WC
     UpTime: 00:04:24
     Upstream interface: Vlanif20
         Upstream neighbor: FE80::A01:100:1
         RPF prime neighbor: FE80::A01:100:1
     Downstream interface(s) information:
     Total number of downstreams: 1
         1: Vlanif10
             Protocol: pim-sm, UpTime: 00:04:24, Expires:  -
If the device is running Bidir-PIM (IPv6), the following information is displayed:
<HUAWEI> display pim ipv6 routing-table
 VPN-Instance: public net
 Total 1 (*, G) entry; 0 (S, G) entry

 (*, FF1E::1)
     RP: FC00:0:0:1::1
     Protocol: bidir-pim, Flag: WC
     UpTime: 00:00:23
     Rpf interface: Vlanif10
         Upstream neighbor: FE80::A02:210:3
     Downstream interface(s) information:
     Total number of downstreams: 2
        1: Vlanif10(RPF)
             Protocol: bidir-pim, UpTime: 00:00:23, Expires: -
        2: Vlanif20
             Protocol: bidir-pim, UpTime: 02:54:43, Expires: 00:02:47
Table 10-53  Description of the display pim ipv6 routing-table command output

Item

Description

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

Total number of the (S, G) entries and (*, G) entries in the PIM routing table.

(*, FFE3::1)

(*, G) entry in the PIM routing table.

RP

RP address.

Protocol

Type of PIM (IPv6) protocols, Bidir-PIM (IPv6), PIM-SM (IPv6), or PIM-SSM (IPv6).

Flag

Flag of an (S, G) entry or (*, G) entry in the PIM (IPv6) routing table.

UpTime

Lifetime of an interface.

Rpf interface

RPF interface in a routing entry.

Upstream interface

Upstream interface of a (S, G) entry or (*, G) entry.

Upstream neighbor

Upstream neighbor of a (S, G) entry or (*, G) entry.

RPF prime neighbor

RPF neighbor of a (S, G) entry or (*, G) entry.
  • For a (*, G) entry, when the local device is an RP, the RPF neighbor is Null.

  • For a (S, G) entry, when the local device is directly connected to the multicast source, the RPF neighbor is Null.

Downstream interface(s) information

Information about downstream interfaces, including:
  • Number of downstream interfaces

  • Names of downstream interfaces

  • Type of the PIM (IPv6) protocol configured on the downstream interfaces

  • Existing period and timeout period of downstream interfaces

Total number of downstreams

Number of downstream interfaces.

Vlanif10

Interface name.

Expires

Timeout period of an entry.

# Display the brief information about PIM (IPv6) routing entries.

<HUAWEI> display pim ipv6 routing-table brief FF25::1
 VPN-Instance: public net
 Total 3 (*, G) entries; 3 (S, G) entries

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

  00001. (FC00:0:0:2008::55, FF25::1)
       Upstream interface: Vlanif10
       Number of downstreams: 2
  00002. (*, FF25::1)
       Upstream interface: Vlanif10
       Number of downstreams: 2
Table 10-54  Description of the display pim ipv6 routing-table brief command output

Item

Description

Total 3 (*, G) entries; 3 (S, G) entries

Total number of the (S, G) entries and (*, G) entries in the PIM (IPv6) routing table.

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

Total number of the (S, G) entries and (*, G) entries that meet the query conditions in the PIM routing table.

00001. (FC00:0:0:2008::55, FF25::1)

(S, G) entry.

Number of downstreams

Number of downstream interfaces in (S, G) entries or (*, G) entries.

# Display the number of the outbound interfaces of PIM (IPv6)routing entries.

<HUAWEI> display pim ipv6 routing-table outgoing-interface-number
 VPN-Instance: public net
 Total 2 (*, G) entries; 0 (S, G) entry

 (*, FF25::1)
     RP: FC00:0:0:2008::5:3:2 (local)
     Protocol: pim-sm, Flag: WC
     UpTime: 00:00:04
     Upstream interface: Register
         Upstream neighbor: NULL
         RPF prime neighbor: NULL
     Downstream interface(s) information:
     Total number of downstreams: 2

 (*, FF25::2)
     RP: FC00:0:0:2008::5:3:2 (local)
     Protocol: pim-sm, Flag: WC
     UpTime: 00:00:05
     Upstream interface: Register
         Upstream neighbor: NULL
         RPF prime neighbor: NULL
     Downstream interface(s) information:
     Total number of downstreams: 2

display pim ipv6 rp-info

Function

The display pim ipv6 rp-info command displays information about the RP corresponding to a multicast group.

Format

display pim ipv6 rp-info [ ipv6-group-address ]

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.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display pim ipv6 rp-info command displays information about the RP to which a multicast group corresponds. This command can help determine whether multicast forwarding errors are caused by faults of an RP.

Precautions

The RP information contains the information about the RP discovered through the BSR mechanism and static RP.

If the group address is not specified in this command, the corresponding RP information of all the multicast groups is displayed.

Example

# Display the RP of multicast group FF1E::1.

<HUAWEI> display pim ipv6 rp-info ff1e::1
 VPN-Instance: public net
 BSR RP Address is: FE1E::1
     Priority: 192
     Uptime: 00:00:52
     Expires: 00:01:38
     BIDIR: Y
 RP mapping for this group is: FC00:0:0:2001::1 (local host)
Table 10-55  Description of the display pim ipv6 rp-info command output

Item

Description

BSR RP Address is

IP address of a dynamical RP

Priority

RP priority

Uptime

Period during which the RP exists

Expires

Time before an RP times out

BIDIR

Whether the RP serves Bidir-PIM.

RP mapping for this group is

Address of the RP to which multicast group corresponds

Related Topics

election-robust-count (IPv6)

Function

The election-robust-count command sets the DF election robustness variable.

The undo election-robust-count command restores the default configuration.

By default, the DF election robustness variable is 3.

Format

election-robust-count robust-value

undo election-robust-count

Parameters

Parameter Description Value
robust-value

Specifies the DF election robustness variable.

The value is an integer that ranges from 3 to 100.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Devices on a Bidir-PIM (IPv6) shared network segment exchange Offer messages for designated forwarder (DF) election. The DF election robustness variable is used in a DF election in the following way:

  • If a device does not receive any Offer message from other devices after sending Offer messages robustness variable times, it considers itself as the DF.
  • If the device receives an Offer message from a neighbor with a smaller route metric to the RP, it stops participating in the DF election for a period (Time period = Robustness variable x Interval between Offer messages). This suppression period gives the neighbor a chance to be elected as the DF.
  • If the DF's route metric to the RP address increases, the DF sends Win messages at variable intervals to announce the new metric, for robustness variable times. If a device has a better route metric than the DF's, the device responds with an Offer message to trigger a new DF election.

Prerequisites

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

Precautions

This command has the same function as the pim ipv6 election-robust-count command used in the interface view, except for the applicable view. The configuration on an interface takes precedence over the configuration in the PIM view. If no configuration is performed on an interface, the interface inherits the configuration in the PIM-IPv6 view.

Example

# Set the DF election robustness variable to 5 in the PIM-IPv6 view.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] election-robust-count 5

embedded-rp

Function

The embedded-rp disable command disables the embedded-RP function.

The undo embedded-rp disable command enables the embedded-RP function.

The embedded-rp command sets the range of IPv6 multicast groups to which embedded-RP applies.

The undo embedded-rp command restores the default range of IPv6 multicast groups to which embedded-RP applies.

By default, the embedded-RP function is enabled and the default range of IPv6 multicast groups to which embedded-RP applies is FF70::/12.

Format

embedded-rp disable

undo embedded-rp disable

embedded-rp [ basic-acl6-number | acl6-name acl6-name ]

undo embedded-rp [ basic-acl6-number | acl6-name acl6-name ]

Parameters

Parameter Description Value
basic-acl6-number Specifies the number of the basic ACL. The value is an integer that ranges from 2000 to 2999.
acl6-name acl6-name Specifies the name of an IPv6 named basic ACL. The value is a string of 1 to 32 case-sensitive characters except spaces. The value must start with a letter (case-sensitive).

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The embedded RP function is enabled by default after PIM-SM (IPv6) is enabled. This function enables the switch to obtain the RP address from the IPv6 multicast address of a received multicast packet, so that the switch does not need to know the RP information beforehand.

By default, the switch can parse group addresses in the range of FF7x::/12. The value of x can 0 or any integer in the range of 3 to F. When the switch receives a multicast packet with an IPv6 group address in this range, the switch can obtain the RP address from the IPv6 group address. This RP will replace the static RP or dynamically elected RP. If you do not want the switch to use RP information obtained from IPv6 multicast addresses of multicast packets, run the embedded-rp disable command to disable the embedded RP function.

Prerequisites

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

Precautions

If an IPv6 ACL is specified in the command, the final group address range for embedded RP is the intersection of the group address range specified by the IPv6 ACL and the default group address range. All the devices in the PIM (IPv6) domain must be configured with the same group address range.

Example

# Enable the embedded RP function on multicast group ff73::.
<HUAWEI> system-view
[~HUAWEI] acl ipv6 number 2000
[*HUAWEI-acl6-basic-2000] rule permit source ff73:: 12
[*HUAWEI-acl6-basic-2000] quit
[*HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] embedded-rp 2000
Related Topics

hello ipsec sa (IPv6)

Function

The hello ipsec sa command specifies an IPSec SA globally used for encrypting and authenticating PIM Hello (IPv6) messages sent and received by the device.

The undo hello ipsec sa command deletes the IPSec SA globally used for encrypting and authenticating PIM Hello (IPv6) messages sent and received by the device.

By default, no IPSec SA is specified for encrypting and authenticating PIM Hello (IPv6) messages.

Format

hello ipsec sa sa-name

undo hello ipsec sa

Parameters

Parameter Description Value
sa-name Specifies the name of the globally used SA. The name of the globally used SA must already exist.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When a Huawei device connects to a non-Huawei device that can only encrypt and authenticate PIM Hello (IPv6) messages, run this command to configure the Huawei device to encrypt and authenticate only PIM Hello (IPv6) messages.

Prerequisites

  • IPv6 multicast routing has been enabled using the multicast ipv6 routing-enable command in the system view.
  • Basic IPSec functions have been configured.

Precautions

If you run both this command and the ipsec sa (PIM-IPv6 view) command in the PIM-IPv6 view, the last configured one takes effect.

This command has the same function as the pim ipv6 hello ipsec sa command used in the interface view, except for the applicable view. The configuration in the interface view takes precedence over the configuration in the PIM-IPv6 view. If SAs are specified in both the interface view and PIM-IPv6 view, the specified interface uses the SA configured in the interface view. If no SA is specified on an interface, the interface uses the SA specified in the PIM-IPv6 view.

Example

# Configure the device to encrypt and authenticate PIM Hello (IPv6) messages using the PIM IPSec (IPv6) SA named sa1. (This SA has been created.)

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] hello ipsec sa sa1

hello-option dr-priority (IPv6)

Function

The hello-option dr-priority command configures the DR (Designated Router) priority for the switch.

The undo hello-option dr-priority command restores the default DR priority.

By default, the DR priority for the switch is 1.

Format

hello-option dr-priority priority

undo hello-option dr-priority

Parameters

Parameter Description Value
priority Specifies the DR priority of the switch. The value is an integer that ranges from 0 to 4294967295. The greater the value, the higher the priority.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In PIM-SM (IPv6), switches on the shared network segment candidates for the DR. The DR is responsible for the registering of the local multicast source and the joining of the receivers.

The DR election is based on the priority and the IPv6 address. To elect the DR, the switches send the Hello message that contains the priority to each other. The switch with the highest priority functions as the DR. If the switches have the same priority, the switch with the largest IPv6 address functions as the DR.

If there is at least one switch that does not support Hello packets that contain the priority in the network, the DR election is based on the IPv6 address of each switch. The switch with the largest IPv6 address functions as the DR.

Prerequisites

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

Precautions

The hello-option dr-priority command has the same function as the pim ipv6 hello-option dr-priority command in the interface view. By default, if the pim ipv6 hello-option dr-priority command is not used, the value configured in the PIM-IPv6 view is used; otherwise, the value configured in the interface view is used.

Example

# In the PIM-IPv6 view, configure the DR priority of a switch to 3.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] hello-option dr-priority 3

hello-option holdtime (IPv6)

Function

The hello-option holdtime command sets the timeout period for a switch to wait to receive Hello messages from its PIM neighbor.

The undo hello-option holdtime command restores the default configuration.

By default, the timeout period for a switch to wait to receive Hello messages from its PIM neighbor is 105 seconds.

Format

hello-option holdtime interval

undo hello-option holdtime

Parameters

Parameter Description Value
interval Specifies the timeout time during which a switch waits to receive a Hello message from its PIM neighbor. The value is an integer that ranges from 1 to 65535, in seconds.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On the PIM (IPv6) network, after the device receives a Hello message from its PIM neighbor, the device starts the timer. The timer value is the value of Holdtime in the Hello message. If the device does not receive any Hello message from its PIM neighbor after the timeout, the device considers the neighbor invalid or unreachable.

The hello-option holdtime (IPv6) command sets the timeout period during which the PIM interface waits to receive the Hello message from its neighbor.

Prerequisites

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

Precautions

The timeout period must be greater than the interval for sending Hello messages. You can run the timer hello (IPv6) command to set the interval for sending Hello messages.

The hello-option holdtime command has the same function as the pim ipv6 hello-option holdtime command in the interface view. By default, if the pim ipv6 hello-option holdtime command is not used, the value configured in the PIM-IPv6 view is used; otherwise, the value configured in the interface view is used.

Example

# In the PIM-IPv6 view, set the timeout interval to 120 seconds. The timeout interval is the period during which a switch waits to receive the Hello message from its PIM neighbor.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] hello-option holdtime 120

hello-option lan-delay (IPv6)

Function

The hello-option lan-delay command sets the delay in transmitting Prune message on the shared network segment.

The undo hello-option lan-delay command restores the default delay.

By default, the delay in transmitting Prune message on the shared network segment is 500 milliseconds.

Format

hello-option lan-delay interval

undo hello-option lan-delay

the the

Parameters

Parameter Description Value
interval Specifies the delay in transmitting Prune message on the shared network segment. The value is an integer that ranges from 1 to 32767, in milliseconds (ms).

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Hello messages sent by devices carry lan-delay and override-interval. The lan-delay parameter indicates the delay in transmitting messages in the LAN. When the values of lan-delay on all devices on the same link are different, the maximum value of these values is used.

When a device sends a Prune message to the upstream device in the same network segment, if other device still requests the multicast data, it needs to send a Join message to the upstream device in the override-interval period.

The value of the Prune-Pending Timer (PPT) is obtained by the value of lan-delay plus the value of override-interval. PPT refers to the delay during which the current device receives a Prune message from the downstream interface and performs the prune action. If the device receives a Join message from the downstream interface in PPT, the device cancels the prune action.

Prerequisites

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

Precautions

If the delay in transmitting Prune message is too short, the upstream device will stop forwarding multicast packets before the downstream device determines whether to override the Prune action or not. Exercise caution when you run the hello-option lan-delay command.

The hello-option lan-delay command has the same function as the pim ipv6 hello-option lan-delay command in the interface view. By default, if the pim ipv6 hello-option lan-delay command is not used, the value configured in the PIM-IPv6 view is used; otherwise, the value configured in the interface view is used.

Example

# Set the delay in transmitting Prune message on the shared network segment to 200 ms in the PIM-IPv6 view.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] hello-option lan-delay 200

hello-option override-interval (IPv6)

Function

The hello-option override-interval command sets the interval for overriding the prune action in a Hello message.

The undo hello-option override-interval command restores the default interval.

By default, the interval for overriding the prune action in a Hello message is 2500 ms.

Format

hello-option override-interval interval

undo hello-option override-interval

Parameters

Parameter Description Value
interval Specifies the interval for overriding the prune action in a Hello message. The value is an integer that ranges from 1 to 65535, in milliseconds.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Hello messages sent by switches carry lan-delay and override-interval. The override-interval parameter refers to the period during which a downstream switch overrides the prune action.

When a switch sends a Prune message to the upstream switch in the same network segment, if other switch still requests the multicast data, it needs to send a Join message to the upstream switch in the override-interval period.

When the values of override-interval on all switches on the same link are different, the maximum value of these values is used.

The value of PPT is obtained by the value of lan-delay plus the value of override-interval. When receiving a Prune message from a downstream interface, the switch does not perform the prune action until the PPT times out. If the switch receives a Join message from the downstream interface in PPT, the interface cancels the Prune action.

Prerequisites

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

Precautions

The hello-option override-interval command has the same function as the pim ipv6 hello-option override-interval command in the interface view. By default, if the pim ipv6 hello-option override-interval command is not used, the value configured in the PIM-IPv6 view is used; otherwise, the value configured in the interface view is used.

Example

# In the PIM-IPv6 view, set the interval for denying the prune action in a Hello message to 2000 ms.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] hello-option override-interval 2000

holdtime assert (IPv6)

Function

The holdtime assert command sets the timeout period for all PIM interfaces to keep the Assert state on the local switch.

The undo holdtime assert command restores the default timeout.

By default, the timeout period for all PIM interfaces to keep the Assert state on the local switch is 180 seconds.

Format

holdtime assert interval

undo holdtime assert

Parameters

Parameter Description Value
interval Specifies the time during which the PIM interface keeps the Assert state. The value is an integer that ranges from 7 to 65535, in seconds.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On the shared network segment connected to multiple PIM devices, if the same multicast packets reach these PIM devices and pass the RPF check, multiple copies of the same multicast packets are forwarded to this network segment. In this situation, these PIM devices need to initiate the assert mechanism. The device that wins assert election is responsible for multicast forwarding on the shared network segment. Other devices suppress multicast data forwarding and retain the Assert state for a period of time. After the timer for a PIM interface in the Assert state expires, the device that fails to be elected triggers a new round of election.

Prerequisites

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

Precautions

The holdtime assert command has the same function as the pim ipv6 holdtime assert command in the interface view. By default, if the timeout period is not used on an interface, the timeout period configured in the PIM-IPv6 view is used.

Example

# In the PIM-IPv6 view, set the interval during which a switch keeps the Assert state to 100s.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] holdtime assert 100

holdtime join-prune (IPv6)

Function

The holdtime join-prune command sets the holdtime value in Join/Prune messages sent by all PIM interfaces. Devices that receive Join/Prune messages set the time during which the downstream interface keeps the Join or Prune state according to holdtime.

The undo holdtime join-prune command restores the default value.

By default, the holdtime value in Join/Prune messages sent by all PIM interfaces is 210 seconds.

Format

holdtime join-prune interval

undo holdtime join-prune

Parameters

Parameter Description Value
interval Specifies the value of holdtime carried in Join/Prune messages sent by the local device. The value is an integer that ranges from 1 to 65535, in seconds.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After receiving a Join/Prune message from the downstream device, the device starts the holdtime timer. After the timeout interval, if the device does not receive subsequent Join/Prune messages from the downstream device, the downstream interface of a multicast group is suppressed from forwarding Join/Prune messages with information about multicast group joining. If Join/Prune messages carry information about multicast group prune, the downstream interface of the multicast group is restored.

Prerequisites

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

Precautions

The holdtime join-prune command has the same function as the pim ipv6 holdtime join-prune command in the interface view. By default, if the holdtime value is not used on an interface, the holdtime value configured in the PIM-IPv6 view is used.

Example

# In the PIM-IPv6 view, set the time during which the downstream interface of a switch keeps the Join or Prune state to 280 seconds.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] holdtime join-prune 280

ipsec sa (PIM-IPv6 view)

Function

The ipsec sa command specifies an IPSec SA globally used for encrypting and authenticating PIM (IPv6) messages sent and received by the device.

The undo ipsec sa command deletes the IPSec SA globally used for encrypting and authenticating PIM (IPv6) messages sent and received by the device.

By default, no IPSec SA is specified for encrypting and authenticating PIM (IPv6) messages.

Format

[ unicast-message ] ipsec sa sa-name

undo [ unicast-message ] ipsec sa

Parameters

Parameter Description Value
unicast-message Authenticates only PIM (IPv6) unicast messages. If you do not specify this keyword, the device authenticates only PIM (IPv6) multicast messages. -
sa-name Specifies the name of the globally used SA. The name of the globally used SA must already exist.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On an IPv6 multicast network, multicast devices may be attacked by forged PIM (IPv6) messages. As a result, multicast data forwarding between multicast devices is interrupted. To protect multicast devices against such attacks, configure PIM IPSec (IPv6) on the multicast devices to authenticate PIM (IPv6) messages they send and receive.

You can configure one or both of the ipsec sa sa-name and unicast-message ipsec sa sa-name commands on a device. The following rules apply:
  • If only ipsec sa sa-name is configured, the device authenticates only PIM (IPv6) multicast messages using IPSec.

  • If only unicast-message ipsec sa sa-name is configured, the device authenticates only PIM (IPv6) unicast messages using IPSec.

  • If the two commands are configured simultaneously, they both take effect. That is, the device authenticates both PIM (IPv6) unicast and multicast messages using IPSec.

Prerequisites

  • IPv6 multicast routing has been enabled using the multicast ipv6 routing-enable command in the system view.
  • Basic IPSec functions have been configured.

Precautions

If you run both the ipsec sa sa-name command and the hello ipsec sa (IPv6) command in the PIM-IPv6 view, the last configured one takes effect.

This command has the same function as the pim ipv6 ipsec sa command used in the interface view, except for the applicable view. The configuration in the interface view takes precedence over the configuration in the PIM-IPv6 view. If SAs are specified in both the interface view and PIM-IPv6 view, the specified interface uses the SA configured in the interface view. If no SA is specified on an interface, the interface uses the SA specified in the PIM-IPv6 view.

Example

# Configure the device to encrypt and authenticate PIM (IPv6) multicast messages using the PIM IPSec (IPv6) SA named sa1. (This SA has been created.)

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] ipsec sa sa1

join-prune triggered-message-cache disable (IPv6)

Function

The join-prune triggered-message-cache disable command disables the Join/Prune message package function.

The undo join-prune triggered-message-cache disable command enables the Join/Prune message package function.

By default, the Join/Prune message package function is enabled.

Format

join-prune triggered-message-cache disable

undo join-prune triggered-message-cache disable

Parameters

None

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The system performs more efficiently to send a package of Join/Prune messages than to send a large number of individual Join/Prune messages. A device sends Join/Prune messages in packages. To disable the package function, run the join-prune triggered-message-cache disable command.

Prerequisites

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

Example

# Disable the Join/Prune message package function.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] join-prune triggered-message-cache disable

local-address (IPv6)

Function

The local-address command sets a local address for an Anycast RP.

The undo local-address command deletes the local address set for an Anycast RP.

By default, no local address is set for an Anycast RP.

Format

local-address local-address

undo local-address

Parameters

Parameter Description Value
local-address Specifies the local address of Anycast RP. The value must be a legal IPv6 unicast IP address in hexadecimal notation.

Views

Anycast-RP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If PIM (IPv6) Anycast RP is configured, after an RP receives a Register message, it checks the source address of the Register message. If the Register message is sent by the source's DR, the RP forwards the Register message to Anycast RP peers. If the Register message is sent by an Anycast RP peer, it does not forward the Register message.

When forwarding a PIM Register message to other Anycast RP peers, the local RP needs to use its own IPv6 address (called the local address) as the source address of the Register message and use the addresses of Anycast RP peers as the destination addresses of the Register message. In such a manner, Anycast RP peers can learn source/group information from each other. This command is used to set a local address for an Anycast RP.

Prerequisites

The local address specified for Anycast RP must be an existing interface IPv6 address.

Precautions

The local address must be different from the Anycast RP address.

NOTE:

Setting a Loopback interface address as the local address of the Anycast RP is recommended.

Example

# In the Anycast RP view, set the Anycast RP address to FC00:0:0:2001::1 and local address of Anycast RP to FC00:0:0:1::1.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] anycast-rp fc00:0:0:2001::1
[*HUAWEI-pim6-anycast-rp-fc00:0:0:2001::1] local-address fc00:0:0:1::1

multicast ipv6 global limit

Function

The multicast ipv6 global limit command sets a limit on the number of global IPv6 PIM entries.

The undo multicast ipv6 global limit command restores the default configuration.

By default, no limit is set on the number of global IPv6 PIM entries.

Format

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

multicast ipv6 global limit bidir-pim star-group-number limit-count [ threshold-alarm upper-limit upper-limit-value lower-limit lower-limit-value ]

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

undo multicast ipv6 global limit bidir-pim star-group-number

Parameters

Parameter Description Value
pim Specify limit for IPv6 PIM protocol. -
sm Specify IPv6 PIM-SM/SSM mode. -
bidir-pim Specify IPv6 BIDIR-PIM mode. -
star-group-number Configures the specified limit to take effect for (*, G) multicast entries. -
source-group-number Configures the specified limit to take effect for (S, G) multicast entries. -
limit-count Specifies a limit on the number of IPv6 PIM entries.

The value is an integer, which varies according to the IPv6 PIM mode. Enter the question mark (?) to obtain the value range.

threshold-alarm Sets a limit on the number of IPv6 PIM entries. -
upper-limit upper-limit-value Sets an alarm trigger threshold, in percentage. An alarm is generated when the percentage ratio of created IPv6 PIM entries to limit-count reaches upper-limit-value. Setting upper-limit-value to a value greater than 95% is not recommended. The value is an integer ranging from 1 to 100. The default value is 80.
lower-limit lower-limit-value Sets an alarm clear threshold, in percentage. An alarm is cleared when the percentage ratio of created IPv6 PIM entries to limit-count falls below lower-limit-value.
NOTE:
  • lower-limit-value must be less than upper-limit-value.
  • To prevent alarms from being frequently generated and cleared due to route flapping, setting lower-limit-value to a value at least 10 less than upper-limit-value is recommended.
The value is an integer ranging from 1 to 100. The default value is 70.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The global limit sets the maximum number of entries allowed on the device. Use the multicast ipv6 global limit command to set a proper limit on the number of IPv6 PIM entries based on service deployment. An improper limit may affect multicast services.

Configuration Impact

  • After the specified limit is reached, new entries cannot be created, and the PIM_1.3.6.1.4.1.2011.5.25.149.4.0.23 routeExceed alarm is generated.

    NOTE:

    After the specified limit is reached, new (*, G) and (S, G) entries can be manually added.

  • If upper-limit upper-limit-value is set, the PIM_1.3.6.1.4.1.2011.5.25.149.4.0.21 routeThresholdExceed alarm is generated when the percentage ratio of created IPv6 PIM entries to the specified limit reaches upper-limit-value.

Example

# Set the limit to 1000 for IPv6 PIM (S, G) entries.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 global limit pim sm source-group-number 1000

# Set the limit to 2000 for IPv6 PIM (*, G) entries, alarm trigger threshold to 80%, and alarm clear threshold to 70%.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 global limit pim sm star-group-number 2000 threshold-alarm upper-limit 80 lower-limit 70 

multicast ipv6 verification pim routing-table

Function

The multicast ipv6 verification pim routing-table command enables PIM IPv6 multicast entry verification.

Format

multicast ipv6 verification pim routing-table

Parameters

None

Views

User view

Default Level

3: Management level

Usage Guidelines

After the multicast ipv6 global limit command is run to raise the global multicast limit, limited multicast entries will be automatically restored. If an error occurs during automatic entry restoration, run the multicast verification pim routing-table command to enable PIM IPv6 multicast entry verification.

To re-construct limited multicast entries without changing the global multicast limit, directly run the multicast ipv6 verification pim routing-table command.

Example

# Enable PIM IPv6 multicast entry verification.

<HUAWEI> multicast ipv6 verification pim routing-table

neighbor-check (IPv6)

Function

The neighbor-check command enables the PIM neighbor check function.

The undo neighbor-check command restores the default setting.

By default, the PIM neighbor check function is not enabled.

Format

neighbor-check { receive | send }

undo neighbor-check { receive | send }

Parameters

Parameter Description Value
receive Checks whether the Join/Prune and Assert messages are received from a PIM neighbor. If not, these messages are discarded. -
send Checks whether the Join/Prune and Assert messages are sent to a PIM neighbor. If not, these messages are not sent. -

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

PIM devices send Join/Prune messages to the upstream PIM neighbor to perform join and prune actions and PIM neighbors often exchange Assert messages. To save system resources and protect security of Join/Prune messages and Assert messages, run the neighbor-check command to enable the PIM neighbor check function.

Prerequisites

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

Precautions

You can specify both receive and send to enable the PIM neighbor check function for the received and sent Join/Prune and Assert messages.

Example

# In the PIM-IPv6 view, enable the PIM neighbor check function for the received Join/Prune and Assert messages.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] neighbor-check receive

offer-interval (IPv6)

Function

The offer-interval command sets the interval between Offer messages.

The undo offer-interval command restores the default configuration.

By default, the interval between Offer messages is 100 ms.

Format

offer-interval interval

undo offer-interval

Parameters

Parameter Description Value
interval

Specifies the interval between Offer messages.

The value is an integer that ranges from 1 to 20000, in seconds.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Devices on a Bidir-PIM (IPv6) shared network segment exchange Offer messages for designated forwarder (DF) election. You can use the offer-interval command to change the interval at which the devices send Offer messages.

Prerequisites

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

Precautions

This command has the same function as the pim ipv6 offer-interval command used in the interface view, except for the applicable view. The configuration on an interface takes precedence over the configuration in the PIM-IPv6 view. If no configuration is performed on an interface, the interface inherits the configuration in the PIM-IPv6 view.

Example

# Set the interval between Offer messages to 20 seconds in the PIM-IPv6 view.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] offer-interval 20

peer (IPv6)

Function

The peer command configures Anycast RP peers.

The undo peer command removes the configurations of Anycast RPs.

By default, no Anycast RP peer is configured.

Format

peer peer-address

undo peer peer-address

Parameters

Parameter Description Value
peer-address Specifies the address of an Anycast RP peer. The value is in hexadecimal notation.

Views

Anycast-RP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If PIM (IPv6) Anycast RP is configured, after an RP receives a Register message, it checks the source address of the Register message. If the Register message is sent by the source's DR, the RP forwards the Register message to Anycast RP peers. If the Register message is sent by an Anycast RP peer, it does not forward the Register message.

When forwarding a PIM Register message to other Anycast RP peers, the local RP needs to use its own IPv6 address (called the local address) as the source address of the Register message and use the addresses of Anycast RP peers as the destination addresses of the Register message. In such a manner, Anycast RP peers can learn source/group information from each other. This command is used to configure an address for an Anycast RP peer. This address is used as the destination address of the Register message to be sent by the local RP.

Precautions

You can specify a maximum of 16 Anycast RP peers for each Anycast RP.

In a PIM-SM (IPv6) domain, all the devices deployed with Anycast RP must be fully connected logically. Anycast RP peer relationships need to be configured between every two devices deployed with the Anycast RP.

Example

# In the Anycast RP view, set the Anycast RP address to FC00:0:0:3::3 and the peer address to FC00:0:0:2::2.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] anycast-rp fc00:0:0:3::3
[*HUAWEI-pim6-anycast-rp-fc00:0:0:3::3] peer fc00:0:0:2::2

pim ipv6

Function

The pim ipv6 command displays the PIM-IPv6 view.

The undo pim ipv6 command clears the configuration in the PIM-IPv6 view.

Format

pim ipv6

undo pim ipv6

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Before performing PIM (IPv6) configurations, run the pim ipv6 command to enter the PIM-IPv6 view.

Prerequisites

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

Precautions

In using the undo pim ipv6 command, enter Y or N to confirm the action. This command clears global PIM (IPv6) configurations in the current instance. Use this command with caution.

Example

# Enter the PIM-IPv6 view.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6]

pim ipv6 backoff-interval

Function

The pim ipv6 backoff-interval command sets the interval at which a designated forwarder (DF) sends Backoff messages on an interface.

The undo pim ipv6 backoff-interval command restores the default configuration.

By default, a DF sends Backoff messages at intervals of 1 second.

Format

pim ipv6 backoff-interval interval

undo pim ipv6 backoff-interval

Parameters

Parameter Description Value
interval

Specifies the interval at which a DF sends Backoff messages.

The value is an integer that ranges from 1 to 20, in seconds.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a Bidir PIM (IPv6) network, the elected DF sends a Backoff message when it receives a superior Offer message. If the DF does not receive any Offer within the interval for sending the next Backoff message, it sends a Pass message to notify all the multicast devices that a new DF appears. You can use this command to change the interval at which the DF sends Backoff messages.

Prerequisite

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

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

Precautions

This command has the same function as the backoff-interval (IPv6) command used in the PIM-IPv6 view, except for the applicable view. The configuration on an interface takes precedence over the configuration in the PIM-IPv6 view. If no configuration is performed on an interface, the interface inherits the configuration in the PIM-IPv6 view.

On the and CE6870EI, physical interfaces that are switched to Layer 3 mode using the undo portswitch command support Bidir-PIM. On switches of the other models, physical interfaces that are switched to Layer 3 mode using the undo portswitch command do not support Bidir-PIM.

Example

# Set the interval at which the DF sends Backoff messages to 5 seconds on VLANIF100.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] ipv6 enable
[*HUAWEI-Vlanif100] pim ipv6 backoff-interval 5

pim ipv6 bfd

Function

The pim ipv6 bfd command configures PIM BFD (IPv6) parameters on an interface.

The undo pim ipv6 bfd command restores default PIM BFD (IPv6) parameters on an interface.

By default, the interval for transmitting BFD packets and interval for receiving BFD packets are 1000 ms, and the BFD detection multiplier is 3.

Format

pim ipv6 bfd { min-tx-interval tx-value | min-rx-interval rx-value | detect-multiplier multiplier-value }*

undo pim ipv6 bfd { min-tx-interval | min-rx-interval | detect-multiplier }*

undo pim ipv6 bfd { min-tx-interval tx-value | min-rx-interval rx-value | detect-multiplier multiplier-value }*

Parameters

Parameter Description Value
min-tx-interval tx-value Specifies the interval for sending BFD packets.

The value is an integer ranging from 50 to 1000, in milliseconds. The default value is 1000. It is recommended that the default value be used.

min-rx-interval rx-value Specifies the interval for receiving BFD packets.

The value is an integer ranging from 50 to 1000, in milliseconds. The default value is 1000. It is recommended that the default value be used.

detect-multiplier multiplier-value Specifies the local detection multiplier of BFD packets.
  • For a stable link, you can set the detection multiplier to a large value to avoid frequent link detection.

  • For an unstable link, a small detection multiplier may cause BFD session flapping. Therefore, it is recommended that you set the detection multiplier to a large value.

The value is an integer ranging from 3 to 50. The default value is 3.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you need to control detection parameters of BFD packets, run the pim ipv6 bfd command to configure the sending interval, receiving interval, and local detection multiplier for PIM IPv6 BFD packets.

min-tx-interval, min-rx-interval, and detect-multiplier parameters can be configured separately on two ends, that is, the two link ends can send or receive BFD packets at different rates. If there is no special requirement for the detection period and the link is stable, you are recommended to configure the same parameter values for the routing devices of the same performance at the shared network segment.

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.

Configuration Impact

After BFD parameters are configured, PIM (IPv6) provides the address to be detected, minimum sending interval and receiving interval of PIM BFD (IPv6) packets, and local detection multiplier for BFD. The two ends enabled with BFD then negotiate the actual sending interval and receiving interval, and the detection period based on these configured parameters. During the detection phase, BFD notifies the route management (RM) module of the BFD session status and the RM module then notifies PIM (IPv6) of the session status.

If a link fault occurs, BFD fast notifies the RM of the session status and the RM then notifies PIM (IPv6) of the session status. The PIM (IPv6) protocol deletes the status of the faulty interface, triggers a new DR or Assert election, and restores the forwarding of multicast data to the downstream interface. This shortens the period of multicast traffic interruption caused by the interface fault.

Precautions

To validate PIM BFD (IPv6), ensure that a BFD session has been set up and the session is in the Up state.

The two ends negotiate the actual sending interval and receiving interval, and detection period of BFD packets based on the following negotiation mechanism:
  • The formula used to calculate the interval for sending PIM IPv6 BFD packets and the formula used to calculate the interval for receiving PIM IPv6 BFD packets are as follows:
    • Interval for sending PIM IPv6 BFD packets = Max (Local min-tx-interval, Remote min-rx-interval)
    • Interval for receiving PIM IPv6 BFD packets = Max (Remote min-tx-interval, Local min-rx-interval)
  • The formula used to calculate the detection period is as follows:
    • Detection period = Remote detect-multiplier x Max (Remote min-tx-interval, Local min-rx-interval)

If a large parameter is set, BFD will take a long time to detect a fault on a link. During this period, packets may be discarded.

Example

# Enable PIM BFD (IPv6) on VLANIF 100, and set both the minimum interval for sending BFD packets and the minimum interval for receiving BFD packets to 200 ms and the local detection multiplier to 5.

<HUAWEI> system-view
[~HUAWEI] bfd
[*HUAWEI-bfd] quit
[*HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] ipv6 enable
[*HUAWEI-Vlanif100] pim ipv6 sm
[*HUAWEI-Vlanif100] pim ipv6 bfd enable
[*HUAWEI-Vlanif100] pim ipv6 bfd min-tx-interval 200 min-rx-interval 200 detect-multiplier 5
# Enable PIM BFD (IPv6) on 10GE1/0/1, and set both the minimum interval for sending BFD packets and the minimum interval for receiving BFD packets to 200 ms and the local detection multiplier to 5.
<HUAWEI> system-view
[~HUAWEI] bfd
[*HUAWEI-bfd] quit
[*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] pim ipv6 sm
[*HUAWEI-10GE1/0/1] pim ipv6 bfd enable
[*HUAWEI-10GE1/0/1] pim ipv6 bfd min-tx-interval 200 min-rx-interval 200 detect-multiplier 5

pim ipv6 bfd enable

Function

The pim ipv6 bfd enable command enables PIM BFD (IPv6) on an interface.

The undo pim ipv6 bfd enable command disables PIM BFD (IPv6) on an interface.

By default, PIM BFD (IPv6) is disabled on an interface.

Format

pim ipv6 bfd enable

undo pim ipv6 bfd enable

Parameters

None

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To minimize the impact of a fault on services and improve network availability, a network device is required to fast detect a communications fault between adjacent devices so that the upper layer protocol can rectify the fault to ensure normal services.

On a PIM network, changes of link status between PIM neighbors will restart some PIM mechanisms, such as DR election or Assert winner election. For example, when the DR or Assert winner on a shared network segment fails, PIM neighbors on the network segment trigger DR or Assert winner re-election only when the PIM neighbor relationships time out. Multicast data transmission is interrupted before a new DR or Assert winner is elected. The multicast service interruption time is longer than or equal to the neighbor relationship timeout interval or Assert timer value, and is usually several seconds.

PIM BFD (IPv6) can detect link status changes on a shared network segment in milliseconds, enabling PIM devices to rapidly respond to failures of PIM neighbors. If a PIM BFD (IPv6)-capable interface does not receive any BFD packets from the DR or Assert winner within the detection interval, it considers that the DR or Assert winner has failed. Then BFD rapidly reports the session status to the route management (RM) module, which then reports the link status change to the PIM module. After receiving the notification, the PIM module triggers DR or Assert winner re-election immediately, without waiting for timeout of the neighbor relationship. This mechanism reduces the multicast service interruption time and improves reliability of multicast data transmission.

Pre-configuration Tasks

PIM BFD (IPv6) depends on the BFD protocol. Therefore, you need first to enable BFD globally to validate the PIM BFD (IPv6) function.

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

Before configuring PIM BFD (IPv6), enable PIM-SM (IPv6) in the interface view. If the undo pim ipv6 sm command is run, IPv6 PIM-SM is disabled and the PIM BFD (IPv6) function is removed from the interface at the same time.

Example

# Enable PIM BFD (IPv6) on VLANIF 100.

<HUAWEI> system-view
[~HUAWEI] bfd
[*HUAWEI-bfd] quit
[*HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] ipv6 enable
[*HUAWEI-Vlanif100] pim ipv6 sm
[*HUAWEI-Vlanif100] pim ipv6 bfd enable
# Enable PIM BFD (IPv6) on 10GE1/0/1.
<HUAWEI> system-view
[~HUAWEI] bfd
[*HUAWEI-bfd] quit
[*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] pim ipv6 sm
[*HUAWEI-10GE1/0/1] pim ipv6 bfd enable

pim ipv6 bsr-boundary

Function

The pim ipv6 bsr-boundary command configures the BSR boundary of a PIM-SM (IPv6) domain on an interface.

The undo pim ipv6 bsr-boundary command restores the default configuration.

By default, the BSR boundary of a PIM-SM (IPv6) domain is not set.

Format

pim ipv6 bsr-boundary

undo pim ipv6 bsr-boundary

Parameters

None

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

As the management core of the PIM-SM (IPv6) network, the BSR is responsible for sending collected RP-set information to PIM neighbors through Bootstrap messages.

You can divide a large PIM-SM (IPv6) network into multiple PIM-SM (IPv6) domains by configuring the bsr boundary on an interface. Each BSR then serves the local PIM-SM (IPv6) domain.

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.

Configuration Impact

The Bootstrap messages cannot traverse the BSR boundary but other multicast packets can.

Example

# Configure the BSR boundary of a PIM-SM (IPv6) domain on VLANIF100.
<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] ipv6 enable
[*HUAWEI-Vlanif100] pim ipv6 bsr-boundary
# Configure the BSR boundary of a PIM-SM (IPv6) domain on 10GE1/0/1.
<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] pim ipv6 bsr-boundary
Related Topics

pim ipv6 election-robust-count

Function

The pim ipv6 election-robust-count command sets the DF election robustness variable on an interface.

Using the undo pim ipv6 election-robust-count command, you can restore the default value.

By default, the DF election robustness variable is 3.

Format

pim ipv6 election-robust-count robust-value

undo pim ipv6 election-robust-count

Parameters

Parameter Description Value
robust-value

Specifies the DF election robustness variable.

The value is an integer that ranges from 3 to 100.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Devices on a Bidir-PIM (IPv6) shared network segment exchange Offer messages for designated forwarder (DF) election. The DF election robustness variable is used in a DF election in the following way:

  • If a device does not receive any Offer message from other devices after sending Offer messages robustness variable times, it considers itself as the DF.
  • If the device receives an Offer message from a neighbor with a smaller route metric to the RP, it stops participating in the DF election for a period (Time period = Robustness variable x Interval between Offer messages). This suppression period gives the neighbor a chance to be elected as the DF.
  • If the DF's route metric to the RP address increases, the DF sends Win messages at variable intervals to announce the new metric, for robustness variable times. If a device has a better route metric than the DF's, the device responds with an Offer message to trigger a new DF election.

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

This command has the same function as the election-robust-count (IPv6) command used in the PIM-IPv6 view, except for the applicable view. The configuration on an interface takes precedence over the configuration in the PIM-IPv6 view. If no configuration is performed on an interface, the interface inherits the configuration in the PIM-IPv6 view.

On the and CE6870EI, physical interfaces that are switched to Layer 3 mode using the undo portswitch command support Bidir-PIM. On switches of the other models, physical interfaces that are switched to Layer 3 mode using the undo portswitch command do not support Bidir-PIM.

Example

# Set the DF election robustness variable on VLANIF100 to 5.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] ipv6 enable
[*HUAWEI-Vlanif100] pim ipv6 election-robust-count 5

pim ipv6 hello ipsec sa

Function

The pim ipv6 hello ipsec sa command specifies an IPSec SA used for encrypting and authenticating PIM Hello (IPv6) messages sent and received on an interface.

The undo pim ipv6 hello ipsec sa command deletes the IPSec SA used for encrypting and authenticating PIM Hello (IPv6) messages sent and received on an interface.

By default, no IPSec SA is specified for encrypting and authenticating PIM Hello (IPv6) messages on an interface.

Format

pim ipv6 hello ipsec sa sa-name

undo pim ipv6 hello ipsec sa

Parameters

Parameter Description Value
sa-name Specifies the name of the SA used on an interface. The name of the SA must already exist.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When a Huawei device connects to a non-Huawei device that can only encrypt and authenticate PIM Hello (IPv6) messages, run this command to configure the Huawei device to encrypt and authenticate only PIM Hello (IPv6) messages.

Prerequisites

  • IPv6 multicast routing has been enabled using the multicast ipv6 routing-enable command in the system view.
  • IPv6 capability has been enabled using the ipv6 enable command in the interface view.
  • Basic IPSec functions have been configured.

Precautions

If you run both this command and the pim ipv6 ipsec sa command on an interface, the last configured one takes effect.

This command has the same function as the hello ipsec sa (IPv6) command used in the PIM-IPv6 view, except for the applicable view. The configuration in the interface view takes precedence over the configuration in the PIM-IPv6 view. If SAs are specified in both the interface view and PIM-IPv6 view, the specified interface uses the SA configured in the interface view. If no SA is specified on an interface, the interface uses the SA specified in the PIM-IPv6 view.

Example

# Configure the device to encrypt and authenticate PIM Hello (IPv6) messages sent and received on VLANIF100 using the PIM IPSec (IPv6) SA named sa1. (This SA has been created.)

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] ipv6 enable
[*HUAWEI-Vlanif100] pim ipv6 hello ipsec sa sa1

# Configure the device to encrypt and authenticate PIM Hello (IPv6) messages sent and received on 10GE1/0/1 using the PIM IPSec (IPv6) SA named sa1. (This SA has been created.)

<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] pim ipv6 hello ipsec sa sa1

pim ipv6 hello-option dr-priority

Function

The pim ipv6 hello-option dr-priority command sets the priority for the PIM interface that is elected as DR.

The undo pim ipv6 hello-option dr-priority command restores the default value of the priority.

By default, the priority for the PIM interface that is elected as DR is 1.

Format

pim ipv6 hello-option dr-priority priority

undo pim ipv6 hello-option dr-priority

Parameters

Parameter Description Value
priority Specifies the priority of the PIM interface that is elected as DR. The value is an integer that ranges from 0 to 4294967295. The greater the value, the higher the priority.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In PIM (IPv6), devices on the shared network segment candidates for the DR. The DR is responsible for the registering of the local multicast source and the joining of the receivers.

The DR election is based on the priority and the IPv6 address. To elect the DR, the devices send the Hello message that contains the priority to each other. The device with the highest priority functions as the DR. If the devices have the same priority, the device with the largest IPv6 address functions as the DR.

If there is at least one device that does not support Hello packets that contain the priority in the network, the DR election is based on the IPv6 address of each device. The device with the largest IPv6 address functions as the DR.

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

The pim ipv6 hello-option dr-priority command has the same function as the hello-option dr-priority (IPv6) command in the PIM-IPv6 view. By default, if the pim ipv6 hello-option dr-priority command is not used, the value configured in the PIM-IPv6 view is used; otherwise, the value configured in the interface view is used.

Example

# Set the priority of VLANIF100 that is elected as DR to 3.
<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] ipv6 enable
[*HUAWEI-Vlanif100] pim ipv6 hello-option dr-priority 3
# Set the priority of 10GE1/0/1 that is elected as DR to 3.
<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] pim ipv6 hello-option dr-priority 3

pim ipv6 hello-option holdtime

Function

The pim ipv6 hello-option holdtime command sets the timeout period during which the PIM interface waits to receive the Hello message from its neighbor.

The undo pim ipv6 hello-option holdtime command restores the default value of the timeout.

By default, the timeout period during which the PIM interface waits to receive the Hello message from its neighbor is 105 seconds.

Format

pim ipv6 hello-option holdtime interval

undo pim ipv6 hello-option holdtime

Parameters

Parameter Description Value
interval Specifies the timeout period during which the PIM interface waits to receive Hello messages from its neighbor. The value is an integer that ranges from 1 to 65535, in seconds.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On the PIM (IPv6) network, after the device receives a Hello message from its PIM neighbor, the device starts the timer. The timer value is the value of Holdtime in the Hello message. If the device does not receive any Hello message from its PIM neighbor after the timeout, the device considers the neighbor invalid or unreachable.

The pim ipv6 hello-option holdtime command sets the timeout period during which the PIM interface waits to receive the Hello message from its neighbor.

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

The timeout period must be greater than the interval for sending Hello messages. You can run the pim ipv6 time hello command to set the interval for sending Hello messages.

The pim ipv6 hello-option holdtime command has the same function as the hello option holdtime (IPv6) command in the PIM-IPv6 view. By default, if the pim ipv6 hello-option holdtime command is not used, the value configured in the PIM-IPv6 view is used; otherwise, the value configured in the interface view is used.

Example

# Set the timeout period during which VLANIF100 waits to receive Hello messages from its neighbor to 120 seconds.
<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] ipv6 enable
[*HUAWEI-Vlanif100] pim ipv6 hello-option holdtime 120
# Set the timeout period during which 10GE1/0/1 waits to receive Hello messages from its neighbor to 120 seconds.
<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] pim ipv6 hello-option holdtime 120

pim ipv6 hello-option lan-delay

Function

The pim ipv6 hello-option lan-delay command sets the delay in transmitting messages in a shared network in the interface view.

The undo pim ipv6 hello-option lan-delay command restores the default value of the delay.

By default, the delay in transmitting messages in the shared network is 500 ms.

Format

pim ipv6 hello-option lan-delay interval

undo pim ipv6 hello-option lan-delay

Parameters

Parameter Description Value
interval Specifies the delay in transmitting messages in the shared network. The value is an integer that ranges from 1 to 32767, in milliseconds.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Hello messages sent by devices carry lan-delay and override-interval. The lan-delay parameter indicates the delay in transmitting messages in the LAN. When the values of lan-delay on all devices on the same link are different, the maximum value of these values is used.

When a device sends a Prune message to the upstream device in the same network segment, if other device still requests the multicast data, it needs to send a Join message to the upstream device in the override-interval period.

The value of the Prune-Pending Timer (PPT) is obtained by the value of lan-delay plus the value of override-interval. PPT refers to the delay during which the current device receives a Prune message from the downstream interface and performs the prune action. If the device receives a Join message from the downstream interface in PPT, the device cancels the prune action.

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

If the prune delay is set too short, the upstream device stops forwarding multicast packets before the downstream device overrides Prune messages of neighbors. Exercise caution when you run this command.

The function of this command in the interface view is the same as that of the hello-option lan-delay (IPv6) command in the PIM-IPv6 view. By default, if the configuration on the interface is not performed, the value configured in the PIM-IPv6 view is used; otherwise, the value configured in the interface view is used.

Example

# Set the delay in transmitting messages to 200 ms on VLANIF100.
<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] ipv6 enable
[*HUAWEI-Vlanif100] pim ipv6 hello-option lan-delay 200
# Set the delay in transmitting messages to 200 ms on 10GE1/0/1.
<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] pim ipv6 hello-option lan-delay 200

pim ipv6 hello-option override-interval

Function

The pim ipv6 hello-option override-interval command sets the interval carried in Hello messages for overriding the prune action on the interface.

The undo pim ipv6 hello-option override-interval command, restores the default configuration.

By default, the interval carried in Hello messages for overriding the prune action on the interface is 2500 milliseconds.

Format

pim ipv6 hello-option override-interval interval

undo pim ipv6 hello-option override-interval

Parameters

Parameter Description Value
interval Specifies the interval of overriding the prune action. The value is an integer that ranges from 1 to 65535, in milliseconds.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Hello messages sent by devices carry lan-delay and override-interval. The override-interval parameter refers to the period during which a downstream switch overrides the prune action.

When a device sends a Prune message to the upstream device in the same network segment, if other device still requests the multicast data, it needs to send a Join message to the upstream device in the override-interval period.

When the values of override-interval on all devices on the same link are different, the maximum value of these values is used.

The value of PPT is obtained by the value of lan-delay plus the value of override-interval. When receiving a Prune message from a downstream interface, the device does not perform the prune action until the PPT times out. If the device receives a Join message from the downstream interface in PPT, the interface cancels the Prune action.

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

The pim ipv6 hello-option override-interval command has the same function as the hello-option override-interval (IPv6) command in the PIM-IPv6 view. By default, if the pim ipv6 hello-option override-interval command is not used, the value configured in the PIM-IPv6 view is used; otherwise, the value configured in the interface view is used.

Example

# Set the interval for overriding the prune action in Hello messages to 2000 ms on VLANIF100.
<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] ipv6 enable
[*HUAWEI-Vlanif100] pim ipv6 hello-option override-interval 2000
# Set the interval for overriding the prune action in Hello messages to 2000 ms on 10GE1/0/1.
<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] pim ipv6 hello-option override-interval 2000

pim ipv6 holdtime assert

Function

The pim ipv6 holdtime assert command sets the timeout period during which a PIM interface keeps the Assert state.

The undo pim ipv6 holdtime assert command restores the default value of the timeout.

By default, the timeout period during which a PIM interface keeps the Assert state is 180 seconds.

Format

pim ipv6 holdtime assert interval

undo pim ipv6 holdtime assert

Parameters

Parameter Description Value
interval Specifies the timeout period during which a PIM interface keeps the Assert state. The value is an integer that ranges from 7 to 65535, in seconds.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On the shared network segment connected to multiple PIM devices, if the same multicast packets reach these PIM devices and pass the RPF check, multiple copies of the same multicast packets are forwarded to this network segment. In this situation, these PIM routers need to initiate the assert mechanism. The router that wins assert election is responsible for multicast forwarding on the shared network segment. Other devices suppress multicast data forwarding and retain the Assert state for a period of time. After the timer for a PIM interface in the Assert state expires, the device that fails to be elected triggers a new round of election.

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

The pim ipv6 holdtime assert command has the same function as the holdtime assert (IPv6) command in the PIM-IPv6 view. By default, if the pim ipv6 holdtime assert command is not used, the value configured in the PIM-IPv6 view is used; otherwise, the value configured in the interface view is used.

Example

# Set the timeout period for VLANIF100 to keep the Assert state to 100s.
<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] ipv6 enable
[*HUAWEI-Vlanif100] pim ipv6 holdtime assert 100
# Set the timeout period for 10GE1/0/1 to keep the Assert state to 100s.
<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] pim ipv6 holdtime assert 100

pim ipv6 holdtime join-prune

Function

The pim ipv6 holdtime join-prune command sets the holdtime in a Join/Prune message sent by the PIM interface.

The undo pim ipv6 holdtime join-prune command restores the default value of the holdtime.

By default, the holdtime in a Join/Prune message sent by the PIM interface is 210 seconds.

Format

pim ipv6 holdtime join-prune interval

undo pim ipv6 holdtime join-prune

Parameters

Parameter Description Value
interval Specifies the value of holdtime in a Join/Prune message sent by the PIM interface. The value is an integer that ranges from 1 to 65535, in seconds.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After receiving a Join/Prune message from the downstream device, the switch starts the holdtime timer. After the timeout interval, if the switch does not receive subsequent Join/Prune messages from the downstream device, the downstream interface of a multicast group is suppressed from forwarding Join/Prune messages with information about multicast group joining. If Join/Prune messages carry information about multicast group prune, the downstream interface of the multicast group is restored.

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

The pim ipv6 holdtime join-prune command has the same function as the holdtime join-prune (IPv6) command in the PIM-IPv6 view. By default, if the pim ipv6 holdtime join-prune command is not used, the value configured in the PIM view is used; otherwise, the value configured in the interface view is used.

Example

# Set the holdtime in a Join/Prune message sent by VLANIF100 to 280 seconds.
<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] ipv6 enable
[*HUAWEI-Vlanif100] pim ipv6 holdtime join-prune 280
# Set the holdtime in a Join/Prune message sent by 10GE1/0/1 to 280 seconds.
<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] pim ipv6 holdtime join-prune 280

pim ipv6 ipsec sa

Function

The pim ipv6 ipsec sa command specifies an IPSec SA used for encrypting and authenticating PIM (IPv6) messages sent and received on an interface.

The undo pim ipv6 ipsec sa command deletes the IPSec SA used for encrypting and authenticating PIM (IPv6) messages sent and received on an interface.

By default, no IPSec SA is specified for encrypting and authenticating PIM (IPv6) messages on an interface.

Format

pim ipv6 ipsec sa sa-name

undo pim ipv6 ipsec sa

Parameters

Parameter Description Value
sa-name Specifies the name of the SA used on an interface. The name of the SA must already exist.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On an IPv6 multicast network, multicast devices may be attacked by forged PIM (IPv6) messages. As a result, multicast data forwarding between multicast devices is interrupted. To protect multicast devices against such attacks, configure PIM IPSec (IPv6) on some interfaces to authenticate PIM (IPv6) messages sent and received on these interfaces.

Prerequisites

  • IPv6 multicast routing has been enabled using the multicast ipv6 routing-enable command in the system view.
  • IPv6 capability has been enabled using the ipv6 enable command in the interface view.
  • Basic IPSec functions have been configured.

Precautions

If you run both this command and the pim ipv6 hello ipsec sa command on an interface, the last configured one takes effect.

This command has the same function as the ipsec sa (PIM-IPv6 view) command used in the PIM-IPv6 view, except for the applicable view. The configuration in the interface view takes precedence over the configuration in the PIM-IPv6 view. If SAs are specified in both the interface view and PIM-IPv6 view, the specified interface uses the SA configured in the interface view. If no SA is specified on an interface, the interface uses the SA specified in the PIM-IPv6 view.

Example

# Configure the device to encrypt and authenticate PIM (IPv6) messages sent and received on VLANIF100 using the PIM IPSec (IPv6) SA named sa1. (This SA has been created.)

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] ipv6 enable
[*HUAWEI-Vlanif100] pim ipv6 ipsec sa sa1

# Configure the device to encrypt and authenticate PIM (IPv6) messages sent and received on 10GE1/0/1 using the PIM IPSec (IPv6) SA named sa1. (This SA has been created.)

<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] pim ipv6 ipsec sa sa1

pim ipv6 join-policy

Function

The pim ipv6 join-policy command enables the system to filter join information in Join/Prune messages.

The undo pim ipv6 join-policy command restores the default setting.

By default, join information in Join/Prune message is not filtered.

Format

pim ipv6 join-policy { asm { basic-acl6-number | acl6-name acl6-name } | ssm { advanced-acl6-number | acl6-name acl6-name } | advanced-acl6-number | acl6-name acl6-name }

undo pim ipv6 join-policy [ asm | ssm ]

Parameters

Parameter Description Value
asm Filters join information, with the group address in the ASM group address range. -
basic-acl6-number Specifies the basic ACL number. The value is an integer that ranges from 2000 to 2999.
acl6-name acl6-name Specifies the name of a named ACL. The value is a string of 1 to 32 case-sensitive characters except spaces. The value must start with a letter (case-sensitive).
ssm Filters join messages, with the group addresses within the SSM group address range and specified source address. -
advanced-acl6-number Specifies the advanced ACL number. The value is an integer that ranges from 3000 to 3999.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To prevent unauthorized users from joining multicast groups on the PIM-SM (IPv6) network, run the pim ipv6 join-policy command to enable the system to filter join information in Join/Prune messages.

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.

Configuration Impact

The pim ipv6 join-policy command and the acl ipv6 (system view) command are used together.
  • If asm is specified, in the basic ACL6 view, you can set the multicast group address range of join information by specifying the source parameter in the rule (basic ACL6 view) command.

  • If ssm is specified, in the advanced ACL6 view, you can set the source address range and multicast group address range of join information by respectively specifying the source parameter and destination parameter in the rule (advanced ACL6 view) command.

Example

# Configure VLANIF100 to accept the join information with the group address FF25::1.
<HUAWEI> system-view
[~HUAWEI] acl ipv6 number 2001
[*HUAWEI-acl6-basic-2001] rule permit source ff25::1 128
[*HUAWEI-acl6-basic-2001] quit
[*HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] ipv6 enable
[*HUAWEI-Vlanif100] pim ipv6 join-policy asm 2001
# Use a named ACL6 to configure VLANIF100 to accept the Join messages with the source address FC00:0:0:2001::4 and group address FF35::1.
<HUAWEI> system-view
[~HUAWEI] acl ipv6 name myacl
[*HUAWEI-acl6-advance-myacl] rule permit ipv6 source fc00:0:0:2001::4 128 destination ff35::1 128
[*HUAWEI-acl6-advance-myacl] quit
[*HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] ipv6 enable
[*HUAWEI-Vlanif100] pim ipv6 join-policy ssm acl6-name myacl
# Configure 10GE1/0/1 to accept the join information with the group address FF25::1.
<HUAWEI> system-view
[~HUAWEI] acl ipv6 number 2001
[*HUAWEI-acl6-basic-2001] rule permit source ff25::1 128
[*HUAWEI-acl6-basic-2001] quit
[*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] pim ipv6 join-policy asm 2001

pim ipv6 neighbor-policy

Function

The pim ipv6 neighbor-policy command configures a policy for filtering PIM neighbors on an interface.

The undo pim ipv6 neighbor-policy command restores the default setting.

By default, PIM neighbors on the interface are not filtered.

Format

pim ipv6 neighbor-policy { basic-acl6-number | acl6-name acl6-name }

undo pim ipv6 neighbor-policy

Parameters

Parameter Description Value
basic-acl6-number Specifies the basic ACL number. The value is an integer that ranges from 2000 to 2999.
acl6-name acl6-name Specifies the basic ACL name. The value is a string of 1 to 32 case-sensitive characters except spaces. The value must start with a letter (case-sensitive).

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To prevent unauthorized neighbors from being involved in the PIM protocol, run the pim ipv6 neighbor-policy command to configure a policy for filtering PIM neighbors and set the address range of PIM neighbors. The device sets up neighbor relationships with the addresses matching the filtering rules and deletes the neighbors that do not match the filtering rules.

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.

Configuration Impact

The pim ipv6 neighbor-policy command and the acl ipv6 command are used together. In the ACL view, set the address range of PIM neighbors by specifying source in the rule command.

For the named ACL, in the ACL view, when the rule command is used to configure a filtering rule, the filtering rule takes effect for only the multicast group address range specified by source and the time range specified by time-range.

Precautions

If the IPv6 address of a PIM neighbor that has established a neighbor relationship with the device is not in the configured range of valid neighbor IPv6 addresses, the device will no longer receive Hello messages from this PIM neighbor. When the holdtime of Hello messages expires, the neighbor relationship between the PIM device and the device is terminated.

Example

# Configure VLANIF100 to set up the PIM neighbor relationship with the switch of the address FC00:0:0:2000::1.
<HUAWEI> system-view
[~HUAWEI] acl ipv6 number 2001
[*HUAWEI-acl6-basic-2001] rule permit source fc00:0:0:2000::1 128
[*HUAWEI-acl6-basic-2001] quit
[*HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] ipv6 enable
[*HUAWEI-Vlanif100] pim ipv6 neighbor-policy 2001
# Configure 10GE1/0/1 to set up the PIM neighbor relationship with the switch of the address FC00:0:0:2000::1.
<HUAWEI> system-view
[~HUAWEI] acl ipv6 number 2001
[*HUAWEI-acl6-basic-2001] rule permit source fc00:0:0:2000::1 128
[*HUAWEI-acl6-basic-2001] quit
[*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] pim ipv6 neighbor-policy 2001

pim ipv6 offer-interval

Function

The pim ipv6 offer-interval command sets the interval between Offer messages on an interface.

The undo pim ipv6 offer-interval command restores the default configuration.

By default, the interval between Offer messages is 100 ms.

Format

pim ipv6 offer-interval interval

undo pim ipv6 offer-interval

Parameters

Parameter Description Value
interval

Specifies the interval between Offer messages.

The value is an integer that ranges from 1 to 20000, in seconds.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Devices on a Bidir-PIM (IPv6) shared network segment exchange Offer messages for designated forwarder (DF) election. You can use the pim ipv6 offer-interval command to change the interval at which an interface sends Offer messages.

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

This command has the same function as the offer-interval (IPv6) command used in the PIM-IPv6 view, except for the applicable view. The configuration on an interface takes precedence over the configuration in the PIM-IPv6 view. If no configuration is performed on an interface, the interface inherits the configuration in the PIM-IPv6 view.

On the and CE6870EI, physical interfaces that are switched to Layer 3 mode using the undo portswitch command support Bidir-PIM. On switches of the other models, physical interfaces that are switched to Layer 3 mode using the undo portswitch command do not support Bidir-PIM.

Example

# Set the interval between Offer messages to 20 seconds on VLANIF100.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] ipv6 enable
[*HUAWEI-Vlanif100] pim ipv6 offer-interval 20
Related Topics

pim ipv6 require-genid

Function

The pim ipv6 require-genid command configures a PIM interface to reject the Hello messages without the generation ID.

The undo pim ipv6 require-genid command restores the default configuration.

By default, a PIM interface is allowed to receive the Hello messages without the generation ID.

Format

pim ipv6 require-genid

undo pim ipv6 require-genid

Parameters

None

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After an interface on the device is enabled with PIM, the device generates a random number as the generation ID of the Hello message. If the status of the device is updated, the device generates a new Generation ID. When the device finds that the Hello message received from a PIM neighbor contains a different Generation ID, the device considers that the status of the PIM neighbor changes.

To ensure that connected PIM neighbors work properly, run the pim ipv6 require-genid command to configure a PIM interface to reject the Hello messages without the generation ID.

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.

Example

# Configure VLANIF100 to reject the Hello messages without the generation ID.
<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] ipv6 enable
[*HUAWEI-Vlanif100] pim ipv6 require-genid
# Configure 10GE1/0/1 to reject the Hello messages without the generation ID.
<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] pim ipv6 require-genid

pim ipv6 silent

Function

The pim ipv6 silent command enables the PIM silent (IPv6) function on an interface.

The undo pim ipv6 silent command cancels the PIM silent (IPv6) function on an interface.

By default, the PIM silent (IPv6) function is disabled on an interface.

Format

pim ipv6 silent

undo pim ipv6 silent

Parameters

None

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To protect the switch against pseudo PIM Hello (IPv6)messages sent from malicious hosts, configure the pim ipv6 silent command on the interface directly connected to the host network segment to set the interface to PIM silent (IPv6) mode. Then the interface cannot receive or forward any PIM (IPv6) packet, and all PIM (IPv6) neighbors and PIM (IPv6) state machines on this interface are deleted. This interface becomes the DR, but the MLD function on the interface is not affected.

The PIM silent (IPv6) function applies only to the interface directly connected to a host network segment, and only one PIM switch can be connected to this network segment.

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

After you run this command on an interface, the interface no longer receives or sends any PIM (IPv6)packets and other PIM (IPv6) functions on the interface become invalid. Confirm your action before using this command.

If a host network segment is connected to multiple switches and PIM silent (IPv6) is enabled on multiple interfaces, all these interfaces become static DRs. This causes multicast forwarding failures.

Example

# Configure the PIM silent (IPv6) function on VLANIF100.
<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] ipv6 enable
[*HUAWEI-Vlanif100] pim ipv6 silent
# Configure the PIM silent (IPv6) function on 10GE1/0/1.
<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] pim ipv6 silent

pim ipv6 sm

Function

The pim ipv6 sm command enables PIM-SM (IPv6) on an interface.

The undo pim ipv6 sm command disables PIM-SM (IPv6).

By default, PIM-SM (IPv6) is disabled on an interface.

Format

pim ipv6 sm

undo pim ipv6 sm

Parameters

None

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After PIM-SM (IPv6) is enabled on interfaces, devices can set up PIM neighbor relationships with each other and process protocol packets received from PIM neighbors.

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.

Example

# Enable PIM-SM (IPv6) on VLANIF100.
<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] ipv6 enable
[*HUAWEI-Vlanif100] pim ipv6 sm
# Enable PIM-SM (IPv6) on 10GE1/0/1.
<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] pim ipv6 sm

pim ipv6 timer dr-switch-delay

Function

The pim ipv6 timer dr-switch-delay command enables PIM DR switching delay and configures the delay on an interface. When the interface changed from a DR to a non-DR, the interface continues to forward data before the delay expires.

The undo pim ipv6 timer dr-switch-delay command disables PIM DR switching delay on the interface.

By default, when the interface changes from a DR to a non-DR, the interface stops forwarding data immediately.

Format

pim ipv6 timer dr-switch-delay interval

undo pim ipv6 timer dr-switch-delay

Parameters

Parameter Description Value
interval Specifies the delay. The value is an integer that ranges from 10 to 3600, in seconds.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the DR on a shared network segment becomes the non-DR, original multicast forwarding entries will be deleted immediately, causing multicast data interruption in a short time. To solve the problem, set the DR switching delay. Original multicast forwarding entries still take effect until the delay is reached.

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.

Example

# Enable PIM DR switching delay on VLANIF100 and set the delay to 20 seconds.
<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] ipv6 enable
[*HUAWEI-Vlanif100] pim ipv6 timer dr-switch-delay 20
# Enable PIM DR switching delay on 10GE1/0/1 and set the delay to 20 seconds.
<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] pim ipv6 timer dr-switch-delay 20

pim ipv6 timer hello

Function

The pim ipv6 timer hello command sets the interval for sending Hello messages on an interface.

The undo pim ipv6 timer hello command restores the default value of the interval.

By default, the interval for sending Hello messages on an interface is 30 seconds.

Format

pim ipv6 timer hello interval

undo pim ipv6 timer hello

Parameters

Parameter Description Value
interval Specifies the interval for sending Hello messages. The value is an integer that ranges from 1 to 18000, in seconds.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

PIM devices periodically send Hello messages to maintain PIM neighbor relationships. You can run the pim ipv6 timer hello command to set the interval for sending Hello messages.

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

The interval for sending Hello messages must be shorter than the timeout period of PIM neighbors. You can run the pim ipv6 hello-option holdtime command to set the timeout period of PIM neighbors.

The configuration is the same as the timer hello (IPv6) command in the PIM-IPv6 view, except for the view. The system prefers the configuration in the interface view. The value configured in the PIM-IPv6 view is used if no value is configured on the interface.

Example

# Set the interval for sending Hello messages to 40 seconds on VLANIF100.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] ipv6 enable
[*HUAWEI-Vlanif100] pim ipv6 timer hello 40
# Set the interval for sending Hello messages to 40 seconds on 10GE1/0/1.
<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] pim ipv6 timer hello 40

pim ipv6 timer join-prune

Function

The pim ipv6 timer join-prune command sets the interval for periodically sending Join/Prune messages to the upstream device.

The undo pim ipv6 timer join-prune command restores the default interval.

By default, the interval for periodically sending Join/Prune messages to the upstream device is 60 seconds.

Format

pim ipv6 timer join-prune interval

undo pim ipv6 timer join-prune

Parameters

Parameter Description Value
interval Specifies the interval at which Join/Prune messages are sent. The value is an integer that ranges from 1 to 18000, in seconds.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The device sends join information to the upstream device, requesting the upstream device to forward multicast data. The device sends prune information to the upstream device, requesting the upstream device to stop forwarding multicast data. Join information and prune information are encapsulated in Join/Prune messages. The device periodically sends Join/Prune messages to the upstream device to update the forwarding status.

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

The interval configured through this command must be shorter than the interval configured through the pim ipv6 holdtime join-prune command. The interval at which Join or Prune messages are sent must be shorter than the holdtime carried in Join/Prune messages.

The configuration is the same as that of the timer join-prune (IPv6) command in the PIM-IPv6 view. The system prefers the configuration in the interface view. The value configured in the PIM-IPv6 view is used if no value is configured on the interface.

Example

# Set the interval for sending Join or Prune messages to 80 seconds on VLANIF100.
<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] ipv6 enable
[*HUAWEI-Vlanif100] pim ipv6 timer join-prune 80
# Set the interval for sending Join or Prune messages to 80 seconds on 10GE1/0/1.
<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] pim ipv6 timer join-prune 80

probe-interval (IPv6)

Function

The probe-interval command sets the interval for a switch to send Probe messages (null Register message) to the RP.

The undo probe-interval command restores the default value of the interval.

By default, the interval for a switch to send Probe messages to the RP is 5 seconds.

Format

probe-interval interval

undo probe-interval

Parameters

Parameter Description Value
interval Specifies the interval for sending Probe messages to RP. The value is an integer that ranges from 1 to 1799, in seconds.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When receiving a Register-Stop message sent by the RP, the DR at the source side stops sending Register messages and enters the register suppression state.

During the register suppression, the DR at the source side sends Probe messages to notify the RP that the multicast source is still in the Active state. After the register suppression times out, the DR at the source side starts to send Register messages.

Prerequisites

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

Precautions

The interval set using the probe-interval command must be less than half the interval set using the register-suppression-timeout (IPv6) command.

Example

# In the PIM-IPv6 view, set the interval for sending Probe messages to RP to 6 seconds.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] probe-interval 6

register-policy (IPv6)

Function

The register-policy command sets the rules used by an RP to filter Register messages.

The undo register-policy command restores the default setting.

By default, the rules for filtering Register messages are not configured.

Format

register-policy { advanced-acl6-number | acl6-name acl6-name }

undo register-policy

Parameters

Parameter Description Value
advanced-acl6-number Specifies the number of the advanced ACL that defines the rules for filtering packets based on source addresses or group addresses. The value is an integer that ranges from 3000 to 3999.
acl6-name acl6-name Specifies the name of a named advanced ACL. The value is a string of 1 to 32 case-sensitive characters except spaces. The value must start with a letter (case-sensitive).

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To prevent the attack of invalid Register messages, you can configure devices to receive or deny Register messages according to the packet filtering rules.

Prerequisites

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

Precautions

When the register-policy command is used on the RP, only Register messages matching the rule of the ACL are received by the RP. If an undefined ACL is specified, the RP denies all Register messages.

The register-policy command takes effect for only subsequently received Register messages. The multicast entries that have been registered successfully are not deleted and can still be used for multicast data forwarding.

Example

# Configure the RP to receive Register packets sent by the multicast source on the network segment FC00:0:0:2001::2/64 to the multicast group FF02:13::/64.

<HUAWEI> system-view
[~HUAWEI] acl ipv6 3000
[*HUAWEI-acl6-advance-3000] rule permit ipv6 source fc00:0:0:2001::2 64 destination ff02:13:: 64
[*HUAWEI-acl6-advance-3000] quit
[*HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] register-policy 3000
# Configure an IPv6 named ACL, the RP receives Register packets sent by the multicast source on the network segment FC00:0:0:2001::2/64 to the multicast group FF02:13::/64.
<HUAWEI> system-view
[~HUAWEI] acl ipv6 name myacl6
[*HUAWEI-acl6-advance-myacl6] rule permit ipv6 source fc00:0:0:2001::2 64 destination ff02:13:: 64
[*HUAWEI-acl6-advance-myacl6] quit 
[*HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6 
[*HUAWEI-pim6] register-policy acl6-name myacl6

register-source (IPv6)

Function

The register-source command specifies the source IPv6 address used by the source's DR to send Register messages.

The undo register-source command restores the default setting.

By default, the source IPv6 address used by the source's DR to send Register messages is not specified.

Format

register-source ipv6-address

undo register-source

Parameters

Parameter Description Value
ipv6-address Specifies the global IPv6 unicast address of the registered source. -

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the source IPv6 address for sending Register messages is no longer the only IPv6 address in the network for the RP device or the source IPv6 address is filtered out, errors occur in the registration process and extra traffic occupies bandwidth on the network. In this case, use the register-source command to specify an appropriate interface as the source IPv6 address for sending Register messages. Using the loopback address of the source's DR as the source IPv6 address is recommended.

Prerequisites

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

Example

# Specify the source IPv6 address used by the source's DR to send Register message as FC00:0:0:1101::1.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] register-source fc00:0:0:1101::1

register-suppression-timeout (IPv6)

Function

The register-suppression-timeout command sets the timeout period during which a switch keeps the register suppression state.

The undo register-suppression-timeout command restores the default timeout period.

By default, a switch keeps the register suppression state for 60 seconds.

Format

register-suppression-timeout interval

undo register-suppression-timeout

Parameters

Parameter Description Value
interval Specifies the timeout period during which the switch keeps the register suppression state. The value is an integer that ranges from 11 to 3600, in seconds.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After receiving a Register-Stop message from the RP, the switch immediately stops sending Register messages and enters the register suppression state.

The register-suppression-timeout command determines how long the switch keeps the register suppression state. When the timeout period expires, the switch (source DR) starts to send Register messages to the RP.

Prerequisites

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

Precautions

If the timeout period is too short, the RP receives burst multicast data more frequently. If the timeout period is too long, the delay for a new receiver to join a group is long when an (S, G) entry on the RP times out.

You can use the probe-interval (IPv6) command to configure the switch to send null Register messages before the suppression timer times out. This configuration reduces burst Register messages and shortens the timeout period to reduce the delay for a new receiver to join a group.

Example

# In the PIM-IPv6 view, set the timeout period during which the switch keeps the register suppression state to 70 seconds.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] register-suppression-timeout 70
Related Topics

reset pim ipv6 control-message counters

Function

The reset pim ipv6 control-message counters command resets the statistics about PIM (IPv6) Control messages.

Format

reset pim ipv6 control-message counters [ interface interface-type interface-number ]

Parameters

Parameter Description Value
interface interface-type interface-number Specifies the name and the number of an interface. It is used to reset the statistics about PIM (IPv6) control messages on a specified interface. -

Views

User view

Default Level

3: Management level

Usage Guidelines

If an interface with PIM (IPv6) enabled on the device has been forwarding multicast packets in a long period of time, the device stores statistics on a large number of control messages. You can run this command to reset statistics on Control messages.

Example

# Reset the statistics about PIM (IPv6) control messages on all interfaces.

<HUAWEI> reset pim ipv6 control-message counters

reset pim ipv6 routing-table

Function

The reset pim ipv6 routing-table command clears PIM status of the specified downstream interface of a specified PIM (IPv6) entry.

Format

reset pim ipv6 routing-table group ipv6-group-address mask ipv6-group-mask-length source ipv6-source-address interface interface-type interface-number

reset pim ipv6 routing-table all

Parameters

Parameter Description Value
group ipv6-group-address Specifies the group address of an IPv6 PIM entry. 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 0 to 128.
source ipv6-source-address Specifies the source address of an IPv6 PIM entry. The address is a 32-digit hexadecimal number, in the format X:X:X:X:X:X:X:X.
interface interface-type interface-number Specifies the type and number of an interface. -
all Resets the PIM state of downstream interfaces in all IPv6 PIM routing entries. -

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

The reset pim ipv6 routing-table command clears PIM status of the specified downstream interface of a specified PIM entry.

Configuration Impact

Using this command can clear the PIM status of the specified interface in a specified PIM entry. The command cannot be used to clear the MLD and static group join status on a specified interface.

Precautions

Clearing PIM status of the downstream interfaces can trigger the sending of corresponding Join/Prune messages, which cause multicast service interruption.

Example

# Clear PIM status of the downstream interface VLANIF100 of the (S, G) entry (FC00:0:0:2001::4,FF25::1).
<HUAWEI> reset pim ipv6 routing-table group ff25::1 mask 128 source fc00:0:0:2001::4 interface vlanif 100

source-lifetime (IPv6)

Function

The source-lifetime command specifies the timeout period of an (S, G) entry on the switch.

The undo source-lifetime command restores the default value of the timeout period.

By default, the timeout period is 210 seconds.

Format

source-lifetime interval

undo source-lifetime

Parameters

Parameter Description Value
interval Specifies the timeout period of an (S, G) entry on the switch. The value is an integer that ranges from 60 to 65535, in seconds.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A switch creates a timer for each (S, G) entry. The source-lifetime command is used to set the value of the timer. After receiving a multicast packet from S, the interface resets the timer. If the timer times out, the (S, G) entry is considered invalid.

Prerequisites

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

Example

# Set the timeout period of an (S, G) entry of the switch to 200 seconds.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] source-lifetime 200

source-policy (IPv6)

Function

The source-policy command configures the switch to filter received multicast data packets based on source addresses or source/group addresses.

The undo source-policy command deletes the configuration.

By default, a switch does not filter received multicast data packets based on source addresses or source/group addresses.

Format

source-policy { acl6-number | acl6-name acl6-name }

undo source-policy

Parameters

Parameter Description Value
acl6-number Specifies number of the basic or advanced ACL. The value is an integer that ranges from 2000 to 3999.
acl6-name acl6-name Specifies the name of a named basic or advanced ACL. The value is a string of 1 to 32 case-sensitive characters except spaces. The value must start with a letter (case-sensitive).

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To prevent unauthorized source information from being advertised on the PIM network, run the source-policy command to configure the switch to filter received multicast data packets based on source addresses or source/group addresses.

Prerequisites

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

Configuration Impact

If source-policy and the basic ACL are applied, all multicast data packets received should match the source address. Packets that do not pass the filtering are discarded.

If source-policy and the advanced ACL are used, the source addresses and group addresses of all received multicast data packets should be matched. Packets that do not pass the filtering are discarded.

The configurations of the named ACL and advanced ACL are the same, and can implement filtering of both source addresses and multicast group addresses. The named ACL can also be configured with the time-range parameter.

Example

# In the public network instance, configure the switch to receive multicast data packets with the source address of 3121::1 and to discard those with the source address of FC00:0:0:3121::2.

<HUAWEI> system-view
[~HUAWEI] acl ipv6 number 2001
[*HUAWEI-acl6-basic-2001] rule permit source fc00:0:0:3121::1 128
[*HUAWEI-acl6-basic-2001] rule deny source fc00:0:0:3121::2 128
[*HUAWEI-acl6-basic-2001] quit
[*HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] source-policy 2001
# In the public network instance, configure a named IPv6 ACL where multicast data packets with the source address of FC00:0:0:3121::1 are received, and those with the source address of 3121::2 are dropped.
<HUAWEI> system-view
[~HUAWEI] acl ipv6 name myacl6
[*HUAWEI-acl6-advance-myacl6] rule permit ipv6 source fc00:0:0:3121::1 128
[*HUAWEI-acl6-advance-myacl6] rule deny ipv6 source fc00:0:0:3121::2 128
[*HUAWEI-acl6-advance-myacl6] quit
[*HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] source-policy acl6-name myacl6

spt-switch-threshold (IPv6)

Function

The spt-switch-threshold command sets the rate threshold of the multicast packets when the DR at the member side joins the SPT.

The undo spt-switch-threshold command restores the default value.

By default, the system performs SPT switchover on receiving the first multicast data packet through the RPT.

Format

spt-switch-threshold { traffic-rate | infinity } [ group-policy { basic-acl6-number | acl6-name acl6-name } [ order order-value ] ]

undo spt-switch-threshold [ traffic-rate | infinity ] [ group-policy { basic-acl6-number | acl6-name acl6-name } ]

Parameters

Parameter Description Value
traffic-rate Specifies the threshold rate for the switchover from the RPT to the SPT.
NOTE:

Setting this parameter may affect operation of multicast services. You are advised to use the default triggering condition. That is, an SPT switchover is triggered immediately after the first multicast data packet is received from the RPT. The default triggering condition can reduce the number of multicast packets forwarded on the RPT.

The value is an integer that ranges from 1 to 4194304, in kbit/s.
infinity Indicates that the SPT switchover is never enabled. -
basic-acl6-number Specifies an entry of the group-policy list. It works with the multicast group that matches basic-acl6-number to enable the threshold. basic-acl6-number specifies the number of the basic ACL that defines the range of multicast groups. If the parameter is not set, the threshold is applied to all multicast groups. The value ranges from 2000 to 2999.
acl6-name acl6-name Specifies the name of a named basic ACL. The value is a string of 1 to 32 case-sensitive characters without spaces. The value must start with a letter (a to z or A to Z, case sensitive) and can contain numbers, hyphens (-), or underlines (_).
order order-value Adjusts the order of the ACLs in the group-policy list. If a group matches multiple ACLs, the threshold is selected in the order specified by order-value. order-value specifies the updated number. The value is an integer. The value is any value other than original one in the current group-policy list. If the parameter is not set, the order of the ACLs in the group-policy list does not change.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The source's DR encapsulates multicast packets in a Register message, and then transmits the unicast Register message to the RP. Then, the RP decapsulates the Register message and forwards the multicast packets to the receivers along the RPT. By default, when the RP or receiver's DR receives a first multicast packet, it initiates an SPT switchover to the source.

After the spt-switch-threshold command is executed on the receiver's DR, the receiver's DR periodically checks the forwarding rate of multicast packets. When the forwarding rate exceeds the threshold, the receiver's DR sends a Join messages to the source, triggering the SPT switchover.

Prerequisites

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

Configuration Impact

If this command is used several times for the same group, the command that is first matched according to the order takes effect.

This command is valid to all devices that may function as the DR at the member side, but is invalid to RPs.

Example

# Set the threshold to 4 kbit/s. If the transmission rate of packets from the source to the multicast group is higher than the threshold, the switch switches packets to the SPT towards the source.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] spt-switch-threshold 4

# Add a group-policy: the ACL number, rate threshold, and order of the group-policy are 2010, 100 kbit/s, and 1 respectively.

<HUAWEI> system-view
[~HUAWEI] acl ipv6 2010
[*HUAWEI-acl6-basic-2010] rule permit source ff02:: 96
[*HUAWEI-acl6-basic-2010] quit
[*HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] spt-switch-threshold 100 group-policy 2010 order 1

ssm-policy (IPv6)

Function

The ssm-policy command sets the range of SSM group addresses.

The undo ssm-policy command restores the default configuration.

By default, the range of IPv6 SSM group addresses is FF3x::/32, where x cannot be 1 or 2.

Format

ssm-policy { basic-acl6-number | acl6-name acl6-name }

undo ssm-policy

Parameters

Parameter Description Value
basic-acl6-number Specifies the number of the basic ACL that defines the range of SSM group addresses. The value is an integer that ranges from 2000 to 2999.
acl6-name acl6-name Specifies the name of a named basic ACL. The value is a string of 1 to 32 case-sensitive characters except spaces. The value must start with a letter (case-sensitive).

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, the SSM group address range is FF3x::/32, where x cannot be 1 or 2. You can run the ssm-policy command to specify the range of PIM SSM group addresses. All the PIM-SM (IPv6) interfaces consider that PIM SSM is enabled on all the multicast groups in the specified address range. The specified SSM group address range can exceed the default group address range.

Prerequisites

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

Example

# Set the range of PIM SSM multicast addresses to FF31:0:8192::/96.
<HUAWEI> system-view
[~HUAWEI] acl ipv6 2000
[*HUAWEI-acl6-basic-2000] rule permit source ff31:0:8192:: 96
[*HUAWEI-acl6-basic-2000] quit
[*HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] ssm-policy 2000
# Use a named ACL to set the PIM SSM group address range to FF31:0:8192::/96.
<HUAWEI> system-view
[~HUAWEI] acl ipv6 name myacl6 basic
[*HUAWEI-acl6-basic-myacl6] rule permit source ff31:0:8192:: 96
[*HUAWEI-acl6-basic-myacl6] quit
[*HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] ssm-policy acl6-name myacl6

static-rp (IPv6)

Function

The static-rp command configures a static RP.

The undo static-rp command restores the default configuration.

By default, no static RP is configured.

Format

static-rp rp-address [ basic-acl6-number | acl6-name acl6-name ] [ preferred ] [ bidir ]

undo static-rp rp-address

Parameters

Parameter Description Value
rp-address Specifies address of a static RP. The address is a 32-digit hexadecimal number, in the format X:X:X:X:X:X:X:X.
basic-acl6-number Specifies the basic ACL that is used to control the range of multicast groups served by a static RP. The value is an integer that ranges from 2000 to 2999.
acl6-name acl6-name Specifies the name of a named basic ACL. The value is a string of 1 to 32 case-sensitive characters except spaces. The value must start with a letter (case-sensitive).
preferred Indicates that the static RP is preferred. -
bidir Configures the static RP to serve Bidir-PIM. -

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When only one RP exists in the network, you can manually configure a static RP rather than a dynamic RP. This can reduce bandwidth used to exchange information between the C-RP and the BSR.

A static RP can serve both PIM-SM (IPv6) and Bidir-PIM (IPv6). If the bidir parameter is not specified in the static-rp command, the configured static RP serves only PIM-SM (IPv6). If the bidir parameter is specified, the configured static RP serves only Bidir-PIM (IPv6).

Prerequisites

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

Before specifying the bidir parameter, you must run the bidir-pim command to enable Bidir-PIM (IPv6).

Configuration Impact

If the address of the static RP is the address of an interface in the Up state on the local host, the local host acts as the static RP. PIM (IPv6) does not need to be enabled on the interface of the static RP.

In Bidir-PIM (IPv6), PIM-SM (IPv6) must be enabled on the interface of a static RP. Otherwise, the interface fails to transmit traffic.

If no ACL number is specified in the command, the static RP serves all the multicast groups. If an ACL is specified but the ACL does not contain any rules, the static RP serves all the multicast groups. If the specified ACL has rules configured, the static RP serves only the multicast groups permitted by the ACL.

If the command used to configure the static RP does not contain preferred, devices apply BSR mechanism to elect a dynamic RP. If the dynamic RP is not configured in the network or the dynamic RP is invalid, the static RP becomes valid. If the command used to configure static RP contains preferred, the static RP is preferred.

If this command is used many times, multiple static RPs are configured. In the case that multiple static RPs serve a group, the RP with the largest IPv6 address is selected to serve the group. If rp-address of the RPs is identical, the latest RP replaces the previous one.

Precautions

NOTE:

Up to 50 static RPs can be configured by using this command repeatedly, but the same ACL cannot correspond to multiple static RPs. If the ACL is not referenced, only one static RP can be configured.

To make the static RP work normally, run the static-rp command on all devices in the PIM-SM (IPv6) domain.

Example

# Configure the switch with the address of FC00:0:0:1111::1111 as the static RP in the PIM-SM (IPv6) domain.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] static-rp fc00:0:0:1111::1111
# Configure the switch with the address of FC00:0:0:1111::1111 as the static RP in the Bidir-PIM (IPv6) domain.
<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] bidir-pim
[*HUAWEI-pim6] static-rp fc00:0:0:1111::1111 bidir

timer hello (IPv6)

Function

The timer hello command sets the interval at which the PIM switch sends Hello messages.

The undo timer hello command restores the default interval.

By default, the interval at which the PIM switch sends Hello messages is 30 seconds.

Format

timer hello interval

undo timer hello

Parameters

Parameter Description Value
interval Specifies the interval at which Hello messages are sent. The value is an integer that ranges from 1 to 18000, in seconds.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

PIM devices periodically send Hello messages to maintain PIM neighbor relationships. You can run the pim ipv6 timer hello command to set the interval for sending Hello messages.

Prerequisites

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

Configuration Impact

The interval at which the PIM device sends Hello messages should be less than the timeout period of the PIM neighbor. You can run the hello-option holdtime (IPv6) command to set the timeout period of PIM neighbors.

The timer hello command has the same function as the pim ipv6 timer hello command in the interface view. By default, if the pim ipv6 timer hello command is not used, the value configured in the PIM view is used; otherwise, the value configured in the interface view is used.

Example

# Set the interval at which PIM Hello messages are sent to 40s.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] timer hello 40

timer join-prune (IPv6)

Function

The timer join-prune command configures the interval at which Join/Prune messages are sent to an upstream device.

The undo timer join-prune command restores the default interval.

By default, the interval at which Join/Prune messages are sent to an upstream device is 60 seconds.

Format

timer join-prune interval

undo timer join-prune

Parameters

Parameter Description Value
interval Specifies the interval for sending Join/Prune messages. The value is an integer that ranges from 1 to 18000, in seconds.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The switch sends join information to the upstream device, requesting the upstream device to forward multicast data. The switch sends prune information to the upstream device, requesting the upstream device to stop forwarding multicast data. Join information and prune information are encapsulated in Join/Prune messages. The PIM switch periodically sends Join/Prune messages to the upstream switch to update the forwarding status.

Prerequisites

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

Precautions

The interval configured using the timer join-prune command must be shorter than the interval configured using the holdtime join-prune (IPv6) command.

The timer join-prune command has the same function as the pim ipv6 timer join-prune command in the interface view. By default, if the pim ipv6 timer join-prune command is not used, the value configured in the PIM view is used; otherwise, the value configured in the interface view is used.

Example

# Set the interval at which Join/Prune messages are sent to 80s.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] timer join-prune 80

timer spt-switch (IPv6)

Function

The timer spt-switch command sets the interval for checking whether the rate for transmitting multicast data exceeds the threshold before the switchover from the RPT to the SPT.

The undo timer spt-switch command restores the default value of the interval.

By default, the interval for checking whether the rate for transmitting multicast data exceeds the threshold before the switchover from the RPT to the SPT is 15 seconds.

Format

timer spt-switch interval

undo timer spt-switch

Parameters

Parameter Description Value
interval Specifies the interval for checking whether the rate for transmitting multicast data exceeds the threshold before the switchover from RPT to SPT. The value is an integer that ranges from 15 to 65535, in seconds.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the timer spt-switch command to set the interval for checking whether the rate for transmitting multicast data exceeds the threshold.

Prerequisites

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

Precautions

Before running this command, you must set the threshold for SPT switchover by using the spt-switch-threshold (IPv6) command; otherwise, the timer spt-switch command takes no effect.

Example

# Set the interval for checking the rate for transmitting the multicast data before the switchover from RPT to SPT to 30 seconds.

<HUAWEI> system-view
[~HUAWEI] multicast ipv6 routing-enable
[*HUAWEI] pim ipv6
[*HUAWEI-pim6] timer spt-switch 30
Translation
Download
Updated: 2019-03-21

Document ID: EDOC1000166501

Views: 70463

Downloads: 376

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