Network Protocols Command Reference, Part 1
IP Routing Protocols Commands

Table Of Contents

IP Routing Protocols Commands

accept-lifetime

aggregate-address

area authentication

area default-cost

area nssa

area-password

area range

area stub

area virtual-link

autonomous-system (EGP)

auto-summary

bgp always-compare-med

bgp client-to-client reflection

bgp cluster-id

bgp confederation identifier

bgp confederation peers

bgp default local-preference

bgp fast-external-fallover

clear arp-cache

clear ip bgp

clear ip bgp peer-group

clear ip cgmp

clear ip dvmrp route

clear ip eigrp neighbors

clear ip igmp group

clear ip mroute

clear ip route

clear ip sdr

default-information

default-information originate (BGP)

default-information originate (EGP)

default-information originate (IS-IS)

default-information originate (OSPF)

default-metric (BGP, EGP, OSPF, and RIP)

default-metric (IGRP and Enhanced IGRP only)

distance

distance bgp

distance eigrp

distribute-list in

distribute-list out

domain-password

eigrp log-neighbor-changes

ip as-path access-list

ip bandwidth-percent eigrp

ip cgmp

ip community-list

ip default-network

ip dvmrp accept-filter

ip dvmrp auto-summary

ip dvmrp default-information

ip dvmrp metric

ip dvmrp metric-offset

ip dvmrp reject-non-pruners

ip dvmrp routehog-notification

ip dvmrp route-limit

ip dvmrp summary-address

ip dvmrp unicast-routing

ip gdp

ip hello-interval eigrp

ip hold-time eigrp

ip igmp access-group

ip igmp join-group

ip igmp query-interval

ip igmp query-max-response-time

ip igmp query-timeout

ip igmp static-group

ip igmp version

ip irdp

ip local policy route-map

ip mroute

ip mroute-cache

ip multicast boundary

ip multicast cache-headers

ip multicast helper-map

ip multicast rate-limit

ip multicast-routing

ip multicast ttl-threshold

ip ospf authentication-key

ip ospf cost

ip ospf dead-interval

ip ospf demand-circuit

ip ospf hello-interval

ip ospf message-digest-key

ip ospf name-lookup

ip ospf network

ip ospf priority

ip ospf retransmit-interval

ip ospf transmit-delay

ip pim

ip pim accept-rp

ip pim message-interval

ip pim nbma-mode

ip pim query-interval

ip pim rp-address

ip pim rp-announce-filter

ip pim send-rp-announce

ip pim send-rp-discovery

ip pim spt-threshold

ip policy route-map

ip rip authentication key-chain

ip rip authentication mode

ip rip receive version

ip rip send version

ip route

ip router isis

ip rsvp bandwidth

ip rsvp neighbors

ip rsvp reservation

ip rsvp sender

ip rsvp udp-multicast

ip sdr cache-timeout

ip sdr listen

ip split-horizon

ip split-horizon eigrp

ip summary-address eigrp

isis circuit-type

isis csnp-interval

isis hello-interval

isis metric

isis password

isis priority

isis retransmit-interval

is-type

key

key chain

key-string

match as-path

match community-list

match interface

match ip address

match ip next-hop

match ip route-source

match length

match metric

match route-type

match tag

maximum-paths

mbranch

metric holddown

metric maximum-hops

metric weights

mrbranch

mrinfo

mstat

mtrace

ping

neighbor (EGP, EIGRP, IGRP, RIP)

neighbor (OSPF)

neighbor advertisement-interval

neighbor any

neighbor any third-party

neighbor configure-neighbors

neighbor default-originate

neighbor distribute-list

neighbor ebgp-multihop

neighbor filter-list

neighbor neighbor-list

neighbor next-hop-self

neighbor password

neighbor peer-group (assigning members)

neighbor peer-group (creating)

neighbor remote-as

neighbor route-map

neighbor route-reflector-client

neighbor send-community

neighbor soft-reconfiguration inbound

neighbor third-party

neighbor update-source

neighbor version

neighbor weight

net

network (BGP)

network (EGP)

network (IGRP and Enhanced IGRP)

network (RIP)

network area

network backdoor

network weight

offset-list

ospf auto-cost

ospf log-adj-changes

output-delay

passive-interface

redistribute

route-map

router bgp

router egp

router egp 0

router eigrp

router igrp

router isis

router odr

router ospf

router rip

send-lifetime

set as-path

set automatic-tag

set community

set default interface

set interface

set ip default next-hop

set ip next-hop

set ip precedence

set level

set local-preference

set metric

set metric

set metric-type

set metric-type internal

set next-hop

set origin

set-overload-bit

set tag

set weight

