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

S7700 and S9700 V200R011C10

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

PIM (IPv6) Configuration Commands

Command Support

For details about command support, see the description of each command. If no command support information is provided, all switch models support the command by default.

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 IP fragmentation causes all fragments to become unavailable when fragment information is lost.

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 an MDT cannot be established correctly.

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 ACL number. The ACL 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 ACL.
NOTE:
acl6-name acl6-name can only be the name of a named advanced ACL.

The value is a string of 1 to 64 case-sensitive characters without spaces. The value must start with a letter.

The referenced named ACL6 must be an advanced ACL6.

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 take part in the BSR election. Once a switch is elected as the BSR, it is responsible for advertising RP information in the network. To prevent the valid BSR from being maliciously replaced, take 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.

When you use the rule (basic ACL6 view) command to configure a filtering rule for the Named ACL, the rule is effective only within the source address range specified by the source parameter and within the time period specified by the time-range parameter.

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
# In the PIM-IPv6 view, use a Named ACL to configure address FC00:0:0:2001::/64 as the valid BSR address range.
<HUAWEI> system-view
[HUAWEI] acl ipv6 name myacl6
[HUAWEI-acl6-adv-myacl6] rule permit ipv6 source fc00:0:0:2001:: 64
[HUAWEI-acl6-adv-myacl6] quit
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] pim-ipv6
[HUAWEI-pim6] bsr-policy acl6-name myacl6
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 multiple C-BSRs and 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 the 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 superior to the current BSR, the C-BSR replaces its BSR address with the BSR address 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.

For the multicast BSR messages learned through the GRE tunnel, you need to configure a static multicast route to ensure that the next hop to the BSR is a GRE interface. You need to configure static multicast routes properly to avoid routing loops.

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 admin-scope (IPv6)

Function

The c-bsr admin-scope command configures a BSR administrative scope in a PIM-SM domain.

The undo c-bsr admin-scope command restores the default configuration.

By default, no BSR administrative scope is configured.

Format

c-bsr admin-scope

undo c-bsr admin-scope

Parameters

None

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, each PIM-SM domain has only one BSR that serves all the devices in the entire PIM-SM domain. To achieve more effective management, you can divide a PIM-SM domain into multiple BSR administrative scopes and a global domain. This can reduce the workload of a single BSR and designate a private-network group address for users in a specific domain.

Each BSR administrative scope maintains a BSR that serves the multicast groups in a specified range. The multicast packets for the groups in a BSR administrative domain cannot travel across the boundary of the domain. The global domain maintains a BSR that serves all multicast groups that do not belong to any BSR administrative domains.

Prerequisites

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

Precautions

The c-bsr admin-scope command needs to be run on all the devices in a PIM-SM domain.

Example

# Configure a BSR administrative scope in a PIM-SM domain.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] pim-ipv6
[HUAWEI-pim6] c-bsr admin-scope

c-bsr global (IPv6)

Function

The c-bsr global command configures the switch as a C-BSR in the global domain.

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

By default, no C-BSR is configured in the global domain.

Format

c-bsr global [ hash-length hash-length | priority priority ] *

undo c-bsr global

Parameters

Parameter Description Value
hash-length hash-length Specifies the hash mask length of a C-BSR in the global domain. The value is an integer that ranging from 0 to 128. By default, the value is 126.
priority priority Specifies the priority of the C-BSR in the global domain. The value is an integer that ranges from 0 to 255. By default, it is 0. The greater the value, the higher the priority of the C-BSR.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A PIM-SM network is divided into multiple BSR administrative domains and a global domain. The global domain maintains a BSR that serves the remaining multicast groups.

The c-bsr global command configures the switch as a C-BSR in the global domain. The BSR in the global domain is generated through election.

The rules of electing a BSR from C-BSRs in the global domain are as follows:
  1. The C-BSR with the highest priority is elected as the BSR.

  2. In the case of the same priority, the C-BSR with the highest IP address is elected as the BSR.

Prerequisites

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

Precautions

The c-bsr global command takes effect only in a BSR administrative domain and can enable a device in this BSR administrative domain to accept multicast data for groups beyond the address range of the administrative domain.

Example

# In the PIM-IPv6 view, configure the switch as a C-BSR in the global domain, and then set the priority of the C-BSR to 1.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] pim-ipv6
[HUAWEI-pim6] c-bsr global priority 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 fail 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 applications, all C-BSRs in the same PIM domain must use the same BS_interval and holdtime. If the configured values are different, the BSR may become unstable. This may result in multicast faults. Note the following points:

  • If BS_interval and holdtime are configured at the same time, ensure that BS_interval is less than holdtime.

  • If BS_interval or holdtime is configured, use the following formula to calculate the other one: holdtime = 2 x BS_interval + 10. The following determines which value is used:

    • If holdtime is configured and the calculated BS_interval is less than the minimum value of BS_interval, the minimum value is used.

    • If BS_interval is configured and the calculated holdtime is more than the maximum value of holdtime, the maximum value is used.

  • If neither BS_interval nor holdtime is configured, the default values are used. The default BS_interval is 60s and the default holdtime is 130s.

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, 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 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 failed in the election triggers a new BSR election to prevent service interruption.

Prerequisites

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

Precautions

In actual applications, all C-BSRs in the same PIM domain must use the same BS_interval and holdtime values. If C-BSRs use different BS_interval or holdtime values, the BSR changes frequently, causing multicast forwarding errors. Note the following points:

  • If BS_interval and holdtime are configured at the same time, ensure that BS_interval is less than holdtime.

  • If only one of the BS_interval and holdtime is configured, use the following formula to calculate the other parameter: holdtime = 2 x BS_interval + 10. The following determines which value is used:

    • If holdtime is configured and the calculated BS_interval is less than the minimum value of BS_interval, the minimum value is used.

    • If BS_interval is configured and the calculated holdtime is more than the maximum value of holdtime, the maximum value is used.

  • If neither the BS_interval nor the holdtime is configured, default values are used. The default value of BS_interval is 60s, and the default value of holdtime is 130s.

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 switch with the highest priority wins in the BSR election.

  • If they have 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-bsr scope

Function

The c-bsr scope command specifies the scope ID of the BSR administrative domain served by a C-BSR.

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

By default, no scope ID is specified for a C-BSR. That is, the C-BSR does not belong to any BSR administrative domain.

Format

c-bsr scope scope-id [ hash-length hash-length | priority priority ] *

undo c-bsr scope scope-id

Parameters

Parameter Description Value
scope-id Specifies the scope ID of the administrative domain served by a C-BSR. The value is an integer that ranges from 3 to 15.
hash-length hash-length Specifies the hash mask length of a C-BSR in a BSR administrative domain. The value is an integer that ranges from 0 to 128. The default value is 126.
priority priority Specifies the priority of a C-BSR in a BSR administrative domain. The value is an integer that ranges from 0 to 255. The default value is 0. The greater the value, the higher the priority.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Each BSR administrative domain is assigned a scope ID. To configure a C-BSR to serve a BSR administrative domain, use the c-bsr scope command to specify the scope ID of the BSR administrative domain. Packets forwarded by the C-BSR cannot travel across the boundary of the BSR administrative domain.

Prerequisites

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

A BSR administrative domain has been configured using the c-bsr admin-scope (IPv6) command in the PIM-IPv6 view.

Precautions

The multicast group that does not belong to any BSR administrative domain belongs to a global domain.

Example

# In the PIM-IPv6 view, configure the switch as a C-BSR in the BSR administrative domain to serve groups of Scope 5, and set the priority of the C-BSR to 10.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] pim-ipv6
[HUAWEI-pim6] c-bsr scope 5 priority 10

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 } | scope scope-id ] | holdtime hold-interval | priority priority ] *

undo c-rp ipv6-address [ scope scope-id ]

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 ACL6.
NOTE:
acl6-name acl6-name can only be the name of a named advanced ACL.

The value is a string of 1 to 64 case-sensitive characters without spaces. The value must start with a letter.

The referenced named ACL6 must be an advanced ACL6.

scope scope-id Specifies the scope ID of the BSR administrative domain that a C-RP serves. The value is an integer that ranges from 3 to 15.
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.

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, in descending order of precedence:

  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. The C-RP with the largest hash value wins.

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

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, use a named ACL6 myacl6 to configure an interface with the IPv6 address FC00:0:0:2001::1 as a C-RP of the PIM-SM (IPv6) multicast domain ff02:0:1391::/96. Set the priority to of the C-RP to 10.
<HUAWEI> system-view
[HUAWEI] acl ipv6 name myacl6
[HUAWEI-acl6-adv-myacl6] rule permit ipv6 destination ff02:0:1391:: 96
[HUAWEI-acl6-adv-myacl6] quit
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] pim-ipv6
[HUAWEI-pim6] c-rp fc00:0:0:2001::1 group-policy acl6-name myacl6 priority 10

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, in descending order of precedence:

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

  • The C-RP with highest priority wins.

  • The C-RP with the largest hash value wins.

  • 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

crp-policy (IPv6)

Function

The crp-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 crp-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

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

undo crp-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 ACL.
NOTE:
acl6-name acl6-name can only be the name of a named advanced ACL.

The value is a string of 1 to 64 case-sensitive characters without spaces. The value must start with a letter.

The referenced named ACL6 must be an advanced ACL6.

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 into an RP-set, and floods it to the entire network using BSR messaged. The local switch then works out the RP serving a specific multicast group address range according to the RP-set.

To protect valid C-RPs from being spoofed, configure crp-policy on the BSR 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 crp-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-adv-3100] rule permit ipv6 source fc00:0:0:2001::1 128 destination ff13::101 128
[HUAWEI-acl6-adv-3100] quit
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] pim-ipv6
[HUAWEI-pim6] crp-policy 3100
# Use a named 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-adv-myacl6] rule permit ipv6 source fc00:0:0:2001::1 128 destination ff13::101 128
[HUAWEI-acl6-adv-myacl6] quit
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] pim-ipv6
[HUAWEI-pim6] crp-policy acl6-name myacl6
Related Topics

