-
Cisco IOS XR Routing Command Reference, Release 3.6
-
Preface
-
BGP Commands on Cisco IOS XR Software
-
EIGRP Commands on Cisco IOS XR Software
-
IS-IS Commands on Cisco IOS XR Software
-
OSPF Commands on Cisco IOS XR Software
-
OSPFv3 Commands on Cisco IOS XR Software
-
RIB Commands on Cisco IOS XR Software
-
RIP Commands on Cisco IOS XR Software
-
Routing Policy Commands on Cisco IOS XR Software
-
Static Routing Commands on Cisco IOS XR Software
-
Index
-
Table Of Contents
OSPFv3 Commands on Cisco IOS XR Software
database-filter all out (OSPFv3)
default-information originate (OSPFv3)
distribute-list prefix-list in
distribute-list prefix-list out
log adjacency changes (OSPFv3)
maximum redistributed-prefixes (OSPFv3)
show ospfv3 retransmission-list
timers throttle lsa all (OSPFv3)
OSPFv3 Commands on Cisco IOS XR Software
This chapter describes the commands used to configure and monitor the IP Version 6 (IPv6) Open Shortest Path First Version 3 (OSPFv3) routing protocol.
For detailed information about OSPFv3 concepts, configuration tasks, and examples, refer to the Implementing OSPF on Cisco IOS XR Software configuration guide.
address-family (OSPFv3)
To enter address family configuration mode for Open Shortest Path First Version 3 (OSPFv3), use the address-family command in the router ospv3 configuration mode. To disable address family configuration mode, use the no form of this command.
address-family ipv6 [unicast]
no address-family ipv6 [unicast]
Syntax Description
ipv6
Specifies IP Version 6 (IPv6) address prefixes.
unicast
(Optional) Specifies unicast address prefixes.
Defaults
An address family is not specified.
Command Modes
Router ospfv3 configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
At present, OSPFv3 provides routing services only for IPv6 unicast topologies, so this command has no effect.
Task ID
Examples
The following example shows how to configure the OSPFv3 router process with IPv6 unicast address prefixes:
RP/0/RP0/CPU0:router(config)# router ospfv3 1RP/0/RP0/CPU0:router(config-ospfv3)# address-family ipv6 unicastarea (OSPFv3)
To configure an Open Shortest Path First Version 3 (OSPFv3) area, use the area command in router ospfv3 configuration mode. To remove an OSPFv3 area, use the no form of this command.
area area-id
no area area-id
Syntax Description
area-id
Identifier of an OSPFv3 area. The area-id argument can be specified as either a decimal value or as an IPv4 address.
Defaults
No OSPFv3 areas are defined.
Command Modes
Router ospfv3 configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
An area must be explicitly configured with the area command.
Use the area command to place the router in area configuration mode (prompt: config-router-ar), from which you can configure area-specific settings. Commands configured under this mode (such as the interface command) are automatically bound to that area.
Note
To remove the specified OSPFv3 area from the router ospfv3 configuration, use the no area area-id command. The no area area-id command removes the OSPFv3 area including all OSPFv3 area options, and all the OSPFv3 interfaces and interface options that are configured under the area.
Task ID
Examples
The following example shows how to configure area 0 for OSPFv3 process 1. The Packet-over-SONET/SDH (POS) 0/1/0/1 interface also is configured:
RP/0/RP0/CPU0:router(config)# router ospfv3 1RP/0/RP0/CPU0:router(config-ospfv3)# area 0RP/0/RP0/CPU0:router(config-ospfv3-ar)# interface POS 0/1/0/1authentication (OSPFv3)
To enable plain text, Message Digest 5 (MD5) authentication, or null authentication for an Open Shortest Path First Version 3 (OSPFv3) interface, use the authentication command in the appropriate mode. To remove such authentication, use the no form of this command.
authentication {ipsec spi spi-value {md5 | sha1} [clear | password] password | disable}
no authentication
Syntax Description
Defaults
If this command is not specified in interface configuration mode, then the interface adopts the authentication parameter specified by the area.
If this command is not specified in area configuration mode, then the interface adopts the authentication parameter specified for the process.
If this command is not specified at any level, then the interface does not use authentication.Command Modes
Interface configuration
Area configuration
Router configuration
Virtual-link configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the authentication command to specify an authentication type for the interface, which overrides the authentication specified for the area to which this interface belongs. If this command is not included in the configuration file, the authentication configured in the area to which the interface belongs is assumed (as specified by the area authentication command).
The authentication type and password must be the same for all OSPFv3 interfaces that are to communicate with each other through OSPFv3.
Task ID
Examples
The following example shows how to enable MD5 authentication:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# router ospfv3 201RP/0/RP0/CPU0:router(config-ospfv3)# router-id 10.1.1.1RP/0/RP0/CPU0:router(config-ospfv3)# authentication ipsec spi 500 md5 1234567890abcdef1234567890abcdefauto-cost (OSPFv3)
To control how the Open Shortest Path First Version 3 (OSPFv3) protocol calculates default metrics for an interface, use the auto-cost command in router ospfv3 configuration mode. To set link cost based only on the interface type, use the disable form of this command. To re-enable OSPFv3 metric calculation for an interface according to the bandwidth of the interface, use the no form of this command.
auto-cost [reference-bandwidth mbps | disable]
no auto-cost [reference-bandwidth mbps | disable]
Syntax Description
reference-bandwidth mbps
(Optional) Sets the rate in Mbps (bandwidth). Range is 1 to 4294967.
disable
(Optional) Sets the link cost based only on the interface type.
Defaults
mbps: 100 Mbps
Command Modes
Router ospfv3 configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs.. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
By default OSPFv3 calculates the OSPFv3 metric for an interface according to the bandwidth of the interface.
The no auto-cost disable form of this command reenables OSPFv3 metric calculation for an interface according to the bandwidth of the interface.
To set link cost based only on the interface type, use the disable keyword.
If you have multiple links with high bandwidth, you might want to use a larger number to differentiate the cost on those links.
Recommended usage of cost configuration for all OSPFv3 configured interfaces is to be consistent: Either explicitly configure link costs (by using the cost command) or choose an appropriate default (by using the auto-cost command).
The value set by the cost command overrides the cost resulting from the auto-cost command.
Task ID
Examples
The following example shows how to set the reference value for the auto cost to 64:
RP/0/RP0/CPU0:router(config)# router ospfv3 1RP/0/RP0/CPU0:router(config-ospfv3)# auto-cost reference-bandwidth 64Related Commands
Explicitly specifies the cost of the interface (network) for OSPF path calculation.
clear ospfv3 process
To reset an Open Shortest Path First Version 3 (OSPFv3) router process without removing and reconfiguring it, use the clear ospfv3 process command in EXEC mode.
clear ospfv3 [process-name] process
Syntax Description
Defaults
No default behavior or value
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
When the OSPFv3 router process is reset, OSPFv3 releases all resources allocated, cleans up the internal database, uninstalls routes, and resets all OSPFv3 adjacencies.
Note
Task ID
Examples
The following example shows how to reset all OSPFv3 processes:
RP/0/RP0/CPU0:router# clear ospfv3 processThe following example shows how to reset the OSPFv3 process 1:
RP/0/RP0/CPU0:router# clear ospfv3 1 processRelated Commands
clear ospfv3 redistribution
To flush all the Type 5 and Type 7 link-state advertisements (LSAs) originated by an Open Shortest Path First Version 3 (OSPFv3) process, use the clear ospfv3 redistribution command in EXEC mode.
clear ospfv3 [process-name] redistribution
Syntax Description
Defaults
No default behavior or value
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the clear ospfv3 redistribution command to cause the routing table to be read again. OSPFv3 regenerates and sends Type 5 and Type 7 link-state advertisements (LSAs) to its neighbors. If an unexpected route has appeared in the OSPFv3 redistribution, using this command corrects the issue.
Note
Task ID
Examples
The following example shows how to clear all OSPFv3 redistributed routes from other protocols:
RP/0/RP0/CPU0:router# clear ospfv3 redistributionclear ospfv3 routes
To clear the Open Shortest Path First Version 3 (OSPFv3) internal route table, use the clear ospfv3 routes command in EXEC mode.
clear ospfv3 [process-name] routes
Syntax Description
Defaults
No default behavior or value
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the clear ospfv3 routes command to force the internal route table to be repopulated by causing recalculation of the shortest path first (SPF) routing table. When the OSPFv3 routing table is cleared, OSPFv3 routes in the global routing table are also recalculated.
Task ID
Examples
The following example shows how to clear all OSPFv3 routes from the OSPFv3 routing table and recomputes valid routes:
RP/0/RP0/CPU0:router# clear ospfv3 routesclear ospfv3 statistics
To clear the Open Shortest Path First Version 3 (OSPFv3) statistical counters, use the clear ospfv3 statistics command in EXEC mode.
clear ospfv3 [process-name] statistics [neighbor [interface-type interface-instance] [router-id]]
Syntax Description
Defaults
No default behavior or value
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the clear ospfv3 statistics command to reset statistics so that subsequent changes are easily observed.
Task ID
Examples
The following example shows how to clear the OSPFv3 statistical counters of all neighbors on Packet-over-SONET/SDH (POS) interface 0/2/0/0:
RP/0/RP0/CPU0:router# clear ospfv3 statistics neighbor POS 0/2/0/0cost (OSPFv3)
To explicitly specify the cost of the interface (network) for OSPF path calculations, use the cost command in the appropriate mode. To remove the cost, use the no form of this command.
cost cost
no cost
Syntax Description
Defaults
If this command is not specified in interface configuration mode, then the interface adopts the cost parameter specified by the area.
If this command is not specified in area configuration mode, then the interface adopts the cost parameter specified for the process.
If this command is not specified at any level, then the cost is based on the interface bandwidth, as specified by the auto-cost command.Command Modes
Interface configuration
Area configuration
Router ospfv3 configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The link-state metric is advertised as the link cost in the router link advertisement.
In general, the path cost is calculated using the following formula:
10^8 / bandwidth
Using this formula, the default path cost is 1 for OC-3 Packet-over-SONET/SDH (POS). If this value does not suit your network, you can use your own method of calculating path costs.
The value set by the cost command overrides the cost resulting from the auto-cost command.
Task ID
Examples
The following example shows how to set the cost value to 65 for Packet-over-SONET/SDH (POS) interface 0/1/0/1:
RP/0/RP0/CPU0:router(config)# router ospfv3 201RP/0/RP0/CPU0:router(config-ospfv3)# area 0RP/0/RP0/CPU0:router(config-ospfv3-ar)# interface POS 0/1/0/1RP/0/RP0/CPU0:router(config-ospfv3-ar-if)# cost 65Related Commands
database-filter all out (OSPFv3)
To filter outgoing link-state advertisements (LSAs) to an Open Shortest Path First Version 3 (OSPFv3) interface, use the database-filter command in the appropriate mode. To restore the forwarding of LSAs to the interface, use the no form of this command.
database-filter all out
no database-filter all out
Syntax Description
This command has no arguments or keywords.
Defaults
If this command is not specified in interface configuration mode, then the interface adopts the database filter parameter specified for the area.
If this command is not specified in area configuration mode, then the interface adopts the database filter parameter specified for the process.
If this command is not specified in router ospfv3 configuration mode, then the database filter is disabled and all outgoing LSAs are flooded to the interface.Command Modes
Interface configuration
Area configuration
Router ospfv3 configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the database-filter all out command to perform the same function that the neighbor command (with the database-filter keyword) performs on a neighbor basis.
Task ID
Examples
The following example shows how to prevent flooding of OSPFv3 LSAs to neighbors reachable through Packet-over-SONET/SDH (POS) interface 0/2/0/3:
RP/0/RP0/CPU0:router(config)# router ospfv3 1RP/0/RP0/CPU0:router(config-ospfv3)# area 0RP/0/RP0/CPU0:router(config-ospfv3-ar)# interface POS 0/2/0/3RP/0/RP0/CPU0:router(config-ospfv3-ar-if)# database-filter all outRelated Commands
dead-interval (OSPFv3)
To set the interval after which a neighbor is declared dead when no hello packets are observed, use the dead-interval command in the appropriate mode. To return to the default time, use the no form of this command.
dead-interval seconds
no dead-interval
Syntax Description
seconds
Unsigned integer that specifies the interval (in seconds). The value must be the same for all nodes on the same network link. Range is 1 to 65535.
Defaults
If this command is not specified in interface configuration mode, then the interface adopts the dead interval parameter specified for the area.
If this command is not specified in area configuration mode, then the interface adopts the dead interval parameter specified for the process.
If this command is not specified in router ospfv3 configuration mode, then the dead interval is four times the interval set by the hello-interval (OSPFv3) command.Command Modes
Interface configuration
Area configuration
Router ospfv3 configuration
Virtual-link configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Two Open Shortest Path First Version 3 (OSPFv3) routers do not become adjacent if their dead interval values differ.
If the hello interval is configured, the dead interval value must be larger than the hello interval value. The dead interval value is usually configured four times larger than the hello interval value.
Task ID
Examples
The following example shows how to set the OSPFv3 dead interval on Packet-over-SONET/SDH (POS) interface 0/2/0/3 to 40 seconds:
RP/0/RP0/CPU0:router(config)# router ospfv3 1RP/0/RP0/CPU0:router(config-ospfv3)# area 0RP/0/RP0/CPU0:router(config-ospfv3-ar)# interface POS 0/2/0/3RP/0/RP0/CPU0:router(config-ospfv3-ar-if)# dead-interval 40Related Commands
Specifies the interval between hello packets that the Cisco IOS XR software sends on the interface.
default-cost (OSPFv3)
To specify a cost for the default summary route sent into a stub area or not-so-stubby area (NSSA) for Open Shortest Path First Version 3 (OSPFv3) packets, use the default-cost command in area configuration mode. To remove the assigned default route cost, use the no form of this command.
default-cost cost
no default-cost cost
Syntax Description
cost
Cost for the default summary route used for a stub or NSSA area. The acceptable value is a 24-bit number.
Defaults
cost: 1
Command Modes
Area configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the default-cost command only on an Area Border Router (ABR) attached to a stub or an NSSA area.
In all routers and access servers attached to the stub area, the area should be configured as a stub area using the stub (OSPFv3) command in the area configuration submode. Use the default-cost command only on an ABR attached to the stub area. The default-cost command provides the metric for the summary default route generated by the ABR into the stub area.
Task ID
Examples
The following example shows how to assign a cost of 20 to the default route sent into area 10.15.0.0:
RP/0/RP0/CPU0:router(config)# router ospfv3 201RP/0/RP0/CPU0:router(config-ospfv3)# area 10.15.0.0RP/0/RP0/CPU0:router(config-ospfv3-ar)# stubRP/0/RP0/CPU0:router(config-ospfv3-ar)# default-cost 20RP/0/RP0/CPU0:router(config-ospfv3-ar)# interface pos0/3/0/1Related Commands
default-information originate (OSPFv3)
To generate a default external route into an Open Shortest Path First Version 3 (OSPFv3) routing domain, use the default-information originate command in router ospfv3 configuration mode. To disable this feature, use the no form of this command.
default-information originate [route-policy policy-name] [always] [metric metric-value] [metric-type type-value] [tag tag-value]
no default-information originate [route-policy policy-name] [always] [metric metric-value] [metric-type type-value] [tag tag-value]
Syntax Description
Defaults
A default external route into an OSPFv3 routing domain is not generated.
metric-value: 10
type-value: Type 2Command Modes
Router ospfv3 configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Whenever you use the redistribute or default-information command to redistribute routes into an OSPFv3 routing domain, the software automatically becomes an ASBR. However, an ASBR does not, by default, generate a default route into the OSPFv3 routing domain. The software still must have a default route for itself before it generates one, except when you have specified the always keyword.
When you use the default-information originate command for the OSPFv3 process, the default network must reside in the routing table.
Task ID
Examples
The following example shows how to specify a metric of 100 for the default route redistributed into the OSPFv3 routing domain and an external metric type of Type 1:
RP/0/RP0/CPU0:router(config)# router ospfv3 109RP/0/RP0/CPU0:router(config-ospfv3)# default-information originate metric 100 metric-type 1Related Commands
default-metric (OSPFv3)
To set default metric values for routes redistributed from another protocol into Open Shortest Path First Version 3 (OSPFv3), use the default-metric command in router ospfv3 configuration mode. To return to the default state, use the no form of this command.
default-metric value
no default-metric value
Syntax Description
Defaults
Built-in, automatic metric translations, as appropriate for each routing protocol
Command Modes
Router ospfv3 configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the default-metric command with the redistribute 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, use a default metric to provide a reasonable substitute and enable the redistribution to proceed.
Task ID
Examples
The following example shows how to configure a router with both the Intermediate System-to-Intermediate System (IS-IS) and the OSPFv3 routing protocols. The OSPFv3 routing protocol advertises IS-IS derived routes and assigns the routes a metric of 10:
RP/0/RP0/CPU0:router(config)# router ospfv3 1RP/0/RP0/CPU0:router(config-ospfv3)# default-metric 10RP/0/RP0/CPU0:router(config-ospfv3)# redistribute isis 109Related Commands
demand-circuit (OSPFv3)
To configure the Open Shortest Path First Version 3 (OSPFv3) router process to treat the interface as an OSPFv3 demand circuit, use the demand-circuit command in the appropriate mode. To remove the demand circuit designation from the interface, use the no form of this command.
demand-circuit [disable]
no demand-circuit
Syntax Description
disable
(Optional) Disables the demand circuit configuration that may have been specified at a higher level in the configuration.
Defaults
If this command is not specified in interface configuration mode, then the interface adopts the demand circuit parameter specified for the area.
If this command is not specified in area configuration mode, then the interface adopts the demand circuit parameter specified for the process.
If this command is not specified at any level, then the interface is not a demand circuit.Command Modes
Interface configuration
Area configuration
Router ospfv3 configuration
Virtual-link configurationCommand History
