When the system is operating in standard mode, BIDIR-PIM is not supported. For more information about the system operating mode, see Fundamentals Configuration Guide.

Related commands: pim and multicast routing-enable.

Examples

# Enable multicast routing on the public network, enter PIM view, and enable BIDIR-PIM.

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] pim

[Sysname-pim] bidir-pim enable

# Enable multicast routing in VPN instance mvpn, enter VPN instance PIM view, and enable BIDIR-PIM.

<Sysname> system-view

[Sysname] ip vpn-instance mvpn

[Sysname-vpn-instance-mvpn] route-distinguisher 100:1

[Sysname-vpn-instance-mvpn] multicast routing-enable

[Sysname-vpn-instance-mvpn] quit

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] bidir-pim enable

bsm-fragment enable (PIM view)

Syntax

bsm-fragment enable

undo bsm-fragment enable

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

None

Description

Use bsm-fragment enable to enable bootstrap message (BSM) semantic fragmentation.

Use undo bsm-fragment enable to disable BSM semantic fragmentation.

By default, BSM semantic fragmentation is enabled.

Disable the BSM semantic fragmentation function if devices not supporting this function exist in the PIM-SM domain.

Related commands: c-bsr admin-scope.

Examples

# Disable BSM semantic fragmentation on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] undo bsm-fragment enable

# Disable BSM semantic fragmentation in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] undo bsm-fragment enable

bsr-policy (PIM view)

Syntax

bsr-policy acl-number

undo bsr-policy

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

acl-number: Specifies a basic ACL number in the range of 2000 to 2999. When an ACL is defined, the source keyword in the rule command specifies a legal BSR source address range.

Description

Use bsr-policy to configure a legal BSR address range to guard against BSR spoofing.

Use undo bsr-policy to remove the restriction of the BSR address range.

By default, no restrictions are defined for the BSR address range. The bootstrap messages from any source are regarded to be valid.

Examples

# Configure a legal BSR address range on the public network so that only devices on the segment 10.1.1.0/24 can become the BSR.

<Sysname> system-view

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 10.1.1.0 0.0.0.255

[Sysname-acl-basic-2000] quit

[Sysname] pim

[Sysname-pim] bsr-policy 2000

# Configure a legal BSR address range in VPN instance mvpn so that only devices on the segment 10.1.1.0/24 can become the BSR.

<Sysname> system-view

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 10.1.1.0 0.0.0.255

[Sysname-acl-basic-2000] quit

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] bsr-policy 2000

c-bsr (PIM view)

Syntax

c-bsr interface-type interface-number [ hash-length [ priority ] ]

undo c-bsr

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

interface-type interface-number: Specifies an interface by its type and number.

hash-length: Specifies a hash mask length in the range of 0 to 32. If this argument is not specified, the corresponding global setting is used.

priority: Specifies the priority of the C-BSR, in the range of 0 to 255. A larger value represents a higher priority. If this argument is not specified, the corresponding global setting is used.

Description

Use c-bsr to configure the specified interface as a C-BSR.

Use undo c-bsr to remove the related C-BSR configuration.

No C-BSR is configured by default.

PIM-SM must be enabled on the interface to be configured as a C-BSR.

Related commands: c-bsr hash-length, c-bsr priority, c-rp, and pim sm.

Examples

# Configure VLAN-interface 100 on the public network to be a C-BSR.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr vlan-interface 100

# Configure VLAN-interface 100 in VPN instance mvpn to be a C-BSR.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] c-bsr vlan-interface 100

c-bsr admin-scope (PIM view)

Syntax

c-bsr admin-scope

undo c-bsr admin-scope

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

None

Description

Use c-bsr admin-scope to enable administrative scoping.

Use undo c-bsr admin-scope to disable administrative scoping.

By default, BSR administrative scoping is disabled and only one BSR exists in a PIM-SM domain.

Related commands: c-bsr, c-bsr global, and c-bsr group.

Examples

# Enable administrative scoping on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr admin-scope

# Enable administrative scoping in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] c-bsr admin-scope

c-bsr global

Syntax

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

undo c-bsr global

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

hash-length: Specifies a hash mask length in the global scope zone, in the range of 0 to 32. If this argument is not specified, the corresponding global setting is used.

priority: Specifies the priority of the C-BSR in the global scope zone, in the range of 0 to 255. A larger value represents a higher priority. If this argument is not specified, the corresponding global setting is used.

Description

Use c-bsr global to configure a C-BSR for the global scope zone.

Use undo c-bsr global to remove the C-BSR configuration for the global scope zone.

By default, no C-BSRs are configured for the global scope zone.

Related commands: c-bsr group, c-bsr hash-length, and c-bsr priority.

Examples

# Configure the device to be a C-BSR for the global scope zone on the public network, with the priority of 1.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr global priority 1

# Configure the device to be a C-BSR for the global scope zone in VPN instance mvpn, with the priority of 1.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] c-bsr global priority 1

c-bsr group

Syntax

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

undo c-bsr group group-address

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

group-address: Specifies a multicast group address in the range of 239.0.0.0 to 239.255.255.255.

mask: Specifies the address mask.

mask-length: Specifies the address mask length in the range of 8 to 32.

hash-length: Specifies a hash mask length in the admin-scope region corresponding to the specified multicast group, in the range of 0 to 32. If this argument is not specified, the corresponding global setting is used.

priority: Specifies the priority of the C-BSR in the admin-scope region corresponding to a multicast group, in the range of 0 to 255. A larger value represents a higher priority. If this argument is not specified, the corresponding global setting is used.

Description

Use c-bsr group to configure a C-BSR for the admin-scope region associated with the specified group.

Use undo c-bsr group to remove the C-BSR configuration for the admin-scope region associated with the specified group.

By default, no C-BSRs are configured for admin-scope regions.

Related commands: c-bsr admin-scope, c-bsr global, c-bsr hash-length, and c-bsr priority.

Examples

# In the public network, configure the device to be a C-BSR in the admin-scope region associated with the multicast group address 239.0.0.0/8, with the priority of 10.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr group 239.0.0.0 255.0.0.0 priority 10

# In VPN instance mvpn, configure the device to be a C-BSR in the admin-scope region associated with the multicast group address 239.0.0.0/8, with the priority of 10.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] c-bsr group 239.0.0.0 255.0.0.0 priority 10

c-bsr hash-length (PIM view)

Syntax

c-bsr hash-length hash-length

undo c-bsr hash-length

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

hash-length: Specifies a hash mask length in the range of 0 to 32.

Description

Use c-bsr hash-length to configure the global hash mask length.

Use undo c-bsr hash-length to restore the default.

By default, the hash mask length is 30.

Related commands: c-bsr, c-bsr global, and c-bsr group.

Examples

# Set the global hash mask length to 16 on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr hash-length 16

# Set the global hash mask length to 16 in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] c-bsr hash-length 16

c-bsr holdtime (PIM view)

Syntax

c-bsr holdtime interval

undo c-bsr holdtime

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

interval: Specifies a BS timeout value in seconds, in the range of 1 to 2147483647.

Description

Use c-bsr holdtime to configure the BS timeout (length of time that a C-BSR waits before it must receive a bootstrap message from the BSR).

Use undo c-bsr holdtime to restore the default.

By default, the bootstrap timeout value is determined by this formula: BS timeout = BS period × 2 + 10.

The default BS period is 60 seconds, so the default BS timeout = 60 × 2 + 10 = 130 (seconds).

Related commands: c-bsr and c-bsr interval.

Examples

# Set the BS timeout time to 150 seconds on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr holdtime 150

# Set the BS timeout time to 150 seconds in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] c-bsr holdtime 150

c-bsr interval (PIM view)

Syntax

c-bsr interval interval

undo c-bsr interval

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

interval: Specifies a BS period in seconds, in the range of 10 to 2147483647.

Description

Use c-bsr interval to configure the BS period (the interval at which the BSR sends bootstrap messages).

Use undo c-bsr interval to restore the default.

By default, the BS period value is determined by this formula: BS period = (BS timeout – 10) ÷ 2.

The default BS timeout is 130 seconds, so the default BS period = (130 – 10) ÷ 2 = 60 (seconds).

Related commands: c-bsr and c-bsr holdtime.

Examples

# Set the BS period to 30 seconds on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr interval 30

# Set the BS period to 30 seconds in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] c-bsr interval 30

c-bsr priority (PIM view)

Syntax

c-bsr priority priority

undo c-bsr priority

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

priority: Specifies the priority of the C-BSR, in the range of 0 to 255. A larger value represents a higher priority.

Description

Use c-bsr priority to configure the global C-BSR priority.

Use undo c-bsr priority to restore the default.

By default, the C-BSR priority is 64.

Related commands: c-bsr, c-bsr global, and c-bsr group.

Examples

# Set the global C-BSR priority to 5 on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr priority 5

# Set the global C-BSR priority to 5 in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] c-bsr priority 5

c-rp (PIM view)

Syntax

c-rp interface-type interface-number [ group-policy acl-number | priority priority | holdtime hold-interval | advertisement-interval adv-interval ] * [ bidir ]

undo c-rp interface-type interface-number

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

