display bgp peer
Use display bgp peer to display BGP peer or peer group information.
Syntax
display bgp [ instance instance-name ] peer ipv4 { multicast | [ unicast ] [ vpn-instance vpn-instance-name ] } [ ipv4-address mask-length | { ipv4-address | group-name group-name } log-info | [ ipv4-address ] verbose ]
display bgp [ instance instance-name ] peer ipv6 { multicast | [ unicast ] [ vpn-instance vpn-instance-name ] } [ ipv6-address prefix-length | { ipv6-address | group-name group-name } log-info | [ ipv6-address ] verbose ]
display bgp [ instance instance-name ] peer { ipv4 | ipv6 } [ unicast ] vpn-instance-all [ verbose ]
display bgp [ instance instance-name ] peer link-state [ ipv4-address mask-length | ipv6-address prefix-length | { ipv4-address | ipv6-address | group-name group-name } log-info | [ ipv4-address | ipv6-address ] verbose ]
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 or peer group information for the default BGP instance.
ipv4: Displays IPv4 BGP peer or peer group information.
ipv6: Displays IPv6 BGP peer or peer group information.
link-state: Displays BGP LS peer or peer group information.
multicast: Displays BGP multicast peer or peer group information.
unicast: Displays BGP unicast peer or peer group information.
vpn-instance-all: Displays BGP peer or peer group information for all VPN instances.
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 or peer group information for the public network.
ipv4-address mask-length: Specifies a subnet. The value range for the mask length is 0 to 32. If you specify a subnet, this command displays information about all dynamic peers in the subnet.
ipv4-address: Specifies a peer by its IPv4 address.
ipv6-address prefix-length: Specifies a subnet. The value range for the prefix length is 0 to 128. If you specify a subnet, this command displays information about all dynamic peers in the subnet.
ipv6-address: Specifies a peer by its IPv6 address.
group-name group-name: Specifies a peer group by its name, a case-sensitive string of 1 to 47 characters.
log-info: Displays log information.
verbose: Displays detailed information. If you do not specify this keyword, the command displays brief peer information.
Usage guidelines
If you do not specify any parameters, this command displays brief information about all BGP peers for the specified address family.
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 peers.
<Sysname> display bgp peer ipv4 BGP local router ID: 192.168.100.1 Local AS number: 100 Total number of peers: 1 Peers in established state: 1 * - Dynamically created peer Peer AS MsgRcvd MsgSent OutQ PrefRcv Up/Down State 10.2.1.2 200 13 16 0 0 00:10:34 Established
# Display brief information about BGP IPv4 unicast peers for all VPN instances.
<Sysname> display bgp peer ipv4 vpn-instance-all
Local AS number: 100
* - Dynamically created peer
VPN instance: 1
BGP local router ID: 111.1.1.1
Total number of peers: 2 Peers in established state: 0
Peer AS MsgRcvd MsgSent OutQ PrefRcv Up/Down State
111.1.1.1 100 0 0 0 0 00:00:34 Connect
111.1.1.2 100 0 0 0 0 00:00:34 Connect
VPN instance: 2
BGP local router ID: 112.1.1.1
Total number of peers: 2 Peers in established state: 0
Peer AS MsgRcvd MsgSent OutQ PrefRcv Up/Down State
112.1.1.1 100 0 0 0 0 00:00:06 Idle
112.1.1.2 100 0 0 0 0 00:00:06 Idle
Table 92: Command output
Field | Description |
|---|---|
* - Dynamically created peer | An asterisk (*) before a peer address indicates that the peer is a dynamic peer. |
VPN instance | Name of the VPN instance to which the peer belongs. |
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 that have been received from the peer and added into the local BGP routing table. |
Up/Down | Lasting time of the current BGP session state. |
State | Current state of the BGP session between the local router and the peer. |
# Display brief information about all dynamic peers in network 1.1.1.0/24.
<Sysname> display bgp peer ipv4 1.1.1.0 24 Type: EBGP link Dynamic address range: 1.1.1.0 24 Configured: Active Hold Time: 3 sec Keepalive Time: 1 sec Address family IPv4 Unicast: Configured Maximum allowed prefix number: 100 Threshold: 75% Minimum time between advertisements is 100 seconds Optional capabilities: Multi-protocol extended capability has been enabled Route refresh capability has been enabled Nexthop self has been configured Keep-all-routes has been configured Send community has been configured Send extend community has been configured Default route originating has been configured Multi-hop ebgp has been enabled Peer preferred value: 100 BFD: Enabled Site-of-Origin: 1:1 Routing policy configured: No import as-path-acl list Export as-path-acl list is: 22 No import prefix list Export prefix list is: p1 No import route policy Export route policy is: p1 No import filter-policy No export filter-policy Dynamic peers: 1.1.1.3
# Display brief information about all dynamic peers in network 1::/64.
<Sysname> display bgp peer ipv6 1:: 64 Type: IBGP link Dynamic address range: 1:: 64 Configured: Active Hold Time: 180 sec Keepalive Time: 60 sec Address family IPv6 Unicast: Configured Maximum allowed prefix number: 4294967295 Threshold: 75% Minimum time between advertisements is 15 seconds Optional capabilities: Multi-protocol extended capability has been enabled Route refresh capability has been enabled Send community has been configured Peer preferred value: 0 Site-of-Origin: Not specified Routing policy configured: No routing policy is configured Dynamic peers: 1::1
Table 93: Command output
Field | Description |
|---|---|
Type | BGP connection type between the local router and the dynamic peer:
|
Configured | Timers configured on the local router in seconds, including the hold time (Active Hold Time) and keepalive interval (Keepalive Time). |
Address family IPv4 Unicast | IPv4 unicast address family capability. |
Address family link-state | LS address family capability. |
Address family IPv6 Unicast | IPv6 unicast address family capability. |
Address family IPv4 Multicast | IPv4 multicast address family capability. |
Address family IPv6 Multicast | IPv6 multicast address family capability. |
Address family MDT | This field is not supported in the current software version. IPv4 MDT address family capability. |
Maximum allowed prefix number | 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 alarm messages. |
Minimum time between advertisements | Minimum route advertisement interval in seconds. |
Optional capabilities | Optional capabilities supported by the local end. |
Peer Preferred Value | Preferred value specified for the routes from the peer. |
BFD | Whether BFD is enabled to detect the link to the BGP peers. |
IPsec profile name | IPsec profile applied to the IPv6 BGP peer. This field is available only for the IPv6 unicast and IPv6 multicast address families. |
Routing policy configured | Routing policy configured for the peer. If you do not specify a routing policy, this field displays No routing policy is configured. |
Dynamic peers | IP addresses of dynamic peers. |
# Display detailed information about BGP IPv4 unicast peer 10.2.1.2.
<Sysname> display bgp peer ipv4 10.2.1.2 verbose
Peer: 10.2.1.2 Local: 192.168.100.1
Type: EBGP link
BGP version 4, remote router ID 192.168.100.2
BGP current state: Established, Up for 00h11m10s
BGP current event: RecvKeepalive
BGP last state: OpenConfirm
Port: Local - 179 Remote - 60672
Configured: Active Hold Time: 180 sec Keepalive Time: 60 sec
Received : Active Hold Time: 180 sec
Negotiated: Active Hold Time: 180 sec Keepalive Time: 60 sec
Peer optional capabilities:
Peer support BGP multi-protocol extended
Peer support BGP route refresh capability
Peer support BGP route AS4 capability
Address family IPv4 Unicast: advertised and received
InQ updates: 0, OutQ updates: 0
NLRI statistics:
Rcvd: UnReach NLRI 0, Reach NLRI 0
Sent: UnReach NLRI 0, Reach NLRI 0
Message statistics:
Msg type Last rcvd time/ Current rcvd count/ History rcvd count/
Last sent time Current sent count History sent count
Open 10:38:50-2013.7.23 1 1
10:38:50-2013.7.23 1 1
Update 10:38:51-2013.7.23 1 1
10:38:51-2013.7.23 1 1
Notification - 0 0
- 0 0
Keepalive 10:38:50-2013.7.23 1 1
10:38:50-2013.7.23 1 1
RouteRefresh - 0 0
- 0 0
Total - 3 3
- 3 3
Maximum allowed prefix number: 4294967295
Threshold: 75%
Minimum time between advertisements is 30 seconds
Optional capabilities:
Multi-protocol extended capability has been enabled
Route refresh capability has been enabled
Peer Preferred Value: 0
GTSM has been enabled, and the maximum number of hops is 10
BFD: Enabled
Site-of-Origin: Not specified
Routing policy configured:
No routing policy is configured
# Display detailed information about BGP IPv6 unicast peer 1::2.
<Sysname> display bgp peer ipv6 1::2 verbose
Peer: 1::2 Local: 192.168.1.136
Type: EBGP link
BGP version 4, remote router ID 192.168.1.135
BGP current state: Established, Up for 00h05m48s
BGP current event: RecvKeepalive
BGP last state: OpenConfirm
Port: Local - 13184 Remote - 179
Configured: Active Hold Time: 180 sec Keepalive Time: 60 sec
Received : Active Hold Time: 180 sec
Negotiated: Active Hold Time: 180 sec Keepalive Time: 60 sec
Peer optional capabilities:
Peer support BGP multi-protocol extended
Peer support BGP route refresh capability
Peer support BGP route AS4 capability
Address family IPv6 Unicast: advertised and received
InQ updates: 0, OutQ updates: 0
NLRI statistics:
Rcvd: UnReach NLRI 0, Reach NLRI 0
Sent: UnReach NLRI 0, Reach NLRI 3
Message statistics:
Msg type Last rcvd time/ Current rcvd count/ History rcvd count/
Last sent time Current sent count History sent count
Open 18:59:15-2013.4.24 1 1
18:59:15-2013.4.24 1 2
Update - 0 0
18:59:16-2013.4.24 1 1
Notification - 0 0
18:59:15-2013.4.24 0 1
Keepalive 18:59:15-2013.4.24 1 1
18:59:15-2013.4.24 1 1
RouteRefresh - 0 0
- 0 0
Total - 2 2
- 3 5
Maximum allowed prefix number: 4294967295
Threshold: 75%
Minimum time between advertisements is 30 seconds
Optional capabilities:
Multi-protocol extended capability has been enabled
Route refresh capability has been enabled
Peer preferred value: 0
GTSM has been enabled, and the maximum number of hops is 10
BFD: Enabled
IPsec profile name: profile001
Site-of-Origin: Not specified
Routing policy configured:
No routing policy is configured
# Display detailed BGP IPv4 unicast peer information for all VPN instances.
<Sysname> display bgp peer ipv4 vpn-instance-all verbose
Peer: 111.1.1.1 Local: 111.1.1.1
VPN instance: 1
Type: IBGP link
BGP version 4, remote router ID 0.0.0.0
BGP current state: Connect
BGP current event: CRTimerExpired
BGP last state: Connect
InQ updates: 0, OutQ updates: 0
NLRI statistics:
Rcvd: UnReach NLRI 0, Reach NLRI 0
Sent: UnReach NLRI 0, Reach NLRI 0
Message statistics:
Msg type Last rcvd time/ Current rcvd count/ History rcvd count/
Last sent time Current sent count History sent count
Open - 0 0
- 0 0
Update - 0 0
- 0 0
Notification - 0 0
- 0 0
Keepalive - 0 0
- 0 0
RouteRefresh - 0 0
- 0 0
Total - 0 0
- 0 0
Maximum allowed prefix number: 4294967295
Threshold: 75%
Minimum time between advertisements is 15 seconds
Optional capabilities:
Multi-protocol extended capability has been enabled
Route refresh capability has been enabled
Peer preferred value: 0
Site-of-Origin: Not specified
Routing policy configured:
No routing policy is configured
Peer: 111.1.1.2 Local: 111.1.1.1
VPN instance: 1
Type: IBGP link
BGP version 4, remote router ID 0.0.0.0
BGP current state: Connect
BGP current event: CRTimerExpired
BGP last state: Connect
InQ updates: 0, OutQ updates: 0
NLRI statistics:
Rcvd: UnReach NLRI 0, Reach NLRI 0
Sent: UnReach NLRI 0, Reach NLRI 0
Message statistics:
Msg type Last rcvd time/ Current rcvd count/ History rcvd count/
Last sent time Current sent count History sent count
Open - 0 0
- 0 0
Update - 0 0
- 0 0
Notification - 0 0
- 0 0
Keepalive - 0 0
- 0 0
RouteRefresh - 0 0
- 0 0
Total - 0 0
- 0 0
Maximum allowed prefix number: 4294967295
Threshold: 75%
Minimum time between advertisements is 15 seconds
Optional capabilities:
Multi-protocol extended capability has been enabled
Route refresh capability has been enabled
Peer preferred value: 0
Site-of-Origin: Not specified
Routing policy configured:
No routing policy is configured
Peer: 112.1.1.1 Local: 112.1.1.1
VPN instance: 2
Type: IBGP link
BGP version 4, remote router ID 0.0.0.0
BGP current state: Connect
BGP current event: CRTimerExpired
BGP last state: Connect
InQ updates: 0, OutQ updates: 0
NLRI statistics:
Rcvd: UnReach NLRI 0, Reach NLRI 0
Sent: UnReach NLRI 0, Reach NLRI 0
Message statistics:
Msg type Last rcvd time/ Current rcvd count/ History rcvd count/
Last sent time Current sent count History sent count
Open - 0 0
- 0 0
Update - 0 0
- 0 0
Notification - 0 0
- 0 0
Keepalive - 0 0
- 0 0
RouteRefresh - 0 0
- 0 0
Total - 0 0
- 0 0
Maximum allowed prefix number: 4294967295
Threshold: 75%
Minimum time between advertisements is 15 seconds
Optional capabilities:
Multi-protocol extended capability has been enabled
Route refresh capability has been enabled
Peer preferred value: 0
Site-of-Origin: Not specified
Routing policy configured:
No routing policy is configured
Peer: 112.1.1.2 Local: 112.1.1.1
VPN instance: 2
Type: IBGP link
BGP version 4, remote router ID 0.0.0.0
BGP current state: Connect
BGP current event: CRTimerExpired
BGP last state: Connect
InQ updates: 0, OutQ updates: 0
NLRI statistics:
Rcvd: UnReach NLRI 0, Reach NLRI 0
Sent: UnReach NLRI 0, Reach NLRI 0
Message statistics:
Msg type Last rcvd time/ Current rcvd count/ History rcvd count/
Last sent time Current sent count History sent count
Open - 0 0
- 0 0
Update - 0 0
- 0 0
Notification - 0 0
- 0 0
Keepalive - 0 0
- 0 0
RouteRefresh - 0 0
- 0 0
Total - 0 0
- 0 0
Maximum allowed prefix number: 4294967295
Threshold: 75%
Minimum time between advertisements is 15 seconds
Optional capabilities:
Multi-protocol extended capability has been enabled
Route refresh capability has been enabled
Peer preferred value: 0
Site-of-Origin: Not specified
Routing policy configured:
No routing policy is configured
Table 94: Command output
Field | Description | |
|---|---|---|
Peer | IPv4 or IPv6 address of the peer. | |
Local | Local router ID. | |
VPN instance | Name of the VPN instance to which the peer belongs. | |
Type | BGP connection type between the local router and the peer:
| |
remote router ID | Router ID of the peer. | |
BGP current state | Current state of the BGP session between the local router and the peer. | |
Up for | Lasting time of the BGP session. | |
BGP current event | Current event of the BGP session between the local router and the peer. | |
BGP last state | Previous state of the BGP session. | |
Port | TCP port numbers of the local router and its peer. | |
Configured | Timers configured on the local router in seconds, including the hold time (Active Hold Time) and keepalive interval (Keepalive Time). | |
Received | Received timer (configured on the peer) in seconds, including the hold time (Active Hold Time). | |
Negotiated | Negotiated timers in seconds, including the hold time (Active Hold Time) and keepalive interval (Keepalive Time). | |
Peer optional capabilities | Optional capabilities supported by the peer. | |
Peer support BGP route AS4 capability | The peer supports 4-byte AS number. | |
Address family IPv4 Unicast | IPv4 unicast address family capability: routes of the address family can be advertised and received. | |
Address family LS | LS address family capability: routes of the address family can be advertised and received. | |
Address family IPv6 Unicast | IPv6 unicast address family capability: routes of the address family can be advertised and received. | |
Address family IPv4 Multicast | IPv4 multicast address family capability: routes of the address family can be advertised and received. | |
Address family IPv6 Multicast | IPv6 multicast address family capability: routes of the address family can be advertised and received. | |
Address family MDT | This field is not supported in the current software version. IPv4 MDT address family capability: routes of the address family can be advertised and received. | |
InQ updates | Number of received updates to be processed. | |
OutQ updates | Number of updates to be sent to the peer. | |
NLRI statistics | Number of the reachable and unreachable routes received from and sent to the peer after the BGP session is established. | |
Message statistics | BGP message statistics. | |
Msg type | BGP message type. | |
Last rcvd time/Last sent time | Time when the most recent BGP message was received from or sent to the peer. | |
Current rcvd count/Current sent count | Number of BGP messages received from or sent to the peer on the current BGP session. | |
History rcvd count/History sent count | Number of BGP messages received from or sent to the peer since the BGP peer relationship was established. | |
Total | Total number of received and sent messages. | |
Maximum allowed prefix number | 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 alarm messages. | |
Minimum time between advertisements | Minimum route advertisement interval in seconds. | |
Optional capabilities | Optional capabilities supported by the local end. | |
Peer Preferred Value | Preferred value specified for the routes from the peer. | |
GTSM has been enabled | GTSM is supported. | |
the maximum number of hops | Maximum number of hops to the specified peer. | |
BFD | Whether BFD is enabled to detect the link to the BGP peer. | |
IPsec profile name | IPsec profile applied to the IPv6 BGP peer. This field is available only for the IPv6 unicast and IPv6 multicast address families. | |
Routing policy configured | Routing policy configured for the peer. If you do not specify a routing policy, this field displays No routing policy is configured. | |
# Display log information for BGP IPv4 unicast peer 1.1.1.1.
<Sysname> display bgp peer ipv4 1.1.1.1 log-info
Peer : 1.1.1.1
Date Time State Notification
Error/SubError
06-Feb-2013 22:54:42 Down Send notification with error 6/4
Cease/Administrative Reset
<administrative reset>
Table 95: Command output
Field | Description |
|---|---|
Peer | IPv4 or IPv6 address of the peer. |
Date | Date on which the Notification was sent or received. |
Time | Time at which the Notification was sent or received. |
State | BGP session state:
|
Notification Error/SubError | Error code of the Notification, indicating the cause of why the BGP session was down.
|