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

AR500, AR510, and AR530 V200R007 Commands Reference

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 (IPv4) Configuration Commands

PIM (IPv4) Configuration Commands

NOTE:

AR502G-L-D-H and AR502GR-L-D-H do not support this function.

anycast-rp (IPv4)

Function

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

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

By default, no Anycast RP is configured.

Format

anycast-rp rp-address

undo anycast-rp rp-address

Parameters

Parameter Description Value
rp-address Indicates the Anycast RP address. The value is in dotted decimal notation. This address must be a valid unicast IP address and cannot be an address on the network segment 127.0.0.0/8.

Views

PIM view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

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

Currently, the Anycast RP can be implemented in a PIM domain by using the following schemes:
  • MSDP Anycast RP, which is applicable to IPv4 networks

  • PIM Anycast RP, which is applicable to IPv4 networks

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Configuration Impact

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

Precautions

  • In IPv4 network deployment, you can choose either of the two schemes. Mixed use of the two schemes is not recommended.

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

  • In a single instance, you can configure a maximum of four Anycast RP addresses on each device.

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

Example

# Set the Anycast RP address to 10.10.10.10 in the public network instance and enter the Anycast-RP view.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] anycast-rp 10.10.10.10
[Huawei-pim-anycast-rp-10.10.10.10]

auto-rp listening enable

Function

The auto-rp listening enable command enables the auto-RP listening function. A device receives auto-RP announcement and discovery messages and learns RP information from the messages.

The undo auto-rp listening enable command restores the default configuration.

By default, auto-RP listening is disabled.

Format

auto-rp listening enable

undo auto-rp listening enable

Parameters

None

Views

PIM view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The auto-RP listening function enables the device to receive auto-RP announcement and discovery messages and learn RP information from the messages. After receiving an Auto-RP Advertisement or Discovery message, the device obtains the source address of the message, and then performs reverse path forwarding (RPF) check based on the source address. If the RPF check fails, the device discards the packet. If the RPF check succeeds, the device forwards the packet to other PIM neighbors.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Example

# In the public network instance, enable auto-RP listening on a industrial switch router.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] auto-rp listening enable

bsm semantic fragmentation (IPv4)

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 view of public network instance or PIM view of VPN instance

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

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

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. During the transmission of BSR message fragments to the destination, if one fragment is lost, 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. During the transmission of BSR message fragments to the destination, if one fragment is lost, only the information carried in this fragment is lost. As a result, only MDTs corresponding to the information carried in the lost fragments cannot be established. Since the other BSR message fragments can still reach the destination, the corresponding MDTs can be correctly established.

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

Precautions

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

Example

# Enable BSR message fragmentation in the public network instance.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] bsm semantic fragmentation

bsr-policy (IPv4)

Function

The bsr-policy command specifies the range of valid bootstrap router (BSR) addresses. Then the industrial switch router drops the BSR messages sent from the addresses out of this range to defend against 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-acl-number | acl-name acl-name }

undo bsr-policy

Parameters

Parameter Description Value
basic-acl-number Specifies the basic ACL number. The ACL defines the filtering policy for the range of source addresses of BSR packets. This parameter corresponds to basic-acl-number in the acl command. The value is an integer that ranges from 2000 to 2999.
acl-name acl-name Specifies the name of a named ACL.
NOTE:
acl-name acl-name can only be the name of a named advanced ACL.
The value is a string of 1 to 32 case-sensitive characters without spaces. The value must start with a letter (a to z or A to Z, case sensitive).

Views

PIM view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

  • Certain hosts try changing the RP mapping to spoof the industrial switch router by forging BSR packets.

    Solution: The attack often occurs on edge industrial switch routers because the BSR packet is a multicast packet and the TTL value of the BSR packet is 1. The BSR is inside the network, and hosts are outside the network. The industrial switch routers can perform neighbor check and RPF check on the received BSR packets to prevent the attack.

  • Certain attackers control the industrial switch router on the network, or the industrial switch router accesses the network. The attackers configure the industrial switch router as a C-BSR, and help the industrial switch router win the BSR election. The attackers obtain the right of advertising RP information in the network.

    Solution: After the industrial switch router is configured as a C-BSR, the industrial switch router spreads BSR packets in the network. The BSR packets are multicast packets. The TTL value of BSR packets is 1. The BSR packets are forwarded hop by hop. As long as the neighboring industrial switch router cannot receive the packets, the packets are not spread in the entire network. The solution is to use the bsr-policy command on every industrial switch router in the network to limit the valid BSR range. For example, only industrial switch routers 10.1.1.1/32 and 10.1.1.2/32 are elected as BSRs; therefore, the industrial switch routers do not receive or forward other BSR packets. This type of attack is prevented.

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

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Configuration Impact

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

Precautions

The bsr-policy command and the acl 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 command.

When you use the rule 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 public network instance, configure address 10.1.1.0/24 as the valid BSR address range.
<Huawei> system-view
[Huawei] acl number 2001
[Huawei-acl-basic-2001] rule permit source 10.1.1.0 0.0.0.255
[Huawei-acl-basic-2001] quit
[Huawei] pim
[Huawei-pim] bsr-policy 2001
# In the public network instance, use a Named ACL to configure address 10.1.1.0/24 as the valid BSR address range.
<Huawei> system-view
[Huawei] acl name myacl
[Huawei-acl-adv-myacl] rule permit ip source 10.1.1.0 0.0.0.255
[Huawei-acl-adv-myacl] quit
[Huawei] pim
[Huawei-pim] bsr-policy acl-name myacl

c-bsr (IPv4)

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 interface-type interface-number [ hash-length [ priority ] ]

undo c-bsr

Parameters

Parameter Description Value
interface-type interface-number Specifies the type and the number of an interface. C-BSR is configured on this interface. PIM-SM must be enabled on this interface to make the configuration effective.
NOTE:

To avoid frequent protocol changes caused by interface flapping, using loopback interfaces is recommended.

-
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 32. By default, the value is 30.
priority Specifies a priority of the C-BSR. The greater the value, the higher the priority of the C-BSR. The value is an integer ranging from 0 to 255. By default, the value is 0.

Views

PIM view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

The process of BSR election is as follows:

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

  2. 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 IP address is preferred. If the BSR carried in the received Bootstrap message is better than the current BSR, the C-BSR replaces its BSR address with the address of the BSR carried in the received Bootstrap message.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Before configuring an interface as a C-BSR, enable PIM-SM on the interface.

Example

# In the public network instance, configure a C-BSR on GE0/0/1.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] pim sm
[Huawei-GigabitEthernet0/0/1] quit
[Huawei] pim
[Huawei-pim] c-bsr gigabitethernet 0/0/1
Related Topics

c-bsr admin-scope

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 view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, each PIM-SM domain has only one BSR and the BSR 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 domains 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 domain maintains one BSR that serves multicast groups on network segment 239.0.0.0/8. Multicast packets for groups on this network segment cannot pass through the border of the BSR administrative domain. Multicast groups that do not belong to any BSR administrative domain belong to a global domain. The global domain maintains a BSR, serving all the remained multicast groups, namely, multicast groups beyond the range 239.0.0.0/8.

A BSR administrative domain is similar to a VPN in unicast and multicast address segment 239.0.0.0/8 equals unicast address segment 10.0.0.0/8. Other multicast group addresses can be used on the public network and address conflicts need be avoided. If a PIM-SM domain is divided into different BSR administrative domains, each BSR administrative domain equals a VPN, serving the multicast groups on the network segment 239.0.0.0/8. You can use the same multicast group address in different BSR administration domains. If you configure the BSR in a BSR administration domain to serve multicast groups beyond 239.0.0.0/8, a message indicating a configuration error will be displayed.

The c-bsr admin-scope command configures a BSR administrative scope on the industrial switch router.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

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

Example

# In the public network instance, configure a BSR administrative scope in a PIM-SM domain.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] c-bsr admin-scope
Related Topics

c-bsr global

Function

The c-bsr global command configures the industrial switch router 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 32. By default, the value is 30.
priority priority Specifies the priority of the C-BSR in the global domain. The greater the value, the higher the priority of the C-BSR. The value is an integer ranging from 0 to 255. By default, it is 0.

Views

PIM view of public network instance or PIM view of VPN instance

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 industrial switch router as a C-BSR in the global domain. The BSR in the global domain is generated through election.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

The c-bsr global command takes effect only in a BSR administrative domain. This means that the c-bsr global command can enable a device in a BSR administrative domain to accept multicast data of group out of the BSR administrative domain.

The c-bsr global command needs to be used together with the c-bsr admin-scope command.

Example

# In the public network instance, configure the industrial switch router as a C-BSR in the global domain, and then set the priority of the C-BSR to 1.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] c-bsr global priority 1

c-bsr group

Function

The c-bsr group command specifies the range of multicast groups that an administrative domain can serve on a C-BSR.

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

By default, range of multicast groups that an administrative domain can serve is not configured.

Format

c-bsr group group-address { mask | mask-length } [ hash-length hash-length | priority priority ] *

undo c-bsr group group-address

Parameters

Parameter Description Value
group-address Specifies a multicast group address. The address is in dotted decimal notation. The value ranges from 239.0.0.0 to 239.255.255.255.
mask Specifies the mask of a multicast group address. The address is in dotted decimal notation.
mask-length Indicates the mask length of a multicast address. The value is an integer ranging from 8 to 32.
hash-length hash-length Specifies the hash mask length for the C-BSR in a BSR administrative domain. The value is an integer ranging from 0 to 32. By default, it is 30.
priority priority Specifies the priority of the C-BSR in the BSR administrative domain. A larger value indicates a higher priority. The value is an integer ranging from 0 to 255. By default, it is 0.

Views

PIM view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a PIM-SM domain is divided into different BSR administrative domains, configure a multicast group address for each BSR administrative domain on the C-BSR. The group addresses must be in the range of 239.0.0.0/8. The group address ranges served by different BSR administrative domains can overlap. The address of a multicast group that a BSR administrative domain serves is used as a private group address.

By running this command on the C-BSR of each administrative domain, you can specify the group address of the administrative domain served by each C-BSR and priority of each C-BSR.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Example

# In the public network instance, configure a C-BSR in the BSR administrative domain to serve groups 239.0.0.0/8, and set the priority of the C-BSR to 10.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] c-bsr group 239.0.0.0 255.0.0.0 priority 10

c-bsr hash-length (IPv4)

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

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

Views

PIM view of public network instance or PIM view of VPN instance

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 industrial switch router 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

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

You can run the c-bsr interface-type interface-number hash-length command in the PIM view to configure the C-BSR interface and specify the hash mask length. The c-bsr hash-length hash-length command specifies the global hash mask length. If both c-bsr interface-type interface-number hash-length and c-bsr hash-length hash-length are used, the c-bsr interface-type interface-number hash-length command takes effect.

Example

# In the public network instance, set the global hash mask length of a C-BSR to 16.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] c-bsr hash-length 16

c-bsr holdtime (IPv4)

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 view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a C-BSR is elected as the BSR, the C-BSR periodically sends Bootstrap messages carrying the IP address of the C-BSR 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. After the BSR times out, the C-BSRs receive new BSR messages.

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

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 60 seconds (s) and the default holdtime is 130s.

Example

# In the public network instance, 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 routing-enable
[Huawei] pim
[Huawei-pim] c-bsr holdtime 150

c-bsr interval (IPv4)

Function

The c-bsr interval command configures the interval for the BSR to continuously send Bootstrap messages.

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

By default, the interval for the BSR to continuously send Bootstrap messages is 60s.

Format

c-bsr interval interval

undo c-bsr interval

Parameters

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

Views

PIM view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

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

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

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

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 a multicast fault. 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 public network instance, set the interval for the C-BSR to continuously send Bootstrap messages to 30 seconds.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] c-bsr interval 30

c-bsr priority (IPv4)

Function

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

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

By default, the global priority of the C-BSR 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 greater the value, the higher the priority of the C-BSR. The value is an integer that ranges from 0 to 255.

Views

PIM view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

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

  • In the case of the same priority, the industrial switch router with the largest IP 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

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

You can run the c-bsr interface-type interface-number priority command in the PIM view to configure the C-BSR interface and specify the C-BSR priority. The c-bsr priority priority command specifies the global C-BSR priority. If both c-bsr interface-type interface-number priority and c-bsr priority priority are used, the c-bsr interface-type interface-number priority command takes effect.

Example

# In the public network instance, configure the global priority of the C-BSR to 5.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] c-bsr priority 5

c-rp (IPv4)

Function

The c-rp command configures the industrial switch router 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 interface-type interface-number [ group-policy { basic-acl-number | acl-name acl-name } | priority priority | holdtime hold-interval | advertisement-interval adv-interval ] *

undo c-rp interface-type interface-number

Parameters

Parameter Description Value
interface-type interface-number Specifies the type and the number of an interface. The IP address of the specified interface is advertised as a C-RP address.
NOTE:

To avoid frequent protocol changes caused by interface flapping, using loopback interfaces is recommended.

