cc/td/doc/product/software/ios121/121sup/121csum1
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

BGP Commands

BGP Commands

This chapter explains the function and syntax of the Border Gateway Protocol (BGP) commands. For more information about defaults and usage guidelines, see the corresponding chapter of the Cisco IOS IP and IP Routing Command Reference, Release 12.1.

aggregate-address

To create an aggregate entry in a BGP routing table, use the aggregate-address router configuration command. To disable this function, use the no form of this command.

aggregate-address address mask [as-set] [summary-only] [suppress-map map-name][advertise-map map-name] [attribute-map map-name]

no aggregate-address address mask [as-set] [summary-only] [suppress-map map-name][advertise-map map-name] [attribute-map map-name]

Syntax Description

address

Aggregate address.

mask

Aggregate mask.

as-set

(Optional) Generates autonomous system set path information.

summary-only

(Optional) Filters all more specific routes from updates.

suppress-map map-name

(Optional) Name of route map used to select the routes to be suppressed.

advertise-map map-name

(Optional) Name of route map used to select the routes to create AS-SET origin communities.

attribute-map map-name

(Optional) Name of route map used to set the attribute of the aggregate route.

auto-summary (BGP)

To restore the default behavior of automatic summarization of subnet routes into network-level routes, use the auto-summary router configuration command. To disable this feature and send subprefix routing information across classful network boundaries, use the no form of this command.

auto-summary

no auto-summary

Syntax Description

This command has no arguments or keywords.

bgp always-compare-med

To allow the comparison of the Multi Exit Discriminator (MED) for paths from neighbors in different autonomous systems, use the bgp always-compare-med router configuration command. To disallow the comparison, use the no form of this command.

bgp always-compare-med

no bgp always-compare-med

Syntax Description

This command has no arguments or keywords.

bgp bestpath as-path ignore

To prevent the router from considering as-path as a factor in the algorithm for choosing a route, use the bgp bestpath as-path ignore router configuration command. To allow the router to consider as-path in choosing a route, use the no form of this command.

bgp bestpath as-path ignore

no bgp bestpath as-path ignore

Syntax Description

This command has no arguments or keywords.

bgp bestpath med-confed

To enable MED comparison among paths learned from confederation peers, use the bgp bestpath med-confed router configuration command. To prevent the software from considering the MED attribute in comparing paths, use the no form of this command.

bgp bestpath med-confed

no bgp bestpath med-confed

Syntax Description

This command has no arguments or keywords.

bgp bestpath missing-as-worst

To have Cisco IOS software consider a missing MED attribute in a path as having a value of infinity, making the path without a MED value the least desirable path, use the bgp bestpath missing-as-worst router configuration command. To return the router to the default (assign a value of 0 to the missing MED), use the no form of this command.

bgp bestpath missing-as-worst

no bgp bestpath missing-as-worst

Syntax Description

This command has no arguments or keywords.

bgp client-to-client reflection

To restore route reflection from a Border Gateway Protocol (BGP) route reflector to clients, use the bgp client-to-client reflection router configuration command. To disable client-to-client reflection, use the no form of this command.

bgp client-to-client reflection

no bgp client-to-client reflection

Syntax Description

This command has no arguments or keywords.

bgp cluster-id

To configure the cluster ID if the Border Gateway Protocol (BGP) cluster has more than one route reflector, use the bgp cluster-id router configuration command. To remove the cluster ID, use the no form of this command.

bgp cluster-id cluster-id

no bgp cluster-id cluster-id

Syntax Description

cluster-id

Cluster ID of this router acting as a route reflector; maximum of 4 bytes.

bgp confederation identifier

To specify a Border Gateway Protocol (BGP) confederation identifier, use the bgp confederation identifier router configuration command. To remove the confederation identifier, use the no form of this command.

bgp confederation identifier autonomous-system

no bgp confederation identifier autonomous-system

Syntax Description

autonomous-system

Autonomous system number that internally includes multiple autonomous systems.

bgp confederation peers

To configure the autonomous systems that belong to the confederation, use the bgp confederation peers router configuration command. To remove an autonomous system from the confederation, use the no form of this command.

bgp confederation peers autonomous-system [autonomous-system]

no bgp confederation peers autonomous-system [autonomous-system]

Syntax Description

autonomous-system

Autonomous system numbers for BGP peers that will belong to the confederation.

No confederation peers are configured.

bgp dampening

To enable Border Gateway Protocol (BGP) route dampening or change various BGP route dampening factors, use the bgp dampening global configuration command. To disable the function or restore the default values, use the no form of this command.

bgp dampening [half-life reuse suppress max-suppress-time] [route-map map]

no bgp dampening [half-life reuse suppress max-suppress-time] [route-map map]

Syntax Description

half-life

(Optional) Time (in minutes) after which a penalty is decreased. Once the route has been assigned a penalty, the penalty is decreased by half after the half-life period (which is 15 minutes by default). The process of reducing the penalty happens every 5 seconds. The range of the half-life period is 1 to 45 minutes. The default is 15 minutes.