show ip bgp

show ip bgp cidr-only

show ip bgp community

show ip bgp community-list

show ip bgp filter-list

show ip bgp inconsistent-as

show ip bgp neighbors

show ip bgp paths

show ip bgp peer-group

show ip bgp regexp

show ip bgp summary

show ip dvmrp route

show ip egp

show ip eigrp interfaces

show ip eigrp neighbors

show ip eigrp topology

show ip eigrp traffic

show ip igmp groups

show ip igmp interface

show ip irdp

show ip local policy

show ip mcache

show ip mroute

show ip ospf

show ip ospf border-routers

show ip ospf database

show ip ospf interface

show ip ospf neighbor

show ip ospf request-list

show ip ospf retransmission-list

show ip ospf virtual-links

show ip pim interface

show ip pim neighbor

show ip pim rp

show ip policy

show ip protocols

show ip route

show ip route summary

show ip route supernets-only

show ip rpf

show ip rsvp interface

show ip rsvp interface installed

show ip rsvp neighbor

show ip rsvp sender

show ip rsvp request

show ip rsvp reservation

show ip sdr

show isis database

show key chain

show route-map

summary-address

synchronization

table-map

timers basic (EGP, RIP, IGRP)

timers bgp

timers egp

timers spf

traffic-share

validate-update-source

variance

version


IP Routing Protocols Commands


Cisco's implementation of the Internet Protocol (IP) suite provides all major services contained in the Transmission Control Protocol (TCP)/IP specifications.

Use the commands in this chapter to configure and monitor the IP routing protocols. For IP routing protocol configuration information and examples, refer to the "Configuring IP Routing Protocols" chapter of the Network Protocols Configuration Guide, Part 1.

accept-lifetime

To set the time period during which the authentication key on a key chain is received as valid, use the accept-lifetime key chain key configuration command. To revert to the default value, use the no form of this command.

accept-lifetime start-time {infinite | end-time | duration seconds}
no accept-lifetime [start-time {infinite | end-time | duration seconds}]

Syntax Description

start-time

Beginning time that the key specified by the key command is valid to be received. The syntax can be either of the following:

        hh:mm:ss Month date year

        hh:mm:ss date Month year

hh—hours

mm—minutes

ss—seconds

date—date (1-31)

Month—first three letters of the month

year—year (four digits)

The default start time and the earliest acceptable date is January 1, 1993.

infinite

Key is valid to be received from the start-time on.

end-time

Key is valid to be received from the start-time until end-time. The end-time must be after the start-time. The syntax is the same as that for start-time. The default end time is an infinite time period.

duration seconds

Length of time (in seconds) that the key is valid to be received.


Default

Forever (Starting time is January 1, 1993, and ending time is infinite.)

Command Mode

Key chain key configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 11.1.

Only RIP Version 2 uses key chains.

Specify a start-time and one of the following: infinite, end-time, or duration seconds.

We recommend running NTP or some other time synchronization method if you assign a lifetime to a key.

If the last key expires, authentication will continue and an error message will be generated. To disable authentication, you must manually delete the last valid key.

Examples

The following example configures a key chain called trees. In this example, the software will always accept and send willow as a valid key.

interface ethernet 0
  ip rip authentication key-chain trees
  ip rip authentication mode md5
!
router rip
  network 172.19.0.0
  version 2
!
key chain trees
  key 1
     key-string willow

In the following example, the key chestnut will be accepted from 1:30 p.m. to 3:30 p.m. and be sent from 2:00 p.m. to 3:00 p.m. The key birch will be accepted from 2:30 p.m. to 4:40 p.m. and be sent from 3:00 p.m. to 4:00 p.m. The overlap allows for migration of keys or discrepancies in the router's set time. There is a half hour leeway on each side to handle time differences.

interface ethernet 0
  ip rip authentication key-chain trees
  ip rip authentication mode md5
!
router rip
  network 172.19.0.0
  version 2
!
key chain trees
    key 1
     key-string chestnut
     accept-lifetime 13:30:00 Jan 25 1996 duration 7200
     send-lifetime 14:00:00 Jan 25 1996 duration 3600
  key 2
     key-string birch
     accept-lifetime 14:30:00 Jan 25 1996 duration 7200
     send-lifetime 15:00:00 Jan 25 1996 duration 3600

Related Commands

key
key chain
key-string
send-lifetime
show key chain

aggregate-address

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

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

Syntax Description

address

Aggregate address.

mask

Aggregate mask.

as-set

(Optional) Generates autonomous system set path information.

summary-only

(Optional) Filters all more specific routes from updates.

suppress-map map-name

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

advertise-map map-name

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

attribute-map map-name

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


