Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 02-Static routing commands | 60.52 KB |
display route-static routing-table
ip route-static default-preference
ip route-static primary-path-detect bfd echo
Static routing commands
delete static-routes all
Use delete static-routes all to delete all static routes.
Syntax
delete [ vpn-instance vpn-instance-name ] static-routes all
Views
System view
Predefined user roles
network-admin
Parameters
vpn-instance vpn-instance-name: Specifies a VPN instance by its name, a case-sensitive string of 1 to 31 characters. Without this option, the command deletes all static routes for the public network.
Usage guidelines
When you use this command, the system will prompt you to confirm the operation before deleting all the static routes.
To delete one static route, use the undo ip route-static command. To delete all static routes, including the default route, use the delete static-routes all command.
Examples
# Delete all static routes.
<Sysname> system-view
[Sysname] delete static-routes all
This will erase all IPv4 static routes and their configurations, you must reconfigure all static routes.
Are you sure?[Y/N]:y
Related commands
ip route-static
display route-static nib
Use display route-static nib to display static route next hop information.
Syntax
display route-static nib [ nib-id ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
nib-id: Specifies a NIB by its ID in the range of 1 to FFFFFFFF.
verbose: Displays detailed static route next hop information. Without this keyword, the command displays brief static route next hop information.
Examples
# Display brief static route next hop information.
<Sysname> display route-static nib
Total number of nexthop(s): 44
NibID: 0x11000000 Sequence: 0
Type: 0x21 Flushed: Yes
UserKey0: 0x111 VrfNthp: 0
UserKey1: 0x0 Nexthop: 0.0.0.0
IFIndex: 0x111 LocalAddr: 0.0.0.0
NibID: 0x11000001 Sequence: 1
Type: 0x41 Flushed: Yes
UserKey0: 0x0 VrfNthp: 5
UserKey1: 0x0 Nexthop: 2.2.2.2
IFIndex: 0x0 LocalAddr: 0.0.0.0
Table 1 Command output
|
Field |
Description |
|
NibID |
ID of the NIB. |
|
NibSeq |
Sequence number of the NIB. |
|
Type |
Type of the NIB. |
|
Flushed |
Indicates whether the route with the NIB has been flushed to the FIB. |
|
UserKey0 |
Reserved data 1. |
|
UserKey1 |
Reserved data 2. |
|
VrfNthp |
VPN instance to which the next hop belongs. |
|
Nexthop |
Next hop address. |
|
IFIndex |
Interface index |
|
LocalAddr |
Local interface address. |
# Display detailed static route next hop information.
<Sysname> display route-static nib verbose
Total number of nexthop(s): 44
NibID: 0x11000000 Sequence: 0
Type: 0x21 Flushed: Yes
UserKey0: 0x111 VrfNthp: 0
UserKey1: 0x0 Nexthop: 0.0.0.0
IFIndex: 0x111 LocalAddr: 0.0.0.0
RefCnt: 2 FlushRefCnt: 0
Flag: 0x2 Version: 1
1 nexthop(s):
PrefixIndex: 0 OrigNexthop: 0.0.0.0
RelyDepth: 0 RealNexthop: 0.0.0.0
Interface: NULL0 LocalAddr: 0.0.0.0
TunnelCnt: 0 Vrf: default-vrf
TunnelID: N/A
NibID: 0x11000001 Sequence: 1
Type: 0x41 Flushed: Yes
UserKey0: 0x0 VrfNthp: 5
UserKey1: 0x0 Nexthop: 2.2.2.2
IFIndex: 0x0 LocalAddr: 0.0.0.0
RefCnt: 1 FlushRefCnt: 0
Flag: 0x12 Version: 1
2 nexthop(s):
PrefixIndex: 0 OrigNexthop: 2.2.2.2
RelyDepth: 7 RealNexthop: 8.8.8.8
Interface: Dia0 LocalAddr: 12.12.12.12
TunnelCnt: 0 Vrf: default-vrf
TunnelID: N/A
PrefixIndex: 0 OrigNexthop: 2.2.2.2
RelyDepth: 9 RealNexthop: 0.0.0.0
Interface: NULL0 LocalAddr: 0.0.0.0
TunnelCnt: 0 Vrf: default-vrf
TunnelID: N/A
...
Table 2 Command output
|
Field |
Description |
|
x nexthop(s) |
Number of next hops. |
|
PrefixIndex |
Prefix index of the next hop for an ECMP route. |
|
OrigNexthop |
Original next hop. |
|
RelyDepth |
Recursion depth. |
|
RealNexthop |
Real next hop. |
|
Interface |
Output interface. |
|
localAddr |
Local interface address. |
|
TunnelCnt |
This field is not supported in the current software version. Number of tunnels after route recursion. |
|
Vrf |
VPN instance name. |
|
TunnelID |
This field is not supported in the current software version. ID of the tunnel after route recursion. |
|
RefCnt |
Reference count of the next hop. |
|
FlushRefCnt |
Reference count of the next hop that is flushed to the FIB. |
|
Flag |
Flag of the next hop. |
|
Version |
Version of the next hop. |
display route-static routing-table
Use display route-static routing-table to display static routing table information.
Syntax
display route-static routing-table [ vpn-instance vpn-instance-name ] [ ip-address { mask-length | mask } ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vpn-instance vpn-instance-name: Specifies a VPN instance by its name, a case-sensitive string of 1 to 31 characters. Without this option, the command displays static routing table information for the public network.
ip-address: Specifies the destination IP address in dotted decimal notation.
mask-length/mask: Specifies the mask length or mask of the IP address. It must be an integer in the range of 0 to 32 or in dotted decimal notation.
Examples
# Display static routing table information.
<Sysname> display route-static routing-table
Total number of routes: 24
Status: * - valid
*Destination: 0.0.0.0/0
NibID: 0x1100000a NextHop: 2.2.2.10
MainNibID: N/A BkNextHop: N/A
BkNibID: N/A Interface: N/A
TableID: 0x2 BkInterface: N/A
Flag: 0x82d01 BfdSrcIp: N/A
DbIndex: 0xd BfdIfIndex: 0x0
Type: Normal BfdVrfIndex: 0
TrackIndex: 0xffffffff Label: NULL
Preference: 60 vrfIndexDst: 0
BfdMode: N/A vrfIndexNH: 0
Permanent: 0 Tag: 0
Destination: 0.0.0.0/0
NibID: 0x1100000b NextHop: 2.2.2.11
MainNibID: N/A BkNextHop: N/A
BkNibID: N/A Interface: N/A
TableID: 0x2 BkInterface: N/A
Flag: 0x82d01 BfdSrcIp: N/A
DbIndex: 0xd BfdIfIndex: 0x0
Type: Normal BfdVrfIndex: 0
TrackIndex: 0xffffffff Label: NULL
Preference: 60 vrfIndexDst: 0
BfdMode: N/A vrfIndexNH: 0
Permanent: 0 Tag: 0
...
# Display information about the static route with destination address 1.2.3.4/32.
<Sysname> display route-static routing-table 1.2.3.4 32
*Destination: 1.2.3.4/32
NibID: 0x11000017 NextHop: 4.4.4.4
MainNibID: 0x11000015 BkNextHop: 5.5.5.5
BkNibID: 0x11000016 Interface: Vlan-interface1
TableID: 0x2 BkInterface: Vlan-interface2
Flag: 0xa8d0b BfdSrcIp: N/A
DbIndex: 0x17 BfdIfIndex: 0x0
Type: Normal BfdVrfIndex: 0
TrackIndex: 0xffffffff Label: NULL
Preference: 60 vrfIndexDst: 0
BfdMode: N/A vrfIndexNH: 0
Permanent: 0 Tag: 0
Table 3 Command output
|
Field |
Description |
|
destination |
Destination address/prefix. |
|
NibID |
ID of the NIB. |
|
MainNibID |
ID of the primary next hop for static route FRR. |
|
BkNibID |
ID of the backup next hop for static route FRR. |
|
NextHop |
Next hop address. |
|
BkNextHop |
Backup next hop address. |
|
Interface |
Output interface of the route. |
|
BkInterface |
Backup output interface. |
|
TableID |
ID of the table to which the route belongs. |
|
Flag |
Flag of the route. |
|
DbIndex |
Index of the database to which the route belongs. |
|
Type |
Route type: · Normal. · DHCP. · NAT. |
|
BfdSrcIp |
Source IP address of the indirect BFD session. |
|
BfdIfIndex |
Index of the interface where BFD is enabled. |
|
BfdVrfIndex |
Index of the VPN instance where BFD is enabled. |
|
BfdMode |
BFD session mode: · N/A—No BFD session is configured. · Ctrl—Control packet mode · Echo—Echo packet mode. |
|
TrackIndex |
NQA Track index. |
|
vrfIndexDst |
Index of the VPN to which the destination belongs. |
|
vrfIndexNH |
Index of the VPN to which the next hop belongs. |
|
Permanent |
Permanent static route flag. 1 indicates a permanent static route. |
ip route-static
Use ip route-static to configure a static route.
Use undo ip route-static to delete a static route.
Syntax
ip route-static dest-address { mask-length | mask } { interface-type interface-number [ next-hop-address ] [ backup-interface interface-type interface-number [ backup-nexthop backup-nexthop-address ] [ permanent ] | bfd { control-packet | echo-packet } | permanent ] | next-hop-address [ bfd control-packet bfd-source ip-address | permanent | track track-entry-number ] | vpn-instance d-vpn-instance-name next-hop-address [ bfd control-packet bfd-source ip-address | permanent | track track-entry-number ] } [ preference preference-value ] [ tag tag-value ] [ description description-text ]
undo ip route-static dest-address { mask-length | mask } [ interface-type interface-number [ next-hop-address ] | next-hop-address | vpn-instance d-vpn-instance-name next-hop-address ] [ preference preference-value ]
ip route-static vpn-instance s-vpn-instance-name dest-address { mask-length | mask } { interface-type interface-number [ next-hop-address ] [ backup-interface interface-type interface-number [ backup-nexthop backup-nexthop-address ] [ permanent ] | bfd { control-packet | echo-packet } | permanent ] | next-hop-address [ public ] [ bfd control-packet bfd-source ip-address | permanent | track track-entry-number ] | vpn-instance d-vpn-instance-name next-hop-address [ bfd control-packet bfd-source ip-address | permanent | track track-entry-number ] } [ preference preference-value ] [ tag tag-value ] [ description description-text ]
undo ip route-static vpn-instance s-vpn-instance-name dest-address { mask-length | mask } [ interface-type interface-number [ next-hop-address ] | next-hop-address [ public ] | vpn-instance d-vpn-instance-name next-hop-address ] [ preference preference-value ]
Default
No static route is configured.
Views
System view
Predefined user roles
network-admin
Parameters
vpn-instance s-vpn-instance-name: Specifies a source VPN instance by its name, a case-sensitive string of 1 to 31 characters. Each VPN has its own routing table, and the configured static route is installed in the routing tables of the specified VPNs.
dest-address: Specifies the destination IP address of the static route, in dotted decimal notation.
mask-length/mask: Specifies the mask length or mask of the IP address. It must be an integer in the range of 0 to 32 or in dotted decimal notation.
vpn-instance d-vpn-instance-name: Specifies a destination VPN instance by its name, a case-sensitive string of 1 to 31 characters. If a destination VPN is specified, packets will search for the output interface in the destination VPN based on the configured next hop address.
next-hop-address: Specifies the IP address of the next hop, in dotted decimal notation.
backup-interface interface-type interface-number: Specifies a backup output interface by its type and number. If the backup output interface is an NBMA interface or broadcast interface and not a P2P interface, you must specify the backup next hop address. Broadcast interfaces include Ethernet interfaces and VLAN interfaces.
backup-nexthop backup-nexthop-address: Specifies a backup next hop address.
bfd: Enables BFD to detect reachability of the static route's next hop. When the next hop is unreachable, the system immediately switches to the backup route.
control-packet: Specifies the BFD control mode.
bfd-source ip-address: Specifies the source IP address of BFD packets. As a best practice, specify the loopback interface address.
permanent: Specifies the route as a permanent static route. If the output interface is down, the permanent static route is still active.
track track-entry-number: Associates the static route with a track entry specified by its number in the range of 1 to 1024. For more information about Track, see High Availability Configuration Guide.
echo-packet: Specifies the BFD echo mode.
public: Indicates that the specified next hop address is on the public network.
interface-type interface-number: Specifies an output interface by its type and number. If the output interface is an NBMA interface or broadcast interface and not a P2P interface, the next hop address must be specified. Broadcast interfaces include Ethernet interfaces and VLAN interfaces.
preference preference-value: Specifies a preference for the static route, in the range of 1 to 255. The default is 60.
tag tag-value: Sets a tag value for marking the static route, in the range of 1 to 4294967295. The default is 0.
description description-text: Configures a description for the static route, which comprises 1 to 60 characters, including special characters like the space, but excluding the question mark (?).
Usage guidelines
If the destination IP address and the mask are both 0.0.0.0 (or 0), the configured route is a default route. The default route is used for forwarding a packet matching no entry in the routing table.
Configure route preferences based on your routing purpose. For example, to enable load sharing for multiple routes to the same destination, assign the same preference to the routes. To enable them to back up one another, assign different preferences to them.
Follow these guidelines when you specify the output interface or the next hop address of the static route:
· If the output interface is a Null 0 interface, no next hop address is required.
· If the output interface is a broadcast interface that might have multiple next hops, you must specify the output interface and the next hop address at the same time. Broadcast interfaces include Ethernet interfaces and VLAN interfaces.
Follow these guidelines when you configure a static route:
· Enabling BFD for a flapping route could worsen the route flapping situation. Therefore, use it with caution. For more information about BFD, see High Availability Configuration Guide.
· For static routing-Track-NQA collaboration, you must configure the same VPN instance ID for the next hop to be detected and the NQA operation.
· If a static route needs route recursion, the associated track entry must monitor the next hop of the recursive route instead of that of the static route. Otherwise, a valid route might be mistakenly considered invalid.
· Do not specify the permanent keyword together with the bfd or track keyword.
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.
<Sysname> system-view
[Sysname] ip route-static 1.1.1.1 24 2.2.2.2 tag 45 description for internet
Related commands
display ip routing-table protocol
ip route-static default-preference
Use ip route-static default-preference to configure a default preference for static routes.
Use undo ip route-static default-preference to restore the default.
Syntax
ip route-static default-preference default-preference-value
undo ip route-static default-preference
Default
The default preference of static routes is 60.
Views
System view
Predefined user roles
network-admin
Parameters
default-preference-value: Specifies a default preference for static routes, in the range of 1 to 255.
Usage guidelines
If no preference is specified for a static route, the default preference applies.
When the default preference is reconfigured, it applies only to newly added static routes.
Examples
# Set a default preference of 120 for static routes.
<Sysname> system-view
[Sysname] ip route-static default-preference 120
Related commands
display ip routing-table protocol
ip route-static primary-path-detect bfd echo
Use ip route-static primary-path-detect bfd echo to enable BFD echo packet mode for static route FRR.
Use undo ip route-static primary-path-detect bfd to restore the default.
Syntax
ip route-static primary-path-detect bfd echo
undo ip route-static primary-path-detect bfd
Default
BFD echo packet mode for static route FRR is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
This command enables static route FRR to use BFD echo packet mode for fast failure detection on the primary link.
Examples
# Enable BFD echo packet mode for static route FRR.
[Sysname] ip route-static 1.1.1.1 24 2.2.2.2 tag 45 description for internet
[Sysname] ip route-static primary-path-detect bfd echo