-
group-policy basic-acl-number Specifies the range of the multicast groups served by a C-RP. The range is restricted to the multicast group range permitted by the specified ACL. The basic-acl-number parameter specifies the number of the basic ACL to identify the service range of the advertised RP. The value is an integer ranging from 2000 to 2999.
acl-name acl-name Specifies the name of a named ACL.
NOTE:
acl-name acl-name can only be the name of a named advanced ACL.
The value is a string of 1 to 32 case-sensitive characters without spaces. The value must start with a letter (a to z or A to Z, case sensitive).
priority priority Specifies the priority of a C-RP. The greater the value, the lower the priority. The value is an integer ranging from 0 to 255. The default value is 0.
holdtime hold-interval Specifies the timeout period during which the BSR waits to receive an Advertisement message from a C-RP. The value is an integer ranging from 1 to 65535, in seconds. The default value is 150.
advertisement-interval adv-interval Specifies the interval for a C-RP to send Advertisement messages. The value is an integer ranging from 1 to 65535, in seconds. The default value is 60.

Views

PIM view of the public network instance or PIM view of the VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

An RP is the core of a PIM-SM or Bidir-PIM domain, and therefore a C-RP must be able to communicate with the other devices in the PIM-SM or Bidir-PIM domain. You are advised to configure a C-RP on the core industrial switch router and reserve enough bandwidth between the industrial switch router and each of the other devices in the PIM-SM or Bidir-PIM domain.

An RP is elected from multiple C-RPs following these rules:

  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. If multiple C-RPs have the same priority, the C-RP with the largest hash value wins.

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

Prerequisites

  • IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

  • PIM-SM has been enabled on the interface that acts as the C-RP.

Configuration Impact

An interface is specified in the command; therefore, the settings of group-policy { basic-acl-number | acl-name acl-name }, priority priority, holdtime hold-interval and advertisement-interval adv-interval configured using this command override the global parameter settings that the interface obtains from the PIM view. If you run this command multiple times and specify the same interface, only the latest configuration takes effect.

NOTE:

If IP address unnumbered is configured, it is not recommended to configure C-RP on the interfaces that use the same addresses. If the interfaces have different priorities, the BSR considers that the C-RP configuration has been repeatedly modified.

Precautions

  • basic-acl-number 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, the C-RP serves all multicast groups.

  • To enable a C-RP to serve multiple PIM-SM domains, configure multiple rules in the ACL to specify multicast group ranges for the domains.

Example

# In the public network instance, use basic ACL 2069 to specify Loopback 0 as the C-RP for PIM-SM domains 225.1.0.0/16 and 226.2.0.0/16, and set the C-RP priority to 10.

<Huawei> system-view
[Huawei] acl number 2069
[Huawei-acl-basic-2069] rule permit source 225.1.0.0 0.0.255.255
[Huawei-acl-basic-2069] rule permit source 226.2.0.0 0.0.255.255
[Huawei-acl-basic-2069] quit
[Huawei] multicast routing-enable
[Huawei] interface loopback 0
[Huawei-LoopBack0] pim sm
[Huawei-LoopBack0] quit
[Huawei] pim
[Huawei-pim] c-rp loopback 0 group-policy 2069 priority 10
# In the public network instance, use named ACL myacl to specify Loopback 0 as the C-RP of PIM-SM multicast domains 225.1.0.0/16 and 226.2.0.0/16, and set the C-RP priority to 10.
<Huawei> system-view
[Huawei] acl name myacl
[Huawei-acl-adv-myacl] rule permit ip destination 225.1.0.0 0.0.255.255
[Huawei-acl-adv-myacl] rule permit ip destination 226.2.0.0 0.0.255.255
[Huawei-acl-adv-myacl] quit
[Huawei] multicast routing-enable
[Huawei] interface loopback 0
[Huawei-LoopBack0] pim sm
[Huawei-LoopBack0] quit
[Huawei] pim
[Huawei-pim] c-rp loopback 0 group-policy acl-name myacl priority 10
Related Topics

c-rp advertisement-interval (IPv4)

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 view of public network instance or PIM view of VPN instance

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

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

You can also set the advertisement interval when you run the c-rp interface-type interface-number advertisement-interval adv-interval command in the PIM view to configure the C-RP interface. The c-rp advertisement-interval interval command specifies the global advertisement interval. If both the commands are configured, the interval configured by the c-rp interface-type interface-number advertisement-interval adv-interval command takes effect.

Example

# In the public network instance, set the interval at which a C-RP sends Advertisement messages to 30s.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] c-rp advertisement-interval 30
Related Topics

c-rp holdtime (IPv4)

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 interval

undo c-rp holdtime

Parameters

Parameter Description Value
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 view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When interval is set on a C-RP, the C-RP encapsulates interval in an Advertisement message and sends it to the BSR. The BSR obtains this 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

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

You can also set the holdtime for a received Advertisement message when you run the c-rp interface-type interface-number holdtime hold-interval in the PIM view to configure a C-PR interface. The c-rp holdtime hold-interval configures the global hold time for Advertisement messages. If both the two commands are configured, the holdtime configured by the c-rp interface-type interface-number holdtime hold-interval command takes effect.

Example

# In the public network instance, set the holdtime for a received Advertisement message to 100s.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] c-rp holdtime 100
Related Topics

c-rp priority (IPv4)

Function

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

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

By default, the global priority of a C-RP is 0.

Format

c-rp priority priority

undo c-rp priority

Parameters

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

Views

PIM view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

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

  • The C-RP with highest priority wins.

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

  • If all the preceding factors are the same, the C-RP with the largest 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

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

You can run the c-rp interface-type interface-number priority priority command in the PIM view to configure the C-RP interface and specify the C-RP priority. The c-rp priority priority command specifies the global C-RP priority. If both c-rp interface-type interface-number priority priority and c-rp priority priority are used, the c-rp interface-type interface-number priority priority command takes effect.

Example

# In the public network instance, set the global priority of a C-RP to 5.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] c-rp priority 5
Related Topics

crp-policy (IPv4)

Function

The crp-policy 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-acl-number | acl-name acl-name }

undo crp-policy

Parameters

Parameter Description Value
advanced-acl-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.
acl-name acl-name Specifies the name of a named ACL.
NOTE:
acl-name acl-name can only be the name of a named advanced ACL.
The value is a string of 1 to 32 case-sensitive characters without spaces. The value must start with a letter (a to z or A to Z, case sensitive).

Views

PIM view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

To protect valid C-RP from being spoofed, configure crp-policy on BSR industrial switch routers 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

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Configuration Impact

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

Precautions

The crp-policy command and the acl command are used together. In the ACL view, you can set the valid source address range for the C-RP by specifying the source parameter in the rule command. You can set the address range of multicast groups that are served by specifying the destination parameter in the rule command.

Example

# Configure a C-RP policy on the C-BSR, which allows only the C-RP with the address 10.1.1.1/32 and allows the C-RP to serve only the multicast groups 225.1.0.0/16.

<Huawei> system-view
[Huawei] acl number 3100
[Huawei-acl-adv-3100] rule permit ip source 10.1.1.1 0 destination 225.1.0.0 0.0.255.255
[Huawei-acl-adv-3100] quit
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] crp-policy 3100
# Use a named ACL to configure a C-RP policy on the C-BSR : only 10.1.1.1/32 can function as the C-RP, and the C-RP is allowed to service only the multicast groups in the range of 225.1.0.0/16.
<Huawei> system-view
[Huawei] acl name myacl
[Huawei-acl-adv-myacl] rule permit ip source 10.1.1.1 0 destination 225.1.0.0 0.0.255.255
[Huawei-acl-adv-myacl] quit
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] crp-policy acl-name myacl

display default-parameter pim-dm

Function

The display default-parameter pim-dm command displays default configurations about PIM-DM.

Format

display default-parameter pim-dm

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display default-parameter pim-dm command displays default configurations about PIM-DM. Even if PIM-DM parameters are modified, the display default-parameter pim-dm command still displays default parameter settings. Therefore, you can use this command to check which parameters on the device have been modified.

Example

# Display default configurations about PIM-DM.

<Huawei> display default-parameter pim-dm
  PIM 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 neighbor-policy: disabled
Table 9-37  Description of the display default-parameter pim-dm command output

Item

Description

PIM View Default Configurations

Indicates default configurations in the PIM view.

Hello-option dr-priority

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

Hello-option holdtime

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

Hello-option lan-delay

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

Hello-option neighbor-tracking

Indicates whether neighbor tracking is enabled. This parameter is configured by the hello-option neighbor-tracking (IPv4) command.

Hello-option override-interval

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

Holdtime assert

Indicates the time period for holding the Assert state. This parameter is configured by the holdtime assert (IPv4) command.

Holdtime join-prune

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

Source-lifetime

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

State-refresh-interval

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

State-refresh-rate-limit

Indicates the 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 (IPv4) command.

State-refresh-ttl

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

Hello periodic interval

Indicates the interval for sending Hello messages. This parameter is configured by the timer hello (IPv4) command.

Join-prune periodic interval

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

Interface View Default Configurations

Indicates the default configurations in the interface view.

Pim hello-option dr-priority

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

Pim hello-option holdtime

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

Pim hello-option lan-delay

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

Pim hello-option neighbor-tracking

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

Pim hello-option override-interval

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

Pim holdtime assert

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

Pim holdtime join-prune

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

Pim require-genid

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

Pim silent

Indicates whether PIM Silent is enabled on the interface. This parameter is configured by the pim silent command.

Pim state-refresh-capable

Indicates whether State-Refresh is enabled on the interface. This parameter is configured by the pim state-refresh-capable command.

Pim timer dr-switch-delay

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

Pim timer graft-retry

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

Pim hello periodic interval

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

Pim join-prune periodic interval

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

Pim triggered-hello-delay

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

Pim version

Indicates the version of PIM enabled on the interface.

Pim neighbor-policy

Indicates whether the neighbor-policy is set on the interface. This parameter is configured by the pim neighbor-policy command.

display default-parameter pim-sm

Function

The display default-parameter pim-sm command displays default configurations about PIM-SM.

Format

display default-parameter pim-sm

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display default-parameter pim-sm command displays default configurations about PIM-SM. Even if PIM-SM parameters are modified, the display default-parameter pim-sm command still displays default parameter settings. Therefore, you can use this command to check which parameters on the device have been modified.

Example

# Display default configurations about PIM-SM.

<Huawei> display default-parameter pim-sm
  PIM View Default Configurations:
  ---------------------------------
  Auto-rp listening enable: disabled
  Bsr-policy: disabled
  C-bsr admin-scope: disabled
  C-bsr global: disabled
  C-bsr group: none
  C-bsr hash-length: 30 
  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: 0
  Crp-policy: disabled
  Bsm semantic fragmentation: disabled
  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-header-checksum: disabled
  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 join-policy: disabled
  Pim neighbor-policy: disabled
Table 9-38  Description of the display default-parameter pim-sm command output

Item

Description

PIM View Default Configurations

Default configurations in the PIM view.

Auto-rp listening enable

Whether auto-RP listening is enabled. This parameter is configured by the auto-rp listening enable command.

Bsr-policy

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

C-bsr admin-scope

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

C-bsr global

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

C-bsr group

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

C-bsr hash-length

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

C-bsr holdtime

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

C-bsr interval

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

C-bsr priority

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

C-rp advertisement-interval

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

C-rp holdtime

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

C-rp priority

Global priority of the C-RP. This parameter is configured by the c-rp priority (IPv4) 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 (IPv4) command.

Bsm semantic fragmentation

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

Hello-option dr-priority

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

Hello-option holdtime

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

Hello-option lan-delay

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

Hello-option neighbor-tracking

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

Hello-option override-interval

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

Holdtime assert

Time period for holding the Assert state, in seconds. This parameter is configured by the holdtime assert (IPv4) command.

Holdtime join-prune

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

Probe-interval

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

Register-header-checksum

Whether calculating the checksum based on information in Register message header is required. This parameter is configured by the register-header-checksum command.

Register-policy

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

Register-suppression-timeout

Time period for holding the register-suppression state, in seconds. This parameter is configured by the register-suppression-timeout (IPv4) command.

Source-lifetime

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

Source-policy

Whether the rule for filtering multicast sources is configured. This parameter is configured by the source-policy (IPv4) 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 (IPv4) command.

Ssm-policy

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

Static-rp

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

Hello periodic interval

Interval for sending Hello messages, in seconds. This parameter is configured by the timer hello (IPv4) command.

Join-prune periodic interval

Interval for sending Join/Prune messages, in seconds. This parameter is configured by the timer join-prune (IPv4) 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, in seconds. This parameter is configured by the timer spt-switch (IPv4) command.

Interface View Default Configurations

Default configurations in the interface view.

Pim bfd

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

Pim bsr-boundary

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

Pim hello-option dr-priority

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

Pim hello-option holdtime

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

Pim hello-option lan-delay

Delay in transmitting Prune messages at a shared network segment on the interface, in milliseconds. This parameter is configured by the pim 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 hello-option neighbor-tracking command.

Pim hello-option override-interval

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

Pim holdtime assert

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

Pim holdtime join-prune

Time period for the interface to hold the Join or Prune state, in seconds. This parameter is configured by the pim 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 require-genid command.

Pim silent

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

Pim timer dr-switch-delay

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

Pim hello periodic interval

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

Pim join-prune periodic interval

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

Pim triggered-hello-delay

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

Pim version

Version of PIM enabled on the interface.

Pim join-policy

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

Pim neighbor-policy

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

display default-parameter pim-ssm

Function

The display default-parameter pim-ssm command displays default configurations of PIM-SM for SSM.