Default

Disabled

Command Mode

Router configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

You can implement aggregate routing in BGP either by redistributing an aggregate route into BGP or by using this conditional aggregate routing feature.

Using the aggregate-address command with no arguments will create an aggregate entry in the BGP routing table if there are any more-specific BGP routes available that fall in the specified range. The aggregate route will be advertised as coming from your autonomous system and has the atomic aggregate attribute set to show that information might be missing. (By default, the atomic aggregate attribute is set unless you specify the as-set keyword.)

Using the as-set keyword creates an aggregate entry using the same rules that the command follows without this keyword, but the path advertised for this route will be an AS_SET consisting of all elements contained in all paths that are being summarized. Do not use this form of aggregate-address when aggregating many paths, because this route must be continually withdrawn and re-updated as autonomous system path reachability information for the summarized routes changes.

Using the summary-only keyword not only creates the aggregate route (for example, 193.*.*.*) but will also suppress advertisements of more-specific routes to all neighbors. If you only want to suppress advertisements to certain neighbors, you may use the neighbor distribute-list command, with caution. If a more specific route leaks out, all BGP speakers will prefer that route over the less-specific aggregate you are generating (using longest-match routing).

Using the suppress-map keyword creates the aggregate route but suppresses advertisement of specified routes. You can use the match clauses of route maps to selectively suppress some more specific routes of the aggregate and leave others unsuppressed. IP access lists and autonomous system path access lists match clauses are supported.

Example

In the following example, an aggregate address is created. The path advertised for this route will be an AS_SET consisting of all elements contained in all paths that are being summarized.

router bgp 5
aggregate-address 193.0.0.0 255.0.0.0 as-set

Related Commands

match as-path
match ip address
route-map

area authentication

To enable authentication for an OSPF area, use the area authentication router configuration command. To remove an area's authentication specification or a specified area from the configuration, use the no form of this command.

area area-id authentication [message-digest]
no area area-id authentication
no area area-id

Syntax Description

area-id

Identifier of the area for which authentication is to be enabled. The identifier can be specified as either a decimal value or an IP address.

message-digest

(Optional) Enables MD5 authentication on the area specified by area-id.


Default

Type 0 authentication (no authentication)

Command Mode

Router configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0. The message-digest keyword first appeared in Cisco IOS Release 11.0.

Specifying authentication for an area sets the authentication to Type 1 (simple password) as specified in RFC 1247. If this command is not included in the configuration file, authentication of Type 0 (no authentication) is assumed.

The authentication type must be the same for all routers and access servers in an area. The authentication password for all OSPF routers on a network must be the same if they are to communicate with each other via OSPF. Use the ip ospf authentication-key command to specify this password.

If you enable MD5 authentication with the message-digest keyword, you must configure a password with the ip ospf message-digest-key command.

To remove the area's authentication specification, use the no form of this command with the authentication keyword. To remove the specified area from the software configuration, use the command no area area-id (with no other keywords).


Note   To remove the specified area from the software configuration, use the command no area area-id (with no other keywords). That is, no area area-id removes all area options, such as area authentication, area default-cost, area nssa, area range, area stub, and area virtual-link.


Example

The following example mandates authentication for areas 0 and 36.0.0.0 of OSPF routing process 201. Authentication keys are also provided.

interface ethernet 0
ip address 131.119.251.201 255.255.255.0
ip ospf authentication-key adcdefgh
!
interface ethernet 1
ip address 36.56.0.201 255.255.0.0
ip ospf authentication-key ijklmnop
!
router ospf 201
network 36.0.0.0 0.255.255.255 area 36.0.0.0
network 131.119.0.0 0.0.255.255 area 0
area 36.0.0.0 authentication
area 0 authentication

Related Commands

area default-cost
area stub
ip ospf authentication-key
ip ospf message-digest-key

area default-cost

To specify a cost for the default summary route sent into a stub area, use the area default-cost router configuration command. To remove the assigned default route cost, use the no form of this command.

area area-id default-cost cost
no area area-id default-cost cost
no area area-id

Syntax Description

area-id

Identifier for the stub area. The identifier can be specified as either a decimal value or as an IP address.

cost

Cost for the default summary route used for a stub area. The acceptable value is a 24-bit number.


Default

Cost of 1

Command Mode

Router configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

The command is used only on an area border router attached to a stub area.

There are two stub area router configuration commands: the stub and default-cost options of the area command. In all routers and access servers attached to the stub area, the area should be configured as a stub area using the stub option of the area command. Use the default-cost option only on an area border router attached to the stub area. The default-cost option provides the metric for the summary default route generated by the area border router into the stub area.


