display bgp group

Function

The display bgp group command displays the peer group.

Format

display bgp group [ group-name ]

display bgp vpnv4 { all | vpn-instance vpn-instance-name } group [ group-name ]

display bgp ipv6 group [ group-name ]

display bgp vpnv6 all group [ group-name ]

display bgp vpnv6 vpn-instance vpn-instance-name group [ group-name ]

display bgp multicast group [ group-name ]

Parameters

Parameter	Description	Value
group-name	Specifies the peer group.	The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
vpnv4	Displays information about BGP VPNv4 peer groups.	-
all	Displays the peer groups of all VPNv4s.	-
vpn-instance vpn-instance-name	Specifies the name of the VPN instance.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
ipv6	Displays information about IPv6 peer groups.	-
vpnv6	Displays information about BGP VPNv6 peer groups.	-
multicast	Displays information about MBGP peer groups.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

Configuring BGP peer groups simplifies BGP network configuration and improves the route advertisement efficiency.

The display bgp group command displays information about the peer group, including peers in the peer group and configuration information about the peer group. The display bgp group command is used in the following scenarios:

Verify the configuration after running the group command to configure the peer group.
Verify the configuration after running the peer group command to add a peer to the peer group.
Verify the configuration after running the undo peer group command to delete a peer from the peer group.
Verify the configuration after modifying the configuration of the peer group.

Precautions

BGP has multiple address families, each of which is configured independently. Information about peer groups in address families can be displayed by specifying different parameters.

If no parameter is specified, the display bgp group command displays default information about peer groups in the IPv4 unicast address family.

Example

# Display the peer group "my-peer".

<sysname> display bgp group my-peer

 BGP peer-group: my-peer

 Remote AS: 100

 Authentication type configured: None

 Group's BFD has been enabled

 Type : internal

 Configured hold timer value: 180

 Keepalive timer value: 60

 Connect-retry timer value: 32

 Minimum route advertisement interval is 15 seconds

 PeerSession Members:

   10.1.1.2

 Maximum allowed route limit: 100

 Threshold: 75%, Parameter:  always connect-retry(default)

 Peer Preferred Value: 0

 No routing policy is configured

 Peer Members:

  Peer            V          AS  MsgRcvd  MsgSent  OutQ  Up/Down       State PrefRcv

  10.1.1.2        4         100       35       42     0 00:29:01 Established  0

**Table 1** Description of the **display bgp group** command output
Item	Description
BGP peer-group	Indicates the name of the BGP peer group.
Remote AS	Indicates the remote AS ID.
Authentication type configured	Indicates the configured BGP authentication type: MD5 Keychain (kk), in which kk indicates the name of the configured keychain authentication None, which indicates no BGP authentication is configured
Group's BFD has been enabled	Indicates that the peer group is enabled with BFD.
Type	Indicates the types of peers: Internal: The type of the peer group is IBGP. External: The type of the peer group is EBGP.
Configured hold timer value	Indicates the configured hold time value, in seconds.
Keepalive timer value	Indicates the Keepalive time value, in seconds.
Connect-retry timer value	Indicates the ConnectRetry timer value, in seconds.
Minimum route advertisement interval	Indicates the minimum interval for advertising routes.
PeerSession Members	Indicates peers that set up session connections.
Maximum allowed route limit	Indicates the maximum number of the allowed BGP routes.
Threshold	Indicates the alarm threshold, that is, the percentage of the number of BGP routes out of the total number of the receivable routes. By default, it is 75%.
Parameter	If peer route-limit command is configured, this parameter will be displayed: always connect-retry(default): By default, BGP Always connect-retry when the maximum is exceeded and the BGP session is terminated. alert-only: Allows the router to generate log message without terminating BGP session when the maximum is exceeded. idle-forever: Don't auto-connect-retry until reset BGP when the maximum is exceeded and then terminating the BGP session. idle-timeout: Auto-connect-retry after timeout when the maximum is exceeded and then terminating BGP session.
Peer Preferred Value	Indicates preferred values of peers.
Peer Members	Indicates that the following displayed information is about peers.
Peer	Indicates the IP address of the peer.
V	Indicates the BGP version number.
As	Indicates the ID of the AS that the peers belong to.
MsgRcvd	Indicates the number of received messages.
MsgSent	Indicates the number of sent messages.
OutQ	Indicates the number of messages to be sent to neighbors.
Up/Down	Indicates the period during which BGP is in the current state.
State	Indicates the BGP state mechanism: Idle: indicates that BGP denies any request of entering. This is the initiatory status of BGP.Upon receiving a Start event, BGP initiates a TCP connection to the remote BGP peer, starts the ConnectRetry Timer with the initial value, listens for a TCP connection initiated by the remote BGP peer, and changes its state to Connect. Idle(Admin): indicates that the peer relationship is shut down initiatively and no attempt is made to establish the neighbor relationship. If the peer ignore command is configured or the peer is set to the Down state through the MIB, the neighbor is in the Idle (Admin) state. Idle(Ovlmt): indicates that the peer relationship is interrupted because the number of routes exceeds the upper threshold. After a BGP peer relationship is interrupted due to the running of the peer route-limit command, the status of the BGP peer relationship is displayed as Idle(Ovlmt). If the reset bgp command is not run, the BGP peer relationship will not be reestablished. Connect: indicates that BGP waits for the TCP connection to be set up before it determines whether to perform other operations. If the TCP connection succeeds, BGP stops the ConnectRetry Timer, sends an Open message to the remote peer, and changes its state to OpenSent. If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection initiated by the remote peer, and changes its state to Active. If the ConnectRetry Timer has expired before a TCP connection is established, BGP restarts the timer with the initial value, initiates a TCP connection to the remote BGP peer, and stays in the Connect state. Active: indicates that BGP tries to set up a TCP connection. This is the intermediate status of BGP. If the TCP connection succeeds, BGP stops the ConnectRetry Timer, sends an Open message to the remote peer, and changes its state to OpenSent. If the ConnectRetry Timer has expired before a TCP connection is established, BGP restarts the timer with the initial value and changes its state to Connect. If BGP initiates a TCP connection with an unknown IP address, the TCP connection fails. When this occurs, BGP restarts the ConnectRetry Timer with the initial value and stays in the Active state. OpenSent: indicates that BGP has sent one Open message to its peer and waits for the other Open message from the peer. If there are no errors in the Open message received, BGP changes its state to OpenConfirm. If there are errors in the Open message received, BGP sends a Notification message to the remote peer and changes its state to Idle. If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection initiated by the remote peer, and changes its state to Active. OpenSent: indicates that BGP has sent one Open message to its peer and waits for the other Open message from the peer. If there are no errors in the Open message received, BGP changes its state to OpenConfirm. If there are errors in the Open message received, BGP sends a Notification message to the remote peer and changes its state to Idle. If the TCP connection fails, BGP restarts the ConnectRetry Timer with the initial value, continues to listen for a TCP connection initiated by the remote peer, and changes its state to Active. OpenConfirm: indicates that BGP waits for a Notification message or a Keepalive message. If BGP receives a Notification message, or the TCP connection fails, BGP changes its state to Idle. If BGP receives a Keepalive message, BGP changes its state to Established. Established: indicates that BGP peers can exchange Update, Notification and Keepalive packets. If BGP receives an Update or a Keepalive message, its state stays in Established. If BGP receives a Notification message, BGP changes its state to Idle.
PrefRcv	Indicates the number of prefixes received by the local peer from the remote peer.

