6.13. BGP Command Reference

6.13.1. Command Hierarchies

6.13.1.1. Configuration Commands

6.13.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
vpn-ipv4 send send-limit receive [none]
vpn-ipv4 send send-limit
— no vpn-ipv4
vpn-ipv6 send send-limit receive [none]
vpn-ipv6 send send-limit
— no vpn-ipv6
auth-keychain name
authentication-key {authentication-key | hash-key} [hash | hash2]
[no] backup-path [ipv4] [ipv6]
always-compare-med [zero | infinity]
always-compare-med strict-as [zero | infinity]
as-path-ignore [ipv4] [vpn-ipv4] [ipv6] [vpn-ipv6] [mvpn-ipv4]
[no] bfd-enable
cluster cluster-id
— no cluster
connect-retry seconds
[no] damping
description description-string
disable-communities [standard] [extended]
export policy-name [policy-name…(up to 5 max)]
— no export [policy-name]
family [ipv4] [ipv6] [vpn-ipv4] [vpn-ipv6] [mvpn-ipv4] [route-target]
— no family
[no] group name
[no] add-paths
hold-time seconds [min seconds2]
— no hold-time
import policy-name [policy-name…(up to 5 max)]
— no import [policy-name]
keepalive seconds
— no keepalive
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
multipath integer
— no multipath
[no] accept-orf
send-orf [comm-id...(up to 32 max)]
— no send-orf comm-id
preference preference
— no preference
[no] remove-private [limited]
route-target-list comm-id [comm-id...(up to 15 max)]
— no route-target-list [comm-id]
router-id ip-address
— no router-id
[no] shutdown
[no] split-horizon
transport-tunnel {ldp | rsvp-te | mpls}

6.13.1.1.2. Group BGP Commands

config
— router [router-name]
[no] bgp
[no] group name
[no] add-paths
— 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
vpn-ipv4 send send-limit receive [none]
vpn-ipv4 send send-limit
— no vpn-ipv4
vpn-ipv6 send send-limit receive [none]
vpn-ipv6 send send-limit
— no vpn-ipv6
auth-keychain name
authentication-key {authentication-key | hash-key} [hash | hash2]
[no] bfd-enable
cluster cluster-id
— no cluster
connect-retry seconds
[no] damping
description description-string
disable-communities [standard] [extended]
export policy-name [policy-name…(up to 5 max)]
— no export [policy-name]
family [ipv4] [vpn-ipv4] [ipv6] [vpn-ipv6] [mvpn-ipv4] [route-target]
— no family
hold-time seconds [min seconds2]
— no hold-time
import policy-name [policy-name…(up to 5 max)]
— no import [policy-name]
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] neighbor ip-address
[no] next-hop-self
[no] accept-orf
send-orf [comm-id...(up to 32 max)]
— no send-orf comm-id
[no] passive
peer-as as-number
— no peer-as
preference preference
— no preference
prefix-limit limit
[no] remove-private [limited]
[no] shutdown
[no] split-horizon
ttl-security min-ttl-value

6.13.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
vpn-ipv4 send send-limit receive [none]
vpn-ipv4 send send-limit
— no vpn-ipv4
vpn-ipv6 send send-limit receive [none]
vpn-ipv6 send send-limit
— no vpn-ipv6
auth-keychain name
authentication-key {authentication-key | hash-key} [hash | hash2]
[no] bfd-enable
cluster cluster-id
— no cluster
connect-retry seconds
[no] damping
description description-string
disable-communities [standard] [extended]
export policy-name [policy-name…(up to 5 max)]
— no export [policy-name]
family [ipv4] [vpn-ipv4] [ipv6] [vpn-ipv6] [mvpn-ipv4] [route-target]
— no family
hold-time seconds [min seconds2]
— no hold-time
import policy-name [policy-name…(up to 5 max)]
— no import [policy-name]
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] next-hop-self
[no] accept-orf
send-orf [comm-id...(up to 32 max)]
— no send-orf comm-id
[no] passive
peer-as as-number
— no peer-as
preference preference
— no preference
prefix-limit limit
[no] remove-private [limited]
[no] shutdown
[no] split-horizon
ttl-security min-ttl-value

6.13.1.1.4. Other BGP-Related Commands

config
— router [router-name]
aggregate ip-prefix/ip-prefix-length [summary-only]
— no aggregate ip-prefix/ip-prefix-length
autonomous-system as-number
router-id ip-address
— no router-id

6.13.1.2. Show Commands

show
router [router-instance]
router service-name service-name
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
damping [ip-prefix[/ip-prefix-length]] [damp-type] [detail] mvpn-ipv4
group [name] [detail]
neighbor [ip-address [detail]]
neighbor [as-number [detail]]
neighbor [ip-address [family [type mvpn-type]] 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 [prefix] [detail | longer | hunt [brief]]
routes vpn-ipv4 prefix [rd rd] [detail | longer | hunt [brief]]
routes vpn-ipv6 prefix [rd rd] [detail | longer | hunt [brief]]
routes [family [type mvpn-type]] community comm-id
routes [family [type mvpn-type]] aspath-regex reg-ex
routes mvpn-ipv4 type mvpn-type {rd rd | originator-ip ip-address | source-ip ip-address | group-ip ip-address | source-as as-number} [hunt | detail]
summary [all]
summary [family family] [neighbor ip-address]

6.13.1.3. Clear Commands

clear
— router
— bgp
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

6.13.1.4. Debug Commands

debug
— router
— bgp
events [neighbor ip-address | group name]
— no events
graceful-restart [neighbor ip-address | group name]
keepalive [neighbor ip-address | group name]
— no keepalive
notification [neighbor ip-address | group name]
— no notification
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

6.13.2. Command Descriptions

6.13.2.1. Configuration Commands

6.13.2.1.1. Configuration Commands

bgp

Syntax 
[no] bgp
Context 
config>router
Description 

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

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

Default 

no bgp

add-paths

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

This command creates the add-paths configuration context and enables add-paths to be configured for one or more families on a BGP instance, BGP group, or BGP neighbor. The BGP add-paths capability allows the router to send and/or receive multiple paths per prefix to/from a peer. The add-paths command without additional parameters is equivalent to removing add-paths support for all address families, which causes sessions that previously negotiated the add-paths capability for one or more address families to go down and come back up without the add-paths capability.

The no form of the command removes add-paths from the configuration of BGP, BGP group, or BGP neighbor, causing sessions established using add-paths to go down and come back up without the add-paths 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
Description 

This command is used to configure the add-paths capability for IPv4 routes (including labeled IPv4 routes on BGP route tunnels). By default, add-paths is not enabled for IPv4 routes.

The maximum number of paths to send per IPv4 prefix is the configured send limit, which is a mandatory parameter. The capability to receive multiple paths per prefix from a peer is configurable using the receive keyword, which is optional. If the receive keyword is not included in the command, the receive capability is enabled by default. Entering the command without optional parameters enables the ability to both send and receive multiple paths per IPv4 prefix with each peer, and configures the router to send the two best paths per prefix to each peer using the default Add-N, N=2 path selection algorithm.

The BGP advertise-inactive, add-paths, and export policy commands can be configured such that active, non-BGP routes are advertised. For more information, see Advertise-Inactive, Add-Paths, and Export Policy Interaction.

The no form of the command removes 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 —
the maximum number of paths per IPv4 prefix that are allowed to 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/or route advertisement rules.
Values—
1 to 16, or none

 

receive —
configures the router to negotiate the add-paths receive capability for IPv4 routes with its peers
none —
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
Description 

This command is used to configure the add-paths capability for unlabeled IPv6 unicast routes. By default, add-paths is not enabled for unlabeled IPv6 unicast routes.

The maximum number of unlabeled unicast paths to send per IPv6 prefix is the configured send limit, which is a mandatory parameter. The capability to receive multiple unlabeled IPv6 unicast paths per prefix from a peer is configurable using the receive keyword, which is optional. If the receive keyword is not included in the command, the receive capability is enabled by default.

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

Default 

no ipv6

Parameters 
send-limit
the maximum number of paths per unlabeled IPv6 unicast prefix that are allowed to be advertised to add-path peers. (The actual number of advertised routes may be less.) If the value is none, the router does not negotiate the send capability with respect to IPv6 AFI/SAFI.
Values—
1 to 16, or none

 

receive —
the router negotiates to receive multiple unlabeled unicast routes per IPv6 prefix
none—
the router does not negotiate to receive multiple unlabeled unicast routes per IPv6 prefix

vpn-ipv4

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

This command is used to configure the add-paths capability for VPN-IPv4 routes. By default, add-paths is not enabled for VPN-IPv4 routes.

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

The BGP advertise-inactive, add-paths, and export policy commands can be configured such that active, non-BGP routes are advertised. For more information, see Advertise-Inactive, Add-Paths, and Export Policy Interaction.

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

Default 

no vpn-ipv4

Parameters 
send-limit —
the maximum number of paths per VPN-IPv4 prefix that are allowed to 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/or route advertisement rules.
Values—
1 to 16, or none

 

receive —
configures the router to negotiate the add-paths receive capability for VPN-IPv4 routes with its peers
none —
the router does not negotiate the add-paths receive capability for VPN-IPv4 routes with its peers

vpn-ipv6

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

This command is used to configure the add-paths capability for VPN-IPv6 routes. By default, add-paths is not enabled for VPN-IPv6 routes.

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

The BGP advertise-inactive, add-paths, and export policy commands can be configured such that active, non-BGP routes are advertised. For more information, see Advertise-Inactive, Add-Paths, and Export Policy Interaction.

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

Default 

no vpn-ipv6

Parameters 
send-limit —
the maximum number of paths per VPN-IPv6 prefix that are allowed to 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/or route advertisement rules.
Values—
1 to 16, or none

 

receive —
configures the router to negotiate the add-paths receive capability for VPN-IPv6 routes with its peers
none —
the router does not negotiate the add-paths receive capability for VPN-IPv6 routes with its peers

advertise-inactive

Syntax 
[no] advertise-inactive
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
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 given 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 given destination.

The BGP advertise-inactive, add-paths, and export policy commands can be configured such that active, non-BGP routes are advertised. For more information, see Advertise-Inactive, Add-Paths, and Export Policy Interaction.

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

Default 

no advertise-inactive

advertise-label

Syntax 
advertise-label ipv4
[no] advertise-label
Context 
config>router>bgp>group>neighbor
Description 

This command configures the IPv4 transport peers to exchange labeled-BGP routes for the IPv4 address family.

When ipv4 is enabled, all IPv4 routes advertised to the remote BGP peer will be sent with an RFC 3107-formatted label for the destination route.

The no form of the command disables advertising of labeled routes.

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

aggregator-id-zero

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

This command is used to set the router ID in the BGP aggregator path attribute to 0 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 AS number and router ID to the aggregator path attribute.

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

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

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

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

Default 

no aggregator-id-zero

auth-keychain

Syntax 
auth-keychain name
no auth-keychain
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Description 

This command associates an authentication keychain with the BGP protocol. The keychain is a collection of keys used to authenticate BGP messages from remote neighbors. The keychain allows the rollover of authentication keys during the lifetime of a session and also supports stronger authentication algorithms than clear text and MD5.

The keychain must already be defined in the config>system>security>keychain context.

Either the authentication-key command or the auth-keychain command can be used by BGP, but both cannot be supported at the same time. If both commands are configured, the auth-keychain configuration will be applied and the authentication-key command will be ignored.

By default, authentication is not enabled.

Default 

no auth-keychain

Parameters 
name—
the name of an existing keychain, up to 32 characters

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
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 MD5 message-based digest.

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

The TCP MD5 key information used to securely communicate with a BGP peer is retained even after the connection has closed, allowing connectionless RST packets to be sent with the proper authentication data.

Either the authentication-key command or the auth-keychain command can be used by BGP, but both cannot be supported at the same time. If both commands are configured, the auth-keychain configuration will be applied and the authentication-key command will be ignored.

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

Default 

MD5 authentication is disabled by default

Parameters 
authentication-key —
the authentication key. The key can be any combination of ASCII characters up to 255 characters in length (unencrypted). If spaces are used in the string, the entire string must be enclosed in quotation marks (“ ”).
hash-key—
the hash key. The key can be any combination of ASCII characters up to 342 characters in length (encrypted). If spaces are used in the string, the entire string must be enclosed 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 that 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 that 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
Description 

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

When 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. The time to reroute the traffic is independent of the number of prefixes sharing the primary or backup paths.

Default 

no backup-path

Parameters 
ipv4—
enables a backup path for IPv4 BGP learned prefixes
ipv6 —
enables a backup path for IPv6 BGP learned prefixes

best-path-selection

Syntax 
best-path-selection
Context 
config>router>bgp
Description 

This command enables path selection configuration.

always-compare-med

Syntax 
always-compare-med [zero | infinity]
always-compare-med strict-as [zero | infinity]
no always-compare-med
Context 
config>router>bgp>path-selection
Description 

This command specifies how the Multi-Exit Discriminator (MED) path attribute is used in the BGP route selection process.

If this command is used without the strict-as option, the MEDs of two paths are always compared even if the paths have a different neighbor AS.

If the strict-as option is used, the MEDs of two paths are compared only if they come from the same neighboring AS.

The zero and infinity options specify how to treat paths that do not have a MED attribute; for example, always-compare-med zero means that if one path is missing a MED attribute, it is treated as though it had a MED attribute with the value of 0. If neither option is specified, the zero option is implied.

The no form of the command means that only the MEDs of paths that have the same neighbor AS are compared.

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 (4294967295) 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 only if they come from the same neighboring AS

as-path-ignore

Syntax 
as-path-ignore [ipv4] [ipv6] [vpn-ipv4] [vpn-ipv6] [mvpn-ipv4]
no as-path-ignore
Context 
config>router>bgp>path-selection
Description 

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

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

When as-path-ignore is used without specifying any keywords, all keywords are configured.

The no form of the command means that the AS paths of incoming routes are used to determine the best BGP route.

Default 

no as-path-ignore

Parameters 
ipv4—
specifies that the AS path length will be ignored for all IPv4 routes
ipv6—
specifies that the AS path length will be ignored for all IPv6 routes
vpn-ipv4—
specifies that the AS path length will be ignored for all VPN-IPv4 routes
vpn-ipv6—
specifies that the AS path length will be ignored for all VPN-IPv6 routes
mvpn-ipv4—
specifies that the AS path length will be ignored for all MVPN-IPv4 routes

bfd-enable

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

This command enables the use of bidirectional forwarding (BFD) to control the state of the associated protocol interface. By enabling BFD on a given 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 BFD are set via the BFD command under the IP interface.

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

Default 

no bfd-enable

cluster

Syntax 
cluster cluster-id
no cluster
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Description 

This command configures the cluster ID for a route reflector server.

Route reflectors are used to reduce the number of IBGP sessions required within an AS. Normally, all BGP speakers within an AS must have a BGP peering with every other BGP speaker in the AS. A route reflector and its clients form a cluster. Peers that are not part of the cluster are considered to be non-clients.

When a route reflector receives a route, it must first select the best path from all the paths received. If the route was received from a non-client peer, then the route reflector sends the route to all clients in the cluster. If the route came from a client peer, the route reflector sends the route to all non-client peers and to all client peers except the originator.

For redundancy, a cluster can have multiple route reflectors.

The no form of the command deletes the cluster ID and effectively disables route reflection for the given group.

Default 

no cluster

Parameters 
cluster-id —
the route reflector cluster ID, expressed in dotted-decimal notation
Values—
any 32-bit number in dotted-decimal notation (0.0.0.1 to 255.255.255.255)

 

connect-retry

Syntax 
connect-retry seconds
no connect-retry
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
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), 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 the command used at the global level reverts to the default value.

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

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

