The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This module describes the commands used to establish static routes.
For detailed information about static routing concepts, configuration tasks, and examples, see the Implementing Static Routes on Cisco IOS XR Software module in the Cisco IOS XR Routing Configuration Guide for the Cisco XR 12000 Series Router.
To enter various address family configuration modes while configuring static routes, use the address-family command in the appropriate configuration mode. To disable support for an address family, use the no form of this command.
address-family { ipv4 | ipv6 } { unicast | multicast }
no address-family { ipv4 | ipv6 } { unicast | multicast }
ipv4 |
Specifies IP Version 4 address prefixes. |
ipv6 |
Specifies IP Version 6 address prefixes. This option is available only in static router configuration mode. |
unicast |
Specifies unicast address prefixes. |
multicast |
Specifies multicast address prefixes. This option is available only in static router configuration mode. |
All static routes belong to the default VRF if you enter address family configuration mode without entering VRF configuration mode.
Router static configuration
VRF router static configuration
Release |
Modification |
---|---|
Release 3.3.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Use the address-family command to enter various address family configuration modes while configuring static routing sessions. From address family configuration mode, you can configure static routes using the route command.
Task ID |
Operations |
---|---|
static |
read, write |
The following example shows how to enter IPv6 unicast address family mode:
RP/0/0/CPU0:router(config)# router static RP/0/0/CPU0:router(config-static)# address-family ipv6 unicast RP/0/0/CPU0:router(config-static-afi)#
Command |
Description |
---|---|
Establishes a static route. |
To change the maximum number of allowable static routes, use the maximum path command in static router configuration mode. To remove the maximum path command from the configuration file and restore the system to its default condition, use the no form of this command.
maximum path { ipv4 | ipv6 } value
no maximum path { ipv4 | ipv6 } value
ipv4 | ipv6 |
Specifies IP Version 4 (IPv4) or IP Version 6 (IPv6) address prefixes. |
value |
Maximum number of static routes for the given AFI. The range is 1 to 140000. |
value : 4000
Static router configuration
Release |
Modification |
---|---|
Release 3.3.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
If you use the maximum path command to reduce the configured maximum allowed number of static routes for a given table below the number of static routes currently configured, the change is rejected. In addition, if you commit a batch of routes that would, when grouped, push the number of static routes configured above the maximum allowed, the first n routes in the batch and the number previously configured are accepted, and the remainder rejected. The n argument is the difference between the maximum number allowed and the number previously configured.
Task ID |
Operations |
---|---|
static |
read, write |
The following example shows how to set the maximum number of static IPv4 routes to 100000:
RP/0/0/CPU0:router(config-static)# maximum path ipv4 100000
The following example shows how to remove the preceding configuration and set the maximum number of static IPv4 routes back to the default:
RP/0/0/CPU0:router(config-static)# no maximum path ipv4 100000
Command |
Description |
---|---|
Enters static router configuration mode. |
|
show route static |
Displays the static routes in a routing table. |
To establish static routes, use the route command in address family configuration mode. To remove the route command from the configuration, use the no form of this command.
prefix /mask [ vrf vrf-name ] { ip-address | type interface-path-id [ ip-address | type interface-path-id ] [ track track-object-name ] [ tunnel-id tunnel-id ] [ vrflabel vrf-label ] [distance] [ description text ] [ tag tag ] [permanent] }
no prefix /mask [ vrf vrf-name ] { ip-address | type interface-path-id [ ip-address | type interface-path-id ] [ track track-object-name ] [ tunnel-id tunnel-id ] [ vrflabel vrf-label ] [distance] [ description text ] [ tag tag ] [permanent] }
No static route is established.
vrf vrf-name : If no VRF is specified, the vrf where the configuration takes place is used.
Address family configuration
Release |
Modification |
---|---|
Release 3.2 |
This command was introduced. The { unicast | multicast } keywords were changed from optional to mandatory. The { ip-address | type interface-path-id } arguments became mandatory. |
Release 3.3.0 |
This command was moved from global configuration mode to router static configuration mode. The vrf vrf-name keyword and argument was added. The following keywords were removed: |
Release 3.5.0 |
The description text keyword and argument were added. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
A static route is appropriate when the software cannot dynamically build a route to the destination.
Static routes have a default administrative distance of 1, in which a low number indicates a preferred route. By default, static routes are preferred to routes learned by routing protocols. You can configure an administrative distance with a static route if you want the static route to be overridden by dynamic routes. For example, you could have routes installed by the Open Shortest Path First (OSPF) protocol with an administrative distance of 120. To have a static route that would be overridden by an OSPF dynamic route, specify an administrative distance greater than 120.
The routing table considers the static routes that point to an interface as “directly connected.” Directly connected networks are advertised by IGP routing protocols if a corresponding interface command is contained under the router configuration stanza of that protocol.
A static route is always associated with a VPN routing and forwarding (VRF) instance. The VRF can be the default VRF or a specified VRF. Specifying a VRF allows you to enter VRF configuration mode where you can configure a static route. If you do not specify a VRF you can configure a default VRF static route.
Use the router static command to configure static routes. To configure a static route, you must enter router static configuration mode and then enter an address family configuration mode or VRF configuration mode. See the vrf (static) command for information on configuring a static route in VRF configuration mode. After you enter an address family mode, you can enter multiple static routes. The following example shows how to configure multiple static routes in IPv4 and IPv6 address family configuration modes:
Note | You cannot create a VRF named default, but you can reference the default VRF. |
Task ID |
Operations |
---|---|
static |
read, write |
The following example shows how to configure IPv6 unicast address family static routes:
RP/0/0/CPU0:router(config)# router static RP/0/0/CPU0:router(config-static)# address-family ipv6 unicast RP/0/0/CPU0:router(config-static-afi)# 2b11::327a:7b00/120 GigabitEthernet0/2/0/7 RP/0/0/CPU0:router(config-static-afi)# 2b11::327a:7b00/120 GigabitEthernet0/6/0/0 RP/0/0/CPU0:router(config-static-afi)# 2b11::327a:7b00/120 2b11::2f01:4c RP/0/0/CPU0:router(config-static-afi)# 2b11::327a:7b00/120 2b11::2f01:4d RP/0/0/CPU0:router(config-static-afi)# 2b11::327a:7b00/120 2b11::2f01:4e RP/0/0/CPU0:router(config-static-afi)# 2b11::327a:7b00/120 2b11::2f01:4f RP/0/0/CPU0:router(config-static-afi)# 2b11::327a:7b00/120 2b11::2f01:50
Command |
Description |
---|---|
Enters address family configuration mode. |
|
network (BGP) |
Specifies a list of networks for the BGP routing process. |
show route |
Displays the current contents of the routing table. |
show route static |
Displays the static routes in a routing table. |
show route summary |
Displays the current contents of the routing table in summary format. |
Enters router static configuration mode. |
|
vrf (static) |
Enters VRF static route configuration mode. |
To enter static router configuration mode, use the router static command in global configurationmode. To remove all static route configurations and terminate the static routing process, use the no form of this command.
router static
no router static
No static routing process is enabled.
Release |
Modification |
---|---|
Release 3.3.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID |
Operations |
---|---|
static |
read, write |
bgp, ospf, hsrp, isis, vrrp, multicast, or network |
read, write |
The following example shows how to enter static router configuration mode:
RP/0/0/CPU0:router(config)# router static RP/0/0/CPU0:router(config-static)#
Command |
Description |
---|---|
Enters address family configuration mode. |
|
show route |
Displays the current contents of the routing table. |
show route static |
Displays the static routes in a routing table. |
show route summary |
Displays the current contents of the routing table in summary format. |
Establishes a static route. |
|
vrf (static) |
Enters VRF static route configuration mode. |
To configure a VPN routing and forwarding (VRF) instance and enter VRF configuration mode, use the vrf command in router configuration mode. To remove the VRF instance from the configuration file and restore the system to its default condition, use the no form of this command.
vrf vrf-name
no vrf vrf-name
vrf-name |
Name of the VRF instance. The following names cannot be used: all, default, and global. |
No default behavior or values
Static router configuration
Release |
Modification |
---|---|
Release 3.3.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Use the vrf command to configure a VRF instance. A VRF instance is a collection of VPN routing and forwarding tables maintained at the provider edge (PE) router.
router static vrf vrf_A address ipv4 unicast 172.168.40.0/24 loopback 1 172.168.50.0/24 vrf vrf_B 192.168.1.2Routes 172.168.40.0/24 and 172.168.50.0/24 belong to vrf_A. Route 172.168.50.0/24 is not installed in vrf_A until next-hop 192.168.1.2 (a vrf_B route) is reachable.
If you are configuring a default VRF route, you do not need to enter VRF configuration mode. For example, routes 192.168.1.0/24 and 192.168.2.0/24 are configured as follows:
router static address ipv4 unicast 192.168.1.0/24 loopback 5 192.168.2.0/24 10.1.1.1
Routes 192.168.1.0/24 and 192.168.2.0/24 are default VRF routes.
Note | You cannot create a VRF named default, but you can reference the default VRF. |
You must remove IPv4/IPv6 addresses from an interface prior to assigning, removing, or changing a VRF on an IP interface. If this is not done in advance, any attempt to change the VRF on an IP interface is rejected.
Task ID |
Operations |
---|---|
static |
read, write |
The following example shows how to configure a VRF instance and enter VRF configuration mode:
RP/0/0/CPU0:router(config)# router static RP/0/0/CPU0:router(config-static)# vrf vrf-1 RP/0/0/CPU0:router(config-static-vrf)#
Command |
Description |
---|---|
Enters address family configuration mode and allows you to configure a static route. |