5.9. BGP Command Reference

5.9.1. Command Hierarchies

5.9.1.1. Configuration Commands

5.9.1.1.1. Global BGP Commands

config
— router [router-name]
[no] bgp
[no] add-paths
ipv4 send send-limit receive [none]
ipv4 send send-limit
— no ipv4
ipv6 send send-limit receive [none]
ipv6 send send-limit
— no ipv6
authentication-key [authentication-key | hash-key] [hash | hash2]
auth-keychain name
[no] backup-path [ipv4] [ipv6]
always-compare-med {zero | infinity}
always-compare-med strict-as {zero | infinity}
as-path-ignore [ipv4] [vpn-ipv4]
[no] bfd-enable
connect-retry seconds
[no] damping
description description-string
disable-communities [standard] [extended]
export policy-name [policy-name…(up to 15 max)]
— no export
family [ipv4] [vpn-ipv4] [ipv6] [vpn-ipv6] [l2-vpn]
— no family
hold-time seconds [strict]
— no hold-time
import policy-name [policy-name …(up to 15 max)]
— no import
keepalive seconds
— no keepalive
local-preference local-preference
loop-detect {drop-peer | discard-route | ignore-loop | off}
med-out {number | igp-cost}
— no med-out
min-as-origination seconds
multihop ttl-value
— no multihop
family family
resolution {any | filter | disabled}
[no] ldp
[no] rsvp
[no] sr-isis
[no] sr-ospf
[no] accept-orf
send-orf [comm-id...(up to 32 max)]
— no send-orf comm-id
preference preference
— no preference
[no] remove-private {limited}
router-id ip-address
— no router-id
[no] shutdown

5.9.1.1.2. Group BGP Commands

config
— router [router-name]
[no] bgp
[no] group name
[no] add-paths
ipv4 send send-limit receive [none]
ipv4 send send-limit
— no ipv4
ipv6 send send-limit receive [none]
ipv6 send send-limit
— no ipv6
[no] aigp
authentication-key [authentication-key | hash-key] [hash | hash2]
auth-keychain name
[no] bfd-enable
connect-retry seconds
[no] damping
description description-string
disable-communities [standard] [extended]
export policy-name [policy-name…(up to 15 max)]
— no export
family [ipv4] [vpn-ipv4] [ipv6] [vpn-ipv6] [l2-vpn]
— no family
hold-time seconds [strict]
— no hold-time
import policy-name [policy-name …(up to 15 max)]
— no import
keepalive seconds
— no keepalive
local-address ip-address
local-as as-number [private]
— no local-as
local-preference local preference
loop-detect {drop-peer | discard-route | ignore-loop | off}
med-out {number | igp-cost}
— no med-out
min-as-origination seconds
multihop ttl-value
— no multihop
[no] accept-orf
send-orf [comm-id...(up to 32 max)]
— no send-orf [comm-id]
peer-as as-number
— no peer-as
preference preference
— no preference
prefix-limit limit
— no prefix-limit
[no] remove-private [limited]
[no] shutdown
type {internal | external}
— no type

5.9.1.1.3. Neighbor BGP Commands

config
— router [router-name]
[no] bgp
[no] group name
[no] neighbor ip-address
[no] add-paths
ipv4 send send-limit receive [none]
ipv4 send send-limit
— no ipv4
ipv6 send send-limit receive [none]
ipv6 send send-limit
— no ipv6
advertise-label ipv4 [use-svc-routes]
[no] aigp
auth-keychain name
authentication-key [authentication-key | hash-key] [hash | hash2]
[no] bfd-enable
connect-retry seconds
[no] damping
description description-string
disable-communities [standard] [extended]
export policy-name [policy-name…(up to 15 max)]
— no export
family [ipv4] [vpn-ipv4] [ipv6] [vpn-ipv6] [l2-vpn]
— no family
hold-time seconds [strict]
— no hold-time
import policy-name [policy-name …(up to 15 max)]
— no import
keepalive seconds
— no keepalive
local-address ip-address
local-as as-number [private]
— no local-as
local-preference local-preference
loop-detect {drop-peer | discard-route | ignore-loop | off}
med-out {number | igp-cost}
— no med-out
min-as-origination seconds
multihop ttl-value
— no multihop
[no] accept-orf
send-orf [comm-id...(up to 32 max)]
— no send-orf [comm-id]
peer-as as-number
— no peer-as
preference preference
— no preference
prefix-limit limit
[no] remove-private {limited}
[no] shutdown
type {internal | external}
— no type

5.9.1.1.4. Other BGP-Related Commands

config
— router [router-name]
autonomous-system as-number

5.9.1.2. Show Commands

show
router [router-instance]
bgp
auth-keychain keychain
damping [ip-prefix [/ip-prefix-length]] [damp-type] [detail] ipv4
damping [ip-prefix [/ip-prefix-length]] [damp-type][detail] ipv6
damping [ip-prefix [/ip-prefix-length]] [damp-type] [detail] vpn-ipv4
damping [ip-prefix [/ip-prefix-length]] [damp-type] [detail] vpn-ipv6
group [name] [detail]
neighbor [ip-address [detail]]
neighbor [as-number [detail]]
neighbor ip-address [family] filter1 [brief]
neighbor ip-address [family] filter2
neighbor as-number [family] filter2
neighbor ip-address orf filter3
neighbor ip-address graceful-restart
next-hop family] [ip-address] [detail]
paths
routes [family] [brief]
routes [family] prefix [detail | longer | hunt [brief]]
routes [family [type mvpn-type]] community comm-id
routes [family [type mvpn-type]] aspath-regex reg-ex
routes ms-pw [rd rd] [aii-type2 aii-type2] [brief]
routes l2-vpn l2vpn-type {[rd rd] | [siteid site-id] | [veid veid] [offset vpls-base-offset]}
routes evpn auto-disc [hunt | detail] [rd rd] [community comm-id] [tag tag] [next-hop ip-address] [esi esi]
routes evpn eth-seg [hunt | detail] [rd rd] [community comm-id] [originator-ip ip-address] [next-hop ip-address] [esi esi]
routes evpn inclusive-mcast [hunt | detail] [rd rd] [community comm-id] [originator-ip ip-address] [next-hop ip-address] [esi esi]
routes evpn inclusive-mcast [hunt | detail] [rd rd] [community comm-id] [originator-ip ip-address] [next-hop ip-address] [tag tag]
routes evpn mac [hunt | detail] [rd rd] [next-hop ip-address] [mac-address mac-address] [community comm-id] [tag tag]
summary [all]
summary [family family] [neighbor ip-address]

5.9.1.3. Clear Commands

clear
— router
— bgp
damping [{ip-prefix/ip-prefix-length] [neighbor ip-address]} | {group name}]
flap-statistics [{ip-prefix/mask [neighbor ip-address] | [group group-name] | [regex reg-exp | policy policy-name}]
neighbor {ip-address | as as-number | external | all} [soft | soft-inbound]
neighbor {ip-address | as as-number | external | all} statistics
neighbor ip-address end-of-rib

5.9.1.4. Debug Commands

debug
— router
— bgp
events [neighbor ip-address | group name]
— no events
keepalive [neighbor ip-address | group name]
— no keepalive
notification [neighbor ip-address | group name]
open [neighbor ip-address | group name]
— no open
packets [neighbor ip-address | group name]
— no packets
route-refresh [neighbor ip-address | group name]
rtm [neighbor ip-address | group name]
— no rtm
socket [neighbor ip-address | group name]
— no socket
timers [neighbor ip-address | group name]\
— no timers
update [neighbor ip-address | group name]
— no update

5.9.2. Command Descriptions

5.9.2.1. Configuration Commands

bgp

Syntax 
[no] bgp
Context 
config>router
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables the BGP protocol instance and BGP configuration context. BGP is administratively enabled upon creation.

The no form of this command deletes the BGP protocol instance and removes all configuration parameters for the BGP instance. BGP must be shutdown before deleting the BGP instance. An error occurs if BGP is not shutdown first.

add-paths

Syntax 
[no] add-paths
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables the context to configure multiple paths for one or more families in a BGP instance, group, or neighbor. The BGP add-path capability allows the router to send and receive multiple paths per prefix to and from a peer.

The no form of this command removes the add-path capability from the BGP instance, group, or neighbor, causing sessions established using add-paths to go down and come back up without the add-path capability.

Default 

no add-paths

ipv4

Syntax 
ipv4 send send-limit receive [none]
ipv4 send send-limit
no ipv4
Context 
config>router>bgp>add-paths
config>router>bgp>group>add-paths
config>router>bgp>group>neighbor>add-paths
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures the add-path capability for IPv4 labeled routes; the add-path capability is disabled by default.

Note:

The add-path capability is not supported for IPv4 native routes (that is, IPv4 routes without a label).

The maximum number of paths to send per IPv4 NLRI is configured using the send-limit mandatory parameter. The capability to receive multiple paths per prefix from a peer is configured using the optional receive keyword. If the receive keyword is not specified, the receive capability is enabled by default.

The no form of this command disables add-path support for IPv4 routes, causing sessions established using add-paths for IPv4 to go down and come back up without the add-paths capability.

Default 

no ipv4

Parameters 
send-limit —
Specifies the maximum number of paths per IPv4 NLRI that can be advertised to add-path peers. The actual number of advertised routes may be less depending on the next-hop diversity requirement, other configuration options, route policies, and route advertisement rules.
Values—
1 to 16, none

 

Default—
max
receive —
Specifies that the router negotiates the add-paths receive capability for IPv4 routes with its peers.
none —
Specifies that the router does not negotiate the add-paths receive capability for IPv4 routes with its peers.

ipv6

Syntax 
ipv6 send send-limit receive [none]
ipv6 send send-limit
no ipv6
Context 
config>router>bgp>add-paths
config>router>bgp>group>add-paths
config>router>bgp>group>neighbor>add-paths
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures the add-path capability for IPv6 labeled routes; the capability is disabled by default.

Note:

The add-path capability is not supported for IPv6 native routes (that is, IPv6 routes without a label).

The maximum number of paths to send per IPv6 NLRI is configured using the send-limit mandatory parameter. The capability to receive multiple paths per prefix from a peer is configured using the optional receive keyword. If the receive keyword is not specified, the receive capability is enabled by default.

The no form of this command disables add-path support for IPv6 routes, and causes sessions established using add-paths for IPv6 to go down and come back up without the add-path capability.

Default 

no ipv6

Parameters 
send-limit —
Specifies the maximum number of paths per IPv6 NLRI that can be advertised to add-path peers. The actual number of advertised routes may be less depending on the next-hop diversity requirement, other configuration options, route policies, and route advertisement rules.
Values—
1 to 16, none

 

Default—
max
receive —
Specifies that the router negotiates the add-paths receive capability for IPv6 routes with its peers.
none —
Specifies that the router does not negotiate the add-paths receive capability for IPv6 routes with its peers.

advertise-inactive

Syntax 
[no] advertise-inactive
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables the advertising of inactive BGP routes to other BGP peers. By default, BGP only advertises BGP routes to other BGP peers if a specific BGP route is chosen by the route table manager as the most preferred route within the system and is active in the forwarding plane. This command allows system administrators to advertise a BGP route even though it is not the most preferred route within the system for a specific destination.

The no form of this command disables the advertising of inactive BGP routers to other BGP peers.

Default 

no advertise-inactive

advertise-label

Syntax 
advertise-label ipv4 [use-svc-routes]
no advertise-label
Context 
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures the IPv4 transport peers to exchange RFC 3107-labeled IPv4 routes.

If the ipv4 keyword is configured, all IPv4 routes advertised to the remote BGP peer are sent with an RFC 3107 formatted label for the destination route.

The optional keyword use-svc-routes allows the user to limit the number of BGP 3107 IPv4 labeled routes that are installed in the MPLS FIB. If the keyword is specified, only BGP 3107 labeled routes that are required by services or required for establishing a BGP session with a configured neighbor are installed in the MPLS FIB. The following will trigger installation of the MPLS label into the MPLS FIB for the received BGP 3107 IPv4 labeled route:

  1. configuration of SDP to use BGP tunnel to the far-end
  2. dynamic creation of spoke-SDP binding when a route is received through BGP AD and the far-end of the SDP binding is reachable using the labeled route
  3. installation of VPN IPv4 routes received from the PE, which is reachable using the labeled route
  4. configuration of the BGP session to a BGP peer using the bgp>neighbor CLI command, and the BGP peer is reachable using the labeled route

Other IP applications such as FTP, SSH, and other applications will not trigger installation of the IPv4 labeled routes into the MPLS FIB.

The no form of this command disables any or all configured options.

Default 

no advertise-label

Parameters 
ipv4—
Specifies the advertisement label address family for core IPv4 routes. This keyword can be specified only for an IPv4 peer.
use-svc-routes—
Optional keyword that allows the user to limit the number of BGP 3107 labeled routes that are installed in the MPLS FIB. If it is specified, only BGP 3107 labeled routes that are required by services configured in the system, or required for establishing a BGP session with a configured neighbor, are installed in the MPLS FIB.

aggregator-id-zero

Syntax 
[no] aggregator-id-zero
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command sets the router ID in the BGP aggregator path attribute to zero when BGP aggregates routes. This prevents different routers within an AS from creating aggregate routes that contain different AS paths.

When BGP is aggregating routes, it adds the aggregator path attribute to the BGP update messages. By default, BGP adds the ASN and router ID to the aggregator path attribute.

When this command is enabled, BGP adds the router ID to the aggregator path attribute. This command is used at the group level to revert to the value defined under the global level. This command is used at the neighbor level to revert to the value defined under the group level.

The no form of this command used at the global level reverts to the default, where BGP adds the ASN and router ID to the aggregator path attribute.

The no form of this command used at the group level reverts to the value defined at the global level.

The no form of this command used at the neighbor level reverts to the value defined at the group level.

Default 

no aggregator-id-zero

aigp

Syntax 
[no] aigp
Context 
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables AIGP path attribute support with one or more BGP peers. BGP path selection among routes with an associated AIGP metric is based on the end-to-end IGP metrics of the different BGP paths, even when these BGP paths span more than one AS and IGP instance.

The no form of this command disables AIGP path attribute support, removes the AIGP attribute from advertised routes, and causes the AIGP attribute in received routes to be ignored.

Default 

no aigp

auth-keychain

Syntax 
auth-keychain name
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures a TCP authentication keychain to use for the session. The keychain allows the rollover of authentication keys during the lifetime of a session.

Default 

no auth-keychain

Parameters 
name
Specifies the name of the keychain, up to 32 characters, to use for the specified TCP session or sessions.

authentication-key

Syntax 
authentication-key [authentication-key | hash-key] [hash | hash2]
no authentication-key
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures the BGP authentication key.

Authentication is performed between neighboring routers before setting up the BGP session by verifying the password. Authentication is performed using the MD-5 message based digest. MD5 authentication is disabled by default.

The authentication key can be any combination of ASCII characters up to 255 characters.

The no form of this command reverts to the default value.

Parameters 
authentication-key—
Specifies the authentication key. The key can be any combination of ASCII characters up to 255 characters (unencrypted). If spaces are used in the string, enclose the entire string in quotation marks (“ ”).
hash-key—
Specifies the hash key. The key can be any combination of ASCII characters up to 342 characters (encrypted). If spaces are used in the string, enclose the entire string in quotation marks (“ ”).

This is useful when a user must configure the parameter, but, for security purposes, the actual unencrypted key value is not provided.

hash—
Specifies the key is entered in an encrypted form. If the hash parameter is not used, the key is assumed to be in a non-encrypted, clear text form. For security, all keys are stored in encrypted form in the configuration file with the hash parameter specified.
hash2—
Specifies the key is entered in a more complex encrypted form. If the hash2 parameter is not used, the less encrypted hash form is assumed.

backup-path

Syntax 
[no] backup-path [ipv4] [ipv6]
Context 
config>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables BGP Fast Reroute (FRR) with Prefix-Independent Convergence (PIC), allowing for the creation of a backup path for labeled IPv4 and IPv6 BGP learned prefixes belonging to the base router. Multiple paths must be received for a prefix to take advantage of this feature.

If a prefix has a backup path and its primary paths fail, the affected traffic is rapidly diverted to the backup path without waiting for control plane reconvergence to occur. If many prefixes share the same primary paths, and in some cases also the same backup path, the time to failover traffic to the backup path is independent of the number of prefixes.

By default, IPv4 and IPv6 prefixes do not have a backup path installed in the IOM.

The no form of this command disables BGP FRR with PIC.

Default 

no backup-path

Parameters 
ipv4—
Enables BGP fast reroute for labeled IPv4 routes.
ipv6—
Enables BGP fast reroute for labeled IPv6 routes.

best-path-selection

Syntax 
best-path-selection
Context 
config>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables path selection configuration.

always-compare-med

Syntax 
always-compare-med {zero | infinity}
no always-compare-med strict-as {zero | infinity}
no always-compare-med
Context 
config>router>bgp>best-path-selection
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures the comparison of BGP routes based on the MED attribute.

The default behavior of 7210 SAS is to compare two routes on the basis of MED only if they have the same neighbor AS (the first non-confed AS in the received AS_PATH attribute). By default, a route without a MED attribute is handled the same as though it had a MED attribute with the value 0.

The always-compare-med command without the strict-as keyword allows MED to be compared even if the paths have a different neighbor AS. In this case, if neither zero nor infinity is specified, the zero option is inferred, meaning a route without a MED is handled the same as though it had a MED attribute with the value 0. When the strict-as keyword is configured, MED is only compared between paths from the same neighbor AS, and in this case, zero or infinity is mandatory and tells BGP how to interpret paths without a MED attribute.

The no form of this command reverts to the default behavior.

Default 

no always-compare-med

Parameters 
zero—
Specifies that for routes learned without a MED attribute, a zero (0) value is used in the MED comparison. The routes with the lowest metric are the most preferred.
infinity—
Specifies that for routes learned without a MED attribute, a value of infinity (2^32-1) is used in the MED comparison. This, in effect makes, these routes the least desirable.
strict-as—
Specifies that the MEDs of two paths are compared even if they come from different neighboring AS.

as-path-ignore

Syntax 
as-path-ignore [ipv4] [vpn-ipv4]
no as-path-ignore
Context 
config>router>bgp>best-path-selection
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command determines whether the AS path is used to determine the best BGP route.

If this option is present, the AS paths of incoming routes are not used in the route selection process.

The no form of this command removes the configuration.

Default 

no as-path-ignore

Parameters 
ipv4—
Specifies that the AS-path length will be ignored for all IPv4 routes.
vpn-ipv4—
Specifies that the AS-path length will be ignored for all IPv4 VPRN routes.

ignore-nh-metric

Syntax 
ignore-nh-metric
no ignore-nh-metric
Context 
config>router>bgp>best-path-selection
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command instructs BGP to disregard the resolved distance to the BGP next-hop in its decision process for selecting the best route to a destination.

When configured in the config>router>bgp>best-path-selection context, this command applies to the comparison of two BGP routes with the same NLRI learned from base router BGP peers. When configured in the config>service>vprn context, this command applies to the comparison of two BGP-VPN routes for the same IP prefix imported into the VPRN from the base router BGP instance. When configured in the config>service>vprn>bgp>best-path-selection context, this command applies to the comparison of two BGP routes for the same IP prefix learned from VPRN BGP peers.

The no form of this command restores the default behavior where BGP factors the distance to the next-hop into its decision process.

Default 

no ignore-nh-metric

ignore-router-id

Syntax 
ignore-router-id
no ignore-router-id
Context 
config>router>bgp>best-path-selection
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command modifies the route selection behavior. When this command is enabled and the current best path to a destination was learned from eBGP peer X with BGP identifier x, new paths that are received from eBGP peer Y with BGP identifier y and are equivalent will not change the best path even if y is less than x during BGP identifier comparison.

The no form of this command restores the default behavior of selecting the route with the lowest BGP identifier (Y) as best.

Default 

no ignore-router-id

bfd-enable

Syntax 
[no] bfd-enable
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables bidirectional forwarding (BFD) to control the state of the associated protocol interface. By enabling BFD on a specific protocol interface, the state of the protocol interface is tied to the state of the BFD session between the local node and the remote node. The parameters used for the BFD are set via the BFD command under the IP interface.

IPv4 BFD can be used for multihop or single hop MP-BGP sessions. For more information about the protocols and platforms that support BFD, refer to the 7210 SAS-D, Dxp, K 2F1C2T, K 2F6C4T, K 3SFP+ 8C Router Configuration Guide.

The no form of this command removes BFD from the associated IGP/BGP protocol adjacency.

Default 

no bfd-enable

connect-retry

Syntax 
connect-retry seconds
no connect-retry
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures the BGP connect retry timer value in seconds.

When this timer expires, BGP tries to reconnect to the configured peer. This configuration parameter can be set at three levels: global level (applies to all peers), peer-group level (applies to all peers in group) or neighbor level (only applies to specified peer). The most specific value is used.

The no form of this command used at the global level reverts to the default value.

The no form of this command used at the group level reverts to the value defined at the global level.

The no form of this command used at the neighbor level reverts to the value defined at the group level.

Default 

connect-retry 120

Parameters 
seconds—
Specifies th BGP connect retry timer value, in seconds, expressed as a decimal integer.
Values—
1 to 65535

 

damping

Syntax 
[no] damping
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables BGP route damping for learned routes, which are defined within the route policy. Use damping to reduce the number of update messages sent between BGP peers and reduce the load on peers without affecting the route convergence time for stable routes. Damping parameters are set through route policy definition.

When damping is enabled and the route policy does not specify a damping profile, the default damping profile is used. This profile is always present and consists of the following parameters:

Half-life:

15 minutes

Max-suppress:

60 minutes

Suppress-threshold:

3000

Reuse-threshold:

750

The no form of this command used at the global level reverts route damping.

The no form of this command used at the group level reverts to the value defined at the global level.

The no form of this command used at the neighbor level reverts to the value defined at the group level.

Default 

no damping

description

Syntax 
description description-string
no description
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command creates a text description stored in the configuration file for a configuration context.

The no form of this command removes the description string from the context.

Parameters 
string—
Specifies the description character string. Allowed values are any string up to 80 characters composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, and so on), the entire string must be enclosed within double quotes.

