display bgp group

Use display bgp group to display BGP peer group information.

Syntax

display bgp [ instance instance-name ] group ipv4 { multicast | [ unicast ] [ vpn-instance vpn-instance-name ] } [ group-name group-name ]

display bgp [ instance instance-name ] group ipv6 { multicast | [ unicast ] [ vpn-instance vpn-instance-name ] } [ group-name group-name ]

display bgp [ instance instance-name ] group link-state [ group-name group-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP peer group information for the default BGP instance.

ipv4: Displays IPv4 BGP peer group information.

ipv6: Displays IPv6 BGP peer group information.

link-state: Displays BGP LS peer group information.

multicast: Displays BGP multicast peer group information.

unicast: Displays BGP unicast peer group information.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays BGP peer group information for the public network.

group-name group-name: Specifies a BGP peer group by its name, a case-sensitive string of 1 to 47 characters. If you do not specify a group, this command displays brief information about all BGP peer groups for the specified address family.

Usage guidelines

By default, the unicast keyword is used if the unicast and multicast keywords are not specified.

Examples

# Display brief information about all BGP IPv4 unicast peer groups.

 BGP peer group: group1
 Remote AS: 600
 Type: external
 Members:
  1.1.1.10

 BGP peer group: group2
 Remote AS number: not specified
 Type: external
 Members:
  2.2.2.2

# Display detailed information about BGP IPv4 unicast peer group group1.

<Sysname> display bgp group ipv4 group-name group1
 BGP peer group: group1
 Remote AS: 600
 Type: external
 Maximum number of prefixes allowed: 4294967295
 Threshold: 75%
 Configured hold time: 180 seconds
 Keepalive time: 60 seconds
 Minimum time between advertisements: 30 seconds
 Peer preferred value: 0
 Site-of-Origin: Not specified

 Routing policy configured:
 No routing policy is configured

 Members:
* - Dynamically created peer
  Peer                    AS  MsgRcvd  MsgSent OutQ PrefRcv Up/Down  State

  1.1.1.10               600        0        0    0       0 00:00:55 Established

# Display detailed information about BGP IPv6 unicast peer group group2.

<Sysname> display bgp group ipv6 group-name group2
 BGP peer group: group2
 Remote AS: 600
 Type: external
 Maximum number of prefixes allowed: 4294967295
 Threshold: 75%
 Configured hold time: 180 seconds
 Keepalive time: 60 seconds
 Minimum time between advertisements: 30 seconds
 Peer preferred value: 0
 IPsec profile name: profile001
 Site-of-Origin: Not specified

 Routing policy configured:
 No routing policy is configured

 Members:
* - Dynamically created peer
  Peer                    AS  MsgRcvd  MsgSent OutQ PrefRcv Up/Down  State

  2::2                   600        0        0    0       0 00:00:45 Established
  3::3                   600        0        0    0       0 00:00:40 Established

Table 85: Command output

Field	Description
BGP peer group	Name of the BGP peer group.
Remote AS	AS number of the peer group.
Type	Type of the peer groups: external—EBGP peer group. internal—IBGP peer group.
Maximum number of prefixes allowed	Maximum number of routes allowed to learn from the peer.
Threshold	Percentage of received routes from the peer to maximum routes allowed to learn from the peer. If the percentage is reached, the system generates a log message.
Configured hold time	Configured hold interval in seconds.
Keepalive time	Keepalive interval in seconds.
Minimum time between advertisements	Minimum route advertisement interval in seconds.
Peer preferred value	Preferred value specified for routes from the peer.
Site-of-Origin	SoO for the peer group.
Routing policy configured	Routing policy configured for the peer group. If you do not specify a routing policy, this field displays No routing policy is configured.
Members	Information about peers included in the peer group.
* - Dynamically created peer	An asterisk (*) before a peer address indicates that the peer is a dynamic peer.
Peer	IPv4 or IPv6 address of the peer.
AS	AS number of the peer.
MsgRcvd	Number of messages received.
MsgSent	Number of messages sent.
OutQ	Number of messages to be sent.
PrefRcv	For the IPv4 and IPv6 address families, this field displays the number of prefixes received from the peer.
Up/Down	Lasting time of the current BGP session state.
State	Current state of the BGP session between the local router and the peer.
IPsec profile name	IPsec profile applied to the IPv6 BGP peer group.

prev	up	next
display bgp dampening parameter	home	display bgp instance-info