interface-type interface-number: Specifies an interface by its type and number.

acl-number: Specifies a basic ACL number in the range of 2000 to 2999. This ACL defines a range of multicast groups to which the C-RP is designated, rather than defining a filtering rule. Any group range matching the permit statement in the ACL will be advertised as a group range to which the C-RP is designated, but the configuration matching other statements like deny will not take effect.

priority: Specifies the priority of the C-RP, in the range of 0 to 255. The default value is 192. A larger value represents a lower priority.

hold-interval: Specifies a C-RP timeout time in seconds, in the range of 1 to 65535. If this argument is not specified, the corresponding global setting is used.

adv-interval: Specifies a C-RP-Adv interval in seconds, in the range of 1 to 65535. If this argument is not specified, the corresponding global setting is used.

bidir: Specifies BIDIR-PIM. If this argument is not specified, the PIM mode is PIM-SM.

Description

Use c-rp to configure the specified interface as a C-RP.

Use undo c-rp to remove the related C-RP configuration.

No C-RPs are configured by default.

PIM-SM must be enabled on the interface to be configured as a C-RP.

If the group range for the C-RP is not specified, the C-RP provides services for all multicast groups.

If you want a device to be a C-RP for multiple group ranges, you need to include these multiple group ranges in multiple rules in the ACL corresponding to the group-policy keyword.

If you execute this command multiple times on the same interface, the most recent configuration takes effect.

Related commands: c-bsr.

Examples

# Configure VLAN-interface 100 on the public network to be a C-RP for multicast groups 225.1.0.0/16 and 226.2.0.0/16, with a priority of 10.

<Sysname> system-view

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 225.1.0.0 0.0.255.255

[Sysname-acl-basic-2000] rule permit source 226.2.0.0 0.0.255.255

[Sysname-acl-basic-2000] quit

[Sysname] pim

[Sysname-pim] c-rp vlan-interface 100 group-policy 2000 priority 10

# Configure VLAN-interface 100 in VPN instance mvpn to be a C-RP for multicast groups 225.1.0.0/16 and 226.2.0.0/16, with a priority of 10.

<Sysname> system-view

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 225.1.0.0 0.0.255.255

[Sysname-acl-basic-2000] rule permit source 226.2.0.0 0.0.255.255

[Sysname-acl-basic-2000] quit

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] c-rp vlan-interface 100 group-policy 2000 priority 10

c-rp advertisement-interval (PIM view)

Syntax

c-rp advertisement-interval interval

undo c-rp advertisement-interval

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

interval: Specifies a C-RP-Adv interval in seconds, in the range of 1 to 65535.

Description

Use c-rp advertisement-interval to configure the interval at which C-RP-Adv messages are sent.

Use undo c-rp advertisement-interval to restore the default.

By default, the C-RP-Adv interval is 60 seconds.

Related commands: c-rp.

Examples

# Set the global C-RP-Adv interval to 30 seconds on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-rp advertisement-interval 30

# Set the global C-RP-Adv interval to 30 seconds in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] c-rp advertisement-interval 30

c-rp holdtime (PIM view)

Syntax

c-rp holdtime interval

undo c-rp holdtime

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

interval: Specifies a C-RP timeout time in seconds, in the range of 1 to 65535.

Description

Use c-rp holdtime to configure the global C-RP timeout time (the length of time that the BSR waits before it must receive a C-RP-Adv message).

Use undo c-rp holdtime to restore the default.

By default, the C-RP timeout time is 150 seconds.

Because a non-BSR router refreshes its C-RP timeout time through BSR bootstrap messages, to prevent loss of C-RP information in BSR bootstrap messages, make sure that the C-RP timeout time is not smaller than the interval at which the BSR sends bootstrap messages. The recommended C-RP timeout setting is 2.5 times the BS period or longer.

Related commands: c-bsr interval and c-rp.

Examples

# Set the global C-RP timeout time to 200 seconds on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-rp holdtime 200

# Set the global C-RP timeout time to 200 seconds in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] c-rp holdtime 200

crp-policy (PIM view)

Syntax

crp-policy acl-number

undo crp-policy

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

acl-number: Specifies an advanced ACL number in the range of 3000 to 3999. When the ACL is defined, the source keyword in the rule command specifies the address of a C-RP and the destination keyword specifies the address range of the multicast groups to which the C-RP is designated.

Description

Use crp-policy to configure a legal C-RP address range and the multicast group range to which the C-RP is designated.

Use undo crp-policy to remove the restrictions in C-RP address ranges and the multicast group range to which the C-RP is designated.

By default, no restrictions are defined for C-RP address ranges and the multicast group range to which the C-RP is designated. All received C-RP messages are accepted.

This command guards against C-RP spoofing.

The crp-policy command filters the multicast group ranges advertised by C-RPs based on the group prefixes. For example, if the multicast group range advertised by a C-RP is 224.1.0.0/16 and the legal group range defined by the crp-policy command is 224.1.0.0/30, the multicast groups in the range of 224.1.0.0/16 are allowed to pass.

Related commands: c-rp.

Examples

# In the public network, configure a C-RP policy so that only devices in the address range of 1.1.1.1/24 can be C-RPs that provide services for multicast groups in the address range of 225.1.1.0/24.

<Sysname> system-view

[Sysname] acl number 3000

[Sysname-acl-adv-3000] rule permit ip source 1.1.1.1 0.0.0.255 destination 225.1.1.0 0.0.0.255

[Sysname-acl-adv-3000] quit

[Sysname] pim

[Sysname-pim] crp-policy 3000

# In VPN instance mvpn, configure a C-RP policy, so that only devices in the address range of 1.1.1.1/24 can be C-RPs that provide services for multicast groups in the address range of 225.1.1.0/24.

<Sysname> system-view

[Sysname] acl number 3000

[Sysname-acl-adv-3000] rule permit ip source 1.1.1.1 0.0.0.255 destination 225.1.1.0 0.0.0.255

[Sysname-acl-adv-3000] quit

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] crp-policy 3000

display pim bsr-info

Syntax

