`show ipv6 bgp neighbors`

Displays configuration information and statistics for BGP4+ neighbors of the device.

Syntax

show ipv6 bgp neighbors

show ipv6 bgp neighbors ipv6-addr

show ipv6 bgp neighbors last-packet-with-error

show ipv6 bgp neighbors routes-summary

Parameters

ipv6-addr: IPv6 address of a neighbor in dotted-decimal notation.
last-packet-with-error: Displays information about the last packet from a neighbor that contained an error.
routes-summary: Displays information about all route information received in UPDATE messages from BGP neighbors.

Modes

User EXEC mode

Usage Guidelines

Use this command to view configuration information and statistics for BGP neighbors of the device. Output shows all configured parameters for the neighbors. Only the parameters whose values differ from defaults are shown.

The show ipv6 bgp neighbors command displays the following information:

Output field	Description
IP Address	The IPv6 address of the neighbor.
AS	The AS in which the neighbor resides.
EBGP or IBGP	Whether the neighbor session is an IBGP session, an EBGP session, or a confederation EBGP session: EBGP - The neighbor is in another AS. EBGP_Confed - The neighbor is a member of another sub-AS in the same confederation. IBGP - The neighbor is in the same AS.
RouterID	The neighbor’s router ID.
State	The state of the device’s session with the neighbor. The states are from the perspective of the session, not the neighbor’s perspective. The state values can be one of the following: IDLE - The BGP4+ process is waiting to be started. Usually, enabling BGP4 or establishing a neighbor session starts the BGP4+ process. A minus sign (-) indicates that the session has gone down and the software is clearing or removing routes. ADMND - The neighbor has been administratively shut down. A minus sign (-) indicates that the session has gone down and the software is clearing or removing routes. CONNECT - BGP4+ is waiting for the connection process for the TCP neighbor session to be completed. ACTIVE - BGP4+ is waiting for a TCP connection from the neighbor. Note: If the state frequently changes between CONNECT and ACTIVE, there may be a problem with the TCP connection. OPEN SENT - BGP4+ is waiting for an Open message from the neighbor. OPEN CONFIRM - BGP4+4 has received an OPEN message from the neighbor and is now waiting for either a KEEPALIVE or NOTIFICATION message. If the device receives a KEEPALIVE message from the neighbor, the state changes to Established. If the message is a NOTIFICATION, the state changes to Idle. ESTABLISHED - BGP4+ is ready to exchange UPDATE messages with the neighbor. If there is more BGP data in the TCP receiver queue, a plus sign (+) is also displayed. Note: If you display information for the neighbor using the show ipv6 bgp neighbor<ipv6-address> command, the TCP receiver queue value will be greater than 0.
Time	The amount of time this session has been in its current state.
KeepAliveTime	The keep alive time, which specifies how often this device sends keep alive messages to the neighbor.
HoldTime	The hold time, which specifies how many seconds the device will wait for a KEEPALIVE or UPDATE message from a BGP4+ neighbor before deciding that the neighbor is dead.
RefreshCapability	Whether the device has received confirmation from the neighbor that the neighbor supports the dynamic refresh capability.
Messages Sent and Received	The number of messages this device has sent to and received from the neighbor. The display shows statistics for the following message types: Open Update KeepAlive Notification Refresh-Req
Last Update Time	Lists the last time updates were sent and received for the following: NLRIs Withdraws
Last Connection Reset Reason	The reason the previous session with this neighbor ended. The reason can be one of the following: No abnormal error has occurred. Reasons described in the BGP specifications: Message Header Error Connection Not Synchronized Bad Message Length Bad Message Type OPEN Message Error Unsupported Version Number Bad Peer AS Number Bad BGP Identifier Unsupported Optional Parameter Authentication Failure Unacceptable Hold Time Unsupported Capability UPDATE Message Error Malformed Attribute List Unrecognized Well-known Attribute Missing Well-known Attribute Attribute Flags Error Attribute Length Error Invalid ORIGIN Attribute Invalid NEXT_HOP Attribute Optional Attribute Error Invalid Network Field Malformed AS_PATH Hold Timer Expired Finite State Machine Error Rcv Notification
Last Connection Reset Reason (cont.)	Reasons specific to the implementation: Reset All Peer Sessions User Reset Peer Session Port State Down Peer Removed Peer Shutdown Peer AS Number Change Peer AS Confederation Change TCP Connection KeepAlive Timeout TCP Connection Closed by Remote TCP Data Stream Error Detected
Notification Sent	If the device receives a NOTIFICATION message from the neighbor, the message contains an error code corresponding to one of the following errors. Some errors have subcodes that clarify the reason for the error. Where applicable, the subcode messages are listed underneath the error code messages. Message Header Error Connection Not Synchronized Bad Message Length Bad Message Type Unspecified Open Message Error Unsupported Version Bad Peer As Bad BGP Identifier Unsupported Optional Parameter Authentication Failure Unacceptable Hold Time Unspecified Update Message Error Malformed Attribute List Unrecognized Attribute Missing Attribute Attribute Flag Error Attribute Length Error Invalid Origin Attribute Invalid NextHop Attribute Optional Attribute Error Invalid Network Field Malformed AS Path Unspecified Hold Timer Expired Finite State Machine Error Cease Unspecified
Notification Received	Refer to the description for Notification Sent.
Neighbor NLRI Negotiation	The state of the device’s NLRI negotiation with the neighbor. The states can include the following: Peer negotiated IPv6 unicast capability. Peer configured for IPv6 unicast routes. Peer negotiated IPv4 unicast capability. Peer negotiated IPv4 multicast capability.
AO Keychain name	Name of the TCP keychain (AO) used for authentication
TCP Connection state	The state of the connection with the neighbor. The connection can have one of the following states: LISTEN - Waiting for a connection request. SYN-SENT - Waiting for a matching connection request after having sent a connection request. SYN-RECEIVED - Waiting for a confirming connection request acknowledgment after having both received and sent a connection request. ESTABLISHED - Data can be sent and received over the connection. This is the normal operational state of the connection. FIN-WAIT-1 - Waiting for a connection termination request from the remote TCP, or an acknowledgment of the connection termination request previously sent. FIN-WAIT-2 - Waiting for a connection termination request from the remote TCP. CLOSE-WAIT - Waiting for a connection termination request from the local user. CLOSING - Waiting for a connection termination request acknowledgment from the remote TCP. LAST-ACK - Waiting for an acknowledgment of the connection termination request previously sent to the remote TCP (which includes an acknowledgment of its connection termination request). TIME-WAIT - Waiting for enough time to pass to be sure the remote TCP received the acknowledgment of its connection termination request. CLOSED - There is no connection state.
TCP Keychain name	Name of active TCP keychain used for TCP segment authentication
TCP-AO Enabled YES/NO	Indicates whether TCP keychain authentication is enabled.
TCP-AO in use YES/NO	Indicates whether TCP keychain authentication is being used.
Keychain valid YES/NO	Indicates whether there is a valid keychain in use.
No of segments dropped	Displays the number of segments dropped because they failed TCP authentication.
Send-Active-Key	Provides details on the TCP authentication send key associated with the active keychain: Key-Id Crypto Algorithm (for example, AES-128-CMAC or HMAC-SHA-1) Send-id - Configured identifier sent in outgoing TCP segments Recv-id - Configured identifier used to compare to send-id in received segments Include-tcp-options (YES/NO) - Specifies whether or not to include TCP options in calculating the Message Authentication Code (MAC) for a TCP segment Accept-ao-mistmatch (YES/NO) - Specifies whether TCP segments are accepted or dropped when TCP peers do not have matching TCP authentication support
Recv-Active-Key	Provides details on the TCP authentication receive key associated with the active keychain: Key-Id Crypto Algorithm (for example, AES-128-CMAC or HMAC-SHA-1) Send-id - Configured identifier sent in outgoing TCP segments Recv-id - Configured identifier used to compare to send-id in received segments Include-tcp-options (YES/NO) - Specifies whether or not to include TCP options in calculating the Message Authentication Code (MAC) for a TCP segment Accept-ao-mistmatch (YES/NO) - Specifies whether TCP segments are accepted or dropped when TCP peers do not have matching TCP authentication support
Maximum segment size	Displays maximum size for TCP segments.
TTL check: value	Diplays TTL value.
Byte Sent	The number of bytes sent.
Byte Received	The number of bytes received.
Local host	The IPv6 address of the device.
Local port	The TCP port the RUCKUS device is using for the BGP4+ TCP session with the neighbor.
Remote host	The IPv6 address of the neighbor.
Remote port	The TCP port the neighbor is using for the BGP4+ TCP session with the device.
ISentSeq	The initial send sequence number for the session.
SendNext	The next sequence number to be sent.
TotUnAck	The number of sequence numbers sent by the device that have not been acknowledged by the neighbor.
TotSent	The number of sequence numbers sent to the neighbor.
ReTrans	The number of sequence numbers that the device retransmitted because they were not acknowledged.
UnAckSeq	The current acknowledged sequence number.
IRcvSeq	The initial receive sequence number for the session.
RcvNext	The next sequence number expected from the neighbor.
SendWnd	The size of the send window.
TotalRcv	The number of sequence numbers received from the neighbor.
DupliRcv	The number of duplicate sequence numbers received from the neighbor.
RcvWnd	The size of the receive window.
SendQue	The number of sequence numbers in the send queue.
RcvQue	The number of sequence numbers in the receive queue.
CngstWnd	The number of times the window has changed.

