6.7. BGP Commands
6.7.1. address-family
Command Purpose
Use this command to enter the IPv4, VPNv4 address-family command mode.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
address-family ipv4 ( unicast | vrf NAME | )
address-family vpnv4 ( unicast )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
vpnv4 |
Configures sessions for VPN-IPv4 prefixes. This parameter takes an IPv4 style address: A.B.C.D. |
- |
unicast |
Specifies unicast prefixes |
- |
vrf |
VPN routing/forwarding instance |
- |
NAME |
VPN Routing/Forwarding instance name |
Up to 15 characters |
Command Mode
Router Configuration
Default
None
Usage
Use the address family command to enter the address family mode allowing configuration of address-family specific parameters.
To leave the address family mode and return to the Configure mode use the exit-address-family command.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)#address-family ipv4
6.7.2. aggregate-address
Command Purpose
Use this command to configure BGP aggregate entries.
Use the no parameter with this command to disable this function.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
( no ) aggregate-address IP_PREFIX { summary-only | as-set }
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
IP_PREFIX |
A.B.C.D/M Specifies the aggregate prefix |
IPv4 Address and mask length in A.B.C.D/M format |
summary-only |
Filters more specific routes from updates. |
- |
as-set |
Generates AS set path information |
- |
Command Mode
Router Configuration
Default
Disabled
Usage
Aggregates are used to minimize the size of routing tables. Aggregation combines the characteristics of several different routes and advertises a single route.The aggregate-address command creates an aggregate entry in the BGP routing table if any more-specific BGP routes are available in the specified range. Using the summary-only parameter advertises the prefix only, suppressing the more-specific routes to all neighbors.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# aggregate-address 10.0.0.0/8 as-set summary-only
Related Commands
N/A
6.7.3. bgp always-compare-med
Command Purpose
Use this command to compare the Multi Exit Discriminator (MED) for paths from neighbors in different autonomous systems.
Use the no parameter with this command to disallow the comparison.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
( no ) bgp always-compare-med
Command Mode
Router Configuration
Default
Disabled
Usage
Multi Exit Discriminator (MED) is used in best path selection by BGP. MED is compared after BGP attributes weight, local preference, AS-path and origin have been compared and are equal.
MED comparison is done only among paths from the same autonomous system (AS). Use bgp always-comparemed command to allow comparison of MEDs from different ASs. The MED parameter is used to select the best path. A path with lower MED is preferred.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# bgp always-compare-med
Related Commands
bgp bestpath med
bgp bestpath as-path ignore
6.7.4. bgp bestpath as-path ignore
Command Purpose
Use this command to prevent the router from considering as-path as a factor in the algorithm for choosing a route.
Use the no parameter with this command to allow the router to consider as-path in choosing a route.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
( no ) bgp bestpath as-path ignore
Command Mode
Router Configuration
Default
Disabled
Usage
None
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# bgp bestpath as-path ignore
Related Commands
bgp always-compare-med, bgp bestpath med, bgp bestpath compare-routerid
6.7.5. bgp bestpath compare-confed-aspath
Command Purpose
Use this command to allow comparing of the confederation AS path length.
Use the no parameter with this command to revert the selection and ignore AS confederation path length in the BGP best path selection.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
( no ) bgp bestpath compare-confed-aspath
Command Mode
Router Configuration
Default
BGP receives routes with identical eBGP paths from eBGP peers and selects the first route received as the best path.
Usage
This command specifies that the AS confederation path length must be used, when available, in the BGP best path decision process. It is effective only when bgp bestpath as-path ignore command has not been specified.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# bgp bestpath compare-confed-aspath
Related Commands
bgp bestpath as-path ignore
6.7.6. bgp bestpath compare-routerid
Command Purpose
Use this command to compare router-id for identical eBGP paths.
Use the no parameter with this command to disable this function.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
( no ) bgp bestpath compare-routerid
Command Mode
Router Configuration
Default
BGP receives routes with identical eBGP paths from eBGP peers and selects the first route received as the best path.
Usage
When comparing similar routes from peers the BGP router does not consider router ID of the routes. By default, it selects the first received route. Use this command to include router ID in the selection process; similar routes are compared and the route with lowest router ID is selected. The router-id is the highest IP address on the router, with preference given to loopback addresses. Router-id can be manually set by using the bgp router-id command.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# bgp bestpath compare-routerid
Related Commands
show ip bgp
show ip bgp neighbors
6.7.7. bgp bestpath med
Command Purpose
Use this command to specify Multi Exit Discriminator (MED) attribute comparison.
Use the no parameter with this command to prevent BGP from considering the MED attribute in comparing paths.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
bgp bestpath med confed [ missing-as-worst ]
bgp bestpath med missing-as-worst [ confed ]
no bgp bestpath med confed [ missing-as-worst ]
no bgp bestpath med missing-as-worst [ confed ]
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
confed |
Compares MED among confederation paths |
- |
missing-as-worst |
Treats missing MED as the least preferred one |
- |
Command Mode
Router Configuration
Default
MED value is zero.
Usage
Use this command to specify two MED attributes–confed and missing-as-worst. The confed attribute enables MED comparison among paths learned from confederation peers. The MEDs are compared only if there is no external autonomous system (an AS not within the confederation) in the path. If there is an external autonomous system in the path, the MED comparison is not made.
The missing-as-worst attribute to 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. If missing-as-worst is disabled, the missing MED is assigned the value of 0, making the path with the missing MED attribute the best path.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# bgp bestpath med missing-as-worst
Related Commands
bgp-always-compare-med, bgp bestpath as-path ignore, bgp deterministic-med
6.7.8. bgp client-to-client reflection
Command Purpose
Use this command to restore route reflection from a BGP route reflector to clients.
Use the no parameter with this command to turn off client-to-client reflection.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
bgp client-to-client reflection
no bgp client-to-client reflection
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
reflection |
Allows reflection of routes |
- |
Command Mode
Router Configuration
Default
When a router is configured as a route reflector, client-to-client reflection is enabled by default.
Usage
The bgp client-to-client reflection command is used to configure routers as route reflectors. Route reflectors are used when all Interior Border Gateway Protocol (iBGP) speakers are not fully meshed. If the clients are fully meshed the route reflector is not required, use no bgp client-to-client reflection command to disable the client-to-client route reflection.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# no bgp client-to-client reflection
Related Commands
bgp cluster-id
neighbor route-reflector-client
show ip bgp
6.7.9. bgp cluster-id
Command Purpose
Use this command to configure the cluster ID if the BGP cluster has more than one route reflector.
Use the no parameter with this command to remove the cluster ID.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
bgp cluster-id CLUSTERID
no bgp cluster-id
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
CLUSTERID |
Specifies the cluster ID of this router acting as a routereflector, either as IP address or as a maximum of 4 bytes. |
IPv4 Address in A.B.C.D format or number in range 1-4294967295 |
A.B.C.D |
A.B.C.D Route Reflector Cluster-id in IP address format |
IPv4 Address |
1-4294967295 |
Route Reflector cluster-id as a 32 bit quantity |
1-4294967295 |
Command Mode
Router Configuration
Default
N/A
Usage
A cluster includes route reflectors and its clients. Usually, each cluster is identified by the router ID of its single route reflector but to increase redundancy sometimes a cluster may have more than one route reflector. All router reflectors in such a cluster are then identified by a cluster ID. The bgp cluster-id command is used to configure the 4 byte cluster ID for clusters with more than one route reflectors.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# bgp cluster-id 1.1.1.1
Related Commands
bgp client-to-client reflection, neighbor route-reflector-client, show ip bgp
6.7.10. bgp confederation identifier
Command Purpose
Use this command to specify a Bgp confederation identifier.
Use the no parameter with this command to remove the Bgp confederation identifier.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
bgp confederation identifier ID
no bgp confederation identifier
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
ID |
Set routing domain confederation AS number |
1-65535 |
Command Mode
Router Configuration
Default
N/A
Usage
N/A
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# bgp confederation identifier 1
Related Commands
bgp confederation peer
6.7.11. bgp confederation peers
Command Purpose
Use this command to configure the Autonomous Systems (AS) that belong to the confederation.
Use the no parameter with this command to remove an autonomous system from the confederation.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
bgp confederation peers .ASN
no bgp confederation peers ( .ASN | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
ASN |
AS numbers of eBGP peers that are under same confederation but in a different sub-AS |
1-65535 |
Command Mode
Router Configuration
Default
N/A
Usage
A confederation allows an AS to be divided into several ASs. The AS is given a confederation identifier. External routers view only the whole confederation as one AS. Each AS is fully meshed within itself and is visible internally to the confederation. Use the bgp confederation peer command to define the list of confederation peers.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# bgp confederation peers 1234 21345
Related Commands
bgp confederation identifier
6.7.12. bgp dampening
Command Purpose
Use this command to set bgp dampening parameters.
Use the no parameter with this command to unset the bgp dampening parameters.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
bgp dampening REACHTIME
bgp dampening REACHTIME REUSE
bgp dampening REACHTIME REUSE SUPPRESS MAXSUPPRESS ( UNREACHTIME | )
bgp dampening route-map ROUTEMAP
no bgp dampening REACHTIME
no bgp dampening REACHTIME REUSE
no bgp dampening REACHTIME REUSE SUPPRESS MAXSUPPRESS ( UNREACHTIME | )
no bgp dampening route-map ( ROUTEMAP | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
REACHTIME |
Specifies the reachability half-life time in minutes. The time for the penalty to decrease to one-half of its current value. The default is 15 minutes. |
1-45 |
REUSE |
Specifies the reuse limit value. When the penalty for a suppressed route decays below the reuse value, the routes become unsuppressed. The default reuse limit is 750 SUPPRESS <1-20000> Specifies the suppress limit value. When the penalty for a route exceeds the suppress value, the route is suppressed. The default suppress limit is 2000. |
1-20000 |
SUPPRESS |
Specifies suppress-time.A route dampening more than this value will be suppressd. The default value is 2000. |
1-20000 |
MAXSUPPRESS |
Specifies the max-suppress-time. Maximum time that a dampened route is suppressed. The default max-suppress value is 4 times the half-life time (60 minutes). |
1-255 |
UNREACHTIME |
Specifies the un-reachability half-life time for penalty, in minutes. |
1-45 |
ROUTEMAP |
route-map WORD Route-map to specify criteria for dampening. |
Up to 20 characters |
Command Mode
Router Configuration
Address Family Configuration
Default
N/A
Usage
Route dampening minimizes the instability caused by route flapping. A penalty is added for every flap in a flapping route. As soon as the total penalty reaches the suppress limit the advertisement of the route is suppressed. This penalty is decayed according to the configured half time value. Once the penalty is lower than the reuse limit, the route advertisement is un-suppressed.
The dampening information is purged from the router once the penalty becomes less than half of the reuse limit.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# bgp dampening 20 800 2500 80 25
Related Commands
N/A
6.7.13. bgp default ipv4-unicast
Command Purpose
Use this command to configure BGP defaults and activate ipv4-unicast for a peer by default. This affects the BGP Global Config.
Use the no parameter with this command to disable this function
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
bgp default ipv4-unicast
no bgp default ipv4-unicast
Command Mode
Router Configuration
Default
The bgp default ipv4 unicast is the default behavior.
Usage
The no bgp default ipv4-unicast command is used to disable the default behavior of the BGP routing process of exchanging IPv4 addressing information with BGP neighbor routers.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# bgp default ipv4-unicast
Related Commands
N/A
6.7.14. bgp default local-preference
Command Purpose
Use this command to change the default local preference value.
Use the no parameter with this command to revert to the default setting.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
bgp default local-preference PREF_VALUE
no default local-preference
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
PREF_VALUE |
Configure default local preference value.The default local preference value is 100. |
0-4294967295 |
Command Mode
Router Configuration
Default
The default local preference value is 100.
Usage
Local preference indicates the preferred path when there are multiple paths to the same destination. The path having a higher preference is preferred. Use bgp default local-preference command to define preference of a particular path. The preference is sent to all routers and access servers in the local autonomous system.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# bgp default local-preference 2345555
Related Commands
N/A
6.7.15. bgp deterministic-med
Command Purpose
Use this command to compare the Multi Exit Discriminator (MED) variable when choosing among routes advertised by different peers in the same autonomous system.
Use the no parameter with this command to disallow this setting.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
bgp deterministic-med
no bgp deterministic-med
Command Mode
Router Configuration
Default
Disabled
Usage
“Multi Exit Discriminator (MED) is used in best path selection by BGP. MED is compared after BGP attributes weight, local preference, AS-path and origin have been compared and are equal. Enable bgp deterministic med command on all routers in the local AS, for a correct comparison result. After enabling this command, all paths for the same prefix are grouped together and arranged according to their MED value.
Based on this comparison, the best path is then chosen.
This command compares MED variable when choosing routes advertised by different peers in the same AS, to compare MED, when choosing routes from neighbors in different ASs use the bgp always-compare-med command.”
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# bgp deterministic-med
Related Commands
show ip bgp, show ip bgp neighbors
6.7.16. bgp enforce-first-as
Command Purpose
Use this command to specifies that any updates received from an external neighbor that do not have the neighbor’s configured Autonomous System (AS) at the beginning of the AS_PATH in the received update must be denied.
Use the no parameter with this command to disable this feature.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
bgp enforce-first-as
no bgp enforce-first-as
Command Mode
Router Configuration
Default
Disabled
Usage
Enabling this feature adds to the security of the BGP network by not allowing traffic from unauthorized systems.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# bgp enforce-first-as
Related Commands
N/A
6.7.17. bgp fast-external-failover
Command Purpose
Use this command to reset a BGP session immediately, if the interface used for BGP connection goes down.
Use the no parameter with this command to disable this feature.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
bgp fast-external-failover
no bgp fast-external-failover
Command Mode
Router Configuration
Default
Enabled
Usage
None
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# bgp fast-external-failover
Related Commands
N/A
6.7.18. bgp log-neighbor-changes
Command Purpose
Use this command to enable logging of status change messages without turning on debug BGP commands.
Use the no parameter with this command to disable this feature.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
bgp log-neighbor-changes
no bgp log-neighbor-changes
Command Mode
Router Configuration
Default
Disabled
Usage
System implementation provides other kinds of logging services for neighbor status, for example, debug bgp fsm, debug bgp events, etc. However, these commands create a significant hit in the logging performance.
The bgp log-neighbor-changes command, logs the following events:
(1)BGP Notification Received
(2)Erroneous BGP Update Received
(3)User reset request
Peer time-out
(5)Peer Closing down the session
Interface flap
Router ID changed
Neighbor deleted
Member added to peer group
Administrative shutdown
Remote AS changed
RR client configuration modification
(13)Soft reconfiguration modification
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# bgp log-neighbor-changes
Related Commands
N/A
6.7.19. bgp router-id
Command Purpose
Use this command to configure the router identifier.
Use the no parameter with this command to disable this function
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
bgp router-id ROUTERID
no bgp router-id ( ROUTERID | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
ROUTERID |
A.B.C.D Manually configured router ID. |
IPv4 Address in A.B.C.D format |
Command Mode
Router Configuration
Address Family Configuration
Default
In case the loopback interface is configured the router-id is set to the IP address of a loopback interface. If not, the highest IP address is the router-id.
Usage
Use bgp router-id command to manually configure a fixed router ID as a BGP router identifier.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# bgp router-id 1.1.2.3
Related Commands
N/A
6.7.20. bgp scan-time
Command Purpose
Use this command to set the interval for BGP route next-hop scanning.
Use the no parameter with this command to disable this function.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
bgp scan-time TIME
no bgp scan-time
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
TIME |
Scanning interval in seconds. The default scanning interval is 60 seconds. |
0-60 |
Command Mode
Router Configuration
Default
N/A
Usage
Use this command to configure scanning intervals of BGP routers. This interval is the period after which router checks the validity of the routes in its database.
To disable BGP scanning, set the scan time interval to 0 seconds.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# bgp scan-time 10
Related Commands
N/A
6.7.21. clear ip bgp *
Command Purpose
Use this command to reset a BGP connection for all peers.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
clear ip bgp * ( IN | out | SOFT | )
clear ip bgp * ipv4 PREFIX ROUTES
clear ip bgp * vpnv4 unicast ROUTES
clear ip bgp * vrf NAME ROUTES
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
* |
clears all bgp peers |
- |
ipv4 |
clears all IPv4 address family peers |
- |
vpnv4 |
clears all vpnv4 address family peers |
- |
ROUTES |
(INSOFT) |
- |
IN |
in (prefix-filter|) |
- |
in |
Indicates that incoming advertised routes will be cleared |
- |
prefix-filter |
Pushes out prefix-list ORF and does inbound soft reconfiguration |
- |
out |
Indicates that outgoing advertised routes will be cleared. |
- |
SOFT |
soft (in) Indicates that both incoming and outgoing routes will be cleared |
- |
PREFIX |
(unicast|multicast) |
- |
unicast |
address family modifier |
- |
multicast |
address family modifier |
- |
vrf |
VPN routing/forwarding instance |
- |
NAME |
VPN Routing/Forwarding instance name |
Up to 15 characters |
Command Mode
Privileged EXEC
Default
N/A
Usage
There are two kinds BGP reset, hard reset will clear BGP peers and establish again. Soft reset only refresh routing table.
Examples
Switch# clear ip bgp *
Switch# clear ip bgp * ipv4 unicast in prefix-filter
Switch# clear ip bgp * vpnv4 unicast in
Related Commands
N/A
6.7.22. clear ip bgp A.B.C.D
Command Purpose
Use this command to reset a IPv4 BGP connection for a specific IP address.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
clear ip bgp A.B.C.D ( in | out | SOFT )
clear ip bgp A.B.C.D ipv4 PREFIX ROUTES
clear ip bgp A.B.C.D vpnv4 unicast ROUTES
clear ip bgp A.B.C.D vrf NAME ROUTES
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
A.B.C.D |
Specifies the IPv4 address of the BGP route to be cleared |
IPv4 Address in A.B.C.D format |
ipv4 |
clears all IPv4 address family peers |
- |
vpnv4 |
clears all VPNv4 address family peers |
- |
ROUTES |
(INSOFT) |
- |
IN |
in prefix-filter |
- |
in |
Indicates that incoming advertised routes will be cleared |
- |
prefix-filter |
Pushes out prefix-list ORF and does inbound soft reconfiguration |
- |
out |
Indicates that outgoing advertised routes will be cleared. |
- |
SOFT |
soft (in) Indicates that both incoming and outgoing routes will be cleared |
- |
PREFIX |
(unicast|multicast) |
- |
unicast |
address family modifier |
- |
multicast |
address family modifier |
- |
vrf |
VPN routing/forwarding instance |
- |
NAME |
VPN Routing/Forwarding instance name |
Up to 15 characters |
Command Mode
Privileged EXEC
Default
N/A
Usage
N/A
Examples
Switch# clear ip bgp 10.10.0.12 soft
Switch# clear ip bgp 10.10.0.10 vpnv4 unicast out
Switch# clear ip bgp 11.11.11.11 ipv4 multicast in prefix-filter
Related Commands
N/A
6.7.23. clear ip bgp dampening
Command Purpose
Use this command to reset all dampened BGP routes under the specified address family.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
clear ip bgp dampening ( A.B.C.D | A.B.C.D/M | )
clear ip bgp ipv4 PREFIX dampening ( A.B.C.D | A.B.C.D/M | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
A.B.C.D |
Specifies the IPv4 address for which Bgp dampening is to be cleared. |
IPv4 Address in A.B.C.D format |
A.B.C.D/M |
Specifies the IPv4 address with mask for which Bgp dampening is to be cleared. |
IPv4 Address and mask length in A.B.C.D/M format |
ipv4 |
clears all IPv4 address family peers |
- |
PREFIX |
(unicast|multicast) |
- |
unicast |
address family modifier |
- |
multicast |
address family modifier |
- |
Command Mode
Privileged EXEC
Default
N/A
Usage
N/A
Examples
Switch# clear ip bgp dampening 10.10.0.121
Switch# clear ip bgp ipv4 unicast dampening
Related Commands
N/A
6.7.24. clear ip bgp flap-statistics
Command Purpose
Use this command to clear the flap count and history duration for all the prefixes under the specified address family.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
clear ip bgp flap-statistics ( A.B.C.D | A.B.C.D/M | )
clear ip bgp ipv4 PREFIX flap-statistics ( A.B.C.D | A.B.C.D/M | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
A.B.C.D |
Specifies the IPv4 address for which Bgp dampening is to be cleared. |
IPv4 Address in A.B.C.D format |
A.B.C.D/M |
Specifies the IPv4 address with mask for which Bgp dampening is to be cleared. |
IPv4 Address and mask length in A.B.C.D/M format |
ipv4 |
clears all IPv4 address family peers |
- |
PREFIX |
(unicast|multicast) |
- |
unicast |
address family modifier |
- |
multicast |
address family modifier |
- |
Command Mode
Privileged EXEC
Default
N/A
Usage
N/A
Examples
Switch# clear ip bgp flap-statistics 10.10.0.121
Switch# clear ip bgp ipv4 unicast flap-statistics
Related Commands
N/A
6.7.25. clear ip bgp ASN
Command Purpose
Use this command to reset a BGP connection for all peers in a specified Autonomous System.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
clear ip bgp ASN ( IN | out | SOFT | )
clear ip bgp ASN ipv4 PREFIX ROUTES
clear ip bgp ASN vpnv4 unicast ROUTES
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
ASN |
Specifies the AS Number for which all routes will be cleared |
1-65535 |
ipv4 |
clears all IPv4 address family peers |
- |
vpnv4 |
clears all VPNv4 address family peers |
- |
ROUTES |
(INSOFT) |
- |
IN |
in prefix-filter |
- |
in |
Indicates that incoming advertised routes will be cleared |
- |
out |
Indicates that outgoing advertised routes will be cleared. |
- |
prefix-filter |
Pushes out prefix-list ORF and does inbound soft reconfiguration |
- |
SOFT |
soft (in) Indicates that both incoming and outgoing routes will be cleared |
- |
PREFIX |
(unicast|multicast) |
- |
unicast |
address family modifier |
- |
multicast |
address family modifier |
- |
Command Mode
Privileged EXEC
Default
N/A
Usage
N/A
Examples
Switch# clear ip bgp 100
Switch# clear ip bgp 200 ipv4 unicast in prefix-filter
Switch# clear ip bgp 500 vpnv4 unicast in
Related Commands
N/A
6.7.26. clear ip bgp external
Command Purpose
Use this command to reset a BGP connection for all external peers.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
clear ip bgp external ( In | out | SOFT | )
clear ip bgp external ipv4 PREFIX ROUTES
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
external |
Clears all external peers |
- |
ROUTES |
(INSOFT) |
- |
IN |
in prefix-filter |
- |
in |
Indicates that incoming advertised routes will be cleared |
- |
out |
Indicates that outgoing advertised routes will be cleared. |
- |
SOFT |
soft (in) Indicates that both incoming and outgoing routes will be cleared |
- |
ipv4 |
clears all IPv4 address family peers |
- |
PREFIX |
(unicast|multicast) |
- |
unicast |
address family modifier |
- |
multicast |
address family modifier |
- |
Command Mode
Privileged EXEC
Default
N/A
Usage
N/A
Examples
Switch# clear ip bgp external out
Switch# clear ip bgp external ipv4 unicast in prefix-filter
Related Commands
N/A
6.7.27. clear ip bgp peer-group
Command Purpose
Use this command to reset a BGP connection for all members of a peer group.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
clear ip bgp peer-group WORD ( In | out | SOFT | )
clear ip bgp peer-group WORD ipv4 PREFIX ROUTES
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
peer-group |
Clears all members of a peer group |
- |
WORD |
Specifies the name of the peer group for which all members will be cleared. |
Up to 20 characters |
ipv4 |
clears all IPv4 address family peers |
- |
ROUTES |
(INSOFT) |
- |
prefix-filter |
Pushes out prefix-list ORF and does inbound soft reconfiguration |
- |
IN |
in prefix-filter |
- |
in |
Indicates that incoming advertised routes will be cleared |
- |
out |
Indicates that outgoing advertised routes will be cleared. |
- |
SOFT |
soft (in) Indicates that both incoming and outgoing routes will be cleared |
- |
PREFIX |
(unicast|multicast) |
- |
unicast |
address family modifier |
- |
multicast |
address family modifier |
- |
Command Mode
Privileged EXEC
Default
N/A
Usage
None
Examples
Switch# clear ip bgp peer-group Peer1 out
Switch# clear ip bgp peer-group mypeer ipv4 unicast in prefix-filter
Related Commands
N/A
6.7.28. clear ip bgp vrf
Command Purpose
Use this command to reset the specified VPN Routing /Forwarding Instance for BGP connections.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
clear ip bgp ( A.B.C.D ) | * ) vrf WORD ( out | in | SOFT )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
WORD |
Specifies the name of the VRF |
Up to 15 characters |
A.B.C.D |
Specifies the IPv4 address of the BGP route to be cleared |
IPv4 Address in A.B.C.D format |
* |
Clears all peers |
- |
out |
Performs soft reconfiguration out |
- |
SOFT |
soft (in) Indicates that both incoming and outgoing routes will be cleared |
- |
in |
Performs soft reconfiguration in |
- |
Command Mode
Privileged EXEC
Default
N/A
Usage
If the neighbor address is specified with this command it clears the specified connection. If no address is specified this command clears all the BGP routes.
Examples
Switch# clear ip bgp 3.3.3.3 vrf VRF1 soft in
Related Commands
N/A
6.7.29. debug bgp
Command Purpose
Use this command to specify all debugging options for BGP. Use the no parameter with this command to disable this function.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
debug bgp ( all | dampening | events | filters | fsm | keepalives | mpls | updates )
no debug bgp ( all | dampening | events | filters | fsm | keepalives | mpls | nsm | updates )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
all |
Used with the no form exclusively; turns off all debugging for BGP |
- |
dampening |
Specifies debugging for Bgp dampening. |
- |
events |
Specifies debugging for BGP events. |
- |
filters |
Specifies debugging for BGP filters. |
- |
fsm |
Specifies debugging for BGP Finite State Machine (FSM). |
- |
mpls |
Specifies debuggin for BGP Multiprotocol Label Switching. |
- |
keepalives |
Specifies debugging for BGP keepalives. |
- |
updates |
updates Specifies debugging for BGP updates. |
- |
Command Mode
Privileged EXEC
Default
N/A
Usage
This command without any parameters turns on normal bgp debug information.
Examples
Switch# debug bgp
Switch# debug bgp events
Related Commands
N/A
6.7.30. distance
Command Purpose
Use this command to define an administrative distance.
Use the no parameter with this command to remove an administrative distance.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
distance ADMINDISTANCE IP_ADDR/IP_MASK_LEN
no distance ADMINDISTANCE IP_ADDR/IP_MASK_LEN
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
ADMINDISTANCE |
Specifies the administrative distance. |
1-255 |
IP_ADDR |
the IP source prefix |
IPv4 Address |
IP_MASK_LEN |
the IP source prefix mask length |
1-32 |
Command Mode
Router Configuration
Default
N/A
Usage
Use this command to set the administrative distance for BGP. This distance is a rating of trustworthiness of a router.
The higher the distance the lower the trust rating.
The administrative distance can be set for external, internal and local routes. External paths are routes learned from a neighbor out of the AS. The internal routes are routes learned from another router within the same AS. Local routes are for the router that is being redistributed from another process.
If the administrative distance is changed, it could create inconsistency in the routing table and obstruct routing.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# distance 34 10.10.0.0/24 mylist
Switch(config-router)# distance bgp 34 23 15
Related Commands
N/A
6.7.31. exit-address-family
Command Purpose
Use this command to exit the address family mode.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
exit-address-family
Command Mode
Address Family Configuration
Default
N/A
Usage
N/A
Examples
The following example shows the use of exit-address-family command and the change in the prompt after using this command:
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# address-family ipv4 unicast
Switch(config-router-af)# exit-address-family
Switch(config-router)#
Related Commands
address-family
6.7.32. ip as-path access-list
Command Purpose
Use this command to define a BGP Autonomous System (AS) path access list.
Use the no parameter with this command to disable use of the access list.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip as-path access-list LISTNAME ( deny | permit ) LINE
no ip as-path access-list LISTNAME ( deny | permit ) LINE
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
LISTNAME |
Specifies the name of the access list. |
Up to 40 characters, the first character must be among [a-zA-Z0-9] |
deny |
(Optional) Denies access to matching conditions. |
- |
permit |
(Optional) Permits access to matching conditions. |
- |
LINE |
Specifies a regular expression to match the BGP AS paths. |
A regular expression to match the BGP AS paths |
Command Mode
Global Config
Default
N/A
Usage
Named community list is a filter based on regular expressions. If the regular expression matches the specified string representing the AS path of the route, then the permit or deny condition applies. Use this command to define the BGP access list globally, use the neighbor router configuration command to apply a specific access list.
Examples
Switch# configure terminal
Switch(config)# ip as-path access-list mylist deny ^65535$
Related Commands
N/A
6.7.33. ip community-list
Command Purpose
Use this command to add a community list entry.
Use the no parameter with this command to delete the community list entry.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip community-list LISTNUM ( deny | permit ) COMMUNITY
no ip community-list LISTNUM ( deny | permit ) COMMUNITY
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
LISTNUM |
Specifies the community ID.1-99:Standard list100-199:Expandes list |
1-199 |
deny |
Specifies the community to reject. |
- |
permit |
Specifies the community to accept. |
- |
COMMUNITY |
- (AA:NN local-ASno-export) |
- |
AA:NN |
Specifies the valid value for the community number. This format represents the 32 bit communities value, where AS is the high order 16 bits and VAL is the low order 16 bits in digit format. |
AA is in the range 1-65535NN is in the range of 1-65535 |
internet |
Specifies routes not to be advertised to the Internet. |
- |
local-AS |
Specifies routes not to be advertised to external BGP peers. |
- |
no-advertise |
Specifies routes not to be advertised to other BGP peers. |
- |
no-export |
Specifies routes not to be advertised outside of Autonomous System boundary. |
- |
Command Mode
Global Config
Default
N/A
Usage
Use the community-lists to specify BGP community attributes. The community attribute is used for implementing policy routing. It is an optional, transitive attribute and facilitates transfer of local policies through different autonomous systems. It includes community values that are 32 bits long.
There are two kinds of community-lists: the expanded and standard. The standard community-list defines the community attributes in a specified format and not with regular expressions. The expanded community-list defines the communities attributes with regular expressions.
Examples
Switch# configure terminal
Switch(config)# ip community-list 20 permit 7675:80 7675:90
Related Commands
ip community-list standard
ip community-list expanded
6.7.34. ip community-list expanded
Command Purpose
Use this command to add a community list entry.
Use the no parameter with this command to delete the community list entry.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip community-list expanded WORD ( deny | permit ) LINE
no ip community-list expanded WORD ( deny | permit ) LINE
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
expanded |
Add an expanded community-list entry. |
- |
WORD |
Expanded community list name |
Up to 20 characters |
deny |
Specifies community to reject. |
- |
permit |
Specifies community to accept. |
- |
LINE |
Specifies a regular expression to match the BGP AS paths. |
A regular expression |
Command Mode
Global Config
Default
N/A
Usage
Use the community-lists to specify BGP community attributes. The community attribute is used for implementing policy routing. It is an optional, transitive attribute and facilitates transfer of local policies through different autonomous systems. It includes community values that are 32 bits long.
There are two kinds of community-lists–the expanded and standard. The standard community-list defines the community attributes in a specified format and not with regular expressions. The expanded community-list defines the communities attributes with regular expressions.
Examples
Switch# configure terminal
Switch(config)# ip community-list expanded CLIST permit .*
Related Commands
ip community-list
ip community-list standard
6.7.35. ip community-list standard
Command Purpose
Use this command to add a standard community-list entry.
Use the no parameter with this command to delete the standard community-list entry.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip community-list standard WORD ( deny | permit ) COMMUNITY
no ip community-list standard WORD ( deny | permit ) COMMUNITY
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
standard |
Specifies a standard community list. |
- |
WORD |
Standard community list name |
Up to 20 characters |
deny |
Specifies community to reject. |
- |
permit |
Specifies community to accept. |
- |
COMMUNITY |
- (AA:NN local-ASno-export) |
- |
AA: NN |
Specifies the valid value for the community number. This format represents the 32 bitcommunities value, where AS is the high order 16 bits and VAL is the low order 16 bits in digitSpecifies the valid value for the community number. This format represents the 32 bitcommunities value, where AS is the high order 16 bits and VAL is the low order 16 bits in digitformat. |
AA is in the range 1-65535NN is in the range of 1-65535 |
internet |
Specifies routes not to be advertised to the Internet. |
- |
local-AS |
Specifies routes not to be advertised to external BGP peers. |
- |
no-advertise |
Specifies routes not to be advertised to other BGP peers. |
- |
no-export |
Specifies routes not to be advertised outside of the Autonomous System boundary. |
- |
Command Mode
Global Config
Default
N/A
Usage
Use the community-lists to specify BGP community attributes. The community attribute is used for implementing policy routing. It is an optional, transitive attribute and facilitates transfer of local policies through different autonomous systems. It includes community values that are 32 bits long.
There are two kinds of community-lists–the expanded and standard. The standard community-list defines the community attributes in a specified format without regular expressions. The expanded community-list defines the communities attributes with regular expressions.
Use the ip community-list standard command to add a standard community-list entry. The standard community-list is compiled into binary format and is directly compared with the BGP communities attribute in the BGP updates. The comparison is faster than the expanded community-list. Any community value that does not match the standard community value is automatically treated as expanded.
Examples
Switch# configure terminal
Switch(config)# ip community-list standard CLIST permit 7675:80 7675:90 no-export
Related Commands
ip community-list
ip community-list expanded
6.7.36. neighbor activate
Command Purpose
Use this command to enable the exchange of the specified AF routes with a neighboring router.
Use the no parameter with this command to disable exchange of information with a neighbor.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID activate
no neighbor NEIGHBORID activate
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
Command Mode
Router Configuration
Address Family Configuration
Default
N/A
Usage
After the TCP connection is opened with the neighbor, this command is used to enable or disable the exchange of the specified AF information with a neighboring router.
To enable the exchange of multicast and VPNv4 address prefix types, neighbors are activated using the neighbor activate command in address family mode.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 1.2.3.4 activate
Related Commands
neighbor remote-as
6.7.37. neighbor advertisement-interval
Command Purpose
Use this command to set the minimum interval between sending the BGP routing updates.
Use the no parameter with this command to set the interval time to default.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID advertisement-interval TIME
no neighbor NEIGHBORID advertisement-interval
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
TIME |
Advertise -interval value in seconds |
0-600 |
Command Mode
Router Configuration
Default
N/A
Usage
Use this command to set the minimum interval between the sending of BGP routing updates. To reduce the flapping of routes to internet, a minimum advertisement interval is set, so that the BGP routing updates are sent only per interval seconds. bgp dampening can also be used to control the effects of flapping routes. For the originated bgp routes, they would be sent out when as-origination-interval and advertisement-interval expired at the same time.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 10.10.0.3 advertisement-interval 45
Related Commands
N/A
6.7.38. neighbor as-origination-interval
Command Purpose
Use this command to set the minimum interval between ready to send the originated BGP routing updates.
Use the no parameter with this command to set the interval time to default.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID as-origination-interval TIME
no neighbor NEIGHBORID as-origination-interval TIME
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
TIME |
Advertise -interval value in seconds |
0-600 |
Command Mode
Router Configuration
Default
N/A
Usage
Use this command to set the minimum interval between the ready to send of originated BGP routing updates. For the originated bgp routes they would be sent out when as-origination-interval and advertisement-interval expired at the same time.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 10.10.0.3 advertisement-interval 45
Related Commands
N/A
6.7.39. neighbor allowas-in
Command Purpose
Use this command to configure PE routers to allow re-advertisement of all prefixes containing duplicate Autonomous System Numbers (ASNs).
Use the no parameter with this command to disable the readvertisement of a PE router’s ASN.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBOR allowas-in [ NUMBER ]
no neighbor NEIGHBOR allowas-in
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
NUMBER |
Number of occurances of AS number.Default value is 1 |
1-10 |
Command Mode
Router Configuration
Address Family Configuration
Default
Disabled
Usage
In a hub and spoke configuration, a PE router re-advertises all prefixes containing duplicate ASNs. Use the neighbor allowas-in command to configure two VRFs on each PE router to receive and re-advertise prefixes. One of the VRFs receives prefixes with ASNs from all PE routers and then advertises them to neighboring PE routers. The other VRF receives prefixes with ASNs from the CE router and re-advertises them to all PE routers in the hub and spoke configuration.
Control the number of times an ASN is advertised, by specifying a number from 1 to 10.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# address-family ipv4 vrf VRF_A
Switch(config-router-af)# neighbor 10.10.0.1 allowas-in 3
Related Commands
N/A
6.7.40. neighbor attribute-unchanged
Command Purpose
Use this command to advertise unchanged BGP attributes to the specified neighbor.
Use the no parameter with this command to disable this function.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID attribute-unchanged { as-path | next-hop | med }
no neighbor NEIGHBORID attribute-unchanged { as-path | next-hop | med }
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
as-path |
AS path attribute |
- |
next-hop |
Next hop attribute |
- |
med |
Multi Exit Discriminator |
- |
Command Mode
Router Configuration
Address Family Configuration
Default
N/A
Usage
N/A
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 10.10.0.75 attribute-unchanged as-path med
Related Commands
N/A
6.7.41. neighbor capability orf prefix-list
Command Purpose
Use this command to advertise ORF capability to neighbors.
Use the no parameter with this command to disable this function.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID capability orf prefix-list ( both | receive | send )
no neighbor NEIGHBORID capability orf prefix-list ( both | receive | send )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
orf |
Advertises ORF capability to its neighbors |
- |
both |
Indicates that the local router can send ORF entries to its peer as well as receive ORF entries from its peer. |
- |
receive |
Indicates that the local router is willing to receive ORF entries from its peer |
- |
send |
Indicates that the local router is willing to send ORF entries to its peer |
- |
Command Mode
Router Configuration
Address Family Configuration
Default
N/A
Usage
Outbound Route Filters (ORFs) send and receive capabilities to lessen the number of updates exchanged between neighbors. By filtering updates, this option minimizes generating and processing of updates.
The local router advertises the ORF capability in send mode and the remote router receives the ORF capability in receive mode applying the filter as outbound policy. The two routers exchange updates to maintain the ORF for each
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 1.1.1.1 capability orf prefix-list both
Related Commands
N/A
6.7.42. neighbor capability route-refresh
Command Purpose
Use this command to advertise route-refresh capability to the specified neighbors.
Use the no parameter with this command to disable this function
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID capability route-refresh
no neighbor NEIGHBORID capability route-refresh
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
Command Mode
Router Configuration
Default
N/A
Usage
Use this command to advertise to peer about route refresh capability support. If route refresh capability is supported, then router can dynamically request that the peer readvertises its Adj-RIB-Out.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 10.10.10.1 capability route-refresh
Related Commands
N/A
6.7.43. neighbor default-originate
Command Purpose
Use this command to allow a BGP local router to send the default route 0.0.0.0 to a neighbor for use as a default route.
Use the no parameter with this command to send no route as a default.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID default-originate ( ROUTEMAP | )
no neighbor NEIGHBORID default-originate ( ROUTEMAP | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
ROUTEMAP |
route-map WORD |
- |
route-map |
The route-map to specify criteria to originate default routes |
- |
WORD |
Route-map name |
Up to 20 characters |
Command Mode
Router Configuration
Address Family Configuration
Default
N/A
Usage
Every router should have a default route, it is used to send datas to the network which is not existent in local RIB. To set a default route on each router can make every router have a default route, or to create a default route and broadcast it to BGP peer by this command.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 10.10.10.1 default-originate route-map myroute
Related Commands
N/A
6.7.44. neighbor description
Command Purpose
Use this command to associate a description with a neighbor.
Use the no parameter with this command to remove the description.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID description LINE
no neighbor NEIGHBORID description
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
LINE |
A string to describing the neighbor. |
Up to 80 characters |
Command Mode
Router Configuration
Address Family Configuration
Default
N/A
Usage
None
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 1.2.3.4 description Backup router for sales.
Related Commands
N/A
6.7.45. neighbor distribute-list
Command Purpose
Use this command to filter route update from a particular BGP neighbor.
Use the no parameter with this command to remove an entry.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID distribute-list WORD ( in | out )
no neighbor NEIGHBORID distribute-list WORD ( in | out )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
WORD |
The name of IP access-list |
Up to 40 characters |
in |
Indicates that incoming advertised routes will be filtered. |
- |
out |
Indicates that outgoing advertised routes will be filtered. |
- |
Command Mode
Router Configuration
Address Family Configuration
Default
N/A
Usage
Use only one distribute-list per BGP neighbor.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 1.2.3.4 distribute-list mylist out
Related Commands
N/A
6.7.46. neighbor ebgp-multihop
Command Purpose
Use this command to accept and attempt BGP connections to external peers on indirectly connected networks.
Use the no parameter with this command to return to the default.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID ebgp-multihop ( COUNT | )
no neighbor NEIGHBORID ebgp-multihop
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
COUNT |
Maximum hop count. If the maximum hop count is not set the hop count is 255. |
1-255 |
Command Mode
Router Configuration
Default
N/A
Usage
Multihop is not established if the only route to the multihop peer is a default route. This avoids loop formation.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 10.10.10.34 remote-as 20
Switch(config-router)# neighbor 10.10.10.34 ebgp-multihop 5
Related Commands
N/A
6.7.47. neighbor filter-list
Command Purpose
Use this command to set up a BGP filter.
Use the no parameter with this command to disable this function.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID filter-list LISTNAME ( in | out )
no neighbor NEIGHBORID filter-list LISTNAME ( in | out )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to theneighbor peer-group and neighbor remote-as commands. When this parameter is usedwith a command, the command applies on all peers in the specified group. |
Up to 20 characters |
in |
Indicates that incoming advertised routes will be filtered. |
- |
out |
Indicates that outgoing advertised routes will be filtered. |
- |
LISTNAME |
The name of an autonomous system path access list. |
Up to 40 characters |
Command Mode
Router Configuration
Address Family Configuration
Default
N/A
Usage
This command specifies an access list filter on updates based on the BGP autonomous system paths. Each filter is an access list based on regular expressions.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 10.10.0.34 filter-list listname out
Related Commands
N/A
6.7.48. neighbor maximum-prefix
Command Purpose
Use this command to control the number of prefixes that can be received from a neighbor.
Use the no parameter with this command to disable this function.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID maximum-prefix MAXIMUM
no neighbor NEIGHBORID maximum-prefix
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
MAXIMUM |
MAXPREFIX (THRESHOLD) |
- |
MAXPREFIX |
Specifies the maximum number of prefixes permitted. |
1-4294967295 |
THRESHOLD |
<1-100> Specifies the threshold value, 1 to 100 percent. |
1-100 |
warning-only |
Only gives a warning message when the limit is exceeded. |
- |
Command Mode
Router Configuration
Address Family Configuration
Default
N/A
Usage
The neighbor maximum-prefix command allows the configuration of a specified number of prefixes that a BGP router is allowed to receive from a neighbor. When the warning-only option is not used, if any extra prefixes are received, the router ends the peering. A terminated peer, stays down until the clear ip bgp command is used.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 10.10.0.72 maximum-prefix 1244 warning-only
Related Commands
N/A
6.7.49. neighbor next-hop-self
Command Purpose
Use this command to configure the router as the next hop for a BGP-speaking neighbor or peer group.
Use the no parameter with this command to disable this feature.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID next-hop-self
no neighbor NEIGHBORID next-hop-self
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
Command Mode
Router Configuration
Address Family Configuration
Default
N/A
Usage
This command allows a BGP router to change the nexthop information that is sent to the iBGP peer. The nexthop information is set to the IP address of the interface used to communicate with the neighbor.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 10.10.0.72 remote-as 100
Switch(config-router)# neighbor 10.10.0.72 next-hop-self
Related Commands
N/A
6.7.50. neighbor override-capability
Command Purpose
Use this command to override a capability negotiation result.
Use the no parameter with this command to disable this function
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID override-capability
no neighbor NEIGHBORID override-capability
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
Command Mode
Router Configuration
Default
N/A
Usage
None
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 10.10.10.10 override-capability
Related Commands
N/A
6.7.51. neighbor passive
Command Purpose
Use this command to set a BGP neighbor as passive.
Use the no parameter with this command to disable this function
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
( no ) neighbor NEIGHBORID passive
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
Command Mode
Router Configuration
Default
N/A
Usage
N/A
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 10.10.10.10 passive
Related Commands
N/A
6.7.52. neighbor peer-group (adding a neighbor)
Command Purpose
Use this command to add a neighbor to an existing peer-group.
Use the no parameter with this command to disable this function.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor IPADDRESS peer-group TAG
no neighbor IPADDRESS peer-group
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
IPADDRESS |
A.B.C.D Specifies the address of the BGP neighbor in IPv4 format.A.B.C.D Specifies the address of the BGP neighbor in IPv4 format.TAG Name of the peer-group |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
Command Mode
Router Configuration
Default
N/A
Usage
Use this command to Neighbors with the same update policies are grouped into peer groups. This facilitates the updates of various policies, such as, distribute and filter lists. The peer-group is then configured easily with any of the neighbor commands. Any changes made to the peer group affect all members.
To create a peer-group use the neighbor peer-group create command and then use this command to add neighbors to the group.
Examples
This example shows a new peer-group group1 and the adding of a neighbor 10.10.0.63 to the group:
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor group1 peer-group
Switch(config-router)# neighbor 10.10.0.63 peer-group group1
Related Commands
N/A
6.7.53. neighbor peer-group (creating a peer-group)
Command Purpose
Use this command to create a peer-group.
Use the no parameter with this command to disable this function
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor TAG peer-group
no neighbor TAG peer-group
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
TAG |
Name of the peer-group |
- |
Command Mode
Router Configuration
Default
N/A
Usage
Neighbors with the same update policies are grouped into peer groups. This facilitates the updates of various policies, such as, distribute and filter lists. The peer-group is then configured easily with any of the neighbor commands. Any changes made to the peer group affect all members. Use this command to create a peer-group.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor group1 peer-group
Related Commands
N/A
6.7.54. neighbor prefix-list
Command Purpose
Use this command to distribute BGP neighbor information as specified in a prefix list.
Use the no parameter with this command to remove an entry.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID prefix-list LISTNAME ( in | out )
no neighbor NEIGHBORID prefix-list LISTNAME ( in | out )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
LISTNAME |
The number of an AS-path access list. |
Up to 40 characters |
in |
Specifies that the access list applies to incoming advertisements. |
- |
out |
Specifies that the access list applies to outgoing advertisements. |
- |
Command Mode
Router Configuration
Address Family Configuration
Default
N/A
Usage
Use this command to specify a prefix list for filtering BGP advertisements. Filtering by prefix list matches the prefixes of routes with those listed in the prefix list. If there is a match, the route is used. An empty prefix list permits all prefixes. If a given prefix does not match any entries of a prefix list, the route is denied access. When multiple entries of a prefix list match a prefix, the entry with the smallest sequence number is considered to be a real match.
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 the most common matches or denies are listed at the top.
The neighbor distribute-list command is an alternative to the neighbor prefix-list command and only
one of them can be used for filtering to the same neighbor in any direction.
Examples
Switch# configure terminal
Switch(config)# ip prefix-list list1 deny 30.0.0.0/24
Switch(config)# router bgp 1
Switch(config-router)# neighbor 10.10.10.10 prefix-list list1 in
Related Commands
ip prefix-list
6.7.55. neighbor remote-as
Command Purpose
Use this command to configure an internal or external BGP (iBGP or eBGP) TCP session with another router.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID remote-as ASNUM
no neighbor NEIGHBORID remote-as ASNUM
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
ASNUM |
Neighbor`s autonomous system number |
1-4294967295 |
Command Mode
Router Configuration
Default
N/A
Usage
This command is used to configure iBGP and eBGP sessions with other neighbors. A peer-group support of this command is configured only after creating a specific peer-group.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 10.10.0.73 remote-as 345
Related Commands
N/A
6.7.56. neighbor remove-private-AS
Command Purpose
Use this command to remove the private Autonomous System (AS) number from outbound updates.
Use the no parameter with this command too revert to default.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID remove-private-AS
no neighbor NEIGHBORID remove-private-AS
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
Command Mode
Router Configuration
Address Family Configuration
Default
Disabled
Usage
The private AS numbers range from <64512-65535>. Private AS numbers are not advertised to the Internet. This command is used with external BGP peers only. The router removes the AS numbers only if the update includes private AS numbers. If the update includes both private and public AS numbers, the system treats it as an error.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 10.10.0.63 remove-private-AS
Related Commands
N/A
6.7.57. neighbor route-reflector-client
Command Purpose
Use this command to configure the router as a BGP route reflector and configure the specified neighbor as its client.
Use the no parameter with this command to indicate that the neighbor is not a client.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID route-reflector-client
no neighbor NEIGHBORID route-reflector-client
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
Command Mode
Router Configuration
Address Family Configuration
Default
N/A
Usage
Route reflectors are a solution for the explosion of iBGP peering within an autonomous system. By route reflection the number of iBGP peers within an AS is reduced. Use the neighbor route-reflector-client command to configure the local router as the route reflector and specify neighbors as its client.
An AS can have more than one route reflector. One route reflector treats the other route reflector as another iBGP speaker.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 10.10.0.72 route-reflector-client
Related Commands
N/A
6.7.58. neighbor send-community
Command Purpose
Use this command to specify that a community attribute should be sent to a BGP neighbor.
Use the no parameter with this command to remove the entry. Use the extended and no parameters to remove extended communities. Specifying no other parameter means standard communities only.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID send-community ( both | extended | standard | )
no neighbor NEIGHBORID send-community ( both | extended | standard | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
both |
Sends Standard and Extended Community attributes |
- |
extended |
Sends Extended Community attributes |
- |
standard |
Sends Standard Community attributes |
- |
Command Mode
Router Configuration
Address Family Configuration
Default
None
Usage
By default ,community attributes are not sent to a neighbor.To use this command to enable this command.Route-map can be based on neighbor address, peer group name or AS path information.
Examples
Switch# configure terminal
Switch(config)# bgp config-type standard
Switch(config)# router bgp 1
Switch(config-router)# neighbor 10.10.0.72 send-community extended
Related Commands
N/A
6.7.59. neighbor shutdown
Command Purpose
Use this command to disable a neighbor.
Use the no parameter with this command to re-enable the neighbor.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID shutdown
no neighbor NEIGHBORID shutdown
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
Command Mode
Router Configuration
Default
N/A
Usage
This command shuts down any active session for the specified neighbor and clears all related routing data.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 10.10.0.72 shutdown
Related Commands
N/A
6.7.60. neighbor soft-reconfiguration inbound
Command Purpose
Use this command to configure to start storing updates.
Use the no parameter with this command to disable this function.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID soft-reconfiguration inbound
bo neighbor NEIGHBORID soft-reconfiguration inbound
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
Command Mode
Router Configuration
Address Family Configuration
Default
N/A
Usage
Use this command to store updates for inbound soft reconfiguration. Soft-reconfiguration may be used in lieu of BGP route refresh capability. Using this command enables local storage of all the received routes and their attributes. This requires additional memory. When a soft reset (inbound) is done on this neighbor, the locally stored routes are reprocessed according to the inbound policy. The BGP neighbor connection is not affected.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 10.10.10.10 soft-reconfiguration inbound
Related Commands
N/A
6.7.61. neighbor strict-capability-match
Command Purpose
Use this command to close the BGP connection if capability value does not completely match to remote peer.
Use the no parameter with this command to disable this function
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID strict-capability-match
no neighbor NEIGHBORID strict-capability-match
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
Command Mode
Router Configuration
Default
N/A
Usage
N/A
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 10.10.10.10 strict-capability-match
Related Commands
N/A
6.7.62. neighbor timers
Command Purpose
Use this command to set the timers for a specific BGP neighbor.
Use the no parameter with this command to clear the timers for a specific BGP neighbor
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID timers KEEPALIVE HOLDTIME
no neighbor NEIGHBORID timers
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
KEEPALIVE |
Frequency (in seconds) at which a router sends keepalive messages to its neighbor. The default is 60 seconds. |
1-65535 |
HOLDTIME |
Interval (in seconds) after which, on not receiving a keepalive message, the router declares a neighbor dead. The default is 180 seconds. |
3-65535 |
Command Mode
Router Configuration
Default
N/A
Usage
Keepalive messages are sent by a router to inform another router that the BGP connection between the two is still active. The keepalive interval is the period of time between each keepalive message sent by the router. The holdtime interval is the time the router waits to receive a keepalive message and if it does not receive a message for this period it declares the neighbor dead.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 10.10.10.10 timers 60 120
Related Commands
N/A
6.7.63. neighbor unsuppress-map
Command Purpose
Use this command to selectively leak more-specific routes to a particular neighbor.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID unsuppress-map WORD
no neighbor NEIGHBORID unsuppress-map WORD
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
WORD |
Name of route map |
- |
Command Mode
Router Configuration
Address Family Configuration
Default
N/A
Usage
When the aggregate-address command is used with the summary-only option, the more-specific routes of the aggregate are suppressed to all neighbors. Use the unsuppress-map command to selectively leak more-specific routes to a particular neighbor.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 10.10.0.73 unsuppress-map mymap
Switch(config-router)# address-family ipv4 unicast
Switch(config-router-af)# neighbor 10.10.0.70 unsuppress-map mymap
Related Commands
N/A
6.7.64. neighbor update-source
Command Purpose
Use this command to allow internal BGP sessions to use any operational interface for TCP connections.
Use the no parameter with this command to restore the interface assignment to the closest interface.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID update-source IFNAME
no neighbor NEIGHBORID update-source
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
IFNAME |
Specifies the loopback interface. |
Supportphysical/aggregation/loopback/tunnel/vlaninterfaces |
Command Mode
Router Configuration
Default
N/A
Usage
Use this command in conjunction with any specified interface on the router. The loopback interface is the interface that is most commonly used with this command. The use of loopback interface eliminates a dependency and BGP does not have to rely on the availability of a particular interface for making TCP connections.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 10.10.0.72 update-source eth-0-1
Related Commands
N/A
6.7.65. neighbor weight
Command Purpose
Use this command to set default weights for routes from this neighbor.
Use the no parameter with this command to remove a weight assignment.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor NEIGHBORID weight WEIGHT
no neighbor NEIGHBORID weight
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEIGHBORID |
(A.B.C.D|TAG) |
- |
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
TAG |
Name of an existing peer-group. For information on how to create peer groups, refer to the neighbor peer-group and neighbor remote-as commands. When this parameter is used with a command, the command applies on all peers in the specified group. |
Up to 20 characters |
WEIGHT |
Specifies the weight this command assigns to the route. |
0-65535 |
Command Mode
Router Configuration
Default
N/A
Usage
Use this command to specify a weight value to all routes learned from a neighbor. The route with the highest weight gets preference when there are other routes on the network.
Unlike the local-preference attribute, the weight attribute is relevant only to the local router.
The weights assigned using the set weight command overrides the weights assigned using this command.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 10.10.10.10 weight 60
Related Commands
N/A
6.7.66. neighbor fall-over bfd
Command Purpose
Use this command to establish BFD session on BGP neighbour.
Use the no parameter with this command to delete BFD session on BGP neighbour.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
neighbor A.B.C.D fall-over bfd ( multihop | )
no neighbor A.B.C.D fall-over bfd ( multihop | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
A.B.C.D |
Specifies the address of the BGP neighbor in IPv4 format. |
IPv4 Address in A.B.C.D format |
multihop |
establish multihop BFD session |
- |
Command Mode
Router Configuration
Default
N/A
Usage
Enabling bfd on bgp neighbor.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# neighbor 10.10.10.10 fall-over bfd
Related Commands
None
6.7.67. network
Command Purpose
Use this command to specify the networks to be advertised by the BGP routing process. A unicast network address without a mask is accepted if it falls into the natural boundary of its class. A class-boundary mask is derived if the address matches its natural class-boundary.
Use the no form of this command to remove a network route entry.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
network A.B.C.D
network A.B.C.D route-map WORD
no network A.B.C.D
no network A.B.C.D route-map WORD
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
A.B.C.D |
IP prefix |
IPv4 Address in A.B.C.D format |
WORD |
Name of the route map |
Up to 20 characters |
Command Mode
Router Configuration
Address Family Configuration
Default
N/A
Usage
N/A
Examples
The following example illustrates a Class-A address configured as a network route. The natural Class-A network prefix mask length of 8 will be internally derived, that is, 2.0.0.0/8:
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# network 2.0.0.0
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# no synchronization
Switch(config-router)# network 2.0.0.0
Related Commands
N/A
6.7.68. network synchronization
Command Purpose
Use this command to ensure the exact same static network prefix, specified through any of the network commands, is local or has IGP reachability (in the NSM RIB) before being introduced into the BGP RIB.
Use the no parameter with this command to disable this function.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
network synchronization
no network synchronization
Command Mode
Router Configuration
Address Family Configuration
Default
Network synchronization is disabled by default.
Usage
N/A
Examples
The following example enables IGP synchronization of BGP static network routes in the router configuration mode:
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# network synchronization
Related Commands
N/A
6.7.69. synchronization
Command Purpose
Use this command to enable IGP synchronization of Internal BGP (iBGP) learned routes with the Internal Gateway Protocol (IGP) system in the router configuration mode or in the address-family configuration mode.
Use the no parameter with this command to disable this function.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
synchronization
no synchronization
Command Mode
Router Configuration
Address Family Configuration
Default
IGP synchronization is disabled.
Usage
Synchronization is used when a BGP router should not advertise routes learned from iBGP neighbors, unless those routes are also present in an IGP (for example, OSPF). Synchronization may be enabled when all the routers in an autonomous system do not speak BGP, and the autonomous system is a transit for other autonomous systems. The no synchronization command is used when BGP router can advertise routes learned from its iBGP neighbors without waiting for the IGP reachability to be present.
Examples
The following example enables IGP synchronization of BGP static network routes in the IPv4-Unicast address family:
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config)# address-family ipv4 unicast
Switch(config-af)# network synchronization
Related Commands
N/A
6.7.70. router bgp
Command Purpose
Use this command to configure a BGP routing process.
Use the no parameter with this command to disable a routing process.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
router bgp ASN
no router bgp ASN
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
ASN |
Specifies the Autonomous System (AS) number |
1-4294967295 |
Command Mode
Global Config
Default
N/A
Usage
The router bgp command enables a BGP routing process.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)#
Related Commands
N/A
6.7.71. show debugging bgp
Command Purpose
Use this command to display the BGP debugging option set.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show debugging bgp
Command Mode
Privileged EXEC
Default
N/A
Usage
None
Examples
Switch# show debugging bgp
Related Commands
N/A
6.7.72. show ip bgp
Command Purpose
Use this command to display BGP network information.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip bgp ( IPADDRESS | )
show ip bgp ipv4 PREFIX ( IPADDRESS | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
IPADDRESS |
A.B.C.D|A.B.C.D/M Specifies the address and length. |
IPv4 Address in A.B.C.D format or IPv4 Address and mask length in A.B.C.D/M format |
ipv4 |
Specifies the address family. The type of address family determines the routing table that isSpecifies the address family. The type of address family determines the routing table that isdisplayed. |
- |
PREFIX |
(multicast|unicast) |
- |
unicast |
Specifies a IPv4 unicast address family. This is the default option. |
- |
multicast |
Specifies a IPv4 multicast address family. |
- |
Command Mode
Privileged EXEC
Default
N/A
Usage
N/A
Examples
Switch# show ip bgp 10.10.1.34/24
Related Commands
N/A
6.7.73. show ip bgp attribute-info
Command Purpose
Use this command to show bgp attribute information.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip bgp attribute-info
Command Mode
Privileged EXEC
Default
N/A
Usage
N/A
Examples
This is a sample output from the show ip bgp attribute-info command displaying internal attribute information:
Switch# show ip bgp attribute-info
Related Commands
N/A
6.7.74. show ip bgp cidr-only
Command Purpose
Use this command to display routes with non-natural network masks.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip bgp cidr-only
show ip bgp ipv4 PREFIX cidr-only
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
ipv4 |
Specifies the address family. The type of address family determines the routing table that is displayed. |
- |
PREFIX |
(multicast|unicast) |
- |
unicast |
Specifies a IPv4 unicast address family. This is the default option. |
- |
multicast |
Specifies a IPv4 multicast address family. |
- |
Command Mode
Privileged EXEC
Default
N/A
Usage
N/A
Examples
This is a sample output from the show ip bgp cidr-only command:
Switch# show ip bgp cidr-only
Related Commands
N/A
6.7.75. show ip bgp community
Command Purpose
Use this command to display routes matching the communities.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip bgp community TYPE ( exact-match | )
show ip bgp ipv4 PREFIX community TYPE ( exact-match | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
TYPE |
- AA:NNn o-advertise|no-export |
- |
AA:NN |
Specifies the valid value for the community number. This format epresents the 32 bit communities value, where AS is the high order 16 bits and VAL is the low order 16 bits in digit format. |
AA is in the range 1-65535NN is in the range of 1-65535 |
local-AS |
Do not send outside local AS (well-known community). |
- |
no-advertise |
Do not advertise to any peer (well-known community). |
- |
no-export |
Do not export to next AS (well-known community). |
- |
exact-match |
Specifies that display the exact match of the communities. |
- |
PREFIX |
(multicast|unicast) |
- |
multicast |
Specifies a IPv4 multicast address family. |
- |
unicast |
Specifies a IPv4 unicast address family. This is the default option. |
- |
Command Mode
Privileged EXEC
Default
N/A
Usage
N/A
Examples
Switch# show ip bgp community 10:23 exact-match
Switch# show ip bgp ipv4 multicast community 10:23 exact-match
Related Commands
N/A
6.7.76. show ip bgp community-info
Command Purpose
Use this command to list all BGP community information.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip bgp community-info
Command Mode
Privileged EXEC
Default
N/A
Usage
N/A
Examples
Switch# show ip bgp community-info
Related Commands
N/A
6.7.77. show ip bgp community-list
Command Purpose
Use this command to display routes that match the community-list.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip bgp community-list LISTNAME ( exact-match | )
show ip bgp ipv4 PREFIX community-list LISTNAME ( exact-match | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
LISTNAME |
Specifies the community list name. |
Up to 20 characters |
exact-match |
Displays only routes that have exactly the same specified communities. |
- |
ipv4 |
Specifies the address family. The type of address family determines the routing table that isSpecifies the address family. The type of address family determines the routing table that isdisplayed. |
- |
PREFIX |
(multicast|unicast) |
- |
unicast |
Specifies a IPv4 unicast address family. This is the default option. |
- |
multicast |
Specifies a IPv4 multicast address family. |
- |
Command Mode
Privileged EXEC
Default
N/A
Usage
N/A
Examples
Switch# show ip bgp community-list mylist exact-match
Switch# show ip bgp ipv4 unicast community-list mylist
Related Commands
N/A
6.7.78. show ip bgp dampening
Command Purpose
Use this command to display detailed information about dampening.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip bgp dampening ( dampened-paths | flap-statistics | parameters )
show ip bgp ipv4 PREFIX dampening ( dampened-paths | flap-statistics | parameters )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
dampened-paths |
Display paths suppressed due to dampening. |
- |
flap-statistics |
Display flap statistics of routes. |
- |
parameters |
Display details of configured dampening parameters. |
- |
ipv4 |
Specifies the address family. The type of address family determines the routing table that is displayed. |
- |
PREFIX |
(multicast|unicast) |
- |
unicast |
Specifies a IPv4 unicast address family. This is the default option. |
- |
multicast |
Specifies a IPv4 multicast address family. |
- |
Command Mode
Privileged EXEC
Default
N/A
Usage
N/A
Examples
Enable bgp dampening to maintain dampened-path information in memory. The following is a sample output displaying all the dampening parameters:
Switch# show ip bgp dampening parameters
Related Commands
N/A
6.7.79. show ip bgp filter-list
Command Purpose
Use this command to display routes conforming to the filter-list.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip bgp filter-list LISTNAME
show ip bgp ipv4 PREFIX filter-list LISTNAME
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
LISTNAME |
Specifies the regular-expression access list name. |
Up to 20 characters |
ipv4 |
Specifies the address family. The type of address family determines the routing table that is Specifies the address family. The type of address family determines the routing table that isdisplayed. |
- |
PREFIX |
(multicast|unicast) |
- |
unicast |
Specifies a IPv4 unicast address family. This is the default option. |
- |
multicast |
Specifies a IPv4 multicast address family. |
- |
Command Mode
Privileged EXEC
Default
N/A
Usage
N/A
Examples
Switch# show ip bgp filter-list mylist
Switch# show ip bgp ipv4 unicast filter-list Switch
Related Commands
N/A
6.7.80. show ip bgp inconsistent-as
Command Purpose
Use this command to display routes with inconsistent AS Paths.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip bgp inconsistent-as
show ip bgp ipv4 PREFIX inconsistent-as
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
ipv4 |
Specifies the address family. The type of address family determines the routing table that is displayed. |
- |
PREFIX |
(multicast|unicast) |
- |
unicast |
Specifies a IPv4 unicast address family. This is the default option. |
- |
multicast |
Specifies a IPv4 multicast address family. |
- |
Command Mode
Privileged EXEC
Default
N/A
Usage
N/A
Examples
Switch# show ip bgp inconsistent-as
Switch# show ip bgp ipv4 unicast inconsistent-as
Related Commands
N/A
6.7.81. show ip bgp neighbors
Command Purpose
Use this command to display detailed information on TCP and BGP neighbor connections.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip bgp neighbors ( IPADDRESS ( advertised-routes | RECEIVED | received-routes | routes ) | )
show ip bgp ipv4 PREFIX neighbors ( IPADDRESS ( advertised-routes | received | received-routes | routes ) | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
IPADDRESS |
Specifies an IPv4 address. |
IPv4 Address in A.B.C.D format |
advertised-routes |
Displays the routes advertised to a BGP neighbor. |
- |
received |
received prefix-filter Displays all received routes, both accepted and rejected. |
- |
prefix-filter |
Displays the prefix-list filter. |
|
received-routes |
Displays the received routes from neighbor. To display all the received routes from the neighbor, configure the BGP soft reconfigure first. routes Displays all accepted routes learned from neighbors. |
- |
routes |
Display routes learned from neighbor |
- |
PREFIX |
(multicast|unicast) |
- |
unicast |
Specifies a IPv4 unicast address family. This is the default option. |
- |
multicast |
Specifies a IPv4 multicast address family. |
- |
ipv4 |
Specifies the address family. The type of address family determines the routing table that is displayed. |
- |
Command Mode
Privileged EXEC
Default
N/A
Usage
N/A
Examples
This is a sample output from the show ip bgp neighbors command displaying information about the specified neighbor:
Switch# show ip bgp neighbors
Related Commands
N/A
6.7.82. show ip bgp paths
Command Purpose
Use this command to display BGP path information.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip bgp paths
show ip bgp ipv4 PREFIX paths
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
ipv4 |
Specifies the address family. The type of address family determines the routing table that is displayed. |
- |
PREFIX |
(multicast|unicast) |
- |
unicast |
Specifies a IPv4 unicast address family. This is the default option. |
- |
multicast |
Specifies a IPv4 multicast address family. |
- |
Command Mode
Privileged EXEC
Default
N/A
Usage
N/A
Examples
Switch# show ip bgp paths
Related Commands
N/A
6.7.83. show ip bgp prefix-list
Command Purpose
Use this command to display routes matching the prefix-list.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip bgp prefix-list LIST
show ip bgp ipv4 PREFIX prefix-list LIST
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
LIST |
Specifies the name of the IP prefix list. |
Up to 40 characters |
ipv4 |
Specifies the address family. The type of address family determines the routing table that is displayed. |
- |
PREFIX |
(multicast|unicast) |
- |
unicast |
Specifies a IPv4 unicast address family. This is the default option. |
- |
multicast |
Specifies a IPv4 multicast address family. |
- |
Command Mode
Privileged EXEC
Default
N/A
Usage
N/A
Examples
Switch# show ip bgp prefix-list mylist
Related Commands
N/A
6.7.84. show ip bgp quote-regexp
Command Purpose
Use this command to display routes matching the AS path regular expression in quotes.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip bgp quote-regexp LINE
show ip bgp ipv4 PREFIX quote-regexp LINE
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
LINE |
Specifies a regular-expression to match the BGP AS paths |
A regular-expression in quote |
ipv4 |
Specifies the address family. The type of address family determines the routing table that is displayed. |
- |
PREFIX |
(multicast|unicast) |
- |
unicast |
Specifies a IPv4 unicast address family. This is the default option. |
- |
multicast |
Specifies a IPv4 multicast address family. |
- |
Command Mode
Privileged EXEC
Default
N/A
Usage
N/A
Examples
Switch# show ip bgp quote-regexp "Switch"
Related Commands
N/A
6.7.85. show ip bgp regexp
Command Purpose
Use this command to display routes matching the AS path regular expression.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip bgp regexp LINE
show ip bgp ipv4 PREFIX regexp LINE
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
regexp |
Displays routes matching the AS path regular expression. |
- |
LINE |
Specifies a regular expression to match the BGP AS paths. |
A regular-expression |
ipv4 |
Specifies the address family. The type of address family determines the routing table that is displayed. |
- |
PREFIX |
(multicast|unicast) |
- |
unicast |
Specifies a IPv4 unicast address family. This is the default option. |
- |
multicast |
Specifies a IPv4 multicast address family. |
- |
Command Mode
Privileged EXEC
Default
N/A
Usage
N/A
Examples
Switch# show ip bgp regexp myexpression
Related Commands
N/A
6.7.86. show ip bgp scan
Command Purpose
Use this command to display BGP scan status.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip bgp scan
Command Mode
Privileged EXEC
Default
N/A
Usage
N/A
Examples
Switch# show ip bgp scan
Related Commands
N/A
6.7.87. show ip bgp summary
Command Purpose
Use this command to display a summary of BGP neighbor status.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip bgp summary
show ip bgp ipv4 PREFIX summary
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
ipv4 |
Specifies the address family. The type of address family determines the routing table that is displayed. |
- |
PREFIX |
(multicast|unicast) |
- |
unicast |
Specifies a IPv4 unicast address family. This is the default option. |
- |
multicast |
Specifies a IPv4 multicast address family. |
- |
Command Mode
Privileged EXEC
Default
N/A
Usage
N/A
Examples
This is a sample output from the show ip bgp summary command displaying a summary of BGP neighbor status:
Switch# show ip bgp summary
Related Commands
N/A
6.7.88. show ip bgp vpnv4 all
Command Purpose
Use this command to display VPNv4 NLRI specific information.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip bgp vpnv4 all TYPE
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
all |
Displays information about all VPNv4 NLRIs |
- |
TYPE |
(A.B.C.D|summary|neighbors) |
- |
neighbors |
Displays information about BGP neighbors. |
- |
summary |
Displays summary of the BGP neighbor status. |
- |
A.B.C.D |
Network for which information will be displayed in the BGP routing table. |
IPv4 Address in A.B.C.D format |
Command Mode
Privileged EXEC
Default
N/A
Usage
N/A
Examples
This is a sample output from the show ip bgp vpnv4 all command displaying VPNv4 specific information:
Switch# show ip bgp vpnv4 all
Related Commands
N/A
6.7.89. show ip bgp vpnv4 rd
Command Purpose
Use this command to display VPNv4 NLRI specific information.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip bgp vpnv4 rd WORD TYPE
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
rd |
Display information for a route distinguisher |
- |
WORD |
VPN Route Distinguisher |
Up to 15 characters |
TYPE |
- (A.B.C. Dsummary|) |
- |
neighbors |
Displays information about BGP neighbors. |
- |
summary |
Displays summary of the BGP neighbor status. |
- |
A.B.C.D |
Network for which information will be displayed in the BGP routing table. |
IPv4 Address in A.B.C.D format |
Command Mode
Privileged EXEC
Default
N/A
Usage
N/A
Examples
This is a sample output from the show ip bgp vpnv4 rd command displaying VPNv4 specific information:
Switch# show ip bgp vpnv4 rd 123
Related Commands
N/A
6.7.90. show ip bgp vpnv4 vrf
Command Purpose
Use this command to display VPNv4 NLRI specific information.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip bgp vpnv4 vrf WORD TYPE
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
vrf |
VPN Routing/Forwarding instance |
- |
WORD |
VPN Routing/Forwarding instance name |
Up to 15 characters |
TYPE |
- (A.B.C. Dsummary|) |
- |
neighbors |
Displays information about BGP neighbors. |
- |
summary |
Displays summary of the BGP neighbor status. |
- |
A.B.C.D |
Network for which information will be displayed in the BGP routing table. |
IPv4 Address in A.B.C.D format |
Command Mode
Privileged EXEC
Default
N/A
Usage
N/A
Examples
This is a sample output from the show ip bgp vpnv4 rd command displaying VPNv4 specific information:
Switch# show ip bgp vpnv4 vrf 123
Related Commands
N/A
6.7.91. timers
Command Purpose
Use this command sets the BGP keepalive timer and holdtime timer values.
Use the no parameter with this command to reset timers to default value.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
timers bgp KEEPALIVE HOLDTIME
no timers bgp
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
KEEPALIVE |
<0-65535> The frequency with which the keepalive messages are sent to the neighbors.The default value is 60 seconds. |
0-65535 |
HOLDTIME |
The interval after which the neighbor is considered dead if keepalive messagesare not received. The default holdtime value is 180 seconds. |
3-65535 |
Command Mode
Router Configuration
Default
N/A
Usage
This command is used globally to set or unset the keepalive and holdtime values for all the neighbors.
Examples
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# timers bgp 40 120
Related Commands
N/A
6.7.92. max-paths
Command Purpose
Use this command to change the maximum ecmp.
Use the no parameter with this command to revert to the default setting.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
max-paths ( ebgp | ibgp ) PATHS
no max-paths ( ebgp | ibgp ) ( PATHS | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
ebgp |
Session EBGP ECMP |
- |
ibgp |
Session IBGP ECMP |
- |
PATHS |
Set multipath ECMP numbers for BGP |
2-64 |
Command Mode
Router Configuration
Default
The default local preference value is 1.
Usage
None
Examples
The following example shows how to configure max-paths.:
Switch# configure terminal
Switch(config)# router bgp 1
Switch(config-router)# max-paths ebgp 2
Related Commands
N/A