display bgp group

Function

The display bgp group command displays information about BGP peer groups.

Format

display bgp group [ group-name ]

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

display bgp vpls 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 l2vpn-ad group [ group-name ]

The vpls, vpnv6, and l2vpn-ad parameter are only supported by the S5720-EI, S5720-HI, S5730-HI, S5731-H, S5731S-H, S5732-H, S6720-EI, S6720-HI, S6720S-EI, S6730S-H, and S6730-H.

Parameters

Parameter	Description	Value
group-name	Specifies the name of a 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 information about all BGP VPNv4 or VPNv6 peer groups.	-
vpn-instance vpn-instance-name	Displays information about BGP peer groups in a specified VPN instance.	The value must be an existing VPN instance name.
vpls	Displays information about BGP peer groups of VPLS.	-
ipv6	Displays information about IPv6 peer groups.	-
vpnv6	Displays information about BGP VPNv6 peer groups.	-
l2vpn-ad	Displays information about BGP peer groups of L2VPN-AD.	-

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 information about a peer group named my-peer.

<HUAWEI> display bgp group my-peer

 BGP peer-group: my-peer
 Remote AS: 200
 Authentication type configured: None
 Group's BFD has been enabled
 Type : internal
 Configured hold timer value: 180
 Keepalive timer value: 60
 Minimum route advertisement interval is 15 seconds
 listen-only has been configured
 PeerSession Members:
   10.2.2.2

 Maximum allowed route limit: 8000  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.2.2.2         4   200        0        0     0 00:00:47      Active       0

**Table 1** Description of the display bgp group command output
Item	Description
BGP peer-group	Indicates the name of a BGP peer group
Remote AS	Indicates the number of the AS where a peer group resides.
Authentication type configured	Indicates the configured BGP authentication type: MD5 None: indicates that no BGP authentication is configured.
Group's BFD has been enabled	Indicates that BFD has been enabled for a peer group.
Type	Indicates the type of a peer group: internal: indicates that the peer group is an IBGP peer group. external: indicates that the peer group is an EBGP peer group.
Configured hold timer value	Indicates the value of the Hold timer.
Keepalive timer value	Indicates the value of the Keepalive timer.
Minimum route advertisement interval	Indicates the minimum interval between route advertisements.
listen-only has been configured	Indicates that the peer or peer group only detects connection requests, and does not initiate any connection.
PeerSession Members	Indicates peers that set up sessions.
Maximum allowed route limit	Indicates the maximum number of allowed BGP routes.
Threshold	Indicates the threshold for the quantity of received BGP routes (in percentage) out of the maximum number of routes that can be received.
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 switch 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 BGP session. idle-timeout: Auto-connect-retry after timeout when the maximum is exceeded and then terminating BGP session.
Peer Preferred Value	Indicates the preferred value of a peer.
Peer Members	Indicates that the following information is about peers.
Peer	Indicates the IP address of a peer.
V	Indicates the BGP version.
AS	Indicates the number of the AS where a member of a peer group resides.
MsgRcvd	Indicates the number of received messages.
MsgSent	Indicates the number of sent messages.
OutQ	Indicates the number of messages to be sent to peers.
Up/Down	Indicates the period of time during which a BGP session keeps 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, detects 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 detect 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 an 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 detect 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 route prefixes received by the local peer from the remote peer.

# Display information about all BGP VPNv4 peer groups.

<HUAWEI> display bgp vpnv4 all group

Group in VPNV4:
 
 BGP peer-group: aa
 Remote AS number isn't specified
 Type : external
 PeerSession Members:
   3.3.3.3
 
 Peer Members:
   3.3.3.3
 ***********************

 BGP peer-group: bb
 Remote AS 100
 Type : internal
 PeerSession Members:
  NONE

 Peer Members:
   4.4.4.4
 
Group in VPN-Instance:
 
 BGP peer-group: cc
 Remote AS number isn't specified
 VPN-Instance(IPv4-family): vpn1
 
 Type : external
 PeerSession Members:
   2.2.2.1

 Peer Members:
   2.2.2.1

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