Note   To remove the specified area from the software configuration, use the command no area area-id (with no other keywords). That is, no area area-id removes all area options, such as area authentication, area default-cost, area nssa, area range, area stub, and area virtual-link.


Example

The following example assigns a default-cost of 20 to stub network 36.0.0.0:

interface ethernet 0
ip address 36.56.0.201 255.255.0.0
!
router ospf 201
network 36.0.0.0 0.255.255.255 area 36.0.0.0
area 36.0.0.0 stub
area 36.0.0.0 default-cost 20

Related Commands

area authentication
area stub

area nssa

To configure an area as a not so stubby area (NSSA), use the area nssa router configuration command. To remove the nssa distinction from the area, use the no form of this command.

area area-id nssa [no-redistribution] [default-information-originate]
no area area-id nssa
no area area-id

Syntax Description

area-id

Identifier of the area for which authentication is to be enabled. The identifier can be specified as either a decimal value or an IP address.

no-redistribution

(Optional) Used when the router is a NSSA ABR and you want the redistribute command to import routes only into the normal areas, but not into the NSSA area.

default-information-
originate

(Optional) Used to generate a Type 7 default into the NSSA area. This argument only takes effect on NSSA ABR.


Default

No NSSA area is defined.

Command Mode

Router configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.


Note   To remove the specified area from the software configuration, use the command no area area-id (with no other keywords). That is, no area area-id removes all area options, such as area authentication, area default-cost, area nssa, area range, area stub, and area virtual-link.


Example

In the following example, NSSA authentication is enabled on area 1:

router ospf1
redistribute rip subnets
network 172.19.92.0.0.0.0.255 area 1
area 1 nssa

area-password

To configure the IS-IS area authentication password, use the area-password router configuration command. To disable the password, use the no form of this command.

area-password password
no area-password [password]

Syntax Description

password

Password you assign.


Default

No area password is defined.

Command Mode

Router configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

This password is inserted in Level 1 (station router level) link state PDUs (LSPs), complete sequence number PDUs (CSNPs), and partial sequence number PDUs (PSNP).

Example

The following example assigns an area authentication password:

router isis
area-password angel

Related Command

domain-password

area range

To consolidate and summarize routes at an area boundary, use the area range router configuration command. To disable this function, use the no form of this command.

area area-id range address mask [advertise | not-advertise]
no area area-id range address mask [advertise | not-advertise]
no area area-id

Syntax Description

area-id

Identifier of the area about which routes are to be summarized. It can be specified as either a decimal value or as an IP address.

address

IP address.

mask

IP mask.

advertise

(Default) Sets the address range status to advertise and generates a Type 3 summary LSA.

not-advertise

Sets the address range status to DoNotAdvertise. The Type 3 summary LSA is suppressed and the component networks remain hidden from other networks.


Default

Disabled

Command Mode

Router configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

The area range command is used only with area border routers (ABRs). It is used to consolidate or summarize routes for an area. The result is that a single summary route is advertised to other areas by the ABR. Routing information is condensed at area boundaries. External to the area, a single route is advertised for each address range. This is called route summarization.

Multiple area router configuration commands specifying the range option can be configured. Thus, OSPF can summarize addresses for many different sets of address ranges.


Note   To remove the specified area from the software configuration, use the command no area area-id (with no other keywords). That is, no area area-id removes all area options, such as area authentication, area default-cost, area nssa, area range, area stub, and area virtual-link.


Example

The following example specifies one summary route to be advertised by the ABR to other areas for all subnets on network 36.0.0.0 and for all hosts on network 192.42.110.0:

interface ethernet 0
ip address 192.42.110.201 255.255.255.0
!
interface ethernet 1
ip address 36.56.0.201 255.255.0.0
!
router ospf 201
network 36.0.0.0 0.255.255.255 area 36.0.0.0
network 192.42.110.0 0.0.0.255 area 0
area 36.0.0.0 range 36.0.0.0 255.0.0.0
area 0 range 192.42.110.0 255.255.255.0

area stub

To define an area as a stub area, use the area stub router configuration command. To disable this function, use the no form of this command.

area area-id stub [no-summary]
no area area-id stub
no area area-id

Syntax Description

area-id

Identifier for the stub area. The identifier can be either a decimal value or an IP address.

no-summary

(Optional) Prevents an ABR from sending summary link advertisements into the stub area.


Default

No stub area is defined.

Command Mode

Router configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

You must configure the area stub command on all routers and access servers in the stub area. Use the area router configuration command with the default-cost option to specify the cost of a default internal router sent into a stub area by an area border router.