reuse

(Optional) If the penalty for a flapping route decreases enough to fall below this value, the route is unsuppressed. The process of unsuppressing routes occurs at 10-second increments. The range of the reuse value is 1 to 20000; the default is 750.

suppress

(Optional) A route is suppressed when its penalty exceeds this limit. The range is 1 to 20000; the default is 2000.

max-suppress-time

(Optional) Maximum time (in minutes) a route can be suppressed. The range is 1 to 20000; the default is 4 times the half-life. If the half-life value is allowed to default, the maximum suppress time defaults to 60 minutes.

route-map map

(Optional) Name of route map that controls where BGP route dampening is enabled.

bgp default local-preference

To change the default local preference value, use the bgp default local-preference router configuration command. To return to the default setting, use the no form of this command.

bgp default local-preference value

no bgp default local-preference value

Syntax Description

value

Local preference value from 0 to 4294967295. Higher is more preferred.

bgp deterministic med

To have Cisco IOS software compare the MED variable when choosing among routes advertised by different peers in the same autonomous system, use the bgp deterministic med router configuration command. To disallow the comparison, use the no form of this command.

bgp deterministic med

no bgp deterministic med

Syntax Description

This command has no arguments or keywords.

bgp fast-external-fallover

To immediately reset the Border Gateway Protocol (BGP) sessions of any directly adjacent external peers if the link used to reach them goes down, use the bgp fast-external-fallover router configuration command. To disable this function, use the no form of this command.

bgp fast-external-fallover

no bgp fast-external-fallover

Syntax Description

This command has no arguments or keywords.

bgp log-neighbor-changes

To enable logging of Border Gateway Protocol (BGP) neighbor resets, use the bgp log-neighbor-changes router configuration command. To disable the logging of changes in BGP neighbor adjacencies, use the no form of this command.

bgp log-neighbor-changes

no bgp log-neighbor-changes

Syntax Description

This command has no arguments or keywords.

clear ip bgp

To reset a BGP connection using Border Gateway Protocol (BGP) soft reconfiguration, use the clear ip bgp EXEC command at the system prompt.

clear ip bgp {* | address | peer-group-name} [soft [in | out]]

Syntax Description

*

Resets all current BGP sessions.

address

Resets only the identified BGP neighbor.

peer-group-name

Resets the specified BGP peer group.

soft

(Optional) Soft reset. Does not reset the session.

in | out

(Optional) Triggers inbound or outbound soft reconfiguration. If the in or out option is not specified, both inbound and outbound soft reset are triggered.

clear ip bgp dampening

To clear Border Gateway Protocol (BGP) route dampening information and unsuppress the suppressed routes, use the clear ip bgp dampening EXEC command.

clear ip bgp dampening [address mask]

Syntax Description

address

(Optional) IP address of the network about which to clear dampening information.

mask

(Optional) Network mask applied to the address.

clear ip bgp flap-statistics

To clear Border Gateway Protocol (BGP) flap statistics, use the clear ip bgp flap-statistics EXEC command.

clear ip bgp address flap-statistics [{regexp regexp} | {filter-list list} | {address mask}]

Syntax Description

regexp regexp

(Optional) Clears flap statistics for all the paths that match the regular expression.

filter-list list

(Optional) Clears flap statistics for all the paths that pass the access list.

address

(Optional) Clears flap statistics for a single entry at this IP address. If this argument is placed before flap-statistics, the router clears flap statistics for all paths from the neighbor at this address.

mask

(Optional) Network mask applied to the address.

clear ip bgp peer-group

To clear all the members of a Border Gateway Protocol (BGP) peer group, use the clear ip bgp peer-group EXEC command.

clear ip bgp peer-group tag

Syntax Description

tag

Name of the BGP peer group to clear.

clear ip prefix-list

To reset the hit count of the prefix list entries, use the clear ip prefix-list router configuration command.

clear ip bgp prefix-list [name] [network/len]

Syntax Description

name

(Optional) The name of the prefix list from which the hit count is to be cleared.

network/len

(Optional) The network number and length (in bits) of the network mask.

default-information originate (BGP)

To originate network 0.0.0.0 into the Border Gateway Protocol (BGP), use the default-information originate router configuration command. To disable this function, use the no form of this command.

default-information originate

no default-information originate

Syntax Description

This command has no arguments or keywords.

default-metric (BGP)

To set default metric values for the Border Gateway Protocol BGP routing protocol, use the default-metric router configuration command. To return to the default state, use the no form of this command.

default-metric number

no default-metric number

Syntax Description

number

Default metric value appropriate for the specified routing protocol.

distance bgp

To allow the use of external, internal, and local administrative distances that could be a better route to a node, use the distance bgp router configuration command. To return to the default values, use the no form of this command.

distance bgp external-distance internal-distance local-distance

no distance bgp

Syntax Description

external-distance