disable-4byte-asn

Syntax 
[no] disable-4byte-asn
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command disables the use of 4-byte ASNs. It can be configured at all 3 levels of the hierarchy so it can be specified down to the per peer basis.

If this command is enabled, 4-byte ASN support should not be negotiated with the associated remote peers.

The no form of this command reverts to the default behavior, which is to enable the use of 4-byte ASN.

disable-capability-negotiation

Syntax 
[no] disable-capability-negotiation
Context 
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command disables the exchange of capabilities when the command is enabled, after the peering is flapped, any new capabilities are not negotiated and strictly support IPv4 routing exchanges with that peer.

The no form of this command removes this command from the configuration and restores the normal behavior.

Default 

no disable-capability-negotiation

disable-communities

Syntax 
disable-communities [standard] [extended]
no disable-communities
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures BGP to disable sending communities.

Parameters 
standard—
Specifies standard communities that existed before VPRNs or 2547.
extended—
Specifies BGP communities used were expanded after the concept of 2547 was introduced, to include handling the VRF target.

disable-fast-external-failover

Syntax 
[no] disable-fast-external-failover
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures BGP fast external failover.

disallow-igp

Syntax 
[no] disallow-igp
Context 
config>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables or disables the use of the IGP next-hop to the BGP next-hop as the next-hop of the last resort.

enable-inter-as-vpn

Syntax 
[no] enable-inter-as-vpn
Context 
config>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command specifies whether VPNs can exchange routes across autonomous system boundaries, providing model B connectivity.

The no form of this command disallows ASBRs to advertise VPRN routes to their peers in other autonomous systems.

Default 

no enable-inter-as-vpn

enable-peer-tracking

Syntax 
[no] enable-peer-tracking
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables BGP peer tracking. BGP peer tracking allows a BGP peer to be dropped immediately if the route used to resolve the BGP peer address is removed from the IP routing table and there is no alternative available. The BGP peer will not wait for the holdtimer to expire; therefore, the BGP reconvergance process is accelerated.

The no form of this command disables peer tracking.

Default 

no enable-peer-tracking

export

Syntax 
export policy-name [policy-name…upto 15 max]
no export [policy-name]
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command specifies the export route policy used to determine which routes are advertised to peers.

This configuration parameter can be set at three levels: global level (applies to all peers), group level (applies to all peers in peer-group) or neighbor level (only applies to specified peer). The most specific level is used.

When multiple policy names are specified, the policies are evaluated in the order they are specified. A maximum of five (5) policy names can be configured. The first policy that matches is applied.

When multiple export commands are issued, the last command entered overrides the previous command.

When no export policies are specified, BGP routes are advertised and non-BGP routes are not advertised by default.

The no form of this command removes the policy association with the BGP instance. To remove association of all policies, use the no export command without arguments.

Default 

no export

Parameters 
policy-name—
Specifies the route policy name. Allowed values are any string up to 32 characters composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes. Route policies are configured in the config>router>policy-options context.

family

Syntax 
family [ipv4] [vpn-ipv4] [ipv6] [vpn-ipv6] [l2-vpn]
no family
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command specifies the address families to be supported over BGP peerings in the base router. This command is additive, so issuing the family command adds the specified address family to the list.

The no form of this command removes the specified address family from the associated BGP peerings. If an address family is not specified, the system resets the supported address family back to the default.

Default 

family ipv4

Parameters 
ipv4—
Exchanges IPv4 routing information.
vpn-ipv4—
Exchanges IPv4 VPN routing information.
ipv6—
Exchanges IPv6 routing information.
vpn-ipv6—
Exchanges IPv6 VPN routing information.
l2-vpn—
Exchanges Layer 2 VPN information.

vpn-apply-export

Syntax 
[no] vpn-apply-export
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command causes the base instance BGP export route policies to be applied to VPN-IPv4 routes.

The no form of this command disables the application of the base instance BGP route policies to VPN-IPv4 routes.

Default 

no vpn-apply-export

vpn-apply-import

Syntax 
[no] vpn-apply-import
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command applies base instance BGP import route policies to VPN-IPv4 routes.

The no form of this command disables the application of the base instance BGP import route policies to VPN-IPv4 routes.

Default 

no vpn-apply-import

group

Syntax 
[no] group name
Context 
config>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables the context to configure a BGP peer group.

The no form of this command deletes the specified peer group and all configurations associated with the peer group. The group must be shutdown before it can be deleted.

Parameters 
name—
Specifies the peer group name. Allowed values are any string up to 32 characters composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes.

hold-time

Syntax 
hold-time seconds [strict]
no hold-time
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures the BGP hold time, expressed in seconds.

The BGP hold time specifies the maximum amount of time that BGP waits between successive messages (either keepalive or update) from its peer before closing the connection.

This configuration parameter can be set at three levels: global level (applies to all peers), group level (applies to all peers in group) or neighbor level (only applies to specified peer). The most specific value is used.

Even though the 7210 SAS implementation allows setting the keepalive time separately, the configured keepalive timer is overridden by the hold-time value under the following circumstances.

  1. If the specified hold-time is less than the configured keepalive time, the operational keepalive time is set to a third of the hold-time; the configured keepalive time is not changed.
  2. If the hold-time is set to zero, the operational value of the keepalive time is set to zero; the configured keepalive time is not changed. This means that the connection with the peer is up permanently and no keepalive packets are sent to the peer.

The no form of this command used at the global level reverts to the default value.

The no form of this command used at the group level reverts to the value defined at the global level.

The no form of this command used at the neighbor level reverts to the value defined at the group level.

Default 

hold-time 90

Parameters 
seconds—
Specifies the hold-time, in seconds, expressed as a decimal integer. A value of 0 indicates the connection to the peer is up permanently.
Values—
0, 3 to 65535

 

strict —
When this parameter is specified, the advertised BGP hold-time from the far-end BGP peer must be greater than or equal to the specified value.

import

Syntax 
import policy-name [policy-name…up to 15 max]
no import [policy-name]
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command specifies the import route policy to be used to determine which routes are accepted from peers. Route policies are configured in the config>router>policy-options context.

This configuration parameter can be set at three levels: global level (applies to all peers), group level (applies to all peers in peer-group) or neighbor level (only applies to specified peer). The most specific level is used.

When multiple policy names are specified, the policies are evaluated in the order they are specified. A maximum of five (5) policy names can be specified. The first policy that matches is applied.

When multiple import commands are issued, the last command entered will override the previous command.

When an import policy is not specified, BGP routes are accepted by default.

The no form of this command removes the policy association with the BGP instance. To remove association of all policies, use no import without arguments.

Default 

no import

Parameters 
policy-name—
Specifies the route policy name. Allowed values are any string up to 32 characters composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes. Route policies are configured in the config>router>policy-options context.

keepalive

Syntax 
keepalive seconds
no keepalive
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures the BGP keepalive timer. A keepalive message is sent every time this timer expires.

The keepalive parameter can be set at three levels: global level (applies to all peers), group level (applies to all peers in peer-group) or neighbor level (only applies to specified peer). The most specific value is used.

The keepalive value is generally one-third of the hold-time interval. Even though the 7210 SAS implementation allows the keepalive value and the hold-time interval to be independently set, under the following circumstances, the configured keepalive value is overridden by the hold-time value.

  1. If the specified keepalive value is greater than the configured hold-time, the specified value is ignored, and the keepalive value is set to one third of the current hold-time value.
  2. If the specified hold-time interval is less than the configured keepalive value, the keepalive value is reset to one third of the specified hold-time interval.
  3. If the hold-time interval is set to zero, the configured keepalive value is ignored. This means that the connection with the peer is up permanently and no keepalive packets are sent to the peer.

The no form of this command used at the global level reverts to the default value.

The no form of this command used at the group level reverts to the value defined at the global level.

The no form of this command used at the neighbor level reverts to the value defined at the group level.

Default 

keepalive 30

Parameters 
seconds—
Specifies the keepalive timer, in seconds, expressed as a decimal integer.
Values—
0 to 21845

 

local-address

Syntax 
local-address ip-address
no local-address
Context 
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures the local IP address used by the group or neighbor when communicating with BGP peers.

Outgoing connections use the local-address as the source of the TCP connection when initiating connections with a peer.

When a local address is not specified, 7210 SAS uses the system IP address when communicating with IBGP peers and uses the interface address for directly connected EBGP peers. This command is used at the neighbor level to revert to the value defined under the group level.

The no form of this command removes the configured local-address for BGP.

The no form of this command used at the group level reverts to the value defined at the global level.

The no form of this command used at the neighbor level reverts to the value defined at the group level.

Default 

no local-address

Parameters 
ip-address—
Specifies the local IP address.
Values—

ipv4-address:

a.b.c.d (host bits must be 0)

ipv4-prefix-length:

0 to 32

ipv6-address:

x:x:x:x:x:x:x:x (eight 16-bit pieces)

x:x:x:x:x:x:d.d.d.d

x: [0 to FFFF]H

d: [0 to 255]D

 

local-as

Syntax 
local-as as-number [private]
no local-as
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures a BGP virtual autonomous system (AS) number.

In addition to the ASN configured for BGP in the config>router>autonomous-system context, a virtual (local) ASN is configured. The virtual ASN is added to the as-path message before the router ASN makes the virtual AS the second AS in the as-path.

This configuration parameter can be set at three levels: global level (applies to all peers), group level (applies to all peers in peer-group) or neighbor level (only applies to specified peer). Therefore, by specifying this at each neighbor level, it is possible to have a separate as-number per EBGP session.

When a command is entered multiple times for the same AS, the last command entered is used in the configuration. The private attribute can be added or removed dynamically by reissuing the command.

Changing the local AS at the global level in an active BGP instance causes the BGP instance to restart with the new local ASN. Changing the local AS at the global level in an active BGP instance causes BGP to re-establish the peer relationships with all peers in the group with the new local ASN. Changing the local AS at the neighbor level in an active BGP instance causes BGP to re-establish the peer relationship with the new local ASN.

This is an optional command and can be used in the following situation.

Example: Provider router P is moved from AS1 to AS2. The customer router that is connected to P, however, is configured to belong to AS1. To avoid reconfiguring the customer router, the local-as value on router P can be set to AS1. Therefore, router P adds AS1 to the as-path message for routes it advertises to the customer router.

The no form of this command used at the global level will remove any virtual ASN configured.

The no form of this command used at the group level reverts to the value defined at the global level.

The no form of this command used at the neighbor level reverts to the value defined at the group level.

Default 

no local-as

Parameters 
as-number—
Specifies the virtual autonomous system number expressed as a decimal integer.
Values—
1 to 65535

 

private—
Specifies the local AS is hidden in paths learned from the peering.

local-preference

Syntax 
local-preference local-preference
no local-preference
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables the context to set the BGP local-preference attribute in incoming routes if not specified and configures the default value for the attribute.

This value is used if the BGP route arrives from a BGP peer without the local-preference integer set.

The specified value can be overridden by any value set via a route policy. This configuration parameter can be set at three levels: global level (applies to all peers), group level (applies to all peers in peer-group) or neighbor level (only applies to specified peer). The most specific value is used.

The no form of this command at the global level specifies that incoming routes with local-preference set are not overridden and routes arriving without local-preference set are interpreted as if the route had local-preference value of 100.

The no form of this command used at the group level reverts to the value defined at the global level.

The no form of this command used at the neighbor level reverts to the value defined at the group level.

Default 

no local-preference

Parameters 
local-preference—
Specifies the local preference value to be used as the override value expressed as a decimal integer.
Values—
0 to 4294967295

 

loop-detect

Syntax 
loop-detect {drop-peer | discard-route | ignore-loop | off}
no loop-detect
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures how the BGP peer session handles loop detection in the AS path.

This configuration parameter can be set at three levels: global level (applies to all peers), group level (applies to all peers in peer-group) or neighbor level (only applies to specified peer). The most specific value is used.

Dynamic configuration changes of loop-detect are not recognized.

The no form of this command used at the global level reverts to default, which is loop-detect ignore-loop.

The no form of this command used at the group level reverts to the value defined at the global level.

The no form of this command used at the neighbor level reverts to the value defined at the group level.

Default 

loop-detect ignore-loop

Parameters 
drop-peer—
Specifies to send a notification to the remote peer and drops the session.
discard-route—
Specifies to discards routes received from a peer with the same ASN as the router. This option prevents routes looped back to the router from being added to the routing information base and consuming memory. When this option is changed, the change will not be active for an established peer until the connection is re-established for the peer.
ignore-loop—
Specifies to ignore routes with loops in the AS path but maintains peering.
off—
Disables loop detection.

med-out

Syntax 
med-out {number | igp-cost}
no med-out
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables advertising the Multi-Exit Discriminator (MED) and assigns the value used for the path attribute for the MED advertised to BGP peers if the MED is not already set.

The specified value can be overridden by any value set through a route policy.

This configuration parameter can be set at three levels: global level (applies to all peers), group level (applies to all peers in peer-group) or neighbor level (only applies to specified peer). The most specific value is used.

The no form of this command used at the global level reverts to default where the MED is not advertised.

The no form of this command used at the group level reverts to the value defined at the global level.

The no form of this command used at the neighbor level reverts to the value defined at the group level.

Default 

no med-out

Parameters 
number—
Specifies the MED path attribute value expressed as a decimal integer.
Values—
0 to 4294967295

 

igp-cost—
Specifies that the MED is set to the IGP cost of the specific IP prefix.

min-as-origination

Syntax 
min-as-origination seconds
no min-as-origination
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures the minimum interval, in seconds, at which a path attribute, originated by the local router, can be advertised to a peer.

This configuration parameter can be set at three levels: global level (applies to all peers), group level (applies to all peers in peer-group) or neighbor level (only applies to specified peer). The most specific value is used.

The no form of this command used at the global level reverts to default.

The no form of this command used at the group level reverts to the value defined at the global level.

The no form of this command used at the neighbor level reverts to the value defined at the group level.

Default 

min-as-origination15

Parameters 
seconds—
Specifies the minimum path attribute advertising interval, in seconds, expressed as a decimal integer.
Values—
2 to 255

 

min-route-advertisement

Syntax 
min-route-advertisement seconds
no min-route-advertisement
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures the minimum interval, in seconds, at which a prefix can be advertised to a peer.

This configuration parameter can be set at three levels: global level (applies to all peers), group level (applies to all peers in peer-group) or neighbor level (only applies to specified peer). The most specific value is used.

The no form of this command used at the global level reverts to the default.

The no form of this command used at the group level reverts to the value defined at the global level.

The no form of this command used at the neighbor level reverts to the value defined at the group level.

Default 

min-route-advertisement 30

Parameters 
seconds—
Specifies the minimum route advertising interval, in seconds, expressed as a decimal integer.
Values—
1 to 255

 

multihop

Syntax 
multihop ttl-value
no multihop
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures the time to live (TTL) value entered in the IP header of packets sent to an EBGP peer multiple hops away.

The no form of this command is used to convey to the BGP instance that the EBGP peers are directly connected.

The no form of this command used at the global level reverts to default.

The no form of this command used at the group level reverts to the value defined at the global level.

The no form of this command used at the neighbor level reverts to the value defined at the group level.

Default 

multihop 1 (EBGP peers are directly connected)

multihop 64 (IBGP)

Parameters 
ttl-value—
Specifies the TTL value expressed as a decimal integer.
Values—
1 to 255

 

next-hop-resolution

Syntax 
next-hop-resolution
Context 
config>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables the context to configure next-hop resolution.

label-route-transport-tunnel

Syntax 
label-route-transport-tunnel
Context 
config>router>bgp>next-hop-resolution
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables the context to configure the binding of BGP labeled routes to tunnels.

family

Syntax 
family family
Context 
config>router>bgp>next-hop-res>label-route-transport-tunnel
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures the binding of BGP labeled routes to tunnels for a specific family.

Default 

family ipv4

Parameters 
family—
Specifies the family.
Values—
ipv4 — Specifies tunnels for the IPv4 family.
ipv6 — Specifies tunnels for the IPv6 family.
vpn — Specifies tunnels for the VPN family.

 

resolution

Syntax 
resolution {any | filter | disabled}
Context 
config>router>bgp>next-hop-res>lbl-rt-tunn>family
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures the resolution state of BGP labeled routes using tunnels to BGP peers.

Default 

resolution filter

Parameters 
any—
Keyword that enables binding to any supported tunnel type in the BGP labeled route context following the TTM preference.
filter—
Keyword that enables binding to the subset of tunnel types configured under the resolution-filter context.
disabled—
Keyword that disables the resolution of BGP labeled routes using tunnels to BGP peers.

resolution-filter

Syntax 
resolution-filter
Context 
config>router>bgp>next-hop-res>lbl-rt-tunn>family
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables the context to configure the subset of tunnel types that can be used in the resolution of BGP label routes.

ldp

Syntax 
[no] ldp
Context 
config>router>bgp>next-hop-res>lbl-rt-tunn>family>resolution-filter
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures LDP tunneling for next-hop resolution.

rsvp

Syntax 
[no] rsvp
Context 
config>router>bgp>next-hop-res>lbl-rt-tunn>family>resolution-filter
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures RSVP tunneling for next-hop resolution.

Default 

no rsvp

sr-isis

