No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

Command Reference

CloudEngine 8800, 7800, 6800, and 5800 V200R002C50

This document describes all the configuration commands of the device, including the command function, syntax, parameters, views, default level, usage guidelines, examples, and related commands.
Rate and give feedback :
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
Static Route Configuration Commands

Static Route Configuration Commands

NOTE:

The CE6810LI does not support IPv4 or IPv6 Layer 3 forwarding. After the IPv4 or IPv6 function is enabled on an interface of the CE6810LI, the configured IPv4 or IPv6 address can only be used to manage the switch.

display static-route ipv6 routing-table

Function

The display static-route ipv6 routing-table command displays IPv6 unicast static routes.

Format

display static-route ipv6 routing-table [ vpn-instance vpn-instance-name ] [ destination-address [ prefix-length ] ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies the name of a VPN instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.
destination-address Specifies a destination IPv6 address. The value is a 32-bit hexadecimal number, in X:X:X:X:X:X:X:X format.
prefix-length Specifies the mask length of a destination IPv6 address. The value ranges from 0 to 128.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display static-route ipv6 routing-table command is used to view configured IPv6 static routes.

The function of the display static-route ipv6 routing-table command varies according to specified parameters.

  • The display static-route ipv6 routing-table command displays IPv6 unicast static routes in the base topology of the public network.

  • The display static-route ipv6 routing-table destination-address mask-length command displays IPv6 unicast static routes that exactly match a specified destination address and mask length in the base topology of the public network.

  • The display static-route ipv6 routing-table vpn-instance vpn-instance-name command displays all IPv6 unicast static routes in a specified VPN instance.

  • The display static-route ipv6 routing-table vpn-instance vpn-instance-name destination-address mask-length command displays the IPv6 unicast static routes that accurately match a destination address/mask length in a specified VPN.

Example

# Display IPv6 unicast static routes in the base topology of the public network.

<HUAWEI> display static-route ipv6 routing-table
Summary Destinations : 2        Routes : 2

Destination   : 2001:db8::/64
Preference    : 60                                      Tag            : 0
Interface     : NULL0                                   InterfaceState : UP
OriginNextHop : ::                                      BfdDetect      : Disable
BfdSession    :                                         
BfdType       : --
NQAAdminName  : --                                      NQATestName    : --
NQADetect     : --                                      Label          : NULL
State         : Active Primary                          
IndirectID    : 0xE                                     RelayTunnel    : Disable
IIDFlags      : BlackHole                               RelayDepth     : 0
LocalAddress  : ::
RemoteIp      : ::

Destination   : fc00::/64
Preference    : 60                                      Tag            : 0
Interface     : --                                      InterfaceState : --
OriginNextHop : fc00::2                                  BfdDetect      : Disable
BfdSession    :                                         
BfdType       : --
NQAAdminName  : --                                      NQATestName    : --
NQADetect     : --                                      Label          : NULL
State         : Active Primary                          
IndirectID    : 0xF                                     RelayTunnel    : Disable
IIDFlags      :                                         RelayDepth     : 1
DestVrf       : public                                  DestTopo       : base
RelayNextHop  : fc00::2                                  RelayInterface : --
TunnelID      : --                                      
Table 9-1  Description of the display static-route ipv6 routing-table command output

Item

Description

Summary Destinations

Indicates the total number of destination network prefixes or host prefixes.

Routes

Indicates the total number of routes.

Destination

Indicates a destination address/mask length.

Preference

Indicates the preference of a route.

Tag

Indicates the administrative tag of a route.

Interface

Indicates the outbound interface configured for a route. If no outbound interface is configured for a route, this item is displayed as "-".

InterfaceState

Indicates the interface status. If no interface is configured, this item is displayed as "-".

OriginNextHop

Indicates the next hop configured for a route. If no next hop is configured for a route, this item is displayed as "::".

BfdDetect

Indicates the result of the BFD detection:

  • Disable: indicates that the BFD detection is not enabled.

  • UP: indicates that the result of detection is Up, the routing entry can be delivered.

  • DOWN: indicates that the result of detection is Down, the routing entry cannot be delivered.

  • UNKOWN: indicates that the result of detection is unkown, the routing entry cannot be delivered.

  • UNKOWN(AdminStatus=Down): indicates that the result of detection is unkown, and the status of administration is Down, the routing entry can be delivered.

BfdSession

Indicates the name of the BFD session.

BfdType

Indicates the type of the BFD session:
  • STATIC: static BFD detection.
  • DYNAMIC: dynamic BFD detection.

NQAAdminName

Indicates the administrator of an NQA test instance.

NQATestName

Indicates the name of an NQA test instance.

NQADetect

Indicates the result of the NQA detection:
  • Disable: indicates that the NQA detection is not enabled.
  • UP: indicates that the result of detection is Up, the routing entry can be delivered.
  • DOWN: indicates that the result of detection is Down, the routing entry cannot be delivered.
  • UNKNOWN: indicates that the result of detection is unkown, the routing entry can be delivered.

Label

Indicates the label.

State

Indicates the route selection result:

  • Active Primary: indicates an active primary route.
  • Active Backup: indicates an active backup route.
  • Inactive Valid: indicates a route that takes part in the route selection but is not preferred.
  • Inactive Invalid: indicates a route that cannot take part in the route selection.

Cost

Indicate the cost value.

IndirectID

Indicates the keyword of indirect next hop.

RelayTunnel

Indicates whether to iterate tunnels.

IIDFlags

Indicates the keyword flags of indirect next hop, including BlackHole and ShortCut.

RelayDepth

Indicates the iteration depth.

LocalAddress

Indicates the IPv6 address of the local interface. If no IPv6 address is configured for the local interface, this item is displayed as "::". This item is displayed only when the outbound interface of the corresponding route is configured.

RemoteIp

Indicates the IPv6 address of the remote P2P interface. If no IPv6 address is configured for the remote P2P interface, this item is displayed as "::". This item is displayed only when the outbound interface of the corresponding route is configured.

DestVrf

Indicates the name of the VPN instance to which the next hop address belongs. This item is displayed only when the next hop of the corresponding static route is configured but the outbound interface of the route is not configured.

DestTopo

Indicates the name of the destination topology to which the next hop address belongs. This item is displayed only when the next hop of the corresponding static route is configured but the outbound interface of the route is not configured.

RelayNextHop

Indicates the iterated next hop address. If the corresponding static route reaches the next hop through a tunnel, this item is displayed as "::". This item is displayed only when the next hop of the route is configured but the outbound interface of the route is not configured.

RelayInterface

Indicates the name of an iterated outbound interface. If the corresponding static route reaches the next hop through a tunnel, this item is displayed as a tunnel name. This item is displayed only when the next hop of the route is configured but the outbound interface of the route is not configured.

If the iterated route is a to-table route, this item is displayed as a VRF name.

TunnelID

Indicates the ID of a tunnel.

# Display the IPv6 unicast static routes that match a destination IPv6 address and mask length in a specified VPN.

<HUAWEI> display static-route ipv6 routing-table vpn-instance vrf1 fc00::1 64
Summary Count : 1

Destination   : fc00::/64
Preference    : 60                                      Tag            : 0
Interface     : NULL0                                   InterfaceState : UP
OriginNextHop : ::                                      BfdDetect      : Disable
BfdSession    :                                         BfdType        : --
NQAAdminName  : --                                      NQATestName    : --
NQADetect     : --                                      Label          : NULL
State         : Active Primary                          
IndirectID    : 0x10                                    RelayTunnel    : Disable
IIDFlags      : BlackHole                               RelayDepth     : 0
LocalAddress  : ::
RemoteIp      : ::

display static-route multicast routing-table

Function

The display static-route multicast routing-table command displays multicast static routes.

Format

display static-route multicast routing-table [ destination-address [ mask-length ] ]

NOTE:

The CE6810LI does not support this command.

Parameters

Parameter Description Value
destination-address Specifies a destination IP address. The value is in dotted decimal notation.
mask-length Specifies the mask length of a destination IP address. The value is an integer ranging from 0 to 32.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display static-route multicast routing-table command is used to view configured multicast static routes.

The function of the display static-route multicast routing-table command varies according to specified parameters.

  • The display static-route multicast routing-table command displays IPv4 multicast static routes in the base topology of the public network.

  • The display static-route multicast routing-table destination-address mask-length command displays IPv4 multicast static routes that exactly match a destination IP address and mask length in the base topology of the public network.

  • The display static-route multicast routing-table vpn-instance vpn-instance-name command displays all IPv4 multicast static routes in a specified VPN.

  • The display static-route multicast routing-table vpn-instance vpn-instance-name destination-address mask-length command displays the IPv4 multicast static routes that accurately match a destination address and mask length in a specified VPN.

Example

# Display IPv4 multicast static routes in the base topology of the public network.

<HUAWEI> display static-route multicast routing-table
Summary Destinations : 1        Routes : 1

Destination   : 192.168.1.0/24
Preference    : 1                                       Tag            : 0
Interface     : -                                       InterfaceState : -
OriginNextHop : 10.1.1.2                                BfdDetect      : Disable
BfdSession    :                                         
BfdType       : --
NQAAdminName  : --                                      NQATestName    : --
NQADetect     : --                                      Label          : NULL
State         : Active Primary                          Cost           : 0
IndirectID    : 0x14                                    RelayTunnel    : Disable
IIDFlags      :                                         RelayDepth     : 1
DestVrf       : public                                  DestTopo       : base
RelayNextHop  : 10.1.1.2                                RelayInterface : 10GE1/0/1
TunnelID      : -

# Display the multicast static routes that match a specified destination IP address.

<HUAWEI> display static-route multicast routing-table 192.168.1.1 24
Summary Count : 1 

Destination   : 192.168.1.0/24
Preference    : 1                                       Tag            : 0
Interface     : -                                       InterfaceState : -
OriginNextHop : 10.1.1.2                                BfdDetect      : Disable
BfdSession    :                                         
BfdType       : --
NQAAdminName  : --                                      NQATestName    : --
NQADetect     : --                                      Label          : NULL
State         : Active Primary                          Cost           : 0
IndirectID    : 0x14                                    RelayTunnel    : Disable
IIDFlags      :                                         RelayDepth     : 1
DestVrf       : public                                  DestTopo       : base
RelayNextHop  : 10.1.1.2                                RelayInterface : 10GE1/0/1
TunnelID      : -

# Display private-network multicast static routes.

<HUAWEI> display static-route multicast routing-table vpn-instance vrf1
Summary Destinations : 1        Routes : 1

Destination   : 192.168.2.0/24
Preference    : 1                                       Tag            : 0
Interface     : -                                       InterfaceState : -
OriginNextHop : 10.1.1.2                                BfdDetect      : Disable
BfdSession    :                                         
BfdType       : --
NQAAdminName  : --                                      NQATestName    : --
NQADetect     : --                                      Label          : NULL
State         : Inactive Invalid                        Cost           : 0
IndirectID    : 0x16                                    RelayTunnel    : Disable
IIDFlags      :                                         RelayDepth     : 0
DestVrf       : vrf1                                    DestTopo       : base
RelayNextHop  : 10.1.1.2                                RelayInterface : --
TunnelID      : --
Table 9-2  Description of the display static-route multicast routing-table command output

Item

Description

Summary Destinations

Indicates the total number of destination network prefixes or host prefixes.

Routes

Indicates the total number of routes.

Destination

Indicates the destination address/mask length.

Preference

Indicates the preference of a route.

Tag

Indicates the administrative tag of a route.

Interface

Indicates the outbound interface configured for a route. If no outbound interface is configured for a route, this item is displayed as "-".

InterfaceState

Indicates the interface status. If no interface is configured, the item is displayed as "-".

OriginNextHop

Indicates the next hop configured for a route. If no next hop is configured for a route, this item is displayed as "0.0.0.0".

BfdDetect

Indicates the result of the BFD detection:

  • Disable: indicates that the BFD detection is not enabled.

  • UP: indicates that the result of detection is up, the routing entry can be delivered.

  • DOWN: indicates that the result of detection is down, the routing entry cannot be delivered.

  • UNKOWN: indicates that the result of detection is unkown, the routing entry cannot be delivered.

  • UNKOWN(AdminStatus=Down): indicates that the result of detection is unkown, and the status of administration is down, the routing entry can be delivered.

BfdSession

Indicates the name of the BFD session.

BfdType

Indicates the type of the BFD session:
  • STATIC: static BFD detection.
  • DYNAMIC: dynamic BFD detection.

NQAAdminName

Indicatess the administrator of an NQA test instance.

NQATestName

Indicates the name of an NQA test instance.

NQADetect

Indicates the result of the NQA detection:
  • Disable: indicates that the NQA detection is not enabled.
  • UP: indicates that the result of detection is up, the routing entry can be delivered.
  • DOWN: indicates that the result of detection is down, the routing entry cannot be delivered.
  • UNKNOWN: indicates that the result of detection is unkown, the routing entry can be delivered.

Label

Label

State

Indicates the route selection result:

  • Active Primary: indicates an active primary route.
  • Active Backup: indicates an active backup route.
  • Inactive Valid: indicates a route that takes part in the route selection but is not preferred.
  • Inactive Invalid: indicates a route that cannot take part in the route selection.

Cost

Cost value.

IndirectID

Indicates the keyword of indirect next hop.

RelayTunnel

Indicates whether to iterate tunnels.

IIDFlags

Indicates the keyword flags of indirect next hop, including BlackHole and ShortCut.

RelayDepth

Indicates the iteration depth.

DestVrf

Indicates the name of the VPN instance to which the next hop address belongs. This item is displayed only when the next hop of the corresponding static route is configured but the outbound interface of the route is not configured.

DestTopo

Indicates the name of the destination topology to which the next hop address belongs. This item is displayed only when the next hop of the corresponding static route is configured but the outbound interface of the route is not configured.

RelayNextHop

Indicates the iterated next hop address. If the corresponding static route reaches the next hop through a tunnel, this item is displayed as 0.0.0.0. This item is displayed only when the next hop of the route is configured but the outbound interface of the route is not configured.

RelayInterface

Indicates the name of an iterated outbound interface. If the corresponding static route reaches the next hop through a tunnel, this item is displayed as a tunnel name. This item is displayed only when the next hop of the route is configured but the outbound interface of the route is not configured.

TunnelID

Indicates the ID of a tunnel. If the corresponding route is forwarded by using IP, this item is displayed as "-". This item is displayed only when the next hop of the route is configured but the outbound interface of the route is not configured.

display static-route routing-table

Function

The display static-route routing-table command displays static routes.

Format

display static-route routing-table [ vpn-instance vpn-instance-name ] [ destination-address [ mask-length ] ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies the name of a VPN instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.
destination-address Specifies a destination IP address. The value is in dotted decimal notation.
mask-length Specifies the mask length of a destination IP address. The value is an integer ranging from 0 to 32.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display static-route routing-table command is used to view configured static routes.

The function of the display static-route routing-table command varies according to specified parameters.

  • The display static-route routing-table command displays IPv4 unicast static routes in the base topology of the public network.

  • The display static-route routing-table destination-address mask-length command displays the IPv4 unicast static routes that exactly match a destination IP address and mask length in the base topology of the public network.

  • The display static-route routing-table vpn-instance vpn-instance-name command displays all IPv4 unicast static routes in a specified VPN.

  • The display static-route routing-table vpn-instance vpn-instance-name destination-address mask-length command displays the IPv4 unicast static routes that accurately match a destination address and mask length in a specified VPN.

Example

# Display IPv4 unicast static routes in the base topology of the public network.

<HUAWEI> display static-route routing-table
Summary Destinations : 3        Routes : 3

Destination   : 2.2.2.2/32
Preference    : 60                                      Tag            : 0
Interface     : NULL0                                   InterfaceState : UP
OriginNextHop : 0.0.0.0                                 BfdDetect      : Disable
BfdSession    :                                                                 
BfdType       : --
NQAAdminName  : --                                      NQATestName    : --
NQADetect     : Disable                                 Label          : NULL
EFMDetect     : Disable                                 EfmInterface   : --  
State         : Active Primary                          Cost           : 0
IndirectID    : 0x1000054                               RelayTunnel    : Disable
IIDFlags      : BlackHole                               RelayDepth     : 0
LocalAddress  : 0.0.0.0
RemoteIp      : 0.0.0.0

Destination   : 3.3.3.0/24
Preference    : 60                                      Tag            : 0
Interface     : --                                      InterfaceState : --
OriginNextHop : 11.11.11.11                             BfdDetect      : Disable
BfdSession    :                                                                 
BfdType       : --
NQAAdminName  : --                                      NQATestName    : --
NQADetect     : Disable                                 Label          : NULL
EFMDetect     : Disable                                 EfmInterface   : --  
State         : Inactive Invalid                        Cost           : 0
IndirectID    : 0x0                                     RelayTunnel    : Disable
IIDFlags      : GateWay                                 RelayDepth     : 0
DestVrf       : _public_                                DestTopo       : 
RelayNextHop  : 0.0.0.0                                 RelayInterface : --
TunnelID      : --                                      

Destination   : 5.5.5.0/24
Preference    : 60                                      Tag            : 0
Interface     : WZC                                     InterfaceState : --
OriginNextHop : 0.0.0.0                                 BfdDetect      : Disable
BfdSession    :                                                                 
BfdType       : --
NQAAdminName  : --                                      NQATestName    : --
NQADetect     : Disable                                 Label          : NULL
EFMDetect     : Disable                                 EfmInterface   : --  
State         : Active Primary                          Cost           : 0
IndirectID    : 0x1000057                               RelayTunnel    : Disable
IIDFlags      : --
Table 9-3  Description of the display static-route routing-table command output

Item

Description

Summary Destinations

Indicates the total number of destination network prefixes or host prefixes.

Routes

Indicates the total number of routes.

Destination

Indicates the destination address/mask length.

Preference

Indicates the preference of a route.

Tag

Indicates the administrative tag of a route.

Interface

Indicates the outbound interface configured for a route. If no outbound interface is configured for a route, this item is displayed as "-".

InterfaceState

Indicates the interface status. If no interface status is configured, the item is displayed as "-".

OriginNextHop

Indicates the next hop configured for a route. If no next hop is configured for a route, this item is displayed as "0.0.0.0".

BfdDetect

Indicates the result of the BFD detection:

  • Disable: indicates that the BFD detection is not enabled.

  • UP: indicates that the result of detection is up, the routing entry can be delivered.

  • DOWN: indicates that the result of detection is down, the routing entry cannot be delivered.

  • UNKOWN: indicates that the result of detection is unkown, the routing entry cannot be delivered.

  • UNKOWN(AdminStatus=Down): indicates that the result of detection is unkown, and the status of administration is down, the routing entry can be delivered.

BfdSession

Indicates the name of the BFD session.

BfdType

Indicates the type of the BFD session:
  • STATIC: static BFD detection.
  • DYNAMIC: dynamic BFD detection.

NQAAdminName

Indicates the administrator of an NQA test instance.

NQATestName

Indicates the name of an NQA test instance.

NQADetect

Indicates the result of the NQA detection:
  • Disable: indicates that the NQA detection is not enabled.
  • UP: indicates that the result of detection is up, the routing entry can be delivered.
  • DOWN: indicates that the result of detection is down, the routing entry cannot be delivered.
  • UNKNOWN: indicates that the result of detection is unkown, the routing entry can be delivered.

Label

Indicates the label.

EFMDetect

Indicates the EFM detection result:
  • Disable: indicates that the EFM detection is not enabled.
  • UP: indicates that the detection result is Up and that routing entries can be delivered.
  • DOWN: indicates that the detection result is Down and that routing entries cannot be delivered.

EfmInterface

Indicates the interface to which EFM is bound.

State

Indicates the route selection result:

  • Active Primary: indicates an active primary route.
  • Active Backup: indicates an active backup route.
  • Inactive Valid: indicates a route that takes part in the route selection but is not preferred.
  • Inactive Invalid: indicates a route that cannot take part in the route selection.

Cost

Indicates the route cost.

IndirectID

Indicates the keyword of indirect next hop.

RelayTunnel

Indicates whether to iterate tunnels.

IIDFlags

Indicates keyword flags of indirect next hop, including BlackHole and GateWay.

RelayDepth

Indicates the iteration depth.

LocalAddress

Indicates the IP address of the local interface. If no IP address is configured for the local interface, this item is displayed as 0.0.0.0. This item is displayed only when the outbound interface of the corresponding route is configured.

RemoteIp

Indicates the IP address of the remote P2P interface. If no IP address is configured for the remote P2P interface, this item is displayed as 0.0.0.0. This item is displayed only when the outbound interface of the corresponding route is configured.

DestVrf

Indicates the name of the VPN instance to which the next hop address belongs. This item is displayed only when the next hop of the corresponding static route is configured but the outbound interface of the route is not configured.

DestTopo

Indicates the name of the destination topology to which the next hop address belongs. This item is displayed only when the next hop of the corresponding static route is configured but the outbound interface of the route is not configured.

RelayNextHop

Indicates the iterated next hop address. If the corresponding static route reaches the next hop through a tunnel, this item is displayed as 0.0.0.0. This item is displayed only when the next hop of the route is configured but the outbound interface of the route is not configured.

RelayInterface

Indicates the name of an iterated outbound interface. If the corresponding static route reaches the next hop through a tunnel, this item is displayed as a tunnel name. This item is displayed only when the next hop of the route is configured but the outbound interface of the route is not configured.

TunnelID

Indicates the ID of a tunnel.

display static-route statistics

Function

The display static-route statistics command displays the maximum number of static routes that can be configured and the number of existing static routes.

Format

display static-route statistics

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To check the maximum number of static routes that can be configured and the number of existing static routes, run the display static-route statistics command.

Example

# Display the maximum number of static routes that can be configured and the number of existing static routes.

<HUAWEI> display static-route statistics
--------------------------------------------------------------------------------
Max IPv4 route number                : 100000
Max IPv6 route number                : 100000
Current configured IPv4 route number : 1
Current configured IPv6 route number : 0
Table 9-4  Description of the display static-route statistics command output

Item

Description

Max IPv4 route number

Maximum number of static IPv4 routes that can be configured

Max IPv6 route number

Maximum number of static IPv6 routes that can be configured

Current configured IPv4 route number

Number of existing static IPv4 routes

Current configured IPv6 route number

Number of existing static IPv6 routes

ip route recursive-lookup bgp-vpnv4-route

Function

The ip route recursive-lookup bgp-vpnv4-route enable command enables a static route to be iterated to a cross route on the remote VPN.

The ip route recursive-lookup bgp-vpnv4-route disable command disables a static route from being iterated to a cross route on the remote VPN.

The undo ip route recursive-lookup bgp-vpnv4-route disable command enables a static route to be iterated to a cross route on the remote VPN.

By default, a static route can be iterated to a cross route on the remote VPN.

NOTE:

The CE6810LI does not support this command.

Format

ip route recursive-lookup bgp-vpnv4-route { enable | disable }

undo ip route recursive-lookup bgp-vpnv4-route disable

Parameters

Parameter Description Value
enable Enables a static route to be iterated to a cross route on the remote VPN. -
disable Disables a static route from being iterated to a cross route on the remote VPN. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A static route needs to be iterated if its next hop is not directly reachable. You can run the ip route recursive-lookup bgp-vpnv4-route enable command to enable the static route to be iterated to a cross route on the remote VPN. Then the static route can inherit the Label and Token information about the cross route. The device can forward data through the tunnel to which the static route is iterated.

Precautions

The ip route recursive-lookup bgp-vpnv4-route enable command and the undo ip route recursive-lookup bgp-vpnv4-route disable command have the same function and do not generate the configuration in the configuration file.

Example

# Enable a static route to be iterated to a cross route on the remote VPN.

<HUAWEI> system-view
[~HUAWEI] ip route recursive-lookup bgp-vpnv4-route enable

# Disable a static route from being iterated to a cross route on the remote VPN.

<HUAWEI> system-view
[~HUAWEI] ip route recursive-lookup bgp-vpnv4-route disable

# Enable a static route to be iterated to a cross route on the remote VPN.

<HUAWEI> system-view
[~HUAWEI] undo ip route recursive-lookup bgp-vpnv4-route disable

ip route-static

Function

The ip route-static command configures a unicast static route.

The undo ip route-static command deletes a unicast static route.

By default, the system does not configure IPv4 unicast static routes.

Format

On the CE6810LI:

ip route-static ip-address { mask | mask-length } { nexthop-address | interface-type interface-number [ nexthop-address ] | vpn-instance vpn-instance-name nexthop-address } [ preference preference | tag tag ] * [ description text ]

undo ip route-static ip-address { mask | mask-length } [ nexthop-address | interface-type interface-number [ nexthop-address ] | vpn-instance vpn-instance-name [ nexthop-address ] ]

undo ip route-static all

On the switches except CE6810LI:

ip route-static ip-address { mask | mask-length } { nexthop-address | vpn-instance vpn-instance-name nexthop-address } [ recursive-lookup host-route [ arp-vlink-only ] ] [ preference preference | tag tag ] * [ bfd enable | track { bfd-session cfg-name | nqa admin-name test-name } | inherit-cost | permanent ] [ description text ]

ip route-static ip-address { mask | mask-length } interface-type interface-number [ nexthop-address ] [ preference preference | tag tag ] * [ bfd enable | track { bfd-session cfg-name | nqa admin-name test-name } | permanent ] [ description text ]

undo ip route-static ip-address { mask | mask-length } { nexthop-address | vpn-instance vpn-instance-name nexthop-address } [ inherit-cost ]

undo ip route-static ip-address { mask | mask-length } [ interface-type interface-number [ nexthop-address ] ]

undo ip route-static [ track bfd-session ] all

Parameters

Parameter Description Value
ip-address Specifies a destination IP address. The value is in dotted decimal notation.
mask Specifies the subnet mask. The value is in dotted decimal notation.
mask-length Specifies the mask length. As 1s in a 32-bit mask must be consecutive, the mask in dotted decimal notation can be replaced by the mask length. The value is an integer that ranges from 0 to 32.
nexthop-address Specifies the next-hop address. The value is in dotted decimal notation.
interface-type interface-number Specifies the type and number of the interface that forwards packets. -
vpn-instance vpn-instance-name Specifies the name of a VPN instance. If the VPN instance name is specified, a static route searches the routing table of the VPN instance for an outbound interface according to nexthop-address. The VPN must already exist.
recursive-lookup host-route Specifies static routes to iterate to host routes. -
arp-vlink-only Specifies static routes to iterates to an ARP Vlink route. -
preference preference Specifies the preference of a static route. A smaller value indicates a higher preference. The value is an integer that ranges from 1 to 255. The default value is 60.
tag tag Specifies the tag value of a static route. By configuring different tag values, you can classify static routes to implement different routing policies. For example, other routing protocols can import static routes with specified tag values through routing policies. The value is an integer that ranges from 1 to 4294967295. The default value is 0.
bfd enable Binds a dynamic BFD session to static routes to fast detect faults. -
track bfd-session cfg-name Binds a static BFD session to static routes to fast detect faults. cfg-name must already exist.
track nqa admin-name test-name Specifies the administrator name of an NQA test instance bound to a static route and the name of the test instance. admin-name must already exist.
permanent

Configures permanent advertisement of static routes.

-
inherit-cost Configures static routes to inherit the cost of iterated routes. -
description text Configures the description of a static route. The value is a string of 1 to 35 characters that can contain spaces.
all Deletes all IPv4 unicast static routes. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a simple network, you only need to configure static routes to ensure that the network runs properly. When the switch cannot use dynamic routing protocols or establish a route to the destination network, configure static routes.

  • After recursive-lookup host-route is configured, static routes can be iterated only to 32-bit host routes.
  • If recursive-lookup host-route arp-vlink-only is configured, the static route can be iterated only to an ARP Vlink route.

  • You can configure track bfd-session cfg-name to bind Bidirectional Forwarding Detection (BFD) sessions to static routes. BFD sessions can detect the link status, which provides the detection mechanism for static routes.

    NOTE:

    The undo command with track bfd-session cfg-name specified can only unbind the static route from the current BFD session and cannot delete the static route.

  • After track nqa admin-name test-name is configured, the system determines whether to activate a static route according to the NQA test result. This helps control the advertisement of static routes, and traffic can be forwarded over an available path. This command can be used only on devices on IPv4 networks.

  • You can specify inherit-cost so that static routes inherit the cost of iterated routes.
    NOTE:
    If you have specified an outbound interface for a static route, you can no longer specify inherit-cost for the static route.
  • If service traffic needs to be forwarded along a specified path, regardless of the link status. you can configure permanent advertisement of static routes by using permanent.

  • You can configure the description text parameter to add the description of static routes so that the administrator can check and maintain static routes easily. You can run the display this command in the system view or run the display current-configuration command to view the descriptions of static routes.

Precautions

When configuring unicast static routes, note the following:

  • Only public routes can be used for tunnel iteration.

  • If no preference is configured for a static route, the static route uses the default preference 60.

  • When both the destination IP address and the mask are set to 0.0.0.0, a default route is configured. If the switch cannot find a route in the routing table to forward packets, the switch uses the default route to forward packets.

  • Setting different preferences can implement different routing management policies. For example, if multiple routes to the same destination are configured with the same preference, load balancing can be implemented. If multiple routes to the same destination are configured with different preferences, route backup can be implemented.

  • When configuring static routes, you can specify outbound interfaces or next-hop addresses based on the outbound interface type. For example, you can specify only outbound interfaces for static routes on P2P interfaces and specify only next hops for static routes on NBMA interfaces, and you must specify next hops for static routes on broadcast interfaces.

  • In some cases, for example, the link layer protocol is PPP and the peer IP address is unknown, you can also specify outbound interfaces when configuring a switch. In this manner, you do not need to modify the switch configuration when the peer IP address changes.

  • If the outbound interface and next-hop IP address configured for a static route do not reside on the same network segment, traffic may fail to be forwarded.

  • If the IP address of the outbound interface configured for a static route is changed and the new IP address resides on a network segment different from that of the static route's next-hop IP address, traffic may fail to be forwarded.

  • To configure the function of iterating static routes only to ARP Vlink direct routes, the function that allows static routes to be iterated to ARP Vlink direct routes must also be enabled globally using the ip route recursive-lookup arp vlink-direct-route protocol static command.

  • The following routes are black-hole routes:
    • Static routes with null0 as the outbound interface
    • Static routes that are iterated to black-hole routes
  • If the undo ip route-static all command is run, all static route configurations on the public network are deleted. Therefore, exercise caution when running the command.

Example

# Set the next-hop address of the default route to 172.16.0.1.

<HUAWEI> system-view
[~HUAWEI] ip route-static 0.0.0.0 0.0.0.0 172.16.0.1

ip route-static bfd

Function

The ip route-static bfd command sets BFD parameters of a static route.

The undo ip route-static bfd command deletes BFD parameters of a specified static route.

By default, no BFD parameter is set for a static route.

NOTE:

The CE6810LI does not support this command.

Format

ip route-static bfd interface-type interface-number nexthop-address [ local-address address ] [ min-rx-interval min-rx-interval | min-tx-interval min-tx-interval | detect-multiplier multiplier ] *

ip route-static bfd [ vpn-instance vpn-instance-name ] nexthop-address local-address address [ min-rx-interval min-rx-interval | min-tx-interval min-tx-interval | detect-multiplier multiplier ] *

undo ip route-static bfd [ interface-type interface-number | vpn-instance vpn-instance-name ] nexthop-address

Parameters

Parameter Description Value
interface-type interface-number Specifies the type and number of the outbound interface of a static route. -
nexthop-address Specifies the next-hop address. The value is in dotted decimal notation.
local-address address Specifies the local address. The value is in dotted decimal notation.
min-rx-interval min-rx-interval Specifies the minimum interval for receiving BFD packets.

The value is an integer. The value ranges from 3 to 1000 on the CE6880EI and 50 to 1000 on other models. The value is expressed in milliseconds. The default value is 1000 ms.

min-tx-interval min-tx-interval Specifies the minimum interval for sending BFD packets.

The value is an integer. The value ranges from 3 to 1000 on the CE6880EI and 50 to 1000 on other models. The value is expressed in milliseconds. The default value is 1000 ms.

detect-multiplier multiplier Specifies the detection multiplier. The value is an integer that ranges from 3 to 50. The default value is 3.
vpn-instance vpn-instance-name Specifies the name of the VPN instance to which the next hop belongs. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can use the ip route-static bfd command to configure a different BFD detection time than the global one for a static route. The formula for calculating the BFD detection time is as follows:

BFD detection time = detect-multiplier x max (min-rx-interval, min-tx-interval)

In the formula, parameters detect-multiplier and min-tx-interval are set on the peer end, and the parameter min-rx-interval is set on the local end.

Configuration Impact

To modify BFD parameters, you need to update BFD parameters of all the corresponding static routes.

If BFD parameters are configured, but the local-address address parameter is not, BFD sessions may fail to be negotiated.

If the undo ip route-static bfd command is run, the static route is unbound from all BFD sessions. Therefore, exercise caution when running the command.

Precautions

If min-rx-interval, min-tx-interval, and detect-multiplier are not set, default values of global BFD parameters are used.

When the type and number of the outbound interface of a static route are specified, and the VPN instance name is specified, a static route searches the routing table of the VPN instance for an outbound interface according to nexthop-address. Run the ip route-static vpn-instance vpn-source-name destination-address { mask | mask-length } interface-type interface-number [ nexthop-address ] [ preference preference | tag tag ] * bfd enable [ description text ] command to bind a dynamic BFD session to static routes.

Example

# Set the next-hop address to 10.1.1.1, local address to 192.168.1.1.

<HUAWEI> system-view
[~HUAWEI] ip route-static bfd 10.1.1.1 local-address 192.168.1.1

ip route-static default-bfd

Function

The ip route-static default-bfd command sets global default BFD parameters for static routes.

The undo ip route-static default-bfd command restores default values of global BFD parameters of static routes.

By default, the minimum interval for receiving BFD packets is 1000 ms, the minimum interval for sending BFD packets is 1000 ms, and the detection multiplier is 3.

NOTE:

The CE6810LI does not support this command.

Format

ip route-static default-bfd { min-rx-interval min-rx-interval | min-tx-interval min-tx-interval | detect-multiplier multiplier } *

undo ip route-static default-bfd

Parameters

Parameter Description Value
detect-multiplier multiplier Specifies the detection multiplier. The value is an integer that ranges from 3 to 50. The default value is 3.
min-rx-interval min-rx-interval Specifies the minimum interval for receiving BFD packets.

The value is an integer. The value ranges from 3 to 1000 on the CE6880EI and 50 to 1000 on other models. The value is expressed in milliseconds. The default value is 1000 ms.

min-tx-interval min-tx-interval Specifies the minimum interval for sending BFD packets.

The value is an integer. The value ranges from 3 to 1000 on the CE6880EI and 50 to 1000 on other models. The value is expressed in milliseconds. The default value is 1000 ms.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If BFD parameters min-rx-interval, min-tx-interval, and detect-multiplier are not specified for a static route, default values of global BFD parameters are used to determine the BFD detection time. The formula for calculating the BFD detection time is as follows:

BFD detection time = detect-multiplier x max (min-rx-interval, min-tx-interval)

In the formula, parameters detect-multiplier and min-tx-interval are set on the peer end, and the parameter min-rx-interval is set on the local end.

Precautions

After the values of global BFD parameters are changed, the values of BFD parameters for all the static routes bound to BFD sessions that use default BFD parameters are also changed.

Example

# Set both the minimum interval for sending BFD packets and the minimum interval for receiving BFD packets to 300 ms and the local detection multiplier to 5 for a static route.

<HUAWEI> system-view
[~HUAWEI] ip route-static default-bfd min-rx-interval 500 min-tx-interval 500 detect-multiplier 4

ip route-static default-preference

Function

The ip route-static default-preference command sets the default preference for IPv4 static routes.

The undo ip route-static default-preference command restores the default preference value of IPv4 static routes.

By default, the default preference of IPv4 static routes is 60.

Format

ip route-static default-preference preference

undo ip route-static default-preference

Parameters

Parameter Description Value
preference Specifies the default preference for IPv4 static routes. A smaller value indicates a higher preference. The value is an integer that ranges from 1 to 255.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

You can change the preference of a static route to change the status of the route. To change the default preference of a new IPv4 static route, run the ip route-static default-preference command.

Example

# Set the default preference of IPv4 static routes to 70.

<HUAWEI> system-view
[~HUAWEI] ip route-static default-preference 70

ip route-static frr

Function

The ip route-static frr command enables FRR for an IPv4 static route.

The undo ip route-static frr command disables FRR for an IPv4 static route.

By default, FRR is disabled for an IPv4 static route.

NOTE:

The CE6810LI does not support this command.

Format

ip route-static frr [ vpn-instance vpn-instance-name ]

undo ip route-static frr [ vpn-instance vpn-instance-name ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies the name of a VPN instance. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To protect IPv4 static routes, configure FRR for IPv4 static routes when configuring link protection.

If the name of a VPN instance is specified, FRR is enabled for IPv4 static routes of the VPN instance.

Prerequisites

A VPN instance has been configured before FRR is enabled on a private network.

Precautions

Enabling or disabling FRR takes effect for all the static routes in the VPN instance.

Example

# Enable FRR for static routes.

<HUAWEI> system-view
[~HUAWEI] ip route-static frr

ip route-static selection-rule compare-inherit-cost

Function

The ip route-static selection-rule compare-inherit-cost command enables a device to compare the costs of inherited routes during static route selection.

The undo ip route-static selection-rule compare-inherit-cost command restores the default configuration.

By default, the device is disabled from comparing the costs of inherited routes during static route selection.

NOTE:
The CE6810LI does not support this command.

Format

ip route-static selection-rule compare-inherit-cost

undo ip route-static selection-rule compare-inherit-cost

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

By default, the device does not compare the costs of inherited routes during static route selection, and static routes with different costs work in load-balancing mode. To enable the device to compare the costs of inherited routes and only select the static route with the smallest cost, run the ip route-static selection-rule compare-inherit-cost command.

Example

# Enable the device to compare the costs of inherited routes during static route selection.

<HUAWEI> system-view
[~HUAWEI] ip route-static selection-rule compare-inherit-cost

ip route-static selection-rule relay-depth

Function

The ip route-static selection-rule relay-depth command enables static routes to be selected based on the iteration depth.

The undo ip route-static selection-rule relay-depth command disables static routes from being selected based on the iteration depth.

By default, static routes are not selected based on the iteration depth.

Format

ip route-static selection-rule relay-depth

undo ip route-static selection-rule relay-depth

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To prevent a loop when GGSN services are forwarded between boards, use the ip route-static selection-rule relay-depth command to enable static routes to be selected based on the iteration depth.

Precautions

In the system, some static routes have the same prefix and preference but different iteration depths. After the system enables static routes to be selected based on the iteration depth, the static route module selects the static route with the smallest iteration depth as the active route and delivers it to the FIB table. Other static routes then become inactive.

Example

# Enable static routes to be selected based on the iteration depth.

<HUAWEI> system-view
[~HUAWEI] ip route-static selection-rule relay-depth

ip route-static vpn-instance

Function

The ip route-static vpn-instance command configures static routes for a VPN instance.

The undo ip route-static vpn-instance command deletes static routes for a VPN instance.

By default, no static route is configured for a VPN instance.

Format

On the CE6810LI switch:

ip route-static vpn-instance vpn-source-name destination-address { mask | mask-length } { nexthop-address [ public ] | interface-type interface-number [ nexthop-address ] | vpn-instance vpn-destination-name nexthop-address } [ preference preference | tag tag ] * [ description text ]

undo ip route-static vpn-instance vpn-source-name destination-address { mask | mask-length } [ nexthop-address [ public ] | interface-type interface-number [ nexthop-address ] | vpn-instance vpn-destination-name [ nexthop-address ] | public ]

undo ip route-static vpn-instance vpn-source-name all

On the switches except CE6810LI:

ip route-static vpn-instance vpn-source-name destination-address { mask | mask-length } interface-type interface-number [ nexthop-address ] [ preference preference | tag tag ] * [ bfd enable | track { bfd-session cfg-name | nqa admin-name test-name } | permanent ] [ description text ]

ip route-static vpn-instance vpn-source-name destination-address { mask | mask-length } { vpn-instance vpn-destination-name nexthop-address | nexthop-address [ public ] } [ recursive-lookup host-route [ arp-vlink-only ] ] [ preference preference | tag tag ] * [ bfd enable | track { bfd-session cfg-name | nqa admin-name test-name } | inherit-cost | permanent ] [ description text ]

undo ip route-static vpn-instance vpn-source-name destination-address { mask | mask-length } [ interface-type interface-number [ nexthop-address ] ]

undo ip route-static vpn-instance vpn-source-name destination-address { mask | mask-length } [ nexthop-address [ public ] [ inherit-cost ] ]

undo ip route-static vpn-instance vpn-source-name destination-address { mask | mask-length } [ vpn-instance vpn-destination-name nexthop-address [ inherit-cost ] ]

undo ip route-static vpn-instance vpn-source-name all

Parameters

Parameter Description Value
vpn-source-name Specifies the name of the source VPN instance. Each VPN instance has its own routing table. The configured static routes are added to the routing table of the specified VPN instance. The VPN must already exist.
destination-address Specifies the destination IP address of a static route. The value is in dotted decimal notation.
mask Specifies the subnet mask of the destination IP address. The value is in dotted decimal notation.
mask-length Specifies the mask length of the destination IP address. The value is an integer that ranges from 0 to 32.
interface-type interface-number Specifies the type and number of the outbound interface of a static route. -
nexthop-address Specifies the next-hop address of a static route. If the outbound interface of a static route is a broadcast interface, the next-hop address must be specified for the static route. The value is in dotted decimal notation.
public Specifies the next-hop address as a public network address but not an address in the source VPN instance. -
recursive-lookup host-route Specifies static routes to iterate to host routes. -
arp-vlink-only Specifies static routes to iterates to an ARP Vlink route. -
preference preference Specifies the preference of a static route. The value is an integer that ranges from 1 to 255. If this parameter is not specified, the default preference of a static route is 60.
tag tag Specifies the tag value of a static route. By configuring different tag values, you can classify static routes to implement different routing policies. For example, other routing protocols can import static routes with specified tag values through routing policies. The value is an integer that ranges from 1 to 4294967295. The default value is 0.
bfd enable Binds a dynamic BFD session to static routes to fast detect faults. -
track bfd-session cfg-name Binds a static BFD session to static routes to fast detect faults. cfg-name is a string of 1 to 15 characters without spaces.
track nqa admin-name test-name Specifies the administrator name of an NQA test instance bound to a static route and the name of the test instance. The values of admin-name and test-name are both a string of 1 to 32 case-sensitive characters without spaces.
permanent

Configures permanent advertisement of static routes.

-
inherit-cost Configures static routes to inherit the cost of iterated routes. -
description text Specifies the description of a static route. You can specify description to add the description of static routes, facilitating static route query and maintenance. The value is a string of 1 to 35 characters that can contain spaces.
vpn-instance vpn-destination-name Specifies the name of the destination VPN instance. The VPN must already exist.
all Deletes all static routes of a VPN instance. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a simple IPv4 VPN, the ip route-static vpn-instance command can be used to configure static routes for this VPN.
  • After recursive-lookup host-route is configured, static routes can be iterated only to 32-bit host routes.
  • If recursive-lookup host-route arp-vlink-only is configured, the static route can be iterated only to an ARP Vlink route.

  • You can specify track bfd-session cfg-name to bind a static route to a BFD session. A router uses BFD sessions to detect link status, which provides a detection mechanism for static routes.
    NOTE:

    The undo command with track bfd-session bfd-name specified can only unbind the static route from the current BFD session and cannot delete the static route.

  • If you specify track nqa admin-name test-name, the system determines whether to activate static routes based on the NQA test result and controls route advertisement.
  • You can specify inherit-cost so that static routes inherit the cost of iterated routes.
    NOTE:
    If you have specified an outbound interface for a static route, you can no longer specify inherit-cost for the static route.
  • If service traffic needs to be forwarded along a specified path, regardless of the link status, configure permanent advertisement of static routes by using permanent.

  • You can configure description text to add the description of static routes so that the administrator can query and maintain static routes easily. To view the description of static routes, run the display this command in the system view or run the display current-configuration command.

Follow-up Procedure

After a static route is configured, import the static route to BGP running between PEs if the static route needs to be sent to the peer PE.

Precautions

  • During the configuration of a static route for a VPN instance, the next-hop address can belong to the VPN instance or a public network. When the next-hop address of the static route is a public network address, specify public following nexthop-address.

  • If the outbound interface of a static route is a broadcast interface, you must specify the next-hop address for the static route.

  • If a next-hop outbound interface is specified for a static route to implement inter-VPN communication, and only the outbound interface bound to the destination VPN instance is specified, the peer device cannot ping the address of this outbound interface based on the static route information.

  • If the undo ip route-static vpn-instance command is run, all static route configurations in the specified VPN instance are deleted. Therefore, exercise caution when running the command.

Example

# Configure a static route for the VPN instance named vpn1, and set the destination address of the static route to 10.1.1.0/24 and next-hop address to 192.168.1.2 (IP address of VPN instance vpn2).

<HUAWEI> system-view
[~HUAWEI] ip vpn-instance vpn1
[*HUAWEI-vpn-instance-vpn1] route-distinguisher 100:200
[*HUAWEI-vpn-instance-vpn1-af-ipv4] quit
[*HUAWEI-vpn-instance-vpn1] quit
[*HUAWEI] ip vpn-instance vpn2
[*HUAWEI-vpn-instance-vpn2] route-distinguisher 300:400
[*HUAWEI-vpn-instance-vpn2-af-ipv4] quit
[*HUAWEI-vpn-instance-vpn2] quit
[*HUAWEI] ip route-static vpn-instance vpn1 10.1.1.0 24 vpn-instance vpn2 192.168.1.2

ipv6 route-static

Function

The ipv6 route-static command configures IPv6 static routes.

The undo ipv6 route-static command deletes configured static routes.

By default, no IPv6 static route is configured.

Format

On the CE6810LI:

ipv6 route-static dest-ipv6-address prefix-length { interface-type interface-number [ nexthop-ipv6-address ] | vpn-instance vpn-instance-name nexthop-ipv6-address | nexthop-ipv6-address } [ preference preference | tag tag ] * [ description text ]

undo ipv6 route-static all

undo ipv6 route-static dest-ipv6-address prefix-length [ interface-type interface-number [ nexthop-ipv6-address ] | vpn-instance vpn-instance-name nexthop-ipv6-address | nexthop-ipv6-address ]

On the devices except CE6810LI:

ipv6 route-static dest-ipv6-address prefix-length { interface-type interface-number [ nexthop-ipv6-address ] | vpn-instance vpn-instance-name nexthop-ipv6-address | nexthop-ipv6-address } [ preference preference | tag tag ] * [ bfd enable | track { bfd-session cfg-name | nqa admin-name test-name } ] [ description text ]

ipv6 route-static dest-ipv6-address prefix-length [ vpn-instance vpn-instance-name ] nexthop-ipv6-address [ preference preference | tag tag ] * inherit-cost [ description text ]

undo ipv6 route-static [ track bfd-session ] all

undo ipv6 route-static dest-ipv6-address prefix-length [ interface-type interface-number [ nexthop-ipv6-address ] | vpn-instance vpn-instance-name nexthop-ipv6-address | nexthop-ipv6-address ]

Parameters

Parameter Description Value
dest-ipv6-address Specifies the destination IPv6 address. The value is a 32-bit hexadecimal number, in X:X:X:X:X:X:X:X format.
prefix-length Specifies the length of an IPv6 prefix, namely, the number of consecutive 1s in the mask. The value is an integer that ranges from 0 to 128.
interface-type interface-number Specifies the type and number of an outbound interface. -
vpn-instance vpn-instance-name Specifies the name of a VPN instance. If the VPN instance name is specified, the system searches the routing table of the VPN instance for the outbound interface of a static route according to the configured next-hop address. The value is the name of an existing VPN instance.
nexthop-ipv6-address Specifies the next-hop IPv6 address The value is a 32-bit hexadecimal number, in X:X:X:X:X:X:X:X format.
preference preference Specifies the preference of an IPv6 static route. The value is an integer that ranges from 1 to 255. The default value is 60.
tag tag Specifies the tag value of a static route. By configuring different tag values, you can classify static routes to implement different routing policies. For example, other routing protocols can import static routes with specified tag values through routing policies. The value is an integer that ranges from 1 to 4294967295. The default value is 0.
bfd enable Binds a dynamic BFD session to static routes to fast detect faults. -
track bfd-session cfg-name Binds a static BFD session to static routes to fast detect faults. cfg-name is a string of 1 to 15 characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.
track nqa admin-name test-name Associates a static route with an NQA test instance to rapidly detect faults. admin-name or test-name is a string of 1 to 32 case-sensitive characters.
description text Specifies the description of a static route. The value is a string of 1 to 35 characters that can contain spaces.
all Deletes all IPv6 static routes. -
inherit-cost Enables a static route to inherit the cost of iterated routes. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a simple network, you only need to configure static routes to ensure that the network runs properly. When the router cannot use dynamic routing protocols or establish a route to the destination network, configure static routes on the router.

You can configure description text to add the description of static routes so that the administrator can query and maintain static routes easily. To view the description of static routes, run the display this command in the system view or run the display current-configuration command.

Precautions

When configuring unicast static routes, note the following:

  • If no preference is set for a static route, the static route uses the default preference 60.

  • If the destination address and mask of a static route are all 0s, the static route is a default route.

  • Before configuring IPv6 routes with prefixes longer than 64 bits on a switch, run the assign forward ipv6 longer-mask resource command to specify the number of IPv6 addresses and routes with prefixes longer than 64 bits supported by the switch.

  • If the undo ipv6 route-static all command is run, all static route configurations on the public network are deleted. Therefore, exercise caution when running the command.

Example

# Configure IPv6 static routes on the public network.

<HUAWEI> system-view
[~HUAWEI] ipv6 route-static fc00:0:0:2001::1 128 fc00:0:0:2002::2

ipv6 route-static default-preference

Function

The ipv6 route-static default-preference command sets the default preference for IPv6 static routes.

The undo ipv6 route-static default-preference command restores the default preference of IPv6 static routes.

By default, the default preference of IPv6 static routes is 60.

Format

ipv6 route-static default-preference preference

undo ipv6 route-static default-preference

Parameters

Parameter Description Value
preference Specifies the default preference of IPv6 static routes. A smaller value indicates a higher preference. The value is an integer that ranges from 1 to 255.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can change the preference of a static route to change the status of the route. To change the default preference of a new IPv6 static route, run the ipv6 route-static default-preference command.

Configuration Impact

After the ipv6 route-static default-preference command is used, the default preference of all the new IPv6 static routes is changed.

After a new default preference is specified, the new default preference is valid only for new IPv6 static routes but not for existing IPv6 static routes.

Example

# Set the default preference of IPv6 static routes to 70.

<HUAWEI> system-view
[~HUAWEI] ipv6 route-static default-preference 70

ipv6 route-static bfd

Function

The ipv6 route-static bfd command sets BFD parameters for an IPv6 static route.

The undo ipv6 route-static bfd command deletes BFD parameters of an IPv6 static route.

By default, no BFD parameter is set for an IPv6 static route.

NOTE:

The CE6810LI does not support this command.

Format

ipv6 route-static bfd interface-type interface-number nexthop-address [ local-address ipv6-address ] [ detect-multiplier multiplier | min-rx-interval min-rx-interval | min-tx-interval min-tx-interval ] *

ipv6 route-static bfd [ vpn-instance vpn-instance-name ] nexthop-address local-address ipv6-address [ detect-multiplier multiplier | min-rx-interval min-rx-interval | min-tx-interval min-tx-interval ] *

undo ipv6 route-static bfd [ interface-type interface-number | vpn-instance vpn-instance-name ] nexthop-address

Parameters

Parameter Description Value
interface-type interface-number Specifies the type and number of an interface. -
nexthop-address Specifies a next-hop IPv6 address. The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.
local-address ipv6-address Specifies the local IPv6 address. The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.
detect-multiplier multiplier Specifies the detection multiplier. The value is an integer that ranges from 3 to 50. The default value is 3.
min-rx-interval min-rx-interval Specifies the minimum interval for receiving BFD control packets.

The value is an integer. The value ranges from 3 to 1000 on the CE6880EI and 50 to 1000 on other models. The value is expressed in milliseconds. The default value is 1000 ms.

min-tx-interval min-tx-interval Specifies the minimum interval for sending BFD control packets.

The value is an integer. The value ranges from 3 to 1000 on the CE6880EI and 50 to 1000 on other models. The value is expressed in milliseconds. The default value is 1000 ms.

vpn-instance vpn-instance-name Specifies the name of the VPN instance to which the next hop address belongs. The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the ipv6 route-static bfd command to set BFD parameters for an IPv6 static route.

Procedure

When setting BFD parameters for an IPv6 static route in the system view, you need to specify the outbound interface or the next hop of the IPv6 static route.

Configuration Impact

When modifying BFD parameters of a static route, update the BFD parameters of all IPv6 static routes.

If the undo ipv6 route-static bfd command is run, the static route is unbound from all BFD sessions. Therefore, exercise caution when running the command.

Precautions

  1. When configuring BFD for an IPv6 static route, check whether BFD parameters are set for the IPv6 static route.

  2. Search for BFD parameters of an IPv6 static route based on the outbound interface, next-hop address, or the IPv6 address family-enabled VPN instance to which the next-hop address of the route belongs.

  3. If none of min-rx-interval, min-tx-interval, and detect-multiplier is specified, the default values of global BFD parameters are used.

Example

# Configure BFD parameters for a static route: set the next-hop address to fc00:0:0:2000::1, and local address to fc00:0:0:3111::1.

<HUAWEI> system-view
[~HUAWEI] ipv6 route-static bfd fc00:0:0:2000::1 local-address fc00:0:0:3111::1

ipv6 route-static default-bfd

Function

The ipv6 route-static default-bfd command configures global default BFD parameters for an IPv6 static route.

The undo ipv6 route-static default-bfd command cancels the global default BFD parameters configured for an IPv6 static route.

By default, the minimum interval for receiving BFD packets is 1000 ms, the minimum interval for sending BFD packets is 1000 ms, and the detection multiplier is 3.

NOTE:

The CE6810LI does not support this command.

Format

ipv6 route-static default-bfd { min-rx-interval min-rx-interval | min-tx-interval min-tx-interval | detect-multiplier multiplier }*

undo ipv6 route-static default-bfd

Parameters

Parameter Description Value
detect-multiplier multiplier Specifies the detection multiplier. The value is an integer that ranges from 3 to 50. The default value is 3.
min-rx-interval min-rx-interval Specifies the minimum interval for receiving BFD packets.

The value is an integer. The value ranges from 3 to 1000 on the CE6880EI and 50 to 1000 on other models. The value is expressed in milliseconds. The default value is 1000 ms.

min-tx-interval min-tx-interval Specifies the minimum interval for sending BFD packets.

The value is an integer. The value ranges from 3 to 1000 on the CE6880EI and 50 to 1000 on other models. The value is expressed in milliseconds. The default value is 1000 ms.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the ipv6 route-static default-bfd command is used, global default BFD parameters are configured for an IPv6 static route that has no BFD parameter configured.

Configuration Impact

BFD parameters detect-multiplier multiplier, min-rx-interval min-rx-interval, and min-tx-interval min-tx-interval are independent of each other. If the ipv6 route-static bfd command changes only one of the three BFD parameters, the other two parameters still use their default values.

Precautions

After global default BFD parameters are modified, BFD parameters of all IPv6 static routes bound to BFD sessions that use default BFD parameters are also modified.

Example

# Set the global minimum interval for receiving BFD packets to 100 ms for IPv6 static routes.

<HUAWEI> system-view
[~HUAWEI] ipv6 route-static default-bfd min-rx-interval 100

ipv6 route-static frr

Function

The ipv6 route-static frr command enables FRR for IPv6 static routes.

The undo ipv6 route-static frr command disables FRR for IPv6 static routes.

By default, FRR is disabled for IPv6 static routes.

NOTE:

The CE6810LI does not support this command.

Format

ipv6 route-static frr

undo ipv6 route-static frr

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To protect IPv6 static routes, run the ipv6 route-static frr command to configure FRR for IPv6 static routes.

If the name of a VPN instance is specified, FRR is enabled for the static routes of the VPN instance.

Prerequisites

A VPN instance has been configured if you want to configure FRR for the VPN.

Configuration Impact

Enabling or disabling FRR takes effect on all the static routes in the VPN instance.

Example

# Enable FRR for IPv6 static routes.

<HUAWEI> system-view
[~HUAWEI] ipv6 route-static frr

ipv6 route-static vpn-instance

Function

The ipv6 route-static vpn-instance command configures IPv6 static routes in a VPN instance.

The undo ipv6 route-static vpn-instance command withdraws IPv6 static routes in a VPN instance.

By default, the system does not configure IPv6 static routes for VPN instances.

Format

On the device of CE6810LI:

ipv6 route-static vpn-instance vpn-source-name dest-ipv6-address prefix-length { interface-type interface-number [ nexthop-ipv6-address ] | vpn-instance vpn-destination-name nexthop-ipv6-address | nexthop-ipv6-address [ public ] } [ preference preference | tag tag ] * [ description text ]

undo ipv6 route-static vpn-instance vpn-source-name dest-ipv6-address prefix-length [ interface-type interface-number [ nexthop-ipv6-address ] | vpn-instance vpn-destination-name nexthop-ipv6-address | nexthop-ipv6-address [ public ] ]

undo ipv6 route-static vpn-instance vpn-destination-name all

On the devices except CE6810LI:

ipv6 route-static vpn-instance vpn-source-name dest-ipv6-address prefix-length { interface-type interface-number [ nexthop-ipv6-address ] | vpn-instance vpn-destination-name nexthop-ipv6-address | nexthop-ipv6-address [ public ] } [ preference preference | tag tag ] * [ bfd enable | track { bfd-session cfg-name | nqa admin-name test-name } ] [ description text ]

ipv6 route-static vpn-instance vpn-source-name dest-ipv6-address prefix-length { vpn-instance vpn-destination-name nexthop-ipv6-address | nexthop-ipv6-address [ public ] } [ preference preference | tag tag ] * inherit-cost [ description text ]

undo ipv6 route-static vpn-instance vpn-source-name dest-ipv6-address prefix-length [ interface-type interface-number [ nexthop-ipv6-address ] | vpn-instance vpn-destination-name nexthop-ipv6-address | nexthop-ipv6-address [ public ] ]

undo ipv6 route-static vpn-instance vpn-destination-name all

Parameters

Parameter Description Value
dest-ipv6-address Specifies the destination IPv6 address. The value is a 32-bit hexadecimal number, in X:X:X:X:X:X:X:X format.
prefix-length Specifies the length of an IPv6 prefix, namely, the number of consecutive 1s in the mask. The value is an integer that ranges from 0 to 128.
interface-type Specifies the type of an interface. -
interface-number Specifies the number of an interface. -
nexthop-ipv6-address Specifies the next-hop IPv6 address. The value is a 32-bit hexadecimal number, in X:X:X:X:X:X:X:X format.
vpn-instance vpn-source-name Specifies the name of the source VPN instance. Each VPN instance has its own routing table. The configured static routes are added to the routing table of the specified VPN instance. The VPN must already exist.
vpn-instance vpn-destination-name Specifies the name of the destination VPN instance. If the name of the destination VPN instance is specified, a static route searches the destination VPN instance for an outbound interface based on the configured next-hop address. The VPN must already exist.
public Specifies the next-hop address as a public network address. -
preference preference Specifies the preference of a static route. The value is an integer that ranges from 1 to 255.
tag tag Specifies the tag value of a static route. By configuring different tag values, you can classify static routes to implement different routing policies. For example, other routing protocols can import static routes with specified tag values through routing policies. The value is an integer that ranges from 1 to 4294967295. The default value is 0.
bfd enable Binds a dynamic BFD session to static routes to fast detect faults. -
track bfd-session cfg-name Binds a static BFD session to static routes to fast detect faults. cfg-name is a string of 1 to 15 characters without spaces.
track nqa admin-name test-name Associates a static route with an NQA test instance to rapidly detect faults. admin-name or test-name is a string of 1 to 32 case-sensitive characters.
description text Specifies the description of static routes. The value is a string of 1 to 35 characters that can contain spaces.
inherit-cost Enables a static route to inherit the cost of iterated routes. -
all Deletes all the IPv6 static routes configured for the specified VPN instance. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When an IPv6 VPN network is simple, you can run the ipv6 route-static vpn-instance command to configure static routes for this VPN.
  • To configure VPN users to access a public network, you can perform network address translation (NAT) or run the ipv6 route-static vpn-instance command with the keyword public to configure the VPN route with the next-hop address as the public network address.

  • You can configure description text to add the description of static routes so that the administrator can query and maintain static routes easily. To view the description of static routes, run the display this command in the system view or run the display current-configuration command.

Precautions

  • If the destination address and the prefix length are set to all 0s, a default route is configured.

  • After a network fault occurs or the network topology changes, static routes cannot automatically change. Therefore, configure static routes with caution.

  • If the undo ipv6 route-static vpn-instance command is run, all static route configurations in the specified VPN instance are deleted. Therefore, exercise caution when running the command.

Example

# Configure a default route with next-hop address FC00:0:0:2001::1.

<HUAWEI> system-view
[~HUAWEI] ipv6 route-static vpn-instance vpn1 :: 0 fc00:0:0:2001::1
Related Topics
Translation
Download
Updated: 2019-03-21

Document ID: EDOC1000166501

Views: 49924

Downloads: 336

Average rating:
This Document Applies to these Products
Related Documents
Related Version
Share
Previous Next