display pim [ all-instance | vpn-instance vpn-instance-name ] bsr-info [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all-instance: Specifies all VPN instances.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display pim bsr-info to display BSR information in the PIM domain and the locally configured C-RP information in effect.

If neither all-instance nor vpn-instance is specified, this command will display the information on the public network.

Related commands: c-bsr and c-rp.

Examples

# Display the BSR information of the PIM-SM domain on the public network and the locally configured C-RP information in effect.

<Sysname> display pim bsr-info

VPN-Instance: public net

Elected BSR Address: 12.12.12.9

Priority: 64

Hash mask length: 30

State: Elected

Scope: Global

Uptime: 00:00:56

Next BSR message scheduled at: 00:01:14

Candidate BSR Address: 12.12.12.9

Priority: 64

Hash mask length: 30

State: Elected

Scope: Global

Candidate RP: 12.12.12.9(LoopBack1)

Priority: 192

HoldTime: 150

Advertisement Interval: 60

Next advertisement scheduled at: 00:00:48

Candidate RP: 3.3.3.3(Vlan-interface100)

Priority: 200

HoldTime: 90

Advertisement Interval: 50

Next advertisement scheduled at: 00:00:28

Candidate RP: 5.5.5.5(Vlan-interface101)

Priority: 192

HoldTime: 80

Advertisement Interval: 60

Next advertisement scheduled at: 00:00:48

Table 1 Command output

Field	Description
VPN-Instance: public net	Public network.
Elected BSR Address	Address of the elected BSR.
Candidate BSR Address	Address of the candidate BSR.
Priority	BSR priority.
Hash mask length	Hash mask length.
State	BSR state.
Scope	Scope of the BSR.
Uptime	Length of time for which this BSR has been up, in hh:mm:ss.
Next BSR message scheduled at	Length of time in which the BSR will expire, in hh:mm:ss.
Candidate RP	Address of the C-RP.
Priority	Priority of the C-RP.
HoldTime	Timeout time of the C-RP.
Advertisement Interval	Interval at which the C-RP sends advertisement messages.
Next advertisement scheduled at	Length of time in which the C-RP will send the next advertisement message, in hh:mm:ss.

display pim claimed-route

Syntax

display pim [ all-instance | vpn-instance vpn-instance-name ] claimed-route [ source-address ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all-instance: Specifies all VPN instances.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.

source-address: Displays the information of the unicast route to a particular multicast source. If this argument is not specified, this command displays information about all unicast routes used by PIM.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display pim claimed-route to display information about unicast routes used by PIM.

If neither all-instance nor vpn-instance is specified, this command displays information on the public network.

If an (S, G) is marked SPT, this (S, G) entry uses a unicast route.

Examples

# Display information about all unicast routes used by PIM on the public network.

<Sysname> display pim claimed-route

VPN-Instance: public net

RPF information about: 172.168.0.0

RPF interface: Vlan-interface100, RPF neighbor: 172.168.0.2

Referenced route/mask: 172.168.0.0/24

Referenced route type: unicast (direct)

RPF-route selecting rule: preference-preferred

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

(172.168.0.12, 227.0.0.1)

Table 2 Command output

Field	Description
VPN-Instance: public net	Public network.
RPF information about: 172.168.0.0	Information of the route to the multicast source 172.168.0.0
RPF interface	RPF interface type and number.
RPF neighbor	IP address of the RPF neighbor.
Referenced route/mask	Address/mask of the referenced route.
Referenced route type	Type of the referenced route: · igp—IGP unicast route. · egp—EGP unicast route. · unicast (direct)—Direct unicast route. · unicast—Other unicast route (such as static unicast route). · mbgp—MBGP route. · multicast static—Static multicast route.
RPF-route selecting rule	Rule of RPF route selection.
The (S,G) or (*,G) list dependent on this route entry	(S,G) or (*, G) entry list dependent on this RPF route.

display pim control-message counters

Syntax

display pim [ all-instance | vpn-instance vpn-instance-name ] control-message counters [ message-type { probe | register | register-stop } | [ interface interface-type interface-number | message-type { assert | bsr | crp | graft | graft-ack | hello | join-prune | state-refresh } ] * ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all-instance: Specifies all VPN instances.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.

probe: Displays the number of null register messages.

interface interface-type interface-number: Displays the number of PIM control messages on the specified interface.

assert: Displays the number of assert messages.

bsr: Displays the number of Bootstrap messages.

crp: Displays the number of C-RP-Adv messages.

graft: Displays the number of Graft messages.

graft-ack: Displays the number of Graft-ack messages.

hello: Displays the number of Hello messages.

join-prune: Displays the number of Join/prune messages.

state-refresh: Displays the number of state refresh messages.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display pim control-message counters to display statistics for PIM control messages.

If neither all-instance nor vpn-instance is specified, this command displays the information on the public network.

Examples

# Display statistics for all PIM control messages on all interfaces on the public network.

<Sysname> display pim control-message counters

VPN-Instance: public net

PIM global control-message counters:

Received Sent Invalid

Probe 10 5 0

PIM control-message counters for interface: Vlan-interface100

Received Sent Invalid

Assert 10 5 0

Graft 20 37 2

Graft-Ack 25 20 1

Hello 1232 453 0

Join/Prune 15 30 21

State-Refresh 8 7 1

BSR 3243 589 1

C-RP 53 32 0

Table 3 Command output

Field	Description
VPN-Instance: public net	Public network.
PIM global control-message counters	Statistics of PIM global control messages.
PIM control-message counters for interface	Interface for which PIM control messages were counted.
Received	Number of messages received.
Sent	Number of messages sent.
Invalid	Number of invalid messages.
Register	Register messages.
Register-Stop	Register-stop messages.
Probe	Null register messages.
Assert	Assert messages.
Graft	Graft messages.
Graft-Ack	Graft-ack messages.
Hello	Hello messages.
Join/Prune	Join/prune messages.
State Refresh	State refresh messages.
BSR	Bootstrap messages.
C-RP	C-RP-Adv messages.

display pim df-info

Syntax

display pim [ all-instance | vpn-instance vpn-instance-name ] df-info [ rp-address ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all-instance: Specifies all instances.

vpn-instance vpn-instance-name: Specifies a VPN instance. A VPN instance name is a case-sensitive string of up to 31 characters and must not contain any space.

rp-address: Specifies the RP address of BIDIR-PIM.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display pim df-info to display the DF information of BIDIR-PIM.

If neither all-instance nor vpn-instance is specified, this command displays the DF information of BIDIR-PIM on the public network.

Examples

# Display the DF information of BIDIR-PIM on the public network.

<Sysname> display pim df-info

VPN-Instance: public net

RP Address: 1.1.1.1

Interface State DF-Pref DF-Metric DF-Uptime DF-Address

Loop0 Win 150 1 00:32:59 4.4.4.4 (local)

Vlan106 Win 150 1 00:32:59 6.0.0.1 (local)

Table 4 Command output

Field	Description
VPN-Instance: public net	Public network.
RP Address	BIDIR-PIM RP address.
Interface	Interface type and number.
State	DF election state: Win or lose.
DF-Pref	Route priority of DF.
DF-Metric	Route metric of DF.
DF-Uptime	Existence duration of DF.
DF-Address	IP address of DF. If a local address is used, this field displays local in brackets ( ) after the IP address.

display pim grafts

Syntax

display pim [ all-instance | vpn-instance vpn-instance-name ] grafts [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all-instance: Specifies all VPN instances.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display pim grafts to display information about unacknowledged PIM-DM graft messages.

If neither all-instance nor vpn-instance is specified, this command displays information on the public network.

Examples

# Display information about unacknowledged PIM-DM graft messages on the public network.

<Sysname> display pim grafts

VPN-Instance: public net

Source Group Age RetransmitIn

192.168.10.1 224.1.1.1 00:00:24 00:00:02

Table 5 Command output

Field	Description
VPN-Instance: public net	Public network.
Source	Multicast source address in the graft message.
Group	Multicast group address in the graft message.
Age	Time in which the graft message will get aged out, in hh:mm:ss.
RetransmitIn	Time in which the graft message will be retransmitted, in hh:mm:ss.

display pim interface

Syntax

display pim [ all-instance | vpn-instance vpn-instance-name ] interface [ interface-type interface-number ] [ verbose ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all-instance: Specifies all VPN instances.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.

interface-type interface-number: Displays the PIM information on a particular interface.

verbose: Displays detailed PIM information.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display pim interface to display PIM information on the specified interface or all interfaces.

If neither all-instance nor vpn-instance is specified, this command displays information on the public network.

Examples

# Display PIM information on all interfaces on the public network.

<Sysname> display pim interface

VPN-Instance: public net

Interface NbrCnt HelloInt DR-Pri DR-Address

Vlan100 1 30 1 10.1.1.2

Vlan101 0 30 1 172.168.0.2 (local)

Vlan102 1 30 1 20.1.1.2

Table 6 Command output

Field	Description
VPN-Instance: public net	Public network.
Interface	Interface name.
NbrCnt	Number of PIM neighbors.
HelloInt	Hello interval.
DR-Pri	Priority for DR election.
DR-Address	DR IP address. If a local address is used, local is displayed in brackets ( ) after the IP address.

# Display detailed PIM information on VLAN-interface 100 on the public network.

<Sysname> display pim interface Vlan-interface100 verbose

VPN-Instance: public net

Interface: Vlan-interface100, 10.1.1.1

PIM version: 2

PIM mode: Sparse

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 override interval (negotiated): 2500 ms

PIM override interval (configured): 2500 ms

PIM neighbor tracking (negotiated): disabled

PIM neighbor tracking (configured): disabled

PIM generation ID: 0xF5712241

PIM require generation ID: 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

Number of routers on network not using DR priority: 0

Number of routers on network not using LAN delay: 0

Number of routers on network not using neighbor tracking: 2

Table 7 Command output

Field	Description
VPN-Instance: public net	Public network.
Interface	Interface name and its IP address.
PIM version	Running PIM version.
PIM mode	PIM mode, dense or sparse.
PIM DR	DR IP address.
PIM DR Priority (configured)	Configured priority for DR election.
PIM neighbor count	Total number of PIM neighbors.
PIM hello interval	Hello interval.
PIM LAN delay (negotiated)	Negotiated prune message delay.
PIM LAN delay (configured)	Configured prune message delay.
PIM override interval (negotiated)	Negotiated prune override interval.
PIM override interval (configured)	Configured prune override interval.
PIM neighbor tracking (negotiated)	Negotiated neighbor tracking status: enabled/disabled.
PIM neighbor tracking (configured)	Configured neighbor tracking status: enabled/disabled.
PIM generation ID	Generation_ID value.
PIM require generation ID	Whether the function of dropping Hello messages without Generation_ID is enabled.
PIM hello hold interval	PIM neighbor timeout time.
PIM assert hold interval	Assert timeout time.
PIM triggered hello delay	Maximum delay of sending hello messages.
PIM J/P interval	Join/prune interval.
PIM J/P hold interval	Join/prune timeout time.
PIM BSR domain border	Status of PIM domain border configuration (enabled/disabled).
Number of routers on network not using DR priority	Number of routers not using the DR priority field on the subnet where the interface resides.
Number of routers on network not using LAN delay	Number of routers not using the LAN delay field on the subnet where the interface resides.
Number of routers on network not using neighbor tracking	Number of routers not using neighbor tracking on the subnet where the interface resides.

display pim join-prune

Syntax

display pim [ all-instance | vpn-instance vpn-instance-name ] join-prune mode { sm [ flags flag-value ] | ssm } [ interface interface-type interface-number | neighbor neighbor-address ] * [ verbose ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all-instance: Specifies all VPN instances.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.

mode: Displays the information of join/prune messages to send in the specified PIM mode.

· sm: Specifies PIM-SM.

· ssm: Specifies PIM-SSM.

flags flag-value: Displays routing entries containing the specified flag.

· rpt: Specifies routing entries on the RPT.

· spt: Specifies routing entries on the SPT.

· wc: Specifies wildcard routing entries.

interface-type interface-number: Displays the information of join/prune messages to send on the specified interface.

neighbor-address: Displays the information of join/prune messages to send to the specified PIM neighbor.

verbose: Displays detailed information about join/prune messages to send.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display pim join-prune to display information about the join/prune messages to send.

If neither all-instance nor vpn-instance is specified, this command displays the information on the public network.

Examples

# In the public network view information about join/prune messages to send in the PIM-SM mode.

<Sysname> display pim join-prune mode sm

VPN-Instance: public net

Expiry Time: 50 sec

Upstream nbr: 10.1.1.1 (Vlan-interface100)

1 (*, G) join(s), 0 (S, G) join(s), 1 (S, G, rpt) prune(s)

-------------------------------------------------------------------------

Total (*, G) join(s): 1, (S, G) join(s): 0, (S, G, rpt) prune(s): 1

Table 8 Command output

Field	Description
VPN-Instance: public net	Public network.
Expiry Time:	Expiration time of sending join/prune messages.
Upstream nbr:	IP address of the upstream PIM neighbor and the interface connecting to it.
(*, G) join(s)	Number of (*, G) joins to send.
(S, G) join(s)	Number of (S, G) joins to send.
(S, G, rpt) prune(s)	Number of (S, G, rpt) prunes.

display pim neighbor

Syntax

display pim [ all-instance | vpn-instance vpn-instance-name ] neighbor [ interface interface-type interface-number | neighbor-address | verbose ] * [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all-instance: Specifies all VPN instances.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.

interface-type interface-number: Displays PIM neighbor information on a particular interface.

neighbor-address: Displays the information of a particular PIM neighbor.

verbose: Displays detailed PIM neighbor information.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display pim neighbor to display the PIM neighbor information.

If neither all-instance nor vpn-instance is specified, this command displays the information on the public network.

Examples

# Display the information of all PIM neighbors on the public network.

<Sysname> display pim neighbor

VPN-Instance: public net

Total Number of Neighbors = 2

Neighbor Interface Uptime Expires Dr-Priority Mode

10.1.1.2 Vlan100 02:50:49 00:01:31 1 B

20.1.1.2 Vlan101 02:49:39 00:01:42 1 B

# In the public network, view detailed information about the PIM neighbor whose IP address is 11.110.0.20.

<Sysname> display pim neighbor 11.110.0.20 verbose

VPN-Instance: public net

Neighbor: 11.110.0.20

Interface: Vlan-interface100

Uptime: 00:00:10

Expiry time: 00:00:30

DR Priority: 1

Generation ID: 0x2ACEFE15

Holdtime: 105 s

LAN delay: 500 ms

Override interval: 2500 ms

State refresh interval: 60 s

Neighbor tracking: Disabled

Bidirectional PIM: Enabled

Neighbor Secondary Address(es):

167.100.1.2

167.100.2.2

167.100.3.2

167.100.4.2

167.100.5.2

Table 9 Command output

Field	Description
VPN-Instance: public net	Public network.
Total Number of Neighbors	Total number of PIM neighbors.
Neighbor	IP address of the PIM neighbor.
Interface	Interface connecting the PIM neighbor.
Uptime	Length of time for which the PIM neighbor has been up, in hh:mm:ss.
Expires/Expiry time	Remaining time of the PIM neighbor, in hh:mm:ss. If the PIM neighbor is always up and reachable, this field displays never.
Dr-Priority/DR Priority	Priority of the PIM neighbor.
Mode	Mode of the PIM neighbor. If the PIM mode is BIDIR-PIM, this field displays B. If a PIM mode other than BIDIR-PIM is used, this field is blank.
Generation ID	Generation ID of the PIM neighbor. A random value indicating a status change of the PIM neighbor.
Holdtime	Holdtime of the PIM neighbor. If the PIM neighbor is always up and reachable, this field displays forever.
LAN delay	Prune message delay.
Override interval	Prune override interval.
State refresh interval	Interval for sending state refresh messages. Displayed only when the PIM neighbor operates in PIM-DM mode and the state refresh capability is enabled.
Neighbor tracking	Neighbor tracking status: enabled/disabled.
Bidirectional PIM	BIDIR-PIM status: enabled/disabled.
Neighbor Secondary Address(es)	Secondary address of the PIM neighbor

display pim routing-table

Syntax

display pim [ all-instance | vpn-instance vpn-instance-name ] routing-table [ group-address [ mask { mask-length | mask } ] | source-address [ mask { mask-length | mask } ] | incoming-interface [ interface-type interface-number | register ] | outgoing-interface { include | exclude | match } { interface-type interface-number | register } | mode mode-type | flags flag-value | fsm ] * [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all-instance: Specifies all VPN instances.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.

group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.

source-address: Specifies a multicast source address.

mask: Specifies the address mask, 255.255.255.255 by default.

mask-length: Specifies the address mask length in the range of 0 to 32. The default is 32.

incoming-interface: Displays PIM routing entries that contain the specified interface as the incoming interface.

interface-type interface-number: Specifies an interface by its type and number.

outgoing-interface: Displays PIM routing entries of which the outgoing interface is the specified interface.

include: Displays PIM routing entries of which the outgoing interface list includes the specified interface.

exclude: Displays PIM routing entries of which the outgoing interface list excludes the specified interface.

match: Displays PIM routing entries of which the outgoing interface list includes only the specified interface.

mode mode-type: Specifies a PIM mode:

· dm: Specifies PIM-DM.

· sm: Specifies PIM-SM.

· ssm: Specifies PIM-SSM.

flags flag-value: Displays PIM routing entries containing the specified flag or flags:

· 2msdp: Specifies PIM routing entries to be contained in the next SA message to notify an MSDP peer.

· act: Specifies PIM routing entries that have been used for routing data.

· bidir: Specifies PIM routing entries created by BIDIR-PIM.

· del: Specifies PIM routing entries scheduled to be deleted.

· exprune: Specifies PIM routing entries containing outgoing interfaces pruned by other multicast routing protocols.

· ext: Specifies PIM routing entries containing outgoing interfaces provided by other multicast routing protocols.

· loc: Specifies PIM routing entries on the devices that directly connect to the same subnet as the multicast source.

· msdp: Specifies PIM routing entries learned from MSDP SA messages.

· niif: Specifies PIM routing entries containing unknown incoming interfaces.

· nonbr: Specifies PIM routing entries with PIM neighbor searching failure.

· rpt: Specifies PIM routing entries on RPT branches where (S, G) prunes have been sent to the RP.

· rq: Specifies PIM routing entries of the receiving side of the switch-MDT switchover.

· spt: Specifies PIM routing entries on the SPT.

· sq: Specifies PIM routing entries of the originator side of switch-MDT switchover.

· swt: Specifies PIM routing entries in the process of RPT-to-SPT switchover.

· wc: Specifies wildcard routing entries.

fsm: Displays the information of the state machine.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display pim routing-table to display PIM routing table information.

If neither all-instance nor vpn-instance is specified, this command displays the information on the public network.

Related commands: display multicast routing-table.

Examples

# Display the content of the PIM routing table on the public network.

<Sysname> display pim routing-table

VPN-Instance: public net

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

(172.168.0.12, 227.0.0.1)

RP: 2.2.2.2

Protocol: pim-sm, Flag: SPT LOC ACT

UpTime: 02:54:43

Upstream interface: Vlan-interface100

Upstream neighbor: NULL

RPF prime neighbor: NULL

Downstream interface(s) information:

Total number of downstreams: 1

1: Vlan-interface101

Protocol: pim-sm, UpTime: 02:54:43, Expires: 00:02:47

# Display the state machine information in the PIM routing table on the public network.

<Sysname> display pim routing-table fsm

VPN-Instance: public net

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

Abbreviations for FSM states:

NI - no info, J - joined, NJ - not joined, P - pruned,

NP - not pruned, PP - prune pending, W - winner, L - loser,

F - forwarding, AP - ack pending, DR - designated router,

NDR - non-designated router, RCV - downstream receivers

(172.168.0.12, 227.0.0.1)

RP: 2.2.2.2

Protocol: pim-sm, Flag: SPT LOC ACT

UpTime: 02:54:43

Upstream interface: GigabitEthernet3/0/1

Upstream neighbor: NULL

RPF prime neighbor: NULL

Join/Prune FSM: [SPT: J] [RPT: NP]

Downstream interface(s) information:

Total number of downstreams: 1

1: GigabitEthernet3/0/2

Protocol: pim-sm, UpTime: 02:54:43, Expires: 00:02:47

DR state: [DR]

Join/Prune FSM: [NI]

Assert FSM: [NI]

FSM information for non-downstream interfaces: None

Table 10 Command output

Field	Description
VPN-Instance: public net	Public network.
Total 0 (*, G) entry; 1 (S, G) entry	Number of (S,G) and (*, G) entries in the PIM routing table.
(172.168.0.2, 227.0.0.1)	(S, G) entry in the PIM routing table.
RP	IP address of the RP.
Protocol	PIM mode.
Flag	Flag of the (S, G) or (*, G) entry in the PIM routing table: · 2MSDP—The entry is contained in the next SA message to notify an MSDP peer. · ACT—The entry has been used for routing data. · BIDIR—The entry was created by BIDIR-PIM. · DEL—The entry will be removed. · EXPRUNE—Some outgoing interfaces are pruned by other multicast routing protocols. · EXT—The entry contains outgoing interfaces provided by other multicast routing protocols. · LOC—The entry is on a router directly connected to the same subnet with the multicast source. · MSDP—The entry is learnt from MSDP SA messages. · NIIF—The entry contains unknown incoming interfaces. · NONBR—The entry has a PIM neighbor searching failure. · RPT—The entry is on a RPT branch where (S, G) prunes have been sent to the RP. · RQ—The entry is on the receiving side of the switch-MDT switchover. · SPT—The entry is on the SPT. · SQ—The entry is on the originator side of switch-MDT switchover. · SWT—The entry is in the process of RPT-to-SPT switchover. · WC—Wildcard routing entry.
Uptime	Length of time for which the (S, G) or (*, G) entry has been existing.
Upstream interface	Upstream (incoming) interface of the (S, G) or (*, G) entry.
Upstream neighbor	Upstream neighbor of the (S, G) or (*, G) entry.
RPF prime neighbor	RPF neighbor of the (S, G) or (, G) entry: · For a (, G) entry, if this router is the RP, the RPF neighbor of this (*, G) entry is NULL. · For a (S, G) entry, if this router directly connects to the multicast source, the RPF neighbor of this (S, G) entry is NULL.
Downstream interface(s) information	Information about the downstream interfaces: · Number of downstream interfaces. · Downstream interface name. · Protocol type on the downstream interfaces. · Uptime of the downstream interfaces. · Expiration time of the downstream interfaces.

display pim rp-info

Syntax

display pim [ all-instance | vpn-instance vpn-instance-name ] rp-info [ group-address ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all-instance: Specifies all VPN instances.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.

group-address: Specifies a multicast group address in the range of 224.0.1.0 to 239.255.255.255. If no group address is specified, this command displays the RP information corresponding to all multicast groups.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display pim rp-info to display the RP information.

If neither all-instance nor vpn-instance is specified, this command displays the information on the public network.

The RP information includes the information of RPs dynamically found by the BSR mechanism and static RPs.

Examples

# Display RP information corresponding to the multicast group 224.0.1.1 on the public network.

<Sysname> display pim rp-info 224.0.1.1

VPN-Instance: public net

BSR RP Address is: 2.2.2.2

Priority: 192

HoldTime: 150

Uptime: 03:01:10

Expires: 00:02:30

RP mapping for this group is: 2.2.2.2

# Display RP information corresponding to all multicast groups on the public network.

<Sysname> display pim rp-info

VPN-Instance: public net

PIM-SM BSR RP information:

Group/MaskLen: 224.0.0.0/4 [B]

RP: 2.2.2.2

Priority: 192

HoldTime: 150

Uptime: 03:01:36

Expires: 00:02:29

Table 11 Command output

Field	Description
VPN-Instance: public net	Public network.
BSR RP Address is	IP address of the RP.
Group/MaskLen	Multicast group to which the RP is designated.
[B]	The RP provides services for multicast groups in BIDIR-PIM. If this field is not displayed, the RP provides services for multicast groups in PIM-SM.
RP	IP address of the RP.
Priority	RP priority.
HoldTime	RP timeout time.
Uptime	Length of time for which the RP has been up, in hh:mm:ss.
Expires	Length of time in which the RP will expire, in hh:mm:ss.
RP mapping for this group	IP address of the RP that provides services for the current multicast group.

hello-option dr-priority (PIM view)

Syntax

hello-option dr-priority priority

undo hello-option dr-priority

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

priority: Specifies the router priority for DR election, in the range of 0 to 4294967295. A larger value represents a higher priority.

Description

Use hello-option dr-priority to configure the global value of the router priority for DR election.

Use undo hello-option dr-priority to restore the default.

By default, the router priority for DR election is 1.

Related commands: pim hello-option dr-priority.

Examples

# Set the router priority for DR election to 3 on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] hello-option dr-priority 3

# Set the router priority for DR election to 3 in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] hello-option dr-priority 3

hello-option holdtime (PIM view)

Syntax

hello-option holdtime interval

undo hello-option holdtime

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

interval: Specifies a PIM neighbor timeout time in seconds, in the range of 1 to 65535. If the value for this argument is 65535, the PIM neighbor is always reachable.

Description

Use hello-option holdtime to configure the PIM neighbor timeout time.

Use undo hello-option holdtime to restore the default.

By default, the PIM neighbor timeout time is 105 seconds.

Related commands: pim hello-option holdtime.

Examples

# Set the global value of the PIM neighbor timeout time to 120 seconds on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] hello-option holdtime 120

# Set the global value of the PIM neighbor timeout time to 120 seconds in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] hello-option holdtime 120

hello-option lan-delay (PIM view)

Syntax

hello-option lan-delay interval

undo hello-option lan-delay

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

interval: Specifies a LAN-delay time in milliseconds, in the range of 1 to 32767.

Description

Use hello-option lan-delay to configure the global value of the LAN-delay time (the period of time that the device waits before forwarding a received prune message).

Use undo hello-option lan-delay to restore the default.

By default, the LAN-delay time is 500 milliseconds.

This command takes effect on both PIM-DM and PIM-SM.

Related commands: hello-option override-interval, pim hello-option lan-delay, and pim hello-option override-interval.

Examples

# Set the LAN-delay time to 200 milliseconds globally on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] hello-option lan-delay 200

# Set the LAN-delay time to 200 milliseconds globally in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] hello-option lan-delay 200

hello-option neighbor-tracking (PIM view)

Syntax

hello-option neighbor-tracking

undo hello-option neighbor-tracking

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

None

Description

Use hello-option neighbor-tracking to disable join suppression globally and enable neighbor tracking.

Use undo hello-option neighbor-tracking to enable join suppression.

By default, join suppression is enabled and neighbor tracking is disabled.

This command takes effect on both PIM-DM and PIM-SM.

Related commands: pim hello-option neighbor-tracking.

Examples

# Disable join suppression globally on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] hello-option neighbor-tracking

# Disable join suppression globally in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] hello-option neighbor-tracking

hello-option override-interval (PIM view)

Syntax

hello-option override-interval interval

undo hello-option override-interval

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

interval: Specifies a prune override interval in milliseconds, in the range of 1 to 65535.

Description

Use hello-option override-interval to configure the global value of the prune override interval.

Use undo hello-option override-interval to restore the default.

By default, the prune override interval is 2500 milliseconds.

This command takes effect on both PIM-DM and PIM-SM.

Related commands: hello-option lan-delay, pim hello-option lan-delay, and pim hello-option override-interval.

Examples

# Set the prune override interval to 2000 milliseconds globally on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] hello-option override-interval 2000

# Set the prune override interval to 2000 milliseconds globally in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] hello-option override-interval 2000

holdtime assert (PIM view)

Syntax

holdtime assert interval

undo holdtime assert

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

interval: Specifies an assert timeout time in seconds, in the range of 7 to 2147483647.

Description

Use holdtime assert to configure the global value of the assert timeout time.

Use undo holdtime assert to restore the default.

By default, the assert timeout time is 180 seconds.

This command takes effect on both PIM-DM and PIM-SM.

Related commands: holdtime join-prune, pim holdtime assert, and pim holdtime join-prune.

Examples

# Set the global value of the assert timeout time to 100 seconds on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] holdtime assert 100

# Set the global value of the assert timeout time to 100 seconds in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] holdtime assert 100

holdtime join-prune (PIM view)

Syntax

holdtime join-prune interval

undo holdtime join-prune

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

interval: Specifies a join/prune timeout time in seconds, in the range of 1 to 65535.

Description

Use holdtime join-prune to configure the global value of the join/prune timeout time.

Use undo holdtime join-prune to restore the default.

By default, the join/prune timeout time is 210 seconds.

Related commands: holdtime assert, pim holdtime assert, and pim holdtime join-prune.

Examples

# Set the global value of the join/prune timeout time to 280 seconds on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] holdtime join-prune 280

# Set the global value of the join/prune timeout time to 280 seconds in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] holdtime join-prune 280

jp-pkt-size (PIM view)

Syntax

jp-pkt-size packet-size

undo jp-pkt-size

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

packet-size: Specifies the maximum size of join/prune messages in bytes, in the range of 100 to 8100.

Description

Use jp-pkt-size to configure the maximum size of join/prune messages.

Use undo jp-pkt-size to restore the default.

By default, the maximum size of join/prune messages is 8100 bytes.

Related commands: jp-queue-size.

Examples

# Set the maximum size of join/prune messages to 1500 bytes on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] jp-pkt-size 1500

# Set the maximum size of join/prune messages to 1500 bytes in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] jp-pkt-size 1500

jp-queue-size (PIM view)

Syntax

jp-queue-size queue-size

undo jp-queue-size

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

queue-size: Specifies the maximum number of (S, G) entries in a join/prune message, in the range of 1 to 4096.

Description

Use jp-queue-size to configure the maximum number of (S, G) entries in a join/prune message.

Use undo jp-queue-size to restore the default.

By default, a join/prune messages contains a maximum of 1020 (S, G) entries.

When you use this command, take the following into account:

· The size of the forwarding table. In a network that does not support packet fragmentation, if you configure a large queue-size, a join/prune message might contain a large number of groups, causing the message length to exceed the MTU of the network. As a result, the products that do not support fragmentation will drop the join/prune message.

· The (S, G) join/prune timeout time on the upstream device. If you configure a small queue size, the outgoing interface of the corresponding entry might have been pruned due to timeout before the last join/prune message in a queue reaches the upstream device.

Related commands: holdtime join-prune, jp-pkt-size, and pim holdtime join-prune.

Examples

# Configure a join/prune messages to contain a maximum of 2000 (S, G) entries on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] jp-queue-size 2000

# Configure a join/prune messages to contain a maximum of 2000 (S, G) entries in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] jp-queue-size 2000

pim

Syntax

pim [ vpn-instance vpn-instance-name ]

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

View

System view

Default level

2: System level

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If this option is not specified, the command applies to the public network.

Description

Use pim to enter public network PIM view or VPN instance PIM view.

Use undo pim to remove all configurations in public network PIM view or VPN instance PIM view.

IP multicast routing must be enabled in the corresponding instance before this command takes effect.

Related commands: multicast routing-enable.

Examples

# Enable IP multicast routing on the public network and enter public network PIM view.

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] pim

[Sysname-pim]

# Enable IP multicast routing in VPN instance mvpn and enter PIM view of VPN instance mvpn.

<Sysname> system-view

[Sysname] ip vpn-instance mvpn

[Sysname-vpn-instance-mvpn] route-distinguisher 100:1

[Sysname-vpn-instance-mvpn] multicast routing-enable

[Sysname-vpn-instance-mvpn] quit

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn]

pim bfd enable

Syntax

pim bfd enable

undo pim bfd enable

View

Interface view

Default level

2: System level

Parameters

None

Description

Use pim bfd enable to enable BFD for PIM.

Use undo pim bfd enable to disable this feature.

By default, this feature is disabled.

You must enable PIM-DM or PIM-SM on an interface before you configure this feature on the interface. Otherwise, this feature does not take effect.

Related commands: pim dm and pim sm.

Examples

# Enable IP multicast routing on the public network, enable PIM-SM on interface VLAN-interface 100, and enable BFD for PIM on the interface.

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim sm

[Sysname-Vlan-interface100] pim bfd enable

pim bsr-boundary

Syntax

pim bsr-boundary

undo pim bsr-boundary

View

Interface view

Default level

2: System level

Parameters

None

Description

Use pim bsr-boundary to configure a PIM domain border (a bootstrap message boundary).

Use undo pim bsr-boundary to remove the configured PIM domain border.

By default, no PIM domain border is configured.

Related commands: c-bsr and multicast boundary.

Examples

# Configure VLAN-interface 100 as a PIM domain border.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim bsr-boundary

pim dm

Syntax

pim dm

undo pim dm

View

Interface view

Default level

2: System level

Parameters

None

Description

Use pim dm to enable PIM-DM.

Use undo pim dm to disable PIM-DM.

By default, PIM-DM is disabled.

This command takes effect only after IP multicast routing is enabled in the corresponding instance.

PIM-DM cannot be used for multicast groups in the SSM group range.

When the system is operating in standard mode, you must configure a reserved VLAN before you configure PIM-DM for a VPN instance. For more information about the system operating mode, see Fundamentals Configuration Guide. For more information about the configuration and commands about a reserved VLAN, see MPLS Configuration Guide and MPLS Command Reference.

Related commands: multicast routing-enable, pim sm, and ssm-policy.

Examples

# Enable IP multicast routing on the public network, and enable PIM-DM on VLAN-interface 100.

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim dm

pim hello-option dr-priority

Syntax

pim hello-option dr-priority priority

undo pim hello-option dr-priority

View

Interface view

Default level

2: System level

Parameters

priority: Specifies the router priority for DR election, in the range of 0 to 4294967295. A larger value represents a higher priority.

Description

Use pim hello-option dr-priority to configure the router priority for DR election on the current interface.

Use undo pim hello-option dr-priority to restore the default.

By default, the router priority for DR election is 1.

Related commands: hello-option dr-priority.

Examples

# Set the router priority for DR election to 3 on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim hello-option dr-priority 3

pim hello-option holdtime

Syntax

pim hello-option holdtime interval

undo pim hello-option holdtime

View

Interface view

Default level

2: System level

Parameters

interval: Specifies a PIM neighbor timeout time in seconds, in the range of 1 to 65535. If the value for this argument is 65535, the PIM neighbor is always reachable.

Description

Use pim hello-option holdtime to configure the PIM neighbor timeout time on the current interface.

Use undo pim hello-option holdtime to restore the default.

By default, the PIM neighbor timeout time is 105 seconds.

Related commands: hello-option holdtime.

Examples

# Set the PIM neighbor timeout time to 120 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim hello-option holdtime 120

pim hello-option lan-delay

Syntax

pim hello-option lan-delay interval

undo pim hello-option lan-delay

View

Interface view

Default level

2: System level

Parameters

interval: Specifies a LAN-delay time in milliseconds, in the range of 1 to 32767.

Description

Use pim hello-option lan-delay to configure the LAN-delay time (the length of time that the device waits before forwarding a received prune message) on the current interface.

Use undo pim hello-option lan-delay to restore the default.

By default, the LAN-delay time to 500 milliseconds.

Related commands: hello-option lan-delay, hello-option override-interval, and pim hello-option override-interval.

Examples

# Set the LAN-delay time to 200 milliseconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim hello-option lan-delay 200

pim hello-option neighbor-tracking

Syntax

pim hello-option neighbor-tracking

undo pim hello-option neighbor-tracking

View

Interface view

Default level

2: System level

Parameters

None

Description

Use pim hello-option neighbor-tracking to disable join suppression and enable neighbor tracking on the current interface.

Use undo pim hello-option neighbor-tracking to enable join suppression.

By default, join suppression is enabled and neighbor tracking is disabled.

Related commands: hello-option neighbor-tracking.

Examples

# Disable join suppression on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim hello-option neighbor-tracking

pim hello-option override-interval

Syntax

pim hello-option override-interval interval

undo pim hello-option override-interval

View

Interface view

Default level

2: System level

Parameters

interval: Specifies a prune override interval in milliseconds, in the range of 1 to 65535.

Description

Use pim hello-option override-interval to configure the prune override interval on the current interface.

Use undo pim hello-option override-interval to restore the default.

By default, the prune override interval is 2500 milliseconds.

Related commands: hello-option lan-delay, hello-option override-interval, and pim hello-option lan-delay.

Examples

# Set the prune override interval to 2000 milliseconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim hello-option override-interval 2000

pim holdtime assert

Syntax

pim holdtime assert interval

undo pim holdtime assert

View

Interface view

Default level

2: System level

Parameters

interval: Specifies an assert timeout time in seconds, in the range of 7 to 2147483647.

Description

Use pim holdtime assert to configure the assert timeout time on the current interface.

Use undo pim holdtime assert to restore the default.

By default, the assert timeout time is 180 seconds.

Related commands: holdtime assert, holdtime join-prune, and pim holdtime join-prune.

Examples

# Set the assert timeout time to 100 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim holdtime assert 100

pim holdtime join-prune

Syntax

pim holdtime join-prune interval

undo pim holdtime join-prune

View

Interface view

Default level

2: System level

Parameters

interval: Specifies a join/prune timeout time in seconds, in the range of 1 to 65535.

Description

Use pim holdtime join-prune to configure the join/prune timeout time on the interface.

Use undo pim holdtime join-prune to restore the default.

By default, the join/prune timeout time is 210 seconds.

Related commands: holdtime assert, holdtime join-prune, and pim holdtime assert.

Examples

# Set the join/prune timeout time to 280 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim holdtime join-prune 280

pim neighbor-policy

Syntax

pim neighbor-policy acl-number

undo pim neighbor-policy

View

Interface view

Default level

2: System level

Parameters

acl-number: Specifies a basic ACL number in the range of 2000 to 2999. When the ACL is defined, the source keyword in the rule command specifies a legal source address range for hello messages.

Description

Use pim neighbor-policy to configure a legal source address range for hello messages to guard against hello message spoofing.

Use undo pim neighbor-policy to restore the default.

By default, no source address range for hello messages is configured. All the received hello messages are considered legal.

Examples

# Configure a legal source address range for hello messages on VLAN-interface 100 so that only the devices on the 10.1.1.0/24 subnet can become PIM neighbors of this switch.

<Sysname> system-view

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 10.1.1.0 0.0.0.255

[Sysname-acl-basic-2000] quit

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim neighbor-policy 2000

pim require-genid

Syntax

pim require-genid

undo pim require-genid

View

Interface view

Default level

2: System level

Parameters

None

Description

Use pim require-genid to enable rejection of hello messages without Generation_ID.

Use undo pim require-genid to restore the default.

By default, hello messages without Generation_ID are accepted.

Examples

# Enable VLAN-interface 100 to reject hello messages without Generation_ID.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim require-genid

pim sm

Syntax

pim sm

undo pim sm

View

Interface view

Default level

2: System level

Parameters

None

Description

Use pim sm to enable PIM-SM.

Use undo pim sm to disable PIM-SM.

By default, PIM-SM is disabled.

This command takes effect only after IP multicast routing is enabled in the corresponding instance.

When the system is operating in standard mode, you must configure a reserved VLAN before you configure PIM-SM for a VPN instance. For more information about the system operating mode, see Fundamentals Configuration Guide. For more information about the configuration and commands about a reserved VLAN, see MPLS Configuration Guide and MPLS Command Reference.

Related commands: multicast routing-enable and pim dm.

Examples

# Enable IP multicast routing on the public network, and enable PIM-SM on VLAN-interface 100.

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim sm

pim state-refresh-capable

Syntax

pim state-refresh-capable

undo pim state-refresh-capable

View

Interface view

Default level

2: System level

Parameters

None

Description

Use pim state-refresh-capable to enable the state fresh feature on the interface.

Use undo pim state-refresh-capable to disable the state fresh feature.

By default, the state refresh feature is enabled.

Related commands: state-refresh-interval, state-refresh-rate-limit, and state-refresh-ttl.

Examples

# Disable state refresh on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] undo pim state-refresh-capable

pim timer graft-retry

Syntax

pim timer graft-retry interval

undo pim timer graft-retry

View

Interface view

Default level

2: System level

Parameters

interval: Specifies a graft retry period in seconds, in the range of 1 to 65535.

Description

Use pim timer graft-retry to configure the graft retry period.

Use undo pim timer graft-retry to restore the default.

By default, the graft retry period is 3 seconds.

Examples

# Set the graft retry period to 80 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim timer graft-retry 80

pim timer hello

Syntax

pim timer hello interval

undo pim timer hello

View

Interface view

Default level

2: System level

Parameters

interval: Specifies a hello interval in seconds, in the range of 1 to 2147483647.

Description

Use pim timer hello to configure on the current interface the interval at which hello messages are sent.

Use undo pim timer hello to restore the default.

By default, hello messages are sent at the interval of 30 seconds.

Related commands: timer hello.

Examples

# Set the hello interval to 40 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim timer hello 40

pim timer join-prune

Syntax

pim timer join-prune interval

undo pim timer join-prune

View

Interface view

Default level

2: System level

Parameters

interval: Specifies a join/prune interval in seconds, in the range of 1 to 2147483647.

Description

Use pim timer join-prune to configure on the current interface the interval at which join/prune messages are sent.

Use undo pim timer join-prune to restore the default.

By default, the join/prune interval is 60 seconds.

Related commands: timer join-prune.

Examples

# Set the join/prune interval to 80 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim timer join-prune 80

pim triggered-hello-delay

Syntax

pim triggered-hello-delay interval

undo pim triggered-hello-delay

View

Interface view

Default level

2: System level

Parameters

interval: Specifies the maximum delay in seconds between hello messages, in the range of 1 to 60.

Description

Use pim triggered-hello-delay to configure the maximum delay between hello messages.

Use undo pim triggered-hello-delay to restore the default.

By default, the maximum delay between hello messages is 5 seconds.

Examples

# Set the maximum delay between hello messages to 3 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim triggered-hello-delay 3

probe-interval (PIM view)

Syntax

probe-interval interval

undo probe-interval

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

interval: Specifies the register probe time in seconds, in the range of 1 to 1799.

Description

Use probe-interval to configure the register probe time.

Use undo probe-interval to restore the default.

By default, the register probe time is 5 seconds.

Related commands: register-suppression-timeout.

Examples

# Set the register probe time to 6 seconds on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] probe-interval 6

# Set the register probe time to 6 seconds in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] probe-interval 6

prune delay (PIM view)

Syntax

prune delay interval

undo prune delay

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

interval: Specifies a prune delay time in the range 1 to 128 seconds.

Description

Use prune delay to configure the prune delay (the length of time that the device waits between receiving a prune message and taking a prune action).

Use undo prune delay to restore the default.

By default, the prune delay is 3 seconds, which equals the prune pending time.

Examples

# Set the prune delay to 75 seconds on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] prune delay 75

# Set the prune delay time to 75 seconds in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] prune delay 75

register-policy (PIM view)

Syntax

undo register-policy

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

acl-number: Specifies an advanced ACL number in the range of 3000 to 3999. Only register messages that match the permit statement of the ACL can be accepted by the RP.

Description

Use register-policy to configure an ACL rule to filter register messages.

Use undo register-policy to remove the configured register filtering rule.

By default, no register filtering rule is configured.

Related commands: register-suppression-timeout.

Examples

# In the public network, configure the RP to accept only those register messages from multicast sources on the subnet of 10.10.0.0/16 for multicast groups on the subnet of 225.1.0.0/16.

<Sysname> system-view

[Sysname] acl number 3000

[Sysname-acl-adv-3000] rule permit ip source 10.10.0.0 0.0.255.255 destination 225.1.0.0 0.0.255.255

[Sysname-acl-adv-3000] quit

[Sysname] pim

[Sysname-pim] register-policy 3000

# In VPN instance mvpn, configure the RP to accept only those register messages from multicast sources on the subnet of 10.10.0.0/16 for multicast groups on the subnet of 225.1.0.0/16.

<Sysname> system-view

[Sysname] acl number 3000

[Sysname-acl-adv-3000] rule permit ip source 10.10.0.0 0.0.255.255 destination 225.1.0.0 0.0.255.255

[Sysname-acl-adv-3000] quit

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] register-policy 3000

register-suppression-timeout (PIM view)

Syntax

undo register-suppression-timeout

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

interval: Specifies a register suppression time in seconds, in the range of 1 to 65535.

Description

Use register-suppression-timeout to configure the register suppression time.

Use undo register-suppression-timeout to restore the default.

By default, the register suppression time is 60 seconds.

Related commands: probe-interval and register-policy.

Examples

# Set the register suppression time to 70 seconds on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] register-suppression-timeout 70

# Set the register suppression time to 70 seconds in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] register-suppression-timeout 70

register-whole-checksum (PIM view)

Syntax

undo register-whole-checksum

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

None

Description

Use register-whole-checksum to configure the router to calculate the checksum based on the entire register message.

Use undo register-whole-checksum to restore the default.

By default, the checksum is calculated based on the header in the register message.

Related commands: register-policy and register-suppression-timeout.

Examples

# Configure the router to calculate the checksum based on the entire register message on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] register-whole-checksum

# Configure the router to calculate the checksum based on the entire register message in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] register-whole-checksum

reset pim control-message counters

Syntax

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

View

User view

Default level

1: Monitor level

Parameters

all-instance: Specifies all VPN instances.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters.

interface interface-type interface-number: Specifies to reset the PIM control message counter on a particular interface. If no interface is specified, this command reset PIM control message counters on all interfaces.

Description

Use reset pim control-message counters to reset PIM control message counters.

If neither all-instance nor vpn-instance is specified, this command resets PIM control message counters on the public network.

Examples

# Reset PIM control message counters on all interfaces on the public network.

<Sysname> reset pim control-message counters

source-lifetime (PIM view)

Syntax

source-lifetime interval

undo source-lifetime

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

interval: Specifies a multicast source lifetime in seconds, in the range of 1 to 31536000.

Description

Use source-lifetime to configure the multicast source lifetime.

Use undo source-lifetime to restore the default.

By default, the lifetime of a multicast source is 210 seconds.

Examples

# Set the multicast source lifetime to 200 seconds on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] source-lifetime 200

# Set the multicast source lifetime to 200 seconds in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] source-lifetime 200

source-policy (PIM view)

Syntax

source-policy acl-number

undo source-policy

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

acl-number: Specifies a basic or advanced ACL number in the range of 2000 to 3999.

Description

Use source-policy to configure a multicast data filter.

Use undo source-policy to remove the configured multicast data filter.

By default, no multicast data filter is configured.

If you specify a basic ACL, the device filters all the received multicast packets based on the source address, and discards packets that fail the source address match. If you specify an advanced ACL, the device filters all the received multicast packets based on the source and group addresses, and discards packets that fail the match.

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# In the public network, configure the router to accept multicast packets originated from 10.10.1.2 and discard multicast packets originated from 10.10.1.1.

<Sysname> system-view

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 10.10.1.2 0

[Sysname-acl-basic-2000] rule deny source 10.10.1.1 0

[Sysname-acl-basic-2000] quit

[Sysname] pim

[Sysname-pim] source-policy 2000

# In VPN instance mvpn, configure the router to accept multicast packets originated from 10.10.1.2 and discard multicast packets originated from 10.10.1.1.

<Sysname> system-view

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 10.10.1.2 0

[Sysname-acl-basic-2000] rule deny source 10.10.1.1 0

[Sysname-acl-basic-2000] quit

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] source-policy 2000

spt-switch-threshold (PIM view)

Syntax

spt-switch-threshold infinity [ group-policy acl-number [ order order-value ] ]

undo spt-switch-threshold [ infinity ] [ group-policy acl-number ]

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

infinity: Disables SPT switchover.

group-policy acl-number: Specifies a basic ACL number in the range of 2000 to 2999. If this option is not specified, the configuration will apply on all multicast groups.

order order-value: Specifies the order of the ACL in the group-policy list. The value range for the order-value argument is 1 to the largest order value in the existing group-policy list plus 1, but it should not include the original order value of the ACL in the group-policy list. If you have assigned an order-value to a certain ACL, do not specify the same order-value for another ACL. Otherwise the system will give error information. If you do not specify the order-value argument, the order value of the ACL will remain the same in the group-policy list.

Description

Use spt-switch-threshold to configure the SPT switchover parameters.

Use undo spt-switch-threshold to restore the default.

By default, the device switches to the SPT immediately after it receives the first multicast packet.

CAUTION:

If the switch is an RP, disabling switchover to SPT might cause multicast traffic forwarding failures on the source-side DR. When disabling switchover to SPT, be sure you fully understand its impact on your network.

To adjust the order of an existing ACL in the group-policy list, you can use the acl-number argument to specify this ACL and set its order-value. This will insert the ACL to the position of order-value in the group-policy list. The order of the other existing ACLs in the group-policy list will remain unchanged.

To use an ACL that does not exist in the group-policy list, you can use the acl-number argument to specify an ACL and set its order-value. This will insert the ACL to the position of order-value in the group-policy list. If you do not include the order order-value option in your command, the ACL will be appended to the end of the group-policy list.

If you use this command multiple times on the same multicast group, the first traffic rate configuration matched in sequence will take effect.

Examples

# In the public network, disable the SPT switchover on a switch that will never become an RP.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] spt-switch-threshold infinity

# In VPN instance mvpn, disable the SPT switchover on a switch that will never become an RP.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] spt-switch-threshold infinity

ssm-policy (PIM view)

Syntax

ssm-policy acl-number

undo ssm-policy

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

acl-number: Specifies a basic ACL number in the range of 2000 to 2999.

Description

Use ssm-policy to configure the SSM multicast group range.

Use undo ssm-policy to restore the default.

By default, the SSM group range is 232.0.0.0/8.

This command allows you to define an address range of permitted or denied multicast groups. If the match succeeds, the multicast mode is PIM-SSM. Otherwise, the multicast mode is PIM-SM.

Examples

# Configure the SSM group range to be 232.1.0.0/16 on the public network.

<Sysname> system-view

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 232.1.0.0 0.0.255.255

[Sysname-acl-basic-2000] quit

[Sysname] pim

[Sysname-pim] ssm-policy 2000

# Configure the SSM group range to be 232.1.0.0/16 in VPN instance mvpn.

<Sysname> system-view

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 232.1.0.0 0.0.255.255

[Sysname-acl-basic-2000] quit

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] ssm-policy 2000

state-refresh-interval (PIM view)

Syntax

state-refresh-interval interval

undo state-refresh-interval

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

interval: Specifies a state refresh interval in seconds, in the range of 1 to 255.

Description

Use state-refresh-interval to configure the interval between state refresh messages.

Use undo state-refresh-interval to restore the default.

By default, the state refresh interval is 60 seconds.

Related commands: pim state-refresh-capable, state-refresh-rate-limit, and state-refresh-ttl.

Examples

# Set the state refresh interval to 70 seconds on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] state-refresh-interval 70

# Set the state refresh interval to 70 seconds in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] state-refresh-interval 70

state-refresh-rate-limit (PIM view)

Syntax

state-refresh-rate-limit interval

undo state-refresh-rate-limit

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

interval: Specifies a time to wait before receiving a new refresh message, in the range of 1 to 65535 seconds.

Description

Use state-refresh-rate-limit to configure the time the router must wait before receiving a new state refresh message.

Use undo state-refresh-rate-limit to restore the default.

By default, the device waits 30 seconds before receiving a new state refresh message.

Related commands: pim state-refresh-capable, state-refresh-interval, and state-refresh-ttl.

Examples

# In the public network, configure the device to wait 45 seconds before receiving a new state refresh message.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] state-refresh-rate-limit 45

# In VPN instance mvpn, configure the device to wait 45 seconds before receiving a new state refresh message.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] state-refresh-rate-limit 45

state-refresh-ttl

Syntax

state-refresh-ttl ttl-value

undo state-refresh-ttl

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

ttl-value: Specifies a TTL value of state refresh messages, in the range of 1 to 255.

Description

Use state-refresh-ttl to configure the TTL value of state refresh messages.

Use undo state-refresh-ttl to restore the default.

By default, the TTL value of state refresh messages is 255.

Related commands: pim state-refresh-capable, state-refresh-interval, and state-refresh-rate-limit.

Examples

# In the public network, configure the device to send PIM state refresh messages with a TTL of 45.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] state-refresh-ttl 45

# In VPN instance mvpn, configure the device to send PIM state refresh messages with a TTL of 45.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] state-refresh-ttl 45

static-rp (PIM view)

Syntax

static-rp rp-address [ acl-number ] [ preferred ] [ bidir ]

undo static-rp rp-address

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

rp-address: Specifies the IP address of the static RP to be configured. This address must be a real, valid unicast IP address, rather than an address on the 127.0.0.0/8 segment. For a static RP that provides services for BIDIR-PIM, you can specify a virtual IP address.

acl-number: Specifies a basic ACL number in the range of 2000 to 2999. If this argument is not specified, the configured static RP provides services for only those groups that pass the ACL filtering. Otherwise, the configured static RP provides services for the all-system group 224.0.0.0/4.

preferred: Specifies to give priority to the static RP if the static RP conflicts with the dynamic RP. If you do not include the preferred keyword in your command, the dynamic RP will be given priority, and the static RP takes effect only if no dynamic RP exists in the network or when the dynamic RP fails.

bidir: Specifies BIDIR-PIM. If this argument is not specified, the PIM mode is PIM-SM.

Description

Use static-rp to configure a static RP.

Use undo static-rp to configure a static RP.

By default, no static RP is configured.

PIM-SM or PIM-DM cannot be enabled on an interface that serves as a static RP.

When the ACL rule applied on a static RP changes, a new RP must be elected for all the multicast groups.

You can configure multiple static RPs by using this command multiple times. However, if you execute this command multiple times and specify the same static RP address or reference the same ACL rule, the most recent configuration takes effect. If multiple static RPs have been configured for the same multicast group, the one with the highest IP address will be chosen to provide services for the multicast group.

You can configure up to 50 static RPs on the same device.

Related commands: auto-rp enable and display pim rp-info.

Examples

# In the public network, configure the interface with the IP address 11.110.0.6 to be a static RP that provides services for the multicast groups in the address range of 225.1.1.0/24 defined in basic ACL 2001, and give priority to this static RP in the case of static/dynamic RP conflict.

<Sysname> system-view

[Sysname] acl number 2001

[Sysname-acl-basic-2001] rule permit source 225.1.1.0 0.0.0.255

[Sysname-acl-basic-2001] quit

[Sysname] pim

[Sysname-pim] static-rp 11.110.0.6 2001 preferred

# In VPN instance mvpn, configure the interface with the IP address 11.110.0.6 to be a static RP that provides services for the multicast groups in the address range of 225.1.1.0/24 defined in basic ACL 2001, and give priority to this static RP in the case of static/dynamic RP conflict.

<Sysname> system-view

[Sysname] acl number 2001

[Sysname-acl-basic-2001] rule permit source 225.1.1.0 0.0.0.255

[Sysname-acl-basic-2001] quit

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] static-rp 11.110.0.6 2001 preferred

timer hello (PIM view)

Syntax

timer hello interval

undo timer hello

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

interval: Specifies a hello interval in seconds, in the range of 1 to 2147483647.

Description

Use timer hello to configure the hello interval globally.

Use undo timer hello to restore the default.

By default, hello messages are sent at the interval of 30 seconds.

Related commands: pim timer hello.

Examples

# Set the global hello interval to 40 seconds on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] timer hello 40

# Set the global hello interval to 40 seconds in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] timer hello 40

timer join-prune (PIM view)

Syntax

timer join-prune interval

undo timer join-prune

View

Public network PIM view, VPN instance PIM view

Default level

2: System level

Parameters

interval: Specifies a join/prune interval in seconds, in the range of 1 to 2147483647.

Description

Use timer join-prune to configure the join/prune interval globally.

Use undo timer join-prune to restore the default.

By default, the join/prune interval is 60 seconds.

Related commands: pim timer join-prune.

Examples

# Set the global join/prune interval to 80 seconds on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] timer join-prune 80

# Set the global join/prune interval to 80 seconds in VPN instance mvpn.

<Sysname> system-view

[Sysname] pim vpn-instance mvpn

[Sysname-pim-mvpn] timer join-prune 80

08-IP Multicast Command Reference

auto-rp enable

c-bsr admin-scope (PIM view)

display pim routing-table

display pim rp-info

hello-option dr-priority (PIM view)

pim dm

pim hello-option dr-priority

pim hello-option holdtime

pim hello-option lan-delay

pim hello-option neighbor-tracking

pim hello-option override-interval

pim holdtime assert

pim holdtime join-prune

pim sm

pim state-refresh-capable

pim timer hello

pim timer join-prune

probe-interval (PIM view)

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us