display default-parameter pim-dm6

Function

The display default-parameter pim-dm6 command displays default PIM-DM (IPv6) configurations.

Format

display default-parameter pim-dm6

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display default-parameter pim-dm6 command displays default PIM-DM (IPv6) configurations. Even if PIM-DM (IPv6) parameters are modified, the display default-parameter pim-dm6 command still displays default parameter settings. Therefore, you can use this command to check which parameters have been modified.

Example

# Display default configurations about PIM-DM (IPv6).

<HUAWEI> display default-parameter pim-dm6
  PIM6 View Default Configurations:
  ---------------------------------
  Hello-option dr-priority: 1
  Hello-option holdtime: 105 s
  Hello-option lan-delay: 500 ms
  Hello-option neighbor-tracking: disabled
  Hello-option override-interval: 2500 ms
  Holdtime assert: 180 s
  Holdtime join-prune: 210 s
  Source-lifetime: 210 s
  State-refresh-interval: 60 s
  State-refresh-rate-limit: 30 s
  State-refresh-ttl: 255
  Hello periodic interval: 30 s
  Join-prune periodic interval: 60 s

  Interface View Default Configurations:
  --------------------------------------
  Pim bfd: disabled
  Pim hello-option dr-priority: 1
  Pim hello-option holdtime: 105 s
  Pim hello-option lan-delay: 500 ms
  Pim hello-option neighbor-tracking: disabled
  Pim hello-option override-interval: 2500 ms
  Pim holdtime assert: 180 s
  Pim holdtime join-prune: 210 s
  Pim require-genid: disabled
  Pim silent: disabled
  Pim state-refresh-capable: enabled
  Pim timer dr-switch-delay: disabled
  Pim timer graft-retry: 3 s
  Pim hello periodic interval: 30 s
  Pim join-prune periodic interval: 60 s
  Pim triggered-hello-delay: 5 s
  Pim version: 2
  Pim ipsec sa: disabled
  Pim neighbor-policy: disabled
Table 8-54  Description of the display default-parameter pim-dm6 command output

Item

Description

PIM6 View Default Configurations

Default configurations in the PIM-IPv6 view.

Hello-option dr-priority

Priority for DR election. This parameter is configured by the hello-option dr-priority (IPv6) command.

Hello-option holdtime

Time period for the neighbor to hold the reachable state. This parameter is configured by the hello-option holdtime (IPv6) command.

Hello-option lan-delay

Delay in transmitting Prune messages at a shared network segment. This parameter is configured by the hello-option lan-delay (IPv6) command.

Hello-option neighbor-tracking

Whether neighbor tracking is enabled.
  • enabled: Neighbor tracking is enabled.
  • disabled: Neighbor tracking is disabled

This function is configured using the hello-option neighbor-tracking (IPv6) command.

Hello-option override-interval

Interval for sending Prune Override messages. This parameter is configured by the hello-option override-interval (IPv6) command.

Holdtime assert

Time period for holding the Assert state. This parameter is configured by the holdtime assert (IPv6) command.

Holdtime join-prune

Time period for holding the Join or Prune state. This parameter is configured by the holdtime join-prune (IPv6) command.

Source-lifetime

Timeout period of an (S, G) entry. This parameter is configured by the source-lifetime (IPv6) command.

State-refresh-interval

Interval for sending State-Refresh messages. This parameter is configured by the state-refresh-interval (IPv6) command.

State-refresh-rate-limit

Minimum interval from when the last State-Refresh message is received to when the next State-Refresh message is received. This parameter is configured by the state-refresh-rate-limit (IPv6) command.

State-refresh-ttl

TTL value of the State-Refresh message. This parameter is configured by the state-refresh-ttl (IPv6) command.

Hello periodic interval

Interval for sending Hello messages. This parameter is configured by the timer hello (IPv6) command.

Join-prune periodic interval

Interval for sending Join/Prune messages. This parameter is configured by the timer join-prune (IPv6) command.

Interface View Default Configurations

Default configurations in the interface view.

Pim bfd Whether the PIM BFD is enabled on the interface. This parameter is configured by the pim ipv6 bfd enable command.

Pim hello-option dr-priority

Priority for DR election on the interface. This parameter is configured by the pim ipv6 hello-option dr-priority command.

Pim hello-option holdtime

Time period for the neighbor on the interface to hold the reachable state. This parameter is configured by the pim ipv6 hello-option holdtime command.

Pim hello-option lan-delay

Delay in transmitting Prune messages at the shared network segment where the interface resides. This parameter is configured by the pim ipv6 hello-option lan-delay command.

Pim hello-option neighbor-tracking

Whether neighbor tracking is enabled on the interface.
  • enabled: Neighbor tracking is enabled.
  • disabled: Neighbor tracking is disabled

This function is configured using the pim ipv6 hello-option neighbor-tracking command.

Pim hello-option override-interval

Interval for the interface to send Prune Override messages. This parameter is configured by the pim ipv6 hello-option override-interval command.

Pim holdtime assert

Time period for the interface to hold the Assert state. This parameter is configured by the pim ipv6 holdtime assert command.

Pim holdtime join-prune

Time period for the interface to hold the Join or Prune state. This parameter is configured by the pim ipv6 holdtime join-prune command.

Pim require-genid

Whether the received Hello message is required to carry the Generation ID.
  • enabled: The received Hello message is required to carry the Generation ID.
  • disabled: The received Hello message is not required to carry the Generation ID.

This parameter is configured using the pim ipv6 require-genid command.

Pim silent

Whether the interface is in PIM silent state.
  • enabled: The interface is in PIM silent state.
  • disabled The interface is not in PIM silent state.

This parameter is configured using the pim ipv6 silent command.

Pim state-refresh-capable

Whether State-Refresh is enabled on the interface.
  • enabled: State-Refresh is enabled on the interface.
  • disabled: State-Refresh is disabled on the interface.

This function is configured using the pim ipv6 state-refresh-capable command.

Pim timer dr-switch-delay

Whether the DR switch delay is set on the interface.
  • enabled: The DR switch delay is set on the interface.
  • disabled: The DR switch delay is not set on the interface.

This function is configured using the pim ipv6 timer dr-switch-delay command.

Pim timer graft-retry

Interval for the interface to retransmit Graft messages. This parameter is configured by the pim ipv6 timer graft-retry command.

Pim hello periodic interval

Interval for the interface to send Hello messages. This parameter is configured by the pim ipv6 timer hello command.

Pim join-prune periodic interval

Interval for the interface to send Join/Prune messages. This parameter is configured by the pim ipv6 timer join-prune command.

Pim triggered-hello-delay

Maximum delay for the interface to send Hello messages. This parameter is configured by the pim ipv6 triggered-hello-delay command.

Pim version

Version of PIM enabled on the interface.

Pim ipsec sa

Whether PIM IPSec is enabled on the interface. The switch does not support this function.

Pim neighbor-policy

Whether the neighbor-policy is set on the interface.
  • enabled: A neighbor policy is configured on the interface.
  • disabled: No neighbor policy is configured on the interface.

This function is configured using the pim ipv6 neighbor-policy command.

display default-parameter pim-sm6

Function

The display default-parameter pim-sm6 command displays default PIM-SM (IPv6) configurations.

Format

display default-parameter pim-sm6

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display default-parameter pim-sm6 command displays default configurations about PIM-SM (IPv6) for both ASM and SSM. Even if PIM-SM (IPv6) parameters are modified, the display default-parameter pim-sm6 command still displays default parameter settings. This command helps you determine which parameters have been modified.

Example

# Display default PIM-SM (IPv6) configurations.

<HUAWEI> display default-parameter pim-sm6
 PIM6 View Default Configurations:
  ---------------------------------
  Bsr-policy: disabled
  C-bsr admin-scope: disabled
  C-bsr global: disabled
  C-bsr group: none
  C-bsr hash-length: 126
  C-bsr holdtime: 130 s
  C-bsr interval: 60 s
  C-bsr priority: 0
  C-rp advertisement-interval: 60 s
  C-rp holdtime: 150 s
  C-rp priority: 192
  Crp-policy: disabled
  Bsm semantic fragmentation: disabled
  Embedded-rp: enabled
  Hello-option dr-priority: 1
  Hello-option holdtime: 105 s
  Hello-option lan-delay: 500 ms
  Hello-option neighbor-tracking: disabled
  Hello-option override-interval: 2500 ms
  Holdtime assert: 180 s
  Holdtime join-prune: 210 s
  Probe-interval: 5 s
  Register-policy: disabled
  Register-suppression-timeout: 60 s
  Source-lifetime: 210 s
  Source-policy: disabled
  Spt-switch-threshold: disabled
  Ssm-policy: disabled
  Static-rp:  disabled
  Hello periodic interval: 30 s
  Join-prune periodic interval: 60 s
  Timer spt-switch: 15 s
                                       
  Interface View Default Configurations:
  --------------------------------------
  Pim bfd: disabled
  Pim bsr-boundary: disabled
  Pim hello-option dr-priority: 1
  Pim hello-option holdtime: 105 s
  Pim hello-option lan-delay: 500 ms
  Pim hello-option neighbor-tracking: disabled
  Pim hello-option override-interval: 2500 ms
  Pim holdtime assert: 180 s
  Pim holdtime join-prune: 210 s
  Pim require-genid: disabled
  Pim silent: disabled
  Pim timer dr-switch-delay: disabled
  Pim hello periodic interval: 30 s
  Pim join-prune periodic interval: 60 s
  Pim triggered-hello-delay: 5 s
  Pim version: 2
  Pim ipsec sa: disabled
  Pim join-policy: disabled
  Pim neighbor-policy: disabled