Default 

120 s

Parameters 
seconds —
the 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
Description 

This command enables BGP route damping for learned routes that 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 at the route policy level. See 7705 SAR Router Configuration Guide, ‘Route Policy Command Reference”.

The no form of the command disables learned route damping.

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

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

Default 

no damping

default-route-target

Syntax 
[no] default-route-target
Context 
config>router>bgp>group
config>router>bgp>group>neighbor
Description 

This command advertises the default RTC route towards the selected peers.

The default RTC route is a special route that has a prefix length of zero. Sending the default RTC route to a peer conveys a request to receive all VPN routes from that peer, whether or not they match the route target extended community. Advertising the default RTC route to a peer does not suppress other more specific RTC routes from being sent to that peer.

The no form of the command blocks the router from advertising the default RTC route.

Default 

no default-route-target

description

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

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

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

Default 

No description is associated with the configuration context

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

disable-client-reflect

Syntax 
[no] disable-client-reflect
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Description 

This command disables the reflection of routes by the route reflector to the clients in a specific group or neighbor.

This command only disables the reflection of routes from other client peers. Routes learned from non-client peers are still reflected to all clients.

The no form re-enables client reflection of routes.

Default 

no disable-client-reflect

disable-communities

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

This command configures BGP to disable sending communities.

Default 

no disable-communities

Parameters 
standard—
specifies standard communities that existed before VPRNs or RFC 2547
extended—
specifies BGP communities that were expanded after the concept of RFC 2547 was introduced, to include handling the route target from the VRF

disable-fast-external-failover

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

This command configures BGP fast external failover.

For EBGP neighbors, this feature controls whether the router should drop an EBGP session immediately upon an interface-down event, or whether the BGP session should be kept up until the hold-time expires.

When fast external failover is disabled, the EBGP session stays up until the hold-time expires or the interface comes back up. If the BGP routes become unreachable as a result of the down IP interface, BGP withdraws the unavailable route immediately from other peers.

Default 

no disable-communities

enable-peer-tracking

Syntax 
[no] enable-peer-tracking
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
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 hold timer to expire; therefore, the BGP reconvergence process is accelerated.

The no form of the command disables peer tracking.

Default 

no enable-peer-tracking

enable-rr-vpn-forwarding

Syntax 
[no] enable-rr-vpn-forwarding
Context 
config>router>bgp
Description 

This command enables a route reflector of VPN-IP routes to be deployed in the data path between two BGP peers (a peer X and a peer Y) in a next-hop resolution.

All received VPN-IP routes are imported into a table that is used to resolve the BGP next hops. The next hop of a VPN-IP route that is imported from peer X and selected as having the best path by the table is advertised to peer Y (the next-hop-self command must be set for peer Y or a next-hop action must be used in an export policy that is applied to peer Y in order for the next-hop to be advertised to peer Y).

A new VPN service label value is then allocated for the VPN-IP route. This new label is advertised to peer Y and a label swap operation is then performed by the IOM.

The no form of the command disables the advertising of a new VPN service label from one BGP peer to another.

Default 

no enable-rr-vpn-forwarding

export

Syntax 
export policy-name [policy-name…(up to 5 max)]
no export [policy-name]
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Description 

This command specifies the export route policy used to determine which routes are advertised to peers. Route policies are configured in the config>router>policy-options context. Refer to the section on “Route Policy” in the 7705 SAR Router Configuration Guide.

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 level is used.

When multiple policy names are specified, the policies are evaluated in the order in which 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 BGP advertise-inactive, add-paths, and export policy commands can be configured such that active, non-BGP routes are advertised. For more information, see Advertise-Inactive, Add-Paths, and Export Policy Interaction.

The no form of the 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 —
the route policy name. Allowed values are any string up to 32 characters long composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes.

family

Syntax 
family [ipv4] [vpn-ipv4] [ipv6] [vpn-ipv6] [mvpn-ipv4] [route-target]
no family
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Description 

This command specifies the address family or families to be supported over BGP peerings in the base router. One or more address families can be specified in a single command. To add an address family to the currently configured families, reissue the command and include the current families in addition to any new family.

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

Default 

ipv4

Parameters 
ipv4—
supports IPv4 routing information
vpn-ipv4—
exchanges VPN-IPv4 routing information
ipv6—
supports IPv6 routing information
vpn-ipv6—
exchanges VPN-IPv6 routing information
mvpn-ipv4—
exchanges MVPN-IPv4 routing information
route-target—
exchanges RTC routing information

graceful-restart

Syntax 
[no] graceful-restart
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Description 

The command enables procedures for BGP graceful restart (GR) helper—the receiving router role, as defined in the RFC 4724 standard—for all received IPv4 and VPN-IPv4 routes. In order for helper mode to be available for a particular address family, both peers must signal GR support for the address family during capability negotiation.

When a neighbor covered by GR helper mode restarts its control plane, the forwarding of traffic can continue uninterrupted while the session is being re-established and routes are relearned.

The no form of the command disables graceful restart and removes all graceful restart configurations in the BGP instance.

Default 

no graceful-restart

stale-routes-time

Syntax 
stale-routes-time time
no stale-routes-time
Context 
config>router>bgp>graceful-restart
config>router>bgp>group>graceful-restart
config>router>bgp>group>neighbor>graceful-restart
Description 

This command configures the maximum amount of time in seconds that stale routes should be maintained after a graceful restart is initiated.

The no form of the command resets the stale routes time back to the default value.

Default 

360 s

Parameters 
time —
the amount of time that stale routes should be maintained after a graceful restart is initiated
Values—
1 to 3600 s

 

group

Syntax 
[no] group name
Context 
config>router>bgp
Description 

This command creates a context to configure a BGP peer group.

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

Default 

no group

Parameters 
name—
the peer group name. Allowed values are any string up to 32 characters long 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 [min seconds2]
no hold-time
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Description 

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

The BGP hold time specifies the maximum time 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.

The min option ensures a minimum hold time for a BGP session that is independent of the hold time advertised in a received Open message. The min option replaces the strict keyword used prior to Release 7.0. If a pre-Release 7.0 configuration database file is loaded that contains the strict keyword, the default value for min is set to the same value as the hold time (that is, seconds2 is equal to seconds).

Even though the 7705 SAR 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, then 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 0, then the operational value of the keepalive time is set to 0; 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 the command used at the global level reverts to the default value.

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

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