There are two stub area router configuration commands: the stub and default-cost options of the area router configuration command. In all routers attached to the stub area, the area should be configured as a stub area using the stub option of the area command. Use the default-cost option only on an ABR attached to the stub area. The default-cost option provides the metric for the summary default route generated by the area border router into the stub area.

To further reduce the number of link state advertisements (LSA) sent into a stub area, you can configure no-summary on the ABR to prevent it from sending summary LSAs (LSA type 3) into the stub area.


Note   To remove the specified area from the software configuration, use the command no area area-id (with no other keywords). That is, no area area-id removes all area options, such as area authentication, area default-cost, area nssa, area range, area stub, and area virtual-link.


Example

The following example assigns a default cost of 20 to stub network 36.0.0.0:

interface ethernet 0
ip address 36.56.0.201 255.255.0.0
!
router ospf 201
network 36.0.0.0 0.255.255.255 area 36.0.0.0
area 36.0.0.0 stub
area 36.0.0.0 default-cost 20

Related Commands

area authentication
area default-cost

area virtual-link

To define an OSPF virtual link, use the area virtual-link router configuration command with the optional parameters. To remove a virtual link, use the no form of this command.

area area-id virtual-link router-id [hello-interval seconds] [retransmit-interval seconds]
[
transmit-delay seconds] [dead-interval seconds] [[authentication-key key] |
[
message-digest-key keyid md5 key]]
no area area-id virtual-link router-id [hello-interval seconds] [retransmit-interval seconds]
[
transmit-delay seconds] [dead-interval seconds] [[authentication-key key] |
[
message-digest-key keyid md5 key]]
no area area-id

Syntax Description

area-id

Area ID assigned to the transit area for the virtual link. This can be either a decimal value or a valid IP address. There is no default.

router-id

Router ID associated with the virtual link neighbor. The router ID appears in the show ip ospf display. It is internally derived by each router from the router's interface IP addresses. This value must be entered in the format of an IP address. There is no default.

hello-interval seconds

(Optional) Time in seconds between the hello packets that the Cisco IOS software sends on an interface. Unsigned integer value to be advertised in the software's hello packets. The value must be the same for all routers and access servers attached to a common network. The default is 10 seconds.

retransmit-interval seconds

(Optional) Time in seconds between link state advertisement retransmissions for adjacencies belonging to the interface. Expected round-trip delay between any two routers on the attached network. The value must be greater than the expected round-trip delay. The default is 5 seconds.

transmit-delay seconds

(Optional) Estimated time in seconds it takes to transmit a link state update packet on the interface. Integer value that must be greater than zero. Link state advertisements in the update packet have their age incremented by this amount before transmission. The default value is 1 second.

dead-interval seconds

(Optional) Time in seconds that a software's hello packets are not seen before its neighbors declare the router down. Unsigned integer value. The default is four times the hello interval, or 40 seconds. As with the hello interval, this value must be the same for all routers and access servers attached to a common network.

authentication-key key

(Optional) Password to be used by neighboring routers. Any continuous string of characters that you can enter from the keyboard up to 8 bytes long. This string acts as a key that will allow the authentication procedure to generate or verify the authentication field in the OSPF header. This key is inserted directly into the OSPF header when originating routing protocol packets. A separate password can be assigned to each network on a per-interface basis. All neighboring routers on the same network must have the same password to be able to route OSPF traffic. The password is encrypted in the configuration file if the service password-encryption command is enabled. There is no default value.

message-digest-key keyid md5 key

(Optional) Key identifier and password to be used by neighboring routers and this router for MD5 authentication. The keyid is a number in the range 1 to 255. The key is an alphanumeric string of up to 16 characters. All neighboring routers on the same network must have the same key identifier and key to be able to route OSPF traffic. There is no default value.


Defaults

area-id: No area ID is predefined.
router-id: No router ID is predefined.
hello-interval seconds: 10 seconds
retransmit-interval seconds: 5 seconds
transmit-delay seconds: 1 second
dead-interval seconds: 40 seconds
authentication-key key: No key is predefined.
message-digest-key keyid md5 key: No key is predefined.

Command Mode

Router configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0. The following keywords and arguments first appeared in Cisco IOS Release 11.0: message-digest-key keyid md5 key.

In OSPF, all areas must be connected to a backbone area. If the connection to the backbone is lost, it can be repaired by establishing a virtual link.

The smaller the hello interval, the faster topological changes will be detected, but more routing traffic will ensue.

The setting of the retransmit interval should be conservative, or needless retransmissions will result. The value should be larger for serial lines and virtual links.

The transmit delay value should take into account the transmission and propagation delays for the interface.

The Cisco IOS software will use the specified authentication key only when authentication is enabled for the backbone with the area area-id authentication router configuration command.