Administrative distance for Border Gateway Protocol (BGP) external routes. External routes are routes for which the best path is learned from a neighbor external to the autonomous system. Acceptable values are from 1 to 255. The default is 20. Routes with a distance of 255 are not installed in the routing table.

internal-distance

Administrative distance for BGP internal routes. Internal routes are those routes that are learned from another BGP entity within the same autonomous system. Acceptable values are from 1 to 255. The default is 200. Routes with a distance of 255 are not installed in the routing table.

local-distance

Administrative distance for BGP local routes. Local routes are those networks listed with a network router configuration command, often as back doors, for that router or for networks that are being redistributed from another process. Acceptable values are from 1 to 255. The default is 200. Routes with a distance of 255 are not installed in the routing table.

distribute-list in

To filter networks received in updates, use the distribute-list in router configuration command. To disable this function, use the no form of this command.

distribute-list {access-list-number | prefix-list} in [type number]

no distribute-list {access-list-number | prefix-list} in [type number]

Syntax Description

access-list-number | name

Standard IP access list number or name. The list defines which networks are to be received and which are to be suppressed in routing updates.

prefix-list

Name of a prefix list. The list defines which networks are to be received and which are to be suppressed in routing updates, based upon matching the network prefix to the prefixes in the list.

in

Applies the access list to incoming routing updates.

type

(Optional) Interface type.

number

(Optional) Interface number on which the access list should be applied to incoming updates. If no interface is specified, the access list will be applied to all incoming updates.

distribute-list out

To suppress networks from being advertised in updates, use the distribute-list out router configuration command. To disable this function, use the no form of this command.

distribute-list {access-list-number | name | prefix-list prefix-listname} out [interface-name | routing-process | autonomous-system-number]

no distribute-list {access-list-number | name | prefix-list prefix-listname} out [interface-name | routing-process | autonomous-system-number]

Syntax Description

access-list-number | name

Standard IP access list number or name. The list defines which networks are to be received and which are to be suppressed in routing updates.

prefix-list

Name of a prefix list. The list defines which networks are to be received and which are to be suppressed in routing updates, based upon matching the network prefix to the prefixes in the list.

out

Applies the access list to outgoing routing updates.

interface-name

(Optional) Name of a particular interface.

routing-process

(Optional) Name of a particular routing process, or the keyword static or connected.

autonomous-system-
number

(Optional) Autonomous system number.

ip as-path access-list

To define a Border Gateway Protocol (BGP) AS path access list, use the ip as-path access-list global configuration command. To disable use of the access list, use the no form of this command.

ip as-path access-list access-list-number {permit | deny} as-regular-expression

no ip as-path access-list access-list-number

Syntax Description

access-list-number

Integer from 1 to 199 that indicates the regular expression access list number.

permit

Permits access for matching conditions.

deny

Denies access to matching conditions.

as-regular-expression

Autonomous system in the access list using a regular expression. See the appendix "Regular Expressions" in the Cisco IOS Dial Services Command Reference for information about forming regular expressions.

ip bgp-community new-format

To display BGP communities in the format AA:NN (autonomous system-community number/2-byte number), use the ip bgp-community new-format global configuration command. To reenable the previous display format for BGP communities (one 32-bit number), use the no form of this command.

ip bgp-community new-format

no ip bgp-community new-format

Syntax Description

This command has no argument or keywords.

ip community-list

To create a community list for Border Gateway Protocol (BGP) and control access to it, use the ip community-list global configuration command. To delete the community list, use the no form of this command.

ip community-list community-list-number {permit | deny} community-number

no ip community-list community-list-number

Syntax Description

community-list-number

Integer from 1 to 99 that identifies one or more permit or deny groups of communities.

permit

Permits access for a matching condition.

deny

Denies access for a matching condition.

community-number

Community number configured by a set community command. Valid value is one of the following:

  • A number from 1 to 4294967200. You can specify a single number or multiple numbers separated by a space.

  • internet---The Internet community.

  • no-export---Routes with this community are sent to peers in other sub-autonomous systems within a confederation. Do not advertise this route to an EBGP peer. External systems are those outside the confederation. If there is no confederation, an external system is any EBGP peer.

  • local-as ---Send this route to peers in other sub-autonomous systems within the local confederation. Do not advertise this route to an external system.

  • no-advertise---Do not advertise this route to any peer (internal or external).

ip prefix-list

To create an entry in a prefix list, use the ip prefix-list global configuration command. To delete the entry, use the no form of this command.

ip prefix-list list-name [seq seq-value] deny | permit network/len [ge ge-value] [le le-value]

no ip prefix-list list-name [seq seq-value] deny | permit network/len [ge ge-value] [le le-value]

Syntax Description

list-name

Name of a prefix list.

seq

(Optional) Applies the sequence number to the prefix list entry being created or deleted.

seq-value

(Optional) Specifies the sequence number for the prefix list entry.

deny

Denies access to matching conditions.

permit

Permits access for matching conditions.

network/len

(Mandatory) The network number and length (in bits) of the network mask.

ge

(Optional) Applies the ge-value to the range specified.

ge-value