Table 8-55  Description of the display default-parameter pim-sm6 command output

Item

Description

PIM6 View Default Configurations

Default configurations in the PIM-IPv6 view.

Bsr-policy

Whether the valid address range of the BSR is set. This parameter is configured by the bsr-policy (IPv6) command.

C-bsr admin-scope

Whether the BSR administrative domain is configured. This parameter is configured by the c-bsr admin-scope (IPv6) command.

C-bsr global

Whether the C-BSR in the global domain is configured. This parameter is configured by the c-bsr global (IPv6) command.

C-bsr group

Whether the C-BSR in the BSR administrative domain is configured. This parameter is configured by the c-bsr scope command.

C-bsr hash-length

Global hash mask length of the C-BSR. This parameter is configured by the c-bsr hash-length (IPv6) command.

C-bsr holdtime

Waiting time for the BSR to receive the Bootstrap message. This parameter is configured by the c-bsr holdtime (IPv6) command.

C-bsr interval

Interval for the BSR to send Bootstrap messages. This parameter is configured by the c-bsr interval (IPv6) command.

C-bsr priority

Global priority of the C-BSR. This parameter is configured by the c-bsr priority (IPv6) command.

C-rp advertisement-interval

Interval for the C-RP to send Advertisement messages. This parameter is configured by the c-rp advertisement-interval (IPv6) command.

C-rp holdtime

Waiting time for the BSR to receive the Advertisement message. This parameter is configured by the c-rp holdtime (IPv6) command.

C-rp priority

Global priority of the C-RP. This parameter is configured by the c-rp priority (IPv6) command.

Crp-policy

Whether the valid address range of the C-RP and the range of multicast groups that the C-RP serves are set. This parameter is configured by the crp-policy (IPv6) command.

Bsm semantic fragmentation

Whether the BSR fragmentation is enabled. This parameter is configured by the bsm semantic fragmentation (IPv6) command.

Embedded-rp

Whether the embedded RP is enabled. This parameter is configured by the embedded-rp command.

Hello-option dr-priority

Priority for DR election. This parameter is configured by the hello-option dr-priority (IPv6) command.

Hello-option holdtime

Time period for the neighbor to hold the reachable state. This parameter is configured by the hello-option holdtime (IPv6) command.

Hello-option lan-delay

Delay in transmitting Prune messages at a shared network segment. This parameter is configured by the hello-option lan-delay (IPv6) command.

Hello-option neighbor-tracking

Whether neighbor tracking is enabled. This parameter is configured by the hello-option neighbor-tracking (IPv6) command.

Hello-option override-interval

Interval for sending Prune Override messages. This parameter is configured by the hello-option override-interval (IPv6) command.

Holdtime assert

Time period for holding the Assert state. This parameter is configured by the holdtime assert (IPv6) command.

Holdtime join-prune

Time period for holding the Join or Prune state. This parameter is configured by the holdtime join-prune (IPv6) command.

Probe-interval

Interval for sending Probe messages (empty Register messages) to the RP. This parameter is configured by the probe-interval (IPv6) command.

Register-policy

Whether the rule for filtering Register messages is configured. This parameter is configured by the register-policy (IPv6) command.

Register-suppression-timeout

Time period for holding the register-suppression state. This parameter is configured by the register-suppression-timeout (IPv6) command.

Source-lifetime

Timeout period of an (S, G) entry. This parameter is configured by the source-lifetime (IPv6) command.

Source-policy

Whether the rule for filtering multicast sources is configured. This parameter is configured by the source-policy (IPv6) command.

Spt-switch-threshold

Whether the threshold of the multicast packet rate that triggers the switch from the RPT to the SPT is configured. This parameter is configured by the spt-switch-threshold (IPv6) command.

Ssm-policy

Whether the SSM group address range is set. This parameter is configured by the ssm-policy (IPv6) command.

Static-rp

Whether the static RP is configured. This parameter is configured by the static-rp (IPv6) command.

Hello periodic interval

Interval for sending Hello messages. This parameter is configured by the timer hello (IPv6) command.

Join-prune periodic interval

Interval for sending Join/Prune messages. This parameter is configured by the timer join-prune (IPv6) command.

Timer spt-switch

Whether the interval for checking whether the multicast packet rate exceeds the threshold before the switchover from RPT to SPT is configured. This parameter is configured by the timer spt-switch (IPv6) command.

Interface View Default Configurations

Default configurations in the interface view.

Pim bfd Whether the PIM BFD is enabled on the interface. This parameter is configured by the pim ipv6 bfd enable command.

Pim bsr-boundary

Whether the PIM boundary is configured on the interface. This parameter is configured by the pim ipv6 bsr-boundary command.

Pim hello-option dr-priority

Priority for DR election on the interface. This parameter is configured by the pim ipv6 hello-option dr-priority command.

Pim hello-option holdtime

Time period for the neighbor on the interface to hold the reachable state. This parameter is configured by the pim ipv6 hello-option holdtime command.

Pim hello-option lan-delay

Delay in transmitting Prune messages at a shared network segment on the interface. This parameter is configured by the pim ipv6 hello-option lan-delay command.

Pim hello-option neighbor-tracking

Whether neighbor tracking is enabled on the interface. This parameter is configured by the pim ipv6 hello-option neighbor-tracking command.

Pim hello-option override-interval

Interval for the interface to send Prune Override messages. This parameter is configured by the pim ipv6 hello-option override-interval command.

Pim holdtime assert

Time period for the interface to hold the Assert state. This parameter is configured by the pim ipv6 holdtime assert command.

Pim holdtime join-prune

Time period for the interface to hold the Join or Prune state. This parameter is configured by the pim ipv6 holdtime join-prune command.

Pim require-genid

Whether the received Hello message is required to carry the Generation ID. This parameter is configured by the pim ipv6 require-genid command.

Pim silent

Whether PIM Silent is enabled on the interface. This parameter is configured by the pim ipv6 silent command.

Pim timer dr-switch-delay

Whether the DR switch delay is set on the interface. This parameter is configured by the pim ipv6 timer dr-switch-delay command.

Pim hello periodic interval

Interval for the interface to send Hello messages. This parameter is configured by the pim ipv6 timer hello command.

Pim join-prune periodic interval

Interval for the interface to send Join/Prune messages. This parameter is configured by the pim ipv6 timer join-prune command.

Pim triggered-hello-delay

Maximum delay for the interface to send Hello messages. This parameter is configured by the pim ipv6 triggered-hello-delay command.

Pim version

Version of PIM enabled on the interface.

Pim ipsec sa Whether PIM IPSec is enabled on the interface.

The switch does not support this function.

Pim join-policy

Whether the join-policy is configured on the interface. This parameter is configured by the pim ipv6 join-policy command.

Pim neighbor-policy

Whether the neighbor-policy is configured on the interface. This parameter is configured by the pim ipv6 neighbor-policy command.

display default-parameter pim-ssm6

Function

The display default-parameter pim-ssm6 command displays default configurations of PIM-SM (IPv6) for SSM.

Format

display default-parameter pim-ssm6

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display default-parameter pim-ssm6 command displays default configuration of PIM-SM (IPv6) for SSM. Even if the configuration of PIM-SM (IPv6) for SSM is modified, the display default-parameter pim-ssm6 command still displays default parameter settings. This command helps you determine which parameters have been modified.

Example

# Display default configuration of PIM-SM (IPv6) for SSM.

<HUAWEI> display default-parameter pim-ssm6
  PIM6 View Default Configurations:
  ---------------------------------
  Hello-option dr-priority: 1
  Hello-option holdtime: 105 s
  Hello-option lan-delay: 500 ms
  Hello-option neighbor-tracking: disabled
  Hello-option override-interval: 2500 ms
  Holdtime assert: 180 s
  Holdtime join-prune: 210 s
  Probe-interval: 5 s
  Register-policy: disabled
  Register-suppression-timeout: 60 s
  Source-lifetime: 210 s
  Source-policy: disabled
  Ssm-policy: disabled
  Hello periodic interval: 30 s
  Join-prune periodic interval: 60 s

  Interface View Default Configurations:
  --------------------------------------
  Pim bfd: disabled
  Pim hello-option dr-priority: 1
  Pim hello-option holdtime: 105 s
  Pim hello-option lan-delay: 500 ms
  Pim hello-option neighbor-tracking: disabled
  Pim hello-option override-interval: 2500 ms
  Pim holdtime assert: 180 s
  Pim holdtime join-prune: 210 s
  Pim require-genid: disabled
  Pim silent: disabled
  Pim timer dr-switch-delay: disabled
  Pim hello periodic interval: 30 s
  Pim join-prune periodic interval: 60 s
  Pim triggered-hello-delay: 5 s
  Pim version: 2
  Pim ipsec sa: disabled
  Pim join-policy: disabled
  Pim neighbor-policy: disabled
Table 8-56  Description of the display default-parameter pim-ssm6 command output

Item

Description

PIM6 View Default Configurations

Default configurations in the PIM-IPv6 view.

Hello-option dr-priority

Priority for DR election. This parameter is configured by the hello-option dr-priority (IPv6) command.

Hello-option holdtime

Time period for the neighbor to hold the reachable state. This parameter is configured by the hello-option holdtime (IPv6) command.

Hello-option lan-delay

Delay in transmitting Prune messages at a shared network segment. This parameter is configured by the hello-option lan-delay (IPv6) command.

Hello-option neighbor-tracking

Whether neighbor tracking is enabled. This parameter is configured by the hello-option neighbor-tracking (IPv6) command.

Hello-option override-interval

Interval for sending Prune Override messages. This parameter is configured by the hello-option override-interval (IPv6) command.

Holdtime assert