The two authentication schemes, simple text and MD5 authentication, are mutually exclusive. You can specify one or the other or neither. Any keywords and arguments you specify after authentication-key key or message-digest-key keyid md5 key are ignored. Therefore, specify any optional arguments before such a keyword-argument combination.


Note   Each virtual link neighbor must include the transit area ID and the corresponding virtual link neighbor's router ID in order for a virtual link to be properly configured. Use the show ip ospf EXEC command to see the router ID.



Note   To remove the specified area from the software configuration, use the command no area area-id (with no other keywords). That is, no area area-id removes all area options, such as area authentication, area default-cost, area nssa, area range, area stub, and area virtual-link.


Examples

The following example establishes a virtual link with default values for all optional parameters:

router ospf 201
network 36.0.0.0 0.255.255.255 area 36.0.0.0
area 36.0.0.0 virtual-link 36.3.4.5

The following example establishes a virtual link with MD5 authentication:

router ospf 201
network 36.0.0.0 0.255.255.255 area 36.0.0.0
area 36.0.0.0 virtual-link 36.3.4.5 message-digest-key 3 md5 sa5721bk47

Related Commands

A dagger (†) indicates that the command is documented outside this chapter.

area authentication
service password-encryption

show ip ospf

autonomous-system (EGP)

To specify the local autonomous system that the Cisco IOS software resides in for EGP, use the autonomous-system global configuration command. To remove the autonomous system number, use the no form of this command.

autonomous-system local-as
no autonomous-system local-as

Syntax Description

local-as

Local autonomous system number to which the router belongs.


Default

No local autonomous system is specified.

Command Mode

Global configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

Before you can set up EGP routing, you must specify an autonomous system number. The local autonomous system number will be included in EGP messages sent by the software.

Example

The following sample configuration specifies an autonomous system number of 110:

autonomous-system 110

Related Command

router egp

auto-summary

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

auto-summary
no auto-summary

Syntax Description

This command has no arguments or keywords.

Default

Enabled (the software summarizes subprefixes to the classful network boundary when crossing classful network boundaries).

Command Mode

Router configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

Route summarization reduces the amount of routing information in the routing tables.

By default, BGP does not accept subnets redistributed from IGP. To advertise and carry subnet routes in BGP, use an explicit network command or the no auto-summary command. If you disable auto-summarization and have not entered a network command, you will not advertise network routes for networks with subnet routes unless they contain a summary route.

IP Enhanced IGRP summary routes are given an administrative distance value of 5. You cannot configure this value.

RIP Version 1 always uses automatic summarization. If you are using RIP Version 2, you can turn off automatic summarization by specifying no auto-summary. Disable automatic summarization if you must perform routing between disconnected subnets. When automatic summarization is off, subnets are advertised.

Examples

In the following example, network numbers are not summarized automatically:

router bgp 6
no auto-summary

The following example disables automatic summarization for process eigrp 109:

router eigrp 109
no auto-summary

Related Command

ip summary-address eigrp

bgp always-compare-med

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

bgp always-compare-med
no bgp always-compare-med

Syntax Description

This command has no arguments or keywords.

Default

The Cisco IOS software does not compare MEDs for paths from neighbors in different autonomous systems.

Command Mode

Router configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 11.0.

The MED is one of the parameters that is considered when selecting the best path among many alternative paths. The path with a lower MED is preferred over a path with a higher MED.

By default, during the best-path selection process, MED comparison is done only among paths from the same autonomous system. This command changes the default behavior by allowing comparison of MEDs among paths regardless of the autonomous system from which the paths are received.

Example

In the following example, the BGP speaker in autonomous system 100 is configured to compare MEDs among alternative paths, regardless of the autonomous system from which the paths are received:

router bgp 109
bgp always-compare-med

bgp client-to-client reflection

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

bgp client-to-client reflection
no bgp client-to-client reflection

Syntax Description

This command has no arguments or keywords.

Default

When a route reflector is configured, the route reflector reflects routes from a client to other clients.

Command Mode

Router configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 11.1.

By default, the clients of a route reflector are not required to be fully meshed and the routes from a client are reflected to other clients. However, if the clients are fully meshed, route reflection is not required. Use the no bgp client-to-client reflection command to disable client-to-client reflection.

If client-to-client reflection is enabled, the clients of a route reflector cannot be members of a peer group.

Example

In the following example, the local router is a route reflector. The three neighbors are fully meshed, so client-to-client reflection is disabled.

router bgp 5
neighbor 155.24.95.22 route-reflector-client
neighbor 155.24.95.23 route-reflector-client
neighbor 155.24.95.24 route-reflector-client
no bgp client-to-client reflection

Related Commands