Examples

The following is sample output from the show ipv6 bgp neighbors command when no arguments or keywords are used.

device# show ipv6 bgp neighbors   

    Total number of BGP Neighbors:3
1   IP Address: 2021:17::1:1:1, AS: 1 (IBGP), RouterID: 3.1.1.1, VRF: default-vrf
    State: ESTABLISHED, Time: 1d22h44m29s, KeepAliveTime: 10, HoldTime: 30
       KeepAliveTimer Expire in 7 seconds, HoldTimer Expire in 24 seconds
    Minimal Route Advertisement Interval: 0 seconds
       PeerGroup: p1
       RefreshCapability: Received
       GracefulRestartCapability: Received
           Restart Time 120 sec, Restart bit 0
           afi/safi 2/1, Forwarding bit 0
       GracefulRestartCapability: Sent
           Restart Time 120 sec, Restart bit 0
           afi/safi 2/1, Forwarding bit 0
    Messages:    Open    Update  KeepAlive Notification Refresh-Req
       Sent    : 1       1       16740     0            0          
       Received: 1       1       18099     0            0          
    Last Update Time: NLRI       Withdraw          NLRI       Withdraw
                  Tx: ---        ---           Rx: ---        ---        
    Last Connection Reset Reason:Unknown
    Notification Sent:     Unspecified
    Notification Received: Unspecified
    Neighbor NLRI Negotiation:
      Peer Negotiated IPV6 unicast  capability
      Peer configured for IPV6 unicast  Routes
    Neighbor AS4 Capability Negotiation:
    Outbound Policy Group:                                        
       ID: 3, Use Count: 6
    AO Keychain name : 1
    TCP Connection state: ESTABLISHED
     TCP Keychain name      : 1
     TCP-AO Enabled         : YES
     TCP-AO in use          : YES
     Keychain valid         : YES
     No of segments dropped : 0
     Send-Active-Key
     ---------------
       Key-id               : 1
       Crypto Algorithm     : AES-128-CMAC
       Send-id              : 100
       Recv-id              : 100
       Include-tcp-options  : YES
       Accept-ao-mismatch   : YES
     Recv-Active-Key
     ---------------
       Key-id               : 1
       Crypto Algorithm     : AES-128-CMAC
       Send-id              : 100
       Recv-id              : 100
       Include-tcp-options  : YES
       Accept-ao-mismatch   : YES
                                                                  
     Maximum segment size: 1420
    TTL check: value: 0
       Byte Sent:   318144, Received: 343965
       Local host:  2021:17::1:1:2, Local  Port: 8028
       Remote host: 2021:17::1:1:1, Remote Port: 179
       ISentSeq:   17791259  SendNext:   18109404  TotUnAck:          0
       TotSent:      318145  ReTrans:           2  UnAckSeq:   18109404
       IRcvSeq:   154039983  RcvNext:   154383949  SendWnd:       16365
       TotalRcv:     343966  DupliRcv:          0  RcvWnd:        16384
       SendQue:           0  RcvQue:            0  CngstWnd:       1439