(Optional) Specifies the lesser value of a range (the "from" portion of the range description).

le

(Optional) Applies the le-value to the range specified.

le-value

(Optional) Specifies the greater value of a range (the "to" portion of the range description).

ip prefix-list description

To add a text description of a prefix list, use the ip prefix-list description global configuration command. To remove the text description, use the no form of this command.

ip prefix-list list-name description text

no
ip prefix-list list-name description text

Syntax Description

list name

Prefix list name.

text

Text description of te prefix list.

ip prefix-list sequence-number

To enable the generation of sequence numbers for entries in a prefix list, use the ip prefix-list sequence-number global configuration command. To remove the text description, use the no form of this command.

ip prefix-list sequence-number

no
ip prefix-list sequence-number

Syntax Description

This command has no arguments or keywords.

match as-path

To match a Border Gateway Protocol (BGP) autonomous system path access list, use the match as-path route-map configuration command. To remove a path list entry, use the no form of this command.

match as-path path-list-number

no match as-path path-list-number

Syntax Description

path-list-number

Autonomous system path access list. An integer from 1 to 199.

match community-list

To match a Border Gateway Protocol (BGP) community, use the match community-list route-map configuration command. To remove the community list entry, use the no form of this command.

match community-list community-list-number [exact]

no match community-list community-list-number [exact]

Syntax Description

community-list-number

Community list number in the range 1 to 99.

exact

(Optional) Indicates an exact match is required. All of the communities and only those communities in the community list must be present.

neighbor advertisement-interval

To set the minimum interval between the sending of Border Gateway Protocol (BGP) routing updates, use the neighbor advertisement-interval router configuration command. To remove an entry, use the no form of this command.

neighbor {ip-address | peer-group-name} advertisement-interval seconds

no neighbor {ip-address | peer-group-name} advertisement-interval seconds

Syntax Description

ip-address

Neighbor's IP address.

peer-group-name

Name of a BGP peer group.

seconds

Time in seconds. Integer from 0 to 600.

neighbor default-originate

To allow a Border Gateway Protocol (BGP) speaker (the local router) to send the default route 0.0.0.0 to a neighbor for use as a default route, use the neighbor default-originate router configuration command. To send no route as a default, use the no form of this command.

neighbor {ip-address | peer-group-name} default-originate [route-map map-name]

no neighbor {ip-address | peer-group-name} default-originate [route-map map-name]

Syntax Description

ip-address

Neighbor's IP address.

peer-group-name

Name of a BGP peer group.

route-map map-name

(Optional) Name of the route map. The route map allows route 0.0.0.0 to be injected conditionally.

neighbor description

To associate a description with a neighbor, use the neighbor description router configuration command. To remove the description, use the no form of this command.

neighbor {ip-address | peer-group-name} description text

no neighbor {ip-address | peer-group-name} description [text]

Syntax Description

ip-address

Neighbor's IP address.

peer-group-name

Name of a BGP peer group.

text

Text (up to 80 characters) that describes the neighbor.

neighbor distribute-list

To distribute Border Gateway Protocol (BGP) neighbor information as specified in an access list, use the neighbor distribute-list router configuration command. To remove an entry, use the no form of this command.

neighbor {ip-address | peer-group-name} distribute-list {access-list-number | name/ prefix-list-name} {in | out}

no neighbor {ip-address | peer-group-name} distribute-list {access-list-number | name/prefix-list-name} {in |out}

Syntax Description

ip-address

Neighbor's IP address.

peer-group-name

Name of a BGP peer group.

access-list-number | name

Number or name of a standard or extended access list. It can be an integer from 1 to 199.

prefix-list-name

Name of a BGP prefix list.

in

Access list is applied to incoming advertisements to that neighbor.

out

Access list is applied to outgoing advertisements from that neighbor.

neighbor ebgp-multihop

To accept and attempt Border Gateway Protocol (BGP) connections to external peers residing on networks that are not directly connected, use the neighbor ebgp-multihop router configuration command. To return to the default, use the no form of this command.

neighbor {ip-address | peer-group-name} ebgp-multihop [ttl]

no neighbor {ip-address | peer-group-name} ebgp-multihop

Syntax Description

ip-address

IP address of the BGP-speaking neighbor.

peer-group-name

Name of a BGP peer group.

ttl

(Optional) Time-to-live in the range 1 to 255 hops.

neighbor filter-list

To set up a Border Gateway Protocol (BGP) filter, use the neighbor filter-list router configuration command. To disable this function, use the no form of this command.

neighbor {ip-address | peer-group-name} filter-list access-list-number {in | out}

no neighbor {ip-address | peer-group-name} filter-list access-list-number {in | out}

Syntax Description

ip-address

IP address of the neighbor.

peer-group-name

Name of a BGP peer group.

access-list-number

Number of an autonomous system path access list. You define this access list with the ip as-path access-list command.

in

Access list to incoming routes.

out

Access list to outgoing routes.

neighbor maximum-prefix