Time period for holding the Assert state. This parameter is configured by the holdtime assert (IPv6) command.

Holdtime join-prune

Time period for holding the Join or Prune state. This parameter is configured by the holdtime join-prune (IPv6) command.

Probe-interval

Interval for sending Probe messages (empty Register messages) to the RP. This parameter is configured by the probe-interval (IPv6) command.

Register-policy

Whether the rule for filtering Register messages is configured. This parameter is configured by the register-policy (IPv6) command.

Register-suppression-timeout

Time period for holding the register-suppression state. This parameter is configured by the register-suppression-timeout (IPv6) command.

Source-lifetime

Timeout period of an (S, G) entry. This parameter is configured by the source-lifetime (IPv6) command.

Source-policy

Whether the rule for filtering multicast sources is configured. This parameter is configured by the source-policy (IPv6) command.

Ssm-policy

Whether the SSM group address range is set. This parameter is configured by the ssm-policy (IPv6) command.

Hello periodic interval

Interval for sending Hello messages. This parameter is configured by the timer hello (IPv6) command.

Join-prune periodic interval

Interval for sending Join/Prune messages. This parameter is configured by the timer join-prune (IPv6) command.

Interface View Default Configurations

Default configurations in the interface view.

Pim bfd Whether the PIM BFD is enabled on the interface. This parameter is configured by the pim ipv6 bfd enable command.

Pim hello-option dr-priority

Priority for DR election on the interface. This parameter is configured by the pim ipv6 hello-option dr-priority command.

Pim hello-option holdtime

Time period for the neighbor on the interface to hold the reachable state. This parameter is configured by the pim ipv6 hello-option holdtime command.

Pim hello-option lan-delay

Delay in transmitting Prune messages at a shared network segment on the interface. This parameter is configured by the pim ipv6 hello-option lan-delay command.

Pim hello-option neighbor-tracking

Whether neighbor tracking is enabled on the interface. This parameter is configured by the pim ipv6 hello-option neighbor-tracking command.

Pim hello-option override-interval

Interval for the interface to send Prune Override messages. This parameter is configured by the pim ipv6 hello-option override-interval command.

Pim holdtime assert

Time period for the interface to hold the Assert state. This parameter is configured by the pim ipv6 holdtime assert command.

Pim holdtime join-prune

Time period for the interface to hold the Join or Prune state. This parameter is configured by the pim ipv6 holdtime join-prune command.

Pim require-genid

Whether the received Hello message is required to carry the Generation ID. This parameter is configured by the pim ipv6 require-genid command.

Pim silent

Whether PIM Silent is enabled on the interface. This parameter is configured by the pim ipv6 silent command.

Pim timer dr-switch-delay

Whether the DR switch delay is set on the interface. This parameter is configured by the pim ipv6 timer dr-switch-delay command.

Pim hello periodic interval

Interval for the interface to send Hello messages. This parameter is configured by the pim ipv6 timer hello command.

Pim join-prune periodic interval

Interval for the interface to send Join/Prune messages. This parameter is configured by the pim ipv6 timer join-prune command.

Pim triggered-hello-delay

Maximum delay for the interface to send Hello messages. This parameter is configured by the pim ipv6 triggered-hello-delay command.

Pim version

Version of PIM enabled on the interface.

Pim ipsec sa Whether PIM IPSec is enabled on the interface.

The switch does not support this function.

Pim join-policy

Whether the join-policy is configured on the interface. This parameter is configured by the pim ipv6 join-policy command.

Pim neighbor-policy

Whether the neighbor-policy is configured on the interface. This parameter is configured by the pim ipv6 neighbor-policy command.

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
     Scope: 5
     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
     Scope: 5
     Wait to be BSR: 0
Table 8-57  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.

Scope

Scope ID of the BSR administrative domain served by a BSR.

Not scoped indicates that the BSR is not an AdminScoped 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 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, the interval at which PIM IPv6 BFD packets are received, and the 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 8-58  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

IPv6 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 8-59  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 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
multicast load-splitting rule: source-group
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 8-60  Description of the display pim ipv6 claimed-route command output

Item

Description

multicast load-splitting rule

Mode in which multi-cast loads are split. The following policies apply:
  • group: multicast group-based load splitting

  • source: multicast source-based load splitting

  • source-group: multicast source and group-based load splitting

  • stable-preferred: stable-preferred load splitting

  • balance-preferred: balance-preferred load splitting

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 | graft | graft-ack | hello | join-prune | state-refresh | bsr } | 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. -
graft Indicates the Graft message. -
graft-ack Indicates the Graft-ack message. -
hello Indicates the Hello message. -
join-prune Indicates the Join-prune message. -
state-refresh Indicates the State-refresh message. -
bsr Indicates the BSR 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 VLANIF100.
<HUAWEI> display pim ipv6 control-message counters interface vlanif 100
VPN-Instance: public net
 PIM control-message counters for interface: Vlanif100
 Message Type     Received         Sent             Invalid      Filtered
 Assert           0                0                0            0
 Graft            0                0                0            0
 Graft-Ack        0                0                0            0
 Hello            328              331              0            0
 Join-prune       2                0                0            0
 State-Refresh    0                0                0            0
 BSR              9778             0                0            0
Table 8-61  Description of the display pim ipv6 control-message counters command output

Item

Description

PIM control-message counters for interface

Name of the interface for collecting statistics on PIM control messages

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.

Assert

Number of Assert messages.

Graft

Number of Graft messages.

Graft-Ack

Number of Graft-Ack messages.

Hello

Number of Hello messages.

Join-prune

Number of Join/Prune messages.

State-Refresh

Number of State-Refresh messages.

BSR

Number of Bootstrap messages.

display pim ipv6 grafts

Function

The display pim ipv6 grafts command displays the information about unacknowledged PIM-DM (IPv6) Graft messages.

Format

display pim ipv6 grafts

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

In PIM-DM (IPv6), after sending the Graft message, the switch needs to wait to receive the Graft-Ack message from the upstream device.

You can run the display pim ipv6 grafts command to view the information about the PIM-DM (IPv6) Graft messages sent but unacknowledged.

Example

# Display the unacknowledged PIM-DM (IPv6) graft messages.
<HUAWEI> display pim ipv6 grafts
Source                      Group                     Expire    RetransmitIn
fc00:0:0:2001::2            ff03::101                 00:02:52  00:00:02
Table 8-62  Description of the display pim ipv6 grafts command output

Item

Description

Source

Multicast source address.

Group

Multicast group address.

Expire

Timeout period of an (S, G) entry.

RetransmitIn

Amount of time before the next Graft message is transmitted.

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 8-63  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
     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: -
Table 8-64  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 boundary is configured on the interface.

PIM dr-switch-delay timer

DR switching delay.

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.

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 | graft | graft-ack | state-refresh } ] *

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. -
graft Displays statistics about invalid Graft messages. -
graft-ack Displays statistics about invalid Graft-Ack messages. -
state-refresh Displays statistics about invalid State-Refresh 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 an 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 General invalid packet:
Invalid PIM Version     : 0           Invalid PIM Type        : 0
Fault Length            : 0           Bad Checksum            : 0

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 Graft invalid packet:
Invalid Multicast Source: 0           Invalid Multicast Group : 0
Invalid Up Neighbor     : 0           Invalid IP Source Addr  : 0
Fault Length            : 0

PIM Graft-Ack invalid packet:
Invalid Multicast Source: 0           Invalid Multicast Group : 0
Invalid Up Neighbor     : 0           Invalid IP Source Addr  : 0
Fault Length            : 0

PIM State Refresh invalid packet:
Invalid Multicast Source: 0           Invalid Multicast Group : 0
Invalid Originator Addr : 0           Fault Length            : 0
-------------------------------------------------------------------- 
Table 8-65  Description of the display pim ipv6 invalid-packet command output

Item

Description

PIM General invalid packet

Number of general invalid PIM (IPv6) messages.

Invalid PIM Version

Number of messages with invalid PIM (IPv6) version.

Invalid PIM Type

Number of messages with invalid PIM (IPv6) message type.

Fault Length

Number of messages with invalid lengths.

Bad Checksum

Number of messages with invalid checksum.

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 Graft invalid packet

Number of invalid Graft messages.

PIM Graft-Ack invalid packet

Number of invalid Graft-Ack messages.

PIM State Refresh invalid packet

Number of invalid State-Refresh messages.

Invalid Originator Addr

Number of messages with invalid Originator address.

# 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 8-66  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
     Neighbor Secondary Address(es):
     FC00:0:0:2004::2
Table 8-67  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.

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 { dm | 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 } ] *

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. -
dm Displays PIM-DM (IPv6) routing entries. -
sm Displays PIM-SM (IPv6) routing entries. -
ssm Displays PIM-SSM (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. -
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 8-68 lists the values of the flags flag-value parameter.

Table 8-68  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.

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.

<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
         1: Vlanif20
         Upstream neighbor: FE80::A01:100:1
         RPF prime neighbor: FE80::A01:100:1
     Downstream interface(s) information:
     Upstream interface: Vlanif10
             Protocol: pim-dm, UpTime: 00:04:24, Expires:  -
Table 8-69  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, PIM-DM (IPv6), PIM-SM (IPv6), or PIM-SSM (IPv6).

Flag

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

UpTime

Lifetime of an interface.

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 8-70  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
 RP mapping for this group is: FC00:0:0:2001::1 (local host)
Table 8-71  Description of the display pim ipv6 rp-info command output

Item

Description

VPN-Instance

VPN instance to which RP information belongs. public net indicates the public network instance.

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

RP mapping for this group is

Address of the RP to which multicast group corresponds

Related Topics

embedded-rp

Function

The embedded-rp command enables the embedded RP function.

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

By default, the embedded RP function is enabled.

Format

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 ACL.
NOTE:
acl6-name acl6-name can only be the name of a named advanced ACL.

The value is a string of 1 to 64 case-sensitive characters without spaces. The value must start with a letter.

The referenced named ACL6 must be an advanced ACL6.

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 be 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 undo embedded-rp 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

# Configure a named ACL6 to enable the embedded RP on the multicast group ff73::.

<HUAWEI> system-view
[HUAWEI] acl ipv6 name myacl6
[HUAWEI-acl6-adv-myacl6] rule permit ipv6 destination ff73:: 12
[HUAWEI-acl6-adv-myacl6] quit
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] pim-ipv6
[HUAWEI-pim6] embedded-rp acl6-name myacl6
Related Topics