Format

display default-parameter pim-ssm

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display default-parameter pim-ssm command displays default configuration of PIM-SM for SSM. Even if the configuration of PIM-SM for SSM is modified, the display default-parameter pim-ssm command still displays default parameter settings. Therefore, you can use this command to check which parameters on the device have been modified.

Example

# Display default configuration of PIM-SM for SSM.

<Huawei> display default-parameter pim-ssm
  PIM 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-header-checksum: disabled
  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 join-policy: disabled
  Pim neighbor-policy: disabled
Table 9-39  Description of the display default-parameter pim-ssm command output

Item

Description

PIM View Default Configurations

Default configurations in the PIM view.

Hello-option dr-priority

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

Hello-option holdtime

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

Hello-option lan-delay

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

Hello-option neighbor-tracking

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

Hello-option override-interval

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

Holdtime assert

Time period for holding the Assert state, in seconds. This parameter is configured by the holdtime assert (IPv4) command.

Holdtime join-prune

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

Source-lifetime

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

Source-policy

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

Ssm-policy

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

Hello periodic interval

Interval for sending Hello messages, in seconds. This parameter is configured by the timer hello (IPv4) command.

Join-prune periodic interval

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

Interface View Default Configurations

Default configurations in the interface view.

Pim bfd

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

Pim hello-option dr-priority

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

Pim hello-option holdtime

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

Pim hello-option lan-delay

Delay in transmitting Prune messages at a shared network segment on the interface, in milliseconds. This parameter is configured by the pim 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 hello-option neighbor-tracking command.

Pim hello-option override-interval

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

Pim holdtime assert

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

Pim holdtime join-prune

Time period for the interface to hold the Join or Prune state, in seconds. This parameter is configured by the pim 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 require-genid command.

Pim silent

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

Pim timer dr-switch-delay

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

Pim hello periodic interval

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

Pim join-prune periodic interval

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

Pim triggered-hello-delay

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

Pim version

Version of PIM enabled on the interface.

Pim join-policy

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

Pim neighbor-policy

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

display pim bfd session

Function

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

Format

display pim [ vpn-instance vpn-instance-name | all-instance ] bfd session statistics

display pim [ vpn-instance vpn-instance-name | all-instance ] bfd session [ interface interface-type interface-number | neighbor neighbor-address ] *

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies a VPN instance. The vpn-instance-name specifies the name of the VPN instance. The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
all-instance Indicates all the instances. -
statistics Displays PIM BFD statistics. -
interface interface-type interface-number Specifies an interface to be displayed. interface-type interface-number specifies the type and number of the interface. -
neighbor neighbor-address Specifies the IP address of a PIM neighbor to be displayed. The address is in dotted decimal notation.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display pim bfd session command output helps you locate communication faults between neighbors.

Example

# Display PIM BFD sessions on GE 0/0/1 in the public network instance.
<Huawei> display pim bfd session interface gigabitethernet 0/0/1
 VPN-Instance: public net                                                       
                                                                                
 GigabitEthernet0/0/1 (12.1.1.2): Total 1 BFD session Created                   
                                                                                
 Neighbor        ActTx(ms) ActRx(ms) ActMulti Local/Remote State                
 12.1.1.1        1000      1000      3         8192/8192   Up    
# Display PIM BFD sessions on GE 0/0/1 in the public network instance when the industrial switch router is not enabled with global BFD.
<Huawei> display pim bfd session interface gigabitethernet 0/0/1         
 VPN-Instance: public net                                                       
                                                                                
 GigabitEthernet0/0/1 (12.1.1.2): Total 1 BFD session Created                   
                                                                                
 Neighbor        ActTx(ms) ActRx(ms) ActMulti Local/Remote State                
 12.1.1.1        --        --        --           0/0      BFD global disable  
# Display the statistics of a PIM BFD session.
<Huawei> display pim 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.

# Display information about PIM BFD sessions of the public network instance neighbor 10.1.2.3.

<Huawei> display pim bfd session neighbor 10.1.2.3
 VPN-Instance: public net

 GigabitEthernet0/0/1 (12.1.1.2)

 Neighbor        ActTx(ms) ActRx(ms) ActMulti Local/Remote State
 12.1.1.1        1000      1000      3         8192/8192   Up
Table 9-40  Description of the display pim bfd session command output

Item

Description

VPN-Instance

Indicates the VPN instance to which PIM BFD session information belongs.

GigabitEthernet0/0/1 (12.1.1.2)

Indicates the PIM interface name (the IP address).

Neighbor

Indicates the IP address of a PIM neighbor.

ActTx (ms)

Indicates the actual minimum transmission interval, in milliseconds.

ActRx (ms)

Indicates the actual minimum receiving interval, in milliseconds.

ActMulti

Indicates the actual local detection multiple.

Local/Remote

Indicates the local and remote discriminators.

State

Indicates the status of the PIM 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.

  • BFD global disable: indicates that BFD is globally disabled.

  • Detect down: indicates that no BFD packets are not received when the detection time expires.

  • Neighbour down: indicates that the packets with the State field being Down are received from neighbors.

Total 1 PIM BFD session in this instance

Indicates the total number of PIM BFD sessions in a public network instance or a VPN instance.

Total 1 PIM BFD session up

Indicates the number of PIM BFD sessions in the Up state in a public network instance or a VPN instance.

Total 0 PIM BFD session down

Indicates the number of PIM BFD sessions in the Down state in a public network instance or a VPN instance, that is, all PIM BFD sessions except the PIM BFD sessions in the Up state.

display pim bsr-info

Function

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

Format

display pim [ vpn-instance vpn-instance-name | all-instance ] bsr-info

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies a VPN instance. vpn-instance-name specifies the name of the VPN instance. The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
all-instance Indicates all the instances. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

This command applies to the PIM-SM domain where the RP is dynamically elected among BSRs. You can run this command on any industrial switch router in the domain to view the BSR information.

  • If the current industrial switch router is configured with the C-BSR, the command output includes information about the elected BSR and locally configured C-BSR.

  • If the current industrial switch router is not configured with the C-BSR, the command output includes information about the elected BSR only.

Precautions

When the display pim bsr-info command is used, only information about the public network instance is displayed if the vpn-instance or all-instance is not specified.

This command has output only after C-BSRs have been configured in a PIM-SM domain.

Example

# Display information about the BSR in the PIM-SM domain of the current public network instance. If the industrial switch router is not configured with C-BSR, only information about the elected BSR is displayed.

<Huawei> display pim bsr-info
 VPN-Instance: public net
 Elected AdminScoped BSR Count: 0
 Elected BSR Address: 10.1.2.2
     Priority: 0
     Hash mask length: 30
     State: Accept Preferred
     Scope: Not scoped
     Uptime: 00:01:46
     Expires: 00:02:02
     C-RP Count: 1

# Display information about BSR in the current PIM-SM of the current public network instance.

If the industrial switch router is configured with C-BSR, information about the elected BSR and C-BSR is displayed.

<Huawei> display pim bsr-info
 VPN-Instance: public net
 Elected AdminScoped BSR Count: 0
 Elected BSR Address: 10.1.2.2
     Priority: 0
     Hash mask length: 30
     State: Elected
     Scope: Not scoped
     Uptime: 00:10:42
     Next BSR message scheduled at: 00:00:31
     C-RP Count: 1
 Candidate AdminScoped BSR Count: 0
 Candidate BSR Address: 10.1.2.2
     Priority: 0
     Hash mask length: 30
     State: Elected
     Scope: Not scoped
     Wait to be BSR: 0
Table 9-41  Description of the display pim bsr-info command output

Item

Description

VPN-Instance

Indicates the VPN instance to which BSR information belongs.

Elected AdminScoped BSR Count

Indicates the number of elected AdminScoped BSRs.

Elected BSR Address

Indicates the address of the elected BSR.
NOTE:

If stably running devices in the same BSR domain display different values in the Elected BSR Address field, the elected BSR is incorrect. Contact technical support personnel to troubleshoot faults.

Priority

Indicates the priority of the BSR. By default, the value is 0.

Hash mask length

Indicates the mask length in the RP hash calculation.

State

Indicates the status of the BSR.

Scope

Indicates the range of multicast addresses in the administrative scope when the BSR is an AdminScoped BSR.

Not scoped indicates that the BSR is not an AdminScoped BSR.

Uptime

Indicates the period during which the BSR exists.

Expires

Indicates the remaining time of the BSR.

C-RP Count

Indicates the number of RPs learned through the BSR.

Next BSR message scheduled at

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

Candidate AdminScoped BSR Count

Indicates the number of AdminScoped C-BSRs.

Candidate BSR Address

Indicates the address of the C-BSR.

Wait to be BSR

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

  • 1: indicates that 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 industrial switch router exceeds the threshold, the value is 1.

display pim claimed-route

Function

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

Format

