[ Contents] [ Prev] [ Next] [ Index] [ Report an Error]

show bgp neighbor

Syntax

show bgp neighbor
< neighbor-address>
<instance instance >

Release Information

Command modified in Release 8.5 of JUNOS software.

Description

Display the state of the specified Border Gateway Protocol (BGP) neighbor. If a peer is forced to Idle state because of license check failure, the output displays the state and the reason—LicenseCheckFailed.

This command is supported on J-series and SRX-series devices.

Options

instance instance—(Optional) Display peer information for a particular routing instance.

neighbor-address—(Optional) Display information for only the BGP peer at the specified IP address.

Required Privilege Level

view

Related Topics

JUNOS Routing Protocols and Policies Command Reference

List of Sample Output

show bgp neighbor 5.5.5.2
show bgp neighbor instance master

Output Fields

Table 5 lists the output fields for the show bgp neighbor command. Output fields are listed in the approximate order in which they appear.

Table 5: show bgp neighbor Output Fields

Field Name

Field Description

Peer

Address of the BGP neighbor. The address is followed by the neighbor's port number.

AS

AS number of the peer.

Local

Address of the local device. The address is followed by the peer's port number.

Type

Type of peer: Internal or External.

State

Current state of the BGP session:

  • Active—BGP is initiating a transport protocol connection in an attempt to connect to a peer. If the connection is successful, BGP sends an open message.
  • Connect—BGP is waiting for the transport protocol connection to complete.
  • Established—The BGP session has been established, and the peers are exchanging update messages.
  • Idle—Either the BGP license checkfailed, or this is the first stage of a connection and BGP is waiting for a Start event.
  • OpenConfirm—BGP has acknowledged receipt of an open message from the peer and is waiting to receive a keepalive or notification message.
  • OpenSent—BGP has sent an open message and is waiting to receive an open message from the peer.

Flags

Internal BGP flags:

  • Aggregate Label—BGP has aggregated a set of incoming labels (labels received from the peer) into a single forwarding label.
  • CleanUp—The peer session is being shut down.
  • Delete—This peer has been deleted.
  • Idled—This peer has been permanently idled.
  • Initializing—The peer session is initializing.
  • SendRtn—Messages are being sent to the peer.
  • Sync—This peer is synchronized with the rest of the peer group.
  • TryConnect—Another attempt is being made to connect to the peer.
  • Unconfigured—This peer is not configured.
  • WriteFailed—An attempt to write to this peer failed.
  • Last State—Previous state of the BGP session.

Last State

Previous state of the BGP session.

Last Event

Last activity that occurred in the BGP session:

  • Closed—The BGP session closed.
  • ConnectRetry—The transport protocol connection failed, and BGP is trying again to connect.
  • HoldTime—The session ended because the hold timer expired.
  • KeepAlive—The local device sent a BGP keepalive message to the peer.
  • Open—The local device sent a BGP open message to the peer.
  • OpenFail—The local device did not receive an acknowledgment of a BGP open message from the peer.
  • RecvKeepAlive—The local device received a BGP keepalive message from the peer.
  • RecvNotify—The local device received a BGP notification message from the peer.
  • RecvOpen—The local device received a BGP open message from the peer.
  • RecvUpdate—The local device received a BGP update message from the peer.
  • Start—The peering session started.
  • Stop—The peering session stopped.
  • TransportError—A TCP error occurred.

Last Error

Last error that occurred in the BGP session:

  • Cease—An error occurred, such as a version mismatch, that caused the session to close.
  • Finite State Machine Error—In setting up the session, BGP received a message that it did not understand.
  • Hold Time Expired—The session's hold time expired.
  • Message Header Error—The header of a BGP message was malformed.
  • Open Message Error—A BGP open message contained an error.
  • None—No errors occurred in the BGP session.
  • Update Message Error—A BGP update message contained an error.

Export

Name of the export policy that is configured on the peer.

Import

Name of the import policy that is configured on the peer.

Options

Configured BGP options:

  • AddressFamily—Configured address family: inet or inet-vpn.
  • GracefulRestart—Graceful restart is configured.
  • HoldTime—Hold time configured with the hold-time statement. The hold time is three times the interval at which keepalive messages are sent.
  • Local Address—Address configured with the local-address statement.
  • NLRI—Configured multicast BGP state for the BGP group: multicast, unicast, or both if you have configured nlri any.
  • Peer AS—Configured peer autonomous system (AS).
  • Preference—Preference value configured with the preference statement.
  • Refresh—Configured to refresh automatically when the policy changes.
  • Rib-group—Configured routing table group.

Address families configured

Names of configured address families for the VPN.

Local Address

Address of the local device.

Holdtime

Hold time configured with the hold-time statement. The hold time is three times the interval at which keepalive messages are sent.

Preference

Preference value configured with the preference statement.

Number of flaps

Number of times the BGP session has gone down and then come back up.

Trace file

Name of the file to receive the output of the tracing operation.

show bgp neighbor 5.5.5.2

user@host> show bgp neighbor 5.5.5.2
  Type: Internal    State: Idle (LicenseCheckFailed)   Flags: <ImportEval Sync>
Peer: 5.5.5.2 AS 200           Local: unspecified AS 200  
  Type: Internal    State: Idle (LIcenseCheckFailed)       (route reflector client)Flags: <ImportEval>
  Last State: Idle          Last Event: Start
  Last Error: None
  Options: <Preference LogUpDown Cluster AddressFamily PeerAS Rib-group Refresh>
  Address families configured: inet-unicast inet-vpn-unicast l2vpn-signaling
  Holdtime: 90 Preference: 170
  Number of flaps: 0
  Trace options:  all
  Trace file: /var/log/bgp size 131072 files 10

show bgp neighbor instance master

user@host> show bgp neighbor instance master
Peer: 5.5.5.1 AS 200           Local: 5.5.5.2 AS 200
  Type: Internal    State: Idle (LicenseCheckFailed)         Flags: <>
  Last State: Idle          Last Event: Start
  Last Error: Cease
  Export: [ static ]
  Options: <Preference LocalAddress LogUpDown AddressFamily PeerAS Rib-group Refresh>
  Address families configured: inet-unicast inet-vpn-unicast
  Local Address: 5.5.5.2 Holdtime: 90 Preference: 170
  Number of flaps: 4
  Last flap event: RecvUpdate
  Error: 'Update Message Error' Sent: 3 Recv: 0
  Error: 'Cease' Sent: 2 Recv: 0
  Trace file: /var/log/bgp size 131072 files 10

[ Contents] [ Prev] [ Next] [ Index] [ Report an Error]