To control how many prefixes can be received from a neighbor, use the neighbor maximum-prefix router configuration command. To disable this function, use the no form of this command.

neighbor {ip-address | peer-group-name} maximum-prefix maximum [threshold] [warning-only]

no neighbor {ip-address | peer-group-name} maximum-prefix maximum

Syntax Description

ip-address

IP address of the neighbor.

peer-group-name

Name of a BGP peer group.

maximum

Maximum number of prefixes allowed from this neighbor.

threshold

(Optional) Integer specifying at what percentage of maximum the router starts to generate a warning message. The range is from 1 to 100; the default is 75 (percent).

warning-only

(Optional) Allows the router to generate log message when the maximum is exceeded, instead of terminating the peering.

neighbor next-hop-self

To configure the router as the next hop for a BGP-speaking neighbor or peer group, use the neighbor next-hop-self router configuration command. To disable this feature, use the no form of this command.

neighbor {ip-address | peer-group-name} next-hop-self

no neighbor {ip-address | peer-group-name} next-hop-self

Syntax Description

ip-address

IP address of the BGP-speaking neighbor.

peer-group-name

Name of a BGP peer group.

neighbor password

To enable Message Digest 5 (MD5) authentication on a TCP connection between two Border Gateway Protocol (BGP) peers, use the neighbor password router configuration command. To disable this function, use the no form of this command.

neighbor {ip-address | peer-group-name} password string

no neighbor {ip-address | peer-group-name} password

Syntax Description

ip-address

IP address of the BGP-speaking neighbor.

peer-group-name

Name of a BGP peer group.

string

Case-sensitive password of up to 80 characters. The first character cannot be a number. The string can contain any alphanumeric characters, including spaces. You cannot specify a password in the format number-space-anything. The space after the number causes problems.

neighbor peer-group (assigning members)

To configure a Border Gateway Protocol (BGP) neighbor to be a member of a peer group, use the neighbor peer-group router configuration command. To remove the neighbor from the peer group, use the no form of this command.

neighbor ip-address peer-group peer-group-name

no neighbor ip-address peer-group peer-group-name

Syntax Description

ip-address

IP address of the BGP neighbor who belongs to the peer group specified by the tag.

peer-group-name

Name of the BGP peer group to which this neighbor belongs.

neighbor peer-group (creating)

To create a Border Gateway Protocol (BGP) peer group, use the neighbor peer-group router configuration command. To remove the peer group and all of its members, use the no form of this command.

neighbor peer-group-name peer-group

no neighbor peer-group-name peer-group

Syntax Description

peer-group-name

Name of the BGP peer group.

neighbor prefix-list

To distribute Border Gateway Protocol (BGP) neighbor information as specified in a prefix list, use the neighbor prefix-list router configuration command. To remove an entry, use the no form of this command.

neighbor {ip-address | peer-group-name} prefix-list prefix-listname {in | out}

no neighbor {ip-address | peer-group-name} prefix-list prefix-listname {in | out}

Syntax Description

ip-address

Neighbor's IP address.

peer-group-name

Name of a BGP peer group.

prefix-listname

Name of a prefix list.

in

Access list is applied to incoming advertisements to that neighbor.

out

Access list is applied to outgoing advertisements from that neighbor.

neighbor remote-as

To add an entry to the Border Gateway Protocol (BGP) neighbor table, use the neighbor remote-as router configuration command. To remove an entry from the table, use the no form of this command.

neighbor {ip-address | peer-group-name} remote-as number

no neighbor {ip-address | peer-group-name} remote-as number

Syntax Description

ip-address

Neighbor's IP address.

peer-group-name

Name of a BGP peer group.

number

Autonomous system to which the neighbor belongs.

neighbor route-map

To apply a route map to incoming or outgoing routes, use the neighbor route-map router configuration command. To remove a route map, use the no form of this command.

neighbor {ip-address | peer-group-name} route-map map-name {in | out}

no neighbor {ip-address | peer-group-name} route-map map-name {in | out}

Syntax Description

ip-address

Neighbor's IP address.

peer-group-name

Name of a BGP peer group.

map-name

Name of route map.

in

Apply to incoming routes.

out

Apply to outgoing routes.

neighbor route-reflector-client

To configure the router as a Border Gateway Protocol (BGP) route reflector and configure the specified neighbor as its client, use the neighbor route-reflector-client router configuration command. To indicate that the neighbor is not a client, use the no form of this command. When all the clients are disabled, the local router is no longer a route reflector.

neighbor ip-address route-reflector-client

no neighbor ip-address route-reflector-client

Syntax Description

ip-address

IP address of the BGP neighbor being identified as a client.

neighbor send-community

To specify that a "communities" attribute should be sent to a Border Gateway Protocol (BGP) neighbor, use the neighbor send-community router configuration command. To remove the entry, use the no form of this command.

neighbor {ip-address | peer-group-name} send-community

no neighbor {ip-address | peer-group-name} send-community

Syntax Description

ip-address

Neighbor's IP address.

peer-group-name