display pim [ vpn-instance vpn-instance-name | all-instance ] claimed-route [ source-address ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies a VPN instance. vpn-instance-name specifies the name of the VPN instance. The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
all-instance Indicates all the instances. -
source-address Specifies the multicast source address. The address is in decimal notation.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display pim claimed-route command is used to view unicast routes used by PIM, such as RPF neighbors, interfaces, route types, and route selection policies.

Configuration Impact

Differences between the display pim claimed-route and display multicast rpf-info commands are as follows:

  • The display multicast rpf-info command is used to check information about RPF neighbors, RPF interfaces, or whether there is a route to a specified source address.
  • The display pim claimed-route command is used to check information about unicast routes used by multicast routing and entries of these routes.

Example

# Display the unicast routing information used by PIM.

<Huawei> display pim claimed-route
 VPN-Instance: public net
 multicast load-splitting rule: source-group
 RPF information about: 10.1.0.0 in PIM-SM routing table
     RPF interface: GigabitEthernet2/0/0, RPF neighbor: 10.1.2.2
     Referenced route/mask: 10.1.0.0/24
     Referenced route type: igp
     RPF-route selecting rule: preference-preferred
     The (S, G) or (*, G) list dependent on this route entry
     (10.1.0.1, 225.0.0.1)
Table 9-42  Description of the display pim claimed-route command output

Item

Description

VPN-Instance

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

multicast load-splitting rule

Indicates the way 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

This parameter is configured by the multicast load-splitting command.

RPF information about: 10.1.0.0 in PIM-SM routing table

Indicates the RPF routing information with the source address of 10.1.0.0 in the PIM-SM routing table

RPF interface

Indicates the RPF interface.

RPF neighbor

Indicates the RPF neighbor.

Referenced route/mask

Indicates the referenced route/mask.

Referenced route type

Indicates the type of route.

RPF-route selecting rule

Indicates the preferred rule for selecting the RPF-route.

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

Indicates the list of multicast entries based on RPF routes.

display pim control-message counters

Function

The display pim control-message counters command displays the number of sent, received, and invalid PIM control messages.

Format

display pim [ vpn-instance vpn-instance-name | all-instance ] control-message counters message-type { probe | register | register-stop | crp }

display pim [ vpn-instance vpn-instance-name | all-instance ] control-message counters [ message-type { assert | graft | graft-ack | hello | join-prune | state-refresh | bsr } | interface interface-type interface-number ] *

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies the name of a VPN instance. The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
all-instance Indicates all the instances. -
message-type Indicates a PIM control message type. -
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 data messages cannot be forwarded on a PIM network, run the display pim control-message counters command to view statistics on protocol messages. The command output helps you locate faults.

When you run the display pim control-message counters command:

  • If you specify interface interface-type interface-number, you can view the number of various PIM control messages that were sent and received on the interface only.

  • If you specify message-type, you can view the number of PIM control messages of this type sent and received on all interfaces of the industrial switch router.

Example

# Display the statistics about sent, received, and invalid PIM control messages in the public network instance.

<Huawei> display pim control-message counters
 VPN-Instance: public net                                                       
 Register* - Register Anycast-RP, Probe* - Probe Anycast-RP
 ---------------------------------------------------------------------------- 
 PIM global control-message counters:                                           
 Message Type     Received         Sent             Invalid          Filtered   
 Register         51               0                0                0          
 Register-Stop    0                48               0                0          
 Probe            44               0                0                0          
 C-RP             0                0                0                0          
 Register*        0                0                0                0          
 Probe*           0                0                0                0          
                                                                                
 PIM control-message counters for interface: GigabitEthernet1/0/1
 Message Type     Received         Sent             Invalid          Filtered   
 Assert           0                6                0                0          
 Graft            0                0                0                0          
 Graft-Ack        0                0                0                0          
 Hello            34496            34495            0                0          
 Join-prune       26171            90               0                0          
 State-Refresh    0                0                0                0          
 BSR              0                0                0                0          
                                                                                
 PIM control-message counters for interface: GigabitEthernet1/0/2
 Message Type     Received         Sent             Invalid          Filtered   
 Assert           0                0                0                0          
 Graft            0                0                0                0          
 Graft-Ack        0                0                0                0          
 Hello            34491            34495            0                0          
 Join-prune       0                41               0                0          
 State-Refresh    0                0                0                0          
 BSR              0                0                0                0  

# Display statistics about sent, received, invalid PIM control messages on GE1/0/0 in the public network instance.

<Huawei> display pim control-message counters interface GigabitEthernet 1/0/0
 VPN-Instance: public net
 PIM control-message counters for interface: GigabitEthernet1/0/0
 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 9-43  Description of the display pim control-message counters command output

Item

Description

VPN-Instance

VPN instance to which the statistics of PIM messages belong.

PIM global control-message counters

Number of PIM control messages in the public network.

PIM control-message counters for interface

Name of the interface where statistics about PIM control messages are collected.

Message Type

Type of the control messages.

Received

Number of control messages received by the interface.

Sent

Number of control messages sent by the interface.

Invalid

Number of invalid control messages.

Filtered

Number of control messages filtered out by the interface.

Register

Statistics about Register messages.

Register-Stop

Statistics about Register-Stop messages.

Probe

Statistics about Probe messages.

C-RP

Statistics about CRP messages.

Register*

Statistics about Register messages for anycast RP.

Probe*

Statistics about Probe messages for anycast RP.

Assert

Statistics about Assert messages.

Graft

Statistics about Graft messages.

Graft-Ack

Statistics about Graft-Ack messages.

Hello

Statistics about Hello messages.

Join-prune

Statistics about Join/Prune messages.

State-Refresh

Statistics about State-Refresh messages.

BSR

Statistics about Bootstrap messages.

display pim grafts

Function

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

Format

display pim [ vpn-instance vpn-instance-name | all-instance ] grafts

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies a VPN instance. vpn-instance-name specifies the name of the VPN instance. The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
all-instance Specifies all the instances. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

In PIM-DM, after sending the Graft message, the industrial switch router needs to wait to receive the Graft-Ack message from the upstream device. You can run the display pim grafts command to view the information about the PIM-DM Graft messages sent but unacknowledged.

Example

# Display the unacknowledged PIM-DM graft messages in the public network instance.
<Huawei> display pim grafts
VPN-Instance: public net
Source                      Group                    Expire   RetransmitIn
10.0.5.200                  226.3.3.3                00:02:52 00:00:02
Table 9-44  Description of the display pim grafts command output

Item

Description

VPN-Instance

Indicates the VPN instance to which the Graft messages belong.

Source

Indicates the multicast source address.

Group

Indicates the multicast group address.

Expire

Indicates the timeout period of an (S, G) entry.

RetransmitIn

Indicates the waiting period before the next Graft message is received.

display pim interface

Function

The display pim interface command displays PIM information on an interface.

Format

display pim [ vpn-instance vpn-instance-name | all-instance ] interface [ interface-type interface-number | up | down ] [ verbose ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies the name of a VPN instance. The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
all-instance Specifies all the instances. -
interface-type interface-number Specifies the type and number of an interface. -
up Displays PIM information on interfaces in Up state. -
down Displays PIM information on interfaces in Down state. -
verbose Displays detailed information about a PIM interface. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

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

When the display pim interface command is used, the following situations occur:

  • If interface-type interface-number is specified, the information about various PIM state parameters on the interface is displayed.

  • If interface-type interface-number is not specified, the information about the state parameters of all the PIM interfaces is displayed.

  • If up is set in the command, the information about the parameters of the PIM interfaces in the Up state is displayed.
  • If down is set in the command, the information about the parameters of the PIM interfaces in the Down state is displayed.

Example

# Display information about all the PIM interfaces in the public network instance.

<Huawei> display pim interface
 VPN-Instance: public net
 Interface      State   NbrCnt   HelloInt   DR-Pri     DR-Address
 GE1/0/0        up      1        30         1          10.1.1.2
 GE2/0/0        up      0        30         1          10.1.2.2    (local)
 Loopback0      up      0        30         1          10.1.3.2    (local)
Table 9-45  Description of the display pim interface command output

Item

Description

VPN-Instance

VPN instance to which the PIM interface belongs.

Interface

Name of the PIM interface.

State

Status of the PIM interface, Up or Down.

NbrCnt

Number of PIM 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 on GE1/0/0 of the public network instance.

<Huawei> display pim interface gigabitethernet 1/0/0 verbose
 VPN-Instance: public net
 Interface: GigabitEthernet1/0/0, 10.1.1.1
     PIM version: 2
     PIM mode: Sparse
     PIM state: up
     PIM DR: 10.1.1.2
     PIM DR Priority (configured): 1
     PIM neighbor count: 1
     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: 0XF5712241 
     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: enabled
     PIM BFD min-tx-interval: 1000 ms
     PIM BFD min-rx-interval: 1000 ms
     PIM BFD detect-multiplier: 3   
     PIM dr-switch-delay timer : 20 s
     Number of routers on link not using DR priority: 0
     Number of routers on link not using LAN delay: 0
     Number of routers on link not using neighbor tracking: 2
     ACL of PIM neighbor policy: myacl
     ACL of PIM ASM join policy: 2000
     ACL of PIM SSM join policy: - 
     ACL of PIM join policy: -
Table 9-46  Description of the display pim interface verbose command output

Item

Description

VPN-Instance

VPN instance to which the PIM interface belongs.

Interface

Name and IP address of the PIM interface.

PIM version

PIM version enabled on the interface.

PIM mode

PIM mode used on the interface.

PIM state

Status of the PIM interface, Up or Down.

PIM DR

DR address on the interface.

PIM DR Priority (configured)

DR priority configured on the interface.

PIM neighbor count

Number of PIM neighbors on the interface.

PIM hello interval

Interval for sending PIM Hello messages, in seconds.

PIM LAN delay (negotiated)

Negotiated delay for transmitting packets on the interface, in milliseconds.

PIM LAN delay (configured)

Configured delay for transmitting packets on the interface, in milliseconds.

PIM hello override interval (negotiated)

Negotiated override interval on the interface, in milliseconds.

PIM hello override interval (configured)

Configured override interval on the interface, in milliseconds.

PIM Silent

Whether the PIM Silent function is enabled on the interface.

PIM neighbor tracking (negotiated)

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

PIM neighbor tracking (configured)

Whether the PIM neighbor tracking function is configured on the interface.

PIM generation ID

Generation ID option on the interface.

PIM require-GenID

Whether the function that rejects the Hello messages without the Generation ID option is enabled.

PIM hello hold interval

Interval during which the receiver of the Hello message to keep its neighbor reachable, in seconds.

PIM assert hold interval

Interval for sending Assert messages, in seconds.

PIM triggered hello delay

Maximum random delay for triggering Hello messages, in seconds.

PIM J/P interval

Interval at which the interface sends Join/Prune messages, in seconds.

PIM J/P hold interval

Period for holding the Join/Prune status on the interface, in seconds.

PIM BSR domain border

Whether the BSR domain boundary is configured on the interface.

PIM BFD

Whether PIM BFD is enabled.

PIM BFD min-tx-interval

Minimum interval for sending BFD packets.

PIM BFD min-rx-interval

Minimum interval for receiving BFD packets.

PIM BFD detect-multiplier

PIM BFD detection multiplier.

PIM dr-switch-delay timer

DR switching delay.

Number of routers on link not using DR priority

Number of industrial switch routers 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 industrial switch routers that do not use LAN delay in all the network segments connected to the interface.

Number of routers on link not using neighbor tracking

Indicates the number of industrial switch router 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 invalid-packet

Function

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

Format

display pim [ vpn-instance vpn-instance-name | all-instance ] invalid-packet [ interface interface-type interface-number | message-type { assert | bsr | hello | join-prune | graft | graft-ack | state-refresh } ] *

display pim [ vpn-instance vpn-instance-name | all-instance ] invalid-packet message-type { crp | register | register-stop }

display pim invalid-packet [ packet-number ] verbose

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays statistics about invalid PIM messages received in a specified VPN instance. The vpn-instance-name parameter specifies the VPN instance name. The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
all-instance Displays statistics about invalid PIM messages received in all VPN instances. -
interface interface-type interface-number Specifies the type and number of an interface on the industrial switch router. -
message-type Displays statistics about invalid PIM 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 about a specified number of invalid PIM messages recently received. The value is an integer that ranges from 1 to 100. By default, details of all the invalid PIM messages currently stored are displayed.
verbose Displays details of invalid PIM messages. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

If a device fails to create PIM entries, you can run the display pim invalid-packet command first to check whether the device has received invalid PIM messages. If the command output displays counters of invalid PIM messages, run the display pim invalid-packet [ packet-number ] verbose command to view details of invalid PIM messages for fault location.

You can run the following commands to view information about specific invalid PIM messages:

  • Run the display pim invalid-packet interface interface-type interface-number command to view statistics about invalid PIM messages received by a specified interface.

  • Run the display pim invalid-packet packet-number verbose command to view details of invalid PIM messages recently received. Currently, details of a maximum of 100 invalid PIM messages can be displayed.

Example

# Display statistics about invalid PIM messages received in the public network instance.

<Huawei> display pim 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

AnycastRP 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 9-47  Description of the display pim invalid-packet command output

Item

Description

Statistics of invalid packets for public net

VPN instance in which statistics about invalid PIM messages need to be displayed.

PIM General invalid packet

General invalid PIM messages.

Invalid PIM Version

Messages with invalid PIM versions.

Invalid PIM Type

Messages with invalid PIM message types.

Fault Length

Messages of invalid lengths.

Bad Checksum

Messages with invalid checksum.

PIM Register invalid packet

Invalid PIM Register messages.

Invalid Multicast Source

Messages with invalid multicast source addresses.

Invalid Multicast Group

Messages with invalid multicast group addresses.

Invalid Dest Addr

Messages with invalid destination addresses.

AnycastRP Register invalid packet

Statistics about invalid Register messages in the anycast-RP scenario.

PIM Register-Stop invalid packet

Invalid PIM Register-Stop messages.

IP Source not RP

Messages whose source addresses are not the RP address.

PIM CRP invalid packet

Invalid PIM C-RP messages.

Invalid CRP Addr

Messages with invalid C-RP addresses.

CRP Adv Fault Length

Messages whose CRP Adv fields are of invalid lengths.

PIM Assert invalid packet

Invalid PIM Assert messages.

Invalid IP Source Addr

Indicates messages with invalid source addresses.

PIM BSR invalid packet

Invalid PIM BSR messages.

Bad Payload

Messages with invalid payloads.

Bad Scope Mask

Messages with invalid scope masks.

Not CBSR But BSR

BSR messages received on interfaces that do not act as a C-BSR.

Invalid BSR Addr

Messages with invalid BSR addresses.

Fault Hash Length

Messages with hash mask fields of invalid lengths.

PIM Hello invalid packet

Indicates invalid PIM Hello messages.

Invalid Addr List

Indicates messages with invalid address lists.

Bad Holdtime Length

Messages with Holdtime fields of invalid lengths.

Bad LanPruneDelay Length

Messages with LanPruneDelay fields of invalid lengths.

Bad DrPriority Length

Messages with DrPriority fields of invalid lengths.

Bad GenID Length

Messages with GenerationID fields of invalid lengths.

PIM Join/Prune invalid packet

Invalid PIM Join/Prune messages.

Invalid Up Neighbor

Messages with invalid upstream neighbors.

PIM Graft invalid packet

Invalid PIM Graft messages.

PIM Graft-Ack invalid packet

Invalid PIM Graft-Ack messages.

PIM State Refresh invalid packet

Invalid PIM State-Refresh messages.

Invalid Originator Addr

Messages with invalid Originator address.

# Display details of one invalid PIM message recently received in the public network instance.

<Huawei> display pim invalid-packet 1 verbose
       Detailed information of invalid packets
-----------------------------------------------------
Packet information (Index 1):
-----------------------------------------------------
Interface           :  GigabitEthernet1/0/0
Time                :  2010-6-1 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 9-48  Description of the display pim invalid-packet 1 verbose command output

Item

Description

Detailed information of invalid packets

Details of an invalid PIM message.

Packet information (Index 1)

Sequence number of the invalid PIM message (numbered in the opposite order the message is received. For example, the index of the last received message is 1, the index of the penultimate message is 2, and so on).

Interface

Interface that received the invalid PIM 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 has been configured using the clock timezone command; DST indicates that the daylight saving time has been configured using clock daylight-saving-time command.

Message Length

Length of the invalid PIM message.

Invalid Type

Type of the invalid PIM 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 message.

display pim neighbor

Function

The display pim neighbor command displays information about PIM neighbors.

Format

display pim [ vpn-instance vpn-instance-name | all-instance ] neighbor [ neighbor-address | interface interface-type interface-number | verbose ] *

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies the name of a VPN instance. The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
all-instance Specifies all the instances. -
interface interface-type interface-number Specifies the type and number of an interface. -
neighbor-address Specifies the IP address of a PIM neighbor. The address is in dotted decimal notation.
verbose Displays detailed information about PIM neighbors. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display pim neighbor command displays information about PIM neighbors, including the number of neighbors, DR priority, and BFD session status. You can adjust PIM neighbor relationships based on the command output.

When you run the display pim neighbor command:

  • If you specify interface interface-type interface-number, the command displays information about PIM neighbors connected to the specified interface.

  • If you do not specify interface interface-type interface-number, the command displays information about all PIM neighbors attached to the industrial switch router.

Example

# Display information about all PIM neighbors in the public network instance.

<Huawei> display pim neighbor
 VPN-Instance: public net
 Total Number of Neighbors = 2

 Neighbor        Interface     Uptime       Expires      Dr-Priority  BFD-Session 
 10.1.1.2        GE1/0/0       02:50:49     00:01:31     1           Y
 10.1.2.2        GE2/0/0       02:49:39     00:01:42     1           Y
Table 9-49  Description of the display pim neighbor command output

Item

Description

VPN-Instance

VPN instance to which PIM neighbors belong.

Total Number of Neighbors

Total number of PIM neighbors on an interface.

Neighbor

IP Address of a PIM neighbor.

Interface

Interface connected to a PIM neighbor.

Uptime

Time elapsed since a PIM neighbor relationship is set up.

Expires

Amount of time left before a PIM relationship times out.

Dr-Priority

DR priority of a PIM neighbor.

BFD-Session

Whether the BFD session has been set up with a neighbor.

# Display detailed information about the PIM neighbor with IP address 10.1.1.2 in the public network instance.

<Huawei> display pim neighbor 192.168.11.1 verbose
 VPN-Instance: public net
 Neighbor: 192.168.11.1
     Interface: Vlanif11
     Uptime: 04:56:41
     Expiry time: 00:01:44
     DR Priority: 1
     Generation ID: 0XD287B917
     Holdtime: 105 s
     LAN delay: 500 ms
     Override interval: 2500 ms
     Neighbor tracking: Disabled
     PIM BFD-Session: Y
     PIM BFD-Session min-tx-interval: 1000 ms
     PIM BFD-Session min-rx-interval: 1000 ms
     PIM BFD-Session detect-multiplier: 3
Table 9-50  Description of the display pim neighbor verbose command output

Item

Description

Expiry time

Amount of time left before a PIM relationship times out.

Generation ID

PIM neighbor status random value.

Holdtime

Keepalive period of the PIM neighbor.

LAN delay

Delay in transmitting Prune messages.

Override interval

Override interval for a prune action.

Neighbor tracking

Whether the neighbor tracking function is enabled.

PIM BFD-Session

Whether the BFD session is set up.

PIM BFD-Session min-tx-interval

Minimum interval at which PIM BFD packets are sent.

PIM BFD-Session min-rx-interval

Minimum interval at which PIM BFD packets are received.

PIM BFD-Session detect-multipler

PIM BFD detection multiplier.

display pim routing-table

Function

The display pim routing-table command displays the PIM routing table.

Format

display pim [ vpn-instance vpn-instance-name | all-instance ] routing-table brief [ group-address [ mask { group-mask-length | group-mask } ] | source-address [ mask { source-mask-length | source-mask } ] | incoming-interface { interface-type interface-number | mcast-extranet | register } ] *

display pim [ vpn-instance vpn-instance-name | all-instance ] routing-table [ group-address [ mask { group-mask-length | group-mask } ] | source-address [ mask { source-mask-length | source-mask } ] | extranet { source-vpn-instance { vpn-instance-name | all | public } | receive-vpn-instance { vpn-instance-name | all } } | incoming-interface { interface-type interface-number | register | mcast-extranet } | outgoing-interface { include | exclude | match } { interface-type interface-number | register | none } | vpn-instance vpn-instance-name | mode { dm | sm | ssm } | flags flag-value | fsm ] * [ outgoing-interface-number [ number ] ] [ rpf-vector [ vector-address ] ]

NOTE:

If you specify the register keyword before mode, the value of mode can only be sm.

After the PIM mode is set to dm or ssm, the register keyword cannot be specified in the command.

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays PIM routing entries in a specified VPN instance. vpn-instance-name specifies the name of the VPN instance. The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
all-instance Displays PIM routing entries in all the instances. -
group-address Displays the PIM routing entry of a specified group. The address is in dotted decimal notation. The value ranges from 224.0.1.0 to 239.255.255.255.
mask Specifies the mask of a multicast source address or group address. -
group-mask Specifies the group address mask. The address is in dotted decimal notation.
group-mask-length Specifies the length of the group address mask. The value is an integer that ranges from 4 to 32.
source-address Displays the PIM routing entry of a specified multicast source. The source address is in dotted decimal notation.
source-mask Specifies the multicast source IP address mask. The address mask is in dotted decimal notation.
source-mask-length Specifies the length of the source address mask. The value is an integer that ranges from 0 to 32.
extranet Displays multicast extranet routing entries. -
source-vpn-instance vpn-instance-name Indicates the source VPN instance. vpn-instance-name specifies the name of the source VPN instance. The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
all Indicates all instances. -
public Indicates the public network instance. -
receive-vpn-instance vpn-instance-name Indicates the receiver VPN instance. vpn-instance-name specifies the name of the receiver VPN instance. The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
incoming-interface Displays the PIM routing entries with a specified interface as the upstream interface. -
interface-type interface-number Specifies the type and number of an interface. -
register Indicates the register interface. -
outgoing-interface Displays the PIM routing entries with a specified interface as the outbound interface. -
include Displays the PIM routing entries with the outbound interface list containing a specified interface. -
exclude Displays the PIM routing entries with the outbound interface list not containing a specified interface. -
match Displays the PIM routing entries with the outbound interface list containing only the specified interface. -
none Displays the PIM routing entries with an empty outbound interface list. -
mode Specifies the PIM operation mode. -
dm Displays PIM-DM routing entries. -
sm Displays PIM-SM routing entries. -
ssm Displays PIM-SSM routing entries. -
flags flag-value Displays PIM-SSM routing entries with the specified flag. The flag-value parameter is the type flag of entries. -
fsm Displays the details of FSM states. -
outgoing-interface-number Displays the number of outbound interfaces of PIM routing entries. -
number Specifies the number of the outbound interfaces to be displayed. The value is an integer that ranges from 0 to 2048.
rpf-vector vector-address Displays detailed information about Reverse Path Forwarding (RPF) vectors. vector-address specifies the vector address. The address mask is in dotted decimal notation.
brief Displays only the upstream interface names and the number of downstream interfaces in PIM routing entries. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can use this command to:
  • Check whether PIM 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 network.

The PIM 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 9-51 lists the values of the flags flag-value parameter.

Table 9-51  Values of the flag-value parameter

Item

Description

2msdp

The RP received a Register message recently and learned the (S, G) entry. The RP will notify MSDP of the (S, G) entry in the next SA message.

act

Multicast routing entries that have matched received data.

del

Multicast routing entries to be deleted.

exprune

Multicast routing entries pruned from the RPT, with no receiver interested in the data from the source.

ext

Multicast routing entries that contain outbound interfaces provided by other multicast routing protocols.

loc

Multicast routing entries the industrial switch router directly connected to the network segment of the multicast source.

msdp

Multicast routing entries learned from recently received MSDP SA messages.

niif

Multicast routing entries with unknown upstream interfaces.

nonbr

Multicast routing entries in which the upstream neighbor address (link-local address) towards the RP or the source is not found.

none

Multicast routing entries without any flag.

rpt

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

sg_rcvr

The industrial switch router has receivers of the source specified in the (S, G) entry, and PIM is the owner of the downstream interfaces.

sgjoin

The industrial switch router has receivers of the source specified in the (S, G) entry, but PIM is not the owner of the downstream interfaces.

spt

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

swt

Multicast routing entries during the SPT switchover.

upchg

A route change has occurred. The current entry is using the original upstream interface to forward data and waiting for data received from a new interface.

wc

(*, G) entry.

Example

# Display the PIM routing table of the public network instance.
<Huawei> display pim routing-table
 VPN-Instance: public net
 Total 0 (*, G) entry; 1 (S, G) entry

 (172.16.0.12, 227.0.0.1)
     RP: 10.2.2.2
     Protocol: pim-sm, Flag: SPT LOC ACT
     UpTime: 02:54:43
     Upstream interface: GigabitEthernet1/0/0
         Upstream neighbor: NULL
         RPF prime neighbor: NULL
     Downstream interface(s) information:
     Total number of downstreams: 1
         1: GigabitEthernet2/0/0
             Protocol: pim-sm, UpTime: 02:54:43, Expires: 00:02:47
Table 9-52  Description of the display pim routing-table command output

Item

Description

VPN-Instance

VPN instance to which PIM routing information belongs.

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

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

(172.16.0.12, 227.0.0.1)

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

RP

RP address.

Protocol

PIM protocol type, which can be PIM-DM, PIM-SM or PIM-SSM.

Flag

Flag of PIM (S, G) or (*, G) entry.

UpTime

Amount of time an interface has been Up.

Upstream interface

Upstream interface in an (S, G) entry or (*, G) entry.

Upstream neighbor

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

RPF prime neighbor

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

  • For an (S, G) entry, when the local device is directly connected to the source, the RPF neighbor in the (S, G) entry is null.

Downstream interface(s) information

Information about the downstream interface, including the following:
  • Total number of downstream interfaces

  • Name of each downstream interface

  • PIM protocol type configured for the downstream interface

  • Keepalive period and timeout period of the downstream interface

Total number of downstreams

Number of downstream interfaces.

Expires

Timeout period of an interface.

# Display the number of the downstream interfaces of PIM routing entries in the public network instance.
<Huawei> display pim routing-table outgoing-interface-number
 VPN-Instance: public net
 Total 2 (*, G) entries; 0 (S, G) entry

 (*, 226.1.1.1)
     RP: 10.2.2.2 (local)
     Protocol: pim-sm, Flag: WC EXT
     UpTime: 21:37:28
     Upstream interface: Register
         Upstream neighbor: NULL
         RPF prime neighbor: NULL
     Downstream interface(s) information:
     Total number of downstreams: 50

 (*, 226.1.2.1)
     RP: 10.2.2.2 (local)
     Protocol: pim-sm, Flag: WC EXT
     UpTime: 21:37:28
     Upstream interface: Register
         Upstream neighbor: NULL
         RPF prime neighbor: NULL
     Downstream interface(s) information:
     Total number of downstreams: 50
Table 9-53  Description of the display pim routing-table outgoing-interface-number command output

Item

Description

Total 2 (*, G) entries; 0 (S, G) entry

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

Total number of downstreams

Total number of the downstream interfaces of the (*, G) entries or (S, G) entries.

# Display brief information about the PIM routing entries in the public network instance.
<Huawei> display pim routing-table brief
  VPN-Instance: public net
 Total 0 (*, G) entry; 6 (S, G) entries

  00001.(10.0.4.100, 225.0.0.1)
       Upstream interface:GigabitEthernet1/0/0
       Number of downstream:1
       Number of receive vrf:0
  00002.(10.0.4.100, 225.0.0.2)
       Upstream interface:GigabitEthernet1/0/0
       Number of downstream:1
       Number of receive vrf:0
  00003.(10.0.4.100, 225.0.0.3)
       Upstream interface:GigabitEthernet1/0/0
       Number of downstream:1
       Number of receive vrf:0
  00004.(10.0.4.100, 225.0.0.4)
       Upstream interface:GigabitEthernet1/0/0
       Number of downstream:1
       Number of receive vrf:0
  00005.(10.0.4.100, 225.0.0.5)
       Upstream interface:GigabitEthernet1/0/0
       Number of downstream:1
       Number of receive vrf:0
  00006.(10.0.4.100, 225.0.0.6)
       Upstream interface:GigabitEthernet1/0/0
       Number of downstream:1
       Number of receive vrf:0
Table 9-54  Description of the display pim routing-table brief command output

Item

Description

Total 0 (*, G) entry; 6 (S, G) entries

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

Upstream interface

Upstream interface in an (S, G) or (*, G) entry.

Number of downstream

Number of downstream interfaces.

Number of receive vrf

Number of receiving VRFs.

display pim rp-info

Function

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

Format

display pim [ vpn-instance vpn-instance-name | all-instance ] rp-info [ group-address ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies the name of a VPN instance. The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
all-instance Specifies all the instances. -
group-address Displays the information about the RP for a specified multicast group. The address is in dotted decimal notation. The value ranges from 224.0.1.0 to 239.255.255.255.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

You can use this command to view information about the RP for a multicast group.

Configuration Impact

The command output includes information about the RP discovered through the BSR mechanism, static RP, and auto-RP.

If group-address is not specified, the command displays RP information for all the multicast groups.

Example

# Display RP information for all the multicast groups.
<Huawei> display pim rp-info
VPN-Instance: public net
PIM-SM BSR RP Number:1
Group/MaskLen: 224.0.0.0/4
     RP: 10.2.2.2 (local)
     Priority: 0
     Uptime: 03:01:36
     Expires: 00:02:29
PIM SM static RP Number:1
     Static RP: 10.1.1.1
Table 9-55  Description of the display pim rp-info command output

Item

Description

VPN-Instance

VPN instance to which RP information belongs.

PIM-SM BSR RP Number

Number of PIM-SM BSR RPs.

Group/MaskLen

Multicast group address and mask length.

RP

RP address.

Priority

Priority of the RP.

Uptime

Time elapsed since presence of the RP.

Expires

Amount of time left before the RP times out.

PIM SM static RP Number

Number of static RPs.

Static RP

IP address of a static RP.

hello-option dr-priority (IPv4)

Function

The hello-option dr-priority command configures the priority of the industrial switch router that candidates for the Designated Router (DR).

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

By default, the priority of the industrial switch router that candidates for the DR is 1.

Format

hello-option dr-priority priority

undo hello-option dr-priority

Parameters

Parameter Description Value
priority Specifies the priority of the industrial switch router that candidates for the DR. The greater the value, the higher the priority. The value is an integer ranging from 0 to 4294967295.

Views

PIM view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In PIM, industrial switch routers on the shared network segment candidates for the DR. The DR is responsible for the registering of the local multicast source and the joining of the receivers.

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

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

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

Example

# In the public network instance, configure the DR priority of a industrial switch router to 3.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] hello-option dr-priority 3

hello-option holdtime (IPv4)

Function

The hello-option holdtime command sets the timeout period for a industrial switch router 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 industrial switch router 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 industrial switch router waits to receive a Hello message from its PIM neighbor. The value is an integer ranging from 1 to 65535, in seconds.

Views

PIM view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

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

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

Example

# In the public network instance, set the timeout interval to 120 seconds. The timeout interval is the period during which a industrial switch router waits to receive the Hello message from its PIM neighbor.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] hello-option holdtime 120

hello-option lan-delay (IPv4)

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 view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

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

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command is valid for PIM-SM and PIM-DM.

If the delay in transmitting Prune message is too short, the upstream industrial switch router will stop forwarding multicast packets before the downstream industrial switch router 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 hello-option lan-delay command in the interface view. By default, if the the pim hello-option lan-delay 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 delay in transmitting Prune message on the shared network segment to 200 ms in public network instance.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] hello-option lan-delay 200

hello-option neighbor-tracking (IPv4)

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 view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When sending a Hello message, the device generates a Generation ID and encapsulates it into the message. The Generation ID changes only when the device status changes. After receiving the Hello message, the neighboring device detects Generation ID change and immediately sends a Join message to the device to update the neighbor relationship. If multiple devices on the shared network segment 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. The upstream neighbor cannot update neighbor relationships with downstream devices because of 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

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command is valid for only PIM-SM.

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 hello-option neighbor-tracking command in the interface view. By default, if neighbor tracking is not used on an interface, the neighbor tracking configuration in the PIM view takes effect.

Example

# In the public network instance, enable the downstream neighbor tracking function.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] hello-option neighbor-tracking

hello-option override-interval (IPv4)

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 view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

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

When the values of override-interval on all industrial switch routers in the same network segment are different, the maximum value of these values is used.

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command is valid for PIM-SM and PIM-DM.

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

Example

# In the public network instance, set the interval for denying the prune action in a Hello message to 2000ms.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] hello-option override-interval 2000

holdtime assert (IPv4)

Function

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

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 industrial switch router is 180 seconds.

Format

holdtime assert interval

undo holdtime assert

Parameters

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

Views

PIM view of public network instance or PIM view of VPN instance

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

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

The holdtime assert command has the same function as the pim 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 view is used.

Example

# In the public network instance, set the interval during which a industrial switch router keeps the Assert state to 100s.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] holdtime assert 100

holdtime join-prune (IPv4)

Function

The holdtime join-prune command sets the holdtime value in Join/Prune messages sent by all PIM interfaces. industrial switch routers 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 industrial switch router. The value is an integer that ranges from 1 to 65535 , in seconds.

Views

PIM view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command is valid for PIM-SM and PIM-DM.

The holdtime of Join/Prune messages must be larger than the interval for sending Join/Prune messages and is generally 3.5 times the interval for sending Join/Prune messages.

The holdtime join-prune command has the same function as the pim 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 view is used.

Example

# In the public network instance, set the time during which the downstream interface of a industrial switch router keeps the Join or Prune state to 280 seconds.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] holdtime join-prune 280

join-prune max-packet-length (IPv4)

Function

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

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

By default, the maximum length of Join/Prune message sent by PIM-SM 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 ranging from 100 to 8100, in bytes.

Views

PIM view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer device has low performance and takes a long time to process a single Join/Prune message carrying a lot of (S, G) entries, the maximum size of each Join/Prune message can be set to a small value to limit the number of (S, G) entries in each message, relieving the burden on the peer device.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command is valid for PIM-SM and PIM-DM.

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 routing-enable
[Huawei] pim
[Huawei-pim] join-prune max-packet-length 2100

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

Function

The join-prune periodic-messages queue-size command sets the maximum number of (S, G) entries carried in a PIM-SM 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 PIM-SM Join/Prune message that is sent every second.

By default, a PIM-SM 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 PIM-SM Join/Prune message that is sent every second. The value is an integer ranging from 16 to 4096.

Views

PIM view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer device has a low throughput, change the length of a queue for periodically sending messages to a small value 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

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command is valid for PIM-SM and PIM-DM.

Example

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

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

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

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 view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command is valid for PIM-SM and PIM-DM.

Example

# Disable the Join/Prune message cacheage function.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] join-prune triggered-message-cache disable

local-address (IPv4)

Function

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

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

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

Format

local-address local-address

undo local-address

Parameters

Parameter Description Value
local-address Specifies the local address of Anycast RP. The value is in dotted decimal notation. This address must be a valid unicast IP address and cannot be an address on the network segment 127.0.0.0/8.

Views

Anycast RP view of public network instance or Anycast RP view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

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

Prerequisites

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

Precautions

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

NOTE:

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

Example

# In the public network instance, set the Anycast RP address to 10.10.10.10 and local address of Anycast RP to 10.1.1.1.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] anycast-rp 10.10.10.10
[Huawei-pim-anycast-rp-10.10.10.10] local-address 10.1.1.1

neighbor-check (IPv4)

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 view of public network instance or PIM view of VPN instance

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

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Configuration Impact

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

Precautions

This command is valid only for PIM-SM.

Example

# In the public network instance, enable the PIM neighbor check function for the received Join/Prune and Assert messages.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] neighbor-check receive

peer (IPv4)

Function

The peer command configures Anycast RP peers.

The undo peer command removes the configurations of Anycast RPs.

By default, no Anycast RP peer is configured.

Format

peer peer-address [ fwd-msdp-sa [ acl-number | acl-name acl-name ] ]

undo peer peer-address

Parameters

Parameter Description Value
peer-address Specifies the address of an Anycast RP peer. The value is in dotted decimal notation.
fwd-msdp-sa Enables a local RP to extract source/group information from the received MSDP SA message, encapsulates the information into a Register message, and sends the Register message to Anycast RP peers. -
acl-number Specifies the range of multicast groups to which an MSDP SA message can be forwarded. acl-number specifies an ACL number. The value is an integer ranging from 2000 to 3999.
acl-name acl-name Specifies the range of multicast groups to which an MSDP SA message can be forwarded. acl-name specifies an ACL name.
NOTE:
acl-name acl-name can only be the name of a named advanced ACL.
The value is a string of 1 to 32 case-sensitive characters without spaces. The value must start with a letter (a to z or A to Z, case sensitive).

Views

Anycast RP view of public network instance or Anycast RP view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

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

To enable an RP to obtain information about the multicast source in another PIM-SM domain, you can adopt either of the following schemes:
  • Set up MSDP peer relationships between every Anycast RP member in a PIM-SM domain and the RP in another PIM-SM domain.

  • Set up MSDP peer relationships between some Anycast RP members with the RP in another PIM-SM domain. After the members who have set up MSDP peer relationships receive SA messages, they extract source/group information from SA messages, encapsulate the information into Register messages, and forward the Register messages to the members who do not set up MSDP peer relationships with the RP.

Precautions

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

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

Example

# In the public network instance, set the Anycast RP address to 10.3.3.3 and the peer address to 10.2.2.2, and enable the local RP to forward MSDP SA messages to its peers.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] anycast-rp 10.3.3.3
[Huawei-pim-anycast-rp-10.3.3.3] peer 10.2.2.2 fwd-msdp-sa

pim

Function

The pim command displays the PIM view.

The undo pim command clears the configuration in the PIM view.

Format

pim [ vpn-instance vpn-instance-name ]

undo pim [ vpn-instance vpn-instance-name ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies the name of a VPN instance. The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Before performing PIM configurations, run the pim command to enter the PIM view.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

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

Example

# Enter the PIM view of the public network instance.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim]
# Enter the PIM view of VPN instance mytest.
<Huawei> system-view
[Huawei] ip vpn-instance mytest
[Huawei-vpn-instance-mytest] ipv4-family
[Huawei-vpn-instance-mytest-af-ipv4] route-distinguisher 100:1
[Huawei-vpn-instance-mytest-af-ipv4] multicast routing-enable
[Huawei-vpn-instance-mytest-af-ipv4] quit
[Huawei-vpn-instance-mytest] quit
[Huawei] pim vpn-instance mytest
[Huawei-pim-mytest]
Related Topics

pim bfd

Function

The pim bfd command adjusts the PIM BFD parameters on an interface.

The undo pim bfd command restores the default values of PIM BFD parameters.

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

Format

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

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

undo pim 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 minimum interval for transmitting BFD packets.

The value is an integer that ranges from 10 to 2000, in milliseconds. The default value is 1000 milliseconds.

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

The value is an integer that ranges from 10 to 2000, in milliseconds. The default value is 1000 milliseconds.

detect-multiplier multiplier-value Specifies the BFD detection multiplier. The value is an integer that ranges from 3 to 50. The default value is 3.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After PIM BFD is enabled, sometimes you need to run the pim bfd command to adjust PIM BFD parameters to adapt to the link.You can use this command to set the minimum interval for sending BFD packets, minimum interval for receiving PIM BFD packets, and local detection multiplier.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command is valid only for PIM-SM.

Before setting PIM BFD parameters, run the pim bfd enable command to enable PIM BFD. Otherwise, the configured parameters do not take effect.

The minimum values of tx-value and rx-value vary with products. You are recommended to set the two values to be equal to or greater than 100. Otherwise, the BFD session flapping may occur.

Example

# Adjust the minimum interval for transmitting BFD packets on GE 0/0/1.
<Huawei> system-view
[Huawei] bfd
[Huawei-bfd] quit
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] pim sm
[Huawei-GigabitEthernet0/0/1] pim bfd enable
[Huawei-GigabitEthernet0/0/1] pim bfd min-tx-interval 100

pim bfd enable

Function

The pim bfd enable command enables PIM BFD on an interface.

The undo pim bfd enable command disables PIM BFD on an interface.

By default, PIM BFD is not enabled on an interface.

Format

pim bfd enable

undo pim bfd enable

Parameters

None

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

This command enables PIM BFD on an interface to quickly detect link failures on the interface.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command is valid for only PIM-SM.

PIM BFD depends on the BFD protocol. If the bfd command is not run to enable global BFD, the session status is BFD global disable though PIM BFD sessions can be set up.

This command is applicable to NBMA interfaces and broadcast interfaces rather than P2P interfaces.

Example

# Enable PIM BFD on GE0/0/1.
<Huawei> system-view
[Huawei] bfd
[Huawei-bfd] quit
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] pim sm
[Huawei-GigabitEthernet0/0/1] pim bfd enable

pim bsr-boundary

Function

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

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

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

Format

pim bsr-boundary

undo pim bsr-boundary

Parameters

None

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Configuration Impact

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

Example

# Configure the BSR boundary of a PIM-SM domain on GE0/0/1.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] pim bsr-boundary

pim dm

Function

The pim dm command enables PIM-DM on an interface.

The undo pim dm command restores the default configuration.

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

Format

pim dm

undo pim dm

Parameters

None

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a PIM-DM network, after PIM-DM is enabled on an interface, the industrial switch router can set up the PIM neighbor relationship with the neighboring device. The industrial switch router then can process protocol packets received from PIM neighbors.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

PIM-DM and PIM-SM cannot be enabled simultaneously on interfaces bound to the same VPN instance or public network instance.

If PIM-DM and IGMP need to be enabled on the same interface, enable PIM-DM, and then enable IGMP.

Example

# Enable PIM-DM on GE0/0/1.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] pim dm
Related Topics

pim hello-option dr-priority

Function

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

The undo pim 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 hello-option dr-priority priority

undo pim hello-option dr-priority

Parameters

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

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In PIM, industrial switch routers on the shared network segment candidates for the DR. The DR is responsible for the registering of the local multicast source and the joining of the receivers.

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

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

The pim hello-option dr-priority command has the same function as the hello-option dr-priority (IPv4) command in the PIM view. By default, if the pim hello-option dr-priority 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 priority of GE0/0/1 that is elected as DR to 3.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] pim hello-option dr-priority 3

