To configure a
not-so-stubby area ( NSSA), use the
areanssacommand in router address family
topology or router configuration mode. To remove the NSSA distinction from the
area, use the
no form of this
command.
Identifier for the stub area or NSSA. The identifier can be specified as either
a decimal value or an IP address.
no-redistribution
(Optional) Used when the router is an NSSA Area Border Router (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 keyword
takes effect only on the NSSA ABR or the NSSA Autonomous System Boundary Router
(ASBR).
metric
(Optional) Specifies the OSPF default metric.
metric-type
(Optional) Specifies the OSPF metric type for default routes.
no-summary
(Optional) Allows an area to be an NSSA but not have summary routes injected
into it.
nssa-only
(Optional) Limits the default advertisement to this NSSA area by setting the
propagate (P) bit in the type-7 LSA to zero.
Command Default
No NSSA area is
defined.
Command Modes
Router address
family topology configuration (config-router-af-topology) Router configuration
(config-router)
Command History
Release
Modification
10.0
This
command was introduced.
12.2(33)SRA
This
command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SRB
This
command was made available in router address family topology configuration
mode.
12.2SX
This
command is supported in the Cisco IOS Release 12.2SX train. Support in a
specific 12.2SX release of this train depends on your feature set, platform,
and platform hardware.
15.0(1)M
This
command was modified. The nssa-only keyword was added.
15.2(1)E
This command was integrated into Cisco IOS Release 15.2(1)E.
Usage Guidelines
To remove the
specified area from the software configuration, use the
noareaarea-idcommand (with no other keywords). That is,
the
noareaarea-id command removes all area options,
including
areaauthentication,
areadefault-cost,
areanssa,
arearange,
areastub, and
areavirtual-link.
Release
12.2(33)SRB
If you plan to
configure the Multi-Topology Routing (MTR) feature, you need to enter the
areanssacommand in router address family topology
configuration mode in order for this OSPF router configuration command to
become topology-aware.
Examples
The following
example makes area 1 an NSSA area:
router ospf 1
redistribute rip subnets
network 172.19.92.0 0.0.0.255 area 1
area 1 nssa
Related Commands
Command
Description
redistribute
Redistributes routes from one routing domain into another routing domain.
area nssa translate
To configure a
not-so-stubby area ( NSSA) and to configure the OSPF Forwarding Address
Suppression in Translated Type-5 LSAs feature, use the
areanssatranslatecommand in router address family topology
or router configuration mode. To remove the NSSA distinction from the area, use
the
no form of this
command.
Identifier for the stub area or NSSA. The identifier can be specified as either
a decimal value or an IP address.
translate
Translates one type of link-state advertisement (LSA) to another type of LSA.
This keyword takes effect only on an NSSA Area Border Router (ABR) or an NSSA
Autonomous System Boundary Router (ASBR).
type7
(Required) Translates a Type-7 LSA to a Type-5 LSA. This keyword takes effect
only on an NSSA ABR or an NSSA ASBR.
always
(Optional) Configures an NSSA ABR router as a forced NSSA LSA translator. The
NSSA ABR router unconditionally translates Type-7 LSAs to Type-5 LSAs. You can
configure the
always
keyword only in router configuration mode, not in router address family
topology configuration mode.
suppress-fa
(Optional) Suppresses the forwarding address of the Type-7 LSAs from being
placed in the Type-5 LSAs. This keyword takes effect only on an NSSA ABR or an
NSSA ASBR.
default-information-originate
(Optional) Used to generate a Type 7 default into the NSSA area. This keyword
takes effect only on the NSSA ABR or the NSSA Autonomous System Boundary Router
(ASBR).
metric
(Optional) Configures the OSPF default metric.
ospf-metric
Specifies the OSPF default metric in the range from 0 to 16777214.
metric-type
(Optional) Configures the OSPF metric type for default routes.
ospf-link-state-type
Specifies OSPF metric type in the range from 1 to 2.
nssa-only
(Optional) Limits the default advertisement to this NSSA area by setting the
propagate (P) bit in the type-7 LSA to zero..
no-ext-capability
(Optional) Specifies that domain-specific capabilities are not sent to NSSA.
no-redistribution
(Optional) Specifies that the
redistribute
command will import routes only into the normal areas, not into the NSSA area.
Used when the router is an NSSA ABR.
no-summary
(Optional) Allows an area to be an NSSA but not have summary routes injected
into it.
Command Default
The ABRs
connecting an NSSA and the backbone areas elect one of them to translate LSAs,
which means that a router might be elected as translator.
Command Modes
Router address
family topology configuration (config-router-af-topology) Router configuration
(config-router)
Release
Modification
12.2(15)T
This
command was introduced.
12.2(27)SBC
This
command was integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA
This
command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SRB
This
command was made available in router address family topology configuration
mode.
12.2SX
This
command is supported in the Cisco IOS Release 12.2SX train. Support in a
specific 12.2SX release of this train depends on your feature set, platform,
and platform hardware.
15.1(2)S
This
command was modified. Support for the
always
keyword was added.
15.2(1)E
This command was integrated into Cisco IOS Release 15.2(1)E.
Usage Guidelines
To configure the
OSPF Forwarding Address Suppression in Translated Type-5 LSAs feature,
configure the
translatetype7suppress-fa keywords. Consider the following
caution.
Caution
Configuring the
OSPF Forwarding Address Suppression in Translated Type-5 LSAs feature causes
the router to be noncompliant with RFC 1587. Also, suboptimal routing might
result because there might be better paths to reach the destination’s
forwarding address. This feature should not be configured without careful
consideration and not until the network topology is understood.
If the the
no-redistribution or
default-information-originate keywords are used,
two separate lines for the
areanssa command appear in the configuration file for
ease of readability. For example, if the
area6nssatranslatetype7suppress-fano-redistributioncommand is configured, the
following lines would appear in the configuration file:
router ospf 1
area 6 nssa no-redistribution
area 6 nssa translate type7 suppress-fa
Cisco IOS Release
15.1(2)S and later releases support RFC 3101 and include the
always
keyword, which allows you to configure an NSSA ABR router as a forced NSSA LSA
translator. This means that the NSSA ABR router will unconditionally assume the
role of LSA translator, preempting the default behavior, which would only
include it among the candidates to be elected as translator.
Note
Even a forced
translator might not translate all LSAs; translation depends on the contents of
each LSA.
You can configure
the
always
keyword only in router configuration mode, not in router address family
topology configuration mode.
To remove the
specified area from the software configuration, use the
noareaarea-idcommand (with no other keywords). That is,
the
noareaarea-id command removes all area options, such as
areaauthentication,
areadefault-cost,
areanssa,
arearange,
areastub, and
areavirtual-link.
Release
12.2(33)SRB
If you plan to
configure the Multi-Topology Routing (MTR) feature with this command, you you
must do so in router address family topology configuration mode in order for
this OSPF router configuration command to become topology-aware.
Examples
The following
example causes OSPF to translate Type-7 LSAs from area 1 to Type-5 LSAs, but
not place the Type-7 forwarding address into the Type-5 LSAs. OSPF places
0.0.0.0 as the forwarding address in the Type-5 LSAs.
router ospf 2
network 172.19.92.0 0.0.0.255 area 1
area 1 nssa translate type7 suppress-fa
The following
example configures an NSSA ABR as a forced LSA translator.
Router(config-router)# area 10 nssa translate type7 always
Related Commands
Command
Description
redistribute
Redistributes routes from one routing domain into another routing domain.
area virtual-link
To define an Open Shortest Path First (OSPF) virtual link, use the
areavirtual-link command in router address family topology, router configuration, or address family configuration mode. To remove a virtual link, use the
no form of this command.
Area ID assigned to the virtual link. This can be either a decimal value or a valid IPv6 prefix. There is no default.
router-id
Router ID associated with the virtual link neighbor. The router ID appears in the
showipospf or
show
ipv6display command. There is no default.
hello-intervalseconds
(Optional) Specifies the time (in seconds) between the hello packets that the Cisco IOS software sends on an interface. The hello interval is an unsigned integer value to be advertised in the hello packets. The value must be the same for all routers and access servers attached to a common network. The range is from 1 to 8192. The default is 10.
retransmit-intervalseconds
(Optional) Specifies the time (in seconds) between link-state advertisement (LSA) retransmissions for adjacencies belonging to the interface. The retransmit interval is the expected round-trip delay between any two routers on the attached network. The value must be greater than the expected round-trip delay. The range is from 1 to 8192. The default is 5.
transmit-delayseconds
(Optional) Specifies the estimated time (in seconds) required to send a link-state update packet on the interface. The integer value that must be greater than zero. LSAs in the update packet have their age incremented by this amount before transmission. The range is from 1 to 8192. The default value is 1.
dead-intervalseconds
(Optional) Specifies the time (in seconds) that hello packets are not seen before a neighbor declares the router down. The dead interval is an 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.
ttl-securityhopshop-count
(Optional) Configures Time-to-Live (TTL) security on a virtual link. The
hop-count argument range is from 1 to 254.
Command Default
No OSPF virtual link is defined.
Command Modes
Router address family topology configuration (config-router-af-topology)
Router configuration (config-router)
Address family configuration (config-router-af)
Command History
Release
Modification
10.0
This command was introduced.
12.0(24)S
Support for IPv6 was added.
12.2(15)T
Support for IPv6 was added.
12.2(18)S
This command was integrated into Cisco IOS Release 12.2(18)S.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SRB
This command was made available in router address family topology configuration mode.
12.2(33)SXH
This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SRC
The
ttl-securityhopshop-count keywords and argument were added.
15.0(1)M
This command was integrated into Cisco IOS Release 15.0(1)M.
15.2(4)S
This command was integrated into Cisco IOS Release 15.2(4)S. This command was made available in the address family configuration mode.
Cisco IOS XE Release 3.7S
This command was integrated into Cisco IOS XE Release 3.7S. This command was made available in the OSPFv3 address family configuration mode.
15.1(1)SY
This command was integrated into Cisco IOS Release 15.1(1)SY.
Usage Guidelines
In OSPF, all areas must be connected to a backbone area. A lost connection to the backbone can be repaired by establishing a virtual link.
The shorter 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.
You should choose a transmit delay value that considers the transmission and propagation delays for the interface.
To configure a virtual link in OSPF for IPv6, you must use a router ID instead of an address. In OSPF for IPv6, the virtual link takes the router ID rather than the IPv6 prefix of the remote router.
Use the
ttl-securityhopshop-count keywords and argument to enable checking of TTL values on OSPF packets from neighbors or to set TTL values sent to neighbors. This feature adds an extra layer of protection to OSPF.
Note
In order for a virtual link to be properly configured, each virtual link neighbor must include the transit area ID and the corresponding virtual link neighbor router ID. To display the router ID, use the
showipospf or the
showipv6ospf command in privileged EXEC mode.
Note
To remove the specified area from the software configuration, use the
noareaarea-id command (with no other keywords). That is, the
noareaarea-id command removes all area options, such as
areadefault-cost,
areanssa,
arearange,
areastub, and
areavirtual-link.
Release 12.2(33)SRB
If you plan to configure the Multitopology Routing (MTR) feature, you need to enter the
areavirtual-link command in router address family topology configuration mode in order for this OSPF router configuration command to become topology-aware.
Examples
The following example establishes a virtual link with default values for all optional parameters:
ipv6 router ospf 1
log-adjacency-changes
area 1 virtual-link 192.168.255.1
The following example establishes a virtual link in OSPF for IPv6:
Enables the display of general information about OSPF routing processes.
showipv6ospf
Enables the display of general information about OSPF routing processes.
ttl-securityhops
Enables checking of TTL values on OSPF packets from neighbors or setting TTL values sent to neighbors.
capability vrf-lite
To suppress the provider edge (PE) specific checks on a router when the Open Shortest Path First (OSPF) process is associated with the VPN routing and forwarding instance (VRF), use the
capabilityvrf-lite command in router configuration mode. To restore the checks, use the
no form of this command.
capabilityvrf-lite
nocapabilityvrf-lite
Syntax Description
This command has no arguments or keywords.
Command Default
Disabled. PE specific checks are performed if the process is associated with VRF command modes.
Command Modes
Router configuration
Command History
Release
Modification
12.0(21)ST
This command was introduced.
12.0(22)S
This command was integrated into Cisco IOS Release 12.0(22)S.
12.2(8)B
This command was integrated into Cisco IOS Release 12.2(8)B.
12.2(13)T
This command was integrated into Cisco IOS Release 12.2(13)T.
12.2(14)S
This command was integrated into Cisco IOS Release 12.2(14)S.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
This command works only if the OSPF process is associated with the VRF.
When the OSPF process is associated with the VRF, several checks are performed when link-state advertisements (LSAs) are received. PE checks are needed to prevent loops when the PE is performing a mutual redistribution between OSPF and Border Gateway Protocol (BGP) interfaces.
The table below describes the PE checks performed when Type-3, Type-5, and Type-7 LSAs are received.
Table 1 PE Checks Performed
Type-3 LSA received
The DN bit is checked. If the DN bit is set, the Type-3 LSA is not considered during the shortest path first (SPF) calculation.
Type-5 or -7 LSA received
If the Tag in the LSA is equal to the VPN-tag, the Type-5 or-7 LSA is not considered during the SPF calculation.
In some situations, performing PE checks might not be desirable. The concept of VRFs can be used on a router that is not a PE router (that is, a router that is not running BGP). With the
capabilityvrf-lite command, the checks can be turned off to allow correct population of the VRF routing table with routes to IP prefixes.
Examples
This example shows a router configured with multi-VRF:
router ospf 100 vrf grc
capability vrf-lite
capability vrf-lite
(OSPFv3)
To suppress the
provider edge (PE)-specific checks on a router when the Open Shortest Path
First version 3 (OSPFv3) process is associated with the VPN routing and
forwarding (VRF) instance, use the
capabilityvrf-lite command in address family configuration
mode. To restore the checks, use the
no form of this
command.
capabilityvrf-lite
nocapabilityvrf-lite
Syntax Description
This command has no
arguments or keywords.
Command Default
Disabled.
PE-specific checks are performed if the process is associated with VRF command
modes.
Command Modes
Address family
configuration (config-router-af)#
Command History
Release
Modification
15.2(2)S
This
command was introduced.
Cisco IOS
XE Release 3.6S
This
command was integrated into Cisco IOS XE Release 3.6S.
15.1(1)SY
This
command was integrated into Cisco IOS Release 15.1(1)SY.
15.2(4)M
This
command was integrated into Cisco IOS Release 15.2(4)M.
15.2(1)E
This command was integrated into Cisco IOS Release
15.2(1)E.
Usage Guidelines
This command works
only if the OSPFv3 process is associated with the VRF.
When the OSPFv3
process is associated with the VRF, several checks are performed when
link-state advertisements (LSAs) are received. PE checks are needed to prevent
loops when the PE is performing a mutual redistribution between OSPF and Border
Gateway Protocol (BGP) interfaces.
The table below
describes the PE checks performed when inter-area-prefix LSAs, AS-External
LSAs, or not-so-stubby area (NSSA) LSAs are received.
Table 2 PE Checks Performed
LSA Received
Check
Inter-area-prefix LSAs, AS-External LSAs or NSSA LSAs received
The down bit
(DN) is checked. If the DN bit is set, the inter-area-prefix LSAs, AS-External
LSAs or NSSA LSAs is not considered during the SPF calculation.
Inter-Area-Prefix-LSAs LSA received from nonbackbone area
The OSPFv3 VRF
process acts as an Area Border Router (ABR) and the PE router does ABR-specific
checks. Most noticeably, the router does not consider during shortest path
first (SPF) calculation inter-area-prefix LSAs received from a nonbackbone
(nonzero) area. The
capabilityvrf-lite command disconnects the OSPFv3 process
from the Multiprotocol Label Switching (MPLS) VPN super-backbone and the router
loses ABR status (unless the OSPFv3 process is configured with active backbone
and nonbackbone areas).
Examples
The following
example shows a router in IPv6 address-family configuration mode reconfigured
with multi-VRF:
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
Use the pidargument to clear only one OSPFprocess. If the pidargumentis not specified,all OSPF processesare cleared.
Examples
The following example clears all OSPF processes:
Router# clear ip ospf process
compatible rfc1587
To replace RFC 3101 compatibility with RFC 1587 compatibility for route selection in not-so-stubby area (NSSA) Area Border Routers (ABRs), use the
compatiblerfc1587command in router configuration mode or address family configuration mode. To restore RFC 3101 compatibility, use the
no form of this command.
compatiblerfc1587
nocompatiblerfc1587
Syntax Description
This command has no arguments or keywords.
Command Default
Route selection is compatible with RFC 3101.
Command Modes
Router configuration (config-router)
Address family configuration (config-router-af)
Command History
Release
Modification
15.1(2)S
This command was introduced.
15.2(4)S
This command was modified. Support for OSPFv3 was added.
Cisco IOS XE Release 3.7S
This command was integrated into Cisco IOS XE Release 3.7S.
Usage Guidelines
In Cisco IOS Release 15.1(2)S and later releases, RFC 3101 replaces RFC 1587, and RFC 3101 behavior is automatically enabled. You can choose the route selection behavior by configuring a router to run as RFC 3101 or RFC 1587 compatible.
See Appendix F of RFC3101
The OSPF Not-So-Stubby Area (NSSA) Option for a detailed list of differences between RFC1587 and RFC3101.
Examples
The following example specifies that the router process is compatible with RFC 1587:
To generate a default external route into an Open Shortest Path First (OSPF) routing domain, use the
default-informationoriginate command in router configuration or router address family topology configuration mode. To disable this feature, use the
no form of this command.
(Optional) Always advertises the default route regardless of whether the software has a default route.
Note
The
always keyword includes the following exception when the route map is used. When a route map is used, the origination of the default route by OSPF is not bound to the existence of a default route in the routing table and the
always keyword is ignored.
metricmetric-value
(Optional) Metric used for generating the default route. If you omit a value and do not specify a value using the
default-metric router configuration command, the default metric value is 10. The value used is specific to the protocol.
metric-typetype-value
(Optional) External link type associated with the default route that is advertised into the OSPF routing domain. It can be one of the following values:
Type 1 external route.
Type 2 external route.
The default is type 2 external route.
route-mapmap-name
(Optional) The routing process will generate the default route if the route map is satisfied.
Command Default
This command is disabled by default. No default external route is generated into the OSPF routing domain.
Command Modes
Router configuration (config-router) Router address family topology configuration (config-router-af-topology)
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SRB
This command was made available in router address family topology configuration mode.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
Whenever you use the
redistribute or thedefault-information router configuration command to redistribute routes into an OSPF routing domain, the Cisco IOS software automatically becomes an Autonomous System Boundary Router (ASBR). However, an ASBR does not, by default, generate a default route into the OSPF routing domain. The software must still have a default route for itself before it generates one, except when you have specified the
always keyword.
When a route map is used, the origination of the default route by OSPF is not bound to the existence of a default route in the routing table.
Release 12.2(33)SRB
If you plan to configure the Multi-Topology Routing (MTR) feature, you need to enter the
default-informationoriginatecommand in router address family topology configuration mode in order for this OSPF router configuration command to become topology-aware.
Examples
The following example specifies a metric of 100 for the default route that is redistributed into the OSPF routing domain and specifies an external metric type of 1:
Accepts exterior or default information into Enhanced Interior Gateway Routing Protocol (EIGRP) processes.
default-metric
Sets default metric values for routes.
redistribute(IP)
Redistributes routes from one routing domain into another routing domain.
default-metric (OSPF)
To set default metric values for the Open Shortest Path First (OSPF) routing protocol,
use the default-metric command in router address family topology or router configuration mode. To r
eturn to the default state, use the no form of this command.
default-metricmetric-value
nodefault-metricmetric-value
Syntax Description
metric-value
Default metric value appropriate for the specified routing protocol.
Command Default
Built-in, automatic metric translations, as appropriate for each routing protocol. The metric of redistributed connected and static routes is set to 0.
Command Modes
Router address family topology configuration (config-router-af-topology)
Router configuration (config-router)
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SRB
This command was made available in router address family topology configuration mode.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
T
he default-metric command is used in conjunction with the redistribute router configuration command to cause the current routing protocol to use the same metric value for all redistributed routes. A default metric helps solve the problem of redistributing routes with incompatible metrics. Whenever metrics do not convert, using a default metric provides a reasonable substitute and enables the redistribution to proceed.
Note
When enabled, thedefault-metric command applies a metric value of 0 to redistributed connected routes. The default-metric command does not override metric values that are applied with the redistribute command.
Release 12.2(33)SRB
If you plan to configure the Multi-Topology Routing (MTR) feature, you need to enter the default-metric command in router address family topology configuration mode in order for this OSPF router configuration command to become topology-aware.
Examples
The following example shows a router in autonomous system 109 using both the Routing Information Protocol (RIP) and the OSPF routing protocols. The example advertises OSPF-derived routes using RIP and assigns the OSPF-derived routes a RIP metric of 10.
Redistributes routes from one routing domain into another routing domain.
distance ospf
To define Open Shortest Path First (OSPF) route administrative distances based on route type, use the distanceospf command in router address family topology or router configuration mode. To restore the default value, use the no form of this command.
(Optional) Sets the distance for routes from other routing domains, learned by redistribution. Range is 1 to 255. The default value is 110.
inter-areadist2
(Optional) Sets the distance for all routes from one area to another area. Range is 1 to 255. The default value is 110.
intra-areadist3
(Optional) Sets the distance for all routes within an area. Range is 1 to 255. The default value is 110.
Command Default
dist1: 110
dist2: 110
dist3: 110
Command Modes
Router address family topology configuration (config-router-af-topology)
Router configuration (config-router)
Command History
Release
Modification
11.1(14)
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SRB
This command was made available in router address family topology configuration mode.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
You must specify at least one of the keywords.
This command performs the same function as the distance command used with an access list. However, the distanceospfcommand allows you to set a distance for an entire group of routes, rather than a specific route that passes an access list.
A common reason to use the distanceospf command is when you have multiple OSPF processes with mutual redistribution, and you want to prefer internal routes from one over external routes from the other.
Release 12.2(33)SRB
If you plan to configure the Multi-Topology Routing (MTR) feature, you need to enter the distanceospfcommand in router address family topology configuration mode in order for this OSPF router configuration command to become topology-aware.
Examples
The following example changes the external distance to 200, making the route less reliable:
To configure the
BGP/MPLS VPN domain ID, use the
domain-id
command in address-family configuration mode. To restore the default value, use
the
no form of this
command.
domain-idtypetype-valuevaluehex-value
nodomain-idtypetype-valuevaluehex-value
Syntax Description
typetype-value
BGP
extended community used to carry the domain-id.
valuehex-value
An
arbitrary 48-bit number encoded as 12 hexadecimal digits.
Command Default
The default value
for the
domain-id
command is NULL.
Command Modes
address-family
configuration
Command History
Release
Modification
Cisco IOS
XE Release 3.6S
This
command was introduced.
15.2(4)S
This
command was integrated into Cisco IOS Release 15.2(4)S.
15.2(4)M
This
command was integrated into Cisco IOS Release 15.2(4)M.
15.1(1)SY
This command was integrated into Cisco IOS Release 15.1(1)SY
.
15.2(1)E
This command was integrated into Cisco IOS Release 15.2(1)E.
Usage Guidelines
The value of the
BGP extended community used to carry the domain-id can be one of 0005, 0105,
0205, or 8005. In OSPFv2, a default non-NULL domain-id is provided by using the
process-id of the router instance. In OSPFv3, the default value is NULL.
ignore lsa mospf
To suppress the sending of syslog messages when the router receives link-state advertisement (LSA) Type 6 Multicast OSPF (
MOSPF) packets, which are unsupported, use the ignorelsamospfcommand in router configuration mode. To restore the sending of syslog messages, use the noform of this command.
ignorelsamospfcommandignorelsamospf
noignorelsamospf
Syntax Description
This command has no arguments or keywords.
Command Default
This command is disabled by default. Each MOSPF packet causes the router to send a syslog message.
Command Modes
Router configuration
Command History
Release
Modification
11.1
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
Cisco routers do not support LSA Type 6 MOSPF packets, and they generate syslog messages if they receive such packets. If the router is receiving many MOSPF packets, you might want to configure the router to ignore the packets and thus prevent a large number of syslog messages.
Examples
The following example configures the router to suppress the sending of syslog messages when it receives MOSPF packets:
router ospf 109
ignore lsa mospf
ip ospf area
To enable Open
Shortest Path First version 2 (OSPFv2) on an interface, use the
ipospfarea command in interface configuration mode. To
disable OSPFv2 on the interface, use the
no form of this
command.
ipospfprocess-idareaarea-id
[ secondariesnone ]
noipospfprocess-idarea
[ secondariesnone ]
Syntax Description
process-id
A decimal
value in the range from 1 to 65535 that identifies the process ID.
area-id
A decimal
value in the range from 0 to 4294967295, or an IP address.
secondariesnone
(Optional) Prevents secondary IP addresses on the interface from being
advertised.
Command Default
If the
secondariesnonekeywords are entered in the
no form of this
command, the secondary IP addresses will be advertised. If the
secondariesnonekeywords are not present, OSPFv2 will be
disabled.
This
command was integrated into Cisco IOS Release 12.3(11)T.
12.2(1)SB
This
command was integrated into Cisco IOS Release 12.2(1)SB.
12.2(33)SRB
This
command was integrated into Cisco IOS Release 12.2(33)SRB.
Cisco
IOS XE Release 3.2S
This
command was modified. Support was added for this command in virtual network
interface configuration mode.
15.2(2)SNI
This
command was implemented on the Cisco ASR 901 Series Aggregation Services
Routers.
15.2(1)E
This command was integrated into Cisco IOS Release 15.2(1)E.
Usage Guidelines
OSPF is enabled
on an interface when the network address for the interface matches the range of
addresses that is specified by thenetworkarea command that is entered in router
configuration mode. You can enable OSPFv2 explicitly on an interface with the
ipospfarea command that is entered in interface
configuration mode. This capability simplifies the configuration of unnumbered
interfaces with different areas.
Theipospfareacommand that is entered in interface
configuration mode will supersede the effects of the
networkareacommand. Therefore, an interface that is
configured with the
ipospfarea command in interface configuration mode will
not be affected by the
networkareacommand.
Note
If you later
disable the
ipospfarea command, the interface will still run OSPFv2
as long as its network address matches the range of addresses that is specified
by the
networkareacommand.
Examples
The following
example enables OSPFv2 on Ethernet interface 0/0/2 and prevents secondary IP
addresses from being advertised:
Router(config)# interface Ethernet0/0/2
Router(config-if)# ip ospf 10 area 0 secondaries none
Related Commands
Command
Description
interface
Configures an interface type and enters interface configuration mode.
networkarea
Defines
the interfaces on which OSPF runs and defines the area ID for those interfaces.
showipospfinterface
Displays OSPF-related interface information.
ip ospf database-filter all out
To filter outgoing link-state advertisements (LSAs) to an Open Shortest Path First (OSPF) interface, use the
ipospfdatabase-filterallout command in interface or virtual network interface configuration modes. To restore the forwarding of LSAs to the interface, use the
noform of this command.
ipospfdatabase-filterallout [disable]
noipospfdatabase-filterallout
Syntax Description
disable
(Optional) Disables the filtering of outgoing LSAs to an OSPF interface; all outgoing LSAs are flooded to the interface.
Note
This keyword is available only in virtual network interface mode.
Command Default
This command is disabled by default. All outgoing LSAs are flooded to the interface.
Command Modes
Interface configuration (config-if)
Virtual network interface (config-if-vnet)
Command History
Release
Modification
12.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Cisco IOS XE Release 3.2S
This command was modified. The
disable keyword was added. Support was added for this command in virtual network interface configuration mode.
15.0(1)SY
This command was modified. The
disable keyword was added. Support was added for this command in virtual network interface configuration mode.
15.1(1)SG
This command was integrated into Cisco IOS Release 15.1(1)SG.
Cisco IOS XE Release 3.3SG
This command was integrated into Cisco IOS XE Release 3.3SG.
Usage Guidelines
This command performs the same function that the
neighbordatabase-filter command performs on a neighbor basis.
If theipospfdatabase-filterallout command is enabled for a virtual network and you want to disable it, use the
disable keyword in virtual network interface configuration mode.
Examples
The following example prevents filtering of OSPF LSAs to broadcast, nonbroadcast, or point-to-point networks reachable through Ethernet interface 0:
interface ethernet 0
ip ospf database-filter all out
Related Commands
Command
Description
neighbordatabase-filter
Filters outgoing LSAs to an OSPF neighbor.
ip ospf demand-circuit
To configure Open Shortest Path First (OSPF) to treat the interface as an OSPF demand circuit, use the
ipospfdemand-circuit command in interface configuration mode or virtual network interface configuration mode. To remove the OSPF demand circuit functionality from the interface, use the
no form of this command.
ipospfdemand-circuit [disable] [ignore]
noipospfdemand-circuit
Syntax Description
disable
(Optional) Disables OSPF from treating the interface as an OSPF demand circuit.
Note
This keyword is available only in virtual network interface mode.
ignore
(Optional) Ignores requests from other routers to operate the link in demand-circuit mode.
Command Default
The circuit is not an OSPF demand circuit.
Command Modes
Interface configuration (config-if)
Virtual network interface (config-if-vnet)
Command History
Release
Modification
11.2
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Cisco IOS XE Release 3.2S
This command was modified. The
disable and
ignore keywords were added. Support was added for this command in virtual network interface configuration mode.
15.1(4)M
This command was integrated into Cisco IOS Release15.1(4)M.
15.0(1)SY
This command was modified. The
disable and
ignore keywords were added. Support was added for this command in virtual network interface configuration mode.
15.1(1)SG
This command was integrated into Cisco IOS Release 15.1(1)SG.
Cisco IOS XE Release 3.3SG
This command was integrated into Cisco IOSXE Release 3.3SG.
Usage Guidelines
On point-to-point interfaces, only one end of the demand circuit must be configured with the
ipospfdemand-circuit command. Periodic hello messages are suppressed and periodic refreshes of link-state advertisements (LSAs) do not flood the demand circuit. This command allows the underlying data-link layer to be closed when the topology is stable. In point-to-multipoint topology, only the multipoint end must be configured with this command.
If theipospfdemand-circuit command is enabled for a virtual network and you want to disable it, use the
disable keyword in virtual network interface configuration mode.
Examples
The following example shows how to configure an OSPF demand circuit for an ISDN on-demand circuit:
The following example shows how to prevent OSPF demand circuit operation on a multipoint hub interface:
outer# configure terminal
Router(config)# interface Dialer0
Router(config-if)# ip ospf network point-to-multipoint
Router(config-if)# ip ospf demand-circuit ignore
Related Commands
Command
Description
ipospfnetworkpoint-to-multipoint
Configures the OSPF network type to point-to-multipoint.
networkarea
Defines the OSPF interfaces and area ID.
routerospf
Configures the OSPF routing process.
showipospf
Displays information about OSPF routing processes.
ip ospf flood-reduction
To suppress the unnecessary flooding of link-state advertisements (LSAs) in stable topologies, use the
ipospfflood-reduction command in interface configuration mode. To disable this feature, use the
no form of this command.
ipospfflood-reductionflood-reduction [disable]
noipospfflood-reduction
Syntax Description
disable
(Optional) Disables the suppressing of unnecessary flooding of LSAs in stable topologies.
Note
This keyword is available only in virtual network interface mode.
Command Default
This command is disabled by default.
Command Modes
Interface configuration (config-if)
Virtual network interface (config-if-vnet)
Command History
Release
Modification
12.1(2)T
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Cisco IOS XE Release 3.2S
This command was modified. The
disable keyword was added. Support was added for this command in virtual network interface configuration mode.
15.0(1)SY
This command was modified. The
disable keyword was added. Support was added for this command in virtual network interface configuration mode.
15.1(1)SG
This command was integrated into Cisco IOS Release 15.1(1)SG.
Cisco IOS XE Release 3.3SG
This command was integrated into Cisco IOS XE Release 3.3SG.
Usage Guidelines
All routers supporting the Open Shortest Path First (OSPF) demand circuit are compatible and can interact with routers supporting flooding reduction.
If theipospfflood-reduction command is enabled for a virtual network and you want to disable it, use the
disable keyword in virtual network interface configuration mode.
Examples
The following example suppresses the flooding of unnecessary LSAs on serial interface 0:
interface serial 0
ip ospf flood-reduction
Related Commands
Command
Description
showipospfinterface
Displays OSPF-related interface information.
showipospfneighbor
Displays OSPF-neighbor information on a per-interface basis.
ip ospf name-lookup
To configure Open Shortest Path First (OSPF) to look up Domain Name System (DNS) names for use in all OSPF
show EXEC command displays, use the
ipospfname-lookup command in global configuration mode. To disable this function, use the
noform of this command.
ipospfname-lookup
noipospfname-lookup
Syntax Description
This command has no arguments or keywords.
Command Default
This command is disabled by default.
Command Modes
Global configuration
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
This command makes it easier to identify a router because the router is displayed by name rather than by its router ID or neighbor ID.
Examples
The following example configures OSPF to look up DNS names for use in all OSPF
show EXEC command displays:
ip ospf name-lookup
ip ospf network
To configure the Open Shortest Path First (OSPF) network type to a type other than the default for a given medium, use the
ipospfnetwork command in interface configuration mode. To return to the default value, use the
noform of this command.
Sets the network type to nonbroadcast multiaccess (NBMA).
point-to-multipointnon-broadcast
Sets the network type to point-to-multipoint. The optional
non-broadcast keyword sets the point-to-multipoint network to be nonbroadcast. If you use the
non-broadcast keyword, the
neighbor command is required.
The
non-broadcast keyword used with the
point-to-multipoint keyword was added.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Cisco IOS XE Release 3.2S
This command was modified. Support was added for this command in virtual network interface configuration mode.
Usage Guidelines
Using this feature, you can configure broadcast networks as NBMA networks when, for example, routers in your network do not support multicast addressing. You can also configure nonbroadcast multiaccess networks (such as X.25, Frame Relay, and Switched Multimegabit Data Service (SMDS)) as broadcast networks. This feature saves you from needing to configure neighbors.
Configuring NBMA networks as either broadcast or nonbroadcast assumes that there are virtual circuits from every router to every router or fully meshed networks. However, there are other configurations where this assumption is not true. For example, a partially meshed network. In these cases, you can configure the OSPF network type as a point-to-multipoint network. Routing between two routers that are not directly connected will go through the router that has virtual circuits to both routers. You need not configure neighbors when using this feature.
If this command is issued on an interface that does not allow it, this command will be ignored.
OSPF has two features related to point-to-multipoint networks. One feature applies to broadcast networks; the other feature applies to nonbroadcast networks:
On point-to-multipoint, broadcast networks, you can use the
neighbor command, and you must specify a cost to that neighbor.
On point-to-multipoint, nonbroadcast networks, you must use the
neighbor command to identify neighbors. Assigning a cost to a neighbor is optional.
Examples
The following example sets your OSPF network as a broadcast network:
interface serial 0
ip address 192.168.77.17 255.255.255.0
ip ospf network broadcast
encapsulation frame-relay
The following example illustrates a point-to-multipoint network with broadcast:
interface serial 0
ip address 10.0.1.1 255.255.255.0
encapsulation frame-relay
ip ospf cost 100
ip ospf network point-to-multipoint
frame-relay map ip 10.0.1.3 202 broadcast
frame-relay map ip 10.0.1.4 203 broadcast
frame-relay map ip 10.0.1.5 204 broadcast
frame-relay local-dlci 200
!
router ospf 1
network 10.0.1.0 0.0.0.255 area 0
neighbor 10.0.1.5 cost 5
neighbor 10.0.1.4 cost 10
Related Commands
Command
Description
frame-relaymap
Defines mapping between a destination protocol address and the DLCI used to connect to the destination address.
neighbor(OSPF)
Configures OSPF routers interconnecting to nonbroadcast networks.
x25map
Sets up the LAN protocols-to-remote host mapping.
limit retransmissions
To modify the number of retransmissions of database exchange and update packets for both demand and non-demand circuits, use the
limitretransmissions command in router configuration mode. To reset the maximum number of retransmissions back to the default value of 24, use the
no form of this command.
Maximum number of retransmissions. Range from 1 to 255.
non-dc
Nondemand circuit retransmissions.
disable
Disables or removes the limit to the number of retransmissions.
Command Default
Maximum number of retransmissions is 24.
Command Modes
Router configuration (config-router)#
Address family configuration (config-router-af)#
Command History
Release
Modification
12.2(11)T
This command was introduced.
Cisco IOS XE 3.7S
This command was modified. This command was implemented on the Cisco ASR 1006 Series Device. This command is now supported in address-family configuration mode.
Cisco IOS Release 15.2(1)E
This command was integrated into Cisco IOS Release 15.2(1)E.
Usage Guidelines
There is a limit to the number of retransmissions of database exchange and update packets for both demand and nondemand circuits. The retransmission of these packets stops once this retry limit is reached, thus preventing unnecessary use of the link in continual retransmission of the packets if, for some reason, a neighbor is not responding during adjacency forming.
The limit for both demand circuit and nondemand circuit retransmissions is 24.
The limit-retransmissions command allows you to either remove (disable) the limit or change the maximum number of retransmissions to be a number from 1 to 255. The configuration of this command provides for backward compatibility for previous or other releases of Cisco IOS Software or other routers that do not have this feature.
The limit to the number of retransmissions does not apply for update packets on nonbroadcast multiaccess (NBMA) point-to-multipoint direct circuits. In this situation, the dead timer is used to end communication with nonresponding neighbors and thus stop the retransmissions.
Note
This command can be used in the router configuration mode and address-family mode. The command is also applicable for both OSPF and OSPFv3 protocols.
Examples
The following example shows how to set the maximum number of demand circuit retransmissions to 10 in the router configuration mode:
The following example shows how to set the maximum number of demand circuit retransmissions to 10 and to set the maximum number of nondemand circuit retransmissions to 20:
The following example shows how to set the maximum number of demand circuit retransmissions to 10, and to remove the limit for the number of nondemand circuit retransmissions:
Enters IPv4 or IPv6 address family configuration mode for OSPFv3.
log-adjacency-changes
To configure the router to send a syslog message when an Open Shortest Path First (OSPF) neighbor goes up or down, use the
log-adjacency-changes command in router configuration mode. To turn off this function, use the
no form of this command.
log-adjacency-changes [detail]
nolog-adjacency-changes [detail]
Syntax Description
detail
(Optional) Sends a syslog message for each state change, not just when a neighbor goes up or down.
Command Default
Enabled
Command Modes
Router configuration (config-router)
Command History
Release
Modification
11.2
This command was introduced as
ospflog-adjacency-changes.
12.1
The
ospf keyword was omitted and the
detail keyword was added.
12.2(15)T
Support for IPv6 was added.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
15.1(2)S
This command was integrated into Cisco IOS Release 15.1(2)S.
Usage Guidelines
This command allows you to know about OSPF neighbors going up or down without turning on the
debugipospfpacketcommand or the
debugipv6ospfadjacency command. The
log-adjacency-changes command provides a higher level view of those changes of the peer relationship with less output than the
debug command provides. The
log-adjacency-changes command is on by default but only up/down (full/down) events are reported, unless the
detail keyword is also used.
Examples
The following example configures the router to send a syslog message when an OSPF neighbor state changes:
log-adjacency-changes detail
Related Commands
Command
Description
debugipospfpacket
Displays information about each OSPF packet received for IPv4.
debugipv6ospf
Displays debugging information for OSPF for IPv6.
max-lsa
To limit the number of nonself-generated link-state advertisements (LSAs) that an Open Shortest Path First (OSPF) routing process can keep in the OSPF link-state database (LSDB), use themax-lsa command in router configuration mode. To remove the limit of non self-generated LSAs that an OSPF routing process can keep in the OSPF LSDB, use the no form of this command.
Maximum number of nonself-generated LSAs the OSPF process can keep in the OSPF LSBD.
threshold-percentage
(Optional) The percentage of the maximum LSA number, as specified by the maximum-number argument, at which a warning message is logged. The default is 75 percent.
warning-only
(Optional) Specifies that only a warning message is sent when the maximum limit for LSAs is exceeded. Disabled by default.
ignore-timeminutes
(Optional) Specifies the time, in minutes, to ignore all neighbors after the maximum limit of LSAs has been exceeded. The default is 5 minutes.
ignore-countcount-number
(Optional) Specifies the number of times the OSPF process can consecutively be placed into the ignore state. The default is 5 times.
reset-timeminutes
(Optional) Specifies the time, in minutes, after which the ignore count is reset to zero. The default is 10 minutes.
Command Default
The number of nonself-generated LSAs that an OSPF routing process can keep in the OSPF LSDB is not limited.
This command was integrated into Cisco IOS Release 12.3(7)T.
12.2(25)S
This command was integrated into Cisco IOS Release 12.2(25)S.
12.2(18)SXE
This command was integrated into Cisco IOS Release 12.2(18)SXE.
12.2(27)SBC
This command was integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
To prevent the OSPF process from endlessly changing from the normal state of operation to the ignore state as a result of the LSA count exceeding the maximum configured number immediately after it returns from the ignore state to the normal state of operation, the OSPF process keeps a counter on how many times the process went into the ignore state. This counter is called the ignore count. If the ignore count exceeds the maximum number of LSAs that is specified by the ignore-count keyword and counter-number argument, the OSPF process remains in the ignore state permanently. To return the OSPF process to the state of normal operation, enter the clearipospf command.
If the router is placed into a permanent ignore state, we recommend that you identify and correct the cause of the problem involving the router that is generating the LSAs, or, if possible, increase the limit that has been configured by the max-lsa command before you try to bring the router back into normal operation.
If the router that has generated large numbers of LSAs is not reachable, these LSAs cannot be removed from the OSPF area and domain. As a result, any other router leaving the ignore state and returning to normal operation may reach the ignore state again. We recommend that you take one of the following actions in order to bring the router back into the network:
Temporarily increase the LSA limit to account for the stale LSAs.
Wait until the stale LSAs are removed as a result of reaching their maximum age.
Make sure that the router that has generated the large number of LSAs is connected to the network and is no longer generating large numbers of LSAs.
When the warning-only keyword is used, the OSPF process never enters the ignore state. When the LSA count exceeds the maximum limit that is specified by the maximum-number argument, only an error message is logged and the OSPF process continues in its normal operation.
When the max-lsa command is entered for the first time or when any of the parameters of the command are changed, the OSPF process undergoes a soft-reset procedure.
Examples
The following example sets a limit of 12,000 LSAs that can be received before the OSPF process enters the ignore state:
In the following example, an OSPF process has remained in the ignore state permanently. When the clearipospf command is entered the OSPF process returns to the state of normal operation and clears redistribution based on the OSPF routing process ID.
Router(config-router)# clear ip ospf 100 process
Related Commands
Command
Description
clearipospf
Clears redistribution based on the OSPF routing process ID.
max-metric router-lsa
To configure a
router that is running the Open Shortest Path First (OSPF) protocol to
advertise a maximum metric so that other routers do not prefer the router as an
intermediate hop in their shortest path first (SPF) calculations, use the
max-metricrouter-lsacommand in router address family
topology or router configuration mode. To disable the advertisement of a
maximum metric, use the
no form of this
command.
(Optional) Configures the router to override the external LSA metric with the
maximum metric value.
max-metric-value
(Optional) Maximum metric value for LSAs. The configurable range is from 1 to
16777215. The default value is 16711680.
include-stub
(Optional) Configures the router to advertise the maximum metric for stub links
in router LSAs.
on-startup
(Optional) Configures the router to advertise a maximum metric at startup.
seconds
(Optional) Maximum metric value for the specified time interval. The
configurable range is from 5 to 86400 seconds. There is no default timer value
for this configuration option.
wait-for-bgp
(Optional) Configures the router to advertise a maximum metric until Border
Gateway Protocol (BGP) routing tables have converged or the default timer has
expired. The default timer is 600 seconds.
summary-lsa
(Optional) Configures the router to override the summary LSA metric with the
maximum metric value.
Command Default
Router link-state
advertisements (LSAs) are originated with normal link metrics.
Command Modes
Router address
family topology configuration (config-router-af-topology) Router configuration
(config-router)
Command History
Release
Modification
12.0(15)S
This
command was introduced.
12.0(16)ST
This
command was integrated into Cisco IOS Release 12.0(16)ST.
12.2(4)T
This
command was integrated into Cisco IOS Release 12.2(4)T.
12.4(10)
The
include-stub,
summary-lsa,and
external-lsa
keywords and the
max-metric-value argument were made available
under router configuration mode.
12.4(11)T
The
include-stub,
summary-lsa,and
external-lsa
keywords and the
max-metric-value argument were made available
under router configuration mode.
12.2(14)S
This
command was integrated into Cisco IOS Release 12.2(14)S.
12.2(31)SB2
The
include-stub,
summary-lsa,and
external-lsa
keywords and the
max-metric-value argument were made available
under router configuration mode.
12.2(33)SRA
This
command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SRB
This
command was made available in router address family topology configuration
mode. The
include-stub,
summary-lsa,and
external-lsa
keywords and the
max-metric-value argument were made available
under router configuration mode.
15.2(1)E
This command was integrated into Cisco IOS Release 15.2(1)E.
Usage Guidelines
Enabling the
max-metric router-lsa command will cause a router to originate LSAs with a
maximum metric (LSInfinity: 0xFFFF) through all nonstub links, which allows BGP
routing tables to converge without attracting transit traffic (if there are not
alternate lower cost paths around the router). The router will advertise
accurate (normal) metrics after the configured or default timers expire or
after BGP sends a notification that routing tables have converged.
Note
Directly
connected links in a stub network are not affected by the configuration of a
maximum or infinite metric because the cost of a stub link is always set to the
output interface cost.
The max-metric
router-lsa command is useful in the following situations:
Reloading a
router. After a router is reloaded, Interior Gateway Protocols (IGPs) converge
very quickly, and other routers may try to forward traffic through the newly
reloaded router. If the router is still building BGP routing tables, packets
destined for other networks that the router has not learned through BGP may be
dropped. In the case of an Internet backbone router, a large number of packets
may be dropped.
Introducing a
router into a network without routing traffic through it. You may want to
connect a router to an OSPF network but not want real traffic flowing through
the router if there are better alternate paths. If there are no alternate
paths, this router would still accept transit traffic as before.
Gracefully
removing a router from a network. This feature allows you to gracefully remove
a router from the network by advertising a maximum metric through all links,
which allows other routers to select alternate paths for transit traffic to
follow before the router is shut down.
Note
You should not
save the running configuration of a router when it is configured for a graceful
shutdown because the router will continue to advertise a maximum metric after
it is reloaded.
Note
In older OSPF
implementations (RFC 1247 and earlier implementations), the router link costs
in received LSAs with a metric of LSInfinity are not used during SPF
calculations, which means that no transit traffic will be sent to the routers
that originate these LSAs.
Release
12.2(33)SRB
If you plan to
configure the Multi-Topology Routing (MTR) feature, you need to enter the
max-metricrouter-lsacommand in router address family
topology configuration mode in order for this OSPF router configuration command
to become topology-aware.
Examples
The following
example configures a router that is running OSPF to advertise a maximum metric
for 100 seconds:
The following
example configures a router to advertise a maximum metric until BGP routing
tables converge or until the default timer expires (600 seconds):
The following
example configures a router that is running OSPF to advertise a maximum metric,
which causes neighbor routers to select alternate paths for transit traffic
before the router shuts down:
Router(config)# router ospf 100
Router(config-router)# max-metric router-lsa
Router(config-router)# end
The following
example configures stub links to be advertised with the maximum-metric in
routers LSAs.
Entering the
showipospfmax-metriccommand with the
include-stub
keyword displays output that confirms that stub links are advertised with the
maximum metric.
Router# show ip ospf max-metric
Routing Process “ospf 1” with ID 10.1.1.1
Start time: 00:00:03.524, Time elapsed: 01:02:28.292
Originating router-LSAs with maximum metric
Condition: always, State: active
Advertise stub links with maximum metric in router-LSAs
Related Commands
Command
Description
showipospf
Displays general information about OSPF routing processes.
showipospfdatabase
Displays lists of information related to the OSPF database for a specific
router.
neighbor (OSPF)
To configure Open Shortest Path First (OSPF) routers interconnecting to nonbroadcast networks, use the
neighbor command in router address family topology or router configuration mode. To remove a configuration, use the
no form of this command.
(Optional) A number that indicates the router priority value of the nonbroadcast neighbor associated with the IP address specified.The default is 0. This keyword does not apply to point-to-multipoint interfaces.
poll-intervalseconds
(Optional) A number value that represents the poll interval time (in seconds). RFC 1247 recommends that this value be much larger than the hello interval. The default is 120 seconds (2 minutes). This keyword does not apply to point-to-multipoint interfaces. The range is from 0 to 4294967295 seconds.
costnumber
(Optional) Assigns a cost to the neighbor, in the form of an integer from 1 to 65535. Neighbors with no specific cost configured will assume the cost of the interface, based on the
ipospfcostcommand. For point-to-multipoint interfaces, the cost keyword and the number argument are the only options that are applicable. This keyword does not apply to nonbroadcast multiaccess (NBMA) networks.
database-filterall
(Optional) Filters outgoing link-state advertisements (LSAs) to an OSPF neighbor.
Command Default
This command is disabled by default. No configuration is specified.
Command Modes
Router address family topology configuration (config-router-af-topology) Router configuration (config-router)
Command History
Release
Modification
10.0
This command was introduced.
11.3AA
The
cost keyword was added.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SRB
This command was made available in router address family topology configuration mode.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
15.1(2)SNG
This command was implemented on the Cisco ASR 901 Series Aggregation Services Routers.
Usage Guidelines
X.25 and Frame Relay provide an optional broadcast capability that can be configured in the map to allow OSPF to run as a broadcast network. At the OSPF level you can configure the router as a broadcast network. Refer to thex25map and
frame-relaymap commands in the “X.25 Commands” and “Frame Relay Commands” chapters, respectively, in the
Cisco IOSWide-AreaNetworkingCommandReferencefor more detail.
One neighbor entry must be included in the Cisco IOS software configuration for each known nonbroadcast network neighbor. The neighbor address must be on the primary address of the interface.
If a neighboring router has become inactive (hello packets have not been received for the Router Dead Interval period), it may still be necessary to send hello packets to the dead neighbor. These hello packets will be sent at a reduced rate called
PollInterval.
When the router first starts up, it sends only hello packets to those routers with nonzero priority, that is, routers that are eligible to become designated routers (DRs) and backup designated routers (BDRs). After the DR and BDR are selected, DR and BDR will then start sending hello packets to all neighbors in order to form adjacencies.
Note
You cannot use the
neighbor(OSPF) command to specify an Open Shortest Path First (OSPF) neighbor on non-broadcast networks within an OSPF Virtual Private Network (VPN) routing instance.
Prior to Cisco IOS Release 12.0, the
neighbor command applied to NBMA networks only. With Release 12.0, the
neighbor command applies to NBMA networks and point-to-multipoint networks. On NBMA networks, the
cost keyword is not accepted.
Release 12.2(33)SRB
If you plan to configure the Multi-Topology Routing (MTR) feature, you need to enter the
neighborcommand in router address family topology configuration mode in order for this OSPF router configuration command to become topology-aware.
Examples
The following example declares a router at address 192.168.3.4 on a nonbroadcast network, with a priority of 1 and a poll interval of 180 seconds:
The following example illustrates a point-to-multipoint network with nonbroadcast:
interface Serial0
ip address 10.0.1.1 255.255.255.0
ip ospf network point-to-multipoint non-broadcast
encapsulation frame-relay
no keepalive
frame-relay local-dlci 200
frame-relay map ip 10.0.1.3 202
frame-relay map ip 10.0.1.4 203
frame-relay map ip 10.0.1.5 204
no shut
!
router ospf 1
network 10.0.1.0 0.0.0.255 area 0
neighbor 10.0.1.3 cost 5
neighbor 10.0.1.4 cost 10
neighbor 10.0.1.5 cost 15
Related Commands
Command
Description
ipospfpriority
Sets the router priority, which helps determine the designated router for this network.
network area
To define the interfaces on which Open Shortest Path First (OSPF) runs and to define the area ID for those interfaces, use the
networkarea command in router configuration mode. To disable OSPF routing for interfaces defined with the
ip-addresswildcard-maskpair, use the
no form of this command.
networkip-addresswildcard-maskareaarea-id
nonetworkip-addresswildcard-maskareaarea-id
Syntax Description
ip-address
IP address.
wildcard-mask
IP-address-type mask that includes “don’t care” bits.
area-id
Area that is to be associated with the OSPF address range. It can be specified as either a decimal value or as an IP address. If you intend to associate areas with IP subnets, you can specify a subnet address as the value of the
area-idargument.
Command Default
This command is disabled by default.
Command Modes
Router configuration
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
15.2(2)SNI
This command was implemented on the Cisco ASR 901 Series Aggregation Services Routers.
Usage Guidelines
The ip-address and wildcard-mask arguments together allow you to define one or multiple interfaces to be associated with a specific OSPF area using a single command. Using the
wildcard-mask argument allows you to define one or multiple interfaces to be associated with a specific OSPF area using a single command. If you intend to associate areas with IP subnets, you can specify a subnet address as the value of the
area-idargument.
For OSPF to operate on the interface, the primary address of the interface must be covered by the
networkareacommand. If the
networkareacommand covers only the secondary address, it will not enable OSPF over that interface.
The Cisco IOS software sequentially evaluates the
ip-addresswildcard-mask pair for each interface as follows:
The
wildcard-maskargument is logically ORed with the interface IP address.
The
wildcard-maskargument is logically ORed with the ip-addressargument in the
network command.
The software compares the two resulting values. If they match, OSPF is enabled on the associated interface and this interface is attached to the OSPF area specified.
There is no limit to the number of
networkarea commands you can use on the router.
Note
Any individual interface can only be attached to a single area. If the address ranges specified for different areas overlap, the software will adopt the first area in the
network command list and ignore the subsequent overlapping portions. In general, we recommend that you configure address ranges that do not overlap in order to avoid inadvertent conflicts.
When a more specific OSPF network range is removed, interfaces belonging to that network range will be retained and remain active if and only if a less specific network range exists.
For example, consider the following configuration:
router ospf 1
network 192.168.129.16 0.0.0.3 area 20
network 192.168.129.40 0.0.0.3 area 20
network 192.168.129.44 0.0.0.3 area 20
network 192.168.129.96 0.0.0.3 area 20
network 192.168.128.0 0.0.127.255 area 20
!
Enter the following:
no network 192.168.129.40 0.0.0.3 area 20
Interfaces falling into the network range 192.168.129.40/0.0.0.3 will still remain active because the superset, 192.168.128.0/0.0.127.255, exists for area 20. A more specific network statement will cause interfaces belonging to that range to be removed from a different area only if a less specific network statement (superset) exists.
Consider a configuration such as the following:
!
router ospf 1
network 192.168.128.0 0.0.127.255 area 20
!
If the following network statement is entered:
network 192.168.129.96 0.0.0.3 area 40
then interfaces belonging to range 192.168.129.96/0.0.0.3, if any, are removed from area 20 and moved to area 40. Network statements with identical ranges but with different area IDs are considered as area changes. For example, the following network statements will cause interfaces belonging to network range 192.168.129.40/0.0.0.3 to move from area 20 to area 40:
network 192.168.129.40 0.0.0.3 area 20
network 192.168.129.40 0.0.0.3 area 40
Examples
The following partial example initializes OSPF routing process 109, and defines four OSPF areas: 10.9.50.0, 2, 3, and 0. Areas 10.9.50.0, 2, and 3 mask specific address ranges, and area 0 enables OSPF for all other networks.
interface ethernet 0
ip address 10.108.20.1 255.255.255.0
router ospf 109
network 10.108.20.0 0.0.0.255 area 10.9.50.0
network 10.108.0.0 0.0.255.255 area 2
network 10.109.10.0 0.0.0.255 area 3
network 0.0.0.0 255.255.255.255 area 0
Related Commands
Command
Description
routerospf
Configures an OSPF routing process.
nsf cisco helper disable
To disable Cisco nonstop forwarding (NSF) helper mode on a Cisco router that is running Open Shortest Path First (OSPF), use the nsfciscohelperdisablecommand in router configuration mode. To reenable Cisco NSF helper mode, use the no form of this command.
nsfciscohelperdisable
nonsfciscohelperdisable
Syntax Description
This command has no arguments or keywords.
Command Default
This command is enabled by default; therefore, NSF helper mode is disabled on a Cisco router that is running OSPF.
Command Modes
Router configuration (config-router)
Command History
Release
Modification
12.0(32)S
This command was introduced.
12.4(6)T
This command was integrated into Cisco IOS Release 12.4(6)T.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2
This command was integrated into Cisco IOS Release 12.2(31)SB2.
12.2(33)SXH
This command was integrated into Cisco IOS Release 12.2(33)SXH.
15.0(1)M
This command was integrated into Cisco IOS Release 15.0(1)M.
Cisco IOS XE Release 2.6
This command was integrated into Cisco IOS XE Release 2.6
Usage Guidelines
When a router in an OSPF process has NSF enabled, the router is said to be NSF-capable and will operate in graceful restart mode--the OSPF router process performs nonstop forwarding recovery due to a Route Processor (RP) switchover. By default, the neighboring routers of the NSF-capable router will be NSF-aware and will operate in NSF helper mode. When the NSF-capable router is performing graceful restart, the helper routers assist in the nonstop forwarding recovery process. If you do not want the router to help the restarting neighbor with nonstop forwarding recovery, enter the nsfciscohelperdisable command.
Examples
The following example disables NSF helper mode for the Cisco router on OSPF process 3:
router ospf 3
nsf cisco helper disable
Related Commands
Command
Description
nsfcisco
Enables Cisco NSF on a Cisco router.
nsfietf
Enables IETF nonstop forwarding operations on a router that is running OSPF.
nsfietfhelperdisable
Disables IETF NSF helper mode on a router.
nsfietfhelperstrict-lsa-checking
Enables strict LSA checking on a router.
nsf ietf helper disable
To disable Internet Engineering Task Force (IETF) nonstop forwarding (NSF) helper mode on a router that is running Open Shortest Path First (OSPF), use the nsfietfhelperdisablecommand in router configuration mode. To reenable IETF NSF helper mode, use the no form of this command.
nsfietfhelperdisable
nonsfietfhelperdisable
Syntax Description
This command has no arguments or keywords.
Command Default
This command is disabled by default; therefore, IETF NSF helper mode is enabled on a router that is running OSPF.
Command Modes
Router configuration (config-router)
Command History
Release
Modification
12.0(32)S
This command was introduced.
12.4(6)T
This command was integrated into Cisco IOS Release 12.4(6)T.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2
This command was integrated into Cisco IOS Release 12.2(31)SB2.
12.2(33)SXH
This command was integrated into Cisco IOS Release 12.2(33)SXH.
15.0(1)M
This command was integrated into Cisco IOS Release 15.0(1)M.
Cisco IOS XE Release 2.6
This command was integrated into Cisco IOS XE Release 2.6
Usage Guidelines
When a router in an OSPF process has NSF enabled, the router is said to be NSF-capable and will operate in graceful restart mode--the OSPF router process performs nonstop forwarding recovery due to a Route Processor (RP) switchover. By default, the neighboring routers of the NSF-capable router will be NSF-aware and will operate in NSF helper mode. When the NSF-capable router is performing graceful restart, the helper routers assist in the nonstop forwarding recovery process. If you do not want the router to help the restarting neighbor with nonstop forwarding recovery, enter the nsfietfhelperdisable command.
Examples
The following example disables IETF NSF helper mode on a router on OSPF process 4:
router ospf 4
nsf ietf helper disable
Related Commands
Command
Description
nsfcisco
Enables Cisco NSF on a router.
nsfciscohelperdisable
Disables Cisco NSF helper mode on a router.
nsfietf
Enables IETF nonstop forwarding operations on a router that is running OSPF.
nsfietfhelperstrict-lsa-checking
Enables strict LSA checking on a router.
nsr
To enable nonstop
routing (NSR) operations on a router that is running Open Shortest Path First
(OSPF), use the
nsrcommand in
router configuration mode. To disable NSR and return to the default, use the
no form of this
command.
nsr
nonsr
Syntax Description
This command has no
arguments or keywords.
Command Default
NSR is disabled.
Command Modes
Router
configuration (config-router)
Command History
Release
Modification
15.1(2)S
This
command was introduced.
Cisco IOS
XE Release 3.3S
This
command was integrated into Cisco IOS XE Release 3.3S.
15.1(2)SY
This
command was integrated into Cisco IOS Release 15.1(2)SY.
15.2(1)E
This command was integrated into Cisco IOS Release 15.2(1)E.
Usage Guidelines
This command
enables NSR on an OSPF router. With NSR enabled, a router with redundant Route
Processors (RPs) is allowed to maintain its OSPF state and adjacencies across
planned and RP switchovers. It does this by checkpointing state information
from OSPF on the active RP to the standby RP. Later, following a switchover to
the standby RP, OSPF can use this checkpointed information to continue
operation without interruption.
This command is
present only in images for platforms that have a hardware or software
redundancy capability.
Examples
The following
example enables NSR on an OSPF router:
To limit the number of prefixes redistributed into Open Shortest Path First (OSPF) or to generate a warning when the number of prefixes redistributed into OSPF reaches a maximum, use the redistributemaximum-prefixcommand in router configuration mode. To remove the values, use the no form of this command.
Integer from 1 to 4294967295 that specifies the maximum number of IP prefixes that can be redistributed into OSPF.
When the warning-onlykeyword is configured, the maximum value specifies the number of prefixes that can be redistributed into OSPF before the system logs a warning message. Redistribution is not limited.
The maximum number of IP prefixes that are allowed to be redistributed into OSPF, or the number of prefixes allowed to be redistributed into OSPF before the system logs a warning message, depends on whether the warning-onlykeyword is present.
There is no default value for the maximum argument.
If the warning-onlykeyword is also configured, this value does not limit redistribution; it is simply the number of redistributed prefixes that, when reached, causes a warning message to be logged.
percentage
(Optional) Integer from 1 to 100 that specifies the threshold value, as a percentage, at which a warning message should be generated.
The percentage default is 75.
warning-only
(Optional) Causes a warning message to be logged when the number of prefixes defined by the maximumargumenthas been exceeded. Additional redistribution is not prevented.
withdraw
(Optional) Prevents additional redistribution when the number of prefixes defined by the maximumargumenthas been exceeded.
Also, IS-IS rebuilds link-state PDUs (LSPs) without the external (redistributed) IP prefixes.
Command Default
The percentage default is 75.
Command Modes
Router configuration (config-router)
Command History
Release
Modification
12.0(25)S
This command was introduced.
12.2(18)S
This command was integrated into Cisco IOS Release 12.2(18)S.
12.3(4)T
This command was integrated into Cisco IOS Release 12.3(4)T.
12.2(27)SBC
This command was integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Cisco IOS XE Release 2.1
This command was introduced on Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
If someone mistakenly injects a large number of IP prefixes into IS-IS, perhaps by redistributing Border Gateway Protocol (BGP) into IS-IS, the network can be severely flooded. Limiting the number of redistributed prefixes prevents this potential problem.
When the redistributemaximum-prefix command is configured and the number of redistributed prefixes reaches the maximum value configured, no more prefixes will be redistributed (unless the warning-only keyword was configured).
The redistribution limit applies only to external IP prefixes. Default prefixes and summarized prefixes are not limited.
The limit is tracked separately for each not-so-stubby-area (NSSA) because redistribution to NSSAs is done independently for each NSSA and independently of all other regular areas.
Select a maximum value based on your knowledge of how many prefixes are redistributed on the router to the OSPF process.
Examples
Examples
The following example shows how to set a maximum of 600 prefixes that can be redistributed into IS-IS. If the number of prefixes redistributed reaches 75 percent of 600 (450 prefixes), a warning message is logged.
router isis
redistribute maximum-prefix 600
The following example shows how to set a maximum of 1200 prefixes that can be redistributed into IS-IS. If the number of prefixes redistributed reaches 80 percent of 1200 (960 prefixes), a warning message is logged.
router isis
redistribute maximum-prefix 1200 80
The following example shows how to allow two warning messages to be logged. The first message is logged when the number of prefixes redistributed reaches 85 percent of 600 (510 prefixes), and the second message is logged when the number of redistributed prefixes reaches 600. However, the number of redistributed prefixes is not limited.
The following example shows how to set a maximum of 2000 prefixes that can be redistributed into OSPF process when the number of prefixes redistributed reaches 75 percent of 2000 (1500 prefixes), a warning message is logged. Another warning is logged when the limit is reached, and no more prefixes are redistributed.
The following example shows how to set a maximum of 1200 prefixes that can be redistributed into OSPF process when the number of prefixes redistributed reaches 80 percent of 1200 (960 prefixes), a warning message is logged. Another warning is logged when the limit is reached, and no more prefixes are redistributed.
The following example shows how to allow two warning messages to be logged. The first message is logged when the number of prefixes redistributed reaches 85 percent of 600 (510 prefixes), and the second message is logged when the number of redistributed prefixes reaches 600. However, the number of redistributed prefixes is not limited.
To configure an Open Shortest Path First (OSPF) routing process, use the
routerospf command in global configuration mode. To terminate an OSPF routing process, use the
noform of this command.
routerospfprocess-id
[ vrfvrf-name ]
norouterospfprocess-id
[ vrfvrf-name ]
Syntax Description
process-id
Internally used identification parameter for an OSPF routing process. It is locally assigned and can be any positive integer. A unique value is assigned for each OSPF routing process.
vrfvrf-name
(Optional) Specifies the name of the VPN routing and forwarding (VRF) instance to associate with OSPF VRF processes.
Command Default
No OSPF routing process is defined.
Command Modes
Global configuration
Command History
Release
Modification
10.0
This command was introduced.
12.0(7)T
The
vrf keyword and
vpn-name arguments were added to identify a VPN.
12.0(9)ST
The
vrf keyword and
vpn-name arguments were added.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
15.1(2)SNG
This command was implemented on the Cisco ASR 901 Series Aggregation Services Routers.
Usage Guidelines
You can specify multiple OSPF routing processes in each router.
After you enter the
routerospf command, you can enter the maximum number of paths. There can be from 1 to 32 paths.
Examples
The following example configures an OSPF routing process and assign a process number of 109:
Router(config)# router ospf 109
This example shows a basic OSPF configuration using the
routerospf command to configure OSPF VRF instance processes for the VRFs first, second, and third:
Router> enable
Router# configure terminal
Router(config)# router ospf 12 vrf first
Router(config)# router ospf 13 vrf second
Router(config)# router ospf 14 vrf third
Router(config)# exit
The following example shows usage of the
maximum-paths option:
Defines the interfaces on which OSPF runs and defines the area ID for those interfaces.
router-id
To use a fixed router ID, use the
router-id command in router configuration mode. To force Open Shortest Path First (OSPF) to use the previous OSPF router ID behavior, use the
no form of this command.
router-idip-address
norouter-idip-address
Syntax Description
ip-address
Router ID in IP address format.
Command Default
No OSPF routing process is defined.
Command Modes
Router configuration
Command History
Release
Modification
12.0(1)T
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
You can configure an arbitrary value in the IP address format for each router. However, each router ID must be unique.
If this command is used on an OSPF router process which is already active (has neighbors), the new router-ID is used at the next reload or at a manual OSPF process restart. To manually restart the OSPF process, use the clear ip ospf command.
Examples
The following example specifies a fixed router-id:
router-id 10.1.1.1
Related Commands
Command
Description
clearipospf
Clears redistribution based on the OSPF routing process ID.
routerospf
Configures the OSPF routing process.
show ip ospf
To display general information about Open Shortest Path First (OSPF) routing processes, use the
showipospf command in user EXEC or privileged EXEC mode.
showipospf [process-id]
Syntax Description
process-id
(Optional) Process ID. If this argument is included, only information for the specified routing process is included.
Command Modes
User EXEC Privileged EXEC
Command History
Mainline Release
Modification
10.0
This command was introduced.
15.0(1)M
This command was integrated into Cisco IOS Release 15.0(1)M.
0S Release
Modification
12.0(25)S
This command was integrated into Cisco IOS Release 12.0(25)S and the output was expanded to display link-state advertisement (LSA) throttling timers.
12.0(31)S
Support for the Bidirectional Forwarding Detection (BFD) feature was added.
S Release
Modification
12.2(14)S
Support for displaying packet pacing timers was added.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2(18)SXE
This command was integrated into Cisco IOS Release 12.2(18)SXE and support for the BFD feature was added.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
T Release
Modification
12.2(4)T
This command was modified to show packet pacing timers in the displayed output.
12.2(15)T
This command was modified to show additional information if the OSPF Forwarding Address Suppression in Type-5 LSAs feature is configured.
12.3(2)T
The output of this command was expanded to display LSA throttling timers and the limit on redistributed routes.
12.4(4)T
Support for the BFD feature was added.
Examples
The following is sample output from the
showipospf command when entered without a specific OSPF process ID:
Router# show ip ospf
Routing Process "ospf 201" with ID 10.0.0.1 and Domain ID 10.20.0.1
Supports only single TOS(TOS0) routes
Supports opaque LSA
SPF schedule delay 5 secs, Hold time between two SPFs 10 secs
Minimum LSA interval 5 secs. Minimum LSA arrival 1 secs
LSA group pacing timer 100 secs
Interface flood pacing timer 55 msecs
Retransmission pacing timer 100 msecs
Number of external LSA 0. Checksum Sum 0x0
Number of opaque AS LSA 0. Checksum Sum 0x0
Number of DCbitless external and opaque AS LSA 0
Number of DoNotAge external and opaque AS LSA 0
Number of areas in this router is 2. 2 normal 0 stub 0 nssa
External flood list length 0
Area BACKBONE(0)
Number of interfaces in this area is 2
Area has message digest authentication
SPF algorithm executed 4 times
Area ranges are
Number of LSA 4. Checksum Sum 0x29BEB
Number of opaque link LSA 0. Checksum Sum 0x0
Number of DCbitless LSA 3
Number of indication LSA 0
Number of DoNotAge LSA 0
Flood list length 0
Area 172.16.26.0
Number of interfaces in this area is 0
Area has no authentication
SPF algorithm executed 1 times
Area ranges are
192.168.0.0/16 Passive Advertise
Number of LSA 1. Checksum Sum 0x44FD
Number of opaque link LSA 0. Checksum Sum 0x0
Number of DCbitless LSA 1
Number of indication LSA 1
Number of DoNotAge LSA 0
Flood list length 0
Examples
The following is sample output from the
showipospfcommand to verify that the BFD feature has been enabled for OSPF process 123. The relevant command output is shown in bold in the output.
Router# show ip ospf
Routing Process "ospf 123" with ID 172.16.10.1
Supports only single TOS(TOS0) routes
Supports opaque LSA
Supports Link-local Signaling (LLS)
Initial SPF schedule delay 5000 msecs
Minimum hold time between two consecutive SPFs 10000 msecs
Maximum wait time between two consecutive SPFs 10000 msecs
Incremental-SPF disabled
Minimum LSA interval 5 secs
Minimum LSA arrival 1000 msecs
LSA group pacing timer 240 secs
Interface flood pacing timer 33 msecs
Retransmission pacing timer 66 msecs
Number of external LSA 0. Checksum Sum 0x000000
Number of opaque AS LSA 0. Checksum Sum 0x000000
Number of DCbitless external and opaque AS LSA 0
Number of DoNotAge external and opaque AS LSA 0
Number of areas in this router is 1. 1 normal 0 stub 0 nssa
External flood list length 0
BFD is enabled
Area BACKBONE(0)
Number of interfaces in this area is 2
Area has no authentication
SPF algorithm last executed 00:00:03.708 ago
SPF algorithm executed 27 times
Area ranges are
Number of LSA 3. Checksum Sum 0x00AEF1
Number of opaque link LSA 0. Checksum Sum 0x000000
Number of DCbitless LSA 0
Number of indication LSA 0
Number of DoNotAge LSA 0
Flood list length 0
The table below describes the significant fields shown in the display.
Table 3 show ip ospf Field Descriptions
Field
Description
Routing process “ospf 201” with ID 10.0.0.1
Process ID and OSPF router ID.
Supports...
Number of types of service supported (Type 0 only).
SPF schedule delay
Delay time (in seconds) of SPF calculations.
Minimum LSA interval
Minimum interval (in seconds) between link-state advertisements.
LSA group pacing timer
Configured LSA group pacing timer (in seconds).
Interface flood pacing timer
Configured LSA flood pacing timer (in milliseconds).
Retransmission pacing timer
Configured LSA retransmission pacing timer (in milliseconds).
Number of external LSA
Number of external link-state advertisements.
Number of opaque AS LSA
Number of opaque link-state advertisements.
Number of DCbitless external and opaque AS LSA
Number of demand circuit external and opaque link-state advertisements.
Number of DoNotAge external and opaque AS LSA
Number of do not age external and opaque link-state advertisements.
Number of areas in this router is
Number of areas configured for the router.
External flood list length
External flood list length.
BFD is enabled
BFD has been enabled on the OSPF process.
The following is an excerpt of output from the
showipospf command when the OSPF Forwarding Address Suppression in Type-5 LSAs feature is configured:
Router# show ip ospf
.
.
.
Area 2
Number of interfaces in this area is 4
It is a NSSA area
Perform type-7/type-5 LSA translation, suppress forwarding address
.
.
.
Routing Process "ospf 1" with ID 192.168.0.1
Supports only single TOS(TOS0) routes
Supports opaque LSA
Supports Link-local Signaling (LLS)
Initial SPF schedule delay 5000 msecs
Minimum hold time between two consecutive SPFs 10000 msecs
Maximum wait time between two consecutive SPFs 10000 msecs
Incremental-SPF disabled
Minimum LSA interval 5 secs
Minimum LSA arrival 1000 msecs
LSA group pacing timer 240 secs
Interface flood pacing timer 33 msecs
Retransmission pacing timer 66 msecs
Number of external LSA 0. Checksum Sum 0x0
Number of opaque AS LSA 0. Checksum Sum 0x0
Number of DCbitless external and opaque AS LSA 0
Number of DoNotAge external and opaque AS LSA 0
Number of areas in this router is 0. 0 normal 0 stub 0 nssa
External flood list length 0
The table below describes the significant fields shown in the display.
Table 4 show ip ospf Field Descriptions
Field
Description
Area
OSPF area and tag.
Number of interfaces...
Number of interfaces configured in the area.
It is...
Possible types are internal, area border, or autonomous system boundary.
Routing process “ospf 1” with ID 192.168.0.1
Process ID and OSPF router ID.
Supports...
Number of types of service supported (Type 0 only).
Initial SPF schedule delay
Delay time of SPF calculations at startup.
Minimum hold time
Minimum hold time (in milliseconds) between consecutive SPF calculations.
Maximum wait time
Maximum wait time (in milliseconds) between consecutive SPF calculations.
Incremental-SPF
Status of incremental SPF calculations.
Minimum LSA...
Minimum time interval (in seconds) between link-state advertisements, and minimum arrival time (in milliseconds) of link-state advertisements,
LSA group pacing timer
Configured LSA group pacing timer (in seconds).
Interface flood pacing timer
Configured LSA flood pacing timer (in milliseconds).
Retransmission pacing timer
Configured LSA retransmission pacing timer (in milliseconds).
Number of...
Number and type of link-state advertisements that have been received.
Number of external LSA
Number of external link-state advertisements.
Number of opaque AS LSA
Number of opaque link-state advertisements.
Number of DCbitless external and opaque AS LSA
Number of demand circuit external and opaque link-state advertisements.
Number of DoNotAge external and opaque AS LSA
Number of do not age external and opaque link-state advertisements.
Number of areas in this router is
Number of areas configured for the router listed by type.
External flood list length
External flood list length.
The following is sample output from the
showipospf command. In this example, the user had configured the
redistributionmaximum-prefix command to set a limit of 2000 redistributed routes. SPF throttling was configured with the
timersthrottlespf command.
Router# show ip ospf 1
Routing Process "ospf 1" with ID 10.0.0.1
Supports only single TOS(TOS0) routes
Supports opaque LSA
Supports Link-local Signaling (LLS)
It is an autonomous system boundary router
Redistributing External Routes from,
static, includes subnets in redistribution
Maximum limit of redistributed prefixes 2000
Threshold for warning message 75%
Initial SPF schedule delay 5000 msecs
Minimum hold time between two consecutive SPFs 10000 msecs
Maximum wait time between two consecutive SPFs 10000 msecs
The table below describes the significant fields shown in the display.
Table 5 show ip ospf Field Descriptions
Field
Description
Routing process “ospf 1” with ID 10.0.0.1
Process ID and OSPF router ID.
Supports ...
Number of Types of Service supported.
It is ...
Possible types are internal, area border, or autonomous system boundary router.
Redistributing External Routes from
Lists of redistributed routes, by protocol.
Maximum limit of redistributed prefixes
Value set in the
redistributionmaximum-prefix command to set a limit on the number of redistributed routes.
Threshold for warning message
Percentage set in the
redistributionmaximum-prefix command for the threshold number of redistributed routes needed to cause a warning message. The default is 75 percent of the maximum limit.
Initial SPF schedule delay
Delay (in milliseconds) before initial SPF schedule for SPF throttling. Configured with the
timersthrottlespf command.
Minimum hold time between two consecutive SPFs
Minimum hold time (in milliseconds) between two consecutive SPF calculations for SPF throttling. Configured with the
timersthrottlespf command.
Maximum wait time between two consecutive SPFs
Maximum wait time (in milliseconds) between two consecutive SPF calculations for SPF throttling. Configured with the
timersthrottlespf command.
Number of areas
Number of areas in router, area addresses, and so on.
The following is sample output from the
showipospf command. In this example, the user had configured LSA throttling, and those lines of output are displayed in bold.
Router# show ip ospf 1
Routing Process "ospf 4" with ID 10.10.24.4
Supports only single TOS(TOS0) routes
Supports opaque LSA
Supports Link-local Signaling (LLS)
Initial SPF schedule delay 5000 msecs
Minimum hold time between two consecutive SPFs 10000 msecs
Maximum wait time between two consecutive SPFs 10000 msecs
Incremental-SPF disabled
Initial LSA throttle delay 100 msecs Minimum hold time for LSA throttle 10000 msecsMaximum wait time for LSA throttle 45000 msecs
Minimum LSA arrival 1000 msecs
LSA group pacing timer 240 secs
Interface flood pacing timer 33 msecs
Retransmission pacing timer 66 msecs
Number of external LSA 0. Checksum Sum 0x0
Number of opaque AS LSA 0. Checksum Sum 0x0
Number of DCbitless external and opaque AS LSA 0
Number of DoNotAge external and opaque AS LSA 0
Number of areas in this router is 1. 1 normal 0 stub 0 nssa
External flood list length 0
Area 24
Number of interfaces in this area is 2
Area has no authentication
SPF algorithm last executed 04:28:18.396 ago
SPF algorithm executed 8 times
Area ranges are
Number of LSA 4. Checksum Sum 0x23EB9
Number of opaque link LSA 0. Checksum Sum 0x0
Number of DCbitless LSA 0
Number of indication LSA 0
Number of DoNotAge LSA 0
Flood list length 0
The following is sample
showipospfcommand. In this example, the user had configured the
redistributionmaximum-prefix command to set a limit of 2000 redistributed routes. SPF throttling was configured with the
timersthrottlespf command.
Router# show ip ospf 1
Routing Process "ospf 1" with ID 192.168.0.0
Supports only single TOS(TOS0) routes
Supports opaque LSA
Supports Link-local Signaling (LLS)
It is an autonomous system boundary router
Redistributing External Routes from,
static, includes subnets in redistribution
Maximum limit of redistributed prefixes 2000
Threshold for warning message 75%
Initial SPF schedule delay 5000 msecs
Minimum hold time between two consecutive SPFs 10000 msecs
Maximum wait time between two consecutive SPFs 10000 msecs
The table below describes the significant fields shown in the display.
Table 6 show ip ospf Field Descriptions
Field
Description
Routing process “ospf 1” with ID 192.168.0.0.
Process ID and OSPF router ID.
Supports ...
Number of TOS supported.
It is ...
Possible types are internal, area border, or autonomous system boundary routers.
Redistributing External Routes from
Lists of redistributed routes, by protocol.
Maximum limit of redistributed prefixes
Value set in the
redistributionmaximum-prefix command to set a limit on the number of redistributed routes.
Threshold for warning message
Percentage set in the
redistributionmaximum-prefix command for the threshold number of redistributed routes needed to cause a warning message. The default is 75 percent of the maximum limit.
Initial SPF schedule delay
Delay (in milliseconds) before the initial SPF schedule for SPF throttling. Configured with the
timersthrottlespf command.
Minimum hold time between two consecutive SPFs
Minimum hold time (in milliseconds) between two consecutive SPF calculations for SPF throttling. Configured with the
timersthrottlespf command.
Maximum wait time between two consecutive SPFs
Maximum wait time (in milliseconds) between two consecutive SPF calculations for SPF throttling. Configured with the
timersthrottlespf command.
Number of areas
Number of areas in router, area addresses, and so on.
The following is sample output from the
showipospf command. In this example, the user had configured LSA throttling, and those lines of output are displayed in bold.
Router# show ip ospf 1
Routing Process "ospf 4" with ID 10.10.24.4
Supports only single TOS(TOS0) routes
Supports opaque LSA
Supports Link-local Signaling (LLS)
Initial SPF schedule delay 5000 msecs
Minimum hold time between two consecutive SPFs 10000 msecs
Maximum wait time between two consecutive SPFs 10000 msecs
Incremental-SPF disabled
Initial LSA throttle delay 100 msecs Minimum hold time for LSA throttle 10000 msecs Maximum wait time for LSA throttle 45000 msecs
Minimum LSA arrival 1000 msecs
LSA group pacing timer 240 secs
Interface flood pacing timer 33 msecs
Retransmission pacing timer 66 msecs
Number of external LSA 0. Checksum Sum 0x0
Number of opaque AS LSA 0. Checksum Sum 0x0
Number of DCbitless external and opaque AS LSA 0
Number of DoNotAge external and opaque AS LSA 0
Number of areas in this router is 1. 1 normal 0 stub 0 nssa
External flood list length 0
Area 24
Number of interfaces in this area is 2
Area has no authentication
SPF algorithm last executed 04:28:18.396 ago
SPF algorithm executed 8 times
Area ranges are
Number of LSA 4. Checksum Sum 0x23EB9
Number of opaque link LSA 0. Checksum Sum 0x0
Number of DCbitless LSA 0
Number of indication LSA 0
Number of DoNotAge LSA 0
Flood list length 0
show ip ospf border-routers
To display the internal Open Shortest Path First (OSPF) routing table entries to an Area Border Router (ABR) and Autonomous System Boundary Router (ASBR), use the
showipospfborder-routers command in privileged EXEC mode.
showipospfborder-routers
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples
The following is sample output from the
showipospfborder-routers command:
Router# show ip ospf border-routers
OSPF Process 109 internal Routing Table
Codes: i - Intra-area route, I - Inter-area route
i 192.168.97.53 [10] via 172.16.1.53, Serial0, ABR, Area 0.0.0.3, SPF 3
i 192.168.103.51 [10] via 192.168.96.51, Serial0, ABR, Area 0.0.0.3, SPF 3
I 192.168.103.52 [22] via 192.168.96.51, Serial0, ASBR, Area 0.0.0.3, SPF 3
I 192.168.103.52 [22] via 172.16.1.53, Serial0, ASBR, Area 0.0.0.3, SPF 3
The table below describes the significant fields shown in the display.
Table 7
showipospfborder-routers Field Descriptions
Field
Description
192.168.97.53
Router ID of the destination.
[10]
Cost of using this route.
via 172.16.1.53
Next hop toward the destination.
Serial0
Interface type for the outgoing interface.
ABR
The router type of the destination; it is either an ABR or ASBR or both.
Area
The area ID of the area from which this route is learned.
SPF 3
The internal number of the shortest path first (SPF) calculation that installs this route.
show ip ospf database
To display lists of information related to the Open Shortest Path First (OSPF) database for a specific router, use the
showipospfdatabase command in EXEC mode.
(Optional) Internal identification. It is locally assigned and can be any positive integer. The number used here is the number assigned administratively when enabling the OSPF routing process.
area-id
(Optional) Area number associated with the OSPF address range defined in the
network router configuration command used to define the particular area.
adv-router [ip-address
(Optional) Displays all the LSAs of the specified router. If no IP address is included, the information is about the local router itself (in this case, the same as
self-originate).
link-state-id
(Optional) Portion of the Internet environment that is being described by the advertisement. The value entered depends on the advertisement’s LS type. It must be entered in the form of an IP address.
When the link state advertisement is describing a network, the
link-state-id can take one of two forms:
The network’s IP address (as in type 3 summary link advertisements and in autonomous system external link advertisements).
A derived address obtained from the link state ID. (Note that masking a network links advertisement’s link state ID with the network’s subnet mask yields the network’s IP address.)
When the link state advertisement is describing a router, the link state ID is always the described router’s OSPF router ID.
When an autonomous system external advertisement (LS Type = 5) is describing a default route, its link state ID is set to Default Destination (0.0.0.0).
asbr-summary
(Optional) Displays information only about the autonomous system boundary router summary LSAs.
database-summary
(Optional) Displays how many of each type of LSA for each area there are in the database, and the total.
external
(Optional) Displays information only about the external LSAs.
network
(Optional) Displays information only about the network LSAs.
nssa-external
(Optional) Displays information only about the NSSA external LSAs.
router
(Optional) Displays information only about the router LSAs.
self-originate
(Optional) Displays only self-originated LSAs (from the local router).
summary
(Optional) Displays information only about the summary LSAs.
Command Modes
EXEC
Command History
Release
Modification
10.0
This command was introduced.
11.0
The
database-summary keyword was added.
12.0
The following keywords were added:
self-originate
adv-router
12.0(25)S
The output of the
showipospfdatabasedatabase-summarycommand was increased to include Self-originated Type-7 and Self-originated Type-5 output.
12.2(27)SBC
This command was integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
The various forms of this command deliver information about different OSPF link state advertisements.
Examples
The following is sample output from the
showipospfdatabase command when no arguments or keywords are used:
Router# show ip ospf database
OSPF Router with id(192.168.239.66) (Process ID 300)
Displaying Router Link States(Area 0.0.0.0)
Link ID ADV Router Age Seq# Checksum Link count
172.16.21.6 172.16.21.6 1731 0x80002CFB 0x69BC 8
172.16.21.5 172.16.21.5 1112 0x800009D2 0xA2B8 5
172.16.1.2 172.16.1.2 1662 0x80000A98 0x4CB6 9
172.16.1.1 172.16.1.1 1115 0x800009B6 0x5F2C 1
172.16.1.5 172.16.1.5 1691 0x80002BC 0x2A1A 5
172.16.65.6 172.16.65.6 1395 0x80001947 0xEEE1 4
172.16.241.5 172.16.241.5 1161 0x8000007C 0x7C70 1
172.16.27.6 172.16.27.6 1723 0x80000548 0x8641 4
172.16.70.6 172.16.70.6 1485 0x80000B97 0xEB84 6
Displaying Net Link States(Area 0.0.0.0)
Link ID ADV Router Age Seq# Checksum
172.16.1.3 192.168.239.66 1245 0x800000EC 0x82E
Displaying Summary Net Link States(Area 0.0.0.0)
Link ID ADV Router Age Seq# Checksum
172.16.240.0 172.16.241.5 1152 0x80000077 0x7A05
172.16.241.0 172.16.241.5 1152 0x80000070 0xAEB7
172.16.244.0 172.16.241.5 1152 0x80000071 0x95CB
The table below describes the significant fields shown in the display.
Table 8 show ip ospf Database Field Descriptions
Field
Description
Link ID
Router ID number.
ADV Router
Advertising router’s ID.
Age
Link state age.
Seq#
Link state sequence number (detects old or duplicate link state advertisements).
Checksum
Fletcher checksum of the complete contents of the link state advertisement.
Link count
Number of interfaces detected for router.
The following is sample output from the
showipospfdatabasecommand with the
asbr-summarykeyword:
Router# show ip ospf database asbr-summary
OSPF Router with id(192.168.239.66) (Process ID 300)
Displaying Summary ASB Link States(Area 0.0.0.0)
LS age: 1463
Options: (No TOS-capability)
LS Type: Summary Links(AS Boundary Router)
Link State ID: 172.16.245.1 (AS Boundary Router address)
Advertising Router: 172.16.241.5
LS Seq Number: 80000072
Checksum: 0x3548
Length: 28
Network Mask: 0.0.0.0 TOS: 0 Metric: 1
The table below describes the significant fields shown in the display.
Table 9 show ip ospf database asbr-summary Field Descriptions
Field
Description
OSPF Router with id
Router ID number.
Process ID
OSPF process ID.
LS age
Link state age.
Options
Type of service options (Type 0 only).
LS Type
Link state type.
Link State ID
Link state ID (autonomous system boundary router).
Advertising Router
Advertising router’s ID.
LS Seq Number
Link state sequence (detects old or duplicate link state advertisements).
Checksum
LS checksum (Fletcher checksum of the complete contents of the link state advertisement).
Length
Length in bytes of the link state advertisement.
Network Mask
Network mask implemented.
TOS
Type of service.
Metric
Link state metric.
The following is sample output from the
showipospfdatabasecommand with the
externalkeyword:
Router# show ip ospf database external
OSPF Router with id(192.168.239.66) (Autonomous system 300)
Displaying AS External Link States
LS age: 280
Options: (No TOS-capability)
LS Type: AS External Link
Link State ID: 10.105.0.0 (External Network Number)
Advertising Router: 172.16.70.6
LS Seq Number: 80000AFD
Checksum: 0xC3A
Length: 36
Network Mask: 255.255.0.0
Metric Type: 2 (Larger than any link state path)
TOS: 0
Metric: 1
Forward Address: 0.0.0.0
External Route Tag: 0
The table below describes the significant fields shown in the display.
Table 10 show ip ospf database external Field Descriptions
Field
Description
OSPF Router with id
Router ID number.
Autonomous system
OSPF autonomous system number (OSPF process ID).
LS age
Link state age.
Options
Type of service options (Type 0 only).
LS Type
Link state type.
Link State ID
Link state ID (external network number).
Advertising Router
Advertising router’s ID.
LS Seq Number
Link state sequence number (detects old or duplicate link state advertisements).
Checksum
LS checksum (Fletcher checksum of the complete contents of the LSA).
Length
Length in bytes of the link state advertisement.
Network Mask
Network mask implemented.
Metric Type
External Type.
TOS
Type of service.
Metric
Link state metric.
Forward Address
Forwarding address. Data traffic for the advertised destination will be forwarded to this address. If the forwarding address is set to 0.0.0.0, data traffic will be forwarded instead to the advertisement’s originator.
External Route Tag
External route tag, a 32-bit field attached to each external route. This is not used by the OSPF protocol itself.
The following is sample output from the
showipospfdatabasecommand with the
networkkeyword:
Router# show ip ospf database network
OSPF Router with id(192.168.239.66) (Process ID 300)
Displaying Net Link States(Area 0.0.0.0)
LS age: 1367
Options: (No TOS-capability)
LS Type: Network Links
Link State ID: 172.16.1.3 (address of Designated Router)
Advertising Router: 192.168.239.66
LS Seq Number: 800000E7
Checksum: 0x1229
Length: 52
Network Mask: 255.255.255.0
Attached Router: 192.168.239.66
Attached Router: 172.16.241.5
Attached Router: 172.16.1.1
Attached Router: 172.16.54.5
Attached Router: 172.16.1.5
The table below describes the significant fields shown in the display.
Table 11 show ip ospf database network Field Descriptions
Field
Description
OSPF Router with id
Router ID number.
Process ID 300
OSPF process ID.
LS age
Link state age.
Options
Type of service options (Type 0 only).
LS Type:
Link state type.
Link State ID
Link state ID of designated router.
Advertising Router
Advertising router’s ID.
LS Seq Number
Link state sequence (detects old or duplicate link state advertisements).
Checksum
LS checksum (Fletcher checksum of the complete contents of the link state advertisement).
Length
Length in bytes of the link state advertisement.
Network Mask
Network mask implemented.
AS Boundary Router
Definition of router type.
Attached Router
List of routers attached to the network, by IP address.
The following is sample output from the
showipospfdatabasecommand with the
routerkeyword:
Router# show ip ospf database router
OSPF Router with id(192.168.239.66) (Process ID 300)
Displaying Router Link States(Area 0.0.0.0)
LS age: 1176
Options: (No TOS-capability)
LS Type: Router Links
Link State ID: 172.16.21.6
Advertising Router: 172.16.21.6
LS Seq Number: 80002CF6
Checksum: 0x73B7
Length: 120
AS Boundary Router
155 Number of Links: 8
Link connected to: another Router (point-to-point)
(link ID) Neighboring Router ID: 172.16.21.5
(Link Data) Router Interface address: 172.16.21.6
Number of TOS metrics: 0
TOS 0 Metrics: 2
The table below describes the significant fields shown in the display.
Table 12 show ip ospf database router Field Descriptions
Field
Description
OSPF Router with id
Router ID number.
Process ID
OSPF process ID.
LS age
Link state age.
Options
Type of service options (Type 0 only).
LS Type
Link state type.
Link State ID
Link state ID.
Advertising Router
Advertising router’s ID.
LS Seq Number
Link state sequence (detects old or duplicate link state advertisements).
Checksum
LS checksum (Fletcher checksum of the complete contents of the link state advertisement).
Length
Length in bytes of the link state advertisement.
AS Boundary Router
Definition of router type.
Number of Links
Number of active links.
link ID
Link type.
Link Data
Router interface address.
TOS
Type of service metric (Type 0 only).
The following is sample output from
showipospfdatabasecommand with the
summarykeyword:
Router# show ip ospf database summary
OSPF Router with id(192.168.239.66) (Process ID 300)
Displaying Summary Net Link States(Area 0.0.0.0)
LS age: 1401
Options: (No TOS-capability)
LS Type: Summary Links(Network)
Link State ID: 172.16.240.0 (summary Network Number)
Advertising Router: 172.16.241.5
LS Seq Number: 80000072
Checksum: 0x84FF
Length: 28
Network Mask: 255.255.255.0 TOS: 0 Metric: 1
The table below describes the significant fields shown in the display.
Table 13 show ip ospf database summary Field Descriptions
Field
Description
OSPF Router with id
Router ID number.
Process ID
OSPF process ID.
LS age
Link state age.
Options
Type of service options (Type 0 only).
LS Type
Link state type.
Link State ID
Link state ID (summary network number).
Advertising Router
Advertising router’s ID.
LS Seq Number
Link state sequence (detects old or duplicate link state advertisements).
Checksum
LS checksum (Fletcher checksum of the complete contents of the link state advertisement).
Length
Length in bytes of the link state advertisement.
Network Mask
Network mask implemented.
TOS
Type of service.
Metric
Link state metric.
The following is sample output from
showipospfdatabasecommand with the
database-summarykeyword:
Router# show ip ospf database database-summary
OSPF Router with ID (10.0.0.1) (Process ID 1)
Area 0 database summary
LSA Type Count Delete Maxage
Router 3 0 0
Network 0 0 0
Summary Net 0 0 0
Summary ASBR 0 0 0
Type-7 Ext 0 0 0
Self-originated Type-7 0
Opaque Link 0 0 0
Opaque Area 0 0 0
Subtotal 3 0 0
Process 1 database summary
LSA Type Count Delete Maxage
Router 3 0 0
Network 0 0 0
Summary Net 0 0 0
Summary ASBR 0 0 0
Type-7 Ext 0 0 0
Opaque Link 0 0 0
Opaque Area 0 0 0
Type-5 Ext 0 0 0
Self-originated Type-5 200
Opaque AS 0 0 0
Total 203 0 0
The table below describes the significant fields shown in the display.
Table 14 show ip ospf database database-summary Field Descriptions
Field
Description
Area 0 database summary
Area number.
Count
Count of LSAs of the type identified in the first column.
Router
Number of router link state advertisements in that area.
Network
Number of network link state advertisements in that area.
Summary Net
Number of summary link state advertisements in that area.
Summary ASBR
Number of summary autonomous system boundary router (ASBR) link state advertisements in that area.
Type-7 Ext
Type-7 LSA count.
Self-originated Type-7
Self-originated Type-7 LSA.
Opaque Link
Type-9 LSA count.
Opaque Area
Type-10 LSA count
Subtotal
Sum of LSAs for that area.
Delete
Number of link state advertisements that are marked “Deleted” in that area.
Maxage
Number of link state advertisements that are marked “Maxaged” in that area.
Process 1 database summary
Database summary for the process.
Count
Count of LSAs of the type identified in the first column.
Router
Number of router link state advertisements in that process.
Network
Number of network link state advertisements in that process.
Summary Net
Number of summary link state advertisements in that process.
Summary ASBR
Number of summary autonomous system boundary router (ASBR) link state advertisements in that process.
Type-7 Ext
Type-7 LSA count.
Opaque Link
Type-9 LSA count.
Opaque Area
Type-10 LSA count.
Type-5 Ext
Type-5 LSA count.
Self-Originated Type-5
Self-originated Type-5 LSA count.
Opaque AS
Type-11 LSA count.
Total
Sum of LSAs for that process.
Delete
Number of link state advertisements that are marked “Deleted” in that process.
Maxage
Number of link state advertisements that are marked “Maxaged” in that process.
show ip ospf flood-list
To display a list of Open Shortest Path First (OSPF) link-state advertisements (LSAs) waiting to be flooded over an interface, use the
showipospfflood-listcommand in EXEC mode.
Interface type over which the LSAs will be flooded.
interface-number
Interface number over which the LSAs will be flooded.
Command Modes
EXEC
Command History
Release
Modification
12.0(1)T
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
Use this command to observe OSPF packet pacing.
Examples
The following is sample output of the
showipospfflood-list command:
Router# show ip ospf flood-list ethernet 1
Interface Ethernet1, Queue length 20
Link state flooding due in 12 msec
Type LS ID ADV RTR Seq NO Age Checksum
5 10.2.195.0 192.168.0.163 0x80000009 0 0xFB61
5 10.1.192.0 192.168.0.163 0x80000009 0 0x2938
5 10.2.194.0 192.168.0.163 0x80000009 0 0x757
5 10.1.193.0 192.168.0.163 0x80000009 0 0x1E42
5 10.2.193.0 192.168.0.163 0x80000009 0 0x124D
5 10.1.194.0 192.168.0.163 0x80000009 0 0x134C
The table below describes the significant fields shown in the display.
Table 15 show ip ospf flood-list Field Descriptions
Field
Description
Interface Ethernet1
Interface for which information is displayed.
Queue length
Number of LSAs waiting to be flooded.
Link state flooding due in
Length of time before next link-state transmission.
Type
Type of LSA.
LS ID
Link-state ID of the LSA.
ADV RTR
IP address of advertising router.
Seq NO
Sequence number of LSA.
Age
Age of LSA (in seconds).
Checksum
Checksum of LSA.
show ip ospf interface
To display interface information related to Open Shortest Path First (OSPF), use the
show ip ospf interface command in user EXEC or privileged EXEC mode.
(Optional) Process ID number. If this argument is included, only information for the specified routing process is included. The range is 1 to 65535.
type
(Optional) Interface type. If the
type argument is included, only information for the specified interface type is included.
number
(Optional) Interface number. If the
number argument is included, only information for the specified interface number is included.
brief
(Optional) Displays brief overview information for OSPF interfaces, states, addresses and masks, and areas on the device.
multicast
(Optional) Displays multicast information.
topologytopology-name
(Optional) Displays OSPF-related information about the named topology instance.
topology base
(Optional) Displays OSPF-related information about the base topology.
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Release
Modification
10.0
This command was introduced.
12.0(25)S
This command was modified. The
brief keyword was added.
12.2(15)T
This command was modified. The
brief keyword was added.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SRB
The
multicast,
topology,
base, and
topology-name keywords and argument were added.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
12.2(33)SRC
Support for the OSPF TTL Security Check feature was added.
15.0(1)M
This command was integrated into Cisco IOS Release 15.0(1)M.
15.1(3)S
This command was modified to display output when loop-free alternate (LFA) Fast Reroute (FRR) is enabled on an interface and whether it can be a protected or a protecting interface.
Examples
The following is sample output from the
show ip ospf interface command when Ethernet interface 0/0 is specified. It shows that LFA and FRR is enabled on the interface and that it can be both a protected and a protecting interface.
Device# show ip ospf interface ethernet 0/0
Ethernet0/0 is up, line protocol is up
Internet Address 192.168.254.202/24, Area 0
Process ID 1, Router ID 192.168.99.1, Network Type BROADCAST, Cost: 10
Topology-MTID Cost Disabled Shutdown Topology Name
0 10 no no Base
Transmit Delay is 1 sec, State DR, Priority 1
Designated Router (ID) 192.168.99.1, Interface address 192.168.254.202
Backup Designated router (ID) 192.168.254.10, Interface address 192.168.254.10
Timer intervals configured, Hello 10, Dead 40, Wait 40, Retransmit 5
oob-resync timeout 40
Hello due in 00:00:05
Supports Link-local Signaling (LLS)
Cisco NSF helper support enabled
IETF NSF helper support enabled
Can be protected by per-prefix Loop-free FastReroute
Can be used for per-prefix Loop-free FastReroute repair paths
Index 1/1, flood queue length 0
Next 0x0(0)/0x0(0)
Last flood scan length is 1, maximum is 1
Last flood scan time is 0 msec, maximum is 0 msec
Neighbor Count is 1, Adjacent neighbor count is 1
Adjacent with neighbor 192.168.254.10 (Backup Designated Router)
Suppress hello for 0 neighbor(s)
In Cisco IOS Release 12.2(33)SRB, the following sample output from the
show ip ospf interface brief topology VOICE command shows a summary of information, including a confirmation that the Multitopology Routing (MTR) VOICE topology is configured in the interface configuration:
Device# show ip ospf interface brief topology VOICE
VOICE Topology (MTID 10)
Interface PID Area IP Address/Mask Cost State Nbrs F/C
Lo0 1 0 10.0.0.2/32 1 LOOP 0/0
Se2/0 1 0 10.1.0.2/30 10 P2P 1/1
The following sample output from the
show ip ospf interface brief topology VOICE command displays details of the MTR VOICE topology for the interface. When the command is entered without the
brief keyword, more information is displayed.
Device# show ip ospf interface topology VOICE
VOICE Topology (MTID 10)
Loopback0 is up, line protocol is up
Internet Address 10.0.0.2/32, Area 0
Process ID 1, Router ID 10.0.0.2, Network Type LOOPBACK
Topology-MTID Cost Disabled Shutdown Topology Name
10 1 no no VOICE
Loopback interface is treated as a stub Host Serial2/0 is up, line protocol is up
Internet Address 10.1.0.2/30, Area 0
Process ID 1, Router ID 10.0.0.2, Network Type POINT_TO_POINT
Topology-MTID Cost Disabled Shutdown Topology Name
10 10 no no VOICE
Transmit Delay is 1 sec, State POINT_TO_POINT
Timer intervals configured, Hello 10, Dead 40, Wait 40, Retransmit 5
oob-resync timeout 40
Hello due in 00:00:03
Supports Link-local Signaling (LLS)
Cisco NSF helper support enabled
IETF NSF helper support enabled
Index 1/1, flood queue length 0
Next 0x0(0)/0x0(0)
Last flood scan length is 1, maximum is 1
Last flood scan time is 0 msec, maximum is 0 msec
Neighbor Count is 1, Adjacent neighbor count is 1
Adjacent with neighbor 10.0.0.1
Suppress hello for 0 neighbor(s)
In Cisco IOS Release 12.2(33)SRC, the following sample output from the
show ip ospf interface command displays details about the configured Time-to-Live (TTL) limits:
Device# show ip ospf interface ethernet 0
.
.
.
Strict TTL checking enabled
! or a message similar to the following is displayed
Strict TTL checking enabled, up to 4 hops allowed
.
.
.
The table below describes the significant fields shown in the displays.
Table 16
show ip ospf interface Field Descriptions
Field
Description
Ethernet
Status of the physical link and operational status of the protocol.
Process ID
OSPF process ID.
Area
OSPF area.
Cost
Administrative cost assigned to the interface.
State
Operational state of the interface.
Nbrs F/C
OSPF neighbor count.
Internet Address
Interface IP address, subnet mask, and area address.
Topology-MTID
MTR topology Multitopology Identifier (MTID). A number assigned so that the protocol can identify the topology associated with information that it sends to its peers.
Transmit Delay
Transmit delay in seconds, interface state, and device priority.
Designated Router
Designated router ID and respective interface IP address.
Backup Designated router
Backup designated router ID and respective interface IP address.
Timer intervals configured
Configuration of timer intervals.
Hello
Number of seconds until the next hello packet is sent out this interface.
Strict TTL checking enabled
Only one hop is allowed.
Strict TTL checking enabled, up to 4 hops allowed
A set number of hops has been explicitly configured.
Neighbor Count
Count of network neighbors and list of adjacent neighbors.
show ip ospf neighbor
To display Open Shortest Path First (OSPF) neighbor information on a per-interface basis, use the
showipospfneighbor command in privileged EXEC mode.
(Optional) Type and number associated with a specific OSPF interface.
neighbor-id
(Optional) Neighbor hostname or IP address in A.B.C.D format.
detail
(Optional) Displays all neighbors given in detail (lists all neighbors).
fast-reroute
(Optional) Displays per-neighbor border router tables and SPF statistics.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
10.0
This command was introduced.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
12.2(33)SRC
Support for the OSPF TTL Security Check feature was added.
15.0(1)M
This command was integrated into Cisco IOS Release 15.0(1)M.
15.1(3)S
This command was modified. The
fast-reroute keyword was added.
Examples
The following sample output from theshowipospfneighbor command shows a single line of summary information for each neighbor:
Router# show ip ospf neighbor
Neighbor ID Pri State Dead Time Address Interface
10.199.199.137 1 FULL/DR 0:00:31 192.168.80.37 Ethernet0
172.16.48.1 1 FULL/DROTHER 0:00:33 172.16.48.1 Fddi0
172.16.48.200 1 FULL/DROTHER 0:00:33 172.16.48.200 Fddi0
10.199.199.137 5 FULL/DR 0:00:33 172.16.48.189 Fddi0
The following is sample output showing summary information about the neighbor that matches the neighbor ID:
Router# show ip ospf neighbor 10.199.199.137
Neighbor 10.199.199.137, interface address 192.168.80.37
In the area 0.0.0.0 via interface Ethernet0
Neighbor priority is 1, State is FULL
Options 2
Dead timer due in 0:00:32
Link State retransmission due in 0:00:04
Neighbor 10.199.199.137, interface address 172.16.48.189
In the area 0.0.0.0 via interface Fddi0
Neighbor priority is 5, State is FULL
Options 2
Dead timer due in 0:00:32
Link State retransmission due in 0:00:03
If you specify the interface along with the neighbor ID, the system displays the neighbors that match the neighbor ID on the interface, as in the following sample display:
Router# show ip ospf neighbor ethernet 0 10.199.199.137
Neighbor 10.199.199.137, interface address 192.168.80.37
In the area 0.0.0.0 via interface Ethernet0
Neighbor priority is 1, State is FULL
Options 2
Dead timer due in 0:00:37
Link State retransmission due in 0:00:04
You can also specify the interface without the neighbor ID to show all neighbors on the specified interface, as in the following sample display:
Router# show ip ospf neighbor fddi 0
ID Pri State Dead Time Address Interface
172.16.48.1 1 FULL/DROTHER 0:00:33 172.16.48.1 Fddi0
172.16.48.200 1 FULL/DROTHER 0:00:32 172.16.48.200 Fddi0
10.199.199.137 5 FULL/DR 0:00:32 172.16.48.189 Fddi0
The following is sample output from theshowipospfneighbordetail command:
Router# show ip ospf neighbor detail
Neighbor 192.168.5.2, interface address 10.225.200.28
In the area 0 via interface GigabitEthernet1/0/0
Neighbor priority is 1, State is FULL, 6 state changes
DR is 10.225.200.28 BDR is 10.225.200.30
Options is 0x42
LLS Options is 0x1 (LR), last OOB-Resync 00:03:08 ago
Dead timer due in 00:00:36
Neighbor is up for 00:09:46
Index 1/1, retransmission queue length 0, number of retransmission 1
First 0x0(0)/0x0(0) Next 0x0(0)/0x0(0)
Last retransmission scan length is 1, maximum is 1
Last retransmission scan time is 0 msec, maximum is 0 msec
The table below describes the significant fields shown in the displays.
Area and interface through which the OSPF neighbor is known.
Neighbor priority
Router priority of the neighbor and neighbor state.
State
OSPF state. If one OSPF neighbor has enabled TTL security, the other side of the connection will show the neighbor in the INIT state.
state changes
Number of state changes since the neighbor was created. This value can be reset using the
clearipospfcountersneighbor command.
DR is
Router ID of the designated router for the interface.
BDR is
Router ID of the backup designated router for the interface.
Options
Hello packet options field contents. (E-bit only. Possible values are 0 and 2; 2 indicates area is not a stub; 0 indicates area is a stub.)
LLS Options..., last OOB-Resync
Link-Local Signaling and out-of-band (OOB) link-state database resynchronization performed hours:minutes:seconds ago. This is nonstop forwarding (NSF) information. The field indicates the last successful out-of-band resynchronization with the NSF-capable router.
Dead timer due in
Expected time in hours:minutes:seconds before Cisco IOS software will declare the neighbor dead.
Neighbor is up for
Number of hours:minutes:seconds since the neighbor went into the two-way state.
Index
Neighbor location in the area-wide and autonomous system-wide retransmission queue.
retransmission queue length
Number of elements in the retransmission queue.
number of retransmission
Number of times update packets have been re-sent during flooding.
First
Memory location of the flooding details.
Next
Memory location of the flooding details.
Last retransmission scan length
Number of link state advertisements (LSAs) in the last retransmission packet.
maximum
Maximum number of LSAs sent in any retransmission packet.
Last retransmission scan time
Time taken to build the last retransmission packet.
maximum
Maximum time, in milliseconds, taken to build any retransmission packet.
Examples
The following is sample output from theshowipospfneighbor command showing a single line of summary information for each neighbor. If one OSPF neighbor has enabled TTL security, the other side of the connection will show the neighbor in the INIT state.
Router# show ip ospf neighbor
Neighbor ID Pri State Dead Time Address Interface
10.199.199.137 1 FULL/DR 0:00:31 192.168.80.37 Ethernet0
172.16.48.1 1 FULL/DROTHER 0:00:33 172.16.48.1 Fddi0
172.16.48.200 1 FULL/DROTHER 0:00:33 172.16.48.200 Fddi0
10.199.199.137 5 FULL/DR 0:00:33 172.16.48.189 Fddi0
172.16.1.201 1 INIT/DROTHER 00.00.35 10.1.1.201 Ethernet0/0
The following sample output from the
show ip ospf neighbor command shows the network from the neighbor’s point of view:
Router# show ip ospf neighbor 192.0.2.1 fast-reroute
OSPF Router with ID (192.1.1.1) (Process ID 1)
Area with ID (0)
Neighbor with Router ID 192.0.2.1:
Reachable over:
Ethernet0/0, IP address 192.0.2.1, cost 10
SPF was executed 1 times, distance to computing router 10
Router distance table:
192.1.1.1 i [10]
192.0.2.1 i [0]
192.3.3.3 i [10]
192.4.4.4 i [20]
192.5.5.5 i [20]
Network LSA distance table:
192.2.12.2 i [10]
192.2.13.3 i [20]
192.2.14.4 i [20]
192.2.15.5 i [20]
show ip ospf nsr
To display IP Open Shortest Path First (OSPF) nonstop routing (NSR) status information, use the showipospfnsr command in privileged EXEC mode.
(Optional) Process ID. If this argument is used, only information for the specified OSPF routing process is included.
objects
(Optional) Displays information on the OSPF NSR objects in the different OSPF routing processes.
statistics
(Optional) Displays OSPF NSR statistical information for the different OSPF routing processes.
Command Modes
Privileged EXEC (#)
Command History
Release
Modification
15.1(2)S
This command was introduced.
Cisco IOS XE Release 3.3S
This command was integrated into Cisco IOS XE Release 3.3S.
15.2(1) E
This command was integrated into 15.2(1) E.
Examples
The following sample output from the showipospfnsrcommand shows that OSPF on the standby RP is fully synchronized and ready to continue operation if the active RP fails or if a manual switchover is performed. NSR is configured and enabled for the “ospf 1” OSPF routing process. The fields are self-explanatory.
Router# show ip ospf
1 nsr
Active RP
Operating in duplex mode
Redundancy state: ACTIVE
Peer redundancy state: STANDBY HOT
Checkpoint peer ready
Checkpoint messages enabled
ISSU negotiation complete
ISSU versions compatible
Routing Process "ospf 1" with ID 10.1.1.100
NSR configured
Checkpoint message sequence number: 6360
Standby synchronization state: synchronized
Bulk sync operations: 1
Next sync check time: 18:48:27.097 PST Fri Dec 10 2010
LSA Count: 3301, Checksum Sum 0x06750217
Related Commands
Command
Description
nsr
Enables NSR on a router that is running OSPF.
show ip ospf request-list
To display a list of all link-state advertisements (LSAs) requested by a router, use the
showipospfrequest-listcommand in EXEC mode.
(Optional) Displays the list of all LSAs requested by the router from this neighbor.
interface
(Optional) Displays the list of all LSAs requested by the router from this interface.
interface-neighbor
(Optional) Displays the list of all LSAs requested by the router on this interface from this neighbor.
Command Modes
EXEC
Command History
Release
Modification
10.2
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
The information displayed by the
showipospfrequest-listcommand is useful in debugging Open Shortest Path First (OSPF) routing operations.
Examples
The following is sample output from the
showipospfrequest-list command:
Router# show ip ospf request-list serial 0
OSPF Router with ID (192.168.1.11) (Process ID 1)
Neighbor 192.168.1.12, interface Serial0 address 172.16.1.12
Type LS ID ADV RTR Seq NO Age Checksum
1 192.168.1.12 192.168.1.12 0x8000020D 8 0x6572
The table below describes the significant fields shown in the displays.
Table 18
showipospfrequest-listField Descriptions
Field
Description
Type
LSA-type.
LS ID
IP address of the neighbor router.
ADV RTR
IP address of the advertising router.
Seq NO
Packet sequence number of the LSA.
Age
Age, in seconds, of the LSA.
Checksum
Checksum number of the LSA.
show ip ospf sham-links
To display information about all sham-links configured for a provider
edge (PE) router in the Virtual Private Network (VPN) backbone, use the
showipospfsham-links command in EXEC mode.
showipospfsham-links
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values.
Command Modes
EXEC
Command History
Release
Modification
12.2(8)T
This command was introduced.
12.0(21)ST
This command was integrated into Cisco IOS Release
12.0(21)ST, and support for Cisco 12000 series Internet Router was added.
12.0(22)S
This command was integrated into Cisco IOS Release
12.0(22)S, and support for Cisco 10000 series Internet Routers was added.
12.2(33)SRA
This command was integrated into Cisco IOS Release
12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX
train. Support in a specific 12.2SX release of this train depends on your
feature set, platform, and platform hardware.
Usage Guidelines
Use this command to display Open Shortest Path First (OSPF)
information about the sham-links configured on a PE router.
Examples
The following example shows sample output from the
showipospfsham-links command for a PE router in the VPN
backbone:
Router1# show ip ospf sham-links
Sham Link OSPF_SL0 to address 10.44.0.1 is up
Area 120 source address 10.0.0.1
Run as demand circuit
DoNotAge LSA allowed., Cost of using 1
Transmit Delay is 1 sec, State POINT_TO_POINT,
Timer intervals configured, Hello 10, Dead 40, Wait 40, Retransmit 5
Hello due in 00:00:09
Adjacency State FULL (Hello suppressed)
Index 2/2, retransmission queue length 0, number of retransmission 27
First 0x0(0)/0x0(0) Next 0x0(0)/0x0(0)
Last retransmission scan length is 0, maximum is 2
Last retransmission scan time is 0 msec, maximum is 0 msec
show ip ospf statistics
To display Open Shortest Path First (OSPF) shortest path first (SPF) calculation statistics, use the
showipospfstatisticscommand in user EXEC or privileged EXEC mode.
showipospfstatistics [detail]
Syntax Description
detail
(Optional) Displays statistics separately for each OSPF area and includes additional, more detailed statistics.
Command Modes
User EXEC Privileged EXEC
Command History
Release
Modification
12.0(24)S
This command was introduced.
12.2(18)S
The command was integrated into Cisco IOS Release 12.2(18)S.
12.3(2)T
The command was integrated into Cisco IOS Release 12.3(2)T.
Usage Guidelines
The
showipospfstatistics command provides important information about SPF calculations and the events that trigger them. This information can be meaningful for both OSPF network maintenance and troubleshooting. For example, entering the
showipospfstatistics command is recommended as the first troubleshooting step for link-state advertisement (LSA) flapping.
Examples
The following is sample output from the
showipospfstatisticscommand that shows a single line of information for each SPF calculation:
Router# show ip ospf statistics
OSPF process ID 200
------------------------------------------
Area 0: SPF algorithm executed 10 times
Area 200: SPF algorithm executed 8 times
Summary OSPF SPF statistic
SPF calculation time
Delta T Intra D-Intra Summ D-Summ Ext D-Ext Total Reason
08:17:16 0 0 0 0 0 0 0 R,
08:16:47 0 0 0 0 0 0 0 R, N,
08:16:37 0 0 0 0 0 0 0 R, X
00:04:40 208 40 208 44 220 0 720 R, N, SN, X
00:03:15 0 112 4 108 8 96 328 R, N, SN, X
00:02:55 164 40 176 44 188 0 612 R, N, SN, X
00:01:49 0 4 4 0 4 4 16 R, N, SN, X
00:01:48 0 0 4 0 4 0 12 R, N, SN, SA, X
00:01:43 0 0 4 0 4 0 8 R,
00:00:53 164 40 176 44 188 0 612 R, N, SN, X
The table below describes the significant fields shown in the display.
Table 19
showipospfstatisticsField Descriptions
Field
Description
OSPF process ID
A unique value assigned to the OSPF process in the configuration.
Area
OSPF area ID.
SPF algorithm executed
Number of times SPF algorithm has been executed for the particular area.
Delta T
Amount of time in milliseconds that has passed from when SPF started its calculation to the current time.
Intra
Time in milliseconds for the SPF algorithm to process intra-area LSAs and install intra-area routes in the routing table.
D-Intra
Time in milliseconds for the SPF algorithm to delete invalid intra-area routes from the routing table.
Summ
Time in milliseconds for the SPF algorithm to process interarea LSAs and install interarea routes in the routing table.
D-Summ
Time in milliseconds for the SPF algorithm to delete invalid interarea routes from the routing table.
Ext
Time in milliseconds for the SPF algorithm to process external and not so stubby area (NSSA) LSAs and install external and NSSA routes in the routing table.
D-Ext
Time in milliseconds for the SPF algorithm to delete invalid external and NSSA routes from the routing table.
Total
Total duration time, in milliseconds, for the SPF algorithm process.
Reason
Record of reasons causing SPF to be executed:
N--A change in a network LSA (type 2) has occurred.
R--A change in a router LSA (type 1) has occurred.
SA--A change in a Summary autonomous system boundary router (ASBR) (SA) LSA has occurred.
SN--A change in a Summary Network (SN) LSA has occurred.
X--A change in an External Type-7 (X7) LSA has occurred.
The following is sample output from the
showipospfstatisticscommand with the
detail keyword entered to show the statistics separately for a specific area:
Router# show ip ospf statistics detail
SPF 7 executed 2d17h ago, SPF type Full
SPF calculation time (in msec):
SPT Intra D-Intr Summ D-Summ Ext7 D-Ext7 Total
0 0 0 0 0 0 0 0
LSIDs processed R:4 N:1 Stub:5 SN:17 SA:1 X7:0
Change record R,
LSIDs changed 1
Last 10 LSIDs:
2.0.0.202(R)
The table below describes the significant fields shown in the display.
Number of SPF algorithms executed in the OSPF area. The number increases by one for each SPF algorithm that is executed in the area.
Executed ago
Time in milliseconds that has passed between the start of the SPF algorithm execution and the current time.
SPF type
SPF type can be Full or Incremental.
SPT
Time in milliseconds requires to compute the first stage of the SPF algorithm (to build a short path tree). The SPT time plus the time required to process links to stub networks equals the Intra time.
Ext
Time in milliseconds for the SPF algorithm to process external and not so stubby area (NSSA) link-state advertisements (LSAs) and install external and NSSA routes in the routing table.
Total
Total duration time, in milliseconds, for the SPF algorithm process.
Note
Total time is the sum of previous times excluding the SPT time, which is already included in the Intra time.
LSIDs processed
Number of LSAs processed during the SPF calculation:
N--Network LSA.
R--Router LSA.
SA--Summary autonomous system boundary router (ASBR) (SA) LSA.
SN--Summary Network (SN) LSA.
Stub--Stub links.
X7--External Type-7 (X7) LSA.
LSIDs changed
Number of LSAs changed between this SPF calculation and the previous one. LSA changes force SPF to be scheduled.
Last 10 LSIDs
List of last ten Intra area LSAs that have changed between this SPF calculation and the previous one. LSID types:
R--Router LSA (type 1)
N--Network LSA (type 2)
show ip ospf summary-address
To display a list of all summary address redistribution information configured under an Open Shortest Path First (OSPF) process, use the
showipospfsummary-addresscommand in EXEC mode.
showipospf [process-id] summary-address
Syntax Description
process-id
(Optional) OSPF area ID.
Command Modes
EXEC
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
The
process-id argument can be entered as a decimal number or as an IP address format.
Examples
The following is sample output from the
showipospfsummary-address command:
Router# show ip ospf summary-address
OSPF Process 2, Summary-address
10.2.0.0/255.255.0.0 Metric -1, Type 0, Tag 0
10.2.0.0/255.255.0.0 Metric -1, Type 0, Tag 10
The table below describes the significant fields shown in the displays.
Table 21
showipospfrequest-listField Descriptions
Field
Description
10.2.0.0/255.255.0.0
IP address and mask of the router for the OSPF process.
Metric -1
OSPF metric type.
Type 0
Type of LSA.
Tag 0
OSPF process tag identifier.
show ip ospf virtual-links
To display parameters and the current state of Open Shortest Path First (OSPF) virtual links, use the
showipospfvirtual-links command in EXEC mode.
showipospfvirtual-links
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
The information displayed by the
showipospfvirtual-links command is useful in debugging OSPF routing operations.
Examples
The following is sample output from the
showipospfvirtual-links command:
Router# show ip ospf virtual-links
Virtual Link to router 192.168.101.2 is up
Transit area 0.0.0.1, via interface Ethernet0, Cost of using 10
Transmit Delay is 1 sec, State POINT_TO_POINT
Timer intervals configured, Hello 10, Dead 40, Wait 40, Retransmit 5
Hello due in 0:00:08
Adjacency State FULL
The table below describes the significant fields shown in the display.
Table 22
showipospfvirtual-links Field Descriptions
Field
Description
Virtual Link to router 192.168.101.2 is up
Specifies the OSPF neighbor, and if the link to that neighbor is up or down.
Transit area 0.0.0.1
The transit area through which the virtual link is formed.
via interface Ethernet0
The interface through which the virtual link is formed.
Cost of using 10
The cost of reaching the OSPF neighbor through the virtual link.
Transmit Delay is 1 sec
The transmit delay (in seconds) on the virtual link.
State POINT_TO_POINT
The state of the OSPF neighbor.
Timer intervals...
The various timer intervals configured for the link.
Hello due in 0:00:08
When the next hello is expected from the neighbor.
Adjacency State FULL
The adjacency state between the neighbors.
show ipv6 ospf
To display general information about Open Shortest Path First ( OSPF) routing processes, use the
showipv6ospf command in user EXEC or privileged EXEC mode.
showipv6ospf [process-id] [area-id] [rate-limit]
Syntax Description
process-id
(Optional) Internal identification. It is locally assigned and can be any positive integer. The number used here is the number assigned administratively when the OSPF routing process is enabled.
area-id
(Optional) Area ID. This argument displays information about a specified area only.
rate-limit
(Optional) Rate-limited link-state advertisements (LSAs). This keyword displays LSAs that are currently being rate limited, together with the remaining time to the next generation.
Command Modes
User EXEC
Privileged EXEC
Command History
Release
Modification
12.0(24)S
This command was introduced.
12.2(15)T
This command was integrated into Cisco IOS Release 12.2(15)T.
12.2(18)S
This command was integrated into Cisco IOS Release 12.2(18)S.
12.3(4)T
Command output is changed when authentication is enabled.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2(25)SG
This command was integrated into Cisco IOS Release 12.2(25)SG.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.4(9)T
Command output was updated to display OSPF for IPv6 encryption information.
12.4(15)XF
Command output was modified to include VMI PPPoE process-level values.
12.4(15)T
This command was integrated into Cisco IOS Release 12.4(15)T
12.2(33)SXH
This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SRC
The
rate-limit keyword was added. Command output was modified to include the configuration values for SPF and LSA throttling timers.
12.2(33)SB
This command was integrated into Cisco IOS Release 12.2(33)SB.
Cisco IOS XE Release 2.1
This command was integrated into Cisco IOS XE Release 2.1.
15.0(1)M
This command was integrated into Cisco IOS Release 12.5(1)M.
15.1(2)T
This command was modified. Support for IPv6 was added to Cisco IOS Release 15.1(2)T.
12.2(50)SY
This command was integrated into Cisco IOS Release 12.2(50)SY.
15.1(1)SG
This command was integrated into Cisco IOS Release 15.1(1)SG.
15.0(1)SY
This command was integrated into Cisco IOS Release 15.0(1)SY.
15.2(2)SNG
This command was implemented on the Cisco ASR 901 Series Aggregation Services devices.
Examples
Examples
The following is sample output from the
showipv6ospf command:
Device# show ipv6 ospf
Routing Process "ospfv3 1" with ID 10.10.10.1
SPF schedule delay 5 secs, Hold time between two SPFs 10 secs
Minimum LSA interval 5 secs. Minimum LSA arrival 1 secs
LSA group pacing timer 240 secs
Interface flood pacing timer 33 msecs
Retransmission pacing timer 66 msecs
Number of external LSA 0. Checksum Sum 0x000000
Number of areas in this device is 1. 1 normal 0 stub 0 nssa
Area BACKBONE(0)
Number of interfaces in this area is 1
MD5 Authentication, SPI 1000
SPF algorithm executed 2 times
Number of LSA 5. Checksum Sum 0x02A005
Number of DCbitless LSA 0
Number of indication LSA 0
Number of DoNotAge LSA 0
Flood list length 0
The table below describes the significant fields shown in the display.
Table 23 show ipv6 ospf Field Descriptions
Field
Description
Routing process "ospfv3 1" with ID 10.10.10.1
Process ID and OSPF device ID.
LSA group pacing timer
Configured LSA group pacing timer (in seconds).
Interface flood pacing timer
Configured LSA flood pacing timer (in milliseconds).
Retransmission pacing timer
Configured LSA retransmission pacing timer (in milliseconds).
Number of areas
Number of areas in device, area addresses, and so on.
Examples
The following sample output shows the
showipv6ospf command with area encryption information:
Device# show ipv6 ospf
Routing Process "ospfv3 1" with ID 10.0.0.1
It is an area border device
SPF schedule delay 5 secs, Hold time between two SPFs 10 secs
Minimum LSA interval 5 secs. Minimum LSA arrival 1 secs
LSA group pacing timer 240 secs
Interface flood pacing timer 33 msecs
Retransmission pacing timer 66 msecs
Number of external LSA 0. Checksum Sum 0x000000
Number of areas in this device is 2. 2 normal 0 stub 0 nssa
Reference bandwidth unit is 100 mbps
Area BACKBONE(0)
Number of interfaces in this area is 2
SPF algorithm executed 3 times
Number of LSA 31. Checksum Sum 0x107493
Number of DCbitless LSA 0
Number of indication LSA 0
Number of DoNotAge LSA 20
Flood list length 0
Area 1
Number of interfaces in this area is 2
NULL Encryption SHA-1 Auth, SPI 1001
SPF algorithm executed 7 times
Number of LSA 20. Checksum Sum 0x095E6A
Number of DCbitless LSA 0
Number of indication LSA 0
Number of DoNotAge LSA 0
Flood list length 0
The table below describes the significant fields shown in the display.
Table 24 show ipv6 ospf with Area Encryption Information Field Descriptions
Field
Description
Area 1
Subsequent fields describe area 1.
NULL Encryption SHA-1 Auth, SPI 1001
Displays the encryption algorithm (in this case, null, meaning no encryption algorithm is used), the authentication algorithm (SHA-1), and the security policy index (SPI) value (1001).
The following example displays the configuration values for SPF and LSA throttling timers:
Device# show ipv6 ospf
Routing Process "ospfv3 1" with ID 10.9.4.1
Event-log enabled, Maximum number of events: 1000, Mode: cyclic
It is an autonomous system boundary device
Redistributing External Routes from,
ospf 2
Initial SPF schedule delay 5000 msecs
Minimum hold time between two consecutive SPFs 10000 msecs
Maximum wait time between two consecutive SPFs 10000 msecs
Minimum LSA interval 5 secs
Minimum LSA arrival 1000 msecs
The table below describes the significant fields shown in the display.
Table 25 show ipv6 ospf with SPF and LSA Throttling Timer Field Descriptions
Field
Description
Initial SPF schedule delay
Delay time of SPF calculations.
Minimum hold time between two consecutive SPFs
Minimum hold time between consecutive SPF calculations.
Maximum wait time between two consecutive SPFs 10000 msecs
Maximum hold time between consecutive SPF calculations.
Minimum LSA interval 5 secs
Minimum time interval (in seconds) between link-state advertisements.
Minimum LSA arrival 1000 msecs
Maximum arrival time (in milliseconds) of link-state advertisements.
The following example shows information about LSAs that are currently being rate limited:
Device# show ipv6 ospf rate-limit
List of LSAs that are in rate limit Queue
LSAID: 0.0.0.0 Type: 0x2001 Adv Rtr: 10.55.55.55 Due in: 00:00:00.500
LSAID: 0.0.0.0 Type: 0x2009 Adv Rtr: 10.55.55.55 Due in: 00:00:00.500
The table below describes the significant fields shown in the display.
Table 26 show ipv6 ospf rate-limit Field Descriptions
Field
Description
LSAID
Link-state ID of the LSA.
Type
Description of the LSA.
Adv Rtr
ID of the advertising device.
Due in:
Remaining time until the generation of the next event.
summary-address (OSPF)
To create
aggregate addresses for
Open Shortest Path First (OSPF),
use the summary-address command in router configuration mode. To restore the default, use the no form of this command.
Summary address designated for a range of addresses.
mask
IP subnet mask used for the summary route.
prefix
IP route prefix for the destination.
not-advertise
(Optional) Suppresses routes that match the specified prefix/mask pair. This keyword applies to OSPF only.
tagtag
(Optional) Specifies the tag value that can be used as a “match” value for controlling redistribution via route maps. This keyword applies to OSPF only.
nssa-only
(Optional) Sets the nssa-only attribute for the summary route (if any) generated for the specified prefix, which limits the summary to not-so-stubby-area (NSSA) areas.
Command Default
This command behavior is disabled by default.
Command Modes
Router configuration
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
15.0(1)M
This command was modified. The nssa-only keyword was added.
Usage Guidelines
R
outes learned from other routing protocols can be summarized. The metric used to advertise the summary is the lowest metric of all the more specific routes. This command helps reduce the size of the routing table.
Using this command for OSPF causes an OSPF Autonomous System Boundary Router (ASBR) to advertise one external route as an aggregate for all redistributed routes that are covered by the address. For OSPF, this command summarizes only routes from other routing protocols that are being redistributed into OSPF. Use the arearange command for route summarization between OSPF areas.
OSPF does not support the summary-address0.0.0.00.0.0.0command.
Examples
In the following example, the summary address 10.1.0.0 includes address 10.1.1.0, 10.1.2.0, 10.1.3.0, and so on. Only the address 10.1.0.0 is advertised in an external link-state advertisement.
summary-address 10.1.0.0 255.255.0.0
Related Commands
Command
Description
arearange
Consolidates and summarizes routes at an area boundary.
ipospfauthentication-key
Assigns a password to be used by neighboring routers that are using the simple password authentication of OSPF.
ipospfmessage-digest-key
Enables OSPF MD5 authentication.
timers lsa arrival
To set the minimum interval at which the software accepts the same link-state advertisement (LSA) from Open Shortest Path First (OSPF) neighbors, use the
timerslsaarrivalcommand in router configuration mode. To restore the default value, use the
no form of this command.
timerslsaarrivalmilliseconds
notimerslsaarrival
Syntax Description
milliseconds
Minimum delay in milliseconds that must pass between acceptance of the same LSA arriving from neighbors. The range is from 0 to 600,000 milliseconds. The default is 1000 milliseconds.
Command Default
1000 milliseconds
Command Modes
OSPF for IPv6 router configuration (config-rtr) Router configuration (config-router)
Command History
Release
Modification
12.0(25)S
This command was introduced.
12.2(27)SBC
This command was integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
12.2(33)SRC
Support for IPv6 was added.
12.2(33)SB
Support for IPv6 was added.
Cisco IOS XE Release 2.1
This command was introduced on Cisco ASR 1000 Series Routers.
15.0(1)M
This command was integrated into Cisco IOS Release 12.5(1)M.
12.2(33)XNE
This command was modified. It was integrated into Cisco IOS Release 12.2(33)XNE.
Usage Guidelines
The
timerslsaarrival command controls the minimum interval for accepting the same LSA. The “same LSA” is defined as an LSA instance that contains the same LSA ID number, LSA type, and advertising router ID. If an instance of the same LSA arrives sooner than the interval that is set, the LSA is dropped.
We suggest you keep the
millisecondsvalue of the
timerslsaarrival command less than or equal to the neighbors’
hold-interval value of the
timersthrottlelsaall command.
Examples
The following example sets the minimum interval for accepting the same LSA at 2000 milliseconds:
router ospf 1
log-adjacency-changes
timers throttle lsa all 200 10000 45000
timers lsa arrival 2000
network 10.10.4.0 0.0.0.255 area 24
network 10.10.24.0 0.0.0.255 area 24
Related Commands
Command
Description
showipospftimersrate-limit
Displays all of the LSAs in the rate limit queue.
showipv6ospftimersrate-limit
Displays all of the LSAs in the IPv6 rate limit queue
timersthrottlelsa
Sets rate-limiting values for OSPF for IPv6 LSA generation.
timersthrottlelsaall
Sets rate-limiting values for LSAs being generated.
timers pacing flood
To configure link-state advertis ement (LSA) flood packet pacing, use the
timerspacingflood command in router configuration mode. To restore the default flood packet pacing value, use the
no form of this command.
timerspacingfloodmilliseconds
notimerspacingflood
Syntax Description
milliseconds
Time (in milliseconds) at which LSAs in the flooding queue are paced in between updates. The configurable range is from 5 milliseconds to 100 milliseconds. The default value is 33 milliseconds.
Command Default
33 milliseconds
Command Modes
Router configuration
Command History
Release
Modification
12.2(4)T
This command was introduced.
12.2(14)S
This command was integrated into Cisco IOS Release 12.2(14)S.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
Configuring Open Shortest Path First (OSPF) flood pacing timers allows you to control interpacket spacing between consecutive link-state update packets in the OSPF transmission queue. This command allows you to control the rate at which LSA updates occur so that high CPU or buffer utilization that can occur when an area is flooded with a very large number of LSAs can be reduced.
The default settings for OSPF packet pacing timers are suitable for the majority of OSPF deployments. Do not change the packet pacing timers unless all other options to meet OSPF packet flooding requirements have been exhausted. Specifically, network operators should prefer summarization, stub area usage, queue tuning, and buffer tuning before changing the default flood timers. Furthermore, there are no guidelines for changing timer values; each OSPF deployment is unique and should be considered on a case-by-case basis. The network operator assumes risks associated with changing the default flood timer values.
Examples
The following example configures LSA flood packet-pacing updates to occur in 55-millisecond intervals for Open Shortest Path First (OSPF) routing process 1:
Displays general information about OSPF routing processes.
timerspacinglsa-group
Changes the interval at which OSPF LSAs are collected into a group and refreshed, checksummed, or aged.
timerspacingretransmission
Configures LSA retransmission packet pacing.
timers pacing retransmission
To configure link-state adv ertisement (LSA) retransmission packet pacing, use the timers pacing retransmission command in router configuration mode. To restore the default retransmission packet pacing value, use the
no form of this command.
timerspacingretransmissionmilliseconds
notimerspacingretransmission
Syntax Description
milliseconds
The time (in milliseconds) at which LSAs in the retransmission queue are paced. The configurable range is from 5 milliseconds to 200 milliseconds. The default value is 66 milliseconds.
Command Default
66 milliseconds
Command Modes
Router configuration
Command History
Release
Modification
12.2(4)T
This command was introduced.
12.2(14)S
This command was integrated into Cisco IOS Release 12.2(14)S.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
Configuring Open Shortest Path First (OSPF) retransmission pacing timers allow you to control interpacket spacing between consecutive link-state update packets in the OSPF retransmission queue. This command allows you to control the rate at which LSA updates occur so that high CPU or buffer utilization that can occur when an area is flooded with a very large number of LSAs can be reduced. The default settings for OSPF packet retransmission pacing timers are suitable for the majority of OSPF deployments. Do not change the packet retransmission pacing timers unless all other options to meet OSPF packet flooding requirements have been exhausted. Specifically, network operators should prefer summarization, stub area usage, queue tuning, and buffer tuning before changing the default flooding timers. Furthermore, there are no guidelines for changing timer values; each OSPF deployment is unique and should be considered on a case-by-case basis. The network operator assumes risks associated with changing the default packet retransmission pacing timer values.
Examples
The following example configures LSA flood pacing updates to occur in 55-millisecond intervals for OSPF routing process 1:
Displays general information about OSPF routing processes.
timerspacingflood
Configures LSA flood packet pacing.
timerspacinglsa-group
Changes the interval at which OSPF LSAs are collected into a group and refreshed, checksummed, or aged.
timers throttle spf
To turn on Open Shortest Path First ( OSPF) shortest path first (SPF) throttling, use the
timersthrottlespf command in the appropriate configuration mode. To turn off OSPF SPF throttling, use the
no form of this command.
timersthrottlespfspf-startspf-holdspf-max-wait
notimersthrottlespfspf-startspf-holdspf-max-wait
Syntax Description
spf-start
Initial delay to schedule an SPF calculation after a change, in milliseconds. Range is from 1 to 600000. In OSPF for IPv6, the default value is 5000.
spf-hold
Minimum hold time between two consecutive SPF calculations, in milliseconds. Range is from 1 to 600000. In OSPF for IPv6, the default value is 10,000.
spf-max-wait
Maximum wait time between two consecutive SPF calculations, in milliseconds. Range is from 1 to 600000. In OSPF for IPv6, the default value is 10,000.
Command Default
SPF throttling is not set.
Command Modes
Address family configuration (config-router-af) Router address family topology configuration (config-router-af-topology) Router configuration (config-router) OSPF for IPv6 router configuration (config-rtr)
Command History
Release
Modification
12.2(14)S
This command was introduced. This command replaces the
timersspf-interval command.
12.0(23)S
This command was integrated into Cisco IOS Release 12.0(23)S.
12.2(15)T
This command was integrated into Cisco IOS Release 12.2(15)T.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SRB
This command was made available in router address family configuration mode.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
12.2(33)SRC
Support for IPv6 was added.
12.2(33)SB
Support for IPv6 was added and this command was integrated into Cisco IOS Release 12.2(33)SB.
Cisco IOS XE Release 2.1
This command was introduced on Cisco ASR 1000 Series Routers.
15.0(1)M
This command was integrated into Cisco IOS Release 12.5(1)M.
12.2(33)XNE
This command was modified. It was integrated into Cisco IOS Release 12.2(33)XNE.
15.1(1)SY
This command was integrated into Cisco IOS Release 15.1(1)SY.
Usage Guidelines
The first wait interval between SPF calculations is the amount of time in milliseconds specified by the
spf-startargument. Each consecutive wait interval is two times the current hold level in milliseconds until the wait time reaches the maximum time in milliseconds as specified by the
spf-max-wait argument. Subsequent wait times remain at the maximum until the values are reset or a link-state advertisement (LSA) is received between SPF calculations.
Release 12.2(33)SRB
If you plan to configure the Multi-Topology Routing (MTR) feature, you need to enter the
timersthrottlespf command in router address family topology configuration mode in order to make this OSPF router configuration command become topology-aware.
Release 15.2(1)T
When you configure the
ospfv3networkmanet command on any interface attached to the OSPFv3 process, the default values for the
spf-start,
spf-hold, and the
spf-max-wait arguments are reduced to 1000 milliseconds, 1000 milliseconds, and 2000 milliseconds respectively.
Examples
The following example shows how to configure a router with the delay, hold, and maximum interval values for the
timersthrottlespf command set at 5, 1000, and 90,000 milliseconds, respectively.
The following example shows how to configure a router using IPv6 with the delay, hold, and maximum interval values for the
timersthrottlespf command set at 500, 1000, and 10,000 milliseconds, respectively.