graceful-restart (IPv6)

Function

The graceful-restart command enables PIM GR.

The undo graceful-restart command disables PIM GR.

By default, PIM GR is not enabled.

Format

graceful-restart

undo graceful-restart

Parameters

None

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On the PIM-SM (IPv6) network, after an active/standby switchover is performed on the switch equipped with two MPUs, the new active MPU deletes original PIM (IPv6) forwarding entries. Because the active MPU on the switch cannot create new PIM (IPv6) forwarding entries in a short time, multicast data transmission is interrupted.

PIM GR enables the switch to back up join and prune information in PIM (IPv6) routing entries to the new MPU when an active/standby switchover is performed on the switch. This ensures normal multicast data forwarding during restoration of the multicast distribution tree.

Prerequisites

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

Precautions

At least one interface must have PIM-SM (IPv6) enabled for the graceful-restart command to take effect.

Example

# Enable PIM GR in the PIM-IPv6 view.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] pim-ipv6
[HUAWEI-pim6] graceful-restart

graceful-restart period (IPv6)

Function

The graceful-restart period command configures the minimum PIM GR period.

The undo graceful-restart period command restores the default minimum PIM GR period.

By default, the minimum PIM GR period is 120 seconds.

Format

graceful-restart period period

undo graceful-restart period

Parameters

Parameter Description Value
period Specifies the minimum PIM GR period. It is an integer that ranges from 90 to 3600 in seconds.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The graceful-restart period command ensures the minimum time for maintaining forwarding entries.

Prerequisites

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

Precautions

Unicast protocol GR forms the basis of PIM GR; therefore, the minimum PIM GR period should be longer than the corresponding unicast protocol GR period.

The PIM GR period also depends on the complexity of the network topology and increases with the expansion of unicast route capacity and multicast route capacity.

Example

# Set the minimum PIM GR period in the PIM-IPv6 view to 150 seconds.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] pim-ipv6
[HUAWEI-pim6] graceful-restart
[HUAWEI-pim6] graceful-restart period 150

hello-option dr-priority (IPv6)

Function

The hello-option dr-priority command configures the designated router (DR) 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

On an IPv6 PIM-SM network, switches on a shared network segment are candidates for the DR. The DR is responsible for the registering of the local multicast source and the joining of the receivers.

The DR is elected based on the priority and the IPv6 address. The switches send Hello messages carrying the priority for DR election. The switch with the highest priority becomes the DR. If the switches have the same priority, the switch with the largest IPv6 address becomes the DR.

If at least one switch in the network does not support Hello packets that contain the priority, 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 a switch receives a Hello message from its PIM neighbor, the switch starts a timer based on the Holdtime value in the Hello message. If the switch does not receive any Hello message from its PIM neighbor when the timer expires, it considers the neighbor invalid or unreachable.

The hello-option holdtime (IPv6) command sets the timeout period during which a 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

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 switches carry lan-delay and override-interval values. The lan-delay parameter indicates the delay in transmitting messages in the LAN. If devices on the same link have different lan-delay values, the maximum value is used.

When a switch sends a Prune message to the upstream device in the same network segment, the other devices that still request multicast data need to send a Join message to the upstream device within the override-interval period.

The value of the Prune-Pending Timer (PPT) is the sum of lan-delay and override-interval values and refer to the delay from the current device receiving a Prune message from the downstream interface to performing the prune action. If the switch receives a Join message from the downstream interface before the PPT timer expires, it 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 neighbor-tracking (IPv6)

Function

The hello-option neighbor-tracking command enables the neighbor tracking function.

The undo hello-option neighbor-tracking command restores the default configuration.

By default, the neighbor tracking function is not enabled.

Format

hello-option neighbor-tracking

undo hello-option neighbor-tracking

Parameters

None

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When sending a Hello message, the switch generates a Generation ID and encapsulates it into the message. The Generation ID changes only when the device status changes. In this case, the neighboring device detects the Generation ID change after receiving the Hello message and immediately sends a Join message to the device to update the neighbor relationship. If multiple devices on a shared network segment prepare to send Join messages to the same upstream PIM neighbor, only one device is allowed to send the Join message. After other devices detect the Join message, they do not send Join messages to the upstream neighbor. This means that the upstream neighbor cannot update neighbor relationships with downstream devices after a Generation ID change.

When the switch with neighbor tracking enabled detects Join messages from other devices, the switch still sends the Join messages to the same upstream PIM neighbor.

Prerequisites

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

Precautions

This command is valid for only PIM-SM (IPv6).

Neighbor tracking can be implemented only when this function is enabled on all devices on the shared network segment.

The hello-option neighbor-tracking command has the same function as the pim ipv6 hello-option neighnor-tracking command in the interface view. By default, if neighbor tracking is not used on an interface, the neighbor tracking configuration in the PIM-IPv6 view takes effect.

Example

# In the PIM-IPv6 view, enable the downstream neighbor tracking function.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] pim-ipv6
[HUAWEI-pim6] hello-option neighbor-tracking

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 from switches carry lan-delay and override-interval values. The override-interval parameter refers to the period during which a downstream switch can override the prune action.

When a switch sends a Prune message to the upstream device in the same network segment, the other devices that still request multicast data need to send a Join message to the upstream device within the override-interval period.

If switches on the same link have different values, the maximum value is used.

The value of PPT is the sum of lan-delay and override-interval values. When receiving a Prune message from a downstream interface, the switch does not perform the prune action until the PPT expires. If the switch receives a Join message from the downstream interface before the PPT expires, it cancels the Prune action.

Prerequisites

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

Precautions

This command is valid for PIM-SM (IPv6) and PIM-DM (IPv6).

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

This command is valid for PIM-SM (IPv6) and PIM-DM (IPv6).

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 switch starts the hold timer. If this message carries group-join information and the switch does not receive subsequent Join/Prune messages from the downstream device when the timer expires, it suppresses multicast data forwarding to downstream interfaces of the specified group. If Join/Prune message carries group-prune information, the switch resumes multicast data forwarding to downstream interfaces when the hold timer expires.

Prerequisites

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

Precautions

This command is valid for PIM-SM (IPv6) and PIM-DM (IPv6).

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

join-prune max-packet-length (IPv6)

Function

The join-prune max-packet-length command sets the maximum size of each Join/Prune message to be sent.

The undo join-prune max-packet-length command restores the default maximum size of each Join/Prune message to be sent.

By default, the maximum length of Join/Prune message sent by is 8100 bytes.

Format

join-prune max-packet-length packet-length

undo join-prune max-packet-length

Parameters

Parameter Description Value
packet-length Specifies the maximum size of each PIM-SM Join/Prune message to be sent. The value is an integer that ranges from 100 to 64000, in bytes.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer device has low performance and takes a long time to process a large Join/Prune message carrying a lot of (S, G) entries, the maximum size of each Join/Prune message can be reduced to relieve the burden on the peer device.

Prerequisites

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

Precautions

This command is valid for PIM-SM (IPv6) and PIM-DM (IPv6).

If the maximum size specified in the join-prune max-packet-length command is greater than the interface MTU, the maximum size of each message to be sent is equal to the interface MTU.

Example

# Set the maximum size of each Join/Prune message to be sent to 2100 bytes.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] pim-ipv6
[HUAWEI-pim6] join-prune max-packet-length 2100

join-prune periodic-messages queue-size (IPv6)

Function

The join-prune periodic-messages queue-size command sets the maximum number of (S, G) entries carried in a Join/Prune message that is sent every second.

The undo join-prune periodic-messages queue-size command restores the default maximum number of (S, G) entries carried in a Join/Prune message that is sent every second.

By default, a Join/Prune message that is sent every second contains 1020 entries.

Format

join-prune periodic-messages queue-size queue-size

undo join-prune periodic-messages queue-size

Parameters

Parameter Description Value
queue-size Specifies the maximum number of (S, G) entries carried in a Join/Prune message that is sent every second. The value is an integer that ranges from 16 to 4096.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer device has a low throughput, reduce the length of a queue for periodically sending messages to control the number of (S, G) entries. This setting allows the local device to send Join/Prune messages with a small number of (S, G) entries multiple times, preventing packet loss or route flapping.

Prerequisites

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

Precautions

This command is valid for PIM-SM (IPv6) and PIM-DM (IPv6).

Example

# Allow each Join/Prune message that is sent every second to carry a maximum of 2000 (S, G) entries.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] pim-ipv6
[HUAWEI-pim6] join-prune periodic-messages queue-size 2000

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 when sending a package of Join/Prune messages than sending 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.

Precautions

This command is valid for PIM-SM (IPv6) and PIM-DM (IPv6).

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

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.

This command is valid for only PIM-SM (IPv6).

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

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 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, in milliseconds. If the MPU is equipped with the ES0D00FSUA00 or the MPU is EH1D2SRUDC00/EH1D2SRUDC01, the value ranges from 3 to 1000. Otherwise, the value ranges from 100 to 1000.
NOTE:

When the MPU is the EH1D2SRUDC00 or EH1D2SRUDC01, you need to first run the detect-engine enable command in the system view so that the value range is 3 to 1000. If the detect-engine enable command is not used first, the value range is 100 to 1000.

