Adds a static route to the routing table.
ipNetmask | Specifies an IP address/mask length. |
ip_addr | Specifies an IP address. |
mask | Specifies a subnet mask. |
gateway | Specifies a VLAN (Virtual LAN) gateway. |
metric | Specifies a cost metric. |
vrname | Specifies the virtual router to which the route is added. |
multicast | Adds the specified route to the multicast routing table. |
multicast-only | Adds the specified route to the multicast routing table. This option is provided for backward compatibility with releases prior to ExtremeXOS 12.1. |
unicast | Adds the specified route to the unicast routing table. |
unicast-only | Adds the specified route to the unicast routing table. This option is provided for backward compatibility with releases prior to ExtremeXOS 12.1. |
If you do not specify a virtual router, the current virtual router context is used.
Use a mask value of 255.255.255.255 to indicate a host entry.
Note
Although dynamic unicast routes can be captured in the multicast routing table, unicast static routes cannot be captured in the multicast routing table. To create a static route for the multicast routing table, you must specify the multicast option.The following example adds a static address to the multicast routing table:
configure iproute add 10.1.1.0/24 123.45.67.1 5 multicast
This command was first available in ExtremeXOS 10.1.
The multicast and unicast keywords were first available in ExtremeXOS 12.1. These keywords replace multicast-only and unicast-only, which remain in the software for backward compatibility.
This command is available on platforms that support the appropriate license. For complete information about software licensing, including how to obtain and upgrade your license and which licenses support the IPv4 multicast feature, see the ExtremeXOS 22.6 Feature License Requirements document.