Syntax 
[no] sr-isis
Context 
config>router>bgp>next-hop-res>lbl-rt-tunn>family>resolution-filter
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command selects the SR tunnel type programmed by an IS-IS instance in the TTM for next-hop resolution and specifies SR tunnels (shortest path) to destinations reachable by the IS-IS protocol. This command allows BGP to use the SR tunnel in the tunnel table submitted by the lowest preference IS-IS instance or, in the case of IS-IS instances with the same lowest preference, the IS-IS instance with the lowest ID number.

The no form of this command removes the SR tunnel type.

sr-ospf

Syntax 
[no] sr-ospf
Context 
config>router>bgp>next-hop-res>lbl-rt-tunn>family>resolution-filter
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command selects the SR tunnel type programmed by an OSPF instance in the TTM for next-hop resolution and specifies SR tunnels (shortest path) to destinations reachable by the OSPF protocol. This command allows BGP to use the SR tunnel in the tunnel table submitted by the lowest preference OSPF instance or, in the case of IS-IS instances with the same lowest preference, the OSPF instance with the lowest ID number.

The no form of this command removes the SR tunnel type.

outbound-route-filtering

Syntax 
[no] outbound-route-filtering
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command opens the configuration tree for sending or accepting BGP filter lists from peers (outbound route filtering).

Default 

no outbound-route-filtering

extended-community

Syntax 
[no] extended-community
Context 
config>router>bgp>orf
config>router>bgp>group>orf
config>router>bgp>group>neighbor>orf
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command opens the configuration tree for sending or accepting extended community-based BGP filters.

In order for the no version of the command to work, all subcommands (send-orf, accept-orf) must be removed first.

accept-orf

Syntax 
[no] accept-orf
Context 
config>router>bgp>orf>ext-comm
config>router>bgp>group>orf>ext-comm
config>router>bgp>group>neighbor>orf>ext-comm
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command instructs the router to negotiate the receive capability in the BGP outbound route filtering (ORF) negotiation with a peer, and to accept filters that the peer wishes to send.

Accepting ORFs is not enabled by default.

The no form of this command causes the router to remove the accept capability in the BGP ORF negotiation with a peer, and to clear any existing ORF filters that are currently in place.

send-orf

Syntax 
send-orf [comm-id...(up to 32 max)]
no send-orf [comm-id]
Context 
config>router>bgp>orf>ext-comm
config>router>bgp>group>orf>ext-comm
config>router>bgp>group>neighbor>orf>ext-comm
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command instructs the router to negotiate the send capability in the BGP ORF negotiation with a peer.

This command also causes the router to send a community filter, prefix filter, or AS path filter configured as an inbound filter on the BGP session to its peer as an ORF Action ADD.

If the comm-id parameters are not exclusively route target communities, the router will extract appropriate route targets and use those. If, for some reason, the comm-id parameters specified contain no route targets, the router will not send an ORF.

The no form of this command causes the router to remove the send capability in the BGP ORF negotiation with a peer. The no form also causes the router to send an ORF remove action for a community filter, prefix filter, or AS path filter configured as an inbound filter on the BGP session to its peer.

Default 

no send-orf

Parameters 
comm-id—
Specifies a community policy that consists exclusively of route target extended communities. If it is not specified, the ORF policy is automatically generated from configured route target lists, accepted client route target ORFs, and locally configured route targets.

neighbor

Syntax 
[no] neighbor ip-address
Context 
config>router>bgp>group
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command creates a BGP peer/neighbor instance within the context of the BGP group.

This command can be issued repeatedly to create multiple peers and their associated configuration.

The no form of this command is used to remove the specified neighbor and the entire configuration associated with the neighbor. The neighbor must be administratively shutdown before attempting to delete it. If the neighbor is not shutdown, the command will not result in any action except a warning message on the console indicating that neighbor is still administratively up.

Parameters 
ip-address—
Specifies the IP address of the BGP peer router.
Values—

ipv4-address:

a.b.c.d (host bits must be 0)

ipv4-prefix-length:

0 to 32

ipv6-address:

x:x:x:x:x:x:x:x (eight 16-bit pieces)

x:x:x:x:x:x:d.d.d.d

x: [0 to FFFF]H

d: [0 to 255]D

 

peer-as

Syntax 
peer-as as-number
Context 
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures the autonomous system number for the remote peer. The peer ASN must be configured for each configured peer.

For eBGP peers, the peer ASN configured must be different from the autonomous system number configured for this router under the global level since the peer will be in a different autonomous system than this router

For iBGP peers, the peer ASN must be the same as the ASN of this router configured under the global level.

This is required command for each configured peer. This may be configured under the group level for all neighbors in a particular group.

Parameters 
as-number—
Specifies the autonomous system number expressed as a decimal integer.
Values—
1 to 4294967295

 

path-mtu-discovery

Syntax 
[no] path-mtu-discovery
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables path MTU discovery for the associated TCP connections. In doing so, the MTU for the associated TCP session will be initially set to the egress interface MTU. The DF bit will also be set so that if a router along the path of the TCP connection cannot handle a packet of a particular size without fragmenting, it will send back an ICMP message to set the path MTU for the specific session to a lower value that can be forwarded without fragmenting.

The no form of this command disables path MTU discovery.

Default 

no path-mtu-discovery

preference

Syntax 
[no] preference preference
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures the route preference for routes learned from the configured peers.

This configuration parameter can be set at three levels: global level (applies to all peers), group level (applies to all peers in peer-group) or neighbor level (only applies to specified peer). The most specific value is used.

The lower the preference the higher the chance of the route being the active route. The 7210 SAS assigns BGP routes the highest default preference compared to routes that are direct, static, or learned through MPLS or OSPF.

The no form of this command used at the global level reverts to default value.

The no form of this command used at the group level reverts to the value defined at the global level.

The no form of this command used at the neighbor level reverts to the value defined at the group level.

Default 

preference 170

Parameters 
preference—
Specifies the route preference expressed as a decimal integer.
Values—
1 to 255

 

purge-timer

Syntax 
[no] purge-timer minutes
Context 
config>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures the maximum time before stale routes are purged.

Parameters 
minutes—
Specifies the duration of the purge timer, in minutes.
Values—
1 to 60

 

rapid-withdrawal

Syntax 
[no] rapid-withdrawal
Context 
config>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command disables the delay (Minimum Route Advertisement) on sending BGP withdrawals. Normal route withdrawals may be delayed up to the minimum route advertisement to allow for efficient packing of BGP updates.

The no form of this command removes the configuration and reverts withdrawal processing to the normal behavior.

Default 

no rapid-withdrawal

prefix-limit

Syntax 
prefix-limit limit [log-only] [threshold percent]
no prefix-limit
Context 
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures the maximum number of routes BGP can learn from a peer.

When the number of routes reaches 90% of this limit, an SNMP trap is sent. When the limit is exceeded, the BGP peering is dropped and disabled.

The no form of this command removes the configuration.

Default 

no prefix-limit

Parameters 
log-only—
Keyword to enable the warning message to be sent at the specified threshold percentage, and also when the limit is exceeded. However, the BGP peering is not dropped.
percent—
Specifies the threshold value (as a percentage) that triggers a warning message to be sent
Values—
1 to 100

 

limit—
Specifies the number of routes that can be learned from a peer expressed as a decimal integer
Values—
1 to 4294967295

 

remove-private

Syntax 
[no] remove-private {limited}
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables private AS numbers to be removed from the AS path before advertising them to BGP peers.

When the remove-private command is configures at the global level, it applies to all peers, regardless of group or neighbor configuration. When the parameter is set at the group level, it applies to all peers in the group, regardless of the neighbor configuration.

7210 SAS software recognizes the set of AS numbers that are defined by the Internet Assignment Numbers Authority (IANA) as private. These are AS numbers in the range 64512 through 65535, inclusive.

The no form of this command used at the global level reverts to default value.

The no form of this command used at the group level reverts to the value defined at the global level.

The no form of this command used at the neighbor level reverts to the value defined at the group level.

Default 

no remove-private

Parameters 
limited—
Optional keyword to remove private ASNs up to the first public ASN encountered. It then stops removing private ASNs.

router-id

Syntax 
router-id ip-address
no router-id
Context 
config>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command specifies the router ID to be used with this BGP instance.

Changing the BGP router ID on an active BGP instance causes the BGP instance to restart with the new router ID. The router ID must be set to a valid host address.

By default, the system interface IP address is used.

Parameters 
ip-address—
Specifies the router ID, expressed in dotted-decimal notation. The allowed value is a valid routable IP address on the router, either an interface or system IP address. It is highly recommended that this address be the system IP address.
Values—
a.b.c.d

 

shutdown

Syntax 
[no] shutdown
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command administratively disables an entity. When disabled, an entity does not change, reset, or remove any configuration settings or statistics.

The operational state of the entity is disabled as well as the operational state of any entities contained within. Many objects must be shut down before they may be deleted.

Unlike other commands and parameters where the default state is not indicated in the configuration file, the shutdown and no shutdown states are always indicated in system generated configuration files.

Default administrative states for services and service entities are described in Special Cases.

The no form of this command places an entity in an administratively enabled state.

Special Cases 
BGP Global—
The BGP protocol is created in the no shutdown state.
BGP Group—
BGP groups are created in the no shutdown state.
BGP Neighbor—
BGP neighbors/peers are created in the no shutdown state.

type

Syntax 
[no] type {internal | external}
Context 
config>router>bgp>group
config>router>bgp>group>neighbor
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command designates the BGP peer as type internal or external.

The type internal indicates that the peer is an iBGP peer while the type external indicates that the peer is an eBGP peer.

By default, 7210 SAS derives the type of neighbor based on the local AS specified. If the local AS specified is the same as the AS of the router, the peer is considered internal. If the local AS is different, the peer is considered external.

The no form of this command used at the group level reverts to the default value.

The no form of this command used at the neighbor level reverts to the value defined at the group level.

Default 

no type

Parameters 
internal—
Keyword to configure the peer as internal.
external—
Keyword to configure the peer as external.

5.9.2.2. Other BGP-Related Commands

autonomous-system

Syntax 
autonomous-system autonomous-system
no autonomous-system
Context 
config>router
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures the AS number for the router. A router can only belong to one AS. An ASN is a globally unique number with an AS. This number is used to exchange exterior routing information with neighboring ASs and as an identifier of the AS.

If the ASN is changed on a router with an active BGP instance, the new ASN is not used until the BGP instance is restarted either by administratively disabling or enabling (shutdown/no shutdown) the BGP instance or rebooting the system with the new configuration.

Parameters 
as-number—
Specifies the ASN, expressed as a decimal integer.
Values—
1 to 4294967295

 

router-id

Syntax 
router-id ip-address
no router-id
Context 
config>router
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures the router ID for the router instance.

The router ID is used by both OSPF and BGP routing protocols in this instance of the routing table manager.

When a new router ID is configured, protocols are not automatically restarted with the new router ID. The next time a protocol is initialized, the new router ID is used. This can result in an interim period of time when different protocols use different router IDs.

To force the new router ID to be used, issue the shutdown and no shutdown commands for each protocol that uses the router ID, or restart the entire router.

By default, the system uses the system interface address (which is also the loopback address).

If a system interface address is not configured, use the last 32 bits of the chassis MAC address.

The no form of this command reverts to the default value.

Parameters 
ip-address—
Specifies the router ID, expressed in dotted-decimal notation. The allowed value is a valid routable IP address on the router, either an interface or system IP address. It is highly recommended that this address be the system IP address.
Values—
a.b.c.d

 

5.9.2.3. Show Commands

router

Syntax 
router [router-instance]
Context 
show
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command displays router instance information.

Parameters 
router-instance—
Specifies either the router name or service ID.
Values—
router-instance: Base, management

 

Default—
Base, Management

bgp

Syntax 
bgp
Context 
show>router
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables the context to display BGP related information.

auth-keychain

Syntax 
auth-keychain keychain
Context 
show>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command displays BGP sessions using a specific authentication keychain.

Parameters 
keychain—
Specifies an existing keychain name, up to 32 characters.
Output 

The following output is an example of authentication keychain information, and Table 64 describes the output fields.

Sample Output — auth-keychain
*A:ALA-48# show router 2 bgp auth-keychain
===============================================================================
Sessions using key chains
===============================================================================
Peer address             Group               Keychain name
-------------------------------------------------------------------------------
10.20.1.3                1                   eta_keychain1
30.1.0.2                 1                   eta_keychain1
===============================================================================
*A:ALA-48# 
*A:ALA-48>config>router>bgp# show router bgp group "To_AS_10000"
===============================================================================
BGP Group : To_AS_10000
-------------------------------------------------------------------------------
Group            : To_AS_10000
-------------------------------------------------------------------------------
Group Type       : No Type              State            : Up
Peer AS          : 10000                Local AS         : 200
Local Address    : n/a                  Loop Detect      : Ignore
Import Policy    : None Specified / Inherited
Hold Time        : 90                   Keep Alive       : 30
NLRI             : Unicast              Preference       : 170
TTL Security     : Disabled             Min TTL Value    : n/a
Graceful Restart : Enabled              Stale Routes Time: 360
Auth key chain   : testname
 
List of Peers
- 10.0.0.8 :
    To_Router B - EBGP Peer
Total Peers      : 1                    Established      : 0
-------------------------------------------------------------------------------
Peer Groups : 1
===============================================================================
*A:ALA-48>config>router>bgp#
 
 
*A:Dut-b>config>router>
 
*A:ALA-48>config>router>bgp# show router bgp neighbor 10.0.0.8
===============================================================================
BGP Neighbor
-------------------------------------------------------------------------------
Peer  : 10.0.0.8
Group : To_AS_10000
-------------------------------------------------------------------------------
Peer AS              : 10000            Peer Port            : 0
Peer Address         : 10.0.0.8
Local AS             : 200              Local Port           : 0
Local Address        : 0.0.0.0
Peer Type            : External
State                : Active           Last State           : Idle
Last Event           : stop
Last Error           : Cease
Local Family         : IPv4
Remote Family        : Unused
Hold Time            : 90               Keep Alive           : 30
Active Hold Time     : 0                Active Keep Alive    : 0
Preference           : 99               Num of Flaps         : 0
Recd. Paths          : 0
IPv4 Recd. Prefixes  : 0                IPv4 Active Prefixes : 0
IPv4 Suppressed Pfxs : 0                VPN-IPv4 Suppr. Pfxs : 0
VPN-IPv4 Recd. Pfxs  : 0                VPN-IPv4 Active Pfxs : 0
Mc IPv4 Recd. Pfxs.  : 0                Mc IPv4 Active Pfxs. : 0
Mc IPv4 Suppr. Pfxs  : 0 
Input Queue          : 0                Output Queue         : 0
i/p Messages         : 0                o/p Messages         : 0
i/p Octets           : 0                o/p Octets           : 0
i/p Updates          : 0                o/p Updates          : 0
TTL Security         : Disabled         Min TTL Value        : n/a
Graceful Restart     : Enabled          Stale Routes Time    : 360
Advertise Inactive   : Disabled         Peer Tracking        : Disabled
Advertise Label      : None
Auth key chain       : testname
Local Capability     : RouteRefresh MP-BGP
Remote Capability    :
Import Policy        : None Specified / Inherited
-------------------------------------------------------------------------------
Neighbors : 1
===============================================================================
*A:ALA-48>config>router>bgp#
 
*A:ALA-48>config>router>bgp# show router bgp auth-keychain testname
=========================================================================
Sessions using key chain: keychain
=========================================================================
Peer address             Group               Keychain name
-------------------------------------------------------------------------
10.0.0.8                 To_AS_10000         testname
=========================================================================
*A:ALA-48>config>router>bgp#
Table 64:  Output Fields: BGP Auth-keychain 

Label

Description

Peer address

Displays the IP address of the peer

Group

Displays the BGP group name

Keychain name

Displays the authentication keychain associated with the session, if applicable

damping

Syntax 
damping [ip-prefix [/ip-prefix-length]] [damp-type] [detail] [ipv4]
damping [ip-prefix [/ip-prefix-length]] [damp-type] [detail] [ipv6]
damping [ip-prefix [/ip-prefix-length]] [damp-type] [detail] [vpn-ipv4]
damping [ip-prefix [/ip-prefix-length]] [damp-type] [detail] [vpn-ipv6]
Context 
show>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command displays BGP routes that have been dampened due to route flapping. This command can be entered with or without a route parameter. If no parameters are included, all dampened routes are listed.

When the keyword detail is included, more detailed information is displayed.

If a damp-type is specified, only those types of dampened routes (decayed, history, or suppressed) are displayed. Routes that have a state of decayed have gained penalties for flapping but have not yet reached the suppression limit. Routes that have a state of history have had a route flap and have been withdrawn. Routes that have a state of suppressed have reached the suppression limit and are not considered in BGP path selection.

Parameters 
ip-prefix/ip-prefix-length—
Displays damping information for the specified IP address.
Values—

ipv4-prefix:

a.b.c.d (host bits must be 0)

ipv4-prefix-length:

0 to 32

ipv6-prefix:

x:x:x:x:x:x:x:x (eight 16-bit pieces)

x:x:x:x:x:x:d.d.d.d

x: [0 to FFFF]H

d: [0 to 255]D

ipv6-prefix-length:

0 to 128

 

damp-type—
Displays damping information for routes with the specified damp type.
Values—
decayed, history, suppressed.

 

detail—
Displays detailed information.
ipv4—
Displays dampened routes for the IPv4 address family.
ipv6—
Displays dampened routes for the IPv6 address family.
vpn-ipv4—
Displays dampened routes for the VPN-IPv4 address family.
vpn-ipv6—
Displays dampened routes for the VPN-IPv6 address family.
Output 

The following output is an example of BGP damping information, and Table 65 describes the output fields.

Sample Output
A:ALA-12# show router bgp damping 
===============================================================================
  BGP Router ID : 10.0.0.14         AS : 65206   Local AS : 65206
===============================================================================
  Legend -
  Status codes  : u - used, s - suppressed, h - history, d - decayed, * - valid
  Origin codes  : i - IGP, e - EGP, ? - incomplete,  - best
===============================================================================
BGP Damped Routes
===============================================================================
Flag  Network            From            Reuse       AS-Path 
-------------------------------------------------------------------------------
ud*i  10.149.7.0/24      10.0.28.1       00h00m00s   60203 65001 19855 3356
                                                      1239  22406 
si    10.155.6.0/23      10.0.28.1       00h43m41s   60203 65001 19855 3356
                                                      2914  7459 
si    10.155.8.0/22      10.0.28.1       00h38m31s   60203 65001 19855 3356
                                                      2914  7459 
si    10.155.12.0/22     10.0.28.1       00h35m41s   60203 65001 19855 3356
                                                      2914  7459 
si    10.155.22.0/23     10.0.28.1       00h35m41s   60203 65001 19855 3356
                                                      2914  7459 
si    10.155.24.0/22     10.0.28.1       00h35m41s   60203 65001 19855 3356
                                                      2914  7459 
si    10.155.28.0/22     10.0.28.1       00h34m31s   60203 65001 19855 3356
                                                      2914  7459 
si    10.155.40.0/21     10.0.28.1       00h28m24s   60203 65001 19855 3356
                                                      7911  7459 
si    10.155.48.0/20     10.0.28.1       00h28m24s   60203 65001 19855 3356
                                                      7911  7459 
ud*i  10.8.140.0/24      10.0.28.1       00h00m00s   60203 65001 19855 3356
                                                      4637  17447 
ud*i  10.8.141.0/24      10.0.28.1       00h00m00s   60203 65001 19855 3356
                                                      4637  17447 
ud*i  10.9.0.0/18        10.0.28.1       00h00m00s   60203 65001 19855 3356
                                                      3561  9658  6163 
. . .
ud*i  10.213.184.0/23    10.0.28.1       00h00m00s   60203 65001 19855 3356
                                                      6774  6774  9154 