min-rx-interval rx-value Specifies the interval for receiving BFD packets.
The value is an integer, in milliseconds. If the MPU is equipped with the ES0D00FSUA00 or the MPU is EH1D2SRUDC00/EH1D2SRUDC01, the value ranges from 3 to 1000. Otherwise, the value ranges from 100 to 1000.
NOTE:

When the MPU is the EH1D2SRUDC00 or EH1D2SRUDC01, you need to first run the detect-engine enable command in the system view so that the value range is 3 to 1000. If the detect-engine enable command is not used first, the value range is 100 to 1000.

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

Ethernet interface view, GE interface view, XGE interface view, 40GE interface view, 100GE interface view, Eth-Trunk interface view, VLANIF 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 BFD (IPv6) packets.

The min-tx-interval, min-rx-interval, and detect-multiplier parameters can be configured separately at two ends of a link so that the two 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 advised to configure the same parameter settings for the routing devices that have the same performance and are on the shared network segment.

Prerequisites

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

Configuration Impact

After BFD parameters are configured, PIM (IPv6) provides the address to be detected, the minimum sending interval and receiving interval of PIM BFD (IPv6) packets, and the 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 quickly 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 value is set, BFD will take a long time to detect a fault on a link. This may cause packet loss.

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 GE1/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 gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] undo portswitch
[HUAWEI-GigabitEthernet1/0/1] ipv6 enable
[HUAWEI-GigabitEthernet1/0/1] pim ipv6 sm
[HUAWEI-GigabitEthernet1/0/1] pim ipv6 bfd enable
[HUAWEI-GigabitEthernet1/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

Ethernet interface view, GE interface view, XGE interface view, 40GE interface view, 100GE interface view, Eth-Trunk interface view, VLANIF 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 quickly 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 globally 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] pim ipv6 sm
[HUAWEI-Vlanif100] pim ipv6 bfd enable
# Enable PIM BFD (IPv6) on GE1/0/1.
<HUAWEI> system-view
[HUAWEI] bfd
[HUAWEI-bfd] quit
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] undo portswitch
[HUAWEI-GigabitEthernet1/0/1] pim ipv6 sm
[HUAWEI-GigabitEthernet1/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

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

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] pim ipv6 bsr-boundary
# Configure the BSR boundary of a PIM-SM (IPv6) domain on GE1/0/1.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] undo portswitch
[HUAWEI-GigabitEthernet1/0/1] pim ipv6 bsr-boundary
Related Topics

pim ipv6 dm

Function

The pim ipv6 dm command enables PIM-DM (IPv6) on an interface.

The undo pim ipv6 dm command restores the default configuration.

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

Format

pim ipv6 dm

undo pim ipv6 dm

Parameters

None

Views

Ethernet interface view, GE interface view, XGE interface view, 40GE interface view, 100GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

PIM-DM (IPv6) is a multicast routing protocol in dense mode and applies to small-scale networks with densely-distributed group members.

After PIM-DM (IPv6) is enabled on an interface, the switch can set up the PIM neighbor relationship with the neighboring device. The switch then can 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.

Precautions

PIM-DM (IPv6) and PIM-SM (IPv6) cannot be enabled simultaneously on the device.

If PIM-DM (IPv6) and MLD need to be enabled on the same interface, enable PIM-DM (IPv6), and then enable MLD.

Running the pim ipv6 dm command failed on the VLANIF interface because Layer 2 multicast querier or report-suppress is enabled for this VLAN.

If both Layer 2 and Layer 3 multicast services are required in a VLAN, enable PIM (IPv6) on the corresponding VLANIF interface first, and then enable MLD snooping in the VLAN. If MLD snooping is enabled in the VLAN first, PIM (IPv6) cannot be enabled on the VLANIF interface.

Example

# Enable PIM-DM (IPv6) on VLANIF100.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] pim ipv6 dm
# Enable PIM-DM (IPv6) on GE1/0/1.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] undo portswitch
[HUAWEI-GigabitEthernet1/0/1] pim ipv6 dm

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

Ethernet interface view, GE interface view, XGE interface view, 40GE interface view, 100GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

The DR is elected based on the priority and the IPv6 address. Switches send Hello messages carrying their priorities to each other, and the one with the highest priority becomes the DR. If the switches have the same priority, the switch with the largest IPv6 address becomes the DR.

If at least one device in the network does not support Hello packets that contain the priority, 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.

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] pim ipv6 hello-option dr-priority 3
# Set the priority of GE1/0/1 that is elected as DR to 3.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] undo portswitch
[HUAWEI-GigabitEthernet1/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

Ethernet interface view, GE interface view, XGE interface view, 40GE interface view, 100GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a PIM (IPv6) network, after a switch receives a Hello message from its PIM neighbor, it starts a timer based on Holdtime value in the Hello message. If the switch does not receive any Hello message from its PIM neighbor when the timer expires, the switch 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.

Precautions

The timeout period must be greater than the interval for sending Hello messages, which is set using the pim ipv6 time hello command.

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

Ethernet interface view, GE interface view, XGE interface view, 40GE interface view, 100GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Hello messages sent switches carry lan-delay and override-interval values. The lan-delay parameter indicates the delay in transmitting messages in the LAN. If devices on the same link have different lan-delay values, the maximum value is used.

When a switch sends a Prune message to the upstream device in the same network segment, the other devices that still request multicast data need to send a Join message to the upstream device within the override-interval period.

The value of the Prune-Pending Timer (PPT) is the sum of lan-delay and override-interval values and refer to the delay from the current device receiving a Prune message from the downstream interface to performing the prune action. If the switch receives a Join message from the downstream interface before the PPT timer expires, it cancels the prune action.

Prerequisites

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

Precautions

This command is valid for PIM-SM (IPv6) and PIM-DM (IPv6).

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] pim ipv6 hello-option lan-delay 200
# Set the delay in transmitting messages to 200 ms on GE1/0/1.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] undo portswitch
[HUAWEI-GigabitEthernet1/0/1] pim ipv6 hello-option lan-delay 200

pim ipv6 hello-option neighbor-tracking

Function

The pim ipv6 hello-option neighbor-tracking command enables the neighbor tracking function in the interface view.

The undo pim ipv6 hello-option neighbor-tracking command restores the default configuration.

By default, the neighbor tracking function is not enabled.

Format

pim ipv6 hello-option neighbor-tracking

undo pim ipv6 hello-option neighbor-tracking

Parameters

None

Views

Ethernet interface view, GE interface view, XGE interface view, 40GE interface view, 100GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When sending a Hello message, a switch generates a Generation ID and encapsulates it into the message. The Generation ID changes only when the device status changes. In this case, the neighboring device detects the Generation ID change after receiving the Hello message and immediately sends a Join message to the device to update the neighbor relationship. If multiple devices on the shared network segment prepare to send Join messages to the same upstream PIM neighbor, only one device is allowed to send the Join message. After other devices detect the Join message, they do not send Join messages to the upstream neighbor. This means that the upstream neighbor cannot update neighbor relationships with downstream devices after a Generation ID change.

After the neighbor tracking function is enabled, when the device detects Join messages from other devices, the device still sends the Join messages to the same upstream PIM neighbor.

Prerequisites

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

Precautions

This command is valid for only PIM-SM (IPv6).

The neighbor tracking function can be implemented on a shared network segment only when this function is enabled on all devices on the network segment.

The pim ipv6 hello-option neighbor-tracking command has the same function as the hello-option neighbor-tracking (IPv6) command in the PIM-IPv6 view. By default, if the pim ipv6 hello-option neighbor-tracking command is not used, the configuration in the PIM-IPv6 view takes effect; otherwise, the configuration in the interface view takes effect.

Example

# Enable the neighbor tracking function on VLANIF100.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] pim ipv6 hello-option neighbor-tracking
# Enable the neighbor tracking function on GE1/0/1.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] undo portswitch
[HUAWEI-GigabitEthernet1/0/1] pim ipv6 hello-option neighbor-tracking

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

Ethernet interface view, GE interface view, XGE interface view, 40GE interface view, 100GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

When a switch sends a Prune message to the upstream device in the same network segment, the other devices that still request multicast data need to send a Join message to the upstream device within the override-interval period.

If switches on the same link have different values, the maximum value is used.

The value of PPT is the sum of lan-delay and override-interval values. When receiving a Prune message from a downstream interface, the switch does not perform the prune action until the PPT expires. If the switch receives a Join message from the downstream interface before the PPT expires, it cancels the Prune action.

Prerequisites

IPv6 multicast routing has been enabled using the multicast ipv6 routing-enable command in the system 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] pim ipv6 hello-option override-interval 2000
# Set the interval for overriding the prune action in Hello messages to 2000 ms on GE1/0/1.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] undo portswitch
[HUAWEI-GigabitEthernet1/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

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

Precautions

This command is valid for PIM-SM (IPv6) and PIM-DM (IPv6).

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] pim ipv6 holdtime assert 100
# Set the timeout period for GE1/0/1 to keep the Assert state to 100s.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] undo portswitch
[HUAWEI-GigabitEthernet1/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

Ethernet interface view, GE interface view, XGE interface view, 40GE interface view, 100GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback 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 hold timer. If this message carries group-join information and the switch does not receive subsequent Join/Prune messages from the downstream device when the timer expires, it suppresses multicast data forwarding to downstream interfaces of the specified group. If Join/Prune message carries group-prune information, the switch resumes multicast data forwarding to downstream interfaces when the hold timer expires.

Prerequisites

IPv6 multicast routing has been enabled using the multicast ipv6 routing-enable command in the system 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] pim ipv6 holdtime join-prune 280
# Set the holdtime in a Join/Prune message sent by GE1/0/1 to 280 seconds.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] undo portswitch
[HUAWEI-GigabitEthernet1/0/1] pim ipv6 holdtime join-prune 280

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.
NOTE:
acl6-name acl6-name can only be the name of a named advanced ACL.