pim hello-option holdtime

Function

The pim 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 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 hello-option holdtime interval

undo pim hello-option holdtime

Parameters

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

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

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

The pim hello-option holdtime command has the same function as the hello-option holdtime (IPv4) command in the PIM view. By default, if the pim hello-option holdtime 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 timeout period during which GE0/0/1 waits to receive Hello messages from its neighbor to 120 seconds.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] pim hello-option holdtime 120

pim hello-option lan-delay

Function

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

The undo pim 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 hello-option lan-delay interval

undo pim hello-option lan-delay

Parameters

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

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

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

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command is valid for PIM-SM and PIM-DM.

If the prune delay is set too short, the upstream industrial switch router stops forwarding multicast packets before the downstream industrial switch router 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 (IPv4) command in the PIM view, except for the view. By default, if the configuration on the interface is not performed, the value configured in the PIM view is used; otherwise, the value configured in the interface view is used.

Example

# Set the delay in transmitting messages to 200 ms in GE0/0/1.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] pim hello-option lan-delay 200

pim hello-option neighbor-tracking

Function

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

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

By default, the neighbor tracking function is not enabled.

Format

pim hello-option neighbor-tracking

undo pim hello-option neighbor-tracking

Parameters

None

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When sending a Hello message, the device generates a Generation ID and encapsulates it into the message. The Generation ID changes only when the device status changes. After receiving the Hello message, the neighboring device detects Generation ID change and immediately sends a Join message to the device to update the neighbor relationship. If multiple devices on the shared network segment 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. The upstream neighbor cannot update neighbor relationships with downstream devices because of 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

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command is valid for only PIM-SM.

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

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