-------------------------------------------------------------------------------
A:ALA-12#
 
A:ALA-12# show router bgp damping detail 
===============================================================================
  BGP Router ID : 10.0.0.14         AS : 65206   Local AS : 65206
===============================================================================
  Legend -
  Status codes  : u - used, s - suppressed, h - history, d - decayed, * - 
 valid
  Origin codes  : i - IGP, e - EGP, ? - incomplete,  - best
===============================================================================
BGP Damped Routes
===============================================================================
-------------------------------------------------------------------------------
Network : 10.149.7.0/24
-------------------------------------------------------------------------------
Network          : 10.149.7.0/24        Peer             : 10.0.28.1
NextHop          : 10.0.28.1            Reuse time       : 00h00m00s
Peer AS          : 60203                Peer Router-Id   : 32.32.27.203
Local Pref       : none
Age              : 00h22m09s            Last update      : 02d00h58m
FOM Present      : 738                  FOM Last upd.    : 2039
Number of Flaps  : 2                    Flags            : ud*i
Path             : 60203 65001 19855 3356  1239  22406
Applied Policy   : default-damping-profile
-------------------------------------------------------------------------------
Network : 10.142.48.0/20
-------------------------------------------------------------------------------
Network          : 10.142.48.0/20       Peer             : 10.0.28.1
NextHop          : 10.0.28.1            Reuse time       : 00h00m00s
Peer AS          : 60203                Peer Router-Id   : 32.32.27.203
Local Pref       : none
Age              : 00h00m38s            Last update      : 02d01h20m
FOM Present      : 2011                 FOM Last upd.    : 2023
Number of Flaps  : 2                    Flags            : ud*i
Path             : 60203 65001 19855 3356  3561  5551  1889
Applied Policy   : default-damping-profile
-------------------------------------------------------------------------------
Network : 10.200.128.0/19
-------------------------------------------------------------------------------
Network          : 10.200.128.0/19      Peer             : 10.0.28.1
NextHop          : 10.0.28.1            Reuse time       : 00h00m00s
Peer AS          : 60203                Peer Router-Id   : 32.32.27.203
Local Pref       : none
Age              : 00h00m38s            Last update      : 02d01h20m
FOM Present      : 2011                 FOM Last upd.    : 2023
Number of Flaps  : 2                    Flags            : ud*i
Path             : 60203 65001 19855 1299  702   1889
Applied Policy   : default-damping-profile
-------------------------------------------------------------------------------
Network : 10.203.192.0/18
-------------------------------------------------------------------------------
Network          : 10.203.192.0/18      Peer             : 10.0.28.1
NextHop          : 10.0.28.1            Reuse time       : 00h00m00s
Peer AS          : 60203                Peer Router-Id   : 32.32.27.203
Local Pref       : none
Age              : 00h00m07s            Last update      : 02d01h20m
FOM Present      : 1018                 FOM Last upd.    : 1024
Number of Flaps  : 1                    Flags            : ud*i
Path             : 60203 65001 19855 1299  702   1889
Applied Policy   : default-damping-profile
-------------------------------------------------------------------------------
A:ALA-12#
A:ALA-12# show router bgp damping 10.203.192.0/18 detail
===============================================================================
  BGP Router ID : 10.0.0.14         AS : 65206   Local AS : 65206
===============================================================================
  Legend -
  Status codes  : u - used, s - suppressed, h - history, d - decayed, * - valid
  Origin codes  : i - IGP, e - EGP, ? - incomplete,  - best
===============================================================================
BGP Damped Routes 15.203.192.0/18
===============================================================================
-------------------------------------------------------------------------------
Network : 10.203.192.0/18
-------------------------------------------------------------------------------
Network          : 10.203.192.0/18      Peer             : 10.0.28.1
NextHop          : 10.0.28.1            Reuse time       : 00h00m00s
Peer AS          : 60203                Peer Router-Id   : 32.32.27.203
Local Pref       : none
Age              : 00h00m42s            Last update      : 02d01h20m
FOM Present      : 2003                 FOM Last upd.    : 2025
Number of Flaps  : 2                    Flags            : ud*i
Path             : 60203 65001 19855 3356  702   1889
Applied Policy   : default-damping-profile
-------------------------------------------------------------------------------
Paths : 1
===============================================================================
A:ALA-12#
 
 
A:ALA-12# show router bgp damping suppressed detail      
===============================================================================
  BGP Router ID : 10.0.0.14         AS : 65206   Local AS : 65206
===============================================================================
  Legend -
  Status codes  : u - used, s - suppressed, h - history, d - decayed, * - valid
  Origin codes  : i - IGP, e - EGP, ? - incomplete,  - best
===============================================================================
BGP Damped Routes (Suppressed)
===============================================================================
-------------------------------------------------------------------------------
Network : 10.142.48.0/20
-------------------------------------------------------------------------------
Network          : 10.142.48.0/20       Peer             : 10.0.28.1
NextHop          : 10.0.28.1            Reuse time       : 00h29m22s
Peer AS          : 60203                Peer Router-Id   : 32.32.27.203
Local Pref       : none
Age              : 00h01m28s            Last update      : 02d01h20m
FOM Present      : 2936                 FOM Last upd.    : 3001
Number of Flaps  : 3                    Flags            : si
Path             : 60203 65001 19855 3356  702   1889
Applied Policy   : default-damping-profile
-------------------------------------------------------------------------------
Network : 10.200.128.0/19
-------------------------------------------------------------------------------
Network          : 10.200.128.0/19      Peer             : 10.0.28.1
NextHop          : 10.0.28.1            Reuse time       : 00h29m22s
Peer AS          : 60203                Peer Router-Id   : 32.32.27.203
Local Pref       : none
Age              : 00h01m28s            Last update      : 02d01h20m
FOM Present      : 2936                 FOM Last upd.    : 3001
Number of Flaps  : 3                    Flags            : si
Path             : 60203 65001 19855 3356  702   1889
Applied Policy   : default-damping-profile
-------------------------------------------------------------------------------
Network : 10.203.240.0/20
-------------------------------------------------------------------------------
Network          : 10.203.240.0/20      Peer             : 10.0.28.1
NextHop          : 10.0.28.1            Reuse time       : 00h29m22s
Peer AS          : 60203                Peer Router-Id   : 32.32.27.203
Local Pref       : none
Age              : 00h01m28s            Last update      : 02d01h20m
FOM Present      : 2936                 FOM Last upd.    : 3001
Number of Flaps  : 3                    Flags            : si
Path             : 60203 65001 19855 3356  702   1889
Applied Policy   : default-damping-profile
-------------------------------------------------------------------------------
Network : 10.206.0.0/17
-------------------------------------------------------------------------------
Network          : 10.206.0.0/17        Peer             : 10.0.28.1
NextHop          : 10.0.28.1            Reuse time       : 00h29m22s
Peer AS          : 60203                Peer Router-Id   : 32.32.27.203
Local Pref       : none
Age              : 00h01m28s            Last update      : 02d01h20m
FOM Present      : 2936                 FOM Last upd.    : 3001
Number of Flaps  : 3                    Flags            : si
Path             : 60203 65001 19855 3356  702   1889
Applied Policy   : default-damping-profile
-------------------------------------------------------------------------------
A:ALA-12#
Table 65:  Output Fields: Router BGP Damping  

Label

Description

BGP Router ID

Displays the local BGP router ID

The local BGP router ID.

Displays the configured ASN

Local AS

Displays the configured or inherited local AS for the specified peer group. If not configured, it is the same value as the AS.

Network

Displays the route IP prefix and mask length for the route

Flag(s)

Legend:

Status codes: u- used, s-suppressed, h-history, d-decayed, *-valid. If a * is not present, then the status is invalid.

Origin codes: i-IGP, e-EGP, ?-incomplete, >-best

From

Displays the originator ID path attribute value

Reuse time

Displays the time when a suppressed route can be used again

From

Displays the originator ID path attribute value

Reuse time

Displays the time when a suppressed route can be used again

AS Path

Displays the BGP AS path for the route

Peer

Displays the router ID of the advertising router

NextHop

Displays the BGP next hop for the route

Peer AS

Displays the ASN of the advertising router

Peer Router-Id

Displays the router ID of the advertising router

Local Pref

Displays the BGP local preference path attribute for the route

Age

Displays the length of time in the hour/minute/second (HH:MM:SS) format.

Last update

Displays the time when BGP was updated last in the day/hour/minute (DD:HH:MM) format

FOM Present

Displays the current Figure of Merit (FOM) value

Number of Flaps

Displays the number of route flaps in the neighbor connection

Path

Displays the BGP AS path for the route

Applied Policy

Displays the applied route policy name

group

Syntax 
group [name] [detail]
Context 
show>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command displays group information for a BGP peer group. This command can be entered with or without parameters.

When this command is entered without a group name, information about all peer groups displays.

When the command is issued with a specific group name, information pertaining to only that specific peer group displays.

The ‘State’ field displays the BGP group operational state. Valid states are the following:

  1. Up
    The BGP global process is configured and running.
  2. Down
    Te BGP global process is administratively shutdown and not running.
  3. Disabled
    The BGP global process is operationally disabled. The process must be restarted by the operator.
Parameters 
name—
Displays information for the specified BGP group, up to 32 characters.
detail—
Displays detailed information.
Output 

The following outputs are examples of BGP group information, and Table 66 describes the output fields:

Sample Output
A:ALA-12# show router bgp group
===============================================================================
BGP Groups 
-------------------------------------------------------------------------------
Group            : To_AS_40000                     
-------------------------------------------------------------------------------
Description      : Not Available
Group Type       : No Type              State            : Up                  
Peer AS          : 40000                Local AS         : 65206               
Local Address    : n/a                  Loop Detect      : Ignore              
Export Policy    : direct2bgp                                                 
Hold Time        : 90                   Keep Alive       : 30                  
NLRI             : Unicast              Preference       : 170                 
 
List of Peers
- 10.0.0.1       : To_Jukebox
- 10.0.0.12      : Not Available
- 10.0.0.13      : Not Available
- 10.0.0.14      : To_SR1
- 10.0.0.15      : To_H-215
 
Total Peers      : 5                    Established      : 2                   
===============================================================================
A:ALA-12#
Sample Detailed Output
A:ALA-12# show router bgp group detail
===============================================================================
BGP Groups (detail)
-------------------------------------------------------------------------------
Group            : To_AS_40000                     
-------------------------------------------------------------------------------
Description      : Not Available
Group Type       : No Type              State            : Up                  
Peer AS          : 40000                Local AS         : 65206               
Local Address    : n/a                  Loop Detect      : Ignore              
Connect Retry    : 20                   Authentication   : None                
Local Pref       : 100                  MED Out          : 0                   
Multihop         : 0 (Default)         
Min Route Advt.  : 30                   Min AS Originate : 15                  
Prefix Limit     : No Limit             Passive          : Disabled            
Next Hop Self    : Disabled             Aggregator ID 0  : Disabled            
Remove Private   : Disabled             Damping          : Disabled            
Export Policy    : direct2bgp                                                 
Hold Time        : 90                   Keep Alive       : 30                  
NLRI             : Unicast              Preference       : 170                 
 
List of Peers
- 10.0.0.1       : To_Jukebox
- 10.0.0.12      : Not Available
- 10.0.0.13      : Not Available
- 10.0.0.14      : To_SR1
- 10.0.0.15      : To_H-215
 
Total Peers      : 5                    Established      : 2                   
===============================================================================
A:ALA-12#
 
 
A:SetupCLI>show>router>bgp# group
===============================================================================
BGP Group
-------------------------------------------------------------------------------
Group            : bgp_group_1 34567890123456789012
-------------------------------------------------------------------------------
Description      : Testing the length of the group value for the DESCRIPTION
                   parameter of BGP
Group Type       : No Type              State            : Up
Peer AS          : n/a                  Local AS         : 100
Local Address    : n/a                  Loop Detect      : Ignore
Import Policy    : test i1
                 : test i2
                 : test i3
                 : test i4
                 : test i5 890123456789012345678901
Export Policy    : test e1
                 : test e2
                 : test e3
                 : test e4
                 : test e5 890123456789012345678901
Hold Time        : 120                  Keep Alive       : 30
NLRI             : Unicast              Preference       : 101
TTL Security     : Disabled             Min TTL Value    : n/a
Graceful Restart : Disabled             Stale Routes Time: n/a
Auth key chain   : n/a                  Bfd Enabled    : Yes
 
List of Peers
- 10.3.3.3 :
    Testing the length of the neighbor value for the DESCRIPTION parameter of
    BGP
Total Peers      : 1                    Established      : 0
-------------------------------------------------------------------------------
Peer Groups : 1
===============================================================================
A:SetupCLI>show>router>bgp#
Table 66:  Output Fields: Router BGP Group  

Label

Description

Group

Displays the BGP group name

Group Type

No Type — Peer type not configured

External — Peer type configured as external BGP peers

Internal — Peer type configured as internal BGP peers

State

Disabled — The BGP peer group has been operationally disabled

Down — The BGP peer group is operationally inactive

Up — The BGP peer group is operationally active

Peer AS

Displays the configured or inherited peer AS for the specified peer group

Local AS

Displays the configured or inherited local AS for the specified peer group

Local Address

Displays the configured or inherited local address for originating peering for the specified peer group

Loop Detect

Displays the configured or inherited loop detect setting for the specified peer group

Connect Retry

Displays the configured or inherited connect retry timer value

Authentication

None — No authentication is configured

MD5 — MD5 authentication is configured

Bfd

Yes — BFD is enabled

No — BFD is disabled

Local Pref

Displays the configured or inherited local preference value

MED Out

Displays the configured or inherited MED value assigned to advertised routes without a MED attribute

Min Route Advt.

Displays the minimum amount of time that must pass between route updates for the same IP prefix

Min AS Originate

Displays the minimum amount of time that must pass between updates for a route originated by the local router

Multihop

Displays the maximum number of router hops a BGP connection can traverse

Prefix Limit

No Limit — No route limit assigned to the BGP peer group

1 to 4294967295 — The maximum number of routes BGP can learn from a peer

Passive

Disabled — BGP attempts to establish a BGP connection with neighbor in the specified peer group

Enabled — BGP will not actively attempt to establish a BGP connection with neighbor in the specified peer group

Next Hop Self

Disabled — BGP is not configured to send only its own IP address as the BGP next hop in route updates to neighbors in the peer group

Enabled — BGP sends only its own IP address as the BGP next hop in route updates to neighbors in the specified peer group

Aggregator ID 0

Disabled — BGP is not configured to set the aggregator ID to 0.0.0.0 in all originated route aggregates sent to the neighbor in the peer group

Enabled — BGP is configured to set the aggregator ID to 0.0.0.0 in all originated route aggregates sent to the neighbor in the peer group

Remove Private

Disabled — BGP will not remove all private AS numbers from the AS path attribute in updates sent to the neighbor in the peer group

Enabled — BGP removes all private AS numbers from the AS path attribute in updates sent to the neighbor in the peer group

Damping

Disabled — The peer group is configured not to dampen route flaps

Enabled — The peer group is configured to dampen route flaps

Export Policy

Displays the configured export policies for the peer group

Import Policy

Displays the configured import policies for the peer group

Hold Time

Displays the configured hold time setting

Keep Alive

Displays the configured keepalive setting

Client Reflect

Disabled — The BGP route reflector will not reflect routes to this neighbor

Enabled — The BGP route reflector is configured to reflect routes to this neighbor

NLRI

Displays the type of NLRI information that the specified peer group can accept

Unicast — IPv4 unicast routing information can be carried

Preference

Displays the configured route preference value for the peer group

List of Peers

Displays a list of BGP peers configured under the peer group

Total Peers

Displays the total number of peers configured under the peer group

Established

Displays the total number of peers that are in an established state

neighbor