Name of a BGP peer group.

neighbor shutdown

To disable a neighbor or peer group, use the neighbor shutdown router configuration command. To reenable the neighbor or peer group, use the no form of this command.

neighbor {ip-address | peer-group-name} shutdown

no neighbor {ip-address | peer-group-name} shutdown

Syntax Description

ip-address

Neighbor's IP address.

peer-group-name

Name of a BGP peer group.

neighbor soft-reconfiguration

To configure the Cisco IOS software to start storing updates, use the neighbor soft-reconfiguration router configuration command. To not store received updates, use the no form of this command.

neighbor {ip-address | peer-group-name} soft-reconfiguration [inbound]

no neighbor {ip-address | peer-group-name} soft-reconfiguration [inbound]

Syntax Description

ip-address

IP address of the BGP-speaking neighbor.

peer-group-name

Name of a BGP peer group.

inbound

(Optional) Keyword indicating that the update to be stored is an incoming update.

neighbor timers

To set the timers for a specific Border Gateway Protocol (BGP) peer or peer group, use the neighbor timers router configuration command. To clear the timers for a specific BGP peer or peer group, use the no form of this command.

neighbor [ip-address | peer-group-name] timers keepalive holdtime

no neighbor [ip-address | peer-group-name] timers keepalive holdtime

Syntax Description

ip-address

(Optional) A BGP peer or peer group IP address.

peer-group-name

(Optional) Name of the BGP peer group.

keepalive

Frequency, in seconds, with which the Cisco IOS software sends keepalive messages to its peer. The default is 60 seconds.

holdtime

Interval, in seconds, after not receiving a keepalive message that the software declares a peer dead. The default is 180 seconds.

neighbor update-source

To have the Cisco IOS software allow internal Border Gateway Protocol (BGP) sessions to use any operational interface for TCP connections, use the neighbor update-source router configuration command. To restore the interface assignment to the closest interface, which is called the best local address, use the no form of this command.

neighbor {ip-address | peer-group-name} update-source interface

no neighbor {ip-address | peer-group-name} update-source interface

Syntax Description

ip-address

IP address of the BGP-speaking neighbor.

peer-group-name

Name of a BGP peer group.

interface

Loopback interface.

neighbor version

To configure the Cisco IOS software to accept only a particular Border Gateway Protocol (BGP) version, use the neighbor version router configuration command. To use the default version level of a neighbor, use the no form of this command.

neighbor {ip-address | peer-group-name} version value

no neighbor {ip-address | peer-group-name} version value

Syntax Description

ip-address

IP address of the BGP-speaking neighbor.

peer-group-name

Name of a BGP peer group.

value

BGP version number. The version can be set to 2 to force the software to only use Version 2 with the specified neighbor. The default is to use Version 4 and dynamically negotiate down to Version 2 if requested.

neighbor weight

To assign a weight to a neighbor connection, use the neighbor weight router configuration command. To remove a weight assignment, use the no form of this command.

neighbor {ip-address | peer-group-name} weight weight

no neighbor {ip-address | peer-group-name} weight weight

Syntax Description

ip-address

Neighbor's IP address.

peer-group-name

Name of a BGP peer group.

weight

Weight to assign. Acceptable values are 0 to 65535.

network (BGP)

To specify the networks to be advertised by the Border Gateway Protocol (BGP) routing process, use the network router configuration command. To remove an entry, use the no form of this command.

network network-number [mask network-mask]

no network network-number [mask network-mask]

Syntax Description

network-number

Network that BGP will advertise.

mask

(Optional) Network or subnetwork mask.

network-mask

(Optional) Network mask address.

network backdoor

To specify a backdoor route to a Border Gateway Protocol (BGP) border router that will provide better information about the network, use the network backdoor router configuration command. To remove an address from the list, use the no form of this command.

network address backdoor

no network address backdoor

Syntax Description

address

IP address of the network to which you want a backdoor route.

network weight

To assign an absolute weight to a Border Gateway Protocol (BGP) network, use the network weight router configuration command. To delete an entry, use the no form of the command.

network address mask weight weight [route-map map-name]

no network address mask weight weight [route-map map-name]

Syntax Description

address

IP address of the network.

mask

Network mask of the network.

weight

Absolute weight, or importance. It can be an integer from 0 to 65535.

route-map map-name

(Optional) Name of route map.

router bgp

To configure the Border Gateway Protocol (BGP) routing process, use the router bgp global configuration command. To remove a routing process, use the no form of this command.

router bgp autonomous-system

no router bgp autonomous-system

Syntax Description

autonomous-system

Number of an autonomous system that identifies the router to other BGP routers and tags the routing information passed along.

set as-path

To modify an autonomous system path for Border Gateway Protocol (BGP) routes, use the set as-path route-map configuration command. To not modify the autonomous system path, use the no form of this command.

set as-path {tag | prepend as-path-string}

no set as-path {tag | prepend as-path-string}

Syntax Description

tag

Converts the tag of a route into an autonomous system path. Applies only when redistributing routes into BGP.