Default 

90 s

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

 

seconds2—
the minimum hold time, in seconds, that will be accepted for the session. If the peer proposes a hold time lower than this value, the session attempt will be rejected.
Values—
0, 3 to 65535

 

ibgp-multipath

Syntax 
[no] ibgp-multipath
Context 
config>router>bgp
Description 

This command enables IBGP multipath load balancing when adding BGP routes to the route table if the route resolving the BGP next-hop offers multiple next-hops.

The no form of the command disables the IBGP multipath load balancing feature.

Default 

no ibgp-multipath

import

Syntax 
import policy-name [policy-name…(up to 5 max)]
no import [policy-name]
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
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. Refer to the section on “Route Policy” in the 7705 SAR Router Configuration Guide.

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 level is used.

When multiple policy names are specified, the policies are evaluated in the order in which 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 the 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 —
the route policy name. Allowed values are any string up to 32 characters long composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes.

keepalive

Syntax 
keepalive seconds
no keepalive
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
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 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 7705 SAR 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, then 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, then the keepalive value is reset to one third of the specified hold-time interval.
  3. If the hold-time interval is set to 0, then the configured value of the 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 the command used at the global level reverts to the default value.

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

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

Default 

30 s

Parameters 
seconds —
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
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, the 7705 SAR 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 the command removes the configured local address for BGP.

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

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

Default 

no local-address

Parameters 
ip-address—
the local address. The allowed value is a valid routable IP address on the router, either an interface or system IP address.
Values—
ipv4-address:       a.b.c.d (host bits must be 0)

 

local-as

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

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

In addition to the AS number configured for BGP in the config>router>autonomous-system context, a virtual (local) AS number is configured. The virtual AS number is added to the as-path attribute before the router’s AS number 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 group) or neighbor level (only applies to specified peer). By specifying this parameter 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 AS number.

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

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 AS number.

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. Thus, router P adds AS1 to the as-path message for routes it advertises to the customer router.

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

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

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

Default 

no local-as

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

 

private —
specifies that 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
Description 

This command configures the default value of the BGP local preference attribute if it is not already specified in incoming routes.

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 group) or neighbor level (only applies to specified peer). The most specific value is used.

The no form of the 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 a local preference value of 100.

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

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

Default 

no local-preference

Parameters 
local-preference —
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
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 group) or neighbor level (only applies to specified peer). The most specific value is used.

When applied to an ongoing BGP peer session, this command does not take effect until the BGP peer session is re-established.

The no form of the command used at the global level reverts to the default (ignore- loop).

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

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

Default 

ignore-loop

Parameters 
drop-peer —
sends a notification to the remote peer and drops the session
discard-route—
discards routes received from a peer with the same AS number as the router itself. 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—
ignores 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
Description 

This command is used to advertise the Multi-Exit Discriminator (MED) to BGP peers and assign the path value if the MED is not already set via a route policy (the specified value can be overridden by a MED value that is set via a route policy using the metric command. See the 7705 SAR Router Configuration Guide, “Route Policy Configuration Commands”).

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

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

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

Default 

no med-out (the MED is not advertised)

Parameters 
number—
the MED path value
Values—
0 to 4294967295

 

igp-cost—
the MED is set to the IGP cost of the IP prefix that is defined via a route policy

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
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 group) or neighbor level (only applies to specified peer). The most specific value is used.

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

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

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

Default 

15 s

Parameters 
seconds —
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
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 group) or neighbor level (only applies to specified peer). The most specific value is used.

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

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

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

Default 

30 s

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

 

multihop

Syntax 
multihop ttl-value
no multihop
Context 
config>service>router>bgp
config>service>router>bgp>group
config>service>router>bgp>group>neighbor
Description 

This command configures the time to live (TTL) value at an originating BGP peer. The TTL value is entered in the IP header of packets that are sent to a terminating BGP peer that is multiple hops away.

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

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

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

Default 

1 — EBGP peers are directly connected

64 — IBGP peer

Parameters 
ttl-value —
the TTL value that will be entered in the IP header of packets that are sent to a terminating BGP peer that is multiple hops away
Values—
1 to 255

 

multipath

Syntax 
multipath integer
no multipath
Context 
config>router>bgp
Description 

This command enables BGP multipath.

When multipath is enabled, BGP load-shares traffic across multiple links. Multipath can be configured to load-share traffic across a maximum of 16 routes. If the equal-cost routes available are more than the configured value, then routes with the lowest next-hop IP address value are chosen.

This configuration parameter is set at the global level (applies to all peers).

Multipath is disabled if the value is set to 1. When multipath is disabled and multiple equal-cost routes are available, the route with the lowest next-hop IP address will be used.

The no form of the command reverts to the default where multipath is disabled.

Default 

no multipath

Parameters 
integer —
the number of equal-cost routes to use for multipath routing. If more equal-cost routes exist than the configured value, routes with the lowest next-hop value are chosen. Setting this value to 1 disables multipath.
Values—
1 to 16

 

mvpn-vrf-import-subtype-new

Syntax 
[no] mvpn-vrf-import-subtype-new
Context 
config>router>bgp
Description 

This command enables the type/subtype in advertised routes to be encoded as 0x010b (extended community type: transitive IPv4-address-specific VRF route import).

The no form of the command encodes the type/subtype as 0x010a (extended community type: transitive IPv4-address-specific L2VPN identifier), in order to preserve backwards compatibility.

Default 

no mvpn-vrf-import-subtype-new

neighbor

Syntax 
[no] neighbor ip-address
Context 
config>router>bgp>group
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 configurations.

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

Default 

no neighbor — no neighbors are defined

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

 

split-horizon

Syntax 
[no] split-horizon
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Description 

This command enables the use of split horizon. Split horizon prevents routes from being reflected back to a peer that sends the best route. It applies to routes of all address families and to any type of sending peer: EBGP and IBGP.

By default, split horizon is not enabled, meaning that no effort is taken to prevent a best route from being reflected back to the sending peer.

Note:

Enabling split horizon may have a detrimental impact on peer and route scaling; therefore, operators are encouraged to use it only when absolutely needed.

Default 

no split-horizon

next-hop-self

Syntax 
[no] next-hop-self
Context 
config>router>bgp>group
config>router>bgp>group>neighbor
Description 

This command configures the group or neighbor to always set the next-hop path attribute to its own physical interface when advertising to a peer.

This command is primarily used to avoid third-party route advertisements when connected to a multi-access network.

The no form of the command used at the group level allows third-party route advertisements in a multi-access network.

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

Default 

no next-hop-self

outbound-route-filtering

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

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

Default 

no outbound-route-filtering

extended-community

Syntax 
[no] extended-community
Context 
config>router>bgp>outbound-route-filtering
config>router>bgp>group>outbound-route-filtering
config>router>bgp>group>neighbor>outbound-route-filtering
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 sub-commands (send-orf, accept-orf) must be removed first.

Default 

no extended-community

accept-orf

Syntax 
[no] accept-orf
Context 
config>router>bgp>outbound-route-filtering>extended-community
config>router>bgp>group>outbound-route-filtering>extended-community
config>router>bgp>group>neighbor>outbound-route-filtering>extended-community
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.

The no form of the 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.

Default 

no accept-orf

send-orf

Syntax 
send-orf [comm-id...(up to 32 max)]
no send-orf [comm-id]
Context 
config>router>bgp>outbound-route-filtering>extended-community
config>router>bgp>group>outbound-route-filtering>extended-community
config>router>bgp>group>neighbor>outbound-route-filtering>extended-community
Description 