Example

# Enable the neighbor tracking function in GE0/0/1.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] pim hello-option neighbor-tracking

pim hello-option override-interval

Function

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

The undo pim 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 hello-option override-interval interval

undo pim hello-option override-interval

Parameters

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

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

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

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

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Configuration Impact

If you run the pim hello-option override-interval command multiple times, only the latest configuration takes effect.

Precautions

This command is valid for PIM-SM and PIM-DM.

The pim hello-option override-interval command has the same function as the hello-option override-interval (IPv4) command in the PIM view. By default, if the pim hello-option override-interval 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 for overriding the prune action in Hello messages to 2000 ms in GE0/0/1.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] pim hello-option override-interval 2000

pim holdtime assert

Function

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

The undo pim 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 holdtime assert interval

undo pim holdtime assert

Parameters

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

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On the shared network segment connected to multiple PIM devices, if the same multicast packets reach these PIM devices and pass the RPF check, multiple copies of the same multicast packets are forwarded to this network segment. In this situation, these PIM routers need to initiate the assert mechanism. The router that wins assert election is responsible for multicast forwarding on the shared network segment. Other devices suppress multicast data forwarding and retains 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

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

The pim holdtime assert command has the same function as the holdtime assert (IPv4) command in the PIM view. By default, if the pim holdtime assert 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 timeout period for the interface GE0/0/1 to keep the Assert state to 100s.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] pim holdtime assert 100

