Table Of Contents
BGP Commands
aggregate-address
auto-summary (BGP)
bgp always-compare-med
bgp bestpath compare-routerid
bgp bestpath med confed
bgp bestpath med missing-as-worst
bgp client-to-client reflection
bgp cluster-id
bgp confederation identifier
bgp confederation peers
bgp dampening
bgp default local-preference
bgp default ipv4-unicast
bgp deterministic-med
bgp fast-external-fallover
bgp log-neighbor-changes
bgp redistribute-internal
bgp router-id
bgp rr-group
clear ip bgp
clear ip bgp dampening
clear ip bgp external
clear ip bgp flap-statistics
clear ip bgp peer-group
clear ip prefix-list
default-information originate (BGP)
default-metric (BGP)
distance bgp
distribute-list in (BGP)
distribute-list out (BGP)
export map
ip as-path access-list
ip bgp-community new-format
ip bgp fast-external-fallover
ip community-list
ip extcommunity-list
ip prefix-list
ip prefix-list description
ip prefix-list sequence-number
match as-path
match community
match extcommunity
maximum-paths
neighbor advertisement-interval
neighbor advertise-map non-exist-map
neighbor default-originate
neighbor description
neighbor distribute-list
neighbor ebgp-multihop
neighbor filter-list
neighbor maximum-prefix
neighbor next-hop-self
neighbor password
neighbor peer-group (assigning members)
neighbor peer-group (creating)
neighbor prefix-list
neighbor remote-as
neighbor remove-private-as
neighbor route-map
neighbor route-reflector-client
neighbor send-community
neighbor shutdown
neighbor soft-reconfiguration
neighbor timers
neighbor update-source
neighbor version
neighbor weight
network (BGP and multiprotocol BGP)
network backdoor
router bgp
set as-path
set comm-list delete
set community
set extcommunity
set dampening
set extcommunity
set ip next-hop (BGP)
set metric-type internal
set origin (BGP)
set weight
show ip bgp
show ip bgp cidr-only
show ip bgp community
show ip bgp community-list
show ip bgp dampened-paths
show ip extcommunity-list
show ip bgp filter-list
show ip bgp flap-statistics
show ip bgp inconsistent-as
show ip bgp neighbors
show ip bgp paths
show ip bgp peer-group
show ip bgp regexp
show ip bgp summary
show ip extcommunity-list
show ip prefix-list
synchronization
table-map
timers bgp
BGP Commands
Use the commands in this chapter to configure and monitor Border Gateway Protocol (BGP). For BGP configuration information and examples, refer to the "Configuring BGP" chapter of the Cisco IOS IP and IP Routing Configuration Guide. For multiprotocol BGP configuration information and examples, refer to the "Configuring Multiprotocol BGP Extensions for IP Multicast" chapter of the Cisco IOS IP and IP Routing Configuration Guide. For multiprotocol BGP command descriptions, refer to the "Multiprotocol BGP Extensions for IP Multicast Commands" chapter.
aggregate-address
To create an aggregate entry in a Border Gateway Protocol (BGP) or multiprotocol BGP database, use the aggregate-address command in address family or router configuration mode. 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 the route map used to select the routes to be suppressed.
|
advertise-map map-name
|
(Optional) Name of the route map used to select the routes to create AS-SET origin communities.
|
attribute-map map-name
|
(Optional) Name of the route map used to set the attribute of the aggregate route.
|
Defaults
This command is disabled by default.
Command Modes
Address family configuration
Router configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
11.1(20)CC
|
The nlri unicast, nlri multicast, and nlri unicast multicast keywords were added.
|
12.0(2)S
|
The nlri unicast, nlri multicast, and nlri unicast multicast keywords were added.
|
12.0(7)T
|
The nlri unicast, nlri multicast, and nlri unicast multicast keywords were removed.
Address family configuration mode was added.
|
Usage Guidelines
You can implement aggregate routing in BGP and multiprotocol BGP either by redistributing an aggregate route into BGP or multiprotocol BGP, or by using this conditional aggregate routing feature.
Using the aggregate-address command with no keywords will create an aggregate entry in the BGP or multiprotocol BGP routing table if any more-specific BGP or multiprotocol BGP routes are available that fall in the specified range. The aggregate route will be advertised as coming from your autonomous system and will have the atomic aggregate attribute set to show that information might be missing. (By default, the atomic aggregate attribute is set unless you specify the as-set keyword.)
Using the as-set keyword creates an aggregate entry using the same rules that the command follows without this keyword, but the path advertised for this route will be an AS_SET consisting of all elements contained in all paths that are being summarized. Do not use this form of the aggregate-address command when aggregating many paths, because this route must be continually withdrawn and reupdated as autonomous system path reachability information for the summarized routes changes.
Using the summary-only keyword not only creates the aggregate route (for example, 10.*.*.*) but also suppresses advertisements of more-specific routes to all neighbors. If you want to suppress only advertisements to certain neighbors, you may use the neighbor distribute-list command, with caution. If a more-specific route leaks out, all BGP or multiprotocol BGP routers will prefer that route over the less-specific aggregate you are generating (using longest-match routing).
Using the suppress-map keyword creates the aggregate route but suppresses advertisement of specified routes. You can use the match clauses of route maps to selectively suppress some more-specific routes of the aggregate and leave others unsuppressed. IP access lists and autonomous system path access lists match clauses are supported.
Using the advertise-map keyword selects specific routes that will be used to build different components of the aggregate route, such as AS_SET or community. This form of the aggregate-address command is useful when the components of an aggregate are in separate autonomous systems and you want to create an aggregate with AS_SET, and advertise it back to some of the same autonomous systems. You must remember to omit the specific autonomous system numbers from the AS_SET to prevent the aggregate from being dropped by the BGP loop detection mechanism at the receiving router. IP access lists and autonomous system path access lists match clauses are supported.
Using the attribute-map keyword allows attributes of the aggregate route to be changed. This form of the aggregate-address command is useful when one of the routes forming the AS_SET is configured with an attribute such as the community no-export attribute, which would prevent the aggregate route from being exported. An attribute map route map can be created to change the aggregate attributes.
Examples
In the following example, a BGP aggregate address is created in router configuration mode. The path advertised for this route will be an AS_SET consisting of all elements contained in all paths that are being summarized.
aggregate-address 10.0.0.0 255.0.0.0 as-set
In the following example, a multiprotocol BGP aggregate address is created in address family configuration mode and applied to the multicast database only using an IP Version 4 address family. More-specific routes are filtered from updates.
address-family ipv4 multicast
aggregate-address 10.0.0.0 255.0.0.0 summary-only
In the following example, a route map called map-one is created matching on an as-path access list. The path advertised for this route will be an AS_SET consisting of elements contained in paths that are matched in the route map.
ip as-path access-list 1 deny ^1234_
ip as-path access-list 1 permit .*
aggregate-address 10.0.0.0 255.0.0.0 as-set advertise-map map-one
Related Commands
Command
|
Description
|
address-family ipv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard IPv4 address prefixes.
|
match ip address
|
Distributes any routes that have a destination network number address that is permitted by a standard or extended access list, and performs policy routing on packets.
|
route-map (IP)
|
Defines the conditions for redistributing routes from one routing protocol into another, or enables policy routing.
|
auto-summary (BGP)
To restore the default behavior of automatic summarization of subnet routes into network-level routes, use the auto-summary command in address family or router configuration mode. 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.
Defaults
The behavior of this command is enabled by default (the software summarizes subprefixes to the classful network boundary when crossing classful network boundaries).
Command Modes
Address family configuration
Router configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
12.0(7)T
|
Address family configuration mode was added.
|
Usage Guidelines
Route summarization reduces the amount of routing information in the routing tables.
By default, BGP does not accept subnets redistributed from Interior Gateway Protocol (IGP). To advertise and carry subnet routes in BGP, use an explicit network command or the no auto-summary command. If you disable auto-summarization and have not entered a network command, you will not advertise network routes for networks with subnet routes unless they contain a summary route.
Examples
In the following router configuration mode example, network numbers are not summarized automatically:
In the following address family configuration mode example, network numbers are not summarized automatically:
address-family ipv4 unicast
Related Commands
Command
|
Description
|
address-family ipv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard IPv4 address prefixes.
|
address-family vpnv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard VPNv4 address prefixes.
|
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 command in router configuration mode. 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.
Defaults
The Cisco IOS software does not compare MEDs for paths from neighbors in different autonomous systems.
Command Modes
Router configuration
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
Usage Guidelines
The MED is one of the parameters that is considered when selecting the best path among many alternative paths. The path with a lower MED is preferred over a path with a higher MED.
By default, during the best-path selection process, MED comparison is done only among paths from the same autonomous system. This command changes the default behavior by allowing comparison of MEDs among paths regardless of the autonomous system from which the paths are received.
Examples
The following example configures the BGP speaker in autonomous system 100 to compare MEDs among alternative paths, regardless of the autonomous system from which the paths are received:
nobgp bestpath as-path ignore
no bgp bestpath as-path ignore
Command History
Release
|
Modification
|
12.0
|
This command was introduced.
|
The following example prevents the BGP router from considering as-path as a factor in choosing a route.
Related Commandsrouter bgp 210
bgp bestpath as-path ignore
Command
|
Description
|
show ip bgp neighbors
|
Displays information about the TCP and BGP connections to neighbors.
|
bgp bestpath compare-routerid
To compare similar routes received from external BGP (eBGP) peers during the best path selection process and switch the best path to the route with the lowest router ID, use the bgp bestpath compare-routerid command in router configuration mode. To return the router to the default setting, use the no form of this command.
bgp bestpath compare-routerid
no bgp bestpath compare-routerid
Border Gateway Protocol (BGP) does not compare similar paths received from eBGP peers during the best path selection process and switch the best path to the route with the lowest router ID.
Command History
Release
|
Modification
|
12.0
|
This command was introduced.
|
12.0 S
|
This command was introduced.
|
12.0 ST
|
This command was introduced.
|
Usage Guidelines
By default, during the best path selection process, when BGP receives similar routes from eBGP peers (all the attributes are the same except for the router ID), the best path is not switched to the route with the lowest router ID if that route was not the first route received. If the bgp bestpath compare-routerid command is enabled, then similar routes are compared and the best path is switched to the route with the lowest router ID.
The following example shows the BGP speaker in autonomous system 500 configured to compare the router IDs of similar paths, regardless of the autonomous system from which the paths are received:
bgp bestpath compare-routerid
Related Commands
Command
|
Description
|
show ip bgp
|
Displays entries in the BGP routing table.
|
bgp bestpath med confed
To enable MED comparison among paths learned from confederation peers, use the bgp bestpath med confed command in router configuration mode. 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.
Defaults
The software does not consider the MED attribute when choosing among paths learned from confederation peers.
Command Modes
Router configuration
Command History
Release
|
Modification
|
12.0
|
This command was introduced.
|
Usage Guidelines
The comparison between MEDs is only made if there are no external autonomous systems in the path (an external autonomous system is an autonomous system that is not within the confederation). If there is an external autonomous system in the path, then the external MED is passed transparently through the confederation, and the comparison is not made.
For example, assume that AS 65000, 65001, 65002, and 65004 are part of the confederation; AS1 is not; and we are comparing route A with four paths. If the bgp bestpath med confed command is enabled, path 1 would be chosen. The fourth path has a lower MED, but it is not involved in the MED comparison because there is an external autonomous system in this path.
path= 65000 65004, med=2
path= 65001 65004, med=3
path= 65002 65004, med=4
path= 65003 1, med=1
Examples
The following command enables the BGP router to compare MED values for paths learned from confederation peers.
Related Commands
Command
|
Description
|
show ip bgp
|
Display entries in the BGP routing table.
|
show ip bgp neighbors
|
Displays information about the TCP and BGP connections to neighbors.
|
bgp bestpath med 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 med missing-as-worst command in router configuration mode. 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 med missing-as-worst
no bgp bestpath med missing-as-worst
Syntax Description
This command has no arguments or keywords.
Defaults
The software assigns a value of 0 to the missing MED, causing the path with the missing MED attribute to be considered the best path.
Command Modes
Router configuration
Command History
Release
|
Modification
|
12.0
|
This command was introduced.
|
Examples
The following command specifies that the Border Gateway Protocol (BGP) router to consider a missing MED attribute in a path as having a value of infinity, making this path the least desirable path.
bgp bestpath med missing-as-worst
Related Commands
Command
|
Description
|
show ip bgp
|
Display entries in the BGP routing table.
|
show ip bgp neighbors
|
Displays information about the TCP and BGP connections to neighbors.
|
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 command in address family or router configuration mode. 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.
Defaults
When a route reflector is configured, the route reflector reflects routes from a client to other clients.
Command Modes
Address family configuration
Router configuration
Command History
Release
|
Modification
|
11.1
|
This command was introduced.
|
12.0(7)T
|
Address family configuration mode was added.
|
Usage Guidelines
By default, the clients of a route reflector are not required to be fully meshed and the routes from a client are reflected to other clients. However, if the clients are fully meshed, route reflection is not required. Use the no bgp client-to-client reflection command to disable client-to-client reflection.
Examples
In the following router configuration mode example, the local router is a route reflector. The three neighbors are fully meshed, so client-to-client reflection is disabled.
neighbor 10.24.95.22 route-reflector-client
neighbor 10.24.95.23 route-reflector-client
neighbor 10.24.95.24 route-reflector-client
no bgp client-to-client reflection
In the following address family configuration mode example, the local router is a route reflector. The three neighbors are fully meshed, so client-to-client reflection is disabled.
address-family ipv4 unicast
neighbor 10.24.95.22 route-reflector-client
neighbor 10.24.95.23 route-reflector-client
neighbor 10.24.95.24 route-reflector-client
no bgp client-to-client reflection
Related Commands
Command
|
Description
|
address-family ipv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard IPv4 address prefixes.
|
address-family vpnv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard VPNv4 address prefixes.
|
bgp cluster-id
|
Configures the cluster ID if the BGP cluster has more than one route reflector.
|
neighbor route-reflector-client
|
Configures the router as a BGP route reflector and configures the specified neighbor as its client.
|
show ip bgp
|
Displays entries in the BGP routing table.
|
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 command in router configuration mode. 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.
|
Defaults
The router ID of the single route reflector in a cluster
Command Modes
Router configuration
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
Usage Guidelines
Together, a route reflector and its clients form a cluster.
Usually a cluster of clients will have a single route reflector. In that case, the cluster is identified by the router ID of the route reflector. In order to increase redundancy and avoid a single point of failure, a cluster might have more than one route reflector. In this case, all route reflectors in the cluster must be configured with the 4-byte cluster ID so that a route reflector can recognize updates from route reflectors in the same cluster.
If the cluster has more than one route reflector, use this command to configure the cluster ID.
Examples
In the following example, the local router is one of the route reflectors serving the cluster. It is configured with the cluster ID to identify the cluster.
neighbor 172.16.70.24 route-reflector-client
Related Commands
bgp confederation identifier
To specify a Border Gateway Protocol (BGP) confederation identifier, use the bgp confederation identifier command in router configuration mode. 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.
|
Defaults
No confederation identifier is configured.
Command Modes
Router configuration
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
Usage Guidelines
One way to reduce the Interior Border Gateway Protocol (IBGP) mesh is to divide an autonomous system into multiple autonomous systems and group them into a single confederation. Each autonomous system is fully meshed within itself, and has a few connections to another autonomous system in the same confederation. Even though the peers in different autonomous systems have EBGP sessions, they exchange routing information as if they are IBGP peers. Specifically, the next hop, Multi Exit Discriminator (MED), and local preference information is preserved. The preservation of this information enables to you to retain a single Interior Gateway Protocol (IGP) for all the autonomous systems. To the outside world, the confederation looks like a single autonomous system.
Examples
In the following example, the autonomous system is divided into autonomous systems 4001, 4002, 4003, 4004, 4005, 4006, and 4007 and identified by the confederation identifier 5. Neighbor 10.2.3.4 is someone inside your routing domain confederation. Neighbor 10.4.5.6 is someone outside your routing domain confederation. To the outside world, there appears to be a single autonomous system with the number 5.
bgp confederation identifier 5
bgp confederation peers 4002 4003 4004 4005 4006 4007
neighbor 10.2.3.4 remote-as 4002
neighbor 10.4.5.6 remote-as 510
Related Commands
bgp confederation peers
To configure the autonomous systems that belong to the confederation, use the bgp confederation peers command in router configuration mode. 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.
|
Defaults
No Border Gateway Protocol (BGP) peers are identified as belonging to the confederation.
Command Modes
Router configuration
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
Usage Guidelines
The autonomous systems specified in this command are visible internally to a confederation. Each autonomous system is fully meshed within itself. The bgp confederation identifier command specifies the confederation to which the autonomous systems belong.
Examples
The following example specifies that autonomous systems 1090, 1091, 1092, and 1093 belong to a single confederation:
bgp confederation peers 1091 1092 1093
Related Commands
bgp dampening
To enable Border Gateway Protocol (BGP) route dampening or change various BGP route dampening factors, use the bgp dampening command in address family or router configuration mode. 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) Reuse values based on accumulated penalties. 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 from 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. When the max-suppress-time is configured, the maximum penalty will never be exceeded, regardless of the number of times that the prefix dampens. The maximum penalty is computed with the following formula:
Max penalty = reuse-limit *2^(maximum suppress time/half time)
|
route-map map
|
(Optional) Name of route map that controls where BGP route dampening is enabled.
|
Defaults
This command is disabled by default.
half-life is 15 minutes
reuse is 750
suppress is 2000
max-suppress-time is 4 times half-life
Command Modes
Address family configuration
Router configuration
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
12.0(7)T
|
Address family configuration mode was added.
|
Usage Guidelines
If this command is used with no arguments, it enables BGP route dampening. The arguments half-life, reuse, suppress, and max-suppress-time are position-dependent. Therefore, if any of them are used, they must all be specified.
When BGP dampening is configured and a prefix is withdrawn, BGP considers the withdrawn prefix as a flap and increases the penalty by a 1000. If BGP receives an attribute change, BGP increases the penalty by 500. If then the prefix has been withdrawn, BGP keeps the prefix in the BGP table as a history entry. If the prefix has not been withdrawn by the neighbor and BGP is not using this prefix, the prefix is marked as dampened. Dampened prefixes are not used in the BGP decision process and not installed to the routing table.
Examples
The following router configuration mode example sets the half-life to 30 minutes, the reuse value to 1500, the suppress value to 10000, and the maximum suppress time to 120 minutes:
bgp dampening 30 1500 10000 120
The following address family configuration mode example sets the half-life to 30 minutes, the reuse value to 1500, the suppress value to 10000, and the maximum suppress time to 120 minutes:
address-family ipv4 multicast
bgp dampening 30 1500 10000 120
Related Commands
Command
|
Description
|
address-family ipv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard IPv4 address prefixes.
|
address-family vpnv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard VPNv4 address prefixes.
|
clear ip bgp dampening
|
Clears BGP route dampening information and unsuppresses the suppressed routes.
|
clear ip bgp flap-statistics
|
Clears BGP flap statistics.
|
show ip bgp dampened-paths
|
Displays BGP dampened routes.
|
show ip bgp flap-statistics
|
Displays BGP flap statistics.
|
bgp default local-preference
To change the default local preference value, use the bgp default local-preference command in router configuration mode. 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.
|
Defaults
Local preference value of 100
Command Modes
Router configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
Generally, the default value of 100 allows you to easily define a particular path as less preferable than paths with no local preference attribute. The preference is sent to all routers and access servers in the local autonomous system.
Examples
The following example raises the default local preference value from the default of 100 to 200:
bgp default local-preference 200
Related Commands
Command
|
Description
|
set local-preference
|
Specifies a preference value for the autonomous system path.
|
bgp default ipv4-unicast
To enable the IP version 4 (IPv4) unicast address family on all neighbors, use the bgp default ipv4-unicast command in address family or router configuration mode. To disable the IPv4 unicast address family on all neighbors, use the no form of this command.
bgp default ipv4-unicast
no bgp default ipv4-unicast
Syntax Description
This command has no arguments or keywords.
Defaults
This command is disabled by default.
Command Modes
Address family
Router configuration
Command History
Release
|
Modification
|
12.0(5)T
|
This command was introduced.
|
Usage Guidelines
Use the neighbor activate address family configuration command for each neighbor you want to run the bgp default ipv4-unicast command for under the IPv4 unicast address family.
Examples
The following example enables IP version 4 unicast address family on all neighbors:
Related Commands
Command
|
Description
|
neighbor activate
|
Enables the exchange of information with a neighboring router.
|
bgp deterministic-med
To have Cisco IOS software enforce the deterministic comparison of the Multi Exit Discriminator (MED) variable between all paths received from the same autonomous system, use the bgp deterministic-med command in router configuration mode. To disable 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.
Defaults
The software does not enforce the deterministic comparison of the MED variable between all paths received from the same autonomous system.
Command Modes
Router configuration
Address-family configuration
Command History
Release
|
Modification
|
11.1
|
This command was introduced.
|
Usage Guidelines
After the bgp always-compare-med command is configured, all paths for the same prefix that are received from different neighbors, which are in the same autonomous system, will be grouped together and sorted by the ascending MED value (received-only paths are ignored and not grouped or sorted). The best path selection algorithm will then pick the best paths using the existing rules; the comparison is made on a per neighbor autonomous system basis and then global basis. The grouping and sorting of paths occurs immediately after this command is entered. For correct results, all routers in the local autonomous system must have this command enabled (or disabled).
Examples
The following example specifies that the BGP router compare MED variables when choosing among routes advertised by the same subautonomous system within a confederation:
Router(config)# router bgp 204
Router(config-router)# bgp deterministic-med
The following example show ip bgp command output illustrates how route selection is affected by the configuration of the bgp deterministic-med command. The order in which routes are received affects how routes are selected for best path selection when the bgp deterministic-med command is not enabled.
The following sample output from the show ip bgp command shows three paths that are received for the same prefix (10.100.0.0), and the bgp deterministic-med command is not enabled:
router# show ip bgp 10.100.0.0
BGP routing table entry for 10.100.0.0/16, version 40
Paths: (3 available, best #3, advertised over IBGP, EBGP)
192.168.43.10 from 192.168.43.10 (192.168.43.1)
Origin IGP, metric 0, localpref 100, valid, internal
192.168.43.22 from 192.168.43.22 (192.168.43.2)
Origin IGP, metric 20, localpref 100, valid, internal
192.168.43.3 from 192.168.43.3 (10.4.1.1)
Origin IGP, metric 30, valid, external, best
If the bgp deterministic-med command is not enabled on the router, the route selection can be affected by the order in which the routes are received. Consider the following scenario in which a router received three paths for the same prefix:
The clear ip bgp * command is entered to clear all routes in the local routing table.
The show ip bgp command is issued again after the routing table has been repopulated. Note that the order of the paths changed after clearing the BGP session. The results of the selection algorithm also changed. This occurred because the order in which the paths were received was different for the second session.
Router# show ip bgp 10.100.0.0
BGP routing table entry for 10.100.0.0/16, version 2
Paths: (3 available, best #3, advertised over EBGP)
109 192.168.43.10 from 192.168.43.10 (192.168.43.1)
Origin IGP, metric 0, localpref 100, valid, internal
192.168.43.3 from 192.168.43.3 (10.4.1.1)
Origin IGP, metric 30, valid, external
192.168.43.22 from 192.168.43.22 (192.168.43.2)
Origin IGP, metric 20, localpref 100, valid, internal, best
If the bgp deterministic-med command is enabled, then the result of the selection algorithm will always be the same, regardless of the order in which the paths are received by the local router. The following output is always generated when the bgp deterministic-med command is entered on the local router in this scenario:
Router# show ip bgp 10.100.0.0
BGP routing table entry for 10.100.0.0/16, version 15
Paths: (3 available, best #1, advertised over EBGP)
192.168.43.10 from 192.168.43.10 (192.168.43.1)
Origin IGP, metric 0, localpref 100, valid, internal, best 3
192.168.43.22 from 192.168.43.22 (192.168.43.2)
Origin IGP, metric 20, localpref 100, valid, internal 3
192.168.43.3 from 192.168.43.3 (10.4.1.1)
Origin IGP, metric 30, valid, external
Related Commands
Command
|
Description
|
clear ip bgp
|
Resets a BGP connection or session.
|
show ip bgp
|
Displays entries in the BGP routing table.
|
show ip bgp neighbor
|
Displays information about the TCP and BGP connections to neighbors.
|
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 command in address family or router configuration mode. 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.
Defaults
The behavior of this command is enabled by default.
Command Modes
Address family configuration
Router configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
12.0(7)T
|
Address family configuration mode was added.
|
Examples
The following example disables the automatic resetting of BGP sessions in router configuration mode:
no bgp fast-external-fallover
The following example disables the automatic resetting of BGP sessions in address family configuration mode:
address-family ipv4 unicast
no bgp fast-external-fallover
Related Commands
Command
|
Description
|
address-family ipv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard IPv4 address prefixes.
|
bgp log-neighbor-changes
To enable logging of Border Gateway Protocol (BGP) neighbor resets, use the bgp log-neighbor-changes command in address family or router configuration mode. 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.
Defaults
BGP neighbor changes are logged.
Command Modes
Address family configuration
Router configuration
Command History
Release
|
Modification
|
11.1 CC and 12.0
|
This command was introduced.
|
12.0(7)T
|
Address family configuration mode was added.
|
12.01
|
BGP neighbor changes are logged by default.
|
Usage Guidelines
The bgp log-neighbor-changes command enables logging of BGP neighbor status changes (up or down) and resets for troubleshooting network connectivity problems and measuring network stability. Unexpected neighbor resets might indicate high error rates or high packet loss in the network and should be investigated.
Using the bgp log-neighbor-changes command to enable status change message logging does not cause a substantial performance impact, unlike, for example, enabling per BGP update debugging. If the UNIX syslog facility is enabled, messages are sent to the UNIX host running the syslog daemon so that the messages can be stored and archived. If the UNIX syslog facility is not enabled, the status change messages are retained in the router's internal buffer, and are not stored to disk. You can set the size of this buffer, which is dependent upon the available RAM, using the logging buffered command.
The neighbor status change messages are not tracked if the bgp log-neighbor-changes command is not enabled, except for the reset reason, which is always available as output of the show ip bgp neighbor command.
The eigrp log-neighbor-changes command enables logging of Enhanced IGRP neighbor adjacencies, but messages for BGP neighbors are logged only if they are specifically enabled with the bgp log-neighbor-changes command.
Use the show logging command to display the log for the BGP neighbor changes.
Examples
The following example will log neighbor changes for BGP in router configuration mode:
The following example will log neighbor changes for BGP in address family configuration mode:
address-family ipv4 unicast
Related Commands
Command
|
Description
|
address-family ipv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard IPv4 address prefixes.
|
logging buffered
|
Logs messages to an internal buffer.
|
show ip bgp neighbors
|
Displays information about the TCP and BGP connections to neighbors.
|
show logging
|
Displays the state of logging (syslog).
|
bgp redistribute-internal
To allow the redistribution of iBGP routes into an interior gateway protocol such as IS-IS or OSPF, use the bgp redistribute-internal command in router configuration mode. To remove the bgp redistribute-internal command from the configuration file and restore the system to its default condition where the software does not allow the redistribution of iBGP routes into Interior Gateway Protocols (IGPs), use the no form of this command.
bgp redistribute-internal
no bgp redistribute-internal
Syntax Description
This command has no arguments or keywords.
Defaults
By default iBGP routes are not redistributed into IGPs.
Command Modes
Router configuration
Command History
Release
|
Modification
|
12.1
|
This command was introduced.
|
Usage Guidelines
Use of the bgp redistribute-internal command requires the clear ip bgp command to be issued to reset BGP connections.
Caution 
Redistributing iBGP routes into IGPs may cause routing loops to form within an autonomous system. Use this command with caution.
Examples
The following example shows iBGP routes being redistributed into OSPF:
bgp redistribute-internal
Related Commands
Command
|
Description
|
clear ip bgp
|
Resets a BGP connection or session.
|
bgp router-id
To configure a fixed router ID for a BGP-speaking router, use the bgp router-id command in router configuration mode. To remove the bgp router-id command from the configuration file and restore the default value of the router ID, use the no form of this command.
bgp router-id ip-address
no bgp router-id ip-address
Syntax Description
ip-address
|
IP address of the router.
|
Defaults
The router ID is set to the IP address of a loopback interface if one is configured. If no virtual interfaces are configured, the highest IP address is configured for a physical interface on that router. Peering sessions will be reset if the router ID is changed.
Command Modes
Router configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
Use this command to configure a fixed router ID as an identifier of the router running BGP. A loopback interface, if one is configured, is more effective than a fixed interface as an identifier because there is no physical link to go down.
Examples
The following example shows the local router configured with the router ID of 192.168.70.24:
bgp router-id 192.168.70.24
Related Commands
Command
|
Description
|
show ip bgp
|
Displays entries in the BGP routing table.
|
bgp rr-group
To create a route-reflector group and enable automatic inbound filtering for VPN version 4 (VPNv4) updates based on the allowed route target (RT) extended communities, use the bgp rr-group command in address-family configuration mode. To disable a route-reflector group or route reflector, use the no form of this command.
bgp rr-group {extcom-list-number}
no bgp rr-group
Syntax Description
extcom-list-number
|
Number of a specific extended community-list that will be supported by the route-reflector group. The range of extended community-list numbers that can be specified is from 1 to 199. However, only one extended community-list is specified with the extcom-list-number argument.
|
Defaults
This command has no default behavior.
Command Modes
This command is configured in the VPNv4 address-family configuration submode.
Command History
Release
|
Modification
|
12.1
|
This command was introduced.
|
12.0(22)S
|
This command was integrated into Cisco IOS Release 12.0(22)S. The maximum number of extended community-lists that can supported by a route-reflector group was changed from 199 to 500.
|
Usage Guidelines
The bgp rr-group command can be used with the ip extcommunity-list command. The ip extcommunity-list command is used to create an extended community list and specify a list of extended community RTs. Only extended community lists are supported.
Examples
The following example configures a route-reflector group that will accept extended community list number 500:
Related Commands
clear ip bgp
To reset a BGP connection using Border Gateway Protocol (BGP) soft reconfiguration, use the clear ip bgp command in privileged EXEC mode at the system prompt.
clear ip bgp {* | address | peer-group-name} [soft [in | out]]
Syntax Description
*
|
Specifies that all current BGP sessions will be reset.
|
address
|
Specifies that only the identified BGP neighbor will be reset.
|
peer-group-name
|
Specifies that the specified BGP peer group will be reset.
|
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 is triggered.
|
Defaults
No reset is initiated.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
12.0(6)T
|
The dynamic inbound soft reset capability was added.
|
12.0(2)S
|
The dynamic inbound soft reset capability was added.
|
Usage Guidelines
You can reset inbound routing table updates dynamically or by generating new updates using stored update information. Using stored update information required additional memory for storing the updates.
To reset inbound routing table updates dynamically, all BGP routers must support the route refresh capability. To determine whether a BGP router supports this capability, use the show ip bgp neighbors command. If a router supports the route refresh capability, the following message is displayed: Received route refresh capability from peer.
If all BGP routers support the route refresh capability, use the clear ip bgp {*|address|peer-group name} in command. You need not use the soft keyword, because soft reset is automatically assumed when the route refresh capability is supported.
To generate new inbound updates from stored update information (rather than dynamically) without resetting the BGP session, you must preconfigure the local BGP router using the neighbor soft-reconfiguration inbound command. This preconfiguration causes the software to store all received updates without modification regardless of whether an update is accepted by the inbound policy. Storing updates is memory intensive and should be avoided if possible.
Outbound BGP soft configuration does not have any memory overhead and does not require any preconfiguration. You can trigger an outbound reconfiguration on the other side of the BGP session to make the new inbound policy take effect.
Use this command whenever any of the following conditions occur:
•
Additions or changes to the BGP-related access lists
•
Changes to BGP-related weights
•
Changes to BGP-related distribution lists
•
Changes to BGP-related route maps
Examples
The following example clears the inbound session with the neighbor 10.108.1.1 without resetting the session:
clear ip bgp 10.108.1.1 soft in
The following example clears the outbound session with the peer-group corp without resetting the session:
clear ip bgp corp soft out
Related Commands
clear ip bgp dampening
To clear Border Gateway Protocol (BGP) route dampening information and unsuppress the suppressed routes, use the clear ip bgp dampening command in privileged EXEC mode.
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.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
Examples
The following example clears route dampening information about the route to network 192.168.0.0 and unsuppresses its suppressed routes. When the address and mask arguments are not specified, the clear ip bgp dampening command clears route dampening information for the entire BGP routing table.
clear ip bgp dampening 192.168.0.0 255.255.0.0
Related Commands
clear ip bgp external
To clear external Border Gateway Protocol (eBGP) peers, use the clear ip bgp external command in privileged EXEC mode.
clear ip bgp external [in | out]
clear ip bgp external [soft [in | out]]
clear ip bgp external {ipv4 | ipv6 {multicast | unicast [in | out | soft]}}
clear ip bgp external [vpn4 unicast {in | out | soft}}
Syntax Description
in | out
|
(Optional) Triggers inbound or outbound soft reconfiguration.
|
soft
|
(Optional) Triggers soft reconfiguration.
|
ipv4 | ipv6 | vpn4
|
(Optional) Triggers reset of IPv4, IPv6, or VPNn4 address family session.
|
multicast
|
(Optional) Triggers reset of IPv4 or IPv6 multicast address family session.
|
unicast
|
(Optional) Triggers reset of IPv4, IPv6, or VPNv4 unicast family session.
|
Defaults
A reset is not initiated.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.0(2)S
|
This command was introduced.
|
Usage Guidelines
Using the clear ip bgp external command without the soft keyword will reset the session.
Examples
The following example clears an inbound session with the eBGP peers:
Router# clear ip bgp external in
or
clear ip bgp external soft in
The following examples clear an outbound address family IPv4 multicast session with the eBGP peers:
Router# clear ip bgp external ipv4 multicast out
Related Commands
Command
|
Description
|
clear ip bgp
|
Resets a BGP connection or session.
|
neighbor soft-reconfiguration
|
Configures the Cisco IOS software to start storing updates.
|
show ip bgp
|
Displays entries in the BGP routing table.
|
clear ip bgp flap-statistics
To clear Border Gateway Protocol (BGP) flap statistics, use the clear ip bgp flap-statistics command in privileged EXEC mode.
clear ip bgp address flap-statistics [{regexp regexp} | {filter-list list} | {address mask}]
clear ip bgp [address] flap-statistics
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.
|
Defaults
No statistics are cleared.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
Usage Guidelines
If no arguments or keywords are specified, the router will clear BGP flap statistics for all routes.
The flap statistics for a route are also cleared when a BGP peer is reset. Although the reset withdraws the route, there is no penalty applied in this instance even though route flap dampening is enabled.
Examples
The following example clears all of the flap statistics for paths that pass filter list 3:
Router# clear ip bgp flap-statistics filter-list 3
Related Commands
Command
|
Description
|
bgp dampening
|
Enables BGP route dampening or changes various BGP route dampening factors.
|
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 command in privileged EXEC mode.
clear ip bgp peer-group tag
Syntax Description
tag
|
Name of the BGP peer group to clear.
|
Defaults
No BGP peer group members are cleared.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
Examples
The following example clears all members from the BGP peer group named internal:
clear ip bgp peer-group internal
Related Commands
clear ip prefix-list
To reset the hit count of the prefix list entries, use the clear ip prefix-list command in privileged EXEC mode.
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. The slash mark is required.
|
Defaults
Does not clear the hit count.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.0
|
This command was introduced.
|
Usage Guidelines
The hit count is a value indicating the number of matches to a specific prefix list entry.
Examples
The following example clears the hit count from the prefix list entries for the prefix list named first_list that match the network mask 10.0.0.0/8.
clear ip prefix-list first_list 10.0.0.0/8
Related Commands
default-information originate (BGP)
To control the redistribution of a protocol or network into the BGP, use the default-information originate command in address family or router configuration mode. 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.
Defaults
This command is disabled by default.
Command Modes
Address family configuration
Router configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
12.0(7)T
|
Address family configuration mode was added.
|
Usage Guidelines
The default-information originate command should be used if the network operator needs to control the redistribution of default routes. Using the default-information originate command in BGP is similar to using the network command. However, to achieve the same result as configuring the network command with the route 0.0.0.0, the default-information originate command requires an explicit redistribution of the route 0.0.0.0. The network command requires only that route 0.0.0.0 is specified in the Interior Gateway Protocol (IGP) routing table. For this reason, the network command is preferred for redistributing default routes and protocols into BGP.
Examples
The following address family configuration mode example configures BGP to redistribute OSPF into BGP:
address-family ipv4 unicast
default-information originate
The following router configuration mode example configures BGP to redistribute OSPF into BGP:
default-information originate
Related Commands
Command
|
Description
|
address-family ipv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard IPv4 address prefixes.
|
address-family vpnv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard VPNv4 address prefixes.
|
neighbor ebgp-multihop
|
Accepts and attempts BGP connections to external peers residing on networks that are not directly connected.
|
network (BGP and multiprotocol BGP)
|
Specifies the list of networks for the BGP routing process.
|
redistribute (IP)
|
Redistributes routes from one routing domain into another routing domain.
|
default-metric (BGP)
To set a default metric for routes redistributed into Border Gateway Protocol (BGP), use the default-metric command in address family or router configuration mode. To remove the configured value and return BGP to default operation, use the no form of this command.
default-metric number
no default-metric number
Syntax Description
number
|
Default metric value applied to the redistributed route. The range of values for this argument is from 1 to 4294967295.
|
Defaults
The following is default behavior if this command is not configured or if the no form of this command is entered:
•
The metric of redistributed interior gateway protocol (IGP) routes is set to a value that is equal to the interior BGP (iBGP) metric.
•
The metric of redistributed connected and static routes is set to 0.
When this command is enabled, the metric for redistributed connected routes is set to 0.
Command Modes
Address family configuration
Router configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
12.0(7)T
|
Address family configuration mode support was added.
|
Usage Guidelines
The default-metric command is used to set the metric value for routes redistributed into BGP with the redistribute command. A default metric can be configured to solve the problem of redistributing routes with incompatible metrics. Assigning the default metric will allow redistribution to occur.
This value is the Multi Exit Discriminator (MED) that is evaluated by BGP during the best path selection process. The MED is a non-transitive value that is processed only within the local autonomous system and adjacent autonomous systems. The default metric is not set if the received route has a MED value.
Note
When enabled, the default-metric command applies a metric value of 0 to redistributed connected routes. The default-metric command does not override metric values that are applied with the redistribute command.
Examples
In the following example, a metric of 1024 is set for routes redistributed into BGP from OSPF:
Router(config)# router bgp 50000
Router(config-router)# address-family ipv4 unicast
Router(config-router-af)# default-metric 1024
Router(config-router-af)# redistribute ospf 10
Router(config-router-af)# end
Related Commands
Command
|
Description
|
redistribute (IP)
|
Redistributes routes from one routing domain into another routing domain.
|
distance bgp
To allow the use of external, internal, and local administrative distances that could be a better route than other external, internal, or local routes to a node, use the distance bgp command in address family or router configuration mode. 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.
|
Defaults
external-distance: 20
internal-distance: 200
local-distance: 200
Command Modes
Address family configuration
Router configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
12.0(7)T
|
Address family configuration mode was added.
|
Usage Guidelines
An administrative distance is a rating of the trustworthiness of a routing information source, such as an individual router or a group of routers. Numerically, an administrative distance is a positive integer from 1 to 255. In general, the higher the value, the lower the trust rating. An administrative distance of 255 means the routing information source cannot be trusted at all and should be ignored.
Use this command if another protocol is known to be able to provide a better route to a node than was actually learned via external BGP, or if some internal routes should be preferred by BGP.
Note
Changing the administrative distance of BGP internal routes is considered dangerous and is not recommended. One problem that can arise is the accumulation of routing table inconsistencies, which can break routing.
The distance bgp command replaces the distance mbgp command.
Examples
In the following router configuration mode example, internal routes are known to be preferable to those learned through the Interior Gateway Protocol (IGP), so the administrative distance values are set accordingly:
neighbor 192.168.6.6 remote-as 123
neighbor 172.16.1.1 remote-as 47
In the following address family configuration mode example, internal routes are known to be preferable to those learned through IGP, so the administrative distance values are set accordingly:
neighbor 192.168.6.6 remote-as 123
neighbor 172.16.1.1 remote-as 47
address family ipv4 multicast
neighbor 192.168.6.6 activate
neighbor 172.16.1.1 activate
Related Commands
Command
|
Description
|
address-family ipv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard IPv4 address prefixes.
|
distribute-list in (BGP)
To filter routes or networks received in incoming Border Gateway Protocol (BGP) updates, use the distribute-list in command in router configuration mode. To delete the distribute list and remove it from the running configuration file, use the no form of this command.
distribute-list acl-number | prefix list-name in
no distribute-list acl-number | prefix list-name in
Syntax Description
acl-number
|
IP access list number. The access list defines which networks are to be received and which are to be suppressed in routing updates.
|
prefix list-name
|
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 prefixes in the prefix list.
|
Note
Interface type and number arguments may be displayed in the CLI depending on the installed version of Cisco IOS software. However, the interface arguments are not support in any software release.
Defaults
If this command is configured without a predefined access list, the distribute list will default to permitting all traffic.
Command Modes
Router configuration
Note
The distribute-list in command can be entered in address family configuration mode. However, address family configuration is not recommended and not supported.
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
11.2
|
The acl-number arguments was added.
|
12.0
|
The prefix list-name argument was added.
|
Usage Guidelines
The distribute-list in command is used to filter incoming BGP updates. An access list must be defined prior to configuration of this command. In addition to access lists, prefix list can be used to filter based upon the prefix length, making it possible to filter either on the prefix list, the gateway, or both for incoming updates. The session must be reset with the clear ip bgp command before the distribute list will take effect. To suppress networks from being advertised in updates, use the distribute-list out command.
Note
We recommend that you use IP prefix lists (configured with the ip prefix-list command in global configuration mode) instead of distribute lists. IP prefix lists provide improved performance and are simpler to configure. Distribute list configuration will be removed from the CLI at a future date.
Note
Prefix lists and access lists are mutually exclusive when configuring a distribute list. We recommend that you do not use both the prefix-list and access-list-name arguments with the distribute-list in command.
Examples
In the following example, a prefix list and distribute list are defined to configure the BGP routing process to accept traffic from only network 192.168.1.0 and network 10.108.0.0. An inbound route refresh is initiated to activate the distribute-list.
Router(config)# ip prefix-list RED deny 0.0.0.0/0 le 32
Router(config)# ip prefix-1ist RED permit 10.108.0.0/16
Router(config)# ip prefix-list RED permit 192.168.1.0/24
Router(config)# router bgp 50000
Router(config-router)# network 10.108.0.0
Router(config-router)# distribute-list prefix RED in
Router(config-router)# end
In the following example, an access list and a distribute list are defined to configure the BGP routing process to accept traffic from only network 192.168.1.0 and network 10.108.0.0. An inbound route refresh is initiated to activate the distribute-list.
Router(config)# access-list 1 permit 192.168.1.0
Router(config)# access-list 1 permit 10.108.0.0
Router(config)# access-list 1 deny 0.0.0.0 255.255.255.255
Router(config)# router bgp 50000
Router(config-router)# network 10.108.0.0
Router(config-router)# distribute-list 1 in
Router(config-router)# end
Related Commands
Command
|
Description
|
access-list
|
Defines an IP access list.
|
clear ip bgp
|
Resets a BGP connection or session.
|
distribute-list out (BGP)
|
Suppresses networks from being advertised in outbound BGP updates.
|
ip prefix-list
|
Creates an entry in a prefix list.
|
redistribute (IP)
|
Redistributes routes from one routing domain into another routing domain.
|
distribute-list out (BGP)
To suppress networks from being advertised in outbound Border Gateway Protocol (BGP) updates, use the distribute-list out command in router configuration mode. To delete the distribute list and remove it from the running configuration file, use the no form of this command.
distribute-list acl-number | prefix list-name out [protocol process-number | connected | static]
no distribute-list acl-number | prefix list-name out [protocol process-number | connected | static]
Syntax Description
acl-number
|
IP access list number. The access list defines which networks are to be received and which are to be suppressed in routing updates.
|
prefix list-name
|
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 prefixes in the prefix list.
|
protocol process-number
|
Specifies the routing protocol to apply the distribution list. BGP, EIGRP, OSPF, and RIP are supported. The process number is entered for all routing protocols, except RIP. The process number is a value from 1 to 65535.
|
connected
|
Specifies peers and networks learned through connected routes.
|
static
|
Specifies peers and networks learned through static routes.
|
Note
Interface type and number arguments may be displayed in the CLI depending on the installed version of Cisco IOS software. However, the interface arguments are not support in any software release.
Defaults
If this command is configured without a predefined access list, the distribute list will default to permitting all traffic.
Command Modes
Router configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
11.2
|
The acl-number argument was added.
|
12.0
|
The prefix list-name argument was added.
|
Usage Guidelines
The distribute-list out command is used to filter outbound BGP updates. An access list must be defined prior to configuration of this command. In addition to access lists, prefix list can be used to filter based upon the prefix length, making it possible to filter either on the prefix list, the gateway, or both for incoming updates. The session must be reset with the clear ip bgp command before the distribute list will take effect. To filter routes that are received in inbound updates, use the distribute-list in command.
Entering a protocol and/or process-number arguments causes the distribute list to be applied to only routes derived from the specified routing process. Addresses not specified in the distribute-list command will not be advertised in outgoing routing updates after a distribute list is configured.
Note
We recommend that you use IP prefix lists (configured with the ip prefix-list command in global configuration mode) instead of distribute lists. IP prefix lists provide improved performance and are simpler to configure. Distribute list configuration will be removed from the CLI at a future date.
Note
Prefix lists and access lists are mutually exclusive when configuring distribute lists. We recommend that you do not use both the prefix-list and access-list-name arguments with the distribute-list out command.
Examples
In the following example, an access list and a distribute list are defined to configure the BGP routing process to advertise only network 192.168.0.0. An outbound route refresh is initiated to activate the distribute-list.
Router(config)# access-list 1 permit 192.168.0.0 0.0.255.255
Router(config)# access-list 1 deny 0.0.0.0 255.255.255.255
Router(config)# router bgp 50000
Router(config-router)# distribute-list 1 out
Router(config-router)# end
Related Commands
Command
|
Description
|
access-list
|
Defines an IP access list.
|
clear ip bgp
|
Resets a BGP connection or session.
|
distribute-list in (BGP)
|
Filters routes and networks received in updates.
|
ip prefix-list
|
Creates an entry in a prefix list.
|
redistribute (IP)
|
Redistributes routes from one routing domain into another routing domain.
|
export map
To configure an export route map for a VRF, use the export map command in VRF configuration mode.
export map route-map
Syntax Description
route-map
|
Specifies the route map to be used as an export route map for the VRF.
|
Defaults
This command has no default behavior.
Command Modes
VRF configuration mode
Command History
Release
|
Modification
|
12.0(5)T
|
This command was introduced.
|
Usage Guidelines
Use an export route map when an application requires finer control over the routes that are exported out of a VRF than the control that is provided by import and export extended communities configured for the importing and exporting VRFs.
The export map command associates a route map with the specified VRF. You can use a route map to filter routes that are eligible for export out of a VRF, based on the route target extended community attributes of the route.
Only one export route map per VRF is supported.
Examples
The following example shows how to configure an export route map for a VRF:
Router(config)# ip vrf vrf_red
Router(config-vrf)# export map blue_export_map
Related Commands
Command
|
Description
|
import map
|
Configures an import route map for a VRF.
|
ip extcommunity-list
|
Creates an extended community list for BGP and controls access to it.
|
ip vrf
|
Configures a VRF routing table.
|
route-target
|
Creates a route-target extended community for a VRF.
|
show ip vrf
|
Displays the set of defined VRFs and associated interfaces.
|
ip as-path access-list
To define a Border Gateway Protocol (BGP) autonomous system (AS) path access list, use the ip as-path access-list command in global configuration mode. 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. Refer to the "Regular Expressions" appendix in the Release 12.1 Cisco IOS Dial Services Command Reference for information about forming regular expressions.
|
Defaults
No access lists are defined.
Command Modes
Global configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
You can specify an access list filter on both inbound and outbound BGP routes. Each filter is an access list based on regular expressions. If the regular expression matches the representation of the autonomous system path of the route as an ASCII string, then the permit or deny condition applies. The autonomous system path does not contain the local autonomous system number. Use the ip as-path access-list global configuration command to define an BGP access list, and the neighbor router configuration command to apply a specific access list.
Examples
The following example specifies that the BGP neighbor with IP address 172.16.1.1 is not sent advertisements about any path through or from the adjacent autonomous system 123:
ip as-path access-list 1 deny _123_
ip as-path access-list 1 deny ^123$
neighbor 192.168.6.6 remote-as 123
neighbor 172.16.1.1 remote-as 47
neighbor 172.16.1.1 filter-list 1 out
Related Commands
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 command in global configuration mode. 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.
Defaults
BGP communities are displayed in the Cisco default format, one 32-bit number.
Command Modes'
Global configuration
Command History
Release
|
Modification
|
12.0
|
This command was introduced.
|
Usage Guidelines
RFC 1997, BGP Communities Attribute specifies that a BGP community is made up of two parts that are 2 bytes long. The first part is the autonomous system number and the second part is a 2-byte number. In the most recent version of the RFC, a community is of the form AA:NN. The Cisco default community format is one 32-bit number. The ip bgp-community new-format command changes the community format to AA:NN to conform to RFC 1997.
Examples
The following example upgrades a router that uses the 32-bit number community format to the AA:NN format:
Router(config)# ip bgp-community new-format
The following example shows how BGP community numbers are displayed when the ip bgp-community new-format command is enabled:
Router# show ip bgp 10.0.0.0
BGP routing table entry for 10.0.0.0/8, version 4
Paths: (2 available, best #2, table Default-IP-Routing-Table)
Advertised to non peer-group peers:
10.0.33.35 from 10.0.33.35 (192.168.3.3)
Origin incomplete, metric 10, localpref 100, valid, external
0.0.0.0 from 0.0.0.0 (10.0.33.34)
Origin incomplete, metric 0, localpref 100, weight 32768, valid, sourced, best
Related Commands
Command
|
Description
|
show ip bgp
|
Displays entries in the BGP routing table.
|
ip bgp fast-external-fallover
To enable per-interface fast external fallover, enter the ip bgp fast-external-fallover command in interface configuration mode. To revert back to the current behavior, use the no format of this command.
ip bgp fast-external-fallover [permit | deny]
no ip bgp fast-external-fallover [permit | deny]
Syntax Description
permit
|
Allows per-interface fast external fallover.
|
deny
|
Prevents per-interface fast external fallover.
|
Defaults
Global fast external fallover.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.0ST
|
This command was introduced.
|
12.1
|
This command was integrated into Cisco IOS Release 12.1.
|
Usage Guidelines
When you specify the ip bgp fast-external-fallover command with the permit or deny keyword, it overrides the global setting. If you enter the no format of the command, the global setting is in effect for this interface.
Examples
The following example enables per-interface fast-external-fallover on interface Ethernet 0/0:
Router(config)# interface ethernet 0/0
Router(config-if)# ip bgp fast-external-fallover permit
ip community-list
To create or configure a Border Gateway Protocol (BGP) community list and to control access to it, use the ip community-list command in global configuration command. To delete the community list, use the no form of this command.
ip community-list {standard | standard list-name {deny | permit} [community-number] [AA:NN]
[internet] [local-AS] [no-advertise] [no-export]} | {expanded | expanded list-name {deny |
permit} regexp}
no ip community-list standard | expanded | {expanded | standard} list-name
Syntax Description
standard
|
Configures a standard community list using a number from 1 to 99 to identify one or more permit or deny groups of communities.
|
standard list-name
|
Configures a named standard community list.
|
permit
|
Permits access for a matching condition.
|
deny
|
Denies access for a matching condition.
|
community-number
|
(Optional) Specifies a community as a 32-bit number from 1 to 4294967200. A single community can be entered or multiple communities can be entered, each separated by a space.
|
AA:NN
|
(Optional) Autonomous system number and network number entered in the 4-byte new community format. This value is configured with with two 2-byte numbers separated by a colon. A number from 1 to 65535 can be entered each 2-byte number. A single community can be entered or multiple communities can be entered, each separated by a space.
|
internet
|
(Optional) Specifies the Internet community. Routes with this community are advertised to all peers (internal and external).
|
no-export
|
(Optional) Specifies the no-export community. Routes with this community are advertised to only peers in the same autonomous system or to only other subautonomous systems within a confederation. These routes are not advertised to external peers.
|
local-as
|
(Optional) Specifies the local-as community. Routes with community are advertised to only peers that are part of the local autonomous system or to only peers within a subautonomous system of a confederation. These routes are not advertised external peers or to other subautonomous systems within a confederation.
|
no-advertise
|
(Optional) Specifies the no-advertise community. Routes with this community are not advertised to any peer (internal or external).
|
expanded
|
Configures an expanded community list number from 100 to 500 to identify one or more permit or deny groups of communities.
|
expanded list-name
|
Configures a named expanded community list.
|
regexp
|
Configures a regular expression that is used to specify a pattern to match against an input string.
Note Regular expressions can be used only with expanded community lists
|
Defaults
BGP community exchange is not enabled by default. It is enabled on a per-neighbor basis with the neighbor send-community command.
The Internet community is applied to all routes or prefixes by default, until any other community value is configured with this command or the set community command.
Once a permit value has been configured to match a given set of communities, the community list defaults to an implicit deny for all other community values.
Community values entered in the new format (AA:NN) are converted to 32-bit numbers if the ip bgp-community new-format command is not enabled on the local router.
Defaults
Global configuration
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
12.0
|
Support for the local-as community was introduced.
|
12.0(10)S
|
Named community list support was added.
|
12.0(16)ST
|
Named community list support was introduced.
|
12.1(9)E
|
Named community list support was integrated into Cisco IOS Release 12.1(9)E.
|
12.2(8)T
|
Named community list support was integrated into Cisco IOS Release 12.2(8)T.
|
12.0(22)S
|
The maximum number of expanded community list numbers was increased from 199 to 500.
|
12.2(15)T
|
The maximum number of expanded community list numbers was increased from 199 to 500.
|
Usage Guidelines
The ip community-list command is used to configure BGP community filtering. BGP community values are configured as a 32-bit number (old format) or as a 4-byte number (new format). The new community format is enabled when the ip bgp-community new-format command is entered in global configuration mode. The new community format consists of a 4-byte value. The first two bytes represent the autonomous system number, and the trailing two bytes represent a user-defined network number. Named and numbered community lists are supported. BGP community attribute exchange between BGP peers is enabled when the neighbor send-community command is configured for the specified neighbor. The BGP community attribute is defined in RFC-1997 and RFC-1998.
Standard Community Lists
Standard community lists are used to configure well-known communities and specific community numbers. A maximum of 16 communities can be configured in a standard community list. If you attempt to configure more than 16 communities, the trailing communities that exceed the limit are not processed or saved to the running configuration file.
Expanded Community Lists
Expanded community lists are used to filter communities using a regular expression. Regular expressions are used to configure patterns to match community attributes. The order for matching using the * or + character is longest construct first. Nested constructs are matched from the outside in. Concatenated constructs are matched beginning at the left side. If a regular expression can match two different parts of an input string, it will match the earliest part first. For more information about configuring regular expressions, see the Regular Expressions appendix of the Cisco IOS Terminal Services Configuration Guide.
Community List Processing
When multiple values are configured in the same community list statement, a logical AND condition is created. All community values must match to satisfy an AND condition. When multiple values are configured in separate community list statements, a logical OR condition is created. The first list that matches a condition is processed.
Examples
In the following example, a standard community list is configured that permits routes that from network 10 in autonomous system 50000:
Router(config)# ip community-list 1 permit 50000:10
In the following example, a standard community list is configured that permits only routes from peers in the same autonomous system or from subautonomous system peers in the same confederation:
Router(config)# ip community-list 1 permit no-export
In the following example, a standard community list is configured to deny routes that carry communities from network 40 in autonomous system 65534 and from network 60 in autonomous system 65412. This example shows a logical AND condition; all community values must match in order for the list to be processed.
Router(config)# ip community-list 2 deny 65534:40 65412:60
In the following example, a named standard community list is configured that permits all routes within the local autonomous system or permits routes from network 20 in autonomous system 40000. This example shows a logical OR condition; the first match is processed.
Router(config)# ip community-list standard RED permit local-AS
Router(config)# ip community-list standard RED permit 40000:20
In the following example, an expanded community list is configured that will deny routes that carry communities from any private autonomous system:
Router(config)# ip community-list 500 deny _64[6-9][0-9][0-9]_|_65[0-9][0-9][0-9]_
In the following example, a named expanded community list configured that denies routes from network 1 through 99 in autonomous system 50000:
Router(config)# ip community-list expanded BLUE deny 50000:[0-9][0-9]_
Related Commands
Command
|
Description
|
match community
|
Matches a BGP community.
|
route-map (IP)
|
Defines the conditions for redistributing routes from one routing protocol into another, or enables policy routing.
|
set community
|
Sets the BGP communities attribute.
|
set comm-list delete
|
Removes communities from the community attribute of an inbound or outbound update.
|
show ip bgp community
|
Displays routes that belong to specified BGP communities.
|
show ip bgp regexp
|
Displays routes that match a locally configured regular expression.
|
ip extcommunity-list
To create an extended community access list and control access to it, use the ip extcommunity-list command in global configuration mode. To delete the community list, use the no form of this command.
ip extcommunity-list standard-list-number expanded-list-number {permit | deny}
[regular-expression] [rt | soo extended-community-value]
no ip extcommunity-list
Syntax Description
standard-list-number
|
Integer from 1 to 99 that identifies one or more permit or deny groups of extended communities.
|
expanded-list-number
|
Integer from 100 to 500 that identifies one or more permit or deny groups of extended communities. Regular expressions can be configured with expanded lists but not standard lists.
|
permit
|
Permits access for a matching condition.
|
deny
|
Denies access for a matching condition.
|
regular-expression
|
(Optional) An input string pattern to match against.
|
rt
|
(Optional) Specifies the route target (RT) extended community attribute. The rt keyword can be configured only with standard extended community lists and not expanded community lists.
|
soo
|
(Optional) Specifies the site of origin (SOO) extended community attribute. The soo keyword can be configured only with standard extended community lists and not expanded community lists.
|
extended-community-value
|
Specifies the route target or site of origin. The value can be one of the following combinations:
• autonomous-system-number:network-number
• ip-address:network-number
The colon is used to separate the autonomous system number and network number or IP address and network number.
|
Defaults
Once you permit a value for the community number, the community list defaults to an implicit deny for everything else that has not been permitted.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.1
|
This command was introduced.
|
Usage Guidelines
Extended community attributes are used to configure, filter, and identify routes for virtual routing and forwarding instances (VRFs) and Multiprotocol Label Switching (MPLS) Virtual Private Networks (VPNs).
The ip extcommunity-list command is used to configure extended community lists. All of the standard rules of access lists apply to the configuration of extended community lists. Regular expressions are supported by the expanded range of extended community list numbers. All regular expression configuration options are supported.
The route target (RT) extended community attribute is configured with the rt keyword. This attribute is used to identify a set of sites and VRFs that may receive routes that are tagged with the configured route target. Configuring the route target extended attribute with a route allows that route to be placed in the per-site forwarding tables that are used for routing traffic that is received from corresponding sites.
The site of origin (SOO) extended community attribute is configured with the soo keyword. This attribute uniquely identifies the site from which the provider edge (PE) router learned the route. All routes learned from a particular site must be assigned the same site of origin extended community attribute, regardless if a site is connected to a single PE router or multiple PE routers. Configuring this attribute prevents routing loops from occurring when a site is multihomed. The SOO extended community attribute is configured on the interface and is propagated into BGP through redistribution. The SOO can be applied to routes that are learned from VRFs. The SOO should not be configured for stub sites or sites that are not multihomed.
Examples
The following example configures an extended community list that will permit routes from route target 901:10 and site of origin 802:20 and deny routes from route target 703:30 and site of origin 604:40:
Router(config)# ip extcommunity-list 1 permit rt 901:10
Router(config)# ip extcommunity-list 1 permit soo 802:20
Router(config)# ip extcommunity-list 1 deny rt 703:30 soo 604:40
The following example configures an extended community list (in the expanded range) that specifies that the BGP neighbor with IP address 192.168.1.1 is not sent advertisements about any path through or from autonomous system 123:
Router(config)# ip extcommunity-list 500 deny _123_
Router(config)# ip extcommunity-list 500 deny ^123 .*
Router(config)# router bgp 101
Router(config-router)# network 172.16.0.0
Router(config-router)# neighbor 10.140.6.6 remote-as 123
Router(config-router)# neighbor 192.168.1.1 remote-as 47
Router(config-router)# neighbor 10.125.1.1 filter-list 1 out
The following example configures an extended community list (in the expanded range) that permits routes from autonomous system 123 and denies all other routes:
Router(config)# ip extcommunity-list 500 permit (1-3)*
Router(config)# ip extcommunity-list 500 deny (^0-9)*
The following example configures an expanded extended community list that permits advertisements that contain a route target extended community attribute beginning with the pattern 100:.
Router(config)# ip extcommunity-list 101 permit RT:100:+
Note
For information about regular expressions and how to use them, see Regular Expressions.
Related Commands
ip prefix-list
To create an entry in a prefix list, use the ip prefix-list command in global configuration mode. To delete the entry, use the no form of this command.
ip prefix-list list-name | list-number [seq seq-value] {deny network/length | permit
network/length}[ge ge-value] [le le-value]
no ip prefix-list list-name | list-number [seq seq-value] {deny network/length | permit
network/length}[ge ge-value] [le le-value]
Syntax Description
list-name
|
Configures a name to identify the prefix list.
|
list-number
|
Configures a number to identify the 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 for a matching condition.
|
permit
|
Permits access for a matching condition.
|
network/length
|
(Mandatory) The network number and length (in bits) of the network mask. The slash mark is required.
|
ge
|
(Optional) Applies the ge-value to the range specified. The ge-value represents the minimum prefix length to be matched.
|
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. The le-value represents the minimum prefix length to be matched.
|
le-value
|
(Optional) Specifies the greater value of a range (the "to" portion of the range description).
|
Defaults
No prefix lists are created.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.0(3)T
|
This command was introduced.
|
Usage Guidelines
When multiple entries of a prefix list match a given prefix, the longest, most specific match is chosen.
The router begins the search at the top of the prefix list, with the sequence number 1. Once a match or deny occurs, the router does not need to go through the rest of the prefix list. For efficiency, you may want to put the most common matches or denies near the top of the list, using the argument seq-value in the ip prefix-list command. The show commands always include the sequence numbers in their output.
By default, the sequence numbers are automatically generated.They can be suppressed with the command no ip prefix-list seq-value. Sequence values are generated in increments of 5. The first sequence value generated in a prefix list would be 5, then 10, then 15, and so on. If you specify a value for an entry and then do not specify values for subsequent entries, the assigned (generated) sequence values are incremented in units of five. For example, if you specify that the first entry in the prefix list have a sequence value of 3, and then do not specify sequence values for the other entries, the automatically generated numbers will be 8, 13, 18, and so on.
The ge and le can be used to specify the range of the prefix length to be matched for prefixes that are more specific than network/length. Exact match is assumed when neither ge nor le is specified. The range is assumed to be from ge-value to 32 if only the ge attribute is specified. And the range is assumed to be from le to le-value if only the le attribute is specified.
A specified ge-value or le-value must satisfy the following condition:
len < ge-value < le-value <= 32
Notes:
•
If you use the ip prefix-list command with the default-information originate command to generate default routes, specify only IP adress matching. Avoid using the ge and le keywords.
For example, the following command works:
ip prefix-list anyrtcondition seq 5 permit 0.0.0.0/0
However, the following command is not supported:
ip prefix-list anyrtcondition seq 5 permit 0.0.0.0/0 le 32
•
Using the ip prefix-list command with the route-map and match ip next-hop commands is not supported. Only IP address match clauses are supported.
Examples
The following examples show how a prefix list can be used.
To deny the default route 0.0.0.0/0:
ip prefix-list abc deny 0.0.0.0/0
To permit the prefix 10.0.0.0/8:
ip prefix-list abc permit 10.0.0.0/8
The following examples show how to specify a group of prefixes.
To accept a mask length of up to 24 bits in routes with the prefix 192/8:
ip prefix-list abc permit 192.0.0.0/8 le 24
To deny mask lengths greater than 25 bits in routes with a prefix of 192/8:
ip prefix-list abc deny 192.0.0.0/8 ge 25
To permit mask lengths from 8 to 24 bits in all address space:
ip prefix-list abc permit 0.0.0.0/0 ge 8 le 24
To deny mask lengths greater than 25 bits in all address space:
ip prefix-list abc deny 0.0.0.0/0 ge 25
To deny all mask lengths within the network 10/8:
ip prefix-list abc deny 10.0.0.0/8 le 32
To deny all masks with a length greater than or equal to 25 bits within the network 192.168.1/24:
ip prefix-list abc deny 192.168.1.0/24 ge 25
To permit all routes:
ip prefix-list abc permit 0.0.0.0/0 le 32
Related Commands
Command
|
Description
|
clear ip prefix-list
|
Resets the hit count of the prefix list entries.
|
ip prefix-list description
|
Adds a text description of a prefix list.
|
ip prefix-list sequence-number
|
Enables the generation of sequence numbers for entries in a prefix list.
|
match ip address
|
Distributes any routes that have a destination network number address that is permitted by a standard or extended access list, and performs policy routing on packets.
|
match route-type (IP)
|
Redistributes routes of the specified type.
|
neighbor prefix-list
|
Distributes BGP neighbor information as specified in a prefix list.
|
show ip prefix-list
|
Displays information about a prefix list or prefix list entries.
|
ip prefix-list description
To add a text description of a prefix list, use the ip prefix-list description command in global configuration mode. To remove the text description, use the no form of this command.
ip prefix-list list-name sequence-number description text
no ip prefix-list list-name sequence-number description text
Syntax Description
list name
|
Prefix list name.
|
sequence-number
|
Sequence number of the prefix list.
|
text
|
Text description of te prefix list.
|
Defaults
There is no text description.
Command Modes
Global configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
11.2
|
The access-list-name, type, and number arguments were added.
|
12.0
|
The prefix-list argument was added.
|
Usage Guidelines
This command is not supported in Intermediate System-to-Intermediate System (IS-IS) or Open Shortest Path First (OSPF).
To suppress networks from being advertised in updates, use the distribute-list out command.
Examples
The following example shows a prefix list description that indicates what routes are permitted by the prefix list:
ip prefix-list customerA description Permit routes from customer A
Related Commands
Command
|
Description
|
clear ip prefix-list
|
Resets the hit count of the prefix list entries.
|
distribute-list out (BGP)
|
Suppresses networks from being advertised in updates.
|
ip prefix-list
|
Creates an entry in a prefix list.
|
ip prefix-list sequence-number
|
Enables the generation of sequence numbers for entries in a prefix list.
|
match ip address
|
Distributes any routes that have a destination network number address that is permitted by a standard or extended access list, and performs policy routing on packets.
|
neighbor prefix-list
|
Distributes BGP neighbor information as specified in a prefix list.
|
show ip prefix-list
|
Displays information about a prefix list or prefix list entries.
|
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 command in global configuration mode. 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.
Defaults
There is no text description.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.0
|
This command was introduced.
|
Examples
The following example disables the default automatic generation of sequence numbers for prefix list entries:
no ip prefix-list sequence-number
Related Commands
Command
|
Description
|
clear ip prefix-list
|
Resets the hit count of the prefix list entries.
|
distribute-list in
|
Filters networks received in updates.
|
distribute-list out (BGP)
|
Suppresses networks from being advertised in updates.
|
ip prefix-list
|
Creates an entry in a prefix list.
|
ip prefix-list sequence-number
|
Enables the generation of sequence numbers for entries in a prefix list.
|
match ip address
|
Distributes any routes that have a destination network number address that is permitted by a standard or extended access list, and performs policy routing on packets.
|
neighbor prefix-list
|
Distributes BGP neighbor information as specified in a prefix list.
|
show ip prefix-list
|
Displays information about a prefix list or prefix list entries.
|
match as-path
To match a Border Gateway Protocol (BGP) autonomous system path access list, use the match as-path command in route-map configuration mode. 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.
|
Defaults
No path lists are defined.
Command Modes
Route-map configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
The values set by the match as-path and set weight commands override global values. For example, the weights assigned with the match as-path and set weight route-map configuration commands override the weight assigned using the neighbor weight command.
A route map can have several parts. Any route that does not match at least one match clause relating to a route-map command will be ignored; that is, the route will not be advertised for outbound route maps and will not be accepted for inbound route maps. If you want to modify only some data, you must configure a second route-map section with an explicit match specified.
Examples
The following example sets the autonomous system path to match BGP autonomous system path access list 20:
Related Commands
Command
|
Description
|
match community
|
Matches a BGP community.
|
match interface (IP)
|
Distributes routes that have their next hop out one of the interfaces specified.
|
match ip address
|
Distributes any routes that have a destination network number address that is permitted by a standard or extended access list, and performs policy routing on packets.
|
match ip next-hop
|
Redistributes any routes that have a next-hop router address passed by one of the access lists specified.
|
match ip route-source
|
Redistributes routes that have been advertised by routers and access servers at the address specified by the access lists.
|
match metric
|
Redistributes routes with the metric specified.
|
match route-type (IP)
|
Redistributes routes of the specified type.
|
match tag
|
Redistributes routes in the routing table that match the specified tags.
|
route-map (IP)
|
Defines the conditions for redistributing routes from one routing protocol into another, or enables policy routing.
|
set as-path
|
Modifies an autonomous system path for BGP routes.
|
set automatic-tag
|
Automatically computes the tag value in a route map configuration.
|
set community
|
Sets the BGP communities attribute.
|
set level (IP)
|
Indicates where to import routes.
|
set local-preference
|
Specifies a preference value for the autonomous system path.
|
set metric
|
Sets the metric value for a routing protocol.
|
set metric-type
|
Sets the metric type for the destination routing protocol.
|
set next-hop
|
Specifies the address of the next hop.
|
set origin (BGP)
|
Sets the BGP origin code.
|
set tag (IP)
|
Sets the value of the destination routing protocol.
|
set weight
|
Specifies the BGP weight for the routing table.
|
match community
To match a Border Gateway Protocol (BGP) community, use the match community command in route-map configuration mode. To remove the match community command from the configuration file and restore the system to its default condition where the software removes the BGP community list entry, use the no form of this command.
match community {standard-list-number | expanded-list-number | community-list-name
[exact-match]}
no match community {standard-list-number | expanded-list-number | community-list-name
[exact-match]}
Syntax Description
standard-list-number
|
Specifies a standard community list number from 1 to 99 that identifies one or more permit or deny groups of communities.
|
expanded-list-number
|
Specifies an expanded community list number from 100 to 199 that identifies one or more permit or deny groups of communities.
|
community-list-name
|
The community list name.
|
exact-match
|
(Optional) Indicates that an exact match is required. All of the communities and only those communities specified must be present.
|
Defaults
No community list is matched by the route map.
Command Modes
Route-map configuration
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
Usage Guidelines
A route map can have several parts. Any route that does not match at least one match command relating to a route-map (IP) command will be ignored; that is, the route will not be advertised for outbound route maps and will not be accepted for inbound route maps. If you want to modify only some data, you must configure a second route-map section with an explicit match specified.
Matching based on community list number or name is one of the types of match commands applicable to BGP.
Examples
The following example shows that the routes matching community list 1 will have the weight set to 100. Any route that has community 109 will have the weight set to 100.
Router(config)# ip community-list 1 permit 109
Router(config)# route-map set_weight
Router(config-route-map)# match community 1
Router(config-route-map)# set weight 100
The following example shows that the routes matching community list 1 will have the weight set to 200. Any route that has community 109 alone will have the weight set to 200.
Router(config)# ip community-list 1 permit 109
Router(config)# route-map set_weight
Router(config-route-map)# match community 1 exact
Router(config-route-map)# set weight 200
In the following example, the routes that match community list LIST_NAME will have the weight set to 100. Any route that has community 101 alone will have the weight set to 100.
Router(config)# ip community-list 1 permit 101
Router(config)# route-map set_weight
Router(config-route-map)# match community LIST_NAME
Router(config-route-map)# set weight 100
Related Commands
Command
|
Description
|
ip community-list
|
Creates a community list for BGP and controls access to it.
|
route-map (IP)
|
Defines the conditions for redistributing routes from one routing protocol into another.
|
set weight
|
Specifies the BGP weight for the routing table.
|
match extcommunity
To match Border Gateway Protocol (BGP) extended community list attributes, use the match extcommunity command in route-map configuration mode. To remove the match extcommunity command from the configuration file and remove the BGP extended community list attribute entry, use the no form of this command.
match extcommunity standard-list-number | expanded-list-number
no match extcommunity standard-list-number | extended-list-number
Syntax Description
standard-list-number
|
A standard extended community list number from 1 to 99 that identifies one or more permit or deny groups of extended community attributes.
|
expanded-list-number
|
An expanded extended community list number from 100 to 500 that identifies one or more permit or deny groups of extended community attributes.
|
Defaults
This command is disabled by default.
Command Modes
Route-map configuration
Command History
Release
|
Modification
|
12.1
|
This command was introduced.
|
Usage Guidelines
Extended community attributes are used to configure, filter, and identify routes for virtual routing and forwarding instances (VRFs) and Multiprotocol Label Switching (MPLS) Virtual Private Networks (VPNs).
The match extcommunity command is used to configure match clauses that use extended community attributes in route maps. The range of numbers that can be configured with the match extcommunity command is from 1 to 99. All of the standard rules of match and set clauses apply to the configuration of extended community attributes.
Examples
The following example shows that the routes that match extended community list 1 will have the weight set to 100. Any route that has extended community 1 will have the weight set to 100.
Router(config)# ip extcommunity-list 1 rt 100:2
Router(config)# route-map MAP_NAME permit 10
Router(config-route-map)# match extcommunity 1
Router(config-route-map)# set weight 100
Related Commands
Command
|
Description
|
ip extcommunity-list
|
Creates an extended community list for BGP and controls access to it.
|
route-map (IP)
|
Defines the conditions for redistributing routes from one routing protocol into another.
|
set extcommunity
|
Sets BGP extended community attributes.
|
set weight
|
Specifies the BGP weight for the routing table.
|
show ip extcommunity-list
|
Displays routes that are permitted by the extended community list.
|
show route-map
|
Displays configured route maps.
|
maximum-paths
To configure the maximum number of parallel routes that an IP routing protocol will install into the routing table, use the maximum-paths command in router configuration or address family configuration mode. To restore the default value, use the no form of this command.
maximum-paths number [import number ]| import number
no maximum-paths number | import number
Syntax Description
number
|
Specifies the number of routes to install to the routing table. See the usage guidelines for the number of paths that can be configured with this argument.
|
import number
|
(Optional) Specifies the number of redundant paths that can be configured as back up multipaths for a VRF. This keyword can only be configured under a VRF in address family configuration mode.
Note We recommend that this feature is enabled only where needed and that the number of import paths be kept to the minimum (Typically, not more than two paths). For more information, see the related note in the usage guidelines of this command reference page.
|
Defaults
Border Gateway Protocol (BGP) by default will install only one best path in the routing table. The default for all other IP routing protocols is four paths.
Command Modes
Router configuration
Address family configuration
Command History
Release
|
Modification
|
11.2
|
This command was introduced.
|
12.0(25)S
|
The import keyword was introduced.
|
12.2(13)T
|
The import keyword was integrated into Cisco IOS Release 12.2(13)T.
|
12.2(14)S
|
The import keyword was integrated into Cisco IOS Release 12.2(14)S.
|
Usage Guidelines
The maximum-paths command is used to set the number of parallel (equal-cost) routes that BGP will install in the routing table to configure multipath loadsharing. The number of paths that can be configured is determined by the version of Cisco IOS software. The following list shows current limits:
•
Cisco IOS Release 12.0S based software: 8 paths
•
Cisco IOS Release 12.3T based software: 16 paths
•
Cisco IOS Release 12.2S based software: 32 paths
The maximum-paths command cannot be configured with the maximum-paths eibgp command for the same BGP routing process.
Configuring VRF Import Paths
A VRF will import only one path (best path) per prefix from the source VRF table, unless the prefix is exported with a different route-target. If the best path goes down, the destination will not be reachable until the next import event occurs, and then a new best path will be imported into the VRF table. The import event runs every 15 seconds by default.
The import keyword allows you to configure the VRF table to accept multiple redundant paths in addition to the best path. An import path is a redundant path, and it can have a next hop that matches an installed multipath.This feature should be used when there are multiple paths with identical next hops available to ensure optimal convergence times. A typical application of this feature is to configure redundant paths in a network that has multiple route reflectors for redundancy.
Note
Configuring redundant paths with the import keyword can increase CPU and memory utilization significantly, especially in a network where there are many prefixes to learn and a large number of configured VRFs. It is recommended that this feature is only configured as necessary and that the minimum number of redundant paths are configured (Typically, not more than two).
Examples
In the following example, the router is configured to install 2 parallel routes in the BGP routing table:
Router(config)# router bgp 40000
Router(config-router)# maximum-paths 2
In the following example, the router is configured to install 6 equal-cost routes and 2 import routes (backup) in the VRF routing table:
Router(config)# router bgp 40000
Router(config-router)# address-family ipv4 vrf RED
Router(config-router-af)# maximum-paths 6 import 2
In the following example, the router is configured to install 2 import routes in the VRF routing table:
Router(config)# router bgp 100
Router(config-router)# address-family ipv4 vrf BLUE
Router(config-router-af)# maximum-paths import 2
neighbor advertisement-interval
To set the minimum interval between the sending of Border Gateway Protocol (BGP) routing updates, use the neighbor advertisement-interval command in address family or router configuration mode. 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.
|
Defaults
30 seconds for external peers and 5 seconds for internal peers.
Command Modes
Address family configuration
Router configuration
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
12.0(7)T
|
Address family configuration mode was added.
|
Usage Guidelines
If you specify a BGP peer group by using the peer-group-name argument, all the members of the peer group will inherit the characteristic configured with this command.
Examples
The following router configuration mode example sets the minimum time between sending BGP routing updates to 10 seconds:
neighbor 4.4.4.4 advertisement-interval 10
The following address family configuration mode example sets the minimum time between sending BGP routing updates to 10 seconds:
address-family ipv4 unicast
neighbor 4.4.4.4 advertisement-interval 10
Related Commands
Command
|
Description
|
address-family ipv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard IPv4 address prefixes.
|
address-family vpnv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard VPNv4 address prefixes.
|
neighbor peer-group (creating)
|
Creates a BGP peer group.
|
neighbor advertise-map non-exist-map
To install a Border Gateway Protocol (BGP) route as a locally originated route into a BGP routing table for conditional advertisement, use the neighbor advertise-map non-exist-map command in router configuration mode. To disable conditional advertisement, use the no form of this command.
neighbor{ip-address} advertise-map {map1-name} non-exist-map {map2-name}
no neighbor{ip-address} advertise-map {map1-name} non-exist-map {map2-name}
Syntax Description
ip-address
|
Specifies the IP address of the router that should receive conditional advertisements for a given set of routes.
|
map-name
|
Specifies the name of the advertise-map and the non-exist-map.
|
Defaults
The BGP Conditional Advertisement feature is not enabled by default.
Command Modes
Address family
Router configuration
Command History
Release
|
Modification
|
11.1CC
|
This command was introduced.
|
11.2
|
This command was integrated into Cisco IOS Release 11.2.
|
Usage Guidelines
Use the neighbor advertise-map non-exist-map router configuration command to conditionally advertise selected routes. The route map associated with the non-exist-map specifies the prefix that the BGP speaker will track. The route map associated with the advertise-map specifies the prefix that will be advertised when the prefix in the non-exist-map no longer exists. Any BGP route that is matched by the advertise-map route map will be advertised to the neighbor if the non-exist-map route map does not match any route in the BGP routing table. If the non-exist-map route map matches any route in the BGP routing table, any BGP routes that are matched by the advertise-map route map will not be advertised to the neighbor. All routes that may be dynamically advertised or not advertised need to exist in the BGP routing table for conditional advertisement to take place. The prefix tracked by the BGP speaker must be present in the IP routing table for the conditional advertisement not to take place.
Examples
The following address family configuration example configures a router to conditionally advertise routes to 10.1.1.1:
address-family ipv4 multicast
neighbor 10.1.1.1 advertise-map map1 non-exist-map map2
The following router configuration example configures a router to conditionally advertise routes to 10.2.1.1:
neighbor 10.2.1.1 advertise-map map1 non-exist-map map2
Related Commands
Command
|
Description
|
address-family ipv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard IPv4 address prefixes.
|
address-family vpnv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard VPNv4 address prefixes.
|
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 command in address family or router configuration mode. 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.
|
Defaults
No default route is sent to the neighbor.
Command Modes
Address family configuration
Router configuration
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
12.0
|
Modifications were added to permit extended access lists.
|
12.0(7)T
|
Address family configuration mode was added.
|
Usage Guidelines
This command does not require the presence of 0.0.0.0 in the local router. When used with a route map, the default route 0.0.0.0 is injected if the route map contains a match ip address clause and there is a route that matches the IP access list exactly. The route map can contain other match clauses also.
You can use standard or extended access lists with the neighbor default-originate command.
Examples
In the following router configuration example, the local router injects route 0.0.0.0 to the neighbor 172.16.2.3 unconditionally:
neighbor 172.16.2.3 remote-as 200
neighbor 172.16.2.3 default-originate
In the following address family configuration example, the local router injects route 0.0.0.0 to the neighbor 172.16.2.3 unconditionally:
neighbor 172.16.2.3 remote-as 200
address-family ipv4 unicast
neighbor 172.16.2.3 default-originate
In the following example, the local router injects route 0.0.0.0 to the neighbor 172.16.2.3 only if there is a route to 172.16.68.0 (that is, if a route with any mask exists, such as 255.255.255.0 or 255.255.0.0):
neighbor 172.16.2.3 remote-as 200
neighbor 172.16.2.3 default-originate route-map default-map
route-map default-map 10 permit
access-list 1 permit 172.16.68.0
In the following example, the last line of the configuration has been changed to show the use of an extended access list. The local router injects route 0.0.0.0 to the neighbor 172.16.2.3 only if there is a route to 172.16.68.0 with a mask of 255.255.0.0:
neighbor 172.16.2.3 remote-as 200
neighbor 172.16.2.3 default-originate route-map default-map
route-map default-map 10 permit
access-list 100 permit ip host 172.16.68.0 host 255.255.255.0
Related Commands
Command
|
Description
|
address-family ipv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard IPv4 address prefixes.
|
address-family vpnv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard VPNv4 address prefixes.
|
neighbor ebgp-multihop
|
Accepts and attempts BGP connections to external peers residing on networks that are not directly connected.
|
neighbor description
To associate a description with a neighbor, use the neighbor description command in router configuration mode. 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.
|
Defaults
There is no description of the neighbor.
Command Modes
Router configuration
Command History
Release
|
Modification
|
11.3
|
This command was introduced.
|
Examples
In the following example, the description of the neighbor is "peer with xyz.com":
neighbor 172.16.2.3 description peer with xyz.com
neighbor distribute-list
To distribute Border Gateway Protocol (BGP) neighbor information as specified in an access list, use the neighbor distribute-list command in address family or router configuration mode. To remove an entry, use the no form of this command.
neighbor {ip-address | peer-group-name} distribute-list {access-list-number |
expanded-list-number | access-list-name| prefix-list-name} {in | out}
no neighbor {ip-address | peer-group-name} distribute-list {access-list-number |
expanded-list-number | access-list-name| prefix-list-name} {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 a standard or extended access list. The range of a standard access list number is from 1 to 99. The range of an extended access list number is from 100 to 199.
|
expanded-list-number
|
Number of an expanded access list number. The range of an expanded access list is from 1300 to 2699.
|
access-list-name
|
Name of a standard or extended access list.
|
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 to that neighbor.
|
Defaults
No BGP neighbor is specified.
Command Modes
Address family configuration
Router configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
11.0
|
The peer-group-name argument was added.
|
11.2
|
The access-list-name argument was added.
|
12.0
|
The prefix-list-name argument was added,
|
12.0(7)T
|
Address family configuration mode was added.
|
Usage Guidelines
If you specify a BGP peer group by using the peer-group-name argument, all the members of the peer group will inherit the characteristic configured with this command. Specifying the command for a neighbor overrides the inbound policy that is inherited from the peer group.
Using a distribute list is one of several ways to filter advertisements. Advertisements can also be filtered by using the following methods:
•
Autonomous system path filters can be configured with the ip as-path access-list and neighbor filter-list commands.
•
The access-list (IP standard) and access-list (IP extended) commands can be used to configure standard and extended access lists for the filtering of advertisement.
•
The route map command can be used to filter advertisements. Route maps may be configured with autonomous system filters, prefix filters, access lists and distribute lists.
Standard access lists may be used to filter routing updates. However, in the case of route filtering when using classless interdomain routing (CIDR), standard access lists do not provide the level of granularity that is necessary to configure advanced filtering of network addresses and masks. Extended access lists, configured with the access-list (IP extended) command, should be used to configure route filtering when using CIDR because extended access lists allow the network operator to use wild card bits to filter the relevant prefixes and masks. Wild card bits are similar to the bit masks that are used with normal access lists; prefix and mask bits that correspond to wild card bits that are set to 0 are used in the comparison of addresses or prefixes and wild card bits that are set to 1 are ignored during any comparisons. This function of extended access list configuration can also be used to filter addresses or prefixes based on the prefix length.
Examples
The following router configuration mode example applies list 39 to incoming advertisements from neighbor 120.23.4.1. List 39 permits the advertisement of network 10.109.0.0.
neighbor 120.23.4.1 distribute-list 39 in
The following three examples show different scenarios for using an extended access list with a distribute list. The three examples are labeled "Example A", "Example B", and "Example C." Each of the example extended access list configurations are used with the neighbor distribute-list command configuration example below.
neighbor 120.23.4.1 distribute-list 101 in
Example A
The following extended access list example will permit route 192.108.0.0 255.255.0.0 but deny any more specific routes of 192.108.0.0 (including 192.108.0.0 255.255.255.0):
access-list 101 permit ip 192.108.0.0 0.0.0.0 255.255.0.0 0.0.0.0
access-list 101 deny ip 192.108.0.0 0.0.255.255 255.255.0.0 0.0.255.255
Example B
The following extended access list example will permit route 10.108.0/24 but deny 131.108/16 and all other subnets of 10.108.0.0:
access-list 101 permit ip 10.108.0.0 0.0.0.0 255.255.255.0 0.0.0.0
access-list 101 deny ip 10.108.0.0 0.0.255.255 255.255.0.0 0.0.255.255
Example C
The following extended access list example will deny all prefixes that are longer than 24 bits and permit all of the shorter prefixes:
access-list 101 deny ip 0.0.0.0 255.255.255.255 255.255.255.0 0.0.0.255
access-list 101 permit ip 0.0.0.0 255.255.255.255 0.0.0.0 255.255.255.255
Related Commands
Command
|
Description
|
access-list (IP extended)
|
Defines an extended IP access list.
|
access-list (IP standard)
|
Defines a standard IP access list.
|
address-family ipv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard IPv4 address prefixes.
|
address-family vpnv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard VPNv4 address prefixes.
|
ip as-path access-list
|
Defines a BGP-related access list.
|
neighbor filter-list
|
Sets up a BGP filter.
|
neighbor peer-group (creating)
|
Creates a BGP peer group.
|

Note
Do not apply both a neighbor distribute-list and a neighbor prefix-list command to a neighbor in any given direction (inbound or outbound). These two commands are mutually exclusive, and only one command (neighbor prefix-list or neighbor distribute-list) can be applied to each inbound or outbound direction.
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 command in router configuration mode. 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.
|
Defaults
Only directly connected neighbors are allowed.
Command Modes
Router configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
11.0
|
The peer-group-name argument was added.
|
Usage Guidelines
This feature should be used only under the guidance of technical support staff.
If you specify a BGP peer group by using the peer-group-name argument, all the members of the peer group will inherit the characteristic configured with this command.
To prevent the creation of loops through oscillating routes, the multihop will not be established if the only route to the multihop peer is the default route (0.0.0.0).
Examples
The following example allows connections to or from neighbor 10.108.1.1, which resides on a network that is not directly connected:
neighbor 10.108.1.1 ebgp-multihop
Related Commands
neighbor filter-list
To set up a Border Gateway Protocol (BGP) filter, use the neighbor filter-list command in address family or router configuration mode. 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.
|
Defaults
No filter is used.
Command Modes
Address family configuration
Router configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
12.0(7)T
|
Address family configuration mode was added.
|
12.1
|
The weight keyword was removed.
|
Usage Guidelines
This command establishes filters on both inbound and outbound BGP routes.
The weights assigned with the match as-path and set weight route-map configuration commands override the weights assigned using the neighbor weight command.
Refer to the "Regular Expressions" appendix in the Release 12.1 Cisco IOS Dial Services Command Reference for information on forming regular expressions.
If you specify a BGP peer group by using the peer-group-name argument, all the members of the peer group will inherit the characteristic configured with this command. Specifying the command with an IP address will override the value inherited from the peer group.
Examples
In the following router configuration mode example, the BGP neighbor with IP address 172.16.1.1 is not sent advertisements about any path through or from the adjacent autonomous system 123:
ip as-path access-list 1 deny _123_
ip as-path access-list 1 deny ^123$
neighbor 192.168.6.6 remote-as 123
neighbor 172.16.1.1 remote-as 47
neighbor 172.16.1.1 filter-list 1 out
In the following address family configuration mode example, the BGP neighbor with IP address 172.16.1.1 is not sent advertisements about any path through or from the adjacent autonomous system 123:
ip as-path access-list 1 deny _123_
ip as-path access-list 1 deny ^123$
address-family ipv4 unicast
neighbor 192.168.6.6 remote-as 123
neighbor 172.16.1.1 remote-as 47
neighbor 172.16.1.1 filter-list 1 out
Related Commands
Command
|
Description
|
address-family ipv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard IPv4 address prefixes.
|
address-family vpnv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard VPNv4 address prefixes.
|
ip as-path access-list
|
Defines a BGP-related access list.
|
neighbor distribute-list
|
Distributes BGP neighbor information as specified in an access list.
|
neighbor peer-group (creating)
|
Creates a BGP peer group.
|
neighbor weight
|
Assigns a weight to a neighbor connection.
|
neighbor maximum-prefix
To control how many prefixes can be received from a neighbor, use the neighbor maximum-prefix command in router configuration mode. 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 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.
|
Defaults
This command is disabled by default. There is no limit on the number of prefixes.
Command Modes
Router configuration
Command History
Release
|
Modification
|
11.3
|
This command was introduced.
|
Usage Guidelines
This command allows you to configure a maximum number of prefixes a BGP router is allowed to receive from a peer. It adds another mechanism (in addition to distribute lists, filter lists, and route maps) to control prefixes received from a peer.
When the number of received prefixes exceeds the maximum number configured, the router terminates the peering (by default). However, if the warning-only keyword is configured, the router instead only sends a log message, but continues peering with the sender. If the peer is terminated, the peer stays down until the clear ip bgp command is issued.
Examples
The following example sets the maximum number of prefixes allowed from the neighbor at 192.168.6.6 to 1000:
neighbor 192.168.6.6 maximum-prefix 1000
Related Commands
Command
|
Description
|
clear ip bgp
|
Resets a BGP connection using BGP soft reconfiguration.
|
neighbor next-hop-self
To configure the router as the next hop for a Border Gateway Protocol (BGP)-speaking neighbor or peer group, use the neighbor next-hop-self command in router configuration mode. 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.
|
Defaults
This command is disabled by default.
Command Modes
Router configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
11.0
|
The peer-group-name argument was added.
|
Usage Guidelines
This command is useful in nonmeshed networks (such as Frame Relay or X.25) where BGP neighbors may not have direct access to all other neighbors on the same IP subnet.
If you specify a BGP peer group by using the peer-group-name argument, all the members of the peer group will inherit the characteristic configured with this command. Specifying the command with an IP address will override the value inherited from the peer group.
For a finer granularity of control, see the set ip next-hop command.
Examples
The following example forces all updates destined for 10.108.1.1 to advertise this router as the next hop:
neighbor 10.108.1.1 next-hop-self
Related Commands
neighbor password
To enable Message Digest 5 (MD5) authentication on a TCP connection between two Border Gateway Protocol (BGP) peers, use the neighbor password command in router configuration mode. 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 25 characters. 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.
|
Defaults
This command is disabled by default.
Command Modes
Router configuration
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
Usage Guidelines
You can invoke authentication between two BGP peers, causing each segment sent on the TCP connection between them to be verified. This feature must be configured with the same password on both BGP peers; otherwise, the connection between them will not be made. The authentication feature uses the MD5 algorithm. Specifying this command causes the generation and checking of the MD5 digest on every segment sent on the TCP connection.
Configuring a password for a neighbor will cause an existing session to be torn down and a new one established.
If you specify a BGP peer group by using the peer-group-name argument, all the members of the peer group will inherit the characteristic configured with this command.
If a router has a password configured for a neighbor, but the neighbor router does not, a message such as the following will appear on the console while the routers attempt to establish a BGP session between them:
%TCP-6-BADAUTH: No MD5 digest from [peer's IP address]:11003 to [local router's
IP address]:179
Similarly, if the two routers have different passwords configured, a message such as the following will appear on the screen:
%TCP-6-BADAUTH: Invalid MD5 digest from [peer's IP address]:11004 to [local router's
IP address]:179
Examples
The following example enables the authentication feature between this router and the BGP neighbor at 10.108.1.1. The password that must also be configured for the neighbor is bla4u00=2nkq.
neighbor 10.108.1.1 password bla4u00=2nkq
Related Commands
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 command in address family or router configuration mode. 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.
|
Defaults
There are no BGP neighbors in a peer group.
Command Modes
Address family configuration
Router configuration
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
12.0(7)T
|
Address family configuration mode was added.
|
Usage Guidelines
The neighbor at the IP address indicated inherits all the configured options of the peer group.
Examples
The following router configuration mode example assigns three neighbors to the peer group named internal:
neighbor internal peer-group
neighbor internal remote-as 100
neighbor internal update-source loopback 0
neighbor internal route-map set-med out
neighbor internal filter-list 1 out
neighbor internal filter-list 2 in
neighbor 172.16.232.53 peer-group internal
neighbor 172.16.232.54 peer-group internal
neighbor 172.16.232.55 peer-group internal
neighbor 172.16.232.55 filter-list 3 in
The following address family configuration mode example assigns three neighbors to the peer group named internal:
address-family ipv4 unicast
neighbor internal peer-group
neighbor internal remote-as 100
neighbor internal update-source loopback 0
neighbor internal route-map set-med out
neighbor internal filter-list 1 out
neighbor internal filter-list 2 in
neighbor 172.16.232.53 peer-group internal
neighbor 172.16.232.54 peer-group internal
neighbor 172.16.232.55 peer-group internal
neighbor 172.16.232.55 filter-list 3 in
Related Commands
Command
|
Description
|
address-family ipv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard IPv4 address prefixes.
|
address-family vpnv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard VPNv4 address prefixes.
|
neighbor peer-group (creating)
|
Creates a BGP peer group.
|
neighbor shutdown
|
Disables a neighbor or peer group.
|
neighbor peer-group (creating)
To create a Border Gateway Protocol (BGP) or multiprotocol BGP peer group, use the neighbor peer-group command in address family or router configuration mode. 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.
|
Defaults
There is no BGP peer group.
Command Modes
Address family configuration
Router configuration
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
11.1(20)CC
|
The nlri unicast, nlri multicast, and nlri unicast multicast keywords were added.
|
12.0(2)S
|
The nlri unicast, nlri multicast, and nlri unicast multicast keywords were added.
|
12.0(7)T
|
The nlri unicast, nlri multicast, and nlri unicast multicast keywords were added.
Address family configuration mode was added.
|
Usage Guidelines
Often in a BGP or multiprotocol BGP speaker, many neighbors are configured with the same update policies (that is, same outbound route maps, distribute lists, filter lists, update source, and so on). Neighbors with the same update policies can be grouped into peer groups to simplify configuration and make update calculation more efficient.
Note
Peer group members can span multiple logical IP subnets, and can transmit, or pass along, routes from one peer group member to another.
Once a peer group is created with the neighbor peer-group command, it can be configured with the neighbor commands. By default, members of the peer group inherit all the configuration options of the peer group. Members also can be configured to override the options that do not affect outbound updates.
Peer group members will always inherit the following configuration options: remote-as (if configured), version, update-source, out-route-map, out-filter-list, out-dist-list, minimum-advertisement-interval, and next-hop-self. All the peer group members will inherit changes made to the peer group.
If a peer group is not configured with a remote-as, the members can be configured with the neighbor {ip-address | peer-group-name} remote-as command. This command allows you to create peer groups containing Exterior Border Gateway Protocol (EBGP) neighbors.
Examples
The following example configurations show how to create these types of neighbor peer group:
•
Interior Border Gateway Protocol (IBGP) peer group
•
EBGP peer group
•
Multiprotocol BGP peer group
IBGP Peer Group
In the following example, the peer group named internal configures the members of the peer group to be IBGP neighbors. By definition, this is an IBGP peer group because the router bgp command and the neighbor remote-as command indicate the same autonomous system (in this case, autonomous system 100). All the peer group members use loopback 0 as the update source and use set-med as the outbound route map. The neighbor internal filter-list 2 in command shows that, except for 172.16.232.55, all the neighbors have filter list 2 as the inbound filter list.
neighbor internal peer-group
neighbor internal remote-as 100
neighbor internal update-source loopback 0
neighbor internal route-map set-med out
neighbor internal filter-list 1 out
neighbor internal filter-list 2 in
neighbor 172.16.232.53 peer-group internal
neighbor 172.16.232.54 peer-group internal
neighbor 172.16.232.55 peer-group internal
neighbor 172.16.232.55 filter-list 3 in
EBGP Peer Group
The following example defines the peer group named external-peers without the neighbor remote-as command. By definition, this is an EBGP peer group because each individual member of the peer group is configured with its respective autonomous system number separately. Thus the peer group consists of members from autonomous systems 200, 300, and 400. All the peer group members have the set-metric route map as an outbound route map and filter list 99 as an outbound filter list. Except for neighbor 172.16.232.110, all of them have 101 as the inbound filter list.
neighbor external-peers peer-group
neighbor external-peers route-map set-metric out
neighbor external-peers filter-list 99 out
neighbor external-peers filter-list 101 in
neighbor 172.16.232.90 remote-as 200
neighbor 172.16.232.90 peer-group external-peers
neighbor 172.16.232.100 remote-as 300
neighbor 172.16.232.100 peer-group external-peers
neighbor 172.16.232.110 remote-as 400
neighbor 172.16.232.110 peer-group external-peers
neighbor 172.16.232.110 filter-list 400 in
Multiprotocol BGP Peer Group
In the following example, all members of the peer group are multicast-capable:
neighbor 10.1.1.1 remote-as 1
neighbor 172.16.2.2 remote-as 2
address-family ipv4 multicast
neighbor mygroup peer-group
neighbor 10.1.1.1 peer-group mygroup
neighbor 172.16.2.2 peer-group mygroup
neighbor 10.1.1.1 activate
neighbor 172.16.2.2 activate
Related Commands
Command
|
Description
|
address-family ipv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard IPv4 address prefixes.
|
address-family vpnv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard VPNv4 address prefixes.
|
clear ip bgp peer-group
|
Removes all the members of a BGP peer group.
|
show ip bgp peer-group
|
Displays information about BGP peer groups.
|
neighbor prefix-list
To distribute Border Gateway Protocol (BGP) neighbor information as specified in a prefix list, use the neighbor prefix-list command in address family or router configuration mode. 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
|
IP address of neighbor.
|
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 to that neighbor.
|
Defaults
No BGP neighbor is specified.
Command Modes
Address family configuration
Router configuration
Command History
Release
|
Modification
|
12.0
|
This command was introduced.
|
11.0
|
The peer-group-name argument was added.
|
12.0(7)T
|
Address family configuration mode was added.
|
Usage Guidelines
Using prefix lists is one of two ways to filter BGP advertisements. The other way is to use AS-path filters, as with the ip as-path access-list global configuration command and the neighbor filter-list command, and access or prefix lists, as with the neighbor distribute-list command.
If you specify a BGP peer group by using the peer-group-name argument, all the members of the peer group will inherit the characteristic configured with this command. Specifying the command with an IP address will override the value inherited from the peer group.
Note
Do not apply both a neighbor distribute-list and a neighbor prefix-list command to a neighbor in any given direction (inbound or outbound). These two commands are mutually exclusive, and only one command (neighbor prefix-list or neighbor distribute-list) can be applied to each inbound or outbound direction.
Examples
The following router configuration mode example applies the prefix list named abc to incoming advertisements to neighbor 120.23.4.1:
neighbor 120.23.4.1 prefix-list abc in
The following address family configuration mode example applies the prefix list named abc to incoming advertisements to neighbor 120.23.4.1:
address-family ipv4 unicast
neighbor 120.23.4.1 prefix-list abc in
The following example applies the prefix list named CustomerA to in outgoing advertisements to neighbor 120.23.4.1:
neighbor 120.23.4.1 prefix-list CustomerA out
Related Commands
Command
|
Description
|
address-family ipv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard IPv4 address prefixes.
|
address-family vpnv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard VPNv4 address prefixes.
|
clear ip prefix-list
|
Resets the hit count of the prefix list entries.
|
ip as-path access-list
|
Defines a BGP-related access list.
|
ip prefix-list
|
Creates an entry in a prefix list.
|
ip prefix-list description
|
Adds a text description of a prefix list.
|
ip prefix-list sequence-number
|
Enables the generation of sequence numbers for entries in a prefix list.
|
neighbor filter-list
|
Sets up a BGP filter.
|
neighbor peer-group (creating)
|
Creates a BGP peer group.
|
show ip bgp peer-group
|
Displays information about BGP peer groups.
|
show ip prefix-list
|
Displays information about a prefix list or prefix list entries.
|
neighbor remote-as
To add an entry to the Border Gateway Protocol (BGP) or multiprotocol BGP neighbor table, use the neighbor remote-as command in router configuration mode. To remove an entry from the table, use the no form of this command.
neighbor {ip-address | peer-group-name} remote-as autonomous-system-number
no neighbor {ip-address | peer-group-name} remote-as autonomous-system-number
Syntax Description
ip-address
|
IP address of the neighbor.
|
peer-group-name
|
Name of a BGP peer group.
|
autonomous-system-number
|
Autonomous system to which the neighbor belongs.
|
Defaults
There are no BGP or multiprotocol BGP neighbor peers.
Command Modes
Router configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
11.0
|
The peer-group-name argument was added.
|
11.1(20)CC
|
The nlri unicast, nlri multicast, and nlri unicast multicast keywords were added.
|
12.0(7)T
|
The nlri unicast, nlri multicast, and nlri unicast multicast keywords were removed.
|
Usage Guidelines
Specifying a neighbor with an autonomous system number that matches the autonomous system number specified in the router bgp global configuration command identifies the neighbor as internal to the local autonomous system. Otherwise, the neighbor is considered external.
If you specify a BGP peer group by using the peer-group-name argument, all the members of the peer group will inherit the characteristic configured with this command.
By default, neighbors that are defined using the neighbor remote-as command in router configuration mode exchange only unicast address prefixes. To exchange other address prefix types, such as multicast and VPNv4, neighbors must also be activated using the neighbor activate command in address family configuration mode.
Examples
The following example specifies that a router at the address 10.108.1.2 is a neighbor in autonomous system number 109:
neighbor 10.108.1.2 remote-as 109
The following example assigns a BGP router to autonomous system 109, and two networks are listed as originating in the autonomous system. Then the addresses of three remote routers (and their autonomous systems) are listed. The router being configured will share information about networks 10.108.0.0 and 192.31.7.0 with the neighbor routers. The first router listed is in the same Class B network address space, but in a different autonomous system; the second neighbor remote-as command illustrates specification of an internal neighbor (with the same autonomous system number) at address 10.108.234.2; and the last neighbor remote-as command specifies a neighbor on a different network.
neighbor 10.108.200.1 remote-as 167
neighbor 10.108.234.2 remote-as 109
neighbor 150.136.64.19 remote-as 99
The following example configures neighbor 10.108.1.1 in autonomous system 1 to exchange only multicast routes:
neighbor 10.108.1.1 remote-as 1
neighbor 131.108 1.2 remote-as 1
neighbor 172.16.2.2 remote-as 2
address-family ipv4 multicast
neighbor 10.108.1.1 activate
neighbor 131.108 1.2 activate
neighbor 172.16.2.2 activate
The following example configures neighbor 10.108.1.1 in autonomous system 1 to exchange only unicast routes:
neighbor 10.108.1.1 remote-as 1
neighbor 131.108 1.2 remote-as 1
neighbor 172.16.2.2 remote-as 2
Related Commands
neighbor remove-private-as
To remove private autonomous system numbers from t in outbound routing updates, use the neighbor remove-private-as command in router configuration mode. To disable this function, use the no form of this command.
neighbor {ip-address | peer-group-name} remove-private-as
no neighbor {ip-address | peer-group-name} remove-private-as
Syntax Description
ip-address
|
IP address of the BGP-speaking neighbor.
|
peer-group-name
|
Name of a BGP peer group.
|
Defaults
This command is disabled by default.
Command Modes
Router configuration
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
11.0
|
The peer-group-name argument was added.
|
Usage Guidelines
This feature is available for external BGP (EBGP) neighbors only.
When an update is passed to the external neighbor, if the AS-path includes private autonomous system numbers, the software will drop the private autonomous system numbers.
If the AS-path includes both private and public autonomous system numbers, the software considers this to be a configuration error and does not remove the private autonomous system numbers.
If the AS-path contains the autonomous system number of the EBGP neighbor, the private autonomous system numbers will not be removed.
If this feature is used with confederation, it will work as long as the private autonomous system numbers follow the confederation portion of the AS-path.
The private autonomous system values are from 64512 to 65535.
Examples
The following example shows a configuration that will remove the private autonomous system number from the updates sent to 172.16.2.33. The result is that the AS_path for the paths advertised by 10.108.1.1 through autonomous system 100 will just contain "100" (as seen by autonomous system 2051).
neighbor 10.108.1.1 description peer with private-as
neighbor 10.108.1.1 remote-as 65001
neighbor 172.16.2.33 description eBGP peer
neighbor 172.16.2.33 remote-as 2051
neighbor 172.16.2.33 remove-private-as
router-in-AS100# show ip bgp 10.0.0.0
BGP routing table entry for 10.0.0.0/8, version 15
Paths: (1 available, best #1)
Advertised to non peer-group peers:
10.108.1.1 from 10.108.1.1
Origin IGP, metric 0, localpref 100, valid, external, best
router-in-AS2501# show ip bgp 10.0.0.0
BGP routing table entry for 10.0.0.0/8, version 3
Paths: (1 available, best #1)
Not advertised to any peer
172.16.2.32 from 172.16.2.32
Origin IGP, metric 0, localpref 100, valid, external, best
Related Commands
Command
|
Description
|
neighbor remote-as
|
Allows entries to the BGP neighbor table.
|
show ip bgp
|
Displays entries in the BGP routing table.
|
neighbor route-map
To apply a route map to incoming or outgoing routes, use the neighbor route-map command in address family or router configuration mode. To remove a route map, use the no form of this command.
neighbor {ip-address | peer-group-name} route-map route-map-name {in | out}
no neighbor {ip-address | peer-group-name} route-map route-map-name {in | out}
Syntax Description
ip-address
|
IP address of the neighbor.
|
peer-group-name
|
Name of a BGP or multiprotocol BGP peer group.
|
route-map-name
|
Name of a route map.
|
in
|
Apply to incoming routes.
|
out
|
Apply to outgoing routes.
|
Defaults
No route maps are applied to a peer.
Command Modes
Address family configuration
Router configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
12.0(7)T
|
Address family configuration mode was added.
|
Usage Guidelines
When specified in address family configuration mode, this command applies a route map to that particular address family only. When specified in router configuration mode, this command applies a route map to IPv4 unicast routes only.
If an outbound route map is specified, it is proper behavior to only advertise routes that match at least one section of the route map.
If you specify a BGP or multiprotocol BGP peer group by using the peer-group-name argument, all the members of the peer group will inherit the characteristic configured with this command. Specifying the command for a neighbor overrides the inbound policy that is inherited from the peer group.
Examples
The following router configuration mode example applies a route map named internal-map to a BGP incoming route from 172.16.70.24:
neighbor 172.16.70.24 route-map internal-map in
The following address family configuration mode example applies a route map named internal-map to a multiprotocol BGP incoming route from 172.16.70.24:
address-family ipv4 multicast
neighbor 172.16.70.24 route-map internal-map in
Related Commands
Command
|
Description
|
address-family ipv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard IPv4 address prefixes.
|
address-family vpnv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard VPNv4 address prefixes.
|
neighbor peer-group (creating)
|
Creates a BGP peer group.
|
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 command in address family or router configuration mode. 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.
|
Defaults
There is no route reflector in the autonomous system.
Command Modes
Address family configuration
Router configuration
Command History
Release
|
Modification
|
11.1
|
This command was introduced.
|
12.0(7)T
|
Address family configuration mode was added.
|
Usage Guidelines
By default, all Interior Border Gateway Protocol (IBGP) speakers in an autonomous system must be fully meshed, and neighbors do not readvertise IBGP learned routes to neighbors, thus preventing a routing information loop.
If you use route reflectors, all IBGP speakers need not be fully meshed. In the route reflector model, an internal BGP peer is configured to be a route reflector responsible for passing IBGP learned routes to IBGP neighbors. This scheme eliminates the need for each router to talk to every other router.
Use the neighbor route-reflector-client command to configure the local router as the route reflector and the specified neighbor as one of its clients. All the neighbors configured with this command will be members of the client group and the remaining IBGP peers will be members of the nonclient group for the local route reflector.
The bgp client-to-client reflection command controls client-to-client reflection.
Examples
In the following router configuration mode example, the local router is a route reflector. It passes learned IBGP routes to the neighbor at 172.16.70.24.
neighbor 172.16.70.24 route-reflector-client
In the following address family configuration mode example, the local router is a route reflector. It passes learned IBGP routes to the neighbor at 172.16.70.24.
address-family ipv4 unicast
neighbor 172.16.70.24 route-reflector-client
Related Commands
Command
|
Description
|
address-family ipv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard IPv4 address prefixes.
|
address-family vpnv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard VPNv4 address prefixes.
|
bgp cluster-id
|
Configures the cluster ID if the BGP cluster has more than one route reflector.
|
neighbor route-reflector-client
|
Configures the router as a BGP route reflector and configures the specified neighbor as its client.
|
show ip bgp
|
Displays entries in the BGP routing table.
|
neighbor send-community
To specify that a "communities" attribute should be sent to a Border Gateway Protocol (BGP) neighbor, use the neighbor send-community command in address family or router configuration mode. To remove the entry, use the no form of this command.
neighbor {ip-address | peer-group-name} send-community [both | standard | extended]
no neighbor {ip-address | peer-group-name} send-community
Syntax Description
ip-address
|
IP address of the neighbor.
|
peer-group-name
|
Name of a BGP peer group.
|
both
|
(Optional) Specifies that both standard and extended communities will be sent.
|
standard
|
(Optional) Specifies that only standard communities will be sent.
|
extended
|
(Optional) Specifies that only extended communities will be sent.
|
No "communities" attribute is sent to any neighbor.
Command Modes
Address family configuration
Router configuration
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
11.0
|
The peer-group-name argument was added.
|
12.0(7)T
|
Address family configuration mode was added.
|
Usage Guidelines
If you specify a BGP peer group by using the peer-group-name argument, all the members of the peer group will inherit the characteristic configured with this command.
Examples
In the following router configuration mode example, the router belongs to autonomous system 109 and is configured to send the "communities" attribute to its neighbor at IP address 172.16.70.23:
neighbor 172.16.70.23 send-community
In the following address family configuration mode example, the router belongs to autonomous system 109 and is configured to send the "communities" attribute to its neighbor at IP address 172.16.70.23:
address-family ipv4 multicast
neighbor 172.16.70.23 send-community
Related Commands
Command
|
Description
|
address-family ipv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard IPv4 address prefixes.
|
address-family vpnv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard VPNv4 address prefixes.
|
match community
|
Matches a BGP community.
|
neighbor peer-group (creating)
|
Creates a BGP peer group.
|
set community
|
Sets the BGP COMMUNITIES attribute.
|
neighbor shutdown
To disable a neighbor or peer group, use the neighbor shutdown command in router configuration mode. 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.
|
Defaults
No change is made to the status of any BGP neighbor or peer group.
Command Modes
Router configuration
Command History
Release
|
Modification
|
12.0
|
This command was introduced.
|
Usage Guidelines
The neighbor shutdown command terminates any active session for the specified neighbor or peer group, and removes all associated routing information. In the case of a peer group, this could mean a large number of peering sessions are suddenly terminated.
To display a summary of BGP neighbors and peer-group connections, use the show ip bgp summary command. Those neighbors with an Idle status and the Admin entry have been disabled by the neighbor shutdown command.
"State/PfxRcd" shows the current state of the BGP session/the number of prefixes the router has received from a neighbor or peer group. When the maximum number (as set by the neighbor maximum-prefix command) is reached, the string "PfxRcd" appears in the entry, the neighbor is shut down, and the connection is Idle.
Examples
The following example disables any active session for the neighbor 172.16.70.23:
neighbor 172.16.70.23 shutdown
The following example disables all peering sessions for the peer group internal:
neighbor internal shutdown
Related Commands
neighbor soft-reconfiguration
To configure the Cisco IOS software to start storing updates, use the neighbor soft-reconfiguration command in router configuration mode. 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) Indicates that the update to be stored is an incoming update.
|
Defaults
Soft reconfiguration is not enabled
Command Modes
Router configuration
Command History
Release
|
Modification
|
11.2
|
This command was introduced.
|
Usage Guidelines
Entering this command starts the storage of updates, which is required to do inbound soft reconfiguration. Outbound BGP soft reconfiguration does not require inbound soft reconfiguration to be enabled.
To use soft reconfiguration, or soft reset, without preconfiguration, both BGP peers must support the soft route refresh capability, which is advertised in the OPEN message sent when the peers establish a TCP session. Routers running Cisco IOS software releases prior to Release 12.1 do not support the route refresh capability and must clear the BGP session using the neighbor soft-reconfiguration command. Clearing the BGP session using the neighbor soft-reconfiguration command has a negative effect on network operations and should be used only as a last resort. Routers running Cisco IOS software Release 12.1 or later releases support the route refresh capability and dynamic soft resets, and can use the clear ip bgp {* | ip-address | peer-group name} in command to clear the BGP session.
To determine whether a BGP router supports this capability, use the show ip bgp neighbors command. If a router supports the route refresh capability, the following message is displayed:
Received route refresh capability from peer.
If you specify a BGP peer group by using the peer-group-name argument, all the members of the peer group will inherit the characteristic configured with this command.
Examples
The following example enables inbound soft reconfiguration for the neighbor 10.108.1.1. All the updates received from this neighbor will be stored unmodified, regardless of the inbound policy. When inbound soft reconfiguration is done later, the stored information will be used to generate a new set of inbound updates.
neighbor 10.108.1.1 remote-as 200
neighbor 10.108.1.1 soft-reconfiguration inbound
Related Commands
neighbor timers
To set the timers for a specific Border Gateway Protocol (BGP) peer or peer group, use the neighbor timers command in router configuration mode. 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.
|
Defaults
keepalive: 60 seconds
holdtime: 180 seconds
Command Modes
Router configuration
Command History
Release
|
Modification
|
12.0
|
This command was introduced.
|
Usage Guidelines
The timers configured for a specific neighbor or peer group override the timers configured for all BGP neighbors using the timers bgp command.
Examples
The following example changes the keepalive timer to 70 seconds and the holdtime timer to 210 seconds for the BGP peer 192.98.47.0:
router bgp 109
neighbor 192.98.47.0 timers 70 210
neighbor update-source
To have the Cisco IOS software allow Border Gateway Protocol (BGP) sessions to use a specific operational interface for TCP connections, use the neighbor update-source command in router configuration mode. 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-type
|
Interface to be used as the source.
|
Defaults
Best local address
Command Modes
Router configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
This command works in conjunction with any specified interface on the router. The loopback interface is the interface that is most commonly used with this feature. For more information, refer to the loopback interface feature described in the "Interface Configuration Overview" chapter of the Cisco IOS Interface Configuration Guide.
If you specify a BGP peer group by using the peer-group-name argument, all the members of the peer group will inherit the characteristic configured with this command.
Examples
The following example sources BGP TCP connections for the specified neighbor with loopback interface's IP address rather than the best local address:
neighbor 172.16.2.3 remote-as 110
neighbor 172.16.2.3 update-source Loopback0
Related Commands
neighbor version
To configure the Cisco IOS software to accept only a particular Border Gateway Protocol (BGP) version, use the neighbor version command in router configuration mode. 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 use only Version 2 with the specified neighbor. The default is to use Version 4 and dynamically negotiate down to Version 2 if requested.
|
Defaults
BGP Version 4
Command Modes
Router configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
Entering this command disables dynamic version negotiation.
Note
The Cisco implementation of BGP in Cisco IOS Release 12.0(5)T or earlier releases supports BGP Versions 2, 3, and 4, with dynamic negotiation down to Version 2 if a neighbor does not accept BGP Version 4 (the default version).
The Cisco implementation of BGP in Cisco IOS Release 12.0(6)T or later releases supports BGP Version 4 only and does not support dynamic negotiation down to Version 2.
If you specify a BGP peer group by using the peer-group-name argument, all the members of the peer group will inherit the characteristic configured with this command.
Examples
The following example locks down to Version 4 of the BGP protocol:
router bgp 109
neighbor 131.104.27.2 version 4
Related Commands
neighbor weight
To assign a weight to a neighbor connection, use the neighbor weight command in address family or router configuration mode. 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.
|
Defaults
Routes learned through another BGP peer have a default weight of 0 and routes sourced by the local router have a default weight of 32768.
Command Modes
Address family configuration
Router configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
12.0(7)T
|
Address family configuration mode was added.
|
Usage Guidelines
All routes learned from this neighbor will have the assigned weight initially. The route with the highest weight will be chosen as the preferred route when multiple routes are available to a particular network.
The weights assigned with the set weight route-map command overrides the weights assigned using the neighbor weight command.
Note
For weight changes to take effect, use of the clear ip bgp peer-group * commands may be necessary.
If you specify a BGP peer group by using the peer-group-name argument, all the members of the peer group will inherit the characteristic configured with this command.
Examples
The following router configuration mode example sets the weight of all routes learned via 172.16.12.1 to 50:
router bgp 109
neighbor 172.16.12.1 weight 50
The following address family configuration mode example sets the weight of all routes learned via 172.16.12.1 to 50:
address-family ipv4 multicast
neighbor 172.16.12.1 weight 50
Related Commands
Command
|
Description
|
address-family ipv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard IPv4 address prefixes.
|
address-family vpnv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard VPNv4 address prefixes.
|
neighbor distribute-list
|
Distributes BGP neighbor information as specified in an access list.
|
neighbor filter-list
|
Sets up a BGP filter.
|
neighbor peer-group (creating)
|
Creates a BGP peer group.
|
network (BGP and multiprotocol BGP)
To specify the networks to be advertised by the Border Gateway Protocol (BGP) and multiprotocol BGP routing processes, use the network command in address family or router configuration mode. To remove an entry, use the no form of this command.
network network-number [mask network-mask] [route-map map-name]
no network network-number [mask network-mask] [route-map map-name]
Syntax Description
network-number
|
Network that BGP or multiprotocol BGP will advertise.
|
mask
|
(Optional) Network or subnetwork mask. If the mask keyword is configured, then an exact match must exist in the routing table.
|
network-mask
|
(Optional) Network mask address.
|
route-map map-name
|
(Optional) Name of a route map.
|
Defaults
No networks are specified.
Command Modes
Address family configuration
Router configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
12.0
|
The limit of 200 network commands per BGP router was removed.
|
11.1(20)CC
|
The nlri unicast, nlri multicast, and nlri unicast multicast keywords were added.
|
12.0(7)T
|
The nlri unicast, nlri multicast, and nlri unicast multicast keywords were removed.
Address family configuration mode was added.
|
Usage Guidelines
This command first appeared in Cisco IOS Release 10.0. The limit of 200 network commands per BGP router was removed in Cisco IOS Release 12.0. The maximum number of network commands you can use is now determined by the resources of the router, such as the amount of configured NVRAM or RAM.
For the information to be advertised by BGP or multiprotocol BGP, a route to the network specified must be present in the routing table. The routing information may be learned from connected routes, dynamic routing, and from static route sources.
Use the route-map keyword to apply a route map to a network to be advertised by the BGP and multiprotocol BGP routing processes. The specified route map can be used in filtering the network, or in setting attributes on the routes advertised by the network command.
Examples
The following example sets up network 10.108.0.0 to be included in the BGP updates:
The following example sets up network 10.108.0.0 to be included in the multiprotocol BGP updates:
address family ipv4 multicast
The following example shows the use of the mask keyword:
ip route 10.0.0.0 255.0.0.0 null0
Note
This configuration will advertise a supernet 10.0.0.0/8. It is necessary to use a static route to provide the information because this summary route may not be learned through dynamic routing or from a connected interface. Specifying the null 0 interface with the ip route command guarantees that the routing information will always be present in the routing table.
Related Commands
Command
|
Description
|
address-family ipv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard IPv4 address prefixes.
|
address-family vpnv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard VPNv4 address prefixes.
|
default-information originate (BGP)
|
Allows the redistribution of network 0.0.0.0 into BGP.
|
network backdoor
|
Specifies a backdoor route to a BGP-learned prefix that provides better information about the network.
|
router bgp
|
Configures the BGP routing process.
|
network backdoor
To specify a backdoor route to a Border Gateway Protocol (BGP) border router that provides better information about the network, use the network backdoor command in address family or router configuration mode. 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.
|
Defaults
No network is advertised.
Command Modes
Address family configuration
Router configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
12.0(7)T
|
Address family configuration mode was added.
|
Usage Guidelines
A backdoor network is assigned an administrative distance of 200. The objective is to make Interior Gateway Protocol (IGP) learned routes preferred. A backdoor network is treated as a local network, except that it is not advertised. A network that is marked as a back door is not sourced by the local router, but should be learned from external neighbors. The BGP best path selection algorithm does not change when a network is configured as a back door.
Examples
The following address family configuration example configures network 10.108.0.0 as a local network and network 192.31.7.0 as a backdoor network:
address-family ipv4 multicast
network 192.31.7.0 backdoor
The following router configuration example configures network 10.108.0.0 as a local network and network 192.31.7.0 as a backdoor network:
network 192.31.7.0 backdoor
Related Commands
Command
|
Description
|
address-family ipv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard IPv4 address prefixes.
|
address-family vpnv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard VPNv4 address prefixes.
|
router bgp
To configure the Border Gateway Protocol (BGP) routing process, use the router bgp command in global configuration mode. 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.
|
Defaults
No BGP routing process is enabled by default.
Command Modes
Global configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
This command allows you to set up a distributed routing core that automatically guarantees the loop-free exchange of routing information between autonomous systems.
Examples
The following example configures a BGP process for autonomous system 120:
Related Commands
set as-path
To modify an autonomous system path for Border Gateway Protocol (BGP) routes, use the set as-path command in route-map configuration mode. 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.
|
Defaults
Autonomous system path is not modified.
Command Modes
Route-map configuration
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
Usage Guidelines
The only global BGP metric available to influence the best path selection is the AS-PATH length. By varying the length of the AS-PATH, a BGP speaker can influence the best path selection by a peer further away.
By allowing you to convert the tag into an autonomous system path, the set as-path tag variation of this command modifies the autonomous system length. The set as-path prepend variation allows you to "prepend" an arbitrary autonomous system path string to BGP routes. Usually the local autonomous system number is prepended multiple times, increasing the autonomous system path length.
Examples
The following example converts the tag of a redistributed route into an autonomous system path:
route-map set-as-path-from-tag
redistribute ospf 109 route-map set-as-path-from-tag
The following example prepends 100 100 100 to all the routes advertised to 10.108.1.1:
set as-path prepend 100 100 100
neighbor 10.108.1.1 route-map set-as-path out
Related Commands
Command
|
Description
|
match as-path
|
Matches a BGP autonomous system path access list.
|
match community
|
Matches a BGP community.
|
match interface (IP)
|
Distributes routes that have their next hop out one of the interfaces specified.
|
match ip address
|
Distributes any routes that have a destination network number address that is permitted by a standard or extended access list, and performs policy routing on packets.
|
match ip next-hop
|
Redistributes any routes that have a next-hop router address passed by one of the access lists specified.
|
match ip route-source
|
Redistributes routes that have been advertised by routers and access servers at the address specified by the access lists.
|
match metric
|
Redistributes routes with the metric specified.
|
match route-type (IP)
|
Redistributes routes of the specified type.
|
match tag
|
Redistributes routes in the routing table that match the specified tags.
|
route-map (IP)
|
Defines the conditions for redistributing routes from one routing protocol into another, or enables policy routing.
|
set automatic-tag
|
Automatically computes the tag value.
|
set community
|
Sets the BGP COMMUNITIES attribute.
|
set level (IP)
|
Indicates where to import routes.
|
set local-preference
|
Specifies a preference value for the autonomous system path.
|
set metric
|
Sets the metric value for a routing protocol.
|
set metric-type
|
Sets the metric type for the destination routing protocol.
|
set next-hop
|
Specifies the address of the next hop.
|
set origin (BGP)
|
Sets the BGP origin code.
|
set tag (IP)
|
Sets a tag value of the destination routing protocol.
|
set weight
|
Specifies the BGP weight for the routing table.
|
set comm-list delete
To remove communities from the community attribute of an inbound or outbound update, use the set comm-list delete command in route-map configuration mode. 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.
|
Defaults
No communities are removed.
Command Modes
Route-map configuration
Command History
Release
|
Modification
|
12.0
|
This command was introduced.
|
Usage Guidelines
This route-map set command removes communities from the community attribute of an inbound or outbound update using a route map to filter and determine the communities to be deleted. Depending upon whether the route map is applied to the inbound or outbound update for a neighbor, each community that passes the route map "permit" clause and matches the given community list will be removed from the community attribute being received from or sent to the BGP neighbor.
Each entry of a standard community list should list only one community when used with the set comm-list delete command. For example, in order to be able to delete communities 10:10 and 10:20, you must use the following format to create the entries:
ip community-list 5 permit 10:10
ip community-list 5 permit 10:20
The following format for a community list entry, while acceptable otherwise, does not work with the set comm-list delete command:
config ip community-list 5 permit 10:10 10:20
When both the set community comm and set comm-list delete commands are configured in the same sequence of a route-map attribute, the deletion operation (set comm-list delete) is performed before the set operation (set community comm).
Examples
In the following example, the communities 100:10 and 100:20 (if present) will be deleted from updates received from 172.16.233.33. Also, except for 100:50, all communities beginning with 100: will be deleted from updates sent to 172.16.233.33.
router bgp 100
neighbor 172.16.233.33 remote-as 120
neighbor 172.16.233.33 route-map ROUTEMAPIN in
neighbor 172.16.233.33 route-map ROUTEMAPOUT out
!
ip community-list 1 permit 100:10
ip community-list 1 permit 100:20
!
ip community-list 120 deny 100:50
ip community-list 120 permit 100:.*
!
route-map ROUTEMAPIN permit 10
set comm-list 1 delete
!
route-map ROUTEMAPOUT permit 10
set comm-list 120 delete
Related Commands
Command
|
Description
|
set community
|
Sets the BGP COMMUNITIES attribute.
|
set community
To set the Border Gateway Protocol (BGP) COMMUNITIES attribute, use the set community command in route-map configuration mode. 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
|
Specifies that community number. Valid values are 1 to 4294967200, no-export, or no-advertise.
|
additive
|
(Optional) Adds the community to the already existing communities.
|
none
|
(Optional) Removes the COMMUNITY attribute from the prefixes that pass the route-map.
|
Defaults
No BGP COMMUNITIES attributes exist.
Command Modes
Route-map configuration
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
Usage Guidelines
You must have a match clause (even if it points to a "permit everything" list) if you want to set tags.
Use the route-map global configuration command, and the match and set route-map configuration commands, to define the conditions for redistributing routes from one routing protocol into another. Each route-map command has a list of match and set commands associated with it. The match commands specify the match criteria—the conditions under which redistribution is allowed for the current route-map command. The set commands specify the set actions—the particular redistribution actions to perform if the criteria enforced by the match commands are met. The no route-map command deletes the route map.
The set route-map configuration commands specify the redistribution set actions to be performed when all of a route map's match criteria are met. When all match criteria are met, all set actions are performed.
Examples
In the following example, routes that pass the autonomous system path access list 1 have the community set to 109. Routes that pass the autonomous system path access list 2 have the community set to no-export (these routes will not be advertised to any EBGP peers).
route-map set_community 10 permit
route-map set_community 20 permit
In the following similar example, routes that pass the autonomous system path access list 1 have the community set to 109. Routes that pass the autonomous system path access list 2 have the community set to local-as (the router will not advertise this route to an EBGP peer outside the local autonomous system.
route-map set_community 10 permit
route-map set_community 20 permit
Related Commands
Command
|
Description
|
ip community-list
|
Creates a community list for BGP and control access to it.
|
match community
|
Matches a BGP community.
|
route-map (IP)
|
Defines the conditions for redistributing routes from one routing protocol into another, or enables policy routing.
|
set comm-list delete
|
Removes communities from the community attribute of an inbound or outbound update.
|
show ip bgp community
|
Displays routes that belong to specified BGP communities.
|
set extcommunity
To set Border Gateway Protocol (BGP) extended community attributes, use the set extcommunity command in route-map configuration mode. To delete the entry, use the no form of this command.
set extcommunity {rt as-number:network-number ip-address:network-number [additive] | soo
as-number:network-number ip-address:network-number}
no set extcommunity {rt as-number:network-number ip-address:network-number [additive] | soo
as-number:network-number ip-address:network-number}
Syntax Description
rt
|
Specifies the route target (RT) extended community attribute.
|
soo
|
Specifies the site of origin (SOO) extended community attribute.
|
as-number:network-number
|
Specifies autonomous system number and network number of the route target or site of origin. The colon is used to separate the autonomous-system number and network number arguments.
|
ip-address:network number
|
Specifies IP address and network number of the route target or site of origin. The colon is used to separate the IP address and network number arguments
|
additive
|
(Optional) Adds a route target to the existing route target list without replacing any existing route targets.
|
Defaults
Specifying new route targets with the rt keyword replaces existing route targets by default, unless the additive keyword is used. The use of the additive keyword adds the new route target to the existing route target list but does not replace any existing route targets.
Command Modes
Route-map configuration
Command History
Release
|
Modification
|
12.1
|
This command was introduced.
|
Usage Guidelines
Extended community attributes are used to configure, filter, and identify routes for virtual routing and forwarding instances (VRFs) and Multiprotocol Label Switching (MPLS) Virtual Private Networks (VPNs).
The set extcommunity command is used to configure set clauses that use extended community attributes in route maps. All of the standard rules of match and set clauses apply to the configuration of extended community attributes.
The route target (RT) extended community attribute is configured with the rt keyword. This attribute is used to identify a set of sites and VRFs that may receive routes that are tagged with the configured route target. Configuring the route target extended attribute with a route allows that route to be placed in the per-site forwarding tables that are used for routing traffic that is received from corresponding sites.
The site of origin (SOO) extended community attribute is configured with the soo keyword. This attribute uniquely identifies the site from which the Provider Edge (PE) router learned the route. All routes learned from a particular site must be assigned the same SOO extended community attribute, whether a site is connected to a single PE router or multiple PE routers. Configuring this attribute prevents routing loops from occurring when a site is multihomed. The SOO extended community attribute is configured on the interface and is propagated into BGP through redistribution. The SOO can be applied to routes that are learned from VRFs. The SOO should not be configured for stub sites or sites that are not multihomed.
Examples
The following example sets the route target to extended community attribute 100:2 for routes that are permitted by the route map:
Router(config)# access-list 2 permit 192.168.78.0 255.255.255.0
Router(config)# route-map MAP_NAME permit 10
Router(config-route-map)# match ip-address 2
Router(config-route-map)# set extcommunity rt 100:2
The following example sets the route target to extended community attribute 100:3 for routes that are permitted by the route map. The use of the additive keyword adds route target 100:3 to the existing route target list but does not replace any existing route targets.
Router(config)# access-list 3 permit 192.168.79.0 255.255.255.0
Router(config)# route-map MAP_NAME permit 10
Router(config-route-map)# match ip-address 3
Router(config-route-map)# set extcommunity rt 100:3 additive
Note
Configuring route targets with the set extcommunity command will replace existing route targets, unless the additive keyword is used.
The following example sets the site of origin to extended community attribute 100:4 for routes that are permitted by the route map:
Router(config)# access-list 4 permit 192.168.80.0 255.255.255.0
Router(config)# route-map MAP_NAME permit 10
Router(config-route-map)# match ip-address 4
Router(config-route-map)# set extcommunity soo 100:4
Related Commands
Command
|
Description
|
ip extcommunity-list
|
Creates an extended community list and control access to it.
|
match extcommunity
|
Matches a BGP VPN extended community list.
|
route-map (IP)
|
Defines the conditions for redistributing routes from one routing protocol into another, or enables policy routing.
|
route-target
|
Creates a route target extended community for a VRF.
|
show ip extcommunity-list
|
Displays routes that are permitted by the extended community list.
|
show route-map
|
Displays all route maps configured or only the one specified.
|
set dampening
To set the Border Gateway Protocol (BGP) route dampening factors, use the set dampening command in route-map configuration mode. 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.
|
Defaults
This command is disabled by default.
Command Modes
Route-map configuration
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
Usage Guidelines
Use the route-map global configuration command, and the match and set route-map configuration commands, to define the conditions for redistributing routes from one routing protocol into another. Each route-map command has a list of match and set commands associated with it. The match commands specify the match criteria—the conditions under which redistribution is allowed for the current route-map command. The set commands specify the set actions—the particular redistribution actions to perform if the criteria enforced by the match commands are met. The no route-map command deletes the route map.
When a BGP peer is reset, the route is withdrawn and the flap statistics cleared. In this instance, the withdrawal does not incur a penalty even though route flap dampening is enabled.
Examples
The following example sets the half-life to 30 minutes, the reuse value to 1500, the suppress value to 10000; and the maximum suppress time to 120 minutes:
set dampening 30 1500 10000 120
neighbor 172.16.233.52 route-map tag in
Related Commands
Command
|
Description
|
match as-path
|
Matches a BGP autonomous system path access list.
|
match community
|
Matches a BGP community.
|
match interface (IP)
|
Distributes routes that have their next hop out one of the interfaces specified.
|
match ip address
|
Distributes any routes that have a destination network number address that is permitted by a standard or extended access list, and performs policy routing on packets.
|
match ip next-hop
|
Redistributes any routes that have a next-hop router address passed by one of the access lists specified.
|
match ip route-source
|
Redistributes routes that have been advertised by routers and access servers at the address specified by the access lists.
|
match metric
|
Redistributes routes with the metric specified.
|
match route-type (IP)
|
Redistributes routes of the specified type.
|
match tag
|
Redistributes routes in the routing table that match the specified tags.
|
route-map (IP)
|
Defines the conditions for redistributing routes from one routing protocol into another, or enables policy routing.
|
set automatic-tag
|
Automatically computes the tag value.
|
set community
|
Sets the BGP COMMUNITIES attribute.
|
set level (IP)
|
Indicates where to import routes.
|
set local-preference
|
Specifies a preference value for the autonomous system path.
|
set metric (BGP, OSPF, RIP)
|
Sets the metric value for a routing protocol.
|
set metric-type
|
Sets the metric type for the destination routing protocol.
|
set next-hop
|
Specifies the address of the next hop.
|
set origin (BGP)
|
Sets the BGP origin code.
|
set tag (IP)
|
Sets the value of the destination routing protocol.
|
set weight
|
Specifies the BGP weight for the routing table.
|
show route-map
|
Displays all route maps configured or only the one specified.
|
set extcommunity
To set Border Gateway Protocol (BGP) extended community attributes, use the set extcommunity command in route-map configuration mode. To delete the entry, use the no form of this command.
set extcommunity {rt extended-community-value [additive] | soo extended-community-value}
no set extcommunity {rt extended-community-value [additive] | soo extended-community-value}
Syntax Description
rt
|
Specifies the route target (RT) extended community attribute.
|
soo
|
Specifies the site of origin (SOO) extended community attribute.
|
extended-community-value
|
Specifies the value to be set. The value can be one of the following combinations:
• autonomous-system-number : network-number
• ip-address : network-number
The colon is used to separate the autonomous system number and network number or IP address and network number.
|
additive
|
(Optional) Adds a route target to the existing route target list without replacing any existing route targets.
|
Defaults
Specifying new route targets with the rt keyword replaces existing route targets by default, unless the additive keyword is used. The use of the additive keyword adds the new route target to the existing route target list but does not replace any existing route targets.
Command Modes
Route-map configuration
Command History
Release
|
Modification
|
12.1
|
This command was introduced.
|
Usage Guidelines
Extended community attributes are used to configure, filter, and identify routes for virtual routing and forwarding instances (VRFs) and Multiprotocol Label Switching (MPLS) Virtual Private Networks (VPNs).
The set extcommunity command is used to configure set clauses that use extended community attributes in route maps. All of the standard rules of match and set clauses apply to the configuration of extended community attributes.
The route target (RT) extended community attribute is configured with the rt keyword. This attribute is used to identify a set of sites and VRFs that may receive routes that are tagged with the configured route target. Configuring the route target extended attribute with a route allows that route to be placed in the per-site forwarding tables that are used for routing traffic that is received from corresponding sites.
The site of origin (SOO) extended community attribute is configured with the soo keyword. This attribute uniquely identifies the site from which the Provider Edge (PE) router learned the route. All routes learned from a particular site must be assigned the same SOO extended community attribute, whether a site is connected to a single PE router or multiple PE routers. Configuring this attribute prevents routing loops from occurring when a site is multihomed. The SOO extended community attribute is configured on the interface and is propagated into BGP through redistribution. The SOO can be applied to routes that are learned from VRFs. The SOO should not be configured for stub sites or sites that are not multihomed.
Examples
The following example sets the route target to extended community attribute 100:2 for routes that are permitted by the route map:
Router(config)# access-list 2 permit 192.168.78.0 255.255.255.0
Router(config)# route-map MAP_NAME permit 10
Router(config-route-map)# match ip-address 2
Router(config-route-map)# set extcommunity rt 100:2
The following example sets the route target to extended community attribute 100:3 for routes that are permitted by the route map. The use of the additive keyword adds route target 100:3 to the existing route target list but does not replace any existing route targets.
Router(config)# access-list 3 permit 192.168.79.0 255.255.255.0
Router(config)# route-map MAP_NAME permit 10
Router(config-route-map)# match ip-address 3
Router(config-route-map)# set extcommunity rt 100:3 additive
Note
Configuring route targets with the set extcommunity command will replace existing route targets, unless the additive keyword is used.
The following example sets the site of origin to extended community attribute 100:4 for routes that are permitted by the route map:
Router(config)# access-list 4 permit 192.168.80.0 255.255.255.0
Router(config)# route-map MAP_NAME permit 10
Router(config-route-map)# match ip-address 4
Router(config-route-map)# set extcommunity soo 100:4
Related Commands
Command
|
Description
|
ip extcommunity-list
|
Creates an extended community list and control access to it.
|
match community
|
Matches a BGP VPN extended community list.
|
route-map (IP)
|
Defines the conditions for redistributing routes from one routing protocol into another, or enables policy routing.
|
route-target
|
Creates a route target extended community for a VRF.
|
show ip extcommunity-list
|
Displays routes that are permitted by the extended community list.
|
show route-map
|
Displays all route maps configured or only the one specified.
|
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 command in route-map configuration mode. 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. The next hop must be an adjacent router.
|
peer-address
|
(Optional) Sets the next hop to be the BGP peering address.
|
Defaults
This command is disabled by default.
Command Modes
Route-map configuration
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
12.0
|
The keyword peer-address was added.
|
Usage Guidelines
Use the ip policy route-map interface configuration command, the route-map global configuration command, and the match and set route-map configuration commands, to define the conditions for policy routing packets. The ip policy route-map command identifies a route map by name. Each route-map command has a list of match and set commands associated with it. The match commands specify the match criteria—the conditions under which policy routing occurs. The set commands specify the set actions—the particular routing actions to perform if the criteria enforced by the match commands are met.
If the interface associated with the first next hop specified with the set ip next-hop command is down, the optionally specified IP addresses are tried in turn.
When set ip next-hop is used with the peer-address keyword in an inbound route map of a BGP peer, the next hop of the received matching routes will be set to be the neighbor peering address, overriding any third-party next hops. This means that the same route map can be applied to multiple BGP peers to override third-party next hops.
When set ip next-hop is used with the peer-address keyword in an outbound route map of a BGP peer, the next hop of the advertised matching routes will be set to be the peering address of the local router, thus disabling the next hop calculation. The set ip next-hop command has finer granularity than the per-neighbor neighbor next-hop-self command, because you can set the next hop for some routes, but not others. The neighbor next-hop-self command sets the next hop for all routes sent to that neighbor.
The set clauses can be used in conjunction with one another. They are evaluated in the following order:
1.
set ip next-hop
2.
set interface
3.
set ip default next-hop
4.
set default interface
Examples
In the following example, three routers are on the same FDDI LAN (with IP addresses 10.1.1.1, 10.1.1.2, and 10.1.1.3). Each is in a different autonomous system. The set ip next-hop peer-address command specifies that traffic from the router (10.1.1.3) in remote autonomous system 300 for the router (10.1.1.1) in remote autonomous system 100 that matches the route map is passed through the router bgp 200, rather than sent directly to the router (10.1.1.1) in autonomous system 100 over their mutual connection to the LAN:
neighbor 10.1.1.3 remote-as 100
neighbor 10.1.1.3 route-map set-peer-address out
neighbor 10.1.1.1 remote-as 100
route-map set-peer-address permit 10
set ip next-hop peer-address
Related Commands
Command
|
Description
|
ip policy route-map
|
Identifies a route map to use for policy routing on an interface.
|
match ip address
|
Distributes any routes that have a destination network number address that is permitted by a standard or extended access list, and performs policy routing on packets.
|
match length
|
Bases policy routing on the Level 3 length of a packet.
|
neighbor next-hop-self
|
Disables next-hop processing of BGP updates on the router.
|
route-map
|
Defines the conditions for redistributing routes from one routing protocol to another, or enables policy routing.
|
set default interface
|
Indicates where to output packets that pass a match clause of a route map for policy routing and that have no explicit route to the destination.
|
set interface
|
Indicates where to output packets that pass a match clause of a route map for policy routing.
|
set ip default next-hop
|
Indicates where to output packets that pass a match clause of a route map for policy routing and for which the Cisco IOS software has no explicit route to a destination.
|
set metric-type internal
To set the Multi Exit Discriminator (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 command in route-map configuration mode. 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.
Defaults
This command is disabled by default.
Command Modes
Route-map configuration
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
Usage Guidelines
This command will cause BGP to advertise a MED that corresponds to the IGP metric associated with the next hop of the route. This command applies to generated, IBGP-, and EBGP-derived routes.
If this command is used, multiple BGP speakers in a common autonomous system (AS) can advertise different MEDs for a particular prefix. Also, note that if the IGP metric changes, BGP will readvertise the route every 10 minutes.
Use the route-map global configuration command, and the match and set route-map configuration commands, to define the conditions for redistributing routes from one routing protocol into another. Each route-map command has a list of match and set commands associated with it. The match commands specify the match criteria—the conditions under which redistribution is allowed for the current route-map command. The set commands specify the set actions—the particular redistribution actions to perform if the criteria enforced by the match commands are met. The no route-map command deletes the route map.
The set route-map configuration commands specify the redistribution set actions to be performed when all of a route map's match criteria are met. When all match criteria are met, all set actions are performed.
Note
This command is not supported for redistributing routes into Border Gateway Protocol (BGP).
Examples
In the following example, the MED for all the advertised routes to neighbor 172.16.2.3 is set to the corresponding IGP metric of the nexthop:
neighbor 172.16.2.3 remote-as 200
neighbor 172.16.2.3 route-map setMED out
route-map setMED permit 10
ip as-path access-list 1 permit .*
Related Commands
Command
|
Description
|
route-map (IP)
|
Defines the conditions for redistributing routes from one routing protocol into another, or enables policy routing.
|
set origin (BGP)
To set the Border Gateway Protocol (BGP) origin code, use the set origin command in route-map configuration mode. 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.
|
Defaults
Default origin, based on route in main IP routing table.
Command Modes
Route-map configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
You must have a match clause (even if it points to a "permit everything" list) if you want to set tags.
Use the route-map global configuration command, and the match and set route-map configuration commands, to define the conditions for redistributing routes from one routing protocol into another. Each route-map command has a list of match and set commands associated with it. The match commands specify the match criteria—the conditions under which redistribution is allowed for the current route-map command. The set commands specify the set actions—the particular redistribution actions to perform if the criteria enforced by the match commands are met. The no route-map command deletes the route map.
The set route-map configuration commands specify the redistribution set actions to be performed when all of the match criteria of a route map are met. When all match criteria are met, all set actions are performed.
Examples
The following example sets the origin of routes that pass the route map to IGP:
Related Commands
Command
|
Description
|
match as-path
|
Matches a BGP autonomous system path access list.
|
match community
|
Matches a BGP community.
|
match interface (IP)
|
Distributes routes that have their next hop out one of the interfaces specified.
|
match ip address
|
Distributes any routes that have a destination network number address that is permitted by a standard or extended access list, and performs policy routing on packets.
|
match ip next-hop
|
Redistributes any routes that have a next-hop router address passed by one of the access lists specified.
|
match ip route-source
|
Redistributes routes that have been advertised by routers and access servers at the address specified by the access lists.
|
match metric
|
Redistributes routes with the metric specified.
|
match route-type (IP)
|
Redistributes routes of the specified type.
|
match tag
|
Redistributes routes in the routing table that match the specified tags.
|
route-map (IP)
|
Defines the conditions for redistributing routes from one routing protocol into another, or enables policy routing.
|
set as-path
|
Modifies an autonomous system path for BGP routes.
|
set automatic-tag
|
Automatically computes the tag value in a route map configuration.
|
set community
|
Sets the BGP COMMUNITIES attribute.
|
set level (IP)
|
Indicates where to import routes.
|
set local-preference
|
Specifies a preference value for the autonomous system path.
|
set metric
|
Sets the metric value for a routing protocol.
|
set metric-type
|
Sets the metric type for the destination routing protocol.
|
set next-hop
|
Specifies the address of the next hop.
|
set tag (IP)
|
Sets the value of the destination routing protocol.
|
set weight
|
Specifies the BGP weight for the routing table.
|
set weight
To specify the Border Gateway Protocol (BGP) weight for the routing table, use the set weight command in route-map configuration mode. 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.
|
Defaults
The weight is not changed by the specified route map.
Command Modes
Route-map configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
The implemented weight is based on the first matched autonomous system path. Weights indicated when an autonomous system path is matched override the weights assigned by global neighbor commands. In other words, the weights assigned with the set weight route-map configuration command override the weights assigned using the neighbor weight command.
Examples
The following example sets the BGP weight for the routes matching the autonomous system path access list to 200:
Related Commands
Command
|
Description
|
match as-path
|
Matches a BGP autonomous system path access list.
|
match community
|
Matches a BGP community.
|
match interface (IP)
|
Distributes routes that have their next hop out one of the interfaces specified.
|
match ip address
|
Distributes any routes that have a destination network number address that is permitted by a standard or extended access list, and performs policy routing on packets.
|
match ip next-hop
|
Redistributes any routes that have a next-hop router address passed by one of the access lists specified.
|
match ip route-source
|
Redistributes routes that have been advertised by routers and access servers at the address specified by the access lists.
|
match metric
|
Redistributes routes with the metric specified.
|
match route-type (IP)
|
Redistributes routes of the specified type.
|
match tag
|
Redistributes routes in the routing table that match the specified tags.
|
route-map (IP)
|
Defines the conditions for redistributing routes from one routing protocol into another, or enables policy routing.
|
set as-path
|
Modifies an autonomous system path for BGP routes.
|
set automatic-tag
|
Automatically computes the tag value in a route map configuration.
|
set community
|
Sets the BGP COMMUNITIES attribute.
|
set level (IP)
|
Indicates where to import routes.
|
set local-preference
|
Specifies a preference value for the autonomous system path.
|
set metric
|
Sets the metric value for a routing protocol.
|
set metric-type
|
Sets the metric type for the destination routing protocol.
|
set next-hop
|
Specifies the address of the next hop.
|
set origin (BGP)
|
Sets the BGP origin code.
|
set tag (IP)
|
Sets the value of the destination routing protocol.
|
show ip bgp
To display entries in the Border Gateway Protocol (BGP) routing table, use the show ip bgp command in EXEC mode.
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.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
12.0
|
The display of prefix advertisement statistics was added.
|
12.0(6)T
|
The display of a message indicating support for route refresh capability was added.
|
Examples
The following is sample output from the show ip bgp command in privileged EXEC mode:
BGP table version is 5, local router ID is 10.0.33.34
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 1.0.0.0 0.0.0.0 0 32768 ?
* 2.0.0.0 10.0.33.35 10 0 35 ?
* 10.0.0.0 10.0.33.35 10 0 35 ?
*> 192.168.0.0/16 10.0.33.35 10 0 35 ?
Table 72 describes the significant fields shown in the display.
Table 72 show ip bgp Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
IP address of the router.
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
s—The table entry is suppressed.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP session.
|
Origin codes
|
Indicates the origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
e—Entry originated from an Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear Usually, this is a router that is redistributed into BGP from an IGP.
|
Network
|
IP address of a network entity.
|
Next Hop
|
IP address of the next system that is used when forwarding a packet to the destination network. An entry of 0.0.0.0 indicates that the router has some non-BGP routes to this network.
|
Metric
|
If shown, the value of the interautonomous system metric.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
The following is sample output from the show ip bgp command in privileged EXEC mode when you specify the longer-prefixes keyword:
Router# show ip bgp 172.16.0.0 255.255.0.0 longer-prefixes
BGP table version is 1738, local router ID is 172.16.72.24
Status codes: s suppressed, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 172.16.0.0 172.16.72.30 8896 32768 ?
* 172.16.72.30 0 109 108 ?
*> 172.16.1.0 172.16.72.30 8796 32768 ?
* 172.16.72.30 0 109 108 ?
*> 172.16.11.0 172.16.72.30 42482 32768 ?
* 172.16.72.30 0 109 108 ?
*> 172.16.14.0 172.16.72.30 8796 32768 ?
* 172.16.72.30 0 109 108 ?
*> 172.16.15.0 172.16.72.30 8696 32768 ?
* 172.16.72.30 0 109 108 ?
*> 172.16.16.0 172.16.72.30 1400 32768 ?
* 172.16.72.30 0 109 108 ?
*> 172.16.17.0 172.16.72.30 1400 32768 ?
* 172.16.72.30 0 109 108 ?
*> 172.16.18.0 172.16.72.30 8876 32768 ?
* 172.16.72.30 0 109 108 ?
*> 172.16.19.0 172.16.72.30 8876 32768 ?
* 172.16.72.30 0 109 108 ?
The following is sample output from the show ip bgp command in privileged EXEC mode, showing information for prefix 3.0.0.0:
Router# show ip bgp 3.0.0.0
BGP routing table entry for 3.0.0.0/8, version 628
Paths: (1 available, best #1)
Advertised to peer-groups:
Advertised to non peer-group peers:
172.16.233.56 from 172.16.233.56 (172.19.185.32)
Origin incomplete, localpref 100, valid, external, best, ref 2
Note
If a prefix has not been advertised to any peer, the display shows "Not advertised to any peer."
Related Commands
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 command in EXEC mode.
show ip bgp cidr-only
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Examples
The following is sample output from the show ip bgp cidr-only command in privileged EXEC mode:
Router# show ip bgp cidr-only
BGP table version is 220, local router ID is 172.16.73.131
Status codes: s suppressed, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 192.168.0.0/8 172.16.72.24 0 1878 ?
*> 172.16.0.0/16 172.16.72.30 0 108 ?
Table 73 describes the significant fields shown in the display.
Table 73 show ip bgp cidr-only Field Descriptions
Field
|
Description
|
BGP table version is 220
|
Internal version number of the table. This number is incremented any time the table changes.
|
local router ID
|
IP address of the router.
|
Status codes
|
s—The table entry is suppressed.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP session.
|
Origin codes
|
Indicates the origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
e—Entry originated from an Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear Usually, this is a router that is redistributed into BGP from an IGP.
|
Network
|
Internet address of the network the entry describes.
|
Next Hop
|
IP address of the next system that is used when forwarding a packet to the destination network. An entry of 0.0.0.0 indicates that the access server has some non-BGP route to this network.
|
Metric
|
If shown, the value of the interautonomous system metric.
|
LocPrf
|
Local preference value. Default is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path. At the end of the path is the origin code for the path.
i—The entry was originated with the IGP and advertised with a network router configuration command.
e—The route originated with EGP.
?—The origin of the path is not clear. Usually this is a path that is redistributed into BGP from an IGP.
|
show ip bgp community
To display routes that belong to specified Border Gateway Protocol (BGP) communities, use the show ip bgp community command in EXEC mode.
show ip bgp community community-number [exact]
Syntax Description
community-number
|
Valid value is a 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.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
12.0
|
The local-as community was added.
|
Examples
The following is sample output from the show ip bgp community command in privileged EXEC mode:
router# show ip bgp community 111:12345 local-as
BGP table version is 10, local router ID is 224.0.0.10
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 172.16.2.2/32 172.43.222.2 0 0 222 ?
*> 10.0.0.0 172.43.222.2 0 0 222 ?
*> 172.43.0.0 172.43.222.2 0 0 222 ?
*> 172.43.44.44/32 172.43.222.2 0 0 222 ?
* 172.43.222.0/24 172.43.222.2 0 0 222 i
*> 172.17.240.0/21 172.43.222.2 0 0 222 ?
*> 192.168.212.0 172.43.222.2 0 0 222 i
*> 172.39.1.0 172.43.222.2 0 0 222 ?
Table 74 describes the significant fields shown in the display.
Table 74 show ip bgp community Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
IP address of the router.
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
s—The table entry is suppressed.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP session.
|
Origin codes
|
Indicates the origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
e—Entry originated from an Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear Usually, this is a router that is redistributed into BGP from an IGP.
|
Network
|
IP address of a network entity.
|
Next Hop
|
IP address of the next system that is used when forwarding a packet to the destination network. An entry of 0.0.0.0 indicates that the router has some non-BGP routes to this network.
|
Metric
|
If shown, this is the value of the interautonomous system metric. This field is frequently not used.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
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 command in EXEC mode.
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.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
Examples
The following is sample output of the show ip bgp community-list command in privileged EXEC mode:
Router# show ip bgp community-list 20
BGP table version is 716977, local router ID is 193.0.32.1
Status codes: s suppressed, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
* i3.0.0.0 193.0.22.1 0 100 0 1800 1239 ?
*>i 193.0.16.1 0 100 0 1800 1239 ?
* i6.0.0.0 193.0.22.1 0 100 0 1800 690 568 ?
*>i 193.0.16.1 0 100 0 1800 690 568 ?
* i7.0.0.0 193.0.22.1 0 100 0 1800 701 35 ?
*>i 193.0.16.1 0 100 0 1800 701 35 ?
* 172.16.72.24 0 1878 704 701 35 ?
* i8.0.0.0 193.0.22.1 0 100 0 1800 690 560 ?
*>i 193.0.16.1 0 100 0 1800 690 560 ?
* 172.16.72.24 0 1878 704 701 560 ?
* i13.0.0.0 193.0.22.1 0 100 0 1800 690 200 ?
*>i 193.0.16.1 0 100 0 1800 690 200 ?
* 172.16.72.24 0 1878 704 701 200 ?
* i15.0.0.0 193.0.22.1 0 100 0 1800 174 ?
*>i 193.0.16.1 0 100 0 1800 174 ?
* i16.0.0.0 193.0.22.1 0 100 0 1800 701 i
*>i 193.0.16.1 0 100 0 1800 701 i
* 172.16.72.24 0 1878 704 701 i
Table 75 describes significant fields shown in the display.
Table 75 show ip bgp community list Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
IP address of the router.
|
Status codes
|
Status of the table entry. The status is displayed at the beginning of each line in the table. It can be one of the following values:
s—The table entry is suppressed.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP session.
|
Origin codes
|
Indicates the origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
e—Entry originated from an Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear Usually, this is a router that is redistributed into BGP from an IGP.
|
Network
|
IP address of a network entity.
|
Next Hop
|
IP address of the next system that is used when forwarding a packet to the destination network. An entry of 0.0.0.0 indicates that the router has some non-BGP routes to this network.
|
Metric
|
If shown, this is the value of the interautonomous system metric. This field is frequently not used.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
show ip bgp dampened-paths
To display Border Gateway Protocol (BGP) dampened routes, use the show ip bgp dampened-paths command in EXEC mode.
show ip bgp dampened-paths
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
Examples
The following is sample output from the show ip bgp dampened-paths command in privileged EXEC mode:
Router# show ip bgp dampened-paths
BGP table version is 10, local router ID is 172.16.232.182
Status codes: s suppressed, d damped, h history, * valid, > best, i -
Origin codes: i - IGP, e - EGP, ? - incomplete
*d 10.0.0.0 172.16.232.177 00:18:4 100 ?
*d 12.0.0.0 172.16.232.177 00:28:5 100 ?
Table 76 describes the fields in the display.
Table 76 show ip bgp dampened-paths Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented any time the table changes.
|
local router
|
IP address of the router where route dampening is enabled.
|
*d Network
|
Route to the network indicated is dampened.
|
From
|
IP address of the peer that advertised this path.
|
Reuse
|
Time (in hours:minutes:seconds) after which the path will be made available.
|
Path
|
AS-path of the route that is being dampened.
|
Related Commands
Command
|
Description
|
bgp dampening
|
Enables BGP route dampening or changes various BGP route dampening factors.
|
clear ip bgp dampening
|
Clears BGP route dampening information and unsuppresses the suppressed routes.
|
show ip extcommunity-list
To display routes that are permitted by an extended community list, use the show ip extcommunity-list command in EXEC mode.
show ip extcommunity-list [community-list-number]
Syntax Description
community-list-number
|
(Optional) Community list number in the range from 1 to 199. A standard extended list is from 1 to 99. An expanded extended list is from 100 to 199.
|
Defaults
If a specific extended community list number is not specified when the show ip extcommunity-list command is entered, all locally configured extended community lists will be displayed by default.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.1
|
This command was introduced.
|
Examples
The following is sample output from the show ip extcommunity-list command in EXEC mode:
Router# show ip extcommunity-list
Extended community standard list 1
deny RT:703:30 SoO:604:40
Extended community standard list 99
permit RT:604:40 SoO:505:50
deny RT:406:60 SoO:307:70
Related Commands
Command
|
Description
|
show route-map
|
Displays configured route maps.
|
show ip bgp filter-list
To display routes that conform to a specified filter list, use the show ip bgp filter-list command in EXEC mode.
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.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Examples
The following is sample output from the show ip bgp filter-list command in privileged EXEC mode:
Router# show ip bgp filter-list 2
BGP table version is 1738, local router ID is 172.16.72.24
Status codes: s suppressed, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
* 172.16.0.0 172.16.72.30 0 109 108 ?
* 172.16.1.0 172.16.72.30 0 109 108 ?
* 172.16.11.0 172.16.72.30 0 109 108 ?
* 172.16.14.0 172.16.72.30 0 109 108 ?
* 172.16.15.0 172.16.72.30 0 109 108 ?
* 172.16.16.0 172.16.72.30 0 109 108 ?
* 172.16.17.0 172.16.72.30 0 109 108 ?
* 172.16.18.0 172.16.72.30 0 109 108 ?
* 172.16.19.0 172.16.72.30 0 109 108 ?
* 172.16.24.0 172.16.72.30 0 109 108 ?
* 172.16.29.0 172.16.72.30 0 109 108 ?
* 172.16.30.0 172.16.72.30 0 109 108 ?
* 172.16.33.0 172.16.72.30 0 109 108 ?
* 172.16.35.0 172.16.72.30 0 109 108 ?
* 172.16.36.0 172.16.72.30 0 109 108 ?
* 172.16.37.0 172.16.72.30 0 109 108 ?
* 172.16.38.0 172.16.72.30 0 109 108 ?
* 172.16.39.0 172.16.72.30 0 109 108 ?
Table 77 describes significant fields shown in the display.
Table 77 show ip bgp filter-list Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented any time the table changes.
|
local router ID
|
IP address of the router.
|
Status codes
|
s—The table entry is suppressed.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP session.
|
Origin codes
|
Indicates the origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
e—Entry originated from an Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear Usually, this is a router that is redistributed into BGP from an IGP.
|
Network
|
Internet address of the network the entry describes.
|
Next Hop
|
IP address of the next system that is used when forwarding a packet to the destination network. An entry of 0.0.0.0 indicates that the router has some non-BGP route to this network.
|
Metric
|
If shown, this is the value of the interautonomous system metric. This field is frequently not used.
|
LocPrf
|
Local preference value. Default is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path. At the end of the path is the origin code for the path.
i—The entry was originated with the IGP and advertised with a network router configuration command.
e—The route originated with EGP.
?—The origin of the path is not clear. Usually this is a path that is redistributed into BGP from an IGP.
|
show ip bgp flap-statistics
To display Border Gateway Protocol (BGP) flap statistics, use the show ip bgp flap-statistics command in EXEC mode.
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.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
Usage Guidelines
If no arguments or keywords are specified, the router displays flap statistics for all routes.
Examples
The following is sample output from the show ip bgp flap-statistics command in privileged EXEC mode:
Router# show ip bgp flap-statistics
BGP table version is 10, local router ID is 172.16.232.182
Status codes: s suppressed, d damped, h history, * valid, > best, i -
Origin codes: i - IGP, e - EGP, ? - incomplete
Network From Flaps Duration Reuse Path
*d 10.0.0.0 172.16.232.177 4 00:13:31 00:18:10 100
*d 12.0.0.0 172.16.232.177 4 00:02:45 00:28:20 100
Table 78 describes the significant fields shown in the display.
Table 78 show ip bgp flap-statistics Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented any time the table changes.
|
local router ID
|
IP address of the router where route dampening is enabled.
|
Network
|
Route to the network indicated is dampened.
|
From
|
IP address of the peer that advertised this path.
|
Flaps
|
Number of times the route has flapped.
|
Duration
|
Time (in hours:minutes:seconds) since the router noticed the first flap.
|
Reuse
|
Time (in hours:minutes:seconds) after which the path will be made available.
|
Path
|
AS-path of the route that is being dampened.
|
Related Commands
show ip bgp inconsistent-as
To display routes with inconsistent originating autonomous systems, use the show ip bgp inconsistent-as command in EXEC mode.
show ip bgp inconsistent-as
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
Examples
The following is sample output from the show ip bgp inconsistent-as command in privileged EXEC mode:
Router# show ip bgp inconsistent-as
BGP table version is 87, local router ID is 172.19.82.53
Status codes: s suppressed, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
* 11.0.0.0 172.16.232.55 0 0 300 88 90 99 ?
*> 172.16.232.52 2222 0 400 ?
* 172.16.0.0 172.16.232.55 0 0 300 90 99 88 200 ?
*> 172.16.232.52 2222 0 400 ?
* 200.200.199.0 172.16.232.55 0 0 300 88 90 99 ?
*> 172.16.232.52 2222 0 400 ?
show ip bgp neighbors
To display information about the TCP and Border Gateway Protocol (BGP) connections to neighbors, use the show ip bgp neighbors command in EXEC mode.
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.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
11.2
|
The received-routes keyword was added.
|
Examples
The following is sample output from the show ip bgp neighbors command in privileged EXEC mode:
Router# show ip bgp neighbors 172.16.232.178
BGP neighbor is 172.16.232.178, remote AS 35, external link
BGP version 4, remote router ID 192.168.3.3
BGP state = Established, up for 1w1d
Last read 00:00:53, hold time is 180, keepalive interval is 60 seconds
Route refresh: advertised and received
Address family IPv4 Unicast: advertised and received
Address family IPv4 Multicast: advertised and received
Received 12519 messages, 0 notifications, 0 in queue
Sent 12523 messages, 0 notifications, 0 in queue
Route refresh request: received 0, sent 0
Minimum time between advertisement runs is 30 seconds
For address family: IPv4 Unicast
BGP table version 5, neighbor version 5
Index 1, Offset 0, Mask 0x2
Community attribute sent to this neighbor
Inbound path policy configured
Outbound path policy configured
Route map for incoming advertisements is uni-in
Route map for outgoing advertisements is uni-out
3 accepted prefixes consume 108 bytes
Prefix advertised 6, suppressed 0, withdrawn 0
For address family: IPv4 Multicast
BGP table version 5, neighbor version 5
Index 1, Offset 0, Mask 0x2
Inbound path policy configured
Outbound path policy configured
Route map for incoming advertisements is mul-in
Route map for outgoing advertisements is mul-out
3 accepted prefixes consume 108 bytes
Prefix advertised 6, suppressed 0, withdrawn 0
Connections established 2; dropped 1
Last reset 1w1d, due to Peer closed the session
Connection state is ESTAB, I/O status: 1, unread input bytes: 0
Local host: 172.16.232.178, Local port: 179
Foreign host: 172.16.232.179, Foreign port: 11002
Enqueued packets for retransmit: 0, input: 0 mis-ordered: 0 (0 bytes)
Event Timers (current time is 0x2CF49CF8):
Timer Starts Wakeups Next
iss: 273358651 snduna: 273596614 sndnxt: 273596614 sndwnd: 15434
irs: 190480283 rcvnxt: 190718186 rcvwnd: 15491 delrcvwnd: 893
SRTT: 300 ms, RTTO: 607 ms, RTV: 3 ms, KRTT: 0 ms
minRTT: 0 ms, maxRTT: 300 ms, ACK hold: 200 ms
Flags: passive open, nagle, gen tcbs
Datagrams (max data segment is 1460 bytes):
Rcvd: 24889 (out of order: 0), with data: 12515, total data bytes: 237921
Sent: 24963 (retransmit: 0), with data: 12518, total data bytes: 237981
Table 79 describes the fields shown in the display.
Table 79 show ip bgp neighbors Field Descriptions
Field
|
Description
|
BGP neighbor
|
IP address of the BGP neighbor and its autonomous system number. If the neighbor is in the same autonomous system as the router, then the link between them is internal; otherwise, it is considered external.
|
remote AS
|
Autonomous system of the neighbor.
|
external link
|
Indicates that this peer is an Exterior Border Gateway Protocol (EBGP) peer.
|
BGP version
|
BGP version being used to communicate with the remote router; the router ID (an IP address) of the neighbor is also specified.
|
remote router ID
|
IP address of the neighbor.
|
BGP state
|
Internal state of this BGP connection.
|
up for
|
Amount of time that the underlying TCP connection has been in existence.
|
Last read
|
Time that BGP last read a message from this neighbor.
|
hold time
|
Maximum amount of time that can elapse between messages from the peer.
|
keepalive interval
|
Time period between sending keepalive packets, which help ensure that the TCP connection is up.
|
Neighbor capabilities
|
BGP capabilities advertised and received from this neighbor.
|
Route refresh
|
Indicates that the neighbor supports dynamic soft reset using the route refresh capability.
|
Address family IPv4 Unicast:
|
IPv4 unicast-specific properties of this neighbor.
|
Address family IPv4 Multicast:
|
IPv4 multicast-specific properties of this neighbor.
|
Received
|
Number of total BGP messages received from this peer, including keepalives.
|
notifications
|
Number of error messages received from the peer.
|
Sent
|
Total number of BGP messages that have been sent to this peer, including keepalives.
|
notifications
|
Number of error messages the router has sent to this peer.
|
Route refresh request:
|
Number of route refresh requests sent and received from this neighbor.
|
advertisement runs
|
Value of minimum advertisement interval.
|
For address family:
|
Address family to which the following fields refer.
|
BGP table version
|
Indicates that the neighbor has been updated with this version of the primary BGP routing table.
|
neighbor version
|
Number used by the software to track the prefixes that have been sent and those that have to be sent to this neighbor.
|
Community attribute
|
Appears if the neighbor send-community command is configured for this neighbor.
|
Inbound path policy
|
Indicates if an inbound policy is configured.
|
Outbound path policy
|
Indicates if an outbound policy is configured.
|
mul-in
|
Name of inbound route map for the multicast address family.
|
mul-out
|
Name of outbound route map for the multicast address family.
|
accepted prefixes
|
Number of prefixes accepted.
|
Prefix advertised
|
Number of prefixes advertised.
|
suppressed
|
Number of prefixes suppressed.
|
withdrawn
|
Number of prefixes withdrawn.
|
Connections established
|
Number of times the router has established a TCP connection and the two peers have agreed speak BGP with each other.
|
dropped
|
Number of times that a good connection has failed or been taken down.
|
Last reset
|
Elapsed time since this peering session was last reset.
|
Connection state
|
State of BGP peer.
|
unread input bytes
|
Number of bytes of packets still to be processed.
|
Local host, Local port
|
Peering address of local router, plus port.
|
Foreign host, Foreign port
|
Neighbor's peering address.
|
Event Timers
|
Table displays the number of starts and wakeups for each timer.
|
iss
|
Initial send sequence number.
|
snduna
|
Last send sequence number the local host sent but has not received an acknowledgment for.
|
sndnxt
|
Sequence number the local host will send next.
|
sndwnd
|
TCP window size of the remote host.
|
irs
|
Initial receive sequence number.
|
rcvnxt
|
Last receive sequence number the local host has acknowledged.
|
rcvwnd
|
Local host's TCP window size.
|
delrecvwnd
|
Delayed receive window—data the local host has read from the connection, but has not yet subtracted from the receive window the host has advertised to the remote host. The value in this field gradually increases until it is larger than a full-sized packet, at which point it is applied to the rcvwnd field.
|
SRTT
|
A calculated smoothed round-trip timeout.
|
RTTO
|
Round-trip timeout.
|
RTV
|
Variance of the round-trip time.
|
KRTT
|
New round-trip timeout (using the Karn algorithm). This field separately tracks the round-trip time of packets that have been retransmitted.
|
minRTT
|
Smallest recorded round-trip timeout (hard wire value used for calculation).
|
maxRTT
|
Largest recorded round-trip timeout.
|
ACK hold
|
Time the local host will delay an acknowledgment in order to piggyback data on it.
|
Flags
|
IP precedence of the BGP packets.
|
Datagrams: Rcvd
|
Number of update packets received from neighbor.
|
with data
|
Number of update packets received with data.
|
total data bytes
|
Total bytes of data.
|
Sent
|
Number of update packets sent.
|
with data
|
Number of update packets with data sent.
|
total data bytes
|
Total number of data bytes.
|
The following is sample output from the show ip bgp neighbors command with the advertised-routes keyword in privileged EXEC mode:
Router# show ip bgp neighbors 172.16.232.178 advertised-routes
BGP table version is 27, local router ID is 172.16.232.181
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*>i110.0.0.0 172.16.232.179 0 100 0 ?
*> 200.2.2.0 0.0.0.0 0 32768 i
The following is sample output from the show ip bgp neighbors command with the routes keyword in privileged EXEC mode:
Router# show ip bgp neighbors 172.16.232.178 routes
BGP table version is 27, local router ID is 172.16.232.181
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
*> 10.0.0.0 172.16.232.178 40 0 10 ?
*> 10.2.0.0 172.16.232.178 40 0 10 ?
Table 80 describes the fields shown in the display.
Table 80 show ip bgp neighbors advertised-routes and routes Field Descriptions
Field
|
Description
|
BGP table version
|
Internal version number of the table. This number is incremented whenever the table changes.
|
local router ID
|
IP address of the router.
|
Status codes
|
s—The table entry is suppressed.
*—The table entry is valid.
>—The table entry is the best entry to use for that network.
i—The table entry was learned via an internal BGP session.
|
Origin codes
|
Indicates the origin of the entry. The origin code is placed at the end of each line in the table. It can be one of the following values:
i—Entry originated from an Interior Gateway Protocol (IGP) and was advertised with a network router configuration command.
e—Entry originated from an Exterior Gateway Protocol (EGP).
?—Origin of the path is not clear Usually, this is a router that is redistributed into BGP from an IGP.
|
Network
|
IP address of a network entity.
|
Next Hop
|
IP address of the next system that is used when forwarding a packet to the destination network. An entry of 0.0.0.0 indicates that the router has some non-BGP routes to this network.
|
Metric
|
If shown, this is the value of the interautonomous system metric. This field is frequently not used.
|
LocPrf
|
Local preference value as set with the set local-preference route-map configuration command. The default value is 100.
|
Weight
|
Weight of the route as set via autonomous system filters.
|
Path
|
Autonomous system paths to the destination network. There can be one entry in this field for each autonomous system in the path.
|
The following is sample output from the show ip bgp neighbors command with the paths keyword in privileged EXEC mode:
Router# show ip bgp neighbors 172.16.232.178 paths ^10
Address Refcount Metric Path
Table 81 describes the significant fields shown in the display.
Table 81 show ip bgp neighbors paths Field Descriptions
Field
|
Description
|
Address
|
Internal address where the path is stored.
|
Refcount
|
Number of routes using that path.
|
Metric
|
The Multi Exit Discriminator (MED) metric for the path. (The name of this metric for BGP versions 2 and 3 is INTER_AS.)
|
Path
|
The AS_PATH for that route, followed by the origin code for that route.
|
show ip bgp paths
To display all the Border Gateway Protocol (BGP) paths in the database, use the show ip bgp paths command in EXEC mode.
show ip bgp paths
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Examples
The following is sample output from the show ip bgp paths command in privileged EXEC mode:
Router# show ip bgp paths
Address Hash Refcount Metric Path
Table 82 describes the significant fields shown in the display.
Table 82 show ip bgp paths Field Descriptions
Field
|
Description
|
Address
|
Internal address where the path is stored.
|
Hash
|
Hash bucket where path is stored.
|
Refcount
|
Number of routes using that path.
|
Metric
|
The Multi Exit Discriminator (MED) metric for the path. (The name of this metric for BGP versions 2 and 3 is INTER_AS.)
|
Path
|
The AS_PATH for that route, followed by the origin code for that route.
|
show ip bgp peer-group
To display information about Border Gateway Protocol (BGP) peer groups, use the show ip bgp peer-group command in EXEC mode.
show ip bgp peer-group [peer-group-name] [summary]
Syntax Description
peer-group-name
|
(Optional) Displays information about that specific peer group.
|
summary
|
(Optional) Displays a summary of the status of all the members of a peer group.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
Examples
The following is sample output for a peer group named internal in privileged EXEC mode:
Router# show ip bgp peer-group internal
BGP peer-group is internal, remote AS 100
Minimum time between advertisement runs is 5 seconds
For address family:IPv4 Unicast
BGP neighbor is internal, peer-group internal, members:
Index 3, Offset 0, Mask 0x8
Incoming update AS path filter list is 53
Outgoing update AS path filter list is 54
Route map for incoming advertisements is MAP193
Route map for outgoing advertisements is MAP194
Update messages formatted 0, replicated 0
show ip bgp regexp
To display routes matching the autonomous system (AS) path regular expression, use the show ip bgp regexp command in EXEC mode.
show ip bgp regexp regular-expression
Syntax Description
regular-expression
|
Regular expression to match the BGP autonomous system paths.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Examples
The following is sample output from the show ip bgp regexp command in privileged EXEC mode:
Router# show ip bgp regexp 108$
BGP table version is 1738, local router ID is 172.16.72.24
Status codes: s suppressed, * valid, > best, i - internal
Origin codes: i - IGP, e - EGP, ? - incomplete
Network Next Hop Metric LocPrf Weight Path
* 172.16.0.0 172.16.72.30 0 109 108 ?
* 172.16.1.0 172.16.72.30 0 109 108 ?
* 172.16.11.0 172.16.72.30 0 109 108 ?
* 172.16.14.0 172.16.72.30 0 109 108 ?
* 172.16.15.0 172.16.72.30 0 109 108 ?
* 172.16.16.0 172.16.72.30 0 109 108 ?
* 172.16.17.0 172.16.72.30 0 109 108 ?
* 172.16.18.0 172.16.72.30 0 109 108 ?
* 172.16.19.0 172.16.72.30 0 109 108 ?
* 172.16.24.0 172.16.72.30 0 109 108 ?
* 172.16.29.0 172.16.72.30 0 109 108 ?
* 172.16.30.0 172.16.72.30 0 109 108 ?
* 172.16.33.0 172.16.72.30 0 109 108 ?
* 172.16.35.0 172.16.72.30 0 109 108 ?
* 172.16.36.0 172.16.72.30 0 109 108 ?
* 172.16.37.0 172.16.72.30 0 109 108 ?
* 172.16.38.0 172.16.72.30 0 109 108 ?
* 172.16.39.0 172.16.72.30 0 109 108 ?
show ip bgp summary
To display the status of all Border Gateway Protocol (BGP) connections, use the show ip bgp summary command in EXEC mode.
show ip bgp summary
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
12.0
|
The PfxRcd and Admin fields were added to the output.
|
Examples
The following is sample output from the show ip bgp summary command in privileged EXEC mode:
Router# show ip bgp summary
BGP router identifier 172.16.1.1, local AS number 100
BGP table version is 199, main routing table version 199
37 network entries and 59 paths using 5713 bytes of memory
18 BGP path attribute entries using 936 bytes of memory
10 BGP AS-PATH entries using 240 bytes of memory
7 BGP community entries using 168 bytes of memory
0 BGP route-map cache entries using 0 bytes of memory
0 BGP filter-list cache entries using 0 bytes of memory
36 received paths for inbound soft reconfiguration
BGP activity 37/2849 prefixes, 60/1 paths, scan interval 15 secs
Neighbor V AS MsgRcvd MsgSent TblVer InQ OutQ Up/Down State/PfxRcd
10.100.1.1 4 200 26 22 199 0 0 00:14:23 23
10.200.1.1 4 300 21 51 199 0 0 00:13:40 0
Table 83 describes the significant fields shown in the display.
.
Table 83 show ip bgp summary Field Descriptions
Field
|
Description
|
BGP router identifier
|
In order of precedence and availability, router identifier specified by the bgp router-id command, loopback address, or lowest IP address.
|
BGP table version
|
Internal version number of BGP database.
|
main routing table version
|
Last version of BGP database that was injected into main routing table.
|
Neighbor
|
IP address of a neighbor.
|
V
|
BGP version number spoken to that neighbor.
|
AS
|
Autonomous system.
|
MsgRcvd
|
BGP messages received from that neighbor.
|
MsgSent
|
BGP messages sent to that neighbor.
|
TblVer
|
Last version of the BGP database that was sent to that neighbor.
|
InQ
|
Number of messages from that neighbor waiting to be processed.
|
OutQ
|
Number of messages waiting to be sent to that neighbor.
|
Up/Down
|
The length of time that the BGP session has been in state Established, or the current state if it is not Established.
|
State/PfxRcd
|
Current state of the BGP session/the number of prefixes the router has received from a neighbor or peer group. When the maximum number (as set by the neighbor maximum-prefix command) is reached, the string "PfxRcd" appears in the entry, the neighbor is shut down, and the connection is Idle.
An (Admin) entry with Idle status indicates that the connection has been shut down using the neighbor shutdown command.
|
Related Commands
show ip extcommunity-list
To display routes that are permitted by an extended community list, use the show ip extcommunity-list command in EXEC mode.
show ip extcommunity-list [community-list-number]
Syntax Description
community-list-number
|
(Optional) Community list number in the range from 1 to 199. A standard extended list is from 1 to 99. An expanded extended list is from 100 to 199.
|
Defaults
If a specific extended community list number is not specified when the show ip extcommunity-list command is entered, all locally configured extended community lists will be displayed by default.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.1
|
This command was introduced.
|
Examples
The following is sample output from the show ip extcommunity-list command in EXEC mode:
Router# show ip extcommunity-list
Extended community standard list 1
deny RT:703:30 SoO:604:40
Extended community standard list 99
permit RT:604:40 SoO:505:50
deny RT:406:60 SoO:307:70
Related Commands
Command
|
Description
|
show route-map
|
Displays configured route maps.
|
show ip prefix-list
To display information about a prefix list or prefix list entries, use the show ip prefix-list command in EXEC mode.
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
|
(Optional) Displays all entries of a prefix list that are more specific than the given network/len.
|
first-match
|
(Optional) Displays the entry of a prefix list that matches the given network/len.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
12.0
|
This command was introduced.
|
Examples
The following example shows the output of the show ip prefix-list command with details about the prefix list named test in privileged EXEC mode:
Router# show ip prefix-list detail test
Description: test-list
count: 1, range entries: 0, sequences: 10 - 10, refcount: 3
seq 10 permit 10.0.0.0/8 (hit count: 0, refcount: 1)
Related Commands
Command
|
Description
|
clear ip prefix-list
|
Resets the hit count of the prefix list entries.
|
distribute-list in
|
Filters networks received in updates.
|
distribute-list out (BGP)
|
Suppresses networks from being advertised in updates.
|
ip prefix-list
|
Creates an entry in a prefix list.
|
ip prefix-list description
|
Adds a text description of a prefix list.
|
match ip address
|
Distributes any routes that have a destination network number address that is permitted by a standard or extended access list, and performs policy routing on packets.
|
neighbor prefix-list
|
Distributes BGP neighbor information as specified in a prefix list.
|
synchronization
To enable the synchronization between Border Gateway Protocol (BGP) and your Interior Gateway Protocol (IGP) system, use the synchronization command in address family or router configuration mode. 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.
Defaults
The behavior of this command is enabled by default.
Command Modes
Address family configuration
Router configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
12.0(7)T
|
Address family configuration mode was added.
|
Usage Guidelines
Usually, a BGP speaker does not advertise a route to an external neighbor unless that route is local or exists in the IGP. The no synchronization command allows the Cisco IOS software to advertise a network route without waiting for the IGP. This feature allows routers and access servers within an autonomous system to have the route before BGP makes it available to other autonomous systems.
Use the synchronization command if there are routers in the autonomous system that do not speak BGP.
Examples
The following router configuration mode example enables a router to advertise a network route without waiting for the IGP:
The following address family configuration mode example enables a router to advertise a network route without waiting for the IGP:
address-family ipv4 unicast
Related Commands
Command
|
Description
|
address-family ipv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard IPv4 address prefixes.
|
address-family vpnv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard VPNv4 address prefixes.
|
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 command in address family or router configuration mode. 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.
|
Defaults
This command is disabled by default.
Command Modes
Address family configuration
Router configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
12.0(7)T
|
Address family configuration mode was added.
|
Usage Guidelines
This command adds the route-map name defined by the route-map command to the IP routing table. This command is used to set the tag name and the route metric to implement redistribution.
You can use match clauses of route maps in the table-map command. IP access list, autonomous system paths, and next-hop match clauses are supported.
Examples
In the following router configuration mode example, the Cisco IOS software is configured to automatically compute the tag value for the BGP learned routes and to update the IP routing table:
In the following address family configuration mode example, the Cisco IOS software is configured to automatically compute the tag value for the BGP learned routes and to update the IP routing table:
address-family ipv4 unicast
Related Commands
Command
|
Description
|
address-family ipv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard IPv4 address prefixes.
|
address-family vpnv4
|
Places the router in address family configuration mode for configuring routing sessions such as BGP, RIP, or static routing sessions that use standard VPNv4 address prefixes.
|
match as-path
|
Matches a BGP autonomous system path access list.
|
match ip address
|
Distributes any routes that have a destination network number address that is permitted by a standard or extended access list, and performs policy routing on packets.
|
match ip next-hop
|
Redistributes any routes that have a next hop router address passed by one of the access lists specified.
|
route-map (IP)
|
Defines the conditions for redistributing routes from one routing protocol into another, or enables policy routing.
|
timers bgp
To adjust Border Gateway Protocol (BGP) network timers, use the timers bgp command in router configuration mode. 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.
|
Defaults
keepalive: 60 seconds
holdtime: 180 seconds
Command Modes
Router configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Examples
The following example changes the keepalive timer to 70 seconds and the holdtime timer to 210 seconds:
Related Commands