Command Manual – Static Routing (IP Routing Volume) Table of Contents

Table of Contents

Chapter 1 Static Routing Configuration Commands ................................................................. 1-1

1.1 Static Routing Configuration Commands .......................................................................... 1-1
1.1.1 delete static-routes all ............................................................................................. 1-1
1.1.2 ip route-static........................................................................................................... 1-2
1.1.3 ip route-static default-preference ............................................................................ 1-5

i
 Chapter 1 Static Routing
Command Manual – Static Routing (IP Routing Volume) Configuration Commands

Chapter 1 Static Routing Configuration

Commands

Note:
The term “router” in this document refers to a firewall in a generic sense.

1.1 Static Routing Configuration Commands

1.1.1 delete static-routes all

Syntax

delete [ vpn-instance vpn-instance-name ] static-routes all

View

System view

Default Level

2: System level

Parameters

vpn-instance-name: Name of a VPN instance, a string of 1 to 31 case-sensitive

characters.

Description

Use the delete static-routes all command to delete all static routes.
When you use this command to delete static routes, the system will prompt you to
confirm the operation before deleting all the static routes.
Related commands: display ip routing-table, ip route-static.

Examples

# Delete all static routes on the router.

<Sysname> system-view
[Sysname] delete static-routes all
This will erase all ipv4 static routes and their configurations, you must reconf

1-1
 Chapter 1 Static Routing
Command Manual – Static Routing (IP Routing Volume) Configuration Commands

igure all static routes

Are you sure?[Y/N]:Y

1.1.2 ip route-static

Syntax

ip route-static dest-address { mask | mask-length } { next-hop-address track

track-entry-number | interface-type interface-number next-hop-address | vpn-instance
d-vpn-instance-name next-hop-address track track-entry-number } [ preference
preference-value ] [ tag tag-value ] [ description description-text ]
undo ip route-static dest-address { mask | mask-length } [ next-hop-address |
interface-type interface-number [ next-hop-address ] | vpn-instance
d-vpn-instance-name next-hop-address ] [ preference preference-value ]
ip route-static vpn-instance s-vpn-instance-name&<1-6> dest-address { mask |
mask-length } { next-hop-address [ public ] [ track track-entry-number ] | interface-type
interface-number next-hop-address | vpn-instance d-vpn-instance-name
next-hop-address track track-entry-number } [ preference preference-value ] [ tag
tag-value ] [ description description-text ]
undo ip route-static vpn-instance s-vpn-instance-name&<1-6> dest-address { mask
| mask-length } [ next-hop-address [ public ] | interface-type interface-number
[ next-hop-address ] | vpn-instance d-vpn-instance-name next-hop-address ]
[ preference preference-value ]

View

System view

Default Level

2: System level

Parameters

vpn-instance s-vpn-instance-name&<1-6>: Specifies the VPN instance name, which

is a string of 1 to 31 case-sensitive characters. &<1-6> indicates the argument before it
can be entered up to 6 times. Each VPN instance has its own routing table, and the
configured static route is installed in the routing tables of the specified VPN instances.
dest-address: Destination IP address of the static route, in dotted decimal notation.
mask: Mast of the IP address, in dotted decimal notation.
mask-length: Mask length, in the range 0 to 32.
next-hop-address: IP address of the next hop, in dotted decimal notation.

1-2
 Chapter 1 Static Routing
Command Manual – Static Routing (IP Routing Volume) Configuration Commands

interface-type interface-number: Specifies the output interface by its type and number.
If the output interface is a broadcast interface, such as an Ethernet interface, a virtual
template or a VLAN interface, the next hop address must be specified.
vpn-instance d-vpn-instance-name: Name of the destination VPN instance,
case-sensitive. If a destination VPN instance name is specified, the router will search
the output interface in the destination VPN instance based on the configured
next-hop-address.
next-hop-address public: Indicates that the specified next-hop-address is a public
network address, rather than a VPN instance address.
preference preference-value : Specifies the preference of the static route, which is in
the range of 1 to 255 and defaults to 60.
tag tag-value: Sets a tag value for the static route from 1 to 4294967295. The default is
0. Tags of routes are used in routing policies to control routing.
description description-text: Configures a description for the static route, which
consists of 1 to 60 characters, including special characters like space, but excluding ?.
track track-entry-number: Associates the static route with a track entry. Use the
track-entry-number argument to specify a track entry number, in the range 1 to 1024.