# Display information about a BGP VPNv4 peer group named rr1.

<HUAWEI> display bgp vpnv4 all group rr1

Group in VPNV4:
 No such a peer-group 

Group in VPN-Instance:

 BGP peer-group: rr1
 Remote AS number isn't specified
 VPN-Instance: 1

 Type : external 
 Configured hold timer value: 180
 Keepalive timer value: 60
 Minimum route advertisement interval is 30 seconds
 PeerSession Members:
  NONE 

 Peer Preferred Value: 0
 No routing policy is configured
 Peer Members:
  No Peer Exists

# Display information about all BGP IPv6 peer groups.

<HUAWEI> display bgp vpnv6 all group

Group in VPNV6:
 
 BGP peer-group: 123
 Remote AS number isn't specified
 Type : external
 PeerSession Members:
   FC00:0:0:1::1
 
 Peer Members:
  No Peer Exists
 ***********************
 
 BGP peer-group: 222
 Remote AS 200
 Type : internal
 PeerSession Members:
   FC00:0:0:2::2
 
 Peer Members:
  No Peer Exists
 ***********************
 
 BGP peer-group: 333
 Remote AS 400
 Type : external
 PeerSession Members:
   FC00:0:0:3::3
 
 Peer Members:
  No Peer Exists
 
 
Group in VPN-Instance:
 
 BGP peer-group: 55
 Remote AS number isn't specified
 VPN-Instance(IPv6-family): vpn1
 
 Type : external
 PeerSession Members:
   FC00:0:0:4::4
 
 Peer Members:
   FC00:0:0:4::4

**Table 3** Description of the display bgp vpnv6 all group command output
Item	Description
Group in VPNV6	Displays information about all BGP peer groups in a VPNv6 address family.
Group in VPN-Instance	Displays information about peer groups in a IPv6 VPN instance.
VPN-Instance	Indicates the name of a IPv6 VPN instance.

# Display information about all BGP IPv6 peer groups.

<HUAWEI> display bgp ipv6 group

BGP peer-group is in
 Remote AS 100
 Type : internal
 PeerSession Members:
   FC00:0:0:2::1
 
 Peer Members:
   FC00:0:0:1::1               FC00:0:0:2::1
 ***********************
 
 BGP peer-group is ex
 Remote AS number not specified
 Type : external
 PeerSession Members:
   FC00:0:0:20::1
 Peer Members:
   FC00:0:0:10::1              FC00:0:0:20::1

# Display information about a BGP VPNv6 peer group named rr1.

<HUAWEI> display bgp vpnv6 all group rr1

Group in VPNV6:
 No such a peer-group 
 
Group in VPN-Instance:
 BGP peer-group: rr1
 Remote AS number isn't specified
 VPN-Instance: 1
 Type : external
 Configured hold timer value: 180
 Keepalive timer value: 60
 Minimum route advertisement interval is 30 seconds
 PeerSession Members:
  NONE
 Peer Preferred Value: 0
 No routing policy is configured
 Peer Members:
  No Peer Exists

# Display information about all peer groups in a IPv6 VPN instance named vpn6 on the local device.

<HUAWEI> display bgp vpnv6 vpn-instance vpn6 group

BGP peer-group: g1
 Remote AS 65410
 Type : external
 PeerSession Members:
   FC00:0:0:2000::2
 
 Peer Members:
   FC00:0:0:2000::2

# Display information about a peer group named g1 in a IPv6 VPN instance named vpn6 on the local device.

<HUAWEI> display bgp vpnv6 vpn-instance vpn6 group g1

BGP peer-group: g1
 Remote AS 65410
 Type : external
 Configured hold timer value: 180
 Keepalive timer value: 60
 Minimum time between advertisement runs is 30 seconds
 PeerSession Members:
   2000::2
 
 Peer Preferred Value: 0
 No routing policy is configured
 Peer Members:
  Peer             V    AS  MsgRcvd  MsgSent  OutQ  Up/Down       State PrefRcv
 
  FC00:0:0:2000::2 4 65410      103       90     0 01:20:55 Established       0