The following is sample output from the show ipv6 bgp neighbors command when an IPv6 address is specified.

device#show ipv6 bgp neighbors 2021:17::1:1:1

1   IP Address: 2021:17::1:1:1, AS: 1 (IBGP), RouterID: 3.1.1.1, VRF: default-vrf
    State: ESTABLISHED, Time: 1d22h45m6s, KeepAliveTime: 10, HoldTime: 30
       KeepAliveTimer Expire in 1 seconds, HoldTimer Expire in 25 seconds
    Minimal Route Advertisement Interval: 0 seconds
       PeerGroup: p1
       RefreshCapability: Received
       GracefulRestartCapability: Received
           Restart Time 120 sec, Restart bit 0
           afi/safi 2/1, Forwarding bit 0
       GracefulRestartCapability: Sent
           Restart Time 120 sec, Restart bit 0
           afi/safi 2/1, Forwarding bit 0
    Messages:    Open    Update  KeepAlive Notification Refresh-Req
       Sent    : 1       1       16743     0            0          
       Received: 1       1       18103     0            0          
    Last Update Time: NLRI       Withdraw          NLRI       Withdraw
                  Tx: ---        ---           Rx: ---        ---        
    Last Connection Reset Reason:Unknown
    Notification Sent:     Unspecified
    Notification Received: Unspecified
    Neighbor NLRI Negotiation:
      Peer Negotiated IPV6 unicast  capability
      Peer configured for IPV6 unicast  Routes
    Neighbor AS4 Capability Negotiation:
    Outbound Policy Group:
       ID: 3, Use Count: 6                                        
    AO Keychain name : 1
    TCP Connection state: ESTABLISHED
     TCP Keychain name      : 1
     TCP-AO Enabled         : YES
     TCP-AO in use          : YES
     Keychain valid         : YES
     No of segments dropped : 0
     Send-Active-Key
     ---------------
       Key-id               : 1
       Crypto Algorithm     : AES-128-CMAC
       Send-id              : 100
       Recv-id              : 100
       Include-tcp-options  : YES
       Accept-ao-mismatch   : YES
     Recv-Active-Key
     ---------------
       Key-id               : 1
       Crypto Algorithm     : AES-128-CMAC
       Send-id              : 100
       Recv-id              : 100
       Include-tcp-options  : YES
       Accept-ao-mismatch   : YES

     Maximum segment size: 1420                                   
    TTL check: value: 0
       Byte Sent:   318201, Received: 344041
       Local host:  2021:17::1:1:2, Local  Port: 8028
       Remote host: 2021:17::1:1:1, Remote Port: 179
       ISentSeq:   17791259  SendNext:   18109461  TotUnAck:          0
       TotSent:      318202  ReTrans:           2  UnAckSeq:   18109461
       IRcvSeq:   154039983  RcvNext:   154384025  SendWnd:       16384
       TotalRcv:     344042  DupliRcv:          0  RcvWnd:        16384
       SendQue:           0  RcvQue:            0  CngstWnd:       1420

History

Release version	Command history
09.0.10	This command was modified to add TCP keychain authentication option (AO) information to the output.

RUCKUS FastIron Command Reference Guide, 10.0.10 53-1005769-22

show ipv6 bgp neighbors

`show ipv6 bgp neighbors`