prepend as-path-string

Appends the string following the keyword prepend to the as-path of the route that is matched by the route map. Applies to inbound and outbound BGP route maps.

set comm-list delete

To remove communities from the community attribute of an inbound or outbound update, use the set comm-list delete router configuration command. To negate a previous set comm-list delete command, use the no form of this command.

set comm-list list-num delete

no set comm-list list-num delete

Syntax Description

list-num

A standard or extended community list number.

set community

To set the Border Gateway Protocol (BGP) COMMUNITIES attribute, use the set community route-map configuration command. To delete the entry, use the no form of this command.

set community {community-number [additive]} | none

no set community {community-number [additive]} | none

Syntax Description

community-number

Valid values are 1 to 4294967200, no-export, or no-advertise.

additive

(Optional) Adds the community to the already existing communities.

none

Removes the COMMUNITY attribute from the prefixes that pass the route-map.

set dampening

To set the Border Gateway Protocol (BGP) route dampening factors, use the set dampening route-map configuration command. To disable this function, use the no form of this command.

set dampening half-life reuse suppress max-suppress-time

no set dampening

Syntax Description

half-life

Time (in minutes) after which a penalty is decreased. Once the route has been assigned a penalty, the penalty is decreased by half after the half-life period (which is 15 minutes by default). The process of reducing the penalty happens every 5 seconds. The range of the half-life period is 1 to 45 minutes. The default is 15 minutes.

reuse

If the penalty for a flapping route decreases enough to fall below this value, the route is unsuppressed. The process of unsuppressing routes occurs at 10-second increments. The range of the reuse value is 1 to 20000; the default is 750.

suppress

A route is suppressed when its penalty exceeds this limit. The range is 1 to 20000; the default is 2000.

max-suppress-time

Maximum time (in minutes) a route can be suppressed. The range is 1 to 20000; the default is 4 times the half-life value. If the half-life value is allowed to default, the maximum suppress time defaults to 60 minutes.

set ip next-hop (BGP)

To indicate where to output packets that pass a match clause of a route map for policy routing, use the set ip next-hop route-map configuration command. To delete an entry, use the no form of this command.

set ip next-hop ip-address [...ip-address] [peer-address]

no set ip next-hop ip-address [...ip-address] [peer-address]

Syntax Description

ip-address

IP address of the next hop to which packets are output. It need not be an adjacent router.

peer-address

(Optional) Sets the next hop to be the BGP peering address.

set metric-type internal

To set the MED value on prefixes advertised to External Border Gateway Protocol (EBGP) neighbors to match the Interior Gateway Protocol (IGP) metric of the next hop, use the set metric-type internal route-map configuration command. To return to the default, use the no form of this command.

set metric-type internal

no set metric-type internal

Syntax Description

This command has no arguments or keywords.

set origin (BGP)

To set the Border Gateway Protocol (BGP) origin code, use the set origin route-map configuration command. To delete an entry, use the no form of this command.

set origin {igp | egp autonomous-system | incomplete}

no set origin {igp | egp autonomous-system | incomplete}

Syntax Description

igp

Remote Interior Gateway Protocol (IGP) system.

egp

Local Exterior Gateway Protocol (EGP) system.

autonomous-system

Remote autonomous system. This is an integer from 0 to 65535.

incomplete

Unknown heritage.

set weight

To specify the Border Gateway Protocol (BGP) weight for the routing table, use the set weight route-map configuration command. To delete an entry, use the no form of this command.

set weight weight

no set weight weight

Syntax Description

weight

Weight value. It can be an integer from 0 to 65535.

show ip bgp

To display entries in the Border Gateway Protocol (BGP) routing table, use the show ip bgp EXEC command.

show ip bgp [network] [network-mask] [longer-prefixes]

Syntax Description

network

(Optional) Network number, entered to display a particular network in the BGP routing table.

network-mask

(Optional) Displays all BGP routes matching the address/mask pair.

longer-prefixes

(Optional) Displays route and more specific routes.

show ip bgp cidr-only

To display routes with nonnatural network masks (that is, classless interdomain routing, or CIDR), use the show ip bgp cidr-only privileged EXEC command.

show ip bgp cidr-only

Syntax Description

This command has no arguments or keywords.

show ip bgp community

To display routes that belong to specified Border Gateway Protocol (BGP) communities, use the show ip bgp community EXEC command.

show ip bgp community community-number [exact]

Syntax Description

community-number

Valid value is community number in the range 1 to 4294967200 or AA:NN (autonomous system-community number/2-byte number), internet, no-export, local-as, or no-advertise.

exact

(Optional) Displays only routes that have exactly the same specified communities.

show ip bgp community-list

To display routes that are permitted by the Border Gateway Protocol (BGP) community list, use the show ip bgp community-list EXEC command.

show ip bgp community-list community-list-number [exact]

Syntax Description

community-list-number

Community list number in the range 1 to 99.

exact

(Optional) Displays only routes that have an exact match.

show ip bgp dampened-paths