The value is a string of 1 to 64 case-sensitive characters without spaces. The value must start with a letter.

The referenced named ACL6 must be an advanced ACL6.

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

Ethernet interface view, GE interface view, XGE interface view, 40GE interface view, 100GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback 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 by filtering join information in Join/Prune messages, run the pim ipv6 join-policy command.

Prerequisites

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

Configuration Impact

This command is valid for only IPv6 PIM-SM.

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

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

The rule configurations for a named ACL and an advanced ACL are the same. The time-range parameter takes effect in the rule command only for the named ACL.

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] 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-adv-myacl] rule permit ipv6 source fc00:0:0:2001::4 128 destination ff35::1 128
[HUAWEI-acl6-adv-myacl] quit
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] pim ipv6 join-policy ssm acl6-name myacl
# Configure GE1/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 gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] undo portswitch
[HUAWEI-GigabitEthernet1/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 ACL name.
NOTE:
acl6-name acl6-name can only be the name of a named advanced ACL.

The value is a string of 1 to 64 case-sensitive characters without spaces. The value must start with a letter.

The referenced named ACL6 must be an advanced ACL6.

Views

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

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

This command is valid for both PIM-DM (IPv6) and PIM-SM (IPv6).

When configuring the neighbor filtering function on the interface, you must also configure the neighbor filtering function correspondingly on the PIM neighbor of the interface.

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] pim ipv6 neighbor-policy 2001
# Configure GE1/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 gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] undo portswitch
[HUAWEI-GigabitEthernet1/0/1] pim ipv6 neighbor-policy 2001

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

Ethernet interface view, GE interface view, XGE interface view, 40GE interface view, 100GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

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.

Precautions

This command is valid for both PIM-DM (IPv6) and PIM-SM (IPv6).

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] pim ipv6 require-genid
# Configure GE1/0/1 to reject the Hello messages without the Generation ID.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] undo portswitch
[HUAWEI-GigabitEthernet1/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

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

Precautions

Running the pim ipv6 silent command failed on the VLANIF interface because Layer 2 multicast querier or report-suppress is enabled for this VLAN.

If PIM BFD (IPv6) function is enabled on the interface, this command cannot be configured.

This command and pim ipv6 timer dr-switch-delay command are mutually exclusive.

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] pim ipv6 silent
# Configure the PIM silent (IPv6) function on GE1/0/1.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] undo portswitch
[HUAWEI-GigabitEthernet1/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

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

Precautions

PIM-DM (IPv6) and PIM-SM (IPv6) cannot be enabled simultaneously on the device.

If PIM-SM (IPv6) and MLD need to be enabled on the same interface, enable PIM-SM (IPv6), and then enable MLD.

Running the pim ipv6 sm command failed on the VLANIF interface because Layer 2 multicast querier or report-suppress is enabled for this VLAN.

If both Layer 2 and Layer 3 multicast services are required in a VLAN, enable PIM (IPv6) on the corresponding VLANIF interface first, and then enable MLD snooping in the VLAN. If MLD snooping is enabled in the VLAN first, PIM (IPv6) cannot be enabled on the VLANIF interface.

Example

# Enable PIM-SM (IPv6) on VLANIF100.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] pim ipv6 sm
# Enable PIM-SM (IPv6) on GE1/0/1.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] undo portswitch
[HUAWEI-GigabitEthernet1/0/1] pim ipv6 sm

pim ipv6 state-refresh-capable

Function

The pim ipv6 state-refresh-capable command enables PIM-DM (IPv6) State-Refresh on an interface.

The undo pim ipv6 state-refresh-capable command disables PIM-DM (IPv6) State-Refresh.

By default, PIM-DM (IPv6) State-Refresh is enabled.

Format

pim ipv6 state-refresh-capable

undo pim ipv6 state-refresh-capable

Parameters

None

Views

Ethernet interface view, GE interface view, XGE interface view, 40GE interface view, 100GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

PIM-DM (IPv6) State-Refresh is implemented by periodically sending State-Refresh messages in the network. After receiving a State-Refresh message, the switch in the pruned state resets the prune-status timer, preventing the downstream interface from forwarding packets.

After PIM-DM (IPv6) state-refresh is disabled, the interface starts to forward multicast data when the prune timer expires. The downstream routers that do not require the data send Prune messages. The process repeats and wastes a lot of network resources. Enabling PIM-DM (IPv6) State-Refresh can reduce traffic on the network.

Prerequisites

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

Precautions

This command is valid for only PIM-DM (IPv6).

Example

# Disable PIM-DM (IPv6) State-Refresh on VLANIF100.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] undo pim ipv6 state-refresh-capable
# Disable PIM-DM (IPv6) State-Refresh on GE1/0/1.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] undo portswitch
[HUAWEI-GigabitEthernet1/0/1] undo pim ipv6 state-refresh-capable

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

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

Precautions

This command is valid for only PIM-SM (IPv6).

This command and pim ipv6 silent command are mutually exclusive.

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] pim ipv6 timer dr-switch-delay 20
# Enable PIM DR switching delay on GE1/0/1 and set the delay to 20 seconds.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] undo portswitch
[HUAWEI-GigabitEthernet1/0/1] pim ipv6 timer dr-switch-delay 20

pim ipv6 timer graft-retry

Function

The pim ipv6 timer graft-retry command sets the interval for retransmitting Graft messages on an interface.

The undo pim ipv6 timer graft-retry command restores the default value of the interval.

By default, the interval for retransmitting Graft messages on an interface is 3 seconds.

Format

pim ipv6 timer graft-retry interval

undo pim ipv6 timer graft-retry

Parameters

Parameter Description Value
interval Specifies the interval of retransmitting Graft messages. The value is an integer that ranges from 1 to 65535, in seconds.

Views

Ethernet interface view, GE interface view, XGE interface view, 40GE interface view, 100GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In PIM-DM (IPv6) mode, when a member joins a pruned group, the switch sends a Graft message and waits to receive an ACK message from the upstream switch. If the downstream switch does not receive the ACK message in the period configured through the command, the switch resends the Graft message until the switch receives the ACK message from the upstream switch.

Prerequisites

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

Precautions

This command is valid for only PIM-DM (IPv6).

Example

# Set the interval for retransmitting Graft messages to 80s on VLANIF100.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] pim ipv6 timer graft-retry 80
# Set the interval for retransmitting Graft messages to 80s on GE1/0/1.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] undo portswitch
[HUAWEI-GigabitEthernet1/0/1] pim ipv6 timer graft-retry 80

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

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

Precautions

This command is valid for both PIM-DM (IPv6) and PIM-SM (IPv6).

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. The configuration in the interface view takes precedence over the configuration in the PIM-IPv6 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] pim ipv6 timer hello 40
# Set the interval for sending Hello messages to 40 seconds on GE1/0/1.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] undo portswitch
[HUAWEI-GigabitEthernet1/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

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

Precautions

This command is valid for both PIM-DM (IPv6) and PIM-SM (IPv6).

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] pim ipv6 timer join-prune 80
# Set the interval for sending Join or Prune messages to 80 seconds on GE1/0/1.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] undo portswitch
[HUAWEI-GigabitEthernet1/0/1] pim ipv6 timer join-prune 80

pim ipv6 triggered-hello-delay

Function

The pim ipv6 triggered-hello-delay command sets the maximum delay for triggering Hello messages.

The undo pim ipv6 triggered-hello-delay command restores the default maximum delay.

By default, the maximum delay for triggering Hello messages is 5 seconds.

Format

pim ipv6 triggered-hello-delay interval

undo pim ipv6 triggered-hello-delay

Parameters

Parameter Description Value
interval Specifies the maximum delay for triggering Hello messages. The value is an integer that ranges from 1 to 5, in seconds.

Views

Ethernet interface view, GE interface view, XGE interface view, 40GE interface view, 100GE interface view, Eth-Trunk interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Conflicts will occur if multiple PIM devices sending Hello message at the same time. To avoid such conflicts, when a PIM device detects Hello messages on the network, it waits for a random delay that is smaller than the value configured using this command before sending a Hello message.

To avoid the conflict caused by multiple PIM devices sending Hello message at the same time, the PIM device automatically selects a random number smaller than the configured value as the delay. When detecting Hello messages in the network, the PIM device sends Hello message after the delay.

Prerequisites

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

Example

# Set the maximum delay for triggering the Hello message to 3 seconds.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] pim ipv6 triggered-hello-delay 3
# Set the maximum delay for triggering the Hello message to 3 seconds.
<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] interface gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] undo portswitch
[HUAWEI-GigabitEthernet1/0/1] pim ipv6 triggered-hello-delay 3

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

This command is valid for only PIM-SM (IPv6).

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 ACL.
NOTE:
acl6-name acl6-name can only be the name of a named advanced ACL.

The value is a string of 1 to 64 case-sensitive characters without spaces. The value must start with a letter.

The referenced named ACL6 must be an advanced ACL6.

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.

This command is valid for only PIM-SM (IPv6).

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-adv-3000] rule permit ipv6 source fc00:0:0:2001::2 64 destination ff02:13:: 64
[HUAWEI-acl6-adv-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-adv-myacl6] rule permit ipv6 source fc00:0:0:2001::2 64 destination ff02:13:: 64
[HUAWEI-acl6-adv-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.

Before specifying the source IPv6 unicast address for sending Register messages, enable PIM-SM.

Precautions

The command is effective only when the specified interface is in Up state.

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

This command is valid only for PIM-SM (IPv6).

If the timeout period is too short, the RP receives burst multicast data more frequently. If the timeout period is too long, there will be a long delay for a new receiver to join a group 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 has been forwarding multicast packets for a long time, the switch 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

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

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

This command is valid for only PIM-SM (IPv6).

Clearing PIM status of the downstream interfaces can trigger sending of Join/Prune messages, which causes 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 (S, G) entries 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 | infinity } [ group-policy { acl6-name acl6-name | acl6-number } ]

