vrouter-bgp-neighbor-show
This command displays information about Border Gateway Protocol (BGP) neighbors.
Syntax vrouter-bgp-neighbor-show
|
vrouter-name name-string |
Specifies the name of the vRouter. |
|
Specifies the following BGP neighbor arguments: |
|
|
neighbor ip-address |
Specifies the IP address of the neighbor. |
|
l3-port l3-port-number |
Specifies the Layer 3 port used for BGP. |
|
ver ver-number |
Specifies the BGP version. |
|
remote-as remote-as-number |
Specifies the AS number of the remote connection. |
|
msg_rcvd msg_rcvd-number |
Specifies the number of messages received from the receive socket buffer. |
|
msg_sent msg_sent-number |
Specifies the number of messages written to the transmit socket buffer. |
|
tblver tblver-number |
Specifies the version of the routing table. |
|
inQ inQ-number |
Specifies the number of BGP packets queued for a neighbor. |
|
outQ outQnumber |
Specifies the number of BGP packets queued for transmission to a neighbor. |
|
up/down up/down-string |
Specifies the current state of BGP neighbor. It indicates duration of time for which the BGP session has been in the Established state. |
|
state/pfxrcd state/pfxrcd-string |
Specifies the current state of the BGP session and the number of prefixes received from a neighbor. The state can be any of the following types: • 1 — Idle • 2 — Connect • 3 — Active • 4 — OpenSent • 5 — OpenConfirm • 6 — Established |
|
remote-router remote-router-string |
Specifies the neighbor router name. |
|
multi-protocol ipv4-unicast|ipv6-unicast|l2vpn-evpn |
Specify a multi-protocol for BGP. |
|
description description-string |
Specify a BGP neighbor description. |
|
vrf vrf |
Specify the name of VRF. |
Defaults None
Access CLI
History
|
Version 2.0 |
Command introduced. |
|
Version 2.4.1 |
The parameter, remote-router, added. |
|
Version 5.1.3 |
The parameter, l3-port, added. |
|
Version 6.0.0 |
The parameter, description, added. |
|
Version 6.1.0 |
The option, l2vpn-evpn, added to the multi-protocol parameter. |
Usage Use this command to display information about BGP neighbors configured on a vRouter.
Examples To display all information about BGP neighbors, use the following command:
CLI network-admin@switch > vrouter-bgp-neighbor-show
vrouter-name neighbor ver remote-as msg_rcvd msg_sent up/down state/pfxrcd remote-router description vrf
------------ ------------ --- --------- -------- -------- -------- ------------ --------------- ----------- ---
switch 172.16.0.33 4 64512 171 176 02:36:36 13 vrouter-spine-1
Additional Information As indicated in the above output, refer below details:
- The up/down value displays the time duration 02:36:36 (hh:mm:ss format) for which the neighbor has stayed UP. The time duration implies that the session is UP and if the session is DOWN it, the value displayed is never.
- Once the BGP neighbor is up, by default, the state is set to Established mode & state/pfxrcd displays the number of prefixes (in the output above, 13) received by the switch from its neighbor. When the maximum prefix number set by the neighbor is reached, the string "PfxRcd" appears in the entry and the neighbor is shut DOWN. This will set the connection to Idle state.