Use the TCPIP ROUTE command with the ADD option to manually configure static routes (routes that are not dynamically discovered) between an intermediate system and remote destination hosts, subnets, networks, and supernets. This command enables you to add routes for specific remote destinations or as default paths to all remote destinations.
The ROUTE command requires the intermediate system and the remote destination to use the same networking protocol, either IPv4 or IPv6. That is, IPv4 hosts can communicate only with other IPv4 hosts and IPv6 hosts can communicate only with other IPv6 hosts. You cannot use mixed mode IPv4/IPv6 addressing with this command.
You can configure "specific" routes by supplying both the destination IP address and a next-hop IP address as the required attributes. The optional MASK attribute is supported only for IPv4 networks and can be specified to configure classless VLSM and CIDR routes to remote subnets, networks, or supernets. The network-prefix length attribute can be specified for IPv4 and IPv6 networks to configure classless VLSM and CIDR routes. Specify the optional PREFERENCE attribute, supported by IPv4 and IPv6 networking, to configure alternate backup routes, or parallel routes, to a common destination. If parallel routes are configured, outgoing dialogs are balanced.
Enter the TCP/IP ROUTE command in one of the following formats:
Supported for IPv4 Only:
NW TCPIP ROUTE ADD <ip address 1> MASK <ip address 2> VIA <ip address 3>[PREF]<preference>
Supported for IPv4 and IPv6:
NW TCPIP ROUTE ADD <ip address 1>/<network-prefix length>VIA <ip address 3>[PREF]<preference>
NW TCPIP ROUTE ADD <ip address 1> VIA <ip address 3>[PREF] <preference>
Variables
The variables are described as follows.
|
Variable |
Description |
|---|---|
|
<ip address 1> |
The IP address of the destination host/subnet/network/supernet that you want the intermediate system to route IP traffic to. |
|
<ip address 2> |
(Optional; IPv4 only) Provides the mask associated with the remote subnet, network, or supernet. |
|
<network-prefix length> |
(Optional) The length of the classless network-prefix that when applied to the ip address yields the destination subnet/network/supernet. |
|
<ip address 3> |
The IP address of the next-hop router along the path to the destination. |
|
<preference> |
(Optional) Used to configure alternate and/or parallel backup routes to the destination. When specifying alternate, backup routes, the preference identifies the backup order that will be used when a lower preference next-hop fails. A preference value can range from 1 to 255. A value of 1, the default when a preference attribute is not specified, identifies the primary next-hop router. Multiple routes of the same preference, to the same destination, can be configured as parallel routes for dialog load‑balancing purposes. |
IPv4 Examples
Add a route to destination host 192.39.50.2.
NW TCPIP ROUTE ADD 192.39.50.2 VIA 192.39.10.3
Add a route to destination subnet 192.39.10.128/25.
NW TCPIP ROUTE ADD 192.39.10.128/25 VIA 192.39.10.3
or
NW TCPIP ROUTE ADD 192.39.10.128 MASK 255.255.255.128 VIA 192.39.10.3
Add a route to destination supernet 192.39.0.0 /16.
NW TCPIP ROUTE ADD 192.39.0.0/16 VIA 192.39.10.3
or
NW TCPIP ROUTE ADD 192.39.0.0 MASK 255.255.0.0 VIA 192.39.10.3
Add a route to destination network 192.39.50.0.
NW TCPIP ROUTE ADD 192.39.50.0 VIA 192.39.10.3
or
NW TCPIP ROUTE ADD 192.39.50.0/24 VIA 192.39.10.3
or
NW TCPIP ROUTE ADD 192.39.50.0 MASK 255.255.255.0 VIA 192.39.10.3
Add two parallel routes to destination host 192.39.50.2 that load-balances dialogs to this destination.
NW TCPIP ROUTE ADD 192.39.50.2 VIA 192.39.10.3
NW TCPIP ROUTE ADD 192.39.50.2 VIA 192.39.10.4
or
NW TCPIP ROUTE ADD 192.39.50.2 VIA 192.39.10.3 PREFERENCE 1
NW TCPIP ROUTE ADD 192.39.50.2 VIA 192.39.10.4 PREFERENCE 1
Add two routes to destination 192.39.50.2 where the first router is the primary router and the second router is an alternate, backup router to be used in case the primary router fails.
NW TCPIP ROUTE ADD 192.39.50.2 VIA 192.39.10.3 PREFERENCE 1
NW TCPIP ROUTE ADD 192.39.50.2 VIA 192.39.10.4 PREFERENCE 2
Add two routes to destination 192.39.50.2 where the first router is the primary router and the second router is an alternate, backup router in another locally attached prefix. The backup router is to be used in case the primary router fails.
NW TCPIP ROUTE ADD 192.39.50.2 VIA 192.39.10.3 PREFERENCE 1
NW TCPIP ROUTE ADD 192.39.50.2 VIA 192.39.20.2 PREFERENCE 2
IPv6 Examples
Add a host-specific backup router.
NW TCPIP ROUTE ADD 090F:0:0:0:9F:FF:89:98 VIA 090F:0:0:0:9F:FF:89:99 PREF 2
Add a route to the destination network.
NW TCPIP ROUTE ADD 090F:0:0:0:9F:FF:: VIA 090F:0:0:0:9F:FF:89:99 PREF 2