undo source-lifetime

undo source-lifetime { interval | infinity } [ group-policy { acl6-name acl6-name | acl6-number } ]

Parameters

Parameter Description Value
interval Specifies the timeout period of (S, G) entries on the switch. The value is an integer that ranges from 60 to 65535, in seconds.
infinity Indicates that (S, G) entries on the switch will never age out. -
group-policy Specifies a group policy to determine to which the configured timeout period takes effect. -
acl6-number Specifies the number of a basic or advanced ACL. The value is an integer that ranges from 2000 to 3999.
acl6-name acl6-name Specifies the name of an ACL.
NOTE:
This parameter applies only to named advanced ACLs.
The value is a string of 1 to 64 case-sensitive characters without any space. The string must start with a letter.

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.

  • If you configure source-lifetime interval, the configured timeout period applies to all (S, G) entries.
  • If you configure source-lifetime interval { group-policy { acl6-name acl6-name | acl6-number } }:
    • If you specify an advanced ACL name in the command, the configured timeout period applies to the (S, G) entries in which the source and group addresses are permitted by the specified ACL.
    • If you specify a basic ACL number in the command, the configured timeout period applies to the (S, G) entries in which the source addresses are permitted by the specified ACL.
    • If you specify an advanced ACL number in the command, the configured timeout period applies to the (S, G) entries in which the source and group addresses are permitted by the specified ACL.
  • If you configure source-lifetime infinity, all (S, G) entries will never age out.
  • If you configure source-lifetime infinity { group-policy { acl6-name acl6-name | acl6-number } }:
    • If you specify an advanced ACL name in the command, the (S, G) entries in which the source and group addresses are permitted by the specified ACL will never age out.
    • If you specify a basic ACL number in the command, the (S, G) entries in which the source addresses are permitted by the specified ACL will never age out.
    • If you specify an advanced ACL number in the command, the (S, G) entries in which the source and group addresses are permitted by the specified ACL will never age out.

If you run this command multiple times for the same range of multicast forwarding entries and specify interval and infinity respectively in the commands, infinity takes precedence over interval.

Prerequisites

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

Precautions

This command is valid for both PIM-DM (IPv6) and PIM-SM (IPv6).

Example

# Set the timeout period of (S, G) entries on 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 ACL.
NOTE:
acl6-name acl6-name can only be the name of a named advanced ACL.

The value is a string of 1 to 64 case-sensitive characters without spaces. The value must start with a letter.

The referenced named ACL6 must be an advanced ACL6.

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 a basic ACL is referenced in the policy, all multicast data packets that do not match the specified source addresses are discarded.

If an advanced ACL is referenced in the policy, all received multicast data packets that do not match the specified source and group addresses are discarded.

The configurations of the named ACL and advanced ACL are the same, and can filter both source addresses and group addresses. A named ACL can also be configured with the time-range parameter.

Precautions

This command is valid for both PIM-DM (IPv6) and PIM-SM (IPv6).

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 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-adv-myacl6] rule permit ipv6 source fc00:0:0:3121::1 128
[HUAWEI-acl6-adv-myacl6] rule deny ipv6 source fc00:0:0:3121::2 128
[HUAWEI-acl6-adv-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 ACL.
NOTE:
acl6-name acl6-name can only be the name of a named advanced ACL.

The value is a string of 1 to 64 case-sensitive characters without spaces. The value must start with a letter.

The referenced named ACL6 must be an advanced ACL6.

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 the 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 first matched command takes effect.

This command is valid to all devices that may function as the DR at the member side, but is invalid to RPs.

Precautions

This command is valid for only PIM-SM (IPv6).

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
# Add a group-policy: the ACL name, rate threshold, and order of the group-policy are myacl6, 100 kbit/s, and 1 respectively.
<HUAWEI> system-view
[HUAWEI] acl ipv6 name myacl6
[HUAWEI-acl6-adv-myacl6] rule permit ipv6 destination ff03::101 128
[HUAWEI-acl6-adv-myacl6] quit
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] pim-ipv6
[HUAWEI-pim6] spt-switch-threshold 100 group-policy acl6-name myacl6 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. (The value of x ranges from 0 to F.)

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 ACL.
NOTE:
acl6-name acl6-name can only be the name of a named advanced ACL.

The value is a string of 1 to 64 case-sensitive characters without spaces. The value must start with a letter.

The referenced named ACL6 must be an advanced ACL6.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, the SSM group address range is FF3x::/32. The value of x ranges from 0 to F. 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.

Precautions

This command is valid for only PIM-SM (IPv6).

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
[HUAWEI-acl6-adv-myacl6] rule permit ipv6 destination ff31:0:8192:: 96
[HUAWEI-acl6-adv-myacl6] quit
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] pim-ipv6
[HUAWEI-pim6] ssm-policy acl6-name myacl6

state-refresh-interval (IPv6)

Function

The state-refresh-interval command sets the interval for sending PIM State-Refresh messages.

The undo state-refresh-interval command restores the default value of the interval.

By default, the interval for sending PIM State-Refresh messages is 60 seconds.

Format

state-refresh-interval interval

undo state-refresh-interval

Parameters

Parameter Description Value
interval Specifies the interval for sending PIM State-Refresh messages. The value is an integer that ranges from 1 to 255, in seconds.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On the PIM-DM (IPv6) network, the device periodically sends State-Refresh messages to update the timeout interval of the prune timer on the downstream device. By doing this, the interface that has no multicast requirements retains in prune state.

Prerequisites

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

Precautions

This command is valid for only PIM-DM (IPv6).

To prevent a pruned interface from forwarding packets when the Prune status times out, the interval for sending State-Refresh messages is shorter than the period for keeping the Prune status.

You can run the holdtime join-prune (IPv6) command to set the period during which the device keeps the Prune status.

This command takes effect only when it is run on the routers directly connected to the source.

Example

# Set the interval for sending PIM State-Refresh messages to 70s.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] pim-ipv6
[HUAWEI-pim6] state-refresh-interval 70

state-refresh-rate-limit (IPv6)

Function

The state-refresh-rate-limit command sets the minimum period to wait before receiving the next PIM State-Refresh message.

The undo state-refresh-rate-limit command restores the default value.

By default, the minimum period to wait to receive the next PIM State-Refresh message is 30 seconds.

Format

state-refresh-rate-limit interval

undo state-refresh-rate-limit

Parameters

Parameter Description Value
interval Specifies the minimum period for waiting to receive the next PIM State-Refresh message. 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

A switch can receive multiple PIM State-Refresh messages in a short period. Some of the messages are the same. To avoid duplicate messages, you can run the state-refresh-rate-limit command to set the period to wait to receive the next State-Refresh message.

  • Before the State-Refresh timer times out, the switch discards the received duplicate State-Refresh messages.

  • After the State-Refresh timer times out, the switch can receive the next State-Refresh message.

Prerequisites

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

Precautions

This command is valid for only PIM-DM (IPv6).

Example

# Set the minimum period to wait to receive the next PIM State-Refresh message to 45s.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] pim-ipv6
[HUAWEI-pim6] state-refresh-rate-limit 45

state-refresh-ttl (IPv6)

Function

The state-refresh-ttl command sets the TTL value for sending PIM State-Refresh messages.

The undo state-refresh-ttl command restores the default value of the TTL.

By default, the TTL value for sending PIM State-Refresh messages is 255.

Format

state-refresh-ttl ttl-value

undo state-refresh-ttl

Parameters

Parameter Description Value
ttl-value Specifies the minimum TTL value of the PIM state refresh message sent by an interface. The value is an integer that ranges from 1 to 255.

Views

PIM-IPv6 view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After receiving a State-Refresh message, the switch decreases the value of the TTL in the message by 1, and then sends the message to the downstream switch until the value of the TTL becomes 0. If the scale of the network is small, the message is delivered in a loop.

You can use the state-refresh-ttl command to set the value of the TTL according to the scale of the network.

Prerequisites

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

Precautions

This command is valid for only PIM-DM (IPv6).

This command takes effect only when it is run on the routers directly connected to the source.

Example

# Set the TTL value for sending PIM State-Refresh messages to 45.

<HUAWEI> system-view
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] pim-ipv6
[HUAWEI-pim6] state-refresh-ttl 45

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 ]

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 ACL.
NOTE:
acl6-name acl6-name can only be the name of a named advanced ACL.

The value is a string of 1 to 64 case-sensitive characters without spaces. The value must start with a letter.

The referenced named ACL6 must be an advanced ACL6.

preferred Indicates that the static RP is preferred. -

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.

Prerequisites

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

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.

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 a Named ACL: the switch with the address of FC00:0:0:1111::1111 functions as the static RP in the PIM-SM (IPv6) domain and serves groups defined by the ACL myacl6; preferential use of the static RP is enabled.
<HUAWEI> system-view
[HUAWEI] acl ipv6 name myacl6
[HUAWEI-acl6-adv-myacl6] rule permit ipv6 destination ff03::101 128
[HUAWEI-acl6-adv-myacl6] quit
[HUAWEI] multicast ipv6 routing-enable
[HUAWEI] pim-ipv6
[HUAWEI-pim6] static-rp fc00:0:0:1111::1111 acl6-name myacl6 preferred

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

This command is valid for both PIM-DM (IPv6) and PIM-SM (IPv6).

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

This command is valid for both PIM-DM (IPv6) and PIM-SM (IPv6).

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

This command is valid for only PIM-SM (IPv6).

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-10-18

Document ID: EDOC1000178288

Views: 26148

Downloads: 109

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