Syntax 
neighbor [ip-address [detail]]
neighbor [as-address [detail]]
neighbor ip-address [family] [filter1 [brief]
neighbor ip-number [family] filter2
neighbor as-number [family] filter2
neighbor ip-address orf [filter3]
neighbor ip-address graceful-restart
Context 
show>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command displays BGP neighbor information. This command can be entered with or without any parameters.

When this command is issued without any parameters, information about all BGP peers displays.

When the command is issued with a specific IP address or ASN, information regarding only that specific peer or peers with the same AS displays.

When either received-routes or advertised-routes is specified, the routes received from or sent to the specified peer are listed (see Sample Output for BGP Neighbor Received Routes). This information is not available with SNMP.

When either history or suppressed is specified, the routes learned from those peers that either have a history or are suppressed are listed.

The State field displays the BGP peer protocol state. In addition to the standard protocol states, this field can also display the Disabled operational state, which indicates that the peer is operationally disabled and must be restarted by the operator.

Parameters 
ip-address—
Displays information for the specified IP address.
Values—

ipv4-address:

a.b.c.d (host bits must be 0)

ipv6-address:

x:x:x:x:x:x:x:x[-interface]

x:x:x:x:x:x:d.d.d.d[-interface]

x:

[0 to FFFF]H

d:

[0 to 255]D

interface: 32 characters maximum, mandatory for link local

addresses.

 

as-number—
Displays information for the specified ASN.
Values—
1 to 65535

 

family—
Specifies the type of routing information to be distributed by this peer group.
Values—
ipv4 — Displays only those BGP peers that have the IPv4 family enabled.
vpn-ipv4 — Displays only those BGP peers that have the VPN-IPv4 family enabled.
ipv6 — Displays only those BGP peers that have the IPv6 family enabled.
vpn-ipv6 — Displays only those BGP peers that have the VPN-IPv4 family enabled.

 

filter1—
Displays information for the specified IP address
Values—
received-routes — Displays the number of routes received from this peer.
advertised-routes — Displays the number of routes advertised by this peer.
history — Displays statistics for dampened routes.
suppressed — Displays the number of paths from this peer that have been suppressed by damping.
detail — Displays detailed information pertaining to filter1.

 

filter2—
Displays information for the specified ASN.
Values—
history — Display statistics for dampened routes.
suppressed — Display the number of paths from this peer that have been suppressed by damping.
detail — Displays detailed information pertaining to filter2.

 

brief—
Displays information in a brief format. This parameter is only supported with received-routes and advertised-routes.
orf—
Displays outbound route filtering for the BGP instance. ORF (Outbound Route Filtering) is used to inform a neighbor of targets (using target-list) that it is willing to receive. This mechanism helps lessen the update exchanges between neighbors and saves CPU cycles to process routes that could have been received from the neighbor only to be dropped/ignored.
filter3—
Displays path information for the specified IP address.
Values—
send — Displays the number of paths sent to this peer.
receive — Displays the number of paths received from this peer.

 

graceful-restart —
Displays neighbors configured for graceful restart.
Output 

The following outputs are examples of BGP neighbor information. The associated tables describe the output fields.

Sample Output
*A:7210-SAS>show>router>bgp# neighbor
 
===============================================================================
BGP Neighbor
===============================================================================
-------------------------------------------------------------------------------
Peer  : 1.1.1.1
Group : sample
-------------------------------------------------------------------------------
Peer AS              : 12345            Peer Port            : 0
Peer Address         : 1.1.1.1
Local AS             : 143              Local Port           : 0
Local Address        : 0.0.0.0
Peer Type            : External
State                : Active           Last State           : Connect
Last Event           : openFail
Last Error           : Cease
Local Family         : IPv4 VPN-IPv4
Remote Family        : Unused
Hold Time            : 10000 (strict)   Keep Alive           : 21845
Active Hold Time     : 0                Active Keep Alive    : 0
Cluster Id           : None
Preference           : 10               Num of Flaps         : 0
Recd. Paths          : 0
IPv4 Recd. Prefixes  : 0                IPv4 Active Prefixes : 0
IPv4 Suppressed Pfxs : 0                VPN-IPv4 Suppr. Pfxs : 0
VPN-IPv4 Recd. Pfxs  : 0                VPN-IPv4 Active Pfxs : 0
Mc IPv4 Recd. Pfxs.  : 0                Mc IPv4 Active Pfxs. : 0
Mc IPv4 Suppr. Pfxs  : 0                IPv6 Suppressed Pfxs : 0
IPv6 Recd. Prefixes  : 0                IPv6 Active Prefixes : 0
VPN-IPv6 Recd. Pfxs  : 0                VPN-IPv6 Active Pfxs : 0
VPN-IPv6 Suppr. Pfxs : 0
MVPN-IPv4 Suppr. Pfxs: 0                MVPN-IPv4 Recd. Pfxs : 0
MVPN-IPv4 Active Pfxs: 0
Input Queue          : 0                Output Queue         : 0
i/p Messages         : 0                o/p Messages         : 1
i/p Octets           : 0                o/p Octets           : 0
i/p Updates          : 0                o/p Updates          : 0
TTL Security         : Disabled         Min TTL Value        : n/a
Graceful Restart     : Enabled          Stale Routes Time    : 3600
Advertise Inactive   : Enabled          Peer Tracking        : Enabled
Advertise Label      : None
Auth key chain       : keychain-one
Bfd Enabled          : Disabled         L2 VPN Cisco Interop : Disabled
Local Capability     : RtRefresh MPBGP ORFSendExComm ORFRecvExComm
Remote Capability    :
Import Policy        : abcd
Export Policy        : abcd
 
-------------------------------------------------------------------------------
Peer  : 1.1.3.4
Group : test
-------------------------------------------------------------------------------
Peer AS              : 0                Peer Port            : 0
Peer Address         : 1.1.3.4
Local AS             : 12345            Local Port           : 0
Local Address        : 0.0.0.0
Peer Type            : External
State                : Idle             Last State           : Idle
Last Event           : none
Last Error           : Unrecognized Error
Local Family         : VPN-IPv4
Remote Family        : Unused
Hold Time            : 0 (strict)       Keep Alive           : 0
Active Hold Time     : 0                Active Keep Alive    : 0
Preference           : 10               Num of Flaps         : 0
Recd. Paths          : 0
IPv4 Recd. Prefixes  : 0                IPv4 Active Prefixes : 0
IPv4 Suppressed Pfxs : 0                VPN-IPv4 Suppr. Pfxs : 0
VPN-IPv4 Recd. Pfxs  : 0                VPN-IPv4 Active Pfxs : 0
Mc IPv4 Recd. Pfxs.  : 0                Mc IPv4 Active Pfxs. : 0
Mc IPv4 Suppr. Pfxs  : 0                IPv6 Suppressed Pfxs : 0
IPv6 Recd. Prefixes  : 0                IPv6 Active Prefixes : 0
VPN-IPv6 Recd. Pfxs  : 0                VPN-IPv6 Active Pfxs : 0
VPN-IPv6 Suppr. Pfxs : 0
MVPN-IPv4 Suppr. Pfxs: 0                MVPN-IPv4 Recd. Pfxs : 0
MVPN-IPv4 Active Pfxs: 0
Input Queue          : 0                Output Queue         : 0
i/p Messages         : 0                o/p Messages         : 0
i/p Octets           : 0                o/p Octets           : 0
i/p Updates          : 0                o/p Updates          : 0
TTL Security         : Disabled         Min TTL Value        : n/a
Graceful Restart     : Enabled          Stale Routes Time    : 100
Advertise Inactive   : Enabled          Peer Tracking        : Enabled
Advertise Label      : None
Auth key chain       : n/a
Bfd Enabled          : Enabled          L2 VPN Cisco Interop : Disabled
Local Capability     : RtRefresh MPBGP
Remote Capability    :
Import Policy        : abcd
Export Policy        : abcd
 
-------------------------------------------------------------------------------
*A:7210-SAS>
 
 
 
*A:SetupCLI>show>router>bgp# neighbor
===============================================================================
BGP Neighbor
===============================================================================
Peer  : 3.3.3.3
Group : bgp_group_1 34567890123456789012
-------------------------------------------------------------------------------
Peer AS              : 20               Peer Port            : 0
Peer Address         : 3.3.3.3
Local AS             : 100              Local Port           : 0
Local Address        : 0.0.0.0
Peer Type            : Internal
State                : Active           Last State           : Idle
Last Event           : stop
Last Error           : Cease
Local Family         : IPv4
Remote Family        : Unused
Hold Time            : 10               Keep Alive           : 30
Active Hold Time     : 0                Active Keep Alive    : 0
Preference           : 101              Num of Flaps         : 0
Recd. Paths          : 0
IPv4 Recd. Prefixes  : 0                IPv4 Active Prefixes : 0
IPv4 Suppressed Pfxs : 0                VPN-IPv4 Suppr. Pfxs : 0
VPN-IPv4 Recd. Pfxs  : 0                VPN-IPv4 Active Pfxs : 0
Mc IPv4 Recd. Pfxs.  : 0                Mc IPv4 Active Pfxs. : 0
Mc IPv4 Suppr. Pfxs  : 0 
Input Queue          : 0                Output Queue         : 0
i/p Messages         : 0                o/p Messages         : 0
i/p Octets           : 0                o/p Octets           : 0
i/p Updates          : 0                o/p Updates          : 0
TTL Security         : Disabled         Min TTL Value        : n/a
Graceful Restart     : Enabled          Stale Routes Time    : 360
Advertise Inactive   : Disabled         Peer Tracking        : Enabled
Advertise Label      : None             Bfd Enabled     : Yes 
Auth key chain       : n/a
Local Capability     : RouteRefresh MP-BGP
Remote Capability    :
Import Policy        : test i1
                     : test i2
                     : test i3
                     : test i4
                     : test i5 890123456789012345678901
Export Policy        : test e1
                     : test e2
                     : test e3
                     : test e4
                     : test e5 890123456789012345678901
-------------------------------------------------------------------------------
Neighbors : 1
===============================================================================
 
 
 
*A:Dut-B>config>service# show router bgp neighbor
===============================================================================
BGP Neighbor
===============================================================================
-------------------------------------------------------------------------------
Peer                 : 10.20.1.3
Description          : (Not Specified)
Group                : PEER_TO_C
-------------------------------------------------------------------------------
Peer AS              : 300              Peer Port            : 179  
Peer Address         : 10.20.1.3
Local AS             : 300              Local Port           : 49635
Local Address        : 10.20.1.5
Peer Type            : Internal         
State                : Established      Last State           : Active
Last Event           : recvKeepAlive
Last Error           : Cease (Other Configuration Change)
Local Family         : IPv4
Remote Family        : IPv4
Hold Time            : 90               Keep Alive           : 30   
Min Hold Time        : 0                
Active Hold Time     : 90               Active Keep Alive    : 30   
Cluster Id           : None             
Preference           : 170              Num of Update Flaps  : 20   
Recd. Paths          : 5                
IPv4 Recd. Prefixes  : 10               IPv4 Active Prefixes : 10   
IPv4 Suppressed Pfxs : 0                VPN-IPv4 Suppr. Pfxs : 0    
VPN-IPv4 Recd. Pfxs  : 0                VPN-IPv4 Active Pfxs : 0    
Mc IPv4 Recd. Pfxs.  : 0                Mc IPv4 Active Pfxs. : 0    
Mc IPv4 Suppr. Pfxs  : 0                IPv6 Suppressed Pfxs : 0    
IPv6 Recd. Prefixes  : 0                IPv6 Active Prefixes : 0    
VPN-IPv6 Recd. Pfxs  : 0                VPN-IPv6 Active Pfxs : 0    
VPN-IPv6 Suppr. Pfxs : 0                
Mc IPv6 Recd. Pfxs.  : 0                Mc IPv6 Active Pfxs. : 0    
Mc IPv6 Suppr. Pfxs  : 0                L2-VPN Suppr. Pfxs   : 0    
L2-VPN Recd. Pfxs    : 0                L2-VPN Active Pfxs   : 0    
MVPN-IPv4 Suppr. Pfxs: 0                MVPN-IPv4 Recd. Pfxs : 0    
MVPN-IPv4 Active Pfxs: 0                MDT-SAFI Suppr. Pfxs : 0    
MDT-SAFI Recd. Pfxs  : 0                MDT-SAFI Active Pfxs : 0    
Flow-IPv4 Suppr. Pfxs: 0                Flow-IPv4 Recd. Pfxs : 0    
Flow-IPv4 Active Pfxs: 0                Rte-Tgt Suppr. Pfxs  : 0    
Rte-Tgt Recd. Pfxs   : 0                Rte-Tgt Active Pfxs  : 0    
Backup IPv4 Pfxs     : 0                Backup IPv6 Pfxs     : 0    
Mc Vpn Ipv4 Recd. Pf*: 0                Mc Vpn Ipv4 Active P*: 0    
Mc Vpn Ipv4 Suppr. P*: 0                
Backup Vpn IPv4 Pfxs : 0                Backup Vpn IPv6 Pfxs : 0    
Input Queue          : 0                Output Queue         : 0    
i/p Messages         : 30               o/p Messages         : 26   
i/p Octets           : 1321             o/p Octets           : 470
i/p Updates          : 8                o/p Updates          : 0    
Flow-IPv6 Suppr. Pfxs: 0                Flow-IPv6 Recd. Pfxs : 0    
Flow-IPv6 Active Pfxs: 0                
Evpn Suppr. Pfxs     : 0                Evpn Recd. Pfxs      : 0    
Evpn Active Pfxs     : 0                
MS-PW Suppr. Pfxs    : 0                MS-PW Recd. Pfxs     : 0    
MS-PW Active Pfxs    : 0                
TTL Security         : Disabled         Min TTL Value        : n/a
Graceful Restart     : Disabled         Stale Routes Time    : n/a
Restart Time         : n/a              
Advertise Inactive   : Disabled         Peer Tracking        : Disabled
Advertise Label      : ipv4 
Auth key chain       : n/a
Disable Cap Nego     : Disabled         Bfd Enabled          : Disabled
Flowspec Validate    : Disabled         Default Route Tgt    : Disabled
Aigp Metric          : Enabled          Split Horizon        : Disabled
Damp Peer Oscillatio*: Disabled         Update Errors        : 0    
GR Notification      : Disabled         Fault Tolerance      : Disabled
Rem Idle Hold Time   : 00h00m00s        
Next-Hop Unchanged   : None             
L2 VPN Cisco Interop : Disabled         
Local Capability     : RtRefresh MPBGP 4byte ASN 
Remote Capability    : RtRefresh MPBGP 4byte ASN 
Local AddPath Capabi*: Disabled
Remote AddPath Capab*: Send - None
                     : Receive - None
Import Policy        : None Specified / Inherited
Export Policy        : None Specified / Inherited
Origin Validation    : N/A
EBGP Link Bandwidth  : n/a
IPv4 Rej. Pfxs       : 0                IPv6 Rej. Pfxs       : 0    
VPN-IPv4 Rej. Pfxs   : 0                VPN-IPv6 Rej. Pfxs   : 0    
Mc IPv4 Rej. Pfxs    : 0                Mc IPv6 Rej. Pfxs    : 0    
MVPN-IPv4 Rej. Pfxs  : 0                MVPN-IPv6 Rej. Pfxs  : 0    
Flow-IPv4 Rej. Pfxs  : 0                Flow-IPv6 Rej. Pfxs  : 0    
L2-VPN Rej. Pfxs     : 0                MDT-SAFI Rej. Pfxs   : 0    
Rte-Tgt Rej. Pfxs    : 0                MS-PW Rej. Pfxs      : 0    
Mc Vpn Ipv4 Rej. Pfxs: 0                Evpn Rej. Pfxs       : 0    
-------------------------------------------------------------------------------
Neighbors : 1
===============================================================================
* indicates that the corresponding row element may have been truncated.
*A:Dut-B>config>service# 
 
 
 
A:ALA-48# show router 2 bgp neighbor 10.20.1.3
===============================================================================
BGP Neighbor
===============================================================================
Peer  : 10.20.1.3
Group : 1
-------------------------------------------------------------------------------
Peer AS              : 100              Peer Port            : 49725
Peer Address         : 10.20.1.3
Local AS             : 100              Local Port           : 179
Local Address        : 10.20.1.2
Peer Type            : Internal
State                : Established      Last State           : Established
Last Event           : recvKeepAlive
Last Error           : Cease
Local Family         : IPv4
Remote Family        : IPv4
Hold Time            : 3                Keep Alive           : 1
Active Hold Time     : 3                Active Keep Alive    : 1
Preference           : 170              Num of Flaps         : 0
Recd. Paths          : 1
IPv4 Recd. Prefixes  : 11               IPv4 Active Prefixes : 10
IPv4 Suppressed Pfxs : 0                VPN-IPv4 Suppr. Pfxs : 0
VPN-IPv4 Recd. Pfxs  : 0                VPN-IPv4 Active Pfxs : 0
Mc IPv4 Recd. Pfxs.  : 0                Mc IPv4 Active Pfxs. : 0
Mc IPv4 Suppr. Pfxs  : 0 
Input Queue          : 0                Output Queue         : 0
i/p Messages         : 471              o/p Messages         : 473
i/p Octets           : 3241             o/p Octets           : 3241
i/p Updates          : 4                o/p Updates          : 4
TTL Security         : Disabled         Min TTL Value        : n/a
Advertise Inactive   : Disabled         Peer Tracking        : Disabled
Advertise Label      : None
Auth key chain       : eta_keychain1
Local Capability     : RouteRefresh MP-BGP
Remote Capability    : RouteRefresh MP-BGP
Import Policy        : None Specified / Inherited
Export Policy        : static2bgp
-------------------------------------------------------------------------------
Neighbors : 1
===============================================================================
A:ALA-48#
 
 
A:ALA-12# show router bgp neighbor 10.0.0.11 orf
===============================================================================
BGP Neighbor 10.0.0.11 ORF
===============================================================================
Send List (Automatic)
-------------------------------------------------------------------------------
target:65535:10
target:65535:20
===============================================================================
A:ALA-12
 
 
A:ALA-22 show router bgp neighbor 10.0.0.1 orf
===============================================================================
BGP Neighbor 10.0.0.1 ORF
===============================================================================
Receive List
-------------------------------------------------------------------------------
target:65535:10
target:65535:20
===============================================================================
A:ALA-22
Sample Detailed Output
A:ALA-12# show router bgp neighbor detail
===============================================================================
BGP Neighbor (detail)
-------------------------------------------------------------------------------
Peer : 10.0.0.15         Group : To_AS_40000
-------------------------------------------------------------------------------
Peer AS          : 65205                Peer Port        : 0 
Peer Address     : 10.0.0.15 
Local AS         : 65206                Local Port       : 0 
Local Address    : 10.0.0.16 
Peer Type        : External                                                     
State            : Active               Last State       : Connect             
Last Event       : openFail                                                     
Last Error       : Hold Timer Expire
Connect Retry    : 20                   Local Pref.      : 100                 
Min Route Advt.  : 30                   Min AS Orig.     : 15                  
 
Damping          : Disabled             Loop Detect      : Ignore              
MED Out          : No MED Out           Authentication   : None                
Next Hop Self    : Disabled             AggregatorID Zero: Disabled            
Remove Private   : Disabled             Passive          : Disabled            
Prefix Limit     : No Limit                                                     
Hold Time        : 90                   Keep Alive       : 30                  
Active Hold Time : 0                    Active Keep Alive: 0                   
Preference       : 170                  Num of Flaps     : 0                   
Recd. Prefixes   : 0                    Active Prefixes  : 0                   
Recd. Paths      : 0                    Suppressed Paths : 0                   
Input Queue      : 0                    Output Queue     : 0                   
i/p Messages     : 0                    o/p Messages     : 0                   
i/p Octets       : 0                    o/p Octets       : 0                   
i/p Updates      : 0                    o/p Updates      : 0                   
Export Policy    : direct2bgp 
===============================================================================
A:ALA-12#
Table 67:  Output Fields: Router BGP Neighbor  

Label

Description

Peer

Displays the IP address of the configured BGP peer

Group

Displays the BGP peer group to which this peer is assigned

Peer AS

Displays the configured or inherited peer AS for the peer group

Peer Address

Displays the configured address for the BGP peer

Peer Port

Displays the TCP port number used on the far-end system

Local AS

Displays the configured or inherited local AS for the peer group

Local Address

Displays the configured or inherited local address for originating peering for the peer group

Local Port

Displays the TCP port number used on the local system

Peer Type

External — Peer type configured as external BGP peers

Internal — Peer type configured as internal BGP peers

Bfd

Yes — BFD is enabled

No — BFD is disabled

State

Idle — The BGP peer is not accepting connections

Active — BGP is listening for and accepting TCP connections from this peer

Connect — BGP is attempting to establish a TCP connections from this peer

Open Sent — BGP has sent an OPEN message to the peer and is waiting for an OPEN message from the peer

Open Confirm — BGP has received a valid OPEN message from the peer and is awaiting a KEEPALIVE or NOTIFICATION

Established — BGP has successfully established a peering and is exchanging routing information

Last State

Idle — The BGP peer is not accepting connections

Active — BGP is listening for and accepting TCP connections from this peer

Connect — BGP is attempting to establish a TCP connections from this peer

Open Sent — BGP has sent an OPEN message to the peer and is waiting for an OPEN message from the peer

Open Confirm — BGP has received a valid OPEN message from the peer and is awaiting a KEEPALIVE or NOTIFICATION

Last Event

start — BGP has initialized the BGP neighbor

stop — BGP has disabled the BGP neighbor

open — BGP transport connection opened

close — BGP transport connection closed

openFail — BGP transport connection failed to open

error — BGP transport connection error

connectRetry — Connect retry timer expired

holdTime — Hold time timer expired

keepAlive — Keepalive timer expired

recvOpen — Receive an OPEN message

revKeepalive — Receive a KEEPALIVE message

recvUpdate — Receive an UPDATE message

recvNotify — Receive a NOTIFICATION message

None — No events have occurred

Last Error

Displays the last BGP error and subcode to occur on the BGP neighbor

Connect Retry

Displays the configured or inherited connect retry timer value

Local Pref.

Displays the configured or inherited local preference value

Min Route Advt.

Displays the minimum amount of time that must pass between route updates for the same IP prefix

Min AS Originate

Displays the minimum amount of time that must pass between updates for a route originated by the local router

Multihop

Displays the maximum number of router hops a BGP connection can traverse

Damping

Disabled — BGP neighbor is configured not to dampen route flaps

Enabled — BGP neighbor is configured to dampen route flaps

Loop Detect

Ignore — The BGP neighbor is configured to ignore routes with an AS loop

Drop — The BGP neighbor is configured to drop the BGP peering if an AS loop is detected

Off — AS loop detection is disabled for the neighbor

MED Out

Displays the configured or inherited MED value assigned to advertised routes without a MED attribute

Authentication

None — No authentication is configured

MD5 — MD5 authentication is configured

Next Hop Self

Disabled — BGP is not configured to send only its own IP address as the BGP nexthop in route updates to the specified neighbor

Enabled — BGP will send only its own IP address as the BGP nexthop in route updates to the neighbor

AggregatorID Zero

Disabled — The BGP Neighbor is not configured to set the aggregator ID to 0.0.0.0 in all originated route aggregates

Enabled — The BGP Neighbor is configured to set the aggregator ID to 0.0.0.0 in all originated route aggregates

Remove Private

Disabled — BGP will not remove all private AS numbers from the AS path attribute, in updates sent to the specified neighbor

Enabled — BGP will remove all private AS numbers from the AS path attribute, in updates sent to the specified neighbor

Passive

Disabled — BGP will actively attempt to establish a BGP connection with the specified neighbor

Enabled — BGP will not actively attempt to establish a BGP connection with the specified neighbor

Prefix Limit

No Limit — No route limit assigned to the BGP peer group

1 — 4294967295 — The maximum number of routes BGP can learn from a peer

Hold Time

Displays the configured hold time setting

Keep Alive

Displays the configured keepalive setting

Active Hold Time

Displays the negotiated hold time if the BGP neighbor is in an established state

Active Keep Alive

Displays the negotiated keepalive time if the BGP neighbor is in an established state

Client Reflect

Disabled — The BGP route reflector is configured not to reflect routes to this neighbor

Enabled — The BGP route reflector is configured to reflect routes to this neighbor

Preference

Displays the configured route preference value for the peer group

Num of Flaps

Displays the number of route flaps in the neighbor connection

Recd. Prefixes

Displays the number of routes received from the BGP neighbor

Active Prefixes

Displays the number of routes received from the BGP neighbor and active in the forwarding table

Recd. Paths

Displays the number of unique sets of path attributes received from the BGP neighbor

Suppressed Paths

Displays the number of unique sets of path attributes received from the BGP neighbor and suppressed due to route damping

Input Queue

Displays the number of BGP messages to be processed

Output Queue

Displays the number of BGP messages to be transmitted

i/p Messages

Displays the total number of packets received from the BGP neighbor

o/p Messages

Displays the total number of packets sent to the BGP neighbor

i/p Octets

Displays the total number of octets received from the BGP neighbor

o/p Octets

Displays the total number of octets sent to the BGP neighbor

Export Policy

Displays the configured export policies for the peer group

Import Policy

Displays the configured import policies for the peer group

Sample Output for BGP Neighbor Received Routes
A:ALA-12# show router bgp neighbor 10.0.0.16 received-routes
===============================================================================
 BGP Router ID : 10.0.0.16         AS : 65206   Local AS : 65206 
===============================================================================
 Legend -
 Status codes  : u - used, s - suppressed, h - history, d - decayed, * - valid
 Origin codes  : i - IGP, e - EGP, ? - incomplete, > - best
===============================================================================
BGP IPv4 Routes
===============================================================================
Flag  Network            Nexthop         LocalPref  MED        As-Path          
-------------------------------------------------------------------------------
?     10.0.0.16/32       10.0.0.16       100        none       No As-Path      
?     10.0.6.0/24        10.0.0.16       100        none       No As-Path      
?     10.0.8.0/24        10.0.0.16       100        none       No As-Path      
?     10.0.12.0/24       10.0.0.16       100        none       No As-Path      
?     10.0.13.0/24       10.0.0.16       100        none       No As-Path      
?     10.0.204.0/24      10.0.0.16       100        none       No As-Path      
===============================================================================
A:ALA-12#
Table 68:  Output Fields: Router BGP Neighbor Received-routes  

Label

Description

BGP Router ID

Displays the local BGP router ID

AS

Displays the configured autonomous system number

Local AS

Displays the configured local AS setting

If not configured, then it is the same value as the AS

Flag

u - used

s - suppressed

h - history

d - decayed

* - valid

i - igp

e - egp

? - incomplete

> - best

Network

Displays the route IP prefix and mask length for the route

Next Hop

Displays the BGP next hop for the route

LocalPref

Displays the BGP local preference path attribute for the route

MED

Displays the BGP Multi-Exit Discriminator (MED) path attribute for the route

AS Path

Displays the BGP AS path for the route

Sample Output — Add-Path
*A:Dut-A# show router bgp neighbor 10.2.2.2                   
===============================================================================
BGP Neighbor
===============================================================================
-------------------------------------------------------------------------------
Peer                 : 10.2.2.2
Description          : (Not Specified)
Group                : Metro
-------------------------------------------------------------------------------
Peer AS              : 100              Peer Port            : 179  
Peer Address         : 2.2.2.2
Local AS             : 100              Local Port           : 50239
Local Address        : 1.1.1.1
Peer Type            : Internal         
State                : Established      Last State           : Active
Last Event           : recvKeepAlive
Last Error           : Cease (Other Configuration Change)
Local Family         : IPv4
Remote Family        : IPv4
Hold Time            : 60               Keep Alive           : 30   
Min Hold Time        : 0                
Active Hold Time     : 60               Active Keep Alive    : 20   
Cluster Id           : None             
Preference           : 170              Num of Update Flaps  : 0    
Recd. Paths          : 1                
IPv4 Recd. Prefixes  : 1                IPv4 Active Prefixes : 1    
IPv4 Suppressed Pfxs : 0                VPN-IPv4 Suppr. Pfxs : 0    
VPN-IPv4 Recd. Pfxs  : 0                VPN-IPv4 Active Pfxs : 0    
Mc IPv4 Recd. Pfxs.  : 0                Mc IPv4 Active Pfxs. : 0    
Mc IPv4 Suppr. Pfxs  : 0                IPv6 Suppressed Pfxs : 0    
IPv6 Recd. Prefixes  : 0                IPv6 Active Prefixes : 0    
VPN-IPv6 Recd. Pfxs  : 0                VPN-IPv6 Active Pfxs : 0    
VPN-IPv6 Suppr. Pfxs : 0                
Mc IPv6 Recd. Pfxs.  : 0                Mc IPv6 Active Pfxs. : 0    
Mc IPv6 Suppr. Pfxs  : 0                L2-VPN Suppr. Pfxs   : 0    
L2-VPN Recd. Pfxs    : 0                L2-VPN Active Pfxs   : 0    
MVPN-IPv4 Suppr. Pfxs: 0                MVPN-IPv4 Recd. Pfxs : 0    
MVPN-IPv4 Active Pfxs: 0                MDT-SAFI Suppr. Pfxs : 0    
MDT-SAFI Recd. Pfxs  : 0                MDT-SAFI Active Pfxs : 0    
Flow-IPv4 Suppr. Pfxs: 0                Flow-IPv4 Recd. Pfxs : 0    
Flow-IPv4 Active Pfxs: 0                Rte-Tgt Suppr. Pfxs  : 0    
Rte-Tgt Recd. Pfxs   : 0                Rte-Tgt Active Pfxs  : 0    
Backup IPv4 Pfxs     : 0                Backup IPv6 Pfxs     : 0    
Mc Vpn Ipv4 Recd. Pf*: 0                Mc Vpn Ipv4 Active P*: 0    
Mc Vpn Ipv4 Suppr. P*: 0                
Backup Vpn IPv4 Pfxs : 0                Backup Vpn IPv6 Pfxs : 0    
Input Queue          : 0                Output Queue         : 0    
i/p Messages         : 40               o/p Messages         : 32   
i/p Octets           : 411              o/p Octets           : 488
i/p Updates          : 1                o/p Updates          : 1    
Flow-IPv6 Suppr. Pfxs: 0                Flow-IPv6 Recd. Pfxs : 0    
Flow-IPv6 Active Pfxs: 0                
Evpn Suppr. Pfxs     : 0                Evpn Recd. Pfxs      : 0    
Evpn Active Pfxs     : 0                
MS-PW Suppr. Pfxs    : 0                MS-PW Recd. Pfxs     : 0    
MS-PW Active Pfxs    : 0                
TTL Security         : Disabled         Min TTL Value        : n/a
Graceful Restart     : Disabled         Stale Routes Time    : n/a
Restart Time         : n/a              
Advertise Inactive   : Disabled         Peer Tracking        : Enabled
Advertise Label      : ipv4 
Auth key chain       : n/a
Disable Cap Nego     : Disabled         Bfd Enabled          : Enabled
Flowspec Validate    : Disabled         Default Route Tgt    : Disabled
Aigp Metric          : Disabled         Split Horizon        : Disabled
Damp Peer Oscillatio*: Disabled         Update Errors        : 0    
GR Notification      : Disabled         Fault Tolerance      : Disabled
Rem Idle Hold Time   : 00h00m00s        
Next-Hop Unchanged   : None             
L2 VPN Cisco Interop : Disabled         
Local Capability     : RtRefresh MPBGP 4byte ASN 
Remote Capability    : RtRefresh MPBGP 4byte ASN 
Local AddPath Capabi*: Send - IPv4 (4) 
                     : Receive - IPv4 
Remote AddPath Capab*: Send - IPv4 
                     : Receive - IPv4 
Import Policy        : None Specified / Inherited
Export Policy        : from_prefix_to_bgp                                      
Origin Validation    : N/A
EBGP Link Bandwidth  : n/a            
IPv4 Rej. Pfxs       : 0                IPv6 Rej. Pfxs       : 0    
VPN-IPv4 Rej. Pfxs   : 0                VPN-IPv6 Rej. Pfxs   : 0    
Mc IPv4 Rej. Pfxs    : 0                Mc IPv6 Rej. Pfxs    : 0    
MVPN-IPv4 Rej. Pfxs  : 0                MVPN-IPv6 Rej. Pfxs  : 0    
Flow-IPv4 Rej. Pfxs  : 0                Flow-IPv6 Rej. Pfxs  : 0    
L2-VPN Rej. Pfxs     : 0                MDT-SAFI Rej. Pfxs   : 0    
Rte-Tgt Rej. Pfxs    : 0                MS-PW Rej. Pfxs      : 0    
Mc Vpn Ipv4 Rej. Pfxs: 0                Evpn Rej. Pfxs       : 0    
-------------------------------------------------------------------------------
Neighbors : 1
===============================================================================
* indicates that the corresponding row element may have been truncated.
*A:Dut-A# 
Table 69:  Output Fields: Show Neighbor Add-path 

Label

Description

Peer

Displays the IP address of the configured BGP peer

Group

Displays the BGP peer group to which this peer is assigned

Peer AS

Displays the configured or inherited peer AS for the peer group

Peer Address

Displays the configured address for the BGP peer

Peer Port

Displays the TCP port number used on the far-end system

Local AS

Displays the configured or inherited local AS for the peer group

Local Address

Displays the configured or inherited local address for originating peering for the peer group

Local Port

Displays the TCP port number used on the local system

Peer Type

External — peer type configured as external BGP peers

Internal — peer type configured as internal BGP peers

State

Idle — The BGP peer is not accepting connections

(Shutdown) is also displayed if the peer is administratively disabled

Active — BGP is listening for and accepting TCP connections from this peer

Connect — BGP is attempting to establish a TCP connection with this peer

Open Sent — BGP has sent an OPEN message to the peer and is waiting for an OPEN message from the peer

Open Confirm — BGP has received a valid OPEN message from the peer and is awaiting a KEEPALIVE or NOTIFICATION

Established — BGP has successfully established a peering session and is exchanging routing information

Last State

Idle — The BGP peer is not accepting connections

Active — BGP is listening for and accepting TCP connections from this peer

Connect — BGP is attempting to establish a TCP connections with this peer

Open Sent — BGP has sent an OPEN message to the peer and is waiting for an OPEN message from the peer

Open Confirm — BGP has received a valid OPEN message from the peer and is awaiting a KEEPALIVE or NOTIFICATION

Last Event

start — BGP has initialized the BGP neighbor

stop — BGP has disabled the BGP neighbor

open — BGP transport connection is opened

close — BGP transport connection is closed

openFail — BGP transport connection failed to open

error — BGP transport connection error

connectRetry — the connect retry timer expired

holdTime — the hold time timer expired

keepAlive — the keepalive timer expired

recvOpen — BGP has received an OPEN message

revKeepalive — BGP has received a KEEPALIVE message

recvUpdate — BGP has received an UPDATE message

recvNotify —BGP has received a NOTIFICATION message

None — no events have occurred

Last Error

Displays the last BGP error and subcode to occur on the BGP neighbor

Local Family

Displays the configured local family value

Remote Family

Displays the configured remote family value

Hold Time

Displays the configured hold-time setting

Keep Alive

Displays the configured keepalive setting

Min Hold Time

Displays the configured minimum hold-time setting

Active Hold Time

Displays the negotiated hold time, if the BGP neighbor is in an established state

Active Keep Alive

Displays the negotiated keepalive time if the BGP neighbor is in an established state

Cluster Id

Displays the configured route reflector cluster ID

None — no cluster ID is configured

Preference

Displays the configured route preference value for the peer group

Num of Flaps

Displays the number of route flaps in the neighbor connection

Recd. Prefixes

Displays the number of routes received from the BGP neighbor

Recd. Paths

Displays the number of unique sets of path attributes received from the BGP neighbor

IPv4 Recd. Prefixes

Displays the number of unique sets of IPv4 path attributes received from the BGP neighbor

IPv4 Active Prefixes

Displays the number of IPv4 routes received from the BGP neighbor and active in the forwarding table

IPv4 Suppressed Pfxs

Displays the number of unique sets of IPv4 path attributes received from the BGP neighbor and suppressed due to route damping

VPN-IPv4 Suppr. Pfxs

Displays the number of unique sets of VPN-IPv4 path attributes received from the BGP neighbor and suppressed due to route damping

VPN-IPv4 Recd. Pfxs

Displays the number of unique sets of VPN-IPv4 path attributes received from the BGP neighbor

VPN-IPv4 Active Pfxs

Displays the number of VPN-IPv4 routes received from the BGP neighbor and active in the forwarding table

IPv6 Recd. Prefixes

Displays the number of unique sets of IPv6 path attributes received from the BGP neighbor

IPv6 Active Prefixes

Displays the number of IPv6 routes received from the BGP neighbor and active in the forwarding table

VPN-IPv6 Recd. Pfxs

Displays the number of unique sets of VPN-IPv6 path attributes received from the BGP neighbor

VPN-IPv6 Active Pfxs

Displays the number of VPN-IPv6 routes received from the BGP neighbor and active in the forwarding table

VPN-IPv6 Suppr. Pfxs

Displays the number of unique sets of VPN-IPv6 path attributes received from the BGP neighbor and suppressed due to route damping

Backup IPv4 Pfxs

Displays the number of BGP FRR backup path IPv4 prefixes

Backup IPv6 Pfxs

Displays the number of BGP FRR backup path IPv6 prefixes

Backup Vpn IPv4 Pfxs

Displays the number of BGP FRR backup path VPN IPv4 prefixes

Backup Vpn IPv6 Pfxs

Displays the number of BGP FRR backup path VPN IPv6 prefixes

Input Queue

Displays the number of BGP messages to be processed

Output Queue

Displays the number of BGP messages to be transmitted

i/p Messages

Displays the total number of packets received from the BGP neighbor

o/p Messages

Displays the total number of packets sent to the BGP neighbor

i/p Octets

Displays the total number of octets received from the BGP neighbor

o/p Octets

Displays the total number of octets sent to the BGP neighbor

i/p Updates

Displays the total number of updates received from the BGP neighbor

o/p Updates

Displays the total number of updates sent to the BGP neighbor

TTL Security

Enabled — TTL security is enabled

Disabled — TTL security is disabled

Min TTL Value

Displays the minimum TTL value configured for the peer

Graceful Restart

Displays the state of graceful restart

Stale Routes Time

Displays the length of time that stale routes are kept in the route table

Advertise Inactive

Displays the state of advertising inactive BGP routes to other BGP peers (enabled or disabled)

Peer Tracking

Displays the state of tracking a neighbor IP address in the routing table for a BGP session

Advertise Label

Displays the enabled address family for supporting RFC 3107 BGP label capability

Auth key chain

Displays the value for the authentication key chain

Bfd Enabled

Enabled — BFD is enabled

Disabled — BFD is disabled

Local Capability

Displays the capability of the local BGP speaker; for example, route refresh, MP-BGP, ORF

Remote Capability

Displays the capability of the remote BGP peer; for example, route refresh, MP-BGP, ORF

Local AddPath Capabi*

Displays the state of the local BGP add-paths capabilities

The add-paths capability allows the router to send and receive multiple paths per prefix to or from a peer

Remote AddPath Capab*

Displays the state of the remote BGP add-paths capabilities

Import Policy

Displays the configured import policies for the peer group

Export Policy

Displays the configured export policies for the peer group

next-hop

Syntax 
next-hop [family] [ip-address] [detail]
Context 
show>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command displays BGP next-hop information.

Parameters 
family—
Displays the type of routing information to be distributed by the BGP instance.
Values—
ipv4 — Displays only those BGP peers that have the IPv4 family enabled.
vpn-ipv4 —Displays only those BGP peers that have the VPN-IPv4 family enabled.
ipv6 — Displays only those BGP peers that have the IPv6 family enabled.
vpn-ipv6 — Displays only those BGP peers that have the VPN-IPv4 family enabled.

 

ip-address—
Displays next-hop information for the specified IP address.
Values—

ipv4-address:

a.b.c.d (host bits must be 0)

ipv6-address:

x:x:x:x:x:x:x:x[-interface]

x:x:x:x:x:x:d.d.d.d[-interface]

x:

[0 to FFFF]H

d:

[0 to 255]D

interface: 32 characters maximum, mandatory for link local addresses.

 

detail—
Displays detailed information.
Output 

The following output is an example of BGP next-hop information, and Table 70 describes the output fields.

Sample Output
*A:Dut-C#  show router bgp next-hop
===============================================================================
 BGP Router ID:10.20.1.3        AS:5000        Local AS:5000
===============================================================================
 
===============================================================================
BGP Next Hop
===============================================================================
Next Hop                                                        Pref Owner
   Resolving Prefix                                                  Metric
   Resolved Next Hop                                                 Ref. Count
-------------------------------------------------------------------------------
10.20.1.1                                                       7    RSVP
   10.20.1.1/32                                                      1000
   10.10.2.1                                                         2
10.20.1.2                                                       7    RSVP
   10.20.1.2/32                                                      1000
   10.10.3.2                                                         2
10.20.1.4                                                       7    RSVP
   10.20.1.4/32                                                      1000
   10.10.11.4                                                        2
-------------------------------------------------------------------------------
Next Hops : 3
 
 
 
A:ALA-49>show>router>bgp# next-hop 192.168.2.194
-------------------------------------------------------------------------------
 BGP Router ID : 10.10.10.104      AS : 200     Local AS : 200
===============================================================================
BGP Next Hop
===============================================================================
Next Hop        Resolving          Owner  Preference Reference  Resolved
                Prefix                               Count      Next Hop
-------------------------------------------------------------------------------
A:ALA-49>show>router>bgp# next-hop 10.10.10.104
Table 70:  Output Fields: Router BGP Next-hop  

Label

Description

BGP ID

Displays the local BGP router ID

AS

Displays the configured ASN

Local AS

Displays the configured local AS setting. If not configured, then the value is the same as the AS.

Next Hop

Displays the next-hop address

Resolving Prefix

Displays the prefix of the best next hop.

Owner

Displays the routing protocol used to derive the best next hop

Preference

Displays the BGP preference attribute for the routes

Reference Count

Displays the number of routes using the resolving prefix

Resolved Next Hop

Displays the IP address of the next hop

paths

Syntax 
paths
Context 
show>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command displays a summary of BGP path attributes.

Output 

The following output is an example of BGP path attributes information, and Table 71 describes the output fields.

Sample Output
===============================================================================
 BGP Router ID : 10.0.0.14         AS : 65206   Local AS : 65206 
===============================================================================
BGP Paths
===============================================================================
Path: 60203 65001 19855 3356  15412 
-------------------------------------------------------------------------------
Origin           : IGP                  Next Hop         : 10.0.28.1           
MED              : 60203                Local Preference : none                
Refs             : 4                    ASes             : 5                   
Segments         : 1                                                           
Flags            : EBGP-learned
Aggregator       : 15412  62.216.140.1
-------------------------------------------------------------------------------
Path: 60203 65001 19855 3356  1     1236  1236  1236  1236  
-------------------------------------------------------------------------------
Origin           : IGP                  Next Hop         : 10.0.28.1           
MED              : 60203                Local Preference : none                
Refs             : 2                    ASes             : 9                   
Segments         : 1                                                           
Flags            : EBGP-learned
Table 71:  Output Fields: Router BGP Paths  

Label

Description

BGP Router ID

Displays the local BGP router ID

AS

Displays the configured autonomous system number

Local AS

Displays the configured local AS setting. If not configured, then the value is the same as the AS.

Path

Displays the AS path attribute

Origin

EGP - The NLRI is learned by an EGP protocol

IGP - The NLRI is interior to the originating AS

INCOMPLETE - NLRI was learned another way

Next Hop

Displays the advertised BGP next hop

MED

Displays the MED value

Local Preference

Displays the local preference value. This value is used if thet BGP route arrives from a BGP peer without the Local Pref attribute set. It is overridden by any value set via a route policy.

Refs

Displays the number of routes using a specified set of path attributes

ASes

Displays the number of autonomous system numbers in the AS path attribute

Segments

Displays the number of segments in the AS path attribute

Flags

EBGP-learned - Path attributes learned by an EBGP peering

IBGP-Learned - Path attributes learned by an IBGP peering

Aggregator

Displays the route aggregator ID

Community

Displays the BGP community attribute list

Originator ID

Displays the originator ID path attribute value

routes

Syntax 
routes [family] [brief]
routes [family] prefix [detail | longer | hunt [brief]]
routes [family [type mvpn-type]] community comm-id
routes [family [type mvpn-type]] aspath-regex reg-ex
routes ms-pw [rd rd] [aii-type2 aii-type2] [brief]
routes l2-vpn l2vpn-type {[rd rd] | [siteid site-id] | [veid veid] [offset vpls-base-offset]}
routes evpn auto-disc [hunt | detail] [rd rd] [community comm-id] [tag tag] [next-hop ip-address] [esi esi]
routes evpn eth-seg [hunt | detail] [rd rd] [community comm-id] [originator-ip ip-address] [next-hop ip-address] [esi esi]
routes evpn inclusive-mcast [hunt | detail] [rd rd] [community comm-id] [originator-ip ip-address] [next-hop ip-address] [esi esi]
routes evpn inclusive-mcast [hunt | detail] [rd rd] [community comm-id] [originator-ip ip-address] [next-hop ip-address] [tag tag]
routes evpn mac [hunt | detail] [rd rd] [next-hop ip-address] [mac-address mac-address] [community comm-id] [tag tag]
Context 
show>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command displays BGP route information.

When this command is issued without any parameters, the entire BGP routing table displays.

When this command is issued with an IP prefix/mask or IP address, the best match for the parameter displays.

Parameters 
family—
Specifies the type of routing information to be distributed by the BGP instance
Values—
ipv4 — Displays only those BGP peers that have the IPv4 family enabled.
vpn-ipv4 — Displays only those BGP peers that have the VPN-IPv4 family enabled.
ipv6 — Displays only those BGP peers that have the IPv6 family enabled.
vpn-ipv6 — Displays only those BGP peers that have the VPN-IPv4 family enabled.
evpn — Displays only BGP peers that have the EVPN family enabled.

 

received—
Displays the BGP routes received from the neighbor.
prefix—
Specifies the type of routing information to display.
Values—

rd:[ip-address[/mask]]

rd

ip-address:number1

as-number1:number2

as-number2:number3

number1

1 to 65535

as-number1

1 to 65535

number2

0 to 4294967295

as-number2

1 to 4294967295

number3

0 to 65535

ip-address

a.b.c.d

mask

0 to 32

 

filter—
Specifies route criteria.
Values—
hunt — Displays entries for the specified route in the RIB-In, RIB-Out, and RTM.
longer — Displays the specified route and subsets of the route.
detail — Displays the longer, more detailed version of the output.

 

aspath-regex reg-exp
Displays all routes with an AS path, up to 32 characters, matching the specified regular expression reg-exp.
community comm-id
Displays all routes with the specified BGP community.
Values—

[as-number1:comm-val1 | ext-comm | well-known-comm]

ext-comm

type:{ip-address:comm-val1 | as-number1:comm-val2 | as-number2:comm-val1}

as-number1

0 to 65535

comm-val1

0 to 65535

type

target, origin

ip-address

a.b.c.d

comm-val2

0 to 4294967295

as-number2

0 to 4294967295

well-known-comm no-export, no-export-subconfed, no-advertise

 

brief—
Provides a summarized display of the set of peers to which a BGP route is advertised.
rd—
Allows more precise definition of the RD and prefix for VPN-IPv6 routes.
Values—
ip-addr:comm-val
2byte-asnumber:ext-comm-val
4byte-asnumber:comm-val

 

veid—
Specifies a two-byte identifier that represents the local bridging instance in a VPLS and is advertised through the BGP NLRI. This value must be lower than or equal to the max-ve-id.
Values—
0 to 4294967295

 

vpls-base-offset—
Specifies a two-byte identifier advertised through the NLRI that is used to indicate which VE ID should use the advertised NLRI at the receiving PE according to the following rule:

If the offset<= local VE-ID <= offset+VBS-1 (VBS = virtual block size = 8 in our implementation), the NLRI is processed. Otherwise it is ignored.

The NLRI with this offset is generated as soon as the first VE ID value between (offset, offset + VBS-1) is advertised in the network.

Values—
0 to 4294967295

 

l2vpn-type—
Specifies a 12-byte Virtual Switch Instance identifier (VSI-ID) type.
Values—
bgp-ad | bgp-vpls | multi-homing

 

ms-pw [rd rd] [aii-type2 aii-type2] [brief]
Displays routes for the ms-pw family.
Output 
Sample Output
*A:Dut-C# show router bgp routes hunt 10.1.1.1/32
===============================================================================
 BGP Router ID:10.20.1.3        AS:5000        Local AS:5000
===============================================================================
 Legend -
 Status codes  : u - used, s - suppressed, h - history, d - decayed, * -
 valid  Origin codes  : i - IGP, e - EGP, ? - incomplete, > - best
 
===============================================================================
BGP IPv4 Routes
===============================================================================
-------------------------------------------------------------------------------
RIB In Entries
-------------------------------------------------------------------------------
Network        : 10.1.1.1/32
Nexthop        : 10.20.1.1
From           : 10.20.1.1
Res. Nexthop   : 10.20.1.1 (RSVP LSP: 1)
Local Pref.    : 100                    Interface Name : ip-10.10.2.3
Aggregator AS  : None                   Aggregator     : None
Atomic Aggr.   : Not Atomic             MED            : None
Community      : No Community Members
Originator Id  : None                   Peer Router Id : 10.20.1.1
Flags          : Used  Valid  Best  Incomplete
AS-Path        : No As-Path
 
-------------------------------------------------------------------------------
RIB Out Entries
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
Routes : 1
===============================================================================
 
 
A:ALA-12>config>router>bgp# show router bgp routes family ipv4
===============================================================================
 BGP Router ID : 10.10.10.103      AS : 200     Local AS : 200
===============================================================================
 Legend -
 Status codes  : u - used, s - suppressed, h - history, d - decayed, * - valid
 Origin codes  : i - IGP, e - EGP, ? - incomplete, > - best
===============================================================================
BGP Routes
===============================================================================
Flag  Network                             Nexthop         LocalPref  MED
      VPN Label                           As-Path
-------------------------------------------------------------------------------
No Matching Entries Found
===============================================================================
A:ALA-12>config>router>bgp# 
 
 
A:ALA-12>config>router>bgp# show router bgp routes 10.1.0.0/24 de 
=============================================================================== 
BGP Router ID : 10.128.0.161 AS : 65535 Local AS : 65535 
=============================================================================== 
Legend - Status codes : u - used, s - suppressed, h - history, d - decayed, * -
 valid Origin codes : i - IGP, e - EGP, ? - incomplete, > - best 
=============================================================================== 
BGP Routes 
=============================================================================== 
Original Attributes 
Network : 10.1.0.0/24 Nexthop :10.20.1.20 
Route Dist. : 10070:100 VPN Label :152784 
From : 10.20.1.20 Res. Nexthop:10.130.0.2 
Local Pref. :100 
Aggregator AS:none Aggregator : none 
Atomic Aggr.:Not Atomic MED :none 
Community :target:10070:1
Originator Id:None Peer Router Id:10.20.1.20 
Flags :Used Valid Best IGP 
AS-Path :10070 {14730} 
 
Modified Attributes 
 
Network :10.1.0.0/24 Nexthop :10.20.1.20 
Route Dist.: 10001:100 VPN Label :152560
From :10.20.1.20 Res. Nexthop :10.130.0.2 
Local Pref.:100 
Aggregator AS: none Aggregator:none 
Atomic Aggr.:Not Atomic MED :none 
Community :target:10001:1 
Originator Id:None Peer Router Id:10.20.1.20 
Flags :Used Valid Best IGP 
AS-Path :No As-Path 
------------------------------------------------------------------------------- 
...
=============================================================================== 
A:ALA-12>config>router>bgp#
 
 
A:7210-12# show router bgp routes 10.0.0.0/30 hunt 
===============================================================================
 BGP Router ID : 10.20.1.1   AS : 100Local AS : 100 
===============================================================================
 Legend -
 Status codes  : u - used, s - suppressed, h - history, d - decayed, * - valid
 Origin codes  : i - IGP, e - EGP, ? - incomplete, > - best
===============================================================================
BGP Routes
===============================================================================
RIB In Entries
-------------------------------------------------------------------------------
Network        : 10.0.0.0/30
Nexthop        : 10.20.1.2
Route Dist.    : 10.20.1.2:1VPN Label: 131070 
From       : 10.20.1.2
Res. Nexthop   : 10.10.1.2
Local Pref.    : 100Interface Name: to-sr7 
Aggregator AS  : noneAggregator: none 
Atomic Aggr.   : Not AtomicMED: none
Community      : target:10.20.1.2:1
Originator Id  : NonePeer Router Id: 10.20.1.2
Flags       : Used  Valid  Best  IGP  
AS-Path        : No As-Path
VPRN Imported  : 1 2 10 12
-------------------------------------------------------------------------------
RIB Out Entries
-------------------------------------------------------------------------------
Routes : 1
===============================================================================
A:7210-12#
 
 
 
*A:Dut-C>config>router>policy-options# show router bgp routes  10.10.0.0/24 hunt 
===============================================================================
 BGP Router ID:10.20.1.3        AS:300         Local AS:300        
===============================================================================
 Legend -
 Status codes  : u - used, s - suppressed, h - history, d - decayed, * - valid
                 l - leaked, x - stale, > - best, b - backup, p - purge
 Origin codes  : i - IGP, e - EGP, ? - incomplete
===============================================================================
BGP IPv4 Routes
===============================================================================
-------------------------------------------------------------------------------
RIB In Entries
-------------------------------------------------------------------------------
Network        : 10.10.0.0/24
Nexthop        : 10.20.1.2
Path Id        : None                   
From           : 10.20.1.2
Res. Nexthop   : 10.10.11.2 (LDP)
Local Pref.    : 100                    Interface Name : INT_TO_C3_D_1
Aggregator AS  : None                   Aggregator     : None
Atomic Aggr.   : Not Atomic             MED            : None
AIGP Metric    : 555                    
Connector      : None
Community      : No Community Members
Cluster        : No Cluster Members
Originator Id  : None                   Peer Router Id : 10.20.1.2
IPv4 Label     : 131065                 
Flags          : Used  Valid  Best  IGP  
Route Source   : Internal
AS-Path        : 400 500 
Route Tag      : 0                      
Neighbor-AS    : 400
Orig Validation: NotFound               
Add Paths Send : Default                
Last Modified  : 00h15m47s              
 
Network        : 10.10.0.0/24
Nexthop        : 10.20.1.4
Path Id        : None                   
From           : 10.20.1.4
Res. Nexthop   : 10.10.5.4 (LDP)
Local Pref.    : 100                    Interface Name : INT_TO_C4_E_1
Aggregator AS  : None                   Aggregator     : None
Atomic Aggr.   : Not Atomic             MED            : None
AIGP Metric    : None                   
Connector      : None
Community      : No Community Members
Cluster        : No Cluster Members
Originator Id  : None                   Peer Router Id : 10.20.1.4
IPv4 Label     : 131065                 
Flags          : Valid  IGP  
TieBreakReason : AIGP                   
Route Source   : Internal
AS-Path        : 400 500 
Route Tag      : 0                      
Neighbor-AS    : 400
Orig Validation: NotFound               
Add Paths Send : Default                
Last Modified  : 00h15m49s              
 
Network        : 10.10.0.0/24
Nexthop        : 10.10.1.1
Path Id        : None                   
From           : 10.10.1.1
Res. Nexthop   : 10.10.1.1
Local Pref.    : None                   Interface Name : INT_TO_C1_A
Aggregator AS  : None                   Aggregator     : None
Atomic Aggr.   : Not Atomic             MED            : None
AIGP Metric    : None                   
Connector      : None
Community      : No Community Members
Cluster        : No Cluster Members
Originator Id  : None                   Peer Router Id : 10.20.1.1
IPv4 Label     : 131071                 
Flags          : Invalid  IGP  AS-Loop  
Route Source   : External
AS-Path        : 200 300 400 500 
Route Tag      : 0                      
Neighbor-AS    : 200                  
Orig Validation: NotFound               
Add Paths Send : Default                
Last Modified  : 00h15m48s              
 
-------------------------------------------------------------------------------
RIB Out Entries
-------------------------------------------------------------------------------
Network        : 10.10.0.0/24
Nexthop        : 10.20.1.2
Path Id        : None                   
To             : 10.20.1.4
Res. Nexthop   : n/a
Local Pref.    : 100                    Interface Name : NotAvailable
Aggregator AS  : None                   Aggregator     : None
Atomic Aggr.   : Not Atomic             MED            : 100
AIGP Metric    : 555                    
Connector      : None
Community      : No Community Members
Cluster        : 10.20.1.3
Originator Id  : 10.20.1.2              Peer Router Id : 10.20.1.4
IPv4 Label     : 131065                 
Origin         : IGP                    
AS-Path        : 400 500 
Route Tag      : 0                      
Neighbor-AS    : 400
Orig Validation: NotFound               
 
Network        : 10.10.0.0/24
Nexthop        : 10.20.1.2
Path Id        : None                   
To             : 10.20.1.2
Res. Nexthop   : n/a
Local Pref.    : 100                    Interface Name : NotAvailable
Aggregator AS  : None                   Aggregator     : None
Atomic Aggr.   : Not Atomic             MED            : 100
AIGP Metric    : 555                    
Connector      : None
Community      : No Community Members
Cluster        : 10.20.1.3
Originator Id  : 10.20.1.2              Peer Router Id : 10.20.1.2
IPv4 Label     : 131065                 
Origin         : IGP                    
AS-Path        : 400 500 
Route Tag      : 0                      
Neighbor-AS    : 400
Orig Validation: NotFound               
 
Network        : 10.10.0.0/24
Nexthop        : 10.20.1.2
Path Id        : None                   
To             : 10.20.1.5
Res. Nexthop   : n/a
Local Pref.    : 100                    Interface Name : NotAvailable
Aggregator AS  : None                   Aggregator     : None
Atomic Aggr.   : Not Atomic             MED            : None
AIGP Metric    : 555                    
Connector      : None
Community      : No Community Members
Cluster        : 10.20.1.3
Originator Id  : 10.20.1.2              Peer Router Id : 10.20.1.5
IPv4 Label     : 131065                 
Origin         : IGP                    
AS-Path        : 400 500 
Route Tag      : 0                      
Neighbor-AS    : 400
Orig Validation: NotFound               
 
Network        : 10.10.0.0/24
Nexthop        : 10.10.1.3
Path Id        : None                   
To             : 10.10.1.1
Res. Nexthop   : n/a
Local Pref.    : n/a                    Interface Name : NotAvailable
Aggregator AS  : None                   Aggregator     : None
Atomic Aggr.   : Not Atomic             MED            : None
AIGP Metric    : None                   
Connector      : None
Community      : No Community Members
Cluster        : No Cluster Members
Originator Id  : None                   Peer Router Id : 10.20.1.1
IPv4 Label     : 131067                 
Origin         : IGP                    
AS-Path        : 300 400 500 
Route Tag      : 0                      
Neighbor-AS    : 300
Orig Validation: NotFound               
 
-------------------------------------------------------------------------------
Routes : 7
===============================================================================
*A:Dut-C>config>router>policy-options# 
 
 
 
*A:dut-a# show router bgp routes mvpn-ipv4 type source-join source-as 200 source-
ip 150.100.1.2 group-ip 226.0.0.0 detail
===============================================================================
 BGP Router ID:10.20.1.3        AS:200         Local AS:200
===============================================================================
 Legend -
 Status codes  : u - used, s - suppressed, h - history, d - decayed, * - valid
 Origin codes  : i - IGP, e - EGP, ? - incomplete, > - best
 
===============================================================================
BGP MVPN-IPv4 Routes
===============================================================================
Route Type     : Source-Join
Route Dist.    : 1:1
Source AS      : 200
Source IP      : 10.100.1.2
Group IP       : 239.0.0.0
Nexthop        : 10.20.1.4
From           : 10.20.1.4
Res. Nexthop   : 0.0.0.0
Local Pref.    : 100                    Interface Name : NotAvailable
Aggregator AS  : None                   Aggregator     : None
Atomic Aggr.   : Not Atomic             MED            : 0
Community      : target:10.20.1.3:2
Originator Id  : None                   Peer Router Id : 10.20.1.4
Flags          : Used  Valid  Best  IGP
AS-Path        : No As-Path
 
-------------------------------------------------------------------------------
Routes : 1
===============================================================================
*A:dut-a#
Table 72:  Output Fields: Router BGP Routes  

Label

Description

BGP Router ID

Displays the local BGP router ID

AS

Displays the configured autonomous system number

Local AS

Displays the configured local AS setting

If not configured, then the value is the same as the AS

Route Dist.

Displays the route distinguisher identifier attached to routes that distinguishes the VPN it belongs

VPN Label

Displays the label generated by the PE label manager

Network

Displays the IP prefix and mask length

Nexthop

Displays the BGP next hop

From

Displays the advertising BGP neighbor IP address

Res. Nexthop

Displays the resolved next hop

Local Pref.

Displays the local preference value

This value is used if the BGP route arrives from a BGP peer without the Local Pref attribute set

It is overridden by any value set via a route policy

Flag

u - used

s - suppressed

h - history

d - decayed

* - valid

i - igp

e - egp

? - incomplete

> - best

Aggregator AS

Displays the aggregator AS value

none - Aggregator AS attributes are not present

Aggregator

Displays the aggregator attribute value

none - Aggregator attributes are not present

Atomic Aggr.

Atomic - The atomic aggregator flag is set

Not Atomic - The atomic aggregator flag is not set

MED

Displays the MED metric value

none - MED metrics are present

Community

Displays the BGP community attribute list

Originator Id

Displays the originator ID path attribute value

none - The originator ID attribute is not present

Peer Router Id

Displays the router ID of the advertising router

AS-Path

Displays the BGP AS path attribute

VPRN Imported

Displays the VPRNs where a particular BGP-VPN received route has been imported and installed

Sample Output — BGP PIC
*A:Dut-A# show router bgp routes ipv4 
===============================================================================
 BGP Router ID:1.1.1.1          AS:100         Local AS:100        
===============================================================================
 Legend -
 Status codes  : u - used, s - suppressed, h - history, d - decayed, * - valid
                 l - leaked, x - stale, > - best, b - backup, p - purge
 Origin codes  : i - IGP, e - EGP, ? - incomplete
===============================================================================
BGP IPv4 Routes
===============================================================================
Flag  Network                                            LocalPref   MED
      Nexthop (Router)                                   Path-Id     Label
      As-Path                                                        
-------------------------------------------------------------------------------
u*>i  10.77.77.77/32                                     100         None
      2.2.2.2                                            1           131066
      200                                                             
ub*i  10.77.77.77/32                                     100         None
      3.3.3.3                                            None        131068
      200                                                             
-------------------------------------------------------------------------------
Routes : 2
===============================================================================
*A:Dut-A# 
Table 73:  Output Fields: BGP Routes IPv4 

Label

Description

BGP Router ID

Displays the local BGP router ID

AS

Displays the configured autonomous system number

Local AS

Displays the configured local AS setting. If not configured, then the value is the same as the AS

BGP IPv4 Routes

Flag

u - used

s - suppressed

h - history

d - decayed

* - valid

i - igp

e - egp

? - incomplete

> - best

Network

Displays the IP prefix and mask length

Nexthop

Displays the BGP next hop

AS-Path

Displays the BGP AS path attribute

Local Pref.

Displays the local preference value

This value is used if the BGP route arrives from a BGP peer without the Local Pref attribute set

It is overridden by any value set via a route policy

MED

Displays the MED metric value

none - MED metrics are present

Path-Id

Displays the path ID

None - The path ID is not present

Label

Displays the MPLS label associated with the BGP route

Routes

Displays the number of routes

Sample Output — EVPN Auto-Disc Routes
*A:Dut-B# show router bgp routes evpn auto-disc 
===============================================================================
 BGP Router ID:10.20.1.2        AS:100         Local AS:100        
===============================================================================
 Legend -
 Status codes  : u - used, s - suppressed, h - history, d - decayed, * - valid
                 l - leaked, x - stale, > - best, b - backup, p - purge
 Origin codes  : i - IGP, e - EGP, ? - incomplete
===============================================================================
BGP EVPN Auto-Disc Routes
===============================================================================
Flag  Route Dist.         ESI                           NextHop
      Tag                                               Label
-------------------------------------------------------------------------------
u*>i  10.20.1.3:1         00:bc:01:00:00:00:00:00:00:01 10.20.1.3
      0                                                 LABEL 131069
u*>i  10.20.1.3:1         00:bc:01:00:00:00:00:00:00:01 10.20.1.3
      MAX-ET                                            LABEL 0
u*>i  10.20.1.4:1         00:de:01:00:00:00:00:00:00:01 10.20.1.4
      0                                                 LABEL 131069
u*>i  10.20.1.4:1         00:de:01:00:00:00:00:00:00:01 10.20.1.4
      MAX-ET                                            LABEL 0
u*>i  10.20.1.5:1         00:de:01:00:00:00:00:00:00:01 10.20.1.5
      0                                                 LABEL 131059
u*>i  10.20.1.5:1         00:de:01:00:00:00:00:00:00:01 10.20.1.5
      MAX-ET                                            LABEL 0
-------------------------------------------------------------------------------
Routes : 6
===============================================================================
Sample Output — EVPN Eth-Seg Routes
*A:Dut-B# show router bgp routes evpn eth-seg 
===============================================================================
 BGP Router ID:10.20.1.2        AS:100         Local AS:100        
===============================================================================
 Legend -
 Status codes  : u - used, s - suppressed, h - history, d - decayed, * - valid
                 l - leaked, x - stale, > - best, b - backup, p - purge
 Origin codes  : i - IGP, e - EGP, ? - incomplete
===============================================================================
BGP EVPN Eth-Seg Routes
===============================================================================
Flag  Route Dist.         ESI                           NextHop
      OrigAddr                                          
-------------------------------------------------------------------------------
u*>i  10.20.1.3:0         00:bc:01:00:00:00:00:00:00:01 10.20.1.3
      10.20.1.3                                          
-------------------------------------------------------------------------------
Routes : 1
===============================================================================
Sample Output — EVPN Inclusive Mcast Routes
*A:Dut-B# show router bgp routes evpn inclusive-mcast 
===============================================================================
 BGP Router ID:10.20.1.2        AS:100         Local AS:100        
===============================================================================
 Legend -
 Status codes  : u - used, s - suppressed, h - history, d - decayed, * - valid
                 l - leaked, x - stale, > - best, b - backup, p - purge
 Origin codes  : i - IGP, e - EGP, ? - incomplete
===============================================================================
BGP EVPN Inclusive-Mcast Routes
===============================================================================
Flag  Route Dist.         OrigAddr            NextHop
      Tag                                     
-------------------------------------------------------------------------------
u*>i  10.20.1.3:1         10.20.1.3           10.20.1.3
      0                                        
u*>i  10.20.1.4:1         10.20.1.4           10.20.1.4
      0                                        
u*>i  10.20.1.5:1         10.20.1.5           10.20.1.5
      0                                        
-------------------------------------------------------------------------------
Routes : 3
===============================================================================
Sample Output — EVPN Mac
*A:Dut-B# show router bgp routes evpn mac 
===============================================================================
 BGP Router ID:10.20.1.2        AS:100         Local AS:100        
===============================================================================
 Legend -
 Status codes  : u - used, s - suppressed, h - history, d - decayed, * - valid
                 l - leaked, x - stale, > - best, b - backup, p - purge
 Origin codes  : i - IGP, e - EGP, ? - incomplete
===============================================================================
BGP EVPN MAC Routes
===============================================================================
Flag  Route Dist.         MacAddr           ESI
      Tag                 Mac Mobility      Ip Address
                                            NextHop
                                            Label1
-------------------------------------------------------------------------------
u*>i  10.20.1.3:1         00:00:00:00:00:03 00:bc:01:00:00:00:00:00:00:01
      0                   Seq:0             N/A
                                            10.20.1.3
                                            LABEL 131069
-------------------------------------------------------------------------------
Routes : 1
===============================================================================
Table 74:  Output Fields: BGP EVPN Routes 

Label

Description

Flag

u - used

s - suppressed

h - history

d - decayed

* - valid

i - igp

e - egp

? - incomplete

> - best

ESI

Displays the Ethernet segment ID value

Route Dist. Tag

Displays the route distinguisher tag

OrigAddr

Displays the BGP originator address

Nexthop

Displays the BGP next hop

MacAddr

Displays the MAC address

Routes

Displays the number of routes

summary

Syntax 
summary [all]
summary [family family] [neighbor ip-address]
Context 
show>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command displays a summary of BGP neighbor information.

The State field displays the global BGP operational state. The valid values are the following:

  1. Up
    The BGP global process is configured and running.
  2. Down
    The BGP global process is administratively shutdown and not running.
  3. Disabled
    The BGP global process is operationally disabled. The process must be restarted by the operator.

For example, if a BGP peer is operationally disabled, the state in the summary table shows the state Disabled.

Parameters 
family—
Specifies the type of routing information to be distributed by the BGP instance
Values—
ipv4 — Displays only those BGP peers that have the IPv4 family enabled.
vpn-ipv4 — Displays only those BGP peers that have the VPN-IPv4 family enabled.
ipv6 — Displays only those BGP peers that have the IPv6 family enabled.
vpn-ipv6 — Displays only those BGP peers that have the VPN-IPv4 family enabled.

 

ip-address—
Displays information for entries received from the BGP neighbor.
Values—

ipv4-address:

a.b.c.d (host bits must be 0)

ipv6-address:

x:x:x:x:x:x:x:x[-interface]

x:x:x:x:x:x:d.d.d.d[-interface]

x:

[0 to FFFF]H

d:

[0 to 255]D

interface: 32 characters maximum, mandatory for link local addresses.

 

Output 

The following output is an example of summary BGP neighbor information, and Table 75 describes the output fields.

Sample Output
A:Dut-C# show router bgp summary neighbor 3FFE::A0A:1064
===============================================================================
 BGP Router ID : 10.20.1.3         AS : 100     Local AS : 100
===============================================================================
BGP Admin State         : Up          BGP Oper State              : Up
Number of Peer Groups   : 4           Number of Peers             : 5
Total BGP Paths         : 8           Total Path Memory           : 1212
Total BGP Active Rts.   : 0           Total BGP Rts.              : 0
Total Suppressed Rts.    : 0           Total Hist. Rts.            : 0
Total Decay Rts.        : 0
 
Total VPN Peer Groups   : 0           Total VPN Peers             : 0
Total VPN Local Rts.    : 0
Total VPN Remote Rts.   : 0           Total VPN Remote Active Rts.: 0
Total VPN Supp. Rts.    : 0           Total VPN Hist. Rts.        : 0
Total VPN Decay Rts.    : 0
 
Total IPv6 Remote Rts.  : 5           Total IPv6 Rem. Active Rts. : 4
===============================================================================
BGP Summary
===============================================================================
Neighbor
                AS    PktRcvd InQ  Up/Down   State|Rcv/Act/Sent (IPv4)
                      PktSent OutQ                 Rcv/Act/Sent (VpnIPv4)
                                                   Rcv/Act/Sent (IPv6)
                                                   Rcv/Act/Sent (MCastIPv4)
-------------------------------------------------------------------------------
 
                  103     489    0 00h40m28s IPv4 Incapable
                          569    0           VPN-IPv4 Incapable
                                             1/1/3
                                             
===============================================================================
A:Dut-C#
 
 
A:SetupCLI>show>router# bgp summary
===============================================================================
 BGP Router ID : 10.3.4.5          AS : 35012   Local AS : 100
===============================================================================
BGP Admin State         : Up          BGP Oper State              : Up
Confederation AS        : 40000
Member Confederations   : 35012 65205 65206 65207 65208
Rapid Withdrawal        : Disabled
Bfd Enabled             : Yes 
 
Number of Peer Groups   : 1           Number of Peers             : 1
Total BGP Paths         : 3           Total Path Memory           : 396
Total BGP Active Rts.   : 0           Total BGP Rts.              : 0
Total Suppressed Rts.    : 0           Total Hist. Rts.            : 0
Total Decay Rts.        : 0
 
Total VPN Peer Groups   : 1           Total VPN Peers             : 1
Total VPN Local Rts.    : 0
Total VPN Remote Rts.   : 0           Total VPN Remote Active Rts.: 0
Total VPN Supp. Rts.    : 0           Total VPN Hist. Rts.        : 0
Total VPN Decay Rts.    : 0
 
===============================================================================
BGP Summary
===============================================================================
Neighbor
                AS    PktRcvd InQ  Up/Down   State|Rcv/Act/Sent (IPv4)
                      PktSent OutQ                 Rcv/Act/Sent (VpnIPv4)
Rcv/Act/Sent (MCastIPv4)
-------------------------------------------------------------------------------
3.3.3.3        20       0    0     01h55m56s Active
                        0    0
===============================================================================
A:SetupCLI>show>router#
Table 75:  Output Fields: Router BGP Summary  

Label

Description

BGP Router ID

Displays the local BGP router ID

AS

Displays the configured autonomous system number

Local AS

Displays the configured local AS setting. If not configured, then the value is the same as the AS.

BGP Admin State

Down - BGP is administratively disabled

Up - BGP is administratively enabled

BGP Oper State

Down - BGP is operationally disabled

Up - BGP is operationally enabled

Bfd

Yes - BFD is enabled

No - BFD is disabled

Number of Peer Groups

Displays the total number of configured BGP peer groups

Number of Peers

Displays the total number of configured BGP peers

Total BGP Active Routes

Displays the total number of BGP routes used in the forwarding table

Total BGP Routes

Displays the total number of BGP routes learned from BGP peers

Total BGP Paths

Displays the total number of unique sets of BGP path attributes learned from BGP peers

Total Path Memory

Displays the total amount of memory used to store the path attributes

Total Suppressed Routes

Displays the total number of suppressed routes due to route damping.

Total History Routes

Displays the total number of routes with history due to route damping

Total Decayed Routes

Displays total number of decayed routes due to route damping

Total VPN Peer Groups

Displays the total number of configured VPN peer groups

Total VPN Peers

Displays the total number of configured VPN peers

Total VPN Local Rts

Displays the total number of configured local VPN routes

Total VPN Remote Rts

Displays the total number of configured remote VPN routes

Total VPN Remote Active Rts.

Displays the total number of active remote VPN routes used in the forwarding table

Total VPN Supp.Rts.

Displays the total number of suppressed VPN routes due to route damping

Total VPN Hist. Rts.

Displays the total number of VPN routes with history due to route damping

Total VPN Decay Rts.

Displays the total number of decayed routes due to route damping

Neighbor

Displays the BGP neighbor address

AS

(Neighbor)

Displays the BGP neighbor autonomous system number

PktRcvd

Displays the total number of packets received from the BGP neighbor

PktSent

Displays the total number of packets sent to the BGP neighbor

InQ

Displays the number of BGP messages to be processed

OutQ

Displays the number of BGP messages to be transmitted

Up/Down

Displays the amount of time that the BGP neighbor has either been established or not established depending on its current state

State|Recv/Actv/Sent

Displays the BGP neighbor’s current state (if not established) or the number of received routes, active routes and sent routes (if established)

5.9.2.4. Clear Commands

damping

Syntax 
damping [[ip-prefix/ip/mask] [neighbor ip-address]] | [group name]
Context 
clear>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command clears or resets the route damping information for received routes.

Parameters 
ip-prefix/mask—
Clears damping information for entries for the specified IP address.
Values—

ipv4-prefix:

a.b.c.d (host bits must be 0)

ipv4-prefix-length:

0 to 32

ipv6-prefix:

x:x:x:x:x:x:x:x (eight 16-bit pieces)

x:x:x:x:x:x:d.d.d.d

x: [0 to FFFF]H

d: [0 to 255]D

ipv6-prefix-length:

0 to 128

 

ip-address—
Clears damping information for entries received from the BGP neighbor.
Values—
a.b.c.d

 

group name
Clears damping information for entries received from any BGP neighbors in the peer group, up to 32 characters.

flap-statistics

Syntax 
flap-statistics [[ip-prefix/mask] [neighbor ip-address]] | [group group-name] | [regex reg-exp] | [policy policy-name]
Context 
clear>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command clears route flap statistics.

Parameters 
ip-prefix/mask—
Clears route flap statistics for entries that match the specified IP address.
Values—

ip-prefix:

a.b.c.d (host bits must be 0)

mask:

0 to 32

ipv6-prefix:

x:x:x:x:x:x:x:x (eight 16-bit pieces)

x:x:x:x:x:x:d.d.d.d

x: [0 to FFFF]H

d: [0 to 255]D

ipv6-prefix-length:

0 to 128

 

ip-address—
Clears route flap statistics for entries received from the specified BGP neighbor.
Values—
a.b.c.d

 

group group-name
Clears route flap statistics for entries received from any BGP neighbors in the specified peer group, up to 32 characters.
regex reg-exp
Clears route flap statistics for all entries which have the regular expression and the AS path that matches the regular expression, up to 80 characters.
policy policy-name
Clears route flap statistics for entries that match the specified route policy, up to 32 characters.

neighbor

Syntax 
neighbor {ip-address | as as-number | external | all} [soft | soft-inbound]
neighbor{ip-address | as as-number | external | all} statistics
neighbor ip-address end-of-rib
Context 
clear>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command resets the specified BGP peers. This can cause existing BGP connections to be shut down and restarted.

Parameters 
ip-address—
Resets the BGP neighbor with the specified IP address.
Values—
ipv4-address: a.b.c.d

 

as as-number
Resets all BGP neighbors with the specified peer AS.
Values—
1 to 65535

 

external—
Keyword to reset all eBGP neighbors.
all—
Keyword to reset all BGP neighbors.
soft—
The specified BGP neighbors reevaluate all routes in the Local-RIB against the configured export policies.
soft-inbound—
The specified BGP neighbors reevaluate all routes in the RIB-In against the configures import policies.
statistics—
Keyword to clear the BGP neighbor statistics.
end-of-rib—
Keyword to clear the Routing Information Base (RIB).

protocol

Syntax 
protocol
Context 
clear>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command resets the entire BGP protocol.

5.9.2.5. Debug Commands

events

Syntax 
events [neighbor ip-address | group name]
no events
Context 
debug>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command logs all events changing the state of a BGP peer.

Parameters 
neighbor ip-address
Debugs only events affecting the specified BGP neighbor.
Values—
ipv4-address: a.b.c.d (host bits must be 0)

 

group name
Debugs only events affecting the specified peer group and associated neighbors, up to 32 characters.

keepalive

Syntax 
keepalive [neighbor ip-addr | group name]
no keepalive
Context 
debug>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command decodes and logs all sent and received keepalive messages in the debug log.

Parameters 
neighbor ip-address
Debugs only events affecting the specified BGP neighbor.
Values—
ipv4-address: a.b.c.d (host bits must be 0)

 

group name
Debugs only events affecting the specified peer group and associated neighbors, up to 32 characters.

notification

Syntax 
notification [neighbor ip-address | group name]
no notification
Context 
debug>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command decodes and logs all sent and received notification messages in the debug log.

Parameters 
neighbor ip-address
Debugs only events affecting the specified BGP neighbor.
Values—
ipv4-address: a.b.c.d (host bits must be 0)

 

group name
Debugs only events affecting the specified peer group and associated neighbors, up to 32 characters.

open

Syntax 
open [neighbor ip-address | group name]
no open
Context 
debug>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command decodes and logs all sent and received open messages in the debug log.

Parameters 
neighbor ip-address
Debugs only events affecting the specified BGP neighbor.
Values—
ipv4-address: a.b.c.d (host bits must be 0)

 

group name
Debugs only events affecting the specified peer group and associated neighbors, up to 32 characters.

outbound-route-filtering

Syntax 
[no] outbound-route-filtering
Context 
debug>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables debugging for all BGP outbound route filtering (ORF) packets. ORF is used to inform a neighbor of targets (using target-list) that it is willing to receive.

packets

Syntax 
packets [neighbor ip-address | group name]
packets
Context 
debug>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command decodes and logs all sent and received BGP packets in the debug log.

Parameters 
neighbor ip-address
Debugs only events affecting the specified BGP neighbor.
Values—
ipv4-address: a.b.c.d (host bits must be 0)

 

group name
Debugs only events affecting the specified peer group and associated neighbors, up to 32 characters.

route-refresh

Syntax 
route-refresh [neighbor ip-address | group name]
no route-refresh
Context 
debug>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables and disables debugging for BGP route-refresh.

Parameters 
neighbor ip-address
Debugs only events affecting the specified BGP neighbor.
Values—
ipv4-address: a.b.c.d (host bits must be 0)

 

group name
Debugs only events affecting the specified peer group and associated neighbors, up to 32 characters.

rtm

Syntax 
rtm [neighbor ip-address | group name]
no rtm
Context 
debug>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command logs RTM changes in the debug log.

Parameters 
neighbor ip-address
Debugs only events affecting the specified BGP neighbor.
Values—
ipv4-address: a.b.c.d (host bits must be 0)

 

group name
Debugs only events affecting the specified peer group and associated neighbors, up to 32 characters.

socket

Syntax 
socket [neighbor ip-address | group name]
no socket
Context 
debug>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command logs all TCP socket events to the debug log.

Parameters 
neighbor ip-address
Debugs only events affecting the specified BGP neighbor.
Values—
ipv4-address: a.b.c.d (host bits must be 0)

 

group name
Debugs only events affecting the specified peer group and associated neighbors, up to 32 characters.

timers

Syntax 
timers [neighbor ip-address | group name]
no timers
Context 
debug>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command logs all BGP timer events to the debug log.

Parameters 
neighbor ip-address
Debugs only events affecting the specified BGP neighbor.
Values—
ipv4-address: a.b.c.d (host bits must be 0)

 

group name
Debugs only events affecting the specified peer group and associated neighbors, up to 32 characters.

update

Syntax 
update [neighbor ip-address | group name]
no update
Context 
debug>router>bgp
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command decodes and logs all sent and received update messages in the debug log.

Parameters 
neighbor ip-address
Debugs only events affecting the specified BGP neighbor.
Values—
ipv4-address: a.b.c.d (host bits must be 0)

 

group name
Debugs only events affecting the specified peer group and associated neighbors, up to 32 characters.