pim holdtime join-prune

Function

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

The undo pim 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 holdtime join-prune interval

undo pim holdtime join-prune

Parameters

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

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After receiving a Join/Prune message from the downstream device, the industrial switch router starts the holdtime timer. If the industrial switch router does not receive subsequent Join/Prune messages from the downstream device within the holdtime interval, the industrial switch router suppresses forwarding of Join/Prune messages carrying group join information on the downstream interface in the group. If Join/Prune messages carry group prune information, the downstream interface is restored.

The pim holdtime join-prune command sets the holdtime interval for Join/Prune messages.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command is valid for PIM-SM and PIM-DM.

The holdtime of Join/Prune messages must be larger than the interval for sending Join/Prune messages and is generally 3.5 times the interval for sending Join/Prune messages.

The pim holdtime join-prune command has the same function as the holdtime join-prune (IPv4) command in the PIM view. By default, if the pim 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 the interface GE0/0/1 to 280 seconds.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] pim holdtime join-prune 280

pim join-policy

Function

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

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

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

Format

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

undo pim join-policy [ asm | ssm ]

Parameters

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

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Configuration Impact

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

  • If ssm is specified, in the advanced ACL view, you can set the source address range and multicast group address range of join information by respectively specifying the source parameter and destination parameter in the rule 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 GE0/0/1 to accept the join information with the group address in the range of 225.1.0.0/16.
<Huawei> system-view
[Huawei] acl number 2001
[Huawei-acl-basic-2001] rule permit source 225.1.0.0 0.0.255.255
[Huawei-acl-basic-2001] quit
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] pim join-policy asm 2001

pim neighbor-policy

Function

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

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

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

Format

pim neighbor-policy { basic-acl-number | acl-name acl-name }

undo pim neighbor-policy

Parameters

Parameter Description Value
basic-acl-number Specifies the basic ACL number. The value is an integer that ranges from 2000 to 2999.
acl-name acl-name Specifies the ACL name.
NOTE:
acl-name acl-name can only be the name of a named advanced ACL.
The value is a string of 1 to 32 case-sensitive characters without spaces. The value must start with a letter (a to z or A to Z, case sensitive).

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Configuration Impact

The pim neighbor-policy command and the acl 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 and PIM-SM.

If a PIM device has established a neighbor relationship with the industrial switch router but its IP address is not in the configured range of valid neighbor addresses, the industrial switch router 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 industrial switch router is terminated.

Example

# Allow GE0/0/1 to set up a PIM neighbor relationship with a PIM device at 10.4.4.4.
<Huawei> system-view
[Huawei] acl number 2001
[Huawei-acl-basic-2001] rule permit source 10.4.4.4 0.0.0.0
[Huawei-acl-basic-2001] quit
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] pim neighbor-policy 2001

pim require-genid

Function

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

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

By default, a PIM interface receives the Hello messages without the generation ID.

Format

pim require-genid

undo pim require-genid

Parameters

None

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

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

Example

# Configure GE0/0/1 to reject the Hello messages without the generation ID.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] pim require-genid

pim silent

Function

The pim silent command enables the PIM silent function on an interface.

The undo pim silent command cancels the PIM silent function on an interface.

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

Format

pim silent

undo pim silent

Parameters

None

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

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

If a host network segment is connected to multiple industrial switch routeres and PIM silent is enabled on multiple interfaces, all these interfaces become static DRs. This causes multicast forwarding failures.

Example

# Configure the PIM silent function on GE0/0/1.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] pim silent

pim sm

Function

The pim sm command enables PIM-SM on an interface.

The undo pim sm command restores the default configuration.

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

Format

pim sm

undo pim sm

Parameters

None

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After PIM-SM is enabled on interfaces, industrial switch routers can set up PIM neighbor relationships with each other and process protocol packets received from PIM neighbors.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

PIM-DM and PIM-SM cannot be enabled simultaneously on interfaces bound to the same VPN instance or public network instance.

If PIM-SM and IGMP need to be enabled on the same interface, enable PIM-SM, and then enable IGMP.

Example

# Enable PIM-SM on GE0/0/1.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] pim sm
Related Topics

pim state-refresh-capable

Function

The pim state-refresh-capable command enables PIM-DM state refresh on an interface.

The undo pim state-refresh-capable command disables PIM-DM state refresh.

By default, PIM-DM state refresh is enabled.

Format

pim state-refresh-capable

undo pim state-refresh-capable

Parameters

None

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

PIM-DM state refresh is implemented by periodically sending State-Refresh messages in the network. After receiving a State-Refresh message, the industrial switch router in the pruned state resets the prune-status timer. As a result, the downstream interface cannot forward packets before the prune-status timer times out.

After PIM-DM state refresh is disabled, the interface starts to forward multicast data when the prune timer times out. The downstream routers that do not want to receive the data can send Prune messages. The process is performed periodically, which wastes a lot of network resources. Enabling PIM-DM state refresh can optimize the network traffic.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command is valid for only PIM-DM.

Example

# Disable PIM-DM state refresh on GE0/0/1.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] undo pim state-refresh-capable

pim timer dr-switch-delay

Function

The pim 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 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 timer dr-switch-delay interval

undo pim timer dr-switch-delay

Parameters

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

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command is valid for only PIM-SM.

Example

# Enable PIM DR switching delay on GE0/0/1 and set the delay to 20 seconds.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] pim timer dr-switch-delay 20

pim timer graft-retry

Function

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

The undo pim 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 timer graft-retry interval

undo pim 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

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command is valid for only PIM-DM.

Example

# Set the interval for retransmitting Graft messages to 80s on the interface GE0/0/1.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] pim timer graft-retry 80

pim timer hello

Function

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

The undo pim 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 timer hello interval

undo pim timer hello

Parameters

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

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

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

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

Example

# Set the interval for sending Hello messages to 40 seconds on GE0/0/1.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] pim timer hello 40
Related Topics

pim timer join-prune

Function

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

The undo pim 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 timer join-prune interval

undo pim timer join-prune

Parameters

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

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command is valid only for PIM-SM.

The interval configured through this command must be shorter than the interval configured through the pim 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 (IPv4) command in the PIM view. The system prefers the configuration in the interface view. The value configured in the PIM 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 GE0/0/1.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] pim timer join-prune 80

pim triggered-hello-delay

Function

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

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

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

Format

pim triggered-hello-delay interval

undo pim 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

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Example

# Set the maximum delay for triggering the Hello message to 3 seconds on GE0/0/1.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] pim triggered-hello-delay 3

probe-interval (IPv4)

Function

The probe-interval command sets the interval for a industrial switch router 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 industrial switch router 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 view of public network instance or PIM view of VPN instance

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

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command is valid for only PIM-SM.

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

Example

# In the public network instance, set the interval for sending Probe messages to RP to 6 seconds.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] probe-interval 6

register-header-checksum

Function

The register-header-checksum command configures devices to calculate the checksum based on the header of a Register message only.

The undo register-header-checksum command restores the default configuration.

By default, the checksum is calculated according to all the contents of a Register message.

Format

register-header-checksum

undo register-header-checksum

Parameters

None

Views

PIM view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, the source's DR calculates the checksum based on all fields in a Register message. After the register-header-checksum command is executed, the source's DR calculates the checksum based on the Register message header. This shortens checksum calculation and improves encapsulation of multicast data in Register messages.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command is valid for only PIM-SM.

Example

# Calculate the checksum based only on the header of a Register message in the public network instance.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] register-header-checksum

register-policy (IPv4)

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-acl-number | acl-name acl-name }

undo register-policy

Parameters

Parameter Description Value
advanced-acl-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.
acl-name acl-name Specifies the name of a Named ACL.
NOTE:
acl-name acl-name can only be the name of a named advanced ACL.
The value is a string of 1 to 32 case-sensitive characters without spaces. The value must start with a letter (a to z or A to Z, case sensitive).

Views

PIM view of public network instance or PIM view of VPN instance

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

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

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.

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 source on network segment 10.10.0.0/16 to group 225.1.0.0/16.

<Huawei> system-view
[Huawei] acl number 3000
[Huawei-acl-adv-3000] rule permit ip source 10.10.0.0 0.0.255.255 destination 225.1.0.0 0.0.255.255
[Huawei-acl-adv-3000] quit
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] register-policy 3000
# Configure a Named ACL: the RP receives Register packets sent by the source on network segment 10.10.0.0/16 to group 225.1.0.0/16.
<Huawei> system-view
[Huawei] acl name myacl
[Huawei-acl-adv-myacl] rule permit ip source 10.10.0.0 0.0.255.255 destination 225.1.0.0 0.0.255.255
[Huawei-acl-adv-myacl] quit
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] register-policy acl-name myacl

register-source

Function

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

The undo register-source command restores the default setting.

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

Format

register-source interface-type interface-number

undo register-source

Parameters

Parameter Description Value
interface-type interface-number Specifies the type and number of the source's DR. -

Views

PIM view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the source IP address for sending Register messages is no longer the only IP address in the network for the RP router or the source IP 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 IP address for sending Register messages. Using the loopback address of the source's DR as the source IP address is recommended.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

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

Example

# In the public network instance, specify the IP address of loopback 0 as the source IP address for source's DR to send Register messages.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] register-source loopback 0

register-suppression-timeout (IPv4)

Function

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

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

By default, a industrial switch router 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 industrial switch router keeps the register suppression state. The value is an integer that ranges from 11 to 3600, in seconds.

Views

PIM view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Configuration Impact

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

You can use the probe-interval (IPv4) command to configure the industrial switch router 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.

Precautions

This command is valid only for PIM-SM.

The interval set by the register-suppression-timeout command must be larger than two times the interval set by the probe-interval (IPv4) command.

Example

# In the public network instance, set the timeout period during which the industrial switch router keeps the register suppression state to 70 seconds.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] register-suppression-timeout 70

reset pim control-message counters

Function

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

Format

