display pim bsr-info

Function

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

Format

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

Parameters

Parameter	Description	Value
vpn-instance vpn-instance-name	Specifies a VPN instance. vpn-instance-name specifies the name of the VPN instance.	The name is a string of 1 to 31 case-sensitive characters.
all-instance	Indicates all the instances.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

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

If the current router is configured with the Candidate-BootStrap Router (C-BSR), the command output includes information about the elected BSR and locally configured C-BSR.
If the current router is not configured with the C-BSR, the command output includes information about the elected BSR only.

Configuration Impact

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

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

Example

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

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

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

If the FW is configured with C-BSR, information about the elected BSR and C-BSR is displayed.

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

**Table 1** Description of the **display pim bsr-info** command output
Item	Description
VPN-Instance	Indicates the VPN instance to which BSR information belongs.
Elected AdminScoped BSR Count	Indicates the number of elected AdminScoped BSRs.
Elected BSR Address	Indicates the address of the elected BSR. NOTE: If stably running devices in the same BSR domain display different values in the Elected BSR Address field, the elected BSR is incorrect. Contact Huawei technical support personnel to troubleshoot faults.
Priority	Indicates the priority of the BSR. By default, the value is 0.
Hash mask length	Indicates the mask length in the RP hash calculation.
State	Indicates the status of the BSR. Accept Preferred: No C-BSR is configured on the device and another device functions as a BSR and does not time out. Accept Any: No C-BSR is configured on the device and the current BSR times out (applicable to the situation that a BSR administrative domain is set) Candidate: A C-BSR is configured on the device and another device functions as a BSR. Pending: The device changes from the non-BSR state to the BSR state or a C-BSR is configured on the device and the current BSR times out. Elected: The device is elected as the BSR.
Scope	Indicates the range of multicast addresses in the administrative scope when the BSR is an AdminScoped BSR. Not scoped indicates that the BSR is not an AdminScoped BSR.
Uptime	Indicates the period during which the BSR exists.
Expires	Indicates the remaining time of the BSR.
C-RP Count	Indicates the number of RPs learned through the BSR.
Next BSR message scheduled at	Indicates the period after which the next BSR message is sent. BSR messages are sent only when the timer maintained by the elected BSR times out.
Candidate AdminScoped BSR Count	Indicates the number of AdminScoped C-BSRs.
Candidate BSR Address	Indicates the address of the C-BSR.
Wait to be BSR	Indicates whether the current C-BSR is valid. The values are as follows: 0: indicates that the current C-BSR is valid. The current C-BSR takes part in the BSR election. 1: indicates that the current C-BSR is invalid. The current C-BSR does not take part in the BSR election. When the number of C-BSRs configured on the FW exceeds the threshold, the value is 1.