bgp cluster-id
neighbor route-reflector-client
show ip bgp

bgp cluster-id

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

bgp cluster-id cluster-id
no bgp cluster-id cluster-id

Syntax Description

cluster-id

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


Default

The router ID of the single route reflector in a cluster

Command Mode

Router configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 11.0.

Together, a route reflector and its clients form a cluster.

Usually a cluster of clients will have a single route reflector. In that case, the cluster is identified by the router ID of the route reflector. In order to increase redundancy and avoid a single point of failure, a cluster might have more than one route reflector. In this case, all route reflectors in the cluster must be configured with the 4-byte cluster ID so that a route reflector can recognize updates from route reflectors in the same cluster.

If the cluster has more than one route reflector, use this command to configure the cluster ID.

Example

In the following example, the local router is one of the route reflectors serving the cluster. It is configured with the cluster ID to identify the cluster.

router bgp 5
neighbor 198.92.70.24 route-reflector-client
bgp cluster-id 50000

Related Commands

bgp client-to-client reflection
neighbor route-reflector-client
show ip bgp

bgp confederation identifier

To specify a BGP confederation identifier, use the bgp confederation identifier router configuration command. To remove the confederation identifier, use the no form of this command.

bgp confederation identifier autonomous-system
no bgp confederation identifier autonomous-system

Syntax Description

autonomous-system

Autonomous system number that internally includes multiple autonomous systems.


Default

No confederation identifier is configured.

Command Mode

Router configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.3.

Another way to reduce the IBGP mesh is to divide an autonomous system into multiple autonomous systems and group them into a single confederation. Each autonomous system is fully meshed within itself, and has a few connections to another autonomous system in the same confederation. Even though the peers in different autonomous systems have EBGP sessions, they exchange routing information as if they are IBGP peers. Specifically, the next-hop and local preference information is preserved. This enables to you to retain a single Interior Gateway Protocol (IGP) for all the autonomous systems. To the outside world, the confederation looks like a single autonomous system.

Example

In the following example, the autonomous system is divided into autonomous systems 4001, 4002, 4003, 4004, 4005, 4006, and 4007 and identified by the confederation identifier 5. Neighbor 1.2.3.4 is someone inside your routing domain confederation. Neighbor 3.4.5.6 is someone outside your routing domain confederation. To the outside world, there appears to be a single autonomous system with the number 5.

router bgp 4001
bgp confederation identifier 5
bgp confederation peers 4002 4003 4004 4005 4006 4007
neighbor 1.2.3.4 remote-as 4002
neighbor 3.4.5.6 remote-as 510

Related Command

bgp confederation peers

bgp confederation peers

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

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

Syntax Description

autonomous-system

Autonomous system number.


Default

No confederation peers are configured.

Command Mode

Router configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.3.

The autonomous systems specified in this command are visible internally to a confederation. Each autonomous system is fully meshed within itself. The bgp confederation identifier command specifies the confederation to which the autonomous systems belong.

Example

The following example specifies that autonomous systems 1090, 1091, 1092, and 1093 belong to a single confederation:

router bgp 1090
bgp confederation peers 1091 1092 1093

Related Command

bgp confederation identifier

bgp default local-preference

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

bgp default local-preference value
no bgp default local-preference value

Syntax Description

value

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


Default

Local preference value of 100

Command Mode

Router configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

Generally, the default value of 100 allows you to easily define a particular path as less preferable than paths with no local preference attribute. The preference is sent to all routers and access servers in the local autonomous system.

Example

In the following example, the default local preference value is raised from the default of 100 to 200:

router bgp 200
bgp default local-preference 200

Related Command

set local-preference

bgp fast-external-fallover

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

bgp fast-external-fallover
no bgp fast-external-fallover

Syntax Description

This command has no arguments or keywords.

Default

Enabled

Command Mode

Router configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

Example

In the following example, the automatic resetting of BGP sessions is disabled:

router bgp 109
no bgp fast-external-fallover

clear arp-cache

To remove all dynamic entries from the ARP cache and to clear the fast-switching cache, use the clear arp-cache EXEC command.

clear arp-cache

Syntax Description

This command has no arguments or keywords.

Command Mode

EXEC

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

Example

The following example removes all dynamic entries from the ARP cache and clears the fast-switching cache:

clear arp-cache

clear ip bgp

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

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

Syntax Description

*

Resets all current BGP sessions.

address

Resets only the identified BGP neighbor.

peer-group-name

Resets the specified BGP peer group.

soft

(Optional) Soft reconfiguration.

in | out

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


Command Mode

EXEC

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