To display Border Gateway Protocol (BGP) dampened routes, use the show ip bgp dampened-paths EXEC command.

show ip bgp dampened-paths

Syntax Description

This command has no arguments or keywords.

show ip bgp filter-list

To display routes that conform to a specified filter list, use the show ip bgp filter-list privileged EXEC command.

show ip bgp filter-list access-list-number

Syntax Description

access-list-number

Number of an autonomous system path access list. It can be a number from 1 to 199.

show ip bgp flap-statistics

To display Border Gateway Protocol (BGP) flap statistics, use the show ip bgp flap-statistics EXEC command.

show ip bgp flap-statistics [{regexp regexp} | {filter-list list} | {address mask [longer-prefix]}]

Syntax Description

regexp regexp

(Optional) Clears flap statistics for all the paths that match the regular expression.

filter-list list

(Optional) Clears flap statistics for all the paths that pass the access list.

address

(Optional) Clears flap statistics for a single entry at this IP address.

mask

(Optional) Network mask applied to the address.

longer-prefix

(Optional) Displays flap statistics for more specific entries.

show ip bgp inconsistent-as

To display routes with inconsistent originating autonomous systems, use the show ip bgp inconsistent-as privileged EXEC command.

show ip bgp inconsistent-as

Syntax Description

This command has no arguments or keywords.

show ip bgp neighbors

To display information about the TCP and Border Gateway Protocol (BGP) connections to neighbors, use the show ip bgp neighbors EXEC command.

show ip bgp neighbors [address] [received-routes | routes | advertised-routes | {paths regular-expression} | dampened-routes]

Syntax Description

address

(Optional) Address of the neighbor whose routes you have learned from. If you omit this argument, all neighbors are displayed.

received-routes

(Optional) Displays all received routes (both accepted and rejected) from the specified neighbor.

routes

(Optional) Displays all routes that are received and accepted. This is a subset of the output from the received-routes keyword.

advertised-routes

(Optional) Displays all the routes the router has advertised to the neighbor.

paths regular-expression

(Optional) Regular expression that is used to match the paths received.

dampened-routes

(Optional) Displays the dampened routes to the neighbor at the IP address specified.

show ip bgp paths

To display all the Border Gateway Protocol (BGP) paths in the database, use the show ip bgp paths EXEC command.

show ip bgp paths

Syntax Description

This command has no arguments or keywords.

show ip bgp peer-group

To display information about Border Gateway Protocol (BGP) peer groups, use the show ip bgp peer-group EXEC command.

show ip bgp peer-group [tag] [summary]

Syntax Description

tag

(Optional) Displays information about that specific peer group.

summary

(Optional) Displays a summary of the status of all the members of a peer group.

show ip bgp regexp

To display routes matching the AS path regular expression, use the show ip bgp regexp privileged EXEC command.

show ip bgp regexp regular-expression

Syntax Description

regular-expression

Regular expression to match the BGP autonomous system paths.

show ip bgp summary

To display the status of all Border Gateway Protocol (BGP) connections, use the show ip bgp summary EXEC command.

show ip bgp summary

Syntax Description

This command has no arguments or keywords.

show ip prefix-list

To display information about a prefix list or prefix list entries, use the show ip prefix-list EXEC command.

show ip prefix-list [detail-summary] name [network/len] [seq seq-num] [longer] [first-match]

Syntax Description

detail-summary

(Optional) Displays detailed or summarized information about all prefix lists.

name

(Optional) The name of a specific prefix list.

network/len

(Optional) The network number and length (in bits) of the network mask.

seq

(Optional) Applies the sequence number to the prefix list entry.

seq-num

The sequence number of the prefix list entry.

longer

Displays all entries of a prefix list that are more specific than the given network/len.

first-match

Displays the entry of a prefix list that matches the given network/len.

synchronization

To enable the synchronization between Border Gateway Protocol (BGP) and your Interior Gateway Protocol (IGP) system, use the synchronization router configuration command. To enable the Cisco IOS software to advertise a network route without waiting for the IGP, use the no form of this command.

synchronization

no synchronization

Syntax Description

This command has no arguments or keywords.

table-map

To modify metric and tag values when the IP routing table is updated with Border Gateway Protocol (BGP) learned routes, use the table-map router configuration command. To disable this function, use the no form of the command.

table-map route-map-name

no table-map route-map-name

Syntax Description

route-map-name

Route-map name, from the route-map command.

timers bgp

To adjust Border Gateway Protocol (BGP) network timers, use the timers bgp router configuration command. To reset the BGP timing defaults, use the no form of this command.

timers bgp keepalive holdtime

no timers bgp

Syntax Description

keepalive

Frequency, in seconds, with which the Cisco IOS software sends keepalive messages to its peer. The default is 60 seconds.

holdtime

Interval, in seconds, after not receiving a keepalive message that the software declares a peer dead. The default is 180 seconds.


hometocprevnextglossaryfeedbacksearchhelp
Posted: Wed Jul 26 13:56:22 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.