Description

Use the ip route-static command to configure a unicast static route.

Use the undo ip route-static command to delete a unicast static route.
When configuring a unicast static route, note that:
1) If the destination IP address and the mask are both 0.0.0.0, the configured route is
a default route. If routing table searching fails, the router will use the default route
for packet forwarding.
2) Different route management policies can be implemented for different route
preference configurations. For example, specifying the same preference for
different routes to the same destination address enables load sharing, while
specifying different preferences for these routes enables route backup.
3) When configuring a static route, you can specify the output interface or the next
hop address based on the actual requirement. Note that the next hop address
must not be the IP address of the local interface; otherwise, the route configuration
will not take effect. For interfaces that support network address to link layer
address resolution or point-to-point interfaces, you can specify the output interface
or next hop address. When specifying the output interface, note that:
z For a NULL0 or loopback interface, if the output interface has already been
configured, there is no need to configure the next hop address.
z For point-to-point interfaces, you can specify the output interface if you do not
know the peer address. Thus, there is no need to change the router’s configuration
even if the peer address is changed. A PPP interface obtains the peer’s IP

1-3
 Chapter 1 Static Routing
Command Manual – Static Routing (IP Routing Volume) Configuration Commands

address through PPP negotiation. In this case, you need only specify the output
interface.
z For NBMA and P2MP interfaces, which support point-to-multipoint networks, the
IP address to link layer address mapping must be established in addition to IP
route configuration. In general, it is recommended to configure the next hop IP
address when you configure the output interface.
z It is not recommended to specify a broadcast interface (such as an Ethernet
interface, virtual template, or VLAN interface) as the output interface for a static
route, because a broadcast interface may have multiple next hops. If you have to
do so, you must specify the corresponding next hop of the interface at the same
time.
Related commands: display ip routing-table, ip route-static default-preference.

Note:
z The static route does not take effect if you specify its next hop address first and then
configure the address as the IP address of a local interface, such as Ethernet
interface and VLAN interface.
z To configure track monitoring for an existing static route, simply associate the static
route with a track entry. For a non-existent static route, configure it and associate it
with a Track entry.
z If the track module uses NQA to detect the reachability of the private network static
route's nexthop, the VPN instance number of the static route's nexthop must be
identical to that configured in the NQA test group.
z If a static route needs route recursion, the associated track entry must monitor the
nexthop of the recursive route instead of that of the static route; otherwise, a valid
route may be mistakenly considered invalid.

Examples

# Configure a static route, whose destination address is 1.1.1.1/24, next hop address is
2.2.2.2, tag value is 45, and description information is for internet & intranet.
<Sysname> system-view
[Sysname] ip route-static 1.1.1.1 24 2.2.2.2 tag 45 description for internet
& intranet

# Configure a static route for a VPN instance named vpn1: the destination address is
1.1.1.1/16 and the next hop address is 1.1.1.2, which is the address of this VPN
instance.
<Sysname> system-view

1-4
 Chapter 1 Static Routing
Command Manual – Static Routing (IP Routing Volume) Configuration Commands

[Sysname] ip route-static vpn-instance vpn1 1.1.1.1 16 vpn-instance vpn1

1.1.1.2

1.1.3 ip route-static default-preference

Syntax

ip route-static default-preference default-preference-value

undo ip route-static default-preference

View

System view

Default Level

2: System level

Parameters

default-preference-value: Default preference for static routes, which is in the range of 1

to 255.

Description

Use the ip route-static default-preference command to configure the default

preference for static routes.
Use the undo ip route-static default-preference command to restore the default.
By default, the default preference of static routes is 60.
Note that:
z If no preference is specified when configuring a static route, the default preference
is used.
z When the default preference is re-configured, it applies to newly added static
routes only.
Related commands: display ip routing-table, ip route-static.

Examples

# Set the default preference of static routes to 120.

<Sysname> system-view
[Sysname] ip route-static default-preference 120

1-5