If you specify BGP soft reconfiguration, by including the soft keyword, the sessions are not reset and the router sends all routing updates again. To generate new inbound updates without resetting the BGP session, the local BGP speaker should store all received updates without modification regardless of whether it is accepted by the inbound policy. This process is memory intensive and should be avoided if possible. Outbound BGP soft configuration does not have any memory overhead. You can trigger an outbound reconfiguration on the other side of the BGP session to make the new inbound policy take effect.

Use this command whenever any of the following changes occur:

Additions or changes to the BGP-related access lists

Changes to BGP-related weights

Changes to BGP-related distribution lists

Changes in the BGP timer's specifications

Changes to the BGP administrative distance

Changes to BGP-related route maps

Example

The following example resets all current BGP sessions:

clear ip bgp *

Related Commands

show ip bgp
timers bgp

clear ip bgp peer-group

To remove all the members of a BGP peer group, use the clear ip bgp peer-group EXEC command.

clear ip bgp peer-group tag

Syntax Description

tag

Name of the BGP peer group to clear.


Command Mode

EXEC

Usage Guidelines

This command first appeared in Cisco IOS Release 11.0.

Example

The following example removes all members from the BGP peer group internal:

clear ip bgp peer-group internal

Related Command

neighbor peer-group (assigning members)

clear ip cgmp

To clear all group entries from the Catalyst switches' caches, use the clear ip cgmp EXEC command.

clear ip cgmp [type number]

Syntax Description

type number

(Optional) Interface type and number.


Command Mode

EXEC

Usage Guidelines

This command first appeared in Cisco IOS Release 11.1.

This command sends a CGMP Leave message with a group address of 0000.0000.0000 and a unicast address of 0000.0000.0000. This instructs the switches to clear all group entries they have cached.

If an interface type and number are specified, the Leave message is sent only on that interface. Otherwise, it is sent on all CGMP-enabled interfaces.

Example

The following example clears the CGMP cache:

clear ip cgmp

Related Command

ip cgmp

clear ip dvmrp route

To delete routes from the DVMRP routing table, use the clear ip dvmrp route EXEC command.

clear ip dvmrp route {* | route}

Syntax Description

*

Clears all routes from the DVMRP table.

route

Clears the longest matched route. Can be an IP address, a network number, or an IP DNS name.


Command Mode

EXEC

Usage Guidelines

This command first appeared in Cisco IOS Release 11.0.

Examples

The following example deletes route 10.1.1.1 from the DVMRP routing table:

clear ip dvmrp route 10.1.1.1

The following example deletes network 10.0.0.0 from the DVMRP routing table:

clear ip dvmrp route 10.0.0.0

clear ip eigrp neighbors

To delete entries from the neighbor table, use the clear ip eigrp neighbors EXEC command.

clear ip eigrp neighbors [ip-address | type number]

Syntax Description

ip-address

(Optional) Address of the neighbor.

type number

(Optional) Interface type and number. Specifying these arguments removes from the neighbor table all entries learned via this interface.


Command Mode

EXEC

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

Example

The following example removes the neighbor whose address is 160.20.8.3:

clear ip eigrp neighbors 160.20.8.3

Related Command

show ip eigrp interfaces

clear ip igmp group

To delete entries from the IGMP cache, use the clear ip igmp group EXEC command.

clear ip igmp group [group-name | group-address | type number]

Syntax Description

group-name

(Optional) Name of the multicast group, as defined in the DNS hosts table or with the ip host command.

group-address

(Optional) Address of the multicast group. This is a multicast IP address in four-part, dotted notation.

type number

(Optional) Interface type and number.


Default

When the command is used with no arguments, all entries are deleted from the IGMP cache.

Command Mode

EXEC

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

The IGMP cache contains a list of the multicast groups of which hosts on the directly connected LAN are members. If the router has joined a group, it is also listed in the cache.

To delete all entries from the IGMP cache, specify the clear ip igmp group command with no arguments.

Example

The following example clears entries for the multicast group 224.0.255.1 from the IGMP cache:

clear ip igmp group 224.0.255.1

Related Commands

A dagger (†) indicates that the command is documented outside this chapter.

ip host
show ip igmp groups
show ip igmp interface

clear ip mroute

To delete entries from the IP multicast routing table, use the clear ip mroute EXEC command.

clear ip mroute {* | group [source]}

Syntax Description

*

Deletes all entries from the IP multicast routing table.

group

Can be either one of the following:

Name of the multicast group, as defined in the DNS hosts table or with the ip host command.

IP address of the multicast group. This is a multicast IP address in four-part, dotted notation.

source

(Optional) If you specify a group name or address, you can also specify a name or address of a multicast source that is transmitting to the group. A source does not need to be a member of the group.