This command instructs the router to negotiate the send capability in the BGP outbound route filtering (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.

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.

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.

Default 

no send-orf

Parameters 
comm-id —
any community policy that consists exclusively of route target extended communities. If the policy is not specified, then the ORF policy is automatically generated from configured route target lists, accepted client route target ORFs, and locally configured route targets.
Values—
comm-id:              target: {ip-addr:comm-val | as-number:ext-                             comm-val}
ip-addr:                a.b.c.d
comm-val:             0 to 65535
as-number:            0 to 65535
ext-comm-val:       0 to 4294967295

 

passive

Syntax 
[no] passive
Context 
config>router>bgp>group
config>router>bgp>group>neighbor
Description 

This command enables and disables passive mode for the BGP group or neighbor. When in passive mode, BGP will not attempt to actively connect to the configured BGP peers but responds only when it receives a connect open request from the peer.

The no form of the command used at the group level disables passive mode, and BGP actively attempts to connect to its peers.

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

Default 

no passive

peer-as

Syntax 
peer-as as-number
no peer-as
Context 
config>router>bgp>group
config>router>bgp>group>neighbor
Description 

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

For IBGP peers, the peer AS number must be the same as the autonomous system number of this router configured under the global level.

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

Default 

no AS numbers are defined

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

 

preference

Syntax 
preference preference
no preference
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
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 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 7705 SAR assigns the highest default preference to BGP routes as compared to routes that are direct, static, or learned via MPLS or OSPF.

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

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

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

Default 

170

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

 

prefix-limit

Syntax 
prefix-limit limit
no prefix-limit
Context 
config>router>bgp>group
config>router>bgp>group>neighbor
Description 

This command configures the maximum number of routes that 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 the command removes the prefix limit.

Default 

no prefix-limit

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

 

rapid-withdrawal

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

This command disables the delay on issuing BGP withdrawals.

By default, BGP withdrawals (messages containing the routes that are no longer valid) are delayed up to the min-route-advertisement to allow for efficient packing of BGP Update messages. However, when the rapid-withdrawal command is enabled, the delay on sending BGP withdrawals is disabled.

The no form of the command returns BGP withdrawal processing to its default behavior.

Default 

no rapid-withdrawal

remove-private

Syntax 
[no] remove-private [limited]
Context 
config>router>bgp
config>router>bgp>group
config>router>bgp>group>neighbor
Description 

This command allows all private AS numbers to be removed from the AS path before advertising them to BGP peers. The no form of the command includes private AS numbers in the AS path attribute.

If the limited keyword is included, only the leading private ASNs up to the first public ASN are removed.

When the remove-private parameter is set 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.

The 7705 SAR recognizes the set of AS numbers that are defined by IANA as private. These are AS numbers in the range 64512 through 65535, inclusive.

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

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

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

Default 

no remove-private

route-target-list

Syntax 
route-target-list comm-id [comm-id ..(up to 15 max)]
no route-target-list [comm-id]
Context 
config>router>bgp
Description 

This command specifies the route targets to be accepted from and advertised to peers. If the route-target-list is a non-null list, only routes with one or more of the given route targets are accepted from or advertised to peers.

This command is only applicable if the router is a route-reflector server.

The route-target-list is assigned at the global level and applies to all peers connected to the system.

The no form of the command with a specified route target community removes the specified community from the route-target-list.

The no form of the command entered without a route target community removes all communities from the list.

Default 

no route-target-list

Parameters 
comm-id —
the route target community
Values—
target:{ip-addr:comm-val | 2byte-asnumber:ext-comm-val | 4-byte-asnumber:comm-val}

where:

ip-addr

a.b.c.d

comm-val

0 to 65535

2-byte-asnumber

0 to 65535

ext-comm-val

0 to 4294967295

4-byte-asnumber

0 to 4294967295

 

router-id

Syntax 
router-id ip-address
no router-id
Context 
config>router>bgp
Description 

This command specifies the router ID to be used with this BGP instance. If no router ID is specified, the system interface IP address is used.

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.

Default 

no router-id

Parameters 
ip-address —
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
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.

The no form of this command administratively enables an entity.

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 the 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

transport-tunnel

Syntax 
transport- tunnel {ldp | rsvp-te | mpls}
no transport-tunnel
Context 
config>router>bgp
Description 

This command selects either RSVP-TE or LDP as the type of Label Switched Path (LSP) transport method that is used to resolve next hops between two BGP peers.

The mpls option allows both RSVP-TE and LDP to be used. The availability of RSVP-TE is checked first; if RSVP-TE is not available then, LDP is selected.

The no form of the command reverts to the default.

Default 

ldp

Parameters 
ldp—
allows LDP to be used as the LSP transport method
rsvp-te—
allows RSVP-TE to be used as the LSP transport method
mpls—
allows both RSVP-TE and LDP to be used as the LSP transport method

ttl-security

Syntax 
ttl-security min-ttl-value
no ttl-security
Context 
config>router>bgp>group
config>router>bgp>group>neighbor
Description 

This command configures TTL security parameters for incoming packets. When the feature is enabled, BGP accepts incoming IP packets from a peer only if the TTL value in the packet is greater than or equal to the minimum TTL value configured for that peer.

The no form of the command disables TTL security.

Default 

no ttl-security

Parameters 
min-ttl-value—
the minimum TTL value for an incoming packet
Values—
1 to 255

 

Default—
1

vpn-apply-export

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

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

The no form of the command disables the application of the base instance BGP export 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
Description 

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

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

Default 

no vpn-apply-import

6.13.2.1.2. Other BGP-Related Commands

aggregate

Syntax 
aggregate ip-prefix/ip-prefix-length [summary-only]
no aggregate ip-prefix/ip-prefix-length
Context 
config>router
Description 

This command creates an aggregate route.

Use this command to group a number of routes with common prefixes into a single entry in the routing table. This reduces the number of routes that need to be advertised by this router and reduces the number of routes in the routing tables of downstream routers.

Both the original components and the aggregated route (source protocol aggregate) are offered to the Routing Table Manager (RTM). Subsequent policies can be configured to assign protocol-specific characteristics, such as the OSPF tag, to aggregate routes.

Multiple entries with the same prefix but a different mask can be configured; routes are aggregated to the longest mask. If one aggregate is configured as 10.0/16 and another as 10.0.0/24, then route 10.0.128/17 would be aggregated into 10.0/16 and route 10.0.0.128/25 would be aggregated into 10.0.0/24. If multiple entries are made with the same prefix and the same mask, the previous entry is overwritten.

The no form of the command removes the aggregate.

Default 

no aggregate

Parameters 
ip-prefix/ip-prefix-length—
the destination address of the aggregate route in dotted-decimal notation
Values—
ip-prefix:                    a.b.c.d (host bits must be 0)
ip-prefix-length:        0 to 32

 

summary-only—
suppresses advertisement of more specific component routes for the aggregate. To remove the summary-only option, enter the same aggregate command without the summary-only parameter.

autonomous-system

Syntax 
autonomous-system as-number
no autonomous-system
Context 
config>router
Description 

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

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

Default 

no autonomous-system

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

 

router-id

Syntax 
router-id ip-address
[no] router-id
Context 
config>router
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. IS-IS uses the router ID value as its system ID.

When configuring a new router ID, 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.

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

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.

Parameters 
ip-address —
32-bit router ID, expressed in dotted-decimal notation or as a decimal value

6.13.2.2. Show Commands

Note:

The following command outputs are examples only; actual displays may differ depending on supported functionality and user configuration.

router

Syntax 
router [router-instance]
router service-name service-name
Context 
show
Description 

The command displays router instance information.

Parameters 
router-instance—
specifies either the router name or service ID
Values—
router-name:       Base, management
service-id:           1 to 2147483647

 

Default—
Base
service-name
specifies the service name, 64 characters maximum

bgp

Syntax 
bgp
Context 
show>router
Description 

This command enables the context to display BGP-related information.

auth-keychain

Syntax 
auth-keychain [keychain]
Context 
show>router>bgp
Description 

This command displays BGP sessions using a particular authentication keychain.

Parameters 
keychain—
specifies an existing keychain name
Output 

The following output is an example of BGP sessions using an authentication keychain, and Table 68 describes the fields.

Output Example
*A:ALU-48# show router bgp auth-keychain
===============================================================================
Sessions using key chains
===============================================================================
Peer address             Group               Keychain name
-------------------------------------------------------------------------------
10.20.1.3                1                   eta_keychain1
-------------------------------------------------------------------------------
No. of Peers: 1
===============================================================================
*A:ALU-48#
Table 68:  BGP Auth-keychain Output Fields  

Label

Description

Peer address

The IP address of the peer

Group

The BGP group name

Keychain name

Indicates 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
damping [ip-prefix[/ip-prefix-length]] [damp-type] [detail] mvpn-ipv4
Context 
show>router>bgp
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.

If 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 30
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
mvpn-ipv4—
displays dampened routes for the MVPN-IPv4 address family
Output 

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

Output Example
*A: ALU-12>show>router>bgp# damping
===============================================================================
 BGP Router ID:0.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, b - backup
===============================================================================
BGP Damped Routes
===============================================================================
Flag  Network            From            Reuse       AS-Path 
------------------------------------------------------------------------------
ud*i  12.149.7.0/24      10.0.28.1       00h00m00s   60203 65001 19855 3356
                                                      1239  22406 
si    24.155.6.0/23      10.0.28.1       00h43m41s   60203 65001 19855 3356
                                                      2914  7459 
si    24.155.8.0/22      10.0.28.1       00h38m31s   60203 65001 19855 3356
                                                      2914  7459 
si    24.155.12.0/22     10.0.28.1       00h35m41s   60203 65001 19855 3356
                                                      2914  7459 
si    24.155.22.0/23     10.0.28.1       00h35m41s   60203 65001 19855 3356
                                                      2914  7459 
si    24.155.24.0/22     10.0.28.1       00h35m41s   60203 65001 19855 3356
                                                      2914  7459 
si    24.155.28.0/22     10.0.28.1       00h34m31s   60203 65001 19855 3356
                                                      2914  7459
si    24.155.40.0/21     10.0.28.1       00h28m24s   60203 65001 19855 3356
                                                      7911  7459 
si    24.155.48.0/20     10.0.28.1       00h28m24s   60203 65001 19855 3356
                                                      7911  7459 
ud*i  61.8.140.0/24      10.0.28.1       00h00m00s   60203 65001 19855 3356
                                                      4637  17447 
ud*i  61.8.141.0/24      10.0.28.1       00h00m00s   60203 65001 19855 3356
                                                      4637  17447 
ud*i  61.9.0.0/18        10.0.28.1       00h00m00s   60203 65001 19855 3356
                                                      3561  9658  6163 
. . .
ud*i  62.213.184.0/23    10.0.28.1       00h00m00s   60203 65001 19855 3356
                                                      6774  6774  9154 
------------------------------------------------------------------------------
*A:7705_ALU-2>show>router>bgp#
*A:7705_ALU-2>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 : 12.149.7.0/24
------------------------------------------------------------------------------
Network          : 12.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 : 15.142.48.0/20
------------------------------------------------------------------------------
Network          : 15.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 : 15.200.128.0/19
------------------------------------------------------------------------------
Network          : 15.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 : 15.203.192.0/18
-------------------------------------------------------------------------------
Network          : 15.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:7705_ALU-2>show>router>bgp#
*A:7705_ALU-2>show>router>bgp# damping 15.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 : 15.203.192.0/18
------------------------------------------------------------------------------
Network          : 15.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:7705_ALU-2>show>router>bgp#
*A:7705_ALU-2>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 : 15.142.48.0/20
------------------------------------------------------------------------------
Network          : 15.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 : 15.200.128.0/19
------------------------------------------------------------------------------
Network          : 15.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 : 15.203.240.0/20
------------------------------------------------------------------------------
Network          : 15.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 : 15.206.0.0/17
------------------------------------------------------------------------------
Network          : 15.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:7705_ALU-2>show>router>bgp#
Table 69:  Show BGP Damping Output Fields  

Label

Description

BGP Router ID

The local BGP router ID

AS

The configured autonomous system number

Local AS

The configured or inherited local AS for the specified peer group; if not configured, it is the same value as the AS

Network

The IP prefix and mask length for the route

Flag/Flags

Legend:

Status codes: u-used, s-suppressed, h-history, d-decayed, *-valid (if an * is not present, the status is invalid)

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

From

The originator ID path attribute value

Reuse/Reuse time

The time when a suppressed route can be used again

AS-Path

The BGP AS path for the route

Peer

The router ID of the advertising router

NextHop

The BGP next hop for the route

Peer AS

The autonomous system number of the advertising router

Peer Router-Id

The router ID of the advertising router

Local Pref

The BGP local preference path attribute for the route

Age

The time elapsed since the service was enabled

Last update

The time that BGP was last updated

FOM Present

The current Figure of Merit (FOM) value

FOM Last upd.

The last updated FOM value

Number of Flaps

The number of flaps in the neighbor connection

Reuse time

The time when the route can be reused

Path

The BGP AS path for the route

Applied Policy

The applied route policy name

group

Syntax 
group [name] [detail]
Context 
show>router>bgp
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 only pertaining to that specific peer group displays.

The “State” field displays the BGP group’s operational state. Valid states are:

  1. Up — BGP global process is configured and running
  2. Down — BGP global process is administratively shut down and not running
  3. Disabled — BGP global process is operationally disabled. The process must be restarted by the operator.
Parameters 
name—
displays information for the specified BGP group
detail—
displays detailed information
Output 

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

Output Example
*A:7705_ALU-2>show>router>bgp# group
===============================================================================
BGP Group
===============================================================================
-------------------------------------------------------------------------------
Group            : bgp_group
-------------------------------------------------------------------------------
Group Type       : No Type              State            : Up
Peer AS          : n/a                  Local AS         : 1
Local Address    : n/a                  Loop Detect      : Ignore
Import Policy    : None Specified / Inherited
Export Policy    : None Specified / Inherited
Hold Time        : 90                   Keep Alive       : 30
Min Hold Time    : 10                   
Cluster Id       : None                 Client Reflect   : Enabled
NLRI             : Unicast              Preference       : 170
TTL Security     : Enabled              Min TTL Value    : 10
Graceful Restart : Enabled              Stale Routes Time: 360
Auth key chain   : n/a
Bfd Enabled      : Disabled
Creation Origin  : manual
Split Horizon    : Disabled
 
List of Peers
- 44.44.44.44 :
 
Total Peers      : 1                    Established      : 0
-------------------------------------------------------------------------------
Peer Groups : 1
*A:7705_ALU-2>show>router>bgp# group detail
===============================================================================
BGP Group  (detail)
===============================================================================
-------------------------------------------------------------------------------
Group            : bgp_group
-------------------------------------------------------------------------------
Group Type       : No Type              State            : Up
Peer AS          : n/a                  Local AS         : 1
Local Address    : n/a                  Loop Detect      : Ignore
Connect Retry    : 120                  Authentication   : None
Local Pref       : 100                  MED Out          : 0
Multihop         : 0 (Default)          AS Override      : Disabled
Min Route Advt.  : 30                   Min AS Originate : 15
Prefix Limit     : No Limit             Passive          : Disabled
Passive          : Disabled
Next Hop Self    : Disabled             Aggregator ID 0  : Disabled
Remove Private   : Disabled             Damping          : Enabled
Import Policy    : None Specified / Inherited
Export Policy    : None Specified / Inherited
Hold Time        : 90                   Keep Alive       : 30
Min Hold Time    : 10                   
Cluster Id       : None                 Client Reflect   : Enabled
NLRI             : Unicast              Preference       : 170
TTL Security     : Enabled              Min TTL Value    : 10
Graceful Restart : Enabled              Stale Routes Time: 360
Auth key chain   : n/a
Bfd Enabled      : Disabled
Creation Origin  : manual
Split Horizon    : Disabled
 
List of Peers
- 44.44.44.44 :
 
Total Peers      : 1                    Established      : 0
-------------------------------------------------------------------------------
Peer Groups : 1
===============================================================================
*A:7705_ALU-2>show>router>bgp#
Table 70:  Show BGP Group Output Fields  

Label

Description

Group

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

The configured or inherited peer AS for the specified peer group

Local AS

The configured or inherited local AS for the specified peer group

Local Address

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

Loop Detect

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

Connect Retry

The configured or inherited connect retry timer value

Authentication

None: no authentication is configured

MD5: MD5 authentication is configured

Local Pref

The configured or inherited local preference value

MED Out

The configured or inherited MED value that is assigned to advertised routes

Multihop

The maximum number of router hops a BGP connection can traverse

AS Override

The setting of the AS override

Min Route Advt.

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

Min AS Originate

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

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

Passive

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

Enabled: BGP will not actively attempt to establish a BGP connection with a 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

Import Policy

The configured import policies for the peer group

Export Policy

The configured export policies for the peer group

Hold Time

The configured hold-time setting

Keep Alive

The configured keepalive setting

Min Hold Time

The configured minimum hold-time setting

Cluster Id

The configured route reflector cluster ID

None: No cluster ID has been configured

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

The type of network layer reachability information that the specified peer group can accept

Unicast: IPv4 unicast routing information can be carried

Preference

The configured route preference value for the peer group

TTL Security

Enabled: TTL security is enabled

Disabled: TTL security is disabled

Min TTL Value

The minimum TTL value configured for the peer

Graceful Restart

The state of graceful restart

Stale Routes Time

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

Auth key chain

The value for the authentication key chain

Bfd Enabled

Enabled: BFD is enabled

Disabled: BFD is disabled

Creation Origin

The creation method of the peer group

Split Horizon

The configured split-horizon setting

List of Peers

A list of BGP peers configured under the peer group

Total Peers

The total number of peers configured under the peer group

Established

The total number of peers that are in an established state

Peer Groups

The number of peer groups

inter-as-label

Syntax 
inter-as-label
Context 
show>router>bgp
Description 

This command displays a summary of BGP inter-autonomous system (inter-AS) service label information pertaining to a next-hop resolution when enable-rr-vpn-forwarding is enabled.

Output 

The following output is an example of inter-AS service label information, and Table 71 describes the fields.

Output Example
*A:7705_ALU-2>show>router>bgp# inter-as-labels
 
===============================================================================
BGP Inter-AS labels
===============================================================================
NextHop                       Received       Advertised     Label              
                              Label          Label          Origin             
-------------------------------------------------------------------------------
10.20.1.1                     131069         131057         Internal           
10.20.1.1                     131070         131055         Internal           
10.20.1.1                     131071         131056         Internal           
10.20.1.2                     131068         131050         Internal           
10.20.1.2                     131069         131054         Internal           
10.20.1.2                     131070         131053         Internal           
10.20.1.6                     131066         131049         Internal           
10.20.1.6                     131067         131052         Internal           
10.20.1.6                     131070         131051         Internal           
-------------------------------------------------------------------------------
Total Labels allocated:   9
===============================================================================
Table 71:  Show Inter-AS Service Label Output Fields 

Label

Description

NextHop

The BGP next hop ID

Received Label

The service label ID that is received by the Multiprotocol Border Gateway Protocol (MP-BGP)

Advertised Label

The service label ID that is advertised by the MP-BGP

Label Origin

The origin of the received label (either external or internal)

Total Labels allocated

The total number of service labels that are allocated as a result of the next-hop resolution

neighbor

Syntax 
neighbor [ip-address [detail]]
neighbor [as-number [detail]]
neighbor ip-address [family [type mvpn-type]] filter1 [brief]
neighbor ip-address [family] filter2
neighbor as-number [family] filter2
neighbor ip-address orf [filter3]
neighbor ip-address graceful-restart
Context 
show>router>bgp
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.

Note:

This information is not available when using SNMP.

Parameters 
ip-address—
the specified IP address for which to display information
Values—
ipv4-address:        a.b.c.d
ipv6-address:       x:x:x:x:x:x:x:x[-interface]
                            x:x:x:x:x:x:d.d.d.d[-interface]
                            x: [0..FFFF]H
                            d: [0..255]D
                             interface: 32 characters maximum,                                         mandatory for link local addresses

 

detail—
displays detailed information
as-number—
the specified AS number for which to display information
Values—
1 to 4294967295

 

family—
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 and not those capable of exchanging VPN-IPv4 routes
vpn-ipv4 — displays only those BGP peers that have the VPN-IPv4 family enabled
mvpn-ipv4 — displays only those BGP peers that have the MVPN-IPv4 family enabled

 

type—
displays information for the MVPN type
mvpn-type—
the specified MVPN type for which to display information
Values—
intra-ad | inter-ad | spmsi-ad | leaf-ad | source-ad | shared-join | source-join

 

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

 

filter2—
displays information for the specified AS number
Values—
history — displays statistics for dampened routes
suppressed — displays the number of paths from this peer that have been suppressed by damping
Note:

When either received-routes or advertised-routes is specified, the routes that are received from or sent to the specified peer are listed. When either history or suppressed is specified, the routes that are learned from those peers that either have a history or are suppressed are listed.

 

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:

Output Example - BGP Neighbor (standard and detailed)
*A:7705_ALU-2>show>router>bgp# neighbor
===============================================================================
BGP Neighbor
===============================================================================
-------------------------------------------------------------------------------
Peer  : 10.10.10.12
Group : ibgp_group
-------------------------------------------------------------------------------
Peer AS              : 65000            Peer Port            : 49550
Peer Address         : 10.10.10.12
Local AS             : 65000            Local Port           : 179
Local Address        : 10.10.10.1
Peer Type            : Internal
State                : Established      Last State           : Established
Last Event           : recvKeepAlive
Last Error           : Cease
Local Family         : IPv4 VPN-IPv4
Remote Family        : IPv4 VPN-IPv4
Hold Time            : 90               Keep Alive           : 30
Min Hold Time        : 10                   
Active Hold Time     : 90               Active Keep Alive    : 30
Cluster Id           : None
Preference           : 170              Num of Flaps         : 0
Recd. Paths          : 19
IPv4 Recd. Prefixes  : 600              IPv4 Active Prefixes : 563
IPv4 Suppressed Pfxs : 0                VPN-IPv4 Suppr. Pfxs : 0
VPN-IPv4 Recd. Pfxs  : 8656             VPN-IPv4 Active Pfxs : 8656
IPv6 Recd. Prefixes  : 0                IPv6 Active Prefixes : 0
VPN-IPv6 Recd. Pfxs  : 0                VPN-IPv6 Active Pfxs : 0
VPN-IPv6 Suppr. Pfxs : 0
Backup IPv4 Pfxs     : 0                Backup IPv6 Pfxs     : 0
Backup Vpn IPv4 Pfxs : 0                Backup Vpn IPv6 Pfxs : 0
Input Queue          : 0                Output Queue         : 0
i/p Messages         : 1141             o/p Messages         : 1041
i/p Octets           : 449029           o/p Octets           : 163814
i/p Updates          : 151              o/p Updates          : 50
TTL Security         : Enabled          Min TTL Value        : 10
Graceful Restart     : Disabled         Stale Routes Time    : n/a
Advertise Inactive   : Disabled         Peer Tracking        : Disabled
Advertise Label      : None
Auth key chain       : n/a
Disable Cap Nego     : Disabled         Bfd Enabled          : Disabled
Local Capability     : RouteRefresh MP-BGP
Remote Capability    : RouteRefresh MP-BGP
Local AddPath Capabi*: Disabled
Remote AddPath Capab*: Send - None
                     : Receive - None
Import Policy        : None Specified / Inherited
Export Policy        : stmt1
-------------------------------------------------------------------------------
Neighbors : 1
===============================================================================
*A:7705_ALU-2>show>router>bgp#
*A:7705_ALU-2>show>router>bgp# neighbor 10.10.10.12 detail
===============================================================================
BGP Neighbor
===============================================================================
-------------------------------------------------------------------------------
Peer  : 10.10.10.12
Group : iBGP
-------------------------------------------------------------------------------
Peer AS              : 65000            Peer Port            : 49550
Peer Address         : 10.10.10.12
Local AS             : 65000            Local Port           : 179
Local Address        : 10.10.10.1
Peer Type            : Internal
State                : Established      Last State           : Established
Last Event           : recvKeepAlive
Last Error           : Cease
Local Family         : IPv4 VPN-IPv4
Remote Family        : IPv4 VPN-IPv4
Connect Retry        : 120              Local Pref.          : 70
Min Route Advt.      : 30               Min AS Orig.         : 15
Multihop             : 0 (Default)      AS Override          : Disabled
Damping              : Disabled         Loop Detect          : Ignore
MED Out              : No MED Out       Authentication       : None
Next Hop Self        : Disabled         AggregatorID Zero    : Disabled
Remove Private       : Disabled         Passive              : Disabled
Peer Identifier      : 10.10.10.12      Fsm Est. Trans       : 1
Fsm Est. Time        : 22h42m46s        InUpd Elap. Time     : 22h54m31s
Prefix Limit         : No Limit         Pref Limit Idle Time*: forever
Hold Time            : 90               Keep Alive           : 30
Min Hold Time        : 10                   
Active Hold Time     : 90               Active Keep Alive    : 30
Cluster Id           : None             Client Reflect       : Disabled
Preference           : 170              Num of Flaps         : 0
Recd. Paths          : 19
IPv4 Recd. Prefixes  : 600              IPv4 Active Prefixes : 563
IPv4 Suppressed Pfxs : 0                VPN-IPv4 Suppr. Pfxs : 0
VPN-IPv4 Recd. Pfxs  : 8656             VPN-IPv4 Active Pfxs : 8656
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
Backup IPv4 Pfxs     : 0                Backup IPv6 Pfxs     : 0
Backup Vpn IPv4 Pfxs : 0                Backup Vpn IPv6 Pfxs : 0
Input Queue          : 0                Output Queue         : 0
i/p Messages         : 2881             o/p Messages         : 2777
i/p Octets           : 482089           o/p Octets           : 196798
i/p Updates          : 151              o/p Updates          : 50
TTL Security         : Enabled          Min TTL Value        : 10
Graceful Restart     : Disabled         Stale Routes Time    : n/a
Advertise Inactive   : Disabled         Peer Tracking        : Disabled
Advertise Label      : None
Auth key chain       : n/a
Bfd Enabled          : Enabled
Disable Cap Nego     : Disabled         Bfd Enabled          : Disabled
Local Capability     : RtRefresh MPBGP 4byte ASN
Remote Capability    :
Local AddPath Capabi*: Disabled
Remote AddPath Capab*: Send - None
                     : Receive - None
Import Policy        : None Specified / Inherited
Export Policy        : stmt1
-------------------------------------------------------------------------------
Neighbors : 1
===============================================================================
*A:7705_ALU-2>show>router>bgp# 
*A:7705_ALU-2>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:7705_ALU-2>show>router>bgp# 
*A:7705_ALU-2>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:7705_ALU-2>show>router>bgp# 
Table 72:  Show BGP Neighbor (Standard and Detailed) Output Fields  

Label

Description

Peer

The IP address of the configured BGP peer

Group

The BGP peer group to which this peer is assigned

Peer AS

The configured or inherited peer AS for the peer group

Peer Address

The configured address for the BGP peer

Peer Port

The TCP port number used on the far-end system

Local AS

The configured or inherited local AS for the peer group

Local Address

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

Local Port

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

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

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

Local Family

The configured local family value

Remote Family

The configured remote family value

Connect Retry

The configured or inherited connect retry timer value

Local Pref.

The configured or inherited local preference value

Min Route Advt.

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

Min AS Originate

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

Multihop

The maximum number of router hops a BGP connection can traverse

Damping

Disabled: the BGP neighbor is configured not to dampen route flaps

Enabled: the 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

The configured or inherited MED value that is assigned to advertised routes

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 next hop in route updates to the specified neighbor

Enabled: BGP will send only its own IP address as the BGP next hop 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

Peer Identifier

The IP identifier for the peer router

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

Pref Limit Idle Time*

The length of time that the session is held in the idle state after it is taken down as a result of reaching the prefix limit

Hold Time

The configured hold-time setting

Keep Alive

The configured keepalive setting

Min Hold Time

The configured minimum hold-time setting

Active Hold Time

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

Active Keep Alive

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

Cluster Id

The configured route reflector cluster ID

None: no cluster ID has been configured

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

The configured route preference value for the peer group

Num of Flaps

The number of route flaps in the neighbor connection

Recd. Prefixes

The number of routes received from the BGP neighbor

Recd. Paths

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

IPv4 Recd. Prefixes

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

IPv4 Active Prefixes

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

IPv4 Suppressed Pfxs

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

VPN-IPv4 Suppr. Pfxs

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

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

VPN-IPv4 Active Pfxs

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

IPv6 Recd. Prefixes

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

IPv6 Active Prefixes

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

VPN-IPv6 Recd. Pfxs

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

VPN-IPv6 Active Pfxs

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

VPN-IPv6 Suppr. Pfxs

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

Backup IPv4 Pfxs

The number of BGP Fast Reroute backup path IPv4 prefixes

Backup IPv6 Pfxs

The number of BGP Fast Reroute backup path IPv6 prefixes

Backup Vpn IPv4 Pfxs

The number of BGP Fast Reroute backup path VPN IPv4 prefixes

Backup Vpn IPv6 Pfxs

The number of BGP Fast Reroute backup path VPN IPv6 prefixes

Input Queue

The number of BGP messages to be processed

Output Queue

The number of BGP messages to be transmitted

i/p Messages

The total number of packets received from the BGP neighbor

o/p Messages

The total number of packets sent to the BGP neighbor

i/p Octets

The total number of octets received from the BGP neighbor

o/p Octets

The total number of octets sent to the BGP neighbor

i/p Updates

The total number of updates received from the BGP neighbor

o/p Updates

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

The minimum TTL value configured for the peer

Graceful Restart

The state of graceful restart

Stale Routes Time

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

Advertise Inactive

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

Peer Tracking

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

Advertise Label

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

Auth key chain

The value for the authentication key chain

Bfd Enabled

Enabled: BFD is enabled

Disabled: BFD is disabled

Local Capability

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

Remote Capability

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

Local AddPath Capabi*

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*

The state of the remote BGP add-paths capabilities

Import Policy

The configured import policies for the peer group

Export Policy

The configured export policies for the peer group

Output Example - BGP Neighbor (advertised-routes and received-routes)
*A:7705_ALU-2>show>router>bgp# neighbor 44.44.44.44 advertised-routes
===============================================================================
 BGP Router ID : 55.55.55.55       AS : 1       Local AS : 1
===============================================================================
 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                                           LocalPref   MED
      Nexthop                                           Path-Id     Label
      As-Path
-------------------------------------------------------------------------------
?     10.0.0.02/32                                      100         none
      10.0.0.16                                         -
      No As-Path
?     10.0.6.04/24                                      100         none 
      10.0.0.16                                         -
      No As-Path
-------------------------------------------------------------------------------
Routes : 2 
===============================================================================
*A:7705_ALU-2>show>router>bgp#
*A:PE1>show>router>bgp# neighbor 10.10.10.12 advertised-routes  brief
===============================================================================
 BGP Router ID : 10.10.10.1        AS : 65000   Local AS : 65000
===============================================================================
 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
-------------------------------------------------------------------------------
?     10.10.10.1/32
?     12.12.1.0/24
?     20.0.0.0/24
?     21.0.0.0/24
?     88.88.1.0/24
-------------------------------------------------------------------------------
Routes : 5 
===============================================================================
*A:7705_ALU-2>show>router>bgp#
*A:7705_ALU-2>show>router>bgp# neighbor 44.44.44.44 received-routes
===============================================================================
 BGP Router ID : 55.55.55.55       AS : 1       Local AS : 1
===============================================================================
 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                                           LocalPref   MED
      Nexthop                                           Path-Id     Label
      As-Path
-------------------------------------------------------------------------------
?     10.0.0.16/32                                       100         none
      10.0.0.16                                          -
      No As-Path
?     10.0.6.0/24                                        100         none 
      10.0.0.16 -
      No As-Path
?     10.0.8.0/24                                        100         none 
      10.0.0.16                                          -
      No As-Path
?     10.0.12.0/24                                       100         none 
      10.0.0.16                                          -
      No As-Path
-------------------------------------------------------------------------------
Routes : 4 
===============================================================================
*A:7705_ALU-2>show>router>bgp#
Table 73:  Show BGP Neighbor (Advertised-Routes and Received-Routes) Output Fields 

Label

Description

BGP Router ID

The local BGP router ID

AS

The configured autonomous system number

Local AS

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

Flag/Flags

Legend:

Status codes:

u - used

s - suppressed

h - history

d - decayed

* - valid

If an * is not present, then the status is invalid

Origin codes:

i - IGP

e - EGP

? - incomplete

> - best

Network

The route IP prefix and mask length for the route

Next Hop

The BGP next hop for the route

LocalPref

The BGP local preference path attribute for the route

MED

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

Path-Id

The path ID that is received as part of the add-path capability

Label

The BGP label associated with the route

AS-Path

The BGP AS path for the route

Output Example - BGP Neighbor (graceful restart)
*A:7705_ALU-2>show>router>bgp# neighbor 20.10.120.44 graceful-restart
===============================================================================
BGP Neighbor 20.10.120.44 Graceful Restart
===============================================================================
Graceful Restart locally configured for peer  : Enabled
Peer's Graceful Restart feature               : Enabled
NLRI(s) that peer supports restart for        : IPv4-Unicast IPv4-MPLS IPv4-VPN
NLRI(s) that peer saved forwarding for        : IPv4-Unicast IPv4-MPLS IPv4-VPN
NLRI(s) that restart is negotiated for        : None
NLRI(s) of received end-of-rib markers        : IPv4-Unicast
NLRI(s) of all end-of-rib markers sent        : IPv4-Unicast
Restart time locally configured for peer      : 120 seconds
Restart time requested by the peer            : 390 seconds
Time stale routes from peer are kept for      : 360 seconds
Graceful restart status on the peer           : Not currently being helped
Number of Restarts                            : 328
Last Restart at                               : 08/20/2006 12:22:06
===============================================================================
*A:7705_ALU-2>show>router>bgp#
Table 74:  BGP Neighbor (Graceful Restart) Output Fields 

Label

Description

BGP Neighbor

The IP address of the BGP neighbor

Graceful Restart locally configured for peer

The configured state of graceful restart for the local router

Peer's Graceful Restart feature

The configured state of graceful restart for the peer router

NLRI(s) that peer supports restart for

The families supported by the peer router for graceful restart

NLRI(s) that peer saved forwarding for

The families for which the peer router continued to forward packets after graceful restart

NLRI(s) that restart is negotiated for

The families that negotiate restart during graceful restart

NLRI(s) of received end-of-rib markers

The families for which end-of-RIB markers have been received

NLRI(s) of all end-of-rib markers sent

The families for which end-of-RIB markers have been sent

Restart time locally configured for peer

The length of time configured on the local router for the peer router’s graceful restart

Restart time requested by the peer

The length of time requested by the peer router for graceful restart

Time stale routes from peer are kept for

The length of time that the local router continues to support stale routes

Graceful restart status on the peer

The status of graceful restart on the peer router

Number of Restarts

The number of restarts since graceful restart is enabled between peers

Last Restart at

The local time of the last graceful restart

next-hop

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

This command displays BGP next-hop information.

Parameters 
family—
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 and not those capable of exchanging VPN-IPv4 routes
vpn-ipv4 — displays only those BGP peers that have the VPN-IPv4 family enabled
mvpn-ipv4 — displays only those BGP peers that have the MVPN-IPv4 family enabled

 

ip-address—
displays the next hop information for the specified IP address
Values—
ipv4-address:        a.b.c.d
ipv6-address:       x:x:x:x:x:x:x:x[-interface]
                            x:x:x:x:x:x:d.d.d.d[-interface]
                            x: [0..FFFF]H
                            d: [0..255]D
                             interface: 32 characters maximum,                                         mandatory for link local addresses

 

detail—
displays the more detailed version of the output
Output 

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

Output Example
A:7705_ALU-2>show>router>bgp# next-hop
===============================================================================
 BGP Router ID : 10.10.10.1        AS : 65000   Local AS : 65000
===============================================================================
===============================================================================
BGP Next Hop
===============================================================================
Next Hop                                                        Pref Owner
   Resolving Prefix                                                  Metric
   Resolved Next Hop                                                 Ref. Count
-------------------------------------------------------------------------------
10.10.10.12                                                     15   ISIS
   0.0.0.0/0                                                         10
   88.88.1.2                                                         592
10.10.10.12                                                     15   ISIS
   0.0.0.0/0                                                         10
   88.88.2.2                                                         592
27.0.0.1                                                        15   ISIS
   27.0.0.0/24                                                       20
   88.88.1.2                                                         8
27.0.0.1                                                        15   ISIS
   27.0.0.0/24                                                       20
   88.88.2.2                                                         8
-------------------------------------------------------------------------------
Next Hops : 2
===============================================================================
A:7705_ALU-2>show>router>bgp# 
A:7705_ALU-2>show>router>bgp# next-hop 27.0.0.1
===============================================================================
 BGP Router ID : 10.10.10.1        AS : 65000   Local AS : 65000
===============================================================================
===============================================================================
BGP Next Hop
===============================================================================
Next Hop                                                        Pref Owner
   Resolving Prefix                                                  Metric
   Resolved Next Hop                                                 Ref. Count
-------------------------------------------------------------------------------
27.0.0.1                                                        15   ISIS
   27.0.0.0/24                                                       20
   88.88.1.2                                                         8
27.0.0.1                                                        15   ISIS
   27.0.0.0/24                                                       20
   88.88.2.2                                                         8
-------------------------------------------------------------------------------
Next Hops : 1
===============================================================================
A:7705_ALU-2>show>router>bgp#
A:7705_ALU-2>show>router>bgp# next-hop 27.0.0.1 detail
===============================================================================
 BGP Router ID : 10.10.10.1        AS : 65000   Local AS : 65000
===============================================================================
===============================================================================
BGP Next Hop
===============================================================================
Next Hop: 27.0.0.1
-------------------------------------------------------------------------------
Resolving Prefix : 27.0.0.0/24
Preference       : 15                   Metric           : 20
Reference Count  : 8                    Owner            : ISIS
Resolved Next Hop: 88.88.1.2
Egress Label     : N/A
Resolved Next Hop: 88.88.2.2
Egress Label     : N/A
Resolved Next Hop: 88.88.3.2
Egress Label     : N/A
-------------------------------------------------------------------------------
Next Hops : 1
===============================================================================
A:7705_ALU-2>show>router>bgp#
Table 75:  Show BGP Next-Hop Output Fields 

Label

Description

BGP Router ID

The local BGP router ID

AS

The configured autonomous system number

Local AS

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

Next Hop

The next-hop address

Resolving Prefix

The prefix of the best next hop

Pref: Preference

The BGP preference attribute for the routes

Metric

The metric derived from the IGP for a particular next hop

Reference Count

The number of routes using the resolving prefix

Owner

The routing protocol used to derive the best next hop

Resolved Next Hop

The IP address of the next hop

Egress Label

The VPN label used for VPN-IPv4 data

Next Hops

The number of next hops

paths

Syntax 
paths
Context 
show>router>bgp
Description 

This command displays a summary of BGP path attributes.

Output 

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

Output Example
*A:7705_ALU-2>show>router>bgp# paths
===============================================================================
 BGP Router ID : 55.55.55.55 AS : 65000   Local AS : 65000
===============================================================================
===============================================================================
BGP Paths
===============================================================================
Path: No As-Path
-------------------------------------------------------------------------------
Next Hop         : 44.44.10.12
Origin           : Incomplete           Segments         : 0
MED              : None                 Local Preference : 4294967295
Refs             : 1080                 ASes             : 0
Flags            : IBGP-learned
-------------------------------------------------------------------------------
Path: No As-Path
-------------------------------------------------------------------------------
Next Hop         : 88.88.1.2
Origin           : IGP                  Segments         : 0
MED              : 10                   Local Preference : None
Refs             : 4                    ASes             : 0
Flags            : Imported
-------------------------------------------------------------------------------
Path: No As-Path
-------------------------------------------------------------------------------
Next Hop         : 44.44.10.21
Origin           : IGP                  Segments         : 0
MED              : None                 Local Preference : 100
Refs             : 1082                 ASes             : 0
Flags            : IBGP-learned
Cluster          : 10.10.10.12
Originator Id    : 10.10.10.21
-------------------------------------------------------------------------------
Paths : 3
===============================================================================
*A:7705_ALU-2>show>router>bgp# 
Table 76:  Show BGP Path Output Fields  

Label

Description

BGP Router ID

The local BGP router ID

AS

The configured autonomous system number

Local AS

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

Path

The AS path attribute

Next Hop

The advertised BGP next hop

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

Segments

The number of segments in the AS path attribute

MED

The Multi-Exit Discriminator value

Local Preference

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.

Refs

The number of routes using a specified set of path attributes

ASes

The number of autonomous system numbers in the AS path attribute

Flags

IBGP-learned: path attributes learned by an IBGP peering

Community

The BGP community attribute list

Cluster List

The route reflector cluster list

Originator ID

The originator ID path attribute value

routes

Syntax 
routes [family] [brief]
routes [family] prefix [detail | longer | hunt [brief]]
routes family [prefix] [detail | longer | hunt [brief]]
routes vpn-ipv4 prefix [rd rd] [detail | longer | hunt [brief]]
routes vpn-ipv6 prefix [rd rd] [detail | longer | hunt [brief]]
routes [family [type mvpn-type]] community comm-id
routes [family [type mvpn-type]] aspath-regex reg-ex
routes mvpn-ipv4 type mvpn-type {rd rd | originator-ip ip-address | source-ip ip-address | group-ip ip-address | source-as as-number} [hunt | detail]
Context 
show>router>bgp
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—
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 and not those capable of exchanging VPN-IPv4 routes
vpn-ipv4 — displays the BGP peers that are VPN-IPv4 capable
ipv6 — displays only those BGP peers that have the IPv6 family enabled and not those capable of exchanging VPN-IPv6 routes
vpn-ipv6 — displays the BGP peers that are VPN-IPv6 capable
mvpn-ipv4 — displays the BGP peers that are MVPN-IPv4 capable

 

prefix—
the type of routing information to display
Values—
rd | [rd:]ip-prefix[/ip-prefix-length]
where
  rd:  ip-addr:comm-val | 2byte-asnumber:ext-comm-val |          4-byte-asnumber:comm-val
where
  ip-addr:                        a.b.c.d
  comm-val:                    0 to 65535
  2-byte-asnumber:         0 to 65535
  ext-comm-val:               0 to 4294967295
  4-byte-asnumber:          asn1.asn2 (two 2-byte pieces)
                                        asn1:     1 to 65535
                                        asn2:     0 to 65535
  ipv4-prefix:                    a.b.c.d
  ipv4-prefix-length:         0 to 32

 

brief—
provides a summarized display of the set of peers to which a BGP route is advertised
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 more detailed version of the output
rd—
see prefix
vpn-ipv4—
see family
vpn-ipv6—
see family
mvpn-ipv4—
see family
mvpn-type—
the specified MVPN type for which to display information
Values—
intra-ad | inter-ad | spmsi-ad | leaf-ad | source-ad | shared-join | source-join

 

comm-id—
displays all routes with the specified BGP community
Values—

comm-id

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 (keywords)

ip-address:

a.b.c.d

comm-val2

0 to 4294967295

as-number2 

0 to 4294967295

well-known-comm

null | no-export | no-export-subconfed | no-advertise (keywords)

 

reg-ex—
displays all routes with an AS path matching the specified regular expression reg-exp, 32 characters maximum
originator-ip ip-address
filters BGP MVPN routes by the originating router's IP address that is found in the intra-AD (auto-discovery) MVPN routes
source-ip ip-address
filters BGP MVPN routes by the source IP address that is found in the source-join, source-AD, or S-PMSI-AD MVPN routes
group-ip ip-address
filters BGP MVPN routes by the multicast group IP address that is found in the source-join, source-AD, or S-PMSI-AD MVPN routes
source-as as-number
filters BGP MVPN routes by source-AS (autonomous system) extended community attribute
Output 

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

Output Example
*A:7705_ALU-2>show>router>bgp# routes
===============================================================================
 BGP Router ID : 10.10.10.1        AS : 65000   Local AS : 65000
===============================================================================
 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                                           LocalPref   MED
      Nexthop                                                       VPN Label
      As-Path
-------------------------------------------------------------------------------
u*>?  10.10.10.12/32                                    100         None
      10.10.10.12                                                   -
      No As-Path
 
u*>?  11.11.1.0/24                                      100         None
      10.10.10.12                                                   -
      No As-Path
 
*?    23.0.0.0/24                                       100         None
      10.10.10.12                                                   -
      No As-Path
 
*?    24.0.0.0/24                                       100         None
      10.10.10.12                                                   -
      No As-Path
-------------------------------------------------------------------------------
Routes : 4
===============================================================================
*A:7705_ALU-2>show>router>bgp# routes brief
===============================================================================
 BGP Router ID : 10.10.10.1        AS : 65000   Local AS : 65000
===============================================================================
 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
-------------------------------------------------------------------------------
u*>?  10.10.10.12/32
u*>?  11.11.1.0/24
*?    23.0.0.0/24
*?    24.0.0.0/24
-------------------------------------------------------------------------------
Routes : 4
===============================================================================
*A:7705_ALU-2>show>router>bgp#
*A:7705_ALU-2>show>router>bgp# routes 13.1.0.0/24 detail
===============================================================================
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        : 13.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
Cluster        : No Cluster Members
Originator Id  : None                Peer Router Id: 10.20.1.20
Flags          : Used Valid Best IGP
AS-Path        : 10070 {14730}
 
Modified Attributes
 
Network        : 13.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
Cluster        : No Cluster Members
Originator Id  : None                Peer Router Id: 10.20.1.20
TieBreakReason : MED        
Flags          : Used Valid Best IGP
AS-Path        : No As-Path
-------------------------------------------------------------------------------
===============================================================================
*A:7705_ALU-2> show router bgp routes 100.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        : 100.0.0.0/30
Nexthop        : 10.20.1.2
Route Dist.    : 10.20.1.2:1         VPN Label: 131070
From           : 10.20.1.2
Res. Nexthop   : 10.10.1.2
Local Pref.    : 100                 Interface Name: to-sr7
Aggregator AS  : none                Aggregator: none
Atomic Aggr.   : Not Atomic          MED: none
Community      : target:10.20.1.2:1
Cluster        : No Cluster Members
Originator Id  : None                Peer 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:7705_ALU-2
Table 77:  Show BGP Route Output Fields 

Label

Description

BGP Router ID

The local BGP router ID

AS

The configured autonomous system number

Local AS

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

Flag/Flags

Legend:

Status codes:

u - used

s - suppressed

h - history

d - decayed

* - valid

If an * is not present, then the status is invalid

Origin codes:

i - IGP

e - EGP

? - incomplete

> - best

Network

The IP prefix and mask length

Nexthop

The BGP next hop

AS-Path

The BGP AS path attribute

Local Pref.

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

The MED metric value

none: MED metrics are present

VPN Label

 The label generated by the PE’s label manager

Original Attributes

The received BGP attributes of a route from a peer without any modification from any policy

Modified Attributes

The final BGP attributes of a route after the policies evaluation

Route Dist.

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

From

The advertising BGP neighbor’s IP address

Res. Nexthop

The resolved next hop

Aggregator AS

The aggregator AS value

none: aggregator AS attributes are not present

Aggregator

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

Community

The BGP community attribute list

Cluster

The route reflector cluster list

Originator Id

The originator ID path attribute value

none: the originator ID attribute is not present

Peer Router Id

The router ID of the advertising router

TieBreakReason

The step in the BGP decision process where a BGP route lost the tie-break with the next BGP route for the same prefix

LocalPref — this route is not the best because the next better route has a higher LOCAL_PREF

ASPathLen — this route is not the best because the next better route has a shorter AS PATH length

Origin — this route is not the best because the next better route has a lower origin value

MED — this route is not the best because the next better route has a lower MED, and MED comparison of the routes was allowed

IBGP — this IBGP route is not the best because the next better route is an EBGP route

NHCost — this route is not the best because the next better route has a lower metric value to reach the BGP NEXT HOP

BGPID — this route is not the best because the next better route has a lower originator ID or BGP identifier

ClusterLen — this route is not the best because the next better route has a shorter cluster list length

PeerIP — this route is not the best because the next better route has a lower neighbor IP address

VPRN Imported

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

summary

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

This command displays a summary of BGP neighbor information.

If confederations are not configured, that portion of the output will not display.

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

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

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

Parameters 
all—
displays BGP peers in all instances
family
the type of routing information to be distributed by the BGP instance
Values—
ipv4, vpn-ipv4, ipv6, vpn-ipv6, mvpn-ipv4
ipv4, ipv6 — displays only those BGP peers that have the IPv4 or IPv6 family enabled
vpn-ipv4, vpn-ipv6 — displays the BGP peers that are IPv4-VPN capable or IPv6-VPN capable
mvpn-ipv4 — displays the BGP peers that are MVPN-IPv4 capable

 

ip-address
clears damping information for entries received from the BGP neighbor
Values—
ipv4-address:          a.b.c.d
ipv6-address:          x:x:x:x:x:x:x:x[-interface]                                 x:x:x:x:x:x:d.d.d.d[-interface]                                     interface - 32 chars max,                                     mandatory for link local addresses                                 x: [0..FFFF]H                                 d: [0..255]D

 

Output 

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

Output Example
*A:7705_ALU-2>show>router>bgp# summary
===============================================================================
 BGP Router ID : 55.55.55.1        AS : 65000   Local AS : 65000
===============================================================================
BGP Admin State         : Up          BGP Oper State              : Up
Total Peer Groups       : 1           Total Peers                 : 1
Total BGP Paths         : 74          Total Path Memory           : 9128
Total IPv4 Remote Rts   : 600         Total IPv4 Rem. Active Rts  : 563
Total Supressed Rts     : 0           Total Hist. Rts             : 0
Total Decay Rts         : 0
Total VPN Peer Groups   : 0           Total VPN Peers             : 0
Total VPN Local Rts     : 8672
Total VPN-IPv4 Rem. Rts : 8656        Total VPN-IPv4 Rem. Act. Rts: 8656
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 (Addr Family)
                      PktSent OutQ
-------------------------------------------------------------------------------
44.44.10.12
                65000     654    0 04h11m01s 600/563/569 (IPv4)
                          557    0           8656/8656/8672 (VpnIPv4)
===============================================================================
*A:7705_ALU-2>show>router>bgp#
*A:7705_ALU-2>show>router>bgp# summary all
===============================================================================
BGP Summary
===============================================================================
Neighbor
ServiceId          AS PktRcvd InQ  Up/Down   State|Rcv/Act/Sent (Addr Family)
                      PktSent OutQ
-------------------------------------------------------------------------------
44.44.10.12
Def. Instance   65000     662    0 04h14m52s 600/563/569 (IPv4)
                          564    0           8656/8656/8672 (VpnIPv4)
===============================================================================
*A:7705_ALU-2>show>router>bgp#
*A:7705_ALU-2>show>router>bgp# summary neighbor 44.44.10.12
===============================================================================
 BGP Router ID : 44.44.10.1        AS : 65000   Local AS : 65000
===============================================================================
BGP Admin State         : Up          BGP Oper State              : Up
Total Peer Groups       : 1           Total Peers                 : 1
Total BGP Paths         : 74          Total Path Memory           : 9128
Total IPv4 Remote Rts   : 600         Total IPv4 Rem. Active Rts  : 563
Total Supressed Rts     : 0           Total Hist. Rts             : 0
Total Decay Rts         : 0
 
Total VPN Peer Groups   : 0           Total VPN Peers             : 0
Total VPN Local Rts     : 8672
Total VPN-IPv4 Rem. Rts : 8656        Total VPN-IPv4 Rem. Act. Rts: 8656
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 (Addr Family)
                      PktSent OutQ
-------------------------------------------------------------------------------
44.44.10.12
                65000     673    0 04h20m24s 600/563/569 (IPv4)
                          575    0           8656/8656/8672 (VpnIPv4)
===============================================================================
*A:7705_ALU-2>show>router>bgp#
*A:7705_ALU-2>show>router>bgp# summary family ipv4
===============================================================================
 BGP Router ID : 44.44.10.1        AS : 65000   Local AS : 65000
===============================================================================
BGP Admin State         : Up          BGP Oper State              : Up
Total Peer Groups       : 1           Total Peers                 : 1
Total BGP Paths         : 74          Total Path Memory           : 9128
Total IPv4 Remote Rts   : 600         Total IPv4 Rem. Active Rts  : 563
Total Supressed Rts     : 0           Total Hist. Rts             : 0
Total Decay Rts         : 0
 
Total VPN Peer Groups   : 0           Total VPN Peers             : 0
Total VPN Local Rts     : 8672
Total VPN-IPv4 Rem. Rts : 8656        Total VPN-IPv4 Rem. Act. Rts: 8656
Total VPN Supp. Rts     : 0           Total VPN Hist. Rts         : 0
Total VPN Decay Rts     : 0
===============================================================================
BGP IPv4 Summary
===============================================================================
Neighbor
                   AS PktRcvd PktSent  InQ OutQ Up/Down   State|Recv/Actv/Sent
-------------------------------------------------------------------------------
44.44.10.12
                65000     679     581    0    0 04h23m36s 600/563/569
===============================================================================
*A:7705_ALU-2>show>router>bgp#
Table 78:  Show BGP Summary Output Fields  

Label

Description

BGP Router ID

The local BGP router ID

AS

The configured autonomous system number

Local AS

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

Total Peer Groups

The total number of configured BGP peer groups

Total Peers

The total number of configured BGP peers

Total BGP Paths

The total number of unique sets of BGP path attributes learned from BGP peers

Total Path Memory

The total amount of memory used to store the path attributes

Total IPv4 Remote Rts

The total number of IPv4 routes learned from BGP peers

Total IPv4 Remote Act. Rts

The total number of IPv4 routes used in the forwarding table

Total Supressed Rts

The total number of suppressed routes due to route damping

Total Hist. Rts

The total number of routes with history due to route damping

Total Decay Rts

The total number of decayed routes due to route damping

Total VPN Peer Groups

The total number of configured VPN peer groups

Total VPN Peers

The total number of configured VPN peers

Total VPN Local Rts

The total number of configured local VPN routes

Total VPN-IPv4 Rem. Rts

The total number of configured remote VPN-IPv4 routes

Total VPN-IPv4 Rem. Act. Rts

The total number of active remote VPN-IPv4 routes used in the forwarding table

Total VPN Supp. Rts

The total number of suppressed VPN routes due to route damping

Total VPN Hist. Rts

The total number of VPN routes with history due to route damping

Total VPN Decay Rts

The total number of decayed routes due to route damping

Neighbor

The BGP neighbor address

AS (Neighbor)

The BGP neighbor autonomous system number

PktRcvd

The total number of packets received from the BGP neighbor

PktSent

The total number of packets sent to the BGP neighbor

InQ

The number of BGP messages to be processed

OutQ

The number of BGP messages to be transmitted

Up/Down

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

State|Recv/Actv/Sent (Addr Family)

The BGP neighbor’s current state (if not established) or the number of received routes, active routes and sent routes (if established), along with the address family

6.13.2.3. Clear Commands

flap-statistics

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

This command clears route flap statistics.

Parameters 
ip-prefix/mask
clears route flap statistics for entries that match the specified IP prefix and mask length
Values—
ip-prefix                a.b.c.d  (host bits must be 0)
mask:                     0 to 32

 

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

 

group-name
clears route flap statistics for entries received from any BGP neighbors in the specified peer group
reg-exp
clears route flap statistics for all entries that have the regular expression and the AS path that matches the regular expression
policy-name
clears route flap statistics for entries that match the specified route policy

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
Description 

This command resets the specified BGP peer or 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-number
resets all BGP neighbors with the specified peer AS
Values—
1 to 4294967295

 

external—
resets all EBGP neighbors
all—
resets all BGP neighbors
soft—
the specified BGP neighbors re-evaluate all routes in the Local-RIB against the configured export policies
soft-inbound—
the specified BGP neighbors re-evaluate all routes in the RIB-In against the configured import policies
statistics—
the BGP neighbor statistics
end-of-rib—
clears the routing information base (RIB)

protocol

Syntax 
protocol
Context 
clear>router>bgp
Description 

This command resets the entire BGP protocol.

6.13.2.4. Debug Commands

events

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

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

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

 

name
debugs only events affecting the specified peer group and associated neighbors

graceful-restart

Syntax 
graceful-restart [neighbor ip-address | group name]
no graceful-restart
Context 
debug>router>bgp
Description 

This command enables debugging for BGP graceful restart.

The no form of the command disables the debugging.

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

 

name
debugs only events affecting the specified peer group and associated neighbors

keepalive

Syntax 
keepalive [neighbor ip-address | group name]
no keepalive
Context 
debug>router>bgp
Description 

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

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

 

name
debugs only events affecting the specified peer group and associated neighbors

notification

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

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

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

 

name
debugs only events affecting the specified peer group and associated neighbors

open

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

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

Parameters 
ip-address
debugs only events affecting the specified BGP neighbor
name
debugs only events affecting the specified peer group and associated neighbors

outbound-route-filtering

Syntax 
 [no] outbound-route-filtering
Context 
debug>router>bgp
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
Description 

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

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

 

name
debugs only events affecting the specified peer group and associated neighbors

route-refresh

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

This command enables and disables debugging for BGP route refresh.

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

 

name
debugs only events affecting the specified peer group and associated neighbors

rtm

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

This command logs RTM changes in the debug log.

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

 

name
debugs only events affecting the specified peer group and associated neighbors

socket

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

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

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

 

name
debugs only events affecting the specified peer group and associated neighbors

timers

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

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

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

 

name
debugs only events affecting the specified peer group and associated neighbors

update

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

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

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

 

name
debugs only events affecting the specified peer group and associated neighbors