Dell Command Line Reference Guide for the S4048–ON System 9.14.2.5

PDF

ip route

Assign a static route to the switch.

Syntax
ip route [vrf vrf-name] ip-address mask {ip-address | interface [ip-address]} [distance] [name description] [permanent] [tag tag-value] [vrf vrf-name] [weight weight-value]

To delete a specific static route, use the no ip route destination mask command.

To delete all routes matching a certain route, use the no ip route destination mask command.

Parameters
vrf vrf-name
(Optoinal) Enter the keyword vrf and then the name of the VRF to configure a static route corresponding to that VRF. Use this VRF option after the ip route keyword to configure a static route on that particular VRF.
destination
Enter the IP address in dotted decimal format of the destination device.
mask
Enter the mask in the slash prefix format (/x) of the destination IP address.
ip-address
Enter the IP address of the forwarding router in dotted decimal format.
interface
Enter one of the following keyword followed by the interface information
  • For a 10-Gigabit Ethernet interface, enter the keyword TenGigabitEthernet then the slot/port[/subport] information.
  • For a 40-Gigabit Ethernet interface, enter the keyword fortyGigE then the slot/port information.
  • For a Loopback interface, enter the keyword loopback then a number from 0 to 16383.
  • For the Management interface on the stack-unit, enter the keyword ManagementEthernet then the slot/port information.
  • For a port channel interface, enter the keywords port-channel then a number.
  • For a Null interface, enter the keyword null then the Null interface number.
  • For a VLAN interface, enter the keyword vlan then a number from 1 to 4094.
  • For a tunnel interface, enter the keyword tunnel then the tunnel interface number. The range is from 1 to 16383.

If you configure a static IPv6 route using an egress interface and enter the ping command to reach the destination IPv6 address, the ping operation may not work. Configure the IPv6 route using a next-hop IPv6 address in order for the ping command to detect the destination address.

interface ip-address
Enter the keyword interface then the IP address.
distance
(OPTIONAL) Enter the value of the distance metric assigned to the route. The range is from 1 to 255.
name description
(OPTIONAL) Enter the keyword name and the description for the IPv4 static route configuration.
permanent
(OPTIONAL) Enter the keyword permanent to specify that the route must not be removed even if the interface assigned to that route goes down. The route must be currently active to be installed in the routing table. If you disable the interface, the route is removed from the routing table.
tag tag-value
(OPTIONAL) Enter the keyword tag then a number to assign to the route. The range is from 1 to 4294967295.
vrf vrf-name
Enter the keyword vrf followed by the name of the VRF. Use this VRF option after the next hop to specify which VRF the next hop belongs to. This setting is used in route leaking cases. See “R”oute Leaking VRFs” in the Virtual Routing and Forwarding (VRF) section of the Configuration guide.
weight weight-value
Enter the keyword weight followed by a weight value. The range is from 0 to 255.
NOTE: Weight for a static route can be added only for the destination address and not for the route pointing to destination a interface.
Defaults
Not configured.
Command Modes
CONFIGURATION
Command History

This guide is platform-specific. For command information about other platforms, see the relevant Dell EMC Networking OS Command Line Reference Guide.

Version
Description
9.14(1.2)
Added the keyword name for static routes.
9.10(0.1)
Introduced on the S6010-ON and S4048T-ON.
9.10(0.0)
Introduced on the S3148.
9.10(0.0)
Introduced on the S6100–ON.
9.8(2.0)
Introduced on the S3100 series.
9.8(1.0)
Introduced on the Z9100–ON.
9.8(0.0P5)
Introduced on the S4048-ON.
9.8(0.0P2)
Introduced on the S3048-ON.
9.7(0.0)
Introduced on the S6000-ON.
9.7(0.0)
Included the weighted parameter to support weighted ECMP feature.
9.4.(0.0)
Added support for VRF.
9.2(1.0)
Introduced on the Z9500.
9.0.2.0
Introduced on the S6000.
9.2.(0.0)
Added support for tunnel interface type.
8.3.19.0
Introduced on the S4820T.
8.3.11.1
Introduced on the Z9000.
8.5.1.0
Added support for 4-port 40G line cards on the E-Series.
8.3.7.0
Introduced on the S4810.
8.2.1.0
Added support for 4094 VLANs on the E-Series (the prior limit was 2094).
8.1.1.0
Introduced on the E-Series.
7.9.1.0
Introduced VRF on the E-Series.
7.6.1.0
Introduced on the S-Series.
7.5.1.0
Introduced on the C-Series.
pre-6.1.1.0
Introduced on the E-Series.
Usage Information
Using the following example of a static route: ip route 33.33.33.0 /24 tengigabitethernet 1/1 172.31.5.43
  • The software installs a next hop that is not on the directly connected subnet but which recursively resolves to a next hop on the interface’s configured subnet. In the example, if tengigabitethernet 1/1 has an ip address on subnet 2.2.2.0 and if 172.31.5.43 recursively resolves to 2.2.2.0, Dell EMC Networking OS installs the static route.
  • When the interface goes down, Dell EMC Networking OS withdraws the route.
  • When the interface comes up, Dell EMC Networking OS re-installs the route.
  • When recursive resolution is “broken,” Dell EMC Networking OS withdraws the route.
  • When recursive resolution is satisfied, Dell EMC Networking OS re-installs the route.

You can specify a weight for an IPv4 or IPv6 static route. If the weight value of a path is 0, then that path is not used for forwarding when weighted ECMP is in effect. Also, if a path corresponding to a static route (destination) has a non-zero weight assigned to it and other paths do not have any weight configured, then regular ECMP is used for forwarding.

You can specify the weight value only to destination address and not on the egress port.

A route is considered for weighted ECMP calculations only if each paths corresponding to that route is configured with a weight.

You cannot use the VRF attribute of this command to configure routes in a management VRF. When a specific VRF is deleted, all the configured static routes corresponding to that VRF are automatically removed.

Example
DellEMC(conf)# ip route 1.1.1.0/24 4.4.4.2 weight 100 
DellEMC(conf)# ip route 1.1.1.0/24 6.6.6.2 weight 200 
DellEMC(conf)# do show running-config | grep route ip route 1.1.1.0/24 4.4.4.2 weight 100 ip route 1.1.1.0/24 6.6.6.2 weight 200     
DellEMC(conf)# ip route  vrf test 1.1.1.0/24 4.4.4.2 weight 100 
DellEMC(conf)# ip route vrf test  1.1.1.0/24 6.6.6.2 weight 200 
DellEMC(conf)# 
DellEMC(conf)# do show running-config | grep route ip route vrf test  1.1.1.0/24 4.4.4.2 weight 100 ip route vrf test  1.1.1.0/24 6.6.6.2 weight 200
Related Commands

Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\