# Display information about all BGP peer groups of VPNv4.

<sysname> display bgp vpnv4 all group
Group in VPNV4:

 BGP peer-group: aa
 Remote AS: 100
 Authentication type configured: None
 Type : internal
 PeerSession Members:
   3.3.3.9

 Peer Members:
   3.3.3.9

Group in VPN-Instance:

 BGP peer-group: v4
 Remote AS number isn't specified
 VPN-Instance(IPv4-family): vpn1

 Authentication type configured: None
 Type : external
 PeerSession Members:
   3.2.6.5            10.1.2.2

 Peer Members:
   3.2.6.5            10.1.2.2

**Table 2** Description of the **display bgp vpnv4 all group** command output
Item	Description
Group in VPNV4	Indicates information about all VPNv4 peer groups.
Remote AS number isn't specified	Indicates that the information is displayed when the peer group is a combined EBGP peer group.
Group in VPN-Instance	Indicates information about peer groups of the VPN instance.
VPN-Instance	Indicates the name of the VPN instance.

# Display information about all BGP IPv6 peer groups.

<sysname> display bgp ipv6 group
 BGP peer-group: in
 Remote AS: 100
 Authentication type configured: None
 Type : internal
 PeerSession Members:
   2::1
 Peer Members:
   1::1               2::1
 ***********************
 BGP peer-group: ex
 Remote AS number not specified
 Authentication type configured: None
 Type : external
 PeerSession Members:
   20::1
 Peer Members:
   10::1              20::1

# Display information about the BGP VPNv6 peer group named bb.

<sysname> display bgp vpnv6 all group bb
Group in VPNV6:

 BGP peer-group: bb
 Remote AS: 100
 Authentication type configured: None
 Type : internal
 Configured hold timer value: 180
 Keepalive timer value: 60

 Connect-retry timer value: 32

 Minimum route advertisement interval is 0 seconds
 PeerSession Members:
  NONE

 Peer Preferred Value: 0
 No routing policy is configured
 Peer Members:
  Peer            V          AS  MsgRcvd  MsgSent  OutQ  Up/Down       State PrefRcv
  3.3.3.9         4         100     1621     1436     0 20:38:19 Established    1
 Group in VPN-Instance:

# Display information about all BGP VPNv6 peer groups.

<sysname> display bgp vpnv6 all group
Group in VPNV6:

 BGP peer-group: bb
 Remote AS: 100
 Authentication type configured: None
 Type : internal
 PeerSession Members:
  NONE

 Peer Members:
   3.3.3.9

Group in VPN-Instance:

 BGP peer-group: v6
 Remote AS number isn't specified
 VPN-Instance(IPv6-family): vpn1

 Authentication type configured: None
 Type : external
 PeerSession Members:
   2001::1

 Peer Members:
   2001::1

# Display information about all IPv6 peer groups of the VPN instance named vpna on the local router.

<sysname> display bgp vpnv6 vpn-instance vpna group

 BGP peer-group: v6
 Remote AS number isn't specified
 VPN-Instance(IPv6-family): vpna

 Authentication type configured: None
 Type : external
 PeerSession Members:
   2001::1

 Peer Members:
   2001::1

# Display information about the IPv6 peer group named g1 of the VPN instance named vpna on the local router.

<sysname> display bgp vpnv6 vpn-instance vpna group g1

 BGP peer-group: g1
 Remote AS number isn't specified
 VPN-Instance(IPv6-family): vpna

 Authentication type configured: None
 Type : external
 Configured hold timer value: 180
 Keepalive timer value: 60

 Connect-retry timer value: 32

 Minimum route advertisement interval is 30 seconds
 PeerSession Members:
   2001::1

 Peer Preferred Value: 0
 No routing policy is configured
 Peer Members:
  Peer            V          AS  MsgRcvd  MsgSent  OutQ  Up/Down       State PrefRcv
  2001::1         4       65410     1336     1559     0 21:06:47 Established   1