reset pim [ vpn-instance vpn-instance-name | all-instance ] control-message counters [ interface interface-type interface-number ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies a VPN instance. vpn-instance-name specifies the name of the VPN instance. The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
all-instance Specifies all the instances. -
interface interface-type interface-number Specifies the name and the number of an interface. It is used to reset the statistics about PIM control messages on a specified interface. -

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

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

Example

# Reset the statistics about PIM control messages on all interfaces in the public network instance.

<Huawei> reset pim control-message counters
# Reset the statistics about PIM control messages on the GE0/0/1 in the public network instance.
<Huawei> reset pim control-message counters interface gigabitethernet 0/0/1

reset pim routing-table

Function

The reset pim routing-table command resets PIM status of a specified downstream interface in a specified PIM routing entry.

Format

reset pim [ vpn-instance vpn-instance-name ] routing-table group group-address mask { group-mask-length | group-mask } source source-address interface interface-type interface-number

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies the name of a VPN instance. The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
group group-address Specifies the multicast group address of a PIM routing entry. The value ranges from 224.0.1.0 to 239.255.255.255, in dotted decimal notation.
mask group-mask-length Specifies the mask length of a multicast group address. The value is an integer that ranges from 4 to 32.
mask group-mask Specifies the mask of a multicast group address. It is in dotted decimal notation.
source source-address Specifies the source address of a PIM routing entry. The value is in dotted decimal notation. If a (*, G) entry is specified, the source address is 0.0.0.0.
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 routing-table command resets PIM status of a specified downstream interface in a specified PIM routing entry.

Configuration Impact

This command can reset the PIM status of the specified interface in a specified PIM routing entry. It cannot reset the IGMP state and static group memberships on a specified interface.

Precautions

This command is valid only for PIM-SM.

Resetting PIM status of downstream interfaces can trigger transmission of Join/Prune messages, which causes multicast service interruption.

Example

# In the public network instance, reset PIM status of downstream interface GE0/0/1 of (10.1.1.1, 225.0.0.1).
<Huawei> reset pim routing-table group 225.0.0.1 mask 255.255.255.0 source 10.1.1.1 interface gigabitethernet 0/0/1

source-lifetime (IPv4)

Function

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

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

By default, the timeout period is 210 seconds.

Format

source-lifetime interval

undo source-lifetime

Parameters

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

Views

PIM view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A industrial switch router starts a timer for each (S, G) or (*, G) entry. The source-lifetime command sets the timer value. After receiving a multicast packet from S, the interface resets the timer. If the timer times out, the (S, G) or (*, G) entry is considered invalid.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

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

Example

# In the public network instance, set the timeout period of an (S, G) or (*, G) entry of the industrial switch router to 200 seconds.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] source-lifetime 200

source-policy (IPv4)

Function

The source-policy command configures the industrial switch router 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 industrial switch router does not filter received multicast data packets based on source addresses or source/group addresses.

Format

source-policy { acl-number | acl-name acl-name }

undo source-policy

Parameters

Parameter Description Value
acl-number Specifies number of the basic or advanced ACL. The value is an integer that ranges from 2000 to 3999.
acl-name acl-name Specifies the name of a named ACL.
NOTE:
acl-name acl-name can only be the name of a named advanced ACL.
The value is a string of 1 to 32 case-sensitive characters without spaces. The value must start with a letter (a to z or A to Z, case sensitive).

Views

PIM view of public network instance or PIM view of VPN instance

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 industrial switch router to filter received multicast data packets based on source addresses or source/group addresses.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Configuration Impact

If source-policy and the basic ACL are applied, all multicast data packets received should match the source address. Packets that do not pass the filtering are discarded.

If source-policy and the advanced ACL are used, the source addresses and group addresses of all received multicast data packets should be matched. Packets that do not pass the filtering are discarded.

The configurations of the Named ACL and advanced ACL are the same, and can implement filtering of both source addresses and multicast group addresses. The Named ACL can also be configured with the time-range parameter.

Precautions

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

Example

# In the public network instance, configure the industrial switch router to receive multicast data packets with the source address of 10.10.1.2 and to discard those with the source address of 10.10.1.1.

<Huawei> system-view
[Huawei] acl number 2001
[Huawei-acl-basic-2001] rule permit source 10.10.1.2 0
[Huawei-acl-basic-2001] rule deny source 10.10.1.1 0
[Huawei-acl-basic-2001] quit
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] source-policy 2001
# In the public network instance, configure a Named ACL where multicast data packets with the source address of 10.10.1.2 are received, and those with the source address of 10.10.1.1 are dropped.
<Huawei> system-view
[Huawei] acl name myacl
[Huawei-acl-adv-myacl] rule permit ip source 10.10.1.2 0
[Huawei-acl-adv-myacl] rule deny ip source 10.10.1.1 0
[Huawei-acl-adv-myacl] quit
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] source-policy acl-name myacl

spt-switch-threshold (IPv4)

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-acl-number | acl-name acl-name } [ order order-value ] ]

undo spt-switch-threshold [ traffic-rate | infinity ] [ group-policy { basic-acl-number ]

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 triggered. -
basic-acl-number Specifies an entry of the group-policy list. It works with the multicast group that matches group-policy basic-acl-number to enable the threshold. basic-acl-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.
acl-name acl-name Specifies the name of a Named ACL.
NOTE:
acl-name acl-name can only be the name of a named advanced ACL.
The value is a string of 1 to 32 case-sensitive characters without spaces. The value must start with a letter (a to z or A to Z, case sensitive).
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. It 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 view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The source's DR encapsulates multicast packets in a Register message, and then transmits the unicast Register message to the RP. Then, the RP decapsulates the Register message and forwards the multicast packets to the receivers along the RPT. By default, when the RP or receiver's DR receives a first multicast packet, it initiates an SPT switchover to the source.

After the spt-switch-threshold command is executed on the receiver's DR, the receiver's DR periodically checks the forwarding rate of multicast packets. When the forwarding rate exceeds the threshold, the receiver's DR sends a Join messages to the source, triggering the SPT switchover.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

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

This command is valid for only PIM-SM.

If this command is used several times for the same group, the command that is first matched according to the order takes effect.

Example

# In the public network instance, set the traffic rate threshold to 4 kbit/s. If the transmission rate of packets from the source to the multicast group exceeds the threshold, the industrial switch router triggers an SPT switchover so that packets are forwarded along the SPT towards the source.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] spt-switch-threshold 4
# In the public network instance, create a group-policy that uses ACL 2010, specify the infinity keyword in the command to ensure that an SPT switchover will never be triggered, and set the order of ACL 2010 in the group-policy to 1.
<Huawei> system-view
[Huawei] acl number 2010
[Huawei-acl-basic-2010] rule permit source 225.1.1.1 0
[Huawei-acl-basic-2010] quit
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] spt-switch-threshold infinity group-policy 2010 order 1
# In the public network instance, create a group-policy that uses ACL 2010, set the traffic rate threshold to 100 kbit/s, and order ACL 2010 in the group-policy to 1.
<Huawei> system-view
[Huawei] acl number 2010
[Huawei-acl-basic-2010] rule permit source 225.1.1.1 0
[Huawei-acl-basic-2010] quit
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] spt-switch-threshold 100 group-policy 2010 order 1
# In the public network instance, create a group-policy that uses ACL myacl, set the traffic rate threshold to 100 kbit/s, and order ACL myacl in the group-policy to 1.
<Huawei> system-view
[Huawei] acl name myacl
[Huawei-acl-adv-myacl] rule permit ip destination 225.1.0.0 0.0.255.255
[Huawei-acl-adv-myacl] quit
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] spt-switch-threshold 100 group-policy acl-name myacl order 1

ssm-policy (IPv4)

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 SSM group addresses is 232.0.0.0/8.

Format

ssm-policy { basic-acl-number | acl-name acl-name }

undo ssm-policy

Parameters

Parameter Description Value
basic-acl-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.
acl-name acl-name Specifies the name of a Named ACL.
NOTE:
acl-name acl-name can only be the name of a named advanced ACL.
The value is a string of 1 to 32 case-sensitive characters without spaces. The value must start with a letter (a to z or A to Z, case sensitive).

Views

PIM view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, the address of an SSM group ranges from 232.0.0.0 to 232.255.255.255. You can run the ssm-policy command to specify the range of PIM SSM group addresses. All the PIM-SM interfaces consider that PIM SSM is enabled on all the multicast groups in the specified address range. The specified SSM group address range can beyond 232.0.0.0/8.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command is valid for only PIM-SM.

Example

# In the public network instance, set the range of PIM SSM multicast addresses to 232.1.0.0/16.
<Huawei> system-view
[Huawei] acl number 2000
[Huawei-acl-basic-2000] rule permit source 232.1.0.0 0.0.255.255
[Huawei-acl-basic-2000] quit
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] ssm-policy 2000
# In the public network instance, configure a Named ACL: the PIM SSM multicast address range is 232.1.0.0/16.
<Huawei> system-view
[Huawei] acl name myacl
[Huawei-acl-adv-myacl] rule permit ip destination 232.1.0.0 0.0.255.255
[Huawei-acl-adv-myacl] quit
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] ssm-policy acl-name myacl
Related Topics

state-refresh-interval (IPv4)

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 view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On the PIM-DM 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. You can use the state-refresh-interval command to set the interval at which State-Refresh messages are sent.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

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 (IPv4) command to set the period during which the device keeps the Prune status.

This command is valid for only PIM-DM.

This command takes effect only on the routers directly conected to a source.

Example

# Set the interval for sending PIM State-Refresh messages to 70s in the public network instance.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] state-refresh-interval 70

state-refresh-rate-limit (IPv4)

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 view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A industrial switch router 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 industrial switch router discards the received duplicate State-Refresh messages.

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command is valid for only PIM-DM.

Example

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

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

state-refresh-ttl (IPv4)

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 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 view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After receiving a State-Refresh message, the industrial switch router decreases the value of the TTL in the message by 1, and then sends the message to the downstream industrial switch router 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

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command is valid for only PIM-DM.

This command takes effect only on the routers directly conected to a source.

Example

# Set the TTL value for sending PIM State-Refresh messages to 45 in the public network instance.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] state-refresh-ttl 45

static-rp (IPv4)

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-acl-number | acl-name acl-name ] [ preferred ]

undo static-rp rp-address

Parameters

Parameter Description Value
rp-address Specifies address of a static RP. The address is in dotted decimal notation. It must be a valid unicast IP address and cannot be configured as an address of network segment 127.0.0.0/8.
basic-acl-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.
acl-name acl-name Specifies the name of a named ACL.
NOTE:
acl-name acl-name can only be the name of a named advanced ACL.
The value is a string of 1 to 32 case-sensitive characters without spaces. The value must start with a letter (a to z or A to Z, case sensitive).
preferred Indicates that the static RP is preferred. -

Views

PIM view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When only one RP exists on a network, you can manually specify the static RP address and do not need to configure dynamic RP. This saves the bandwidth used to exchange information between the C-RPs and the BSR.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Configuration Impact

If the static RP address is the address of an Up interface on the local device, the local device works as the static RP. PIM does not need to be enabled on the interface where the static RP address is located.

If no ACL is specified, the static RP serves all the multicast groups of 224.0.0.0/4. If an ACL is specified but no rule is configured in the ACL, the static RP serves all the groups of 224.0.0.0/4. If ACL rules are configured, the static RP serves only the multicast groups permitted by the ACL.

If the static-rp command does not contain preferred, devices apply the BSR mechanism to elect a dynamic RP. If dynamic RP is not configured or the dynamic RP is invalid, the static RP becomes valid. If the static-rp command contains preferred, the static RP is preferred over the dynamic RP.

If you run this command multiple times, multiple static RPs are configured. If multiple static RPs serve the same group, the RP with the largest IP address is selected to serve the group. If you specify the same RP address when running the static-rp command multiple times, the latest RP takes effect.

Precautions

NOTE:

Up to 50 static RPs can be configured by using this command, but an ACL cannot be applied to multiple static RPs. If no ACL is referenced, only one static RP can be configured.

To ensure normal operating of a static RP, run the static-rp command to configure the same RP information on all devices in the PIM-SM domain.

This command is valid only for PIM-SM.

Example

# In the public network instance, configure the industrial switch router with address 10.110.0.6 as a static RP serving the groups permitted by ACL 2001, and configure the static RP to be preferred.

<Huawei> system-view
[Huawei] acl number 2001
[Huawei-acl-basic-2001] rule permit source 225.1.0.0 0.0.255.255
[Huawei-acl-basic-2001] quit
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] static-rp 10.110.0.6 2001 preferred
# In the public network instance, configure the industrial switch router with address 10.110.0.6 as a static RP serving the groups permitted by ACL myacl, and configure the static RP to be preferred.
<Huawei> system-view
[Huawei] acl name myacl
[Huawei-acl-adv-myacl] rule permit ip destination 225.1.0.0 0.0.255.255
[Huawei-acl-adv-myacl] quit
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] static-rp 10.110.0.6 acl-name myacl preferred
Related Topics

timer hello (IPv4)

Function

The timer hello command sets the interval at which the PIM industrial switch router sends Hello messages.

The undo timer hello command restores the default interval.

By default, the interval at which the PIM industrial switch router 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 ranging from 1 to 18000, in seconds.

Views

PIM view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Configuration Impact

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

The interval at which the PIM industrial switch router sends Hello messages should be less than the timeout period of the PIM neighbor. You can run the hello-option holdtime (IPv4) command to set the timeout period of PIM neighbors.

The timer hello command has the same function as the pim timer hello command in the interface view. By default, if the pim 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 in the public network instance.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] timer hello 40

timer join-prune (IPv4)

Function

The timer join-prune command configures the interval at which Join/Prune messages are sent to an upstream industrial switch router.

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

By default, the interval at which Join/Prune messages are sent to an upstream industrial switch router 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 view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The industrial switch router sends join information to the upstream device, requesting the upstream device to forward multicast data. The industrial switch router 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 router periodically sends Join/Prune messages to the upstream router to update the forwarding status.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command is valid only for PIM-SM.

The interval configured using the timer join-prune command must be shorter than the interval configured using the holdtime join-prune (IPv4) command.

The timer join-prune command has the same function as the pim timer join-prune command in the interface view. By default, if the pim 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 in the public network instance.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] pim
[Huawei-pim] timer join-prune 80
Related Topics

timer spt-switch (IPv4)

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 view of public network instance or PIM view of VPN instance

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

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command is valid for only PIM-SM.

Before running this command, you must set the threshold for SPT switchover by using the spt-switch-threshold (IPv4) command; otherwise, the timer spt-switch command takes no effect.

Example

# In the public network instance, 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 routing-enable
[Huawei] pim
[Huawei-pim] spt-switch-threshold 100
[Huawei-pim] timer spt-switch 30
Translation
Download
Updated: 2019-05-29

Document ID: EDOC1000097293

Views: 69392

Downloads: 113

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