Contents

IPv6 static routing commands· 1

delete ipv6 static-routes all 1

display ipv6 route-static nib· 1

display ipv6 route-static routing-table· 6

ipv6 route-static· 8

ipv6 route-static default-preference· 10

ipv6 route-static fast-reroute auto· 11

 

IPv6 static routing commands

delete ipv6 static-routes all

Use delete ipv6 static-routes all to delete all IPv6 static routes.

Syntax

delete ipv6 static-routes all

Views

System view

Predefined user roles

network-admin

Usage guidelines

CAUTION: This command might interrupt network communication and cause packet forwarding failure. Before executing the command, make sure you fully understand the potential impact on the network.

‌

When you use this command, the system will prompt you to confirm the operation before deleting all the IPv6 static routes.

Examples

# Delete all IPv6 static routes.

<Sysname> system-view

[Sysname] delete ipv6 static-routes all

This will erase all IPv6 static routes and their configurations, you must reconfigure all static routes.

Are you sure?[Y/N]:y

Related commands

ipv6 route-static

display ipv6 route-static nib

Use display ipv6 route-static nib to display IPv6 static route next hop information.

Syntax

display ipv6 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, a hexadecimal string in the range of 1 to ffffffff.

verbose: Displays detailed IPv6 static route next hop information. If you do not specify this keyword, the command displays brief IPv6 static route next hop information.

Examples

# Display brief IPv6 static route next hop information.

<Sysname> display ipv6 route-static nib

Total number of nexthop(s): 35

 

      NibID: 0x21000000        Sequence: 0

       Type: 0x41               Flushed: Yes

   UserKey0: 0x0                VrfNthp: 0

   UserKey1: 0x0                Nexthop: 2::3

    IFIndex: 0x0              LocalAddr: ::

     NewUK0: 0x0                 NewUK1: 0x0

     NewUK2: 0x0                 NewUK3: 0x0

     NewUK4: 0x0                 NewUK5: 0x0

     NewUK6: 0x0                 NewUK7: 0x0

   TopoNthp: Invalid            ExtType: 0x0

      Color: 0                   COFlag: 0x0

     LinkID: 0x0

   SIDIndex: 0x0                SRPName:

 OriNexthop: ::

 

      NibID: 0x21000001        Sequence: 1

       Type: 0x41               Flushed: Yes

   UserKey0: 0x0                VrfNthp: 0

   UserKey1: 0x0                Nexthop: 3::4

    IFIndex: 0x0              LocalAddr: ::

     NewUK0: 0x0                 NewUK1: 0x0

     NewUK2: 0x0                 NewUK3: 0x0

     NewUK4: 0x0                 NewUK5: 0x0

     NewUK6: 0x0                 NewUK7: 0x0

   TopoNthp: Invalid            ExtType: 0x0

      Color: 0                   COFlag: 0x0

     LinkID: 0x0

   SIDIndex: 0x0                SRPName:

 OriNexthop: ::

 

...

Table 1 Command output

Field	Description
NibID	ID of the NIB.
Sequence	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	This field is not supported in the current software version. Index of the VPN instance to which the next hop belongs. This field displays 0 if the next hop is on the public network.
Nexthop	Next hop address.
IFIndex	Interface index
LocalAddr	Local interface address.
NewUK0	New reserved data 1.
NewUK1	New reserved data 2.
NewUK2	New reserved data 3.
NewUK3	New reserved data 4.
NewUK4	New reserved data 5.
NewUK5	New reserved data 6.
NewUK6	New reserved data 7.
NewUK7	New reserved data 8.
TopoNthp	This field is not supported in the current software version. Index of the topology that contains the next hop. This field displays 0 if the next hop is on the public network. This field displays Invalid if the next hop is on an IPv6 network, because the router does not support non-base topologies.
ExtType	NIB extension type.
Color	This field is not supported in the current software version. Color extended community attribute.
COFlag	This field is not supported in the current software version. Flag of the color extended community attribute.
LinkID	This field is not supported in the current software version. Link ID of the SDWAN TTE connection.
SIDIndex	This field is not supported in the current software version. SID index value.
SRPName	This field is not supported in the current software version. SR-MPLS TE policy name.
OriNexthop	Original next hop address of the route. If the route is obtained from a BGP UPDATE message, the address is the next hop IP address in the BGP UPDATE message.

 

# Display detailed IPv6 static route next hop information. ‌

<Sysname> display ipv6 route-static nib verbose

Total number of nexthop(s): 35

 

      NibID: 0x21000000        Sequence: 0

       Type: 0x41               Flushed: Yes

   UserKey0: 0x0                VrfNthp: 0

   UserKey1: 0x0                Nexthop: 2::3

    IFIndex: 0x0              LocalAddr: ::

     NewUK0: 0x0                 NewUK1: 0x0

     NewUK2: 0x0                 NewUK3: 0x0

     NewUK4: 0x0                 NewUK5: 0x0

     NewUK6: 0x0                 NewUK7: 0x0

   TopoNthp: Invalid            ExtType: 0x0

      Color: 0                   COFlag: 0x0

     LinkID: 0x0

   SIDIndex: 0x0                SRPName:

 OriNexthop: ::

     RefCnt: 1              FlushRefCnt: 0

       Flag: 0x12               Version: 1

 1 nexthop(s):

PrefixIndex: 0              OrigNexthop: 2::3

  RelyDepth: 2              RealNexthop: ::

  Interface: NULL0            LocalAddr: ::

  TunnelCnt: 0                      Vrf: default-vrf

   TunnelID: N/A               Topology:

     Weight: 0                    Flags: 0x0

SRPolicyNID: 4294967295     SRInterface:

ColorWeight: 0                  Locator: N/A

 OrigLinkID: 0x0             RealLinkID: 0x0

 

      NibID: 0x21000001        Sequence: 1

       Type: 0x41               Flushed: Yes

   UserKey0: 0x0                VrfNthp: 0

   UserKey1: 0x0                Nexthop: 3::4

    IFIndex: 0x0              LocalAddr: ::

     NewUK0: 0x0                 NewUK1: 0x0

     NewUK2: 0x0                 NewUK3: 0x0

     NewUK4: 0x0                 NewUK5: 0x0

     NewUK6: 0x0                 NewUK7: 0x0

   TopoNthp: Invalid            ExtType: 0x0

      Color: 0                   COFlag: 0x0

     LinkID: 0x0

   SIDIndex: 0x0                SRPName:

 OriNexthop: ::

     RefCnt: 1              FlushRefCnt: 0

       Flag: 0x12               Version: 1

 1 nexthop(s):

PrefixIndex: 0              OrigNexthop: 3::4

  RelyDepth: 1              RealNexthop: ::

  Interface: Vlan11           LocalAddr: ::

  TunnelCnt: 0                      Vrf: default-vrf

   TunnelID: N/A               Topology:

     Weight: 0                    Flags: 0x0

SRPolicyNID: 4294967295     SRInterface:

ColorWeight: 0                  Locator: N/A

 OrigLinkID: 0x0             RealLinkID: 0x0

 

...

Table 2 Command output

Field	Description
x nexthop(s)	Number of next hops.
PrefixIndex	Prefix index of the next hop for an ECMP route.
Vrf	This field is not supported in the current software version. VPN instance name. For the public network, this field displays default-vrf.
OrigNexthop	Original next hop.
RealNexthop	Real next hop.
Interface	Output interface.
localAddr	Local interface address.
RelyDepth	Recursion depth.
TunnelCnt	‌ Number of tunnels after route recursion.
TunnelID	‌ ID of the tunnel after route recursion.
Topology	This field is not supported in the current software version. Topology name. This field is blank for IPv6, because IPv6 does not support non-base topologies.
Weight	ECMP route weight. This field displays 0 for non-ECMP routes.
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.
Flags	Flags of the detailed next hop.
SRPolicyNID	This field is not supported in the current software version. NIB ID of the route obtained from an SR-MPLS TE policy through route recursion.
SRInterface	This field is not supported in the current software version. Output interface of the route obtained from the SR-MPLS TE policy through route recursion.
ColorWeight	This field is not supported in the current software version. Weight value of the color attribute in the SR-MPLS TE policy.
Locator	This field is not supported in the current software version. IPv6 prefix of the locator to which the SID belongs. If no locator is available, this field displays N/A.
OrigLinkID	This field is not supported in the current software version. Original link ID of the SDWAN TTE connection.
RealLinkID	This field is not supported in the current software version. Real link ID of the SDWAN TTE connection.

 

display ipv6 route-static routing-table

Use display ipv6 route-static routing-table to display IPv6 static routing table information.

Syntax

display ipv6 route-static routing-table [ ipv6-address prefix-length ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

ipv6-address: Specifies the destination IPv6 address.

prefix-length: Specifies the prefix length in the range of 0 to 128.

Examples

# Display IPv6 static routing table information. ‌

<Sysname> display ipv6 route-static routing-table

Total number of routes: 5

 

Status: * - valid

 

*Destination: 1::1/128

       NibID: 0x21000000        NextHop: 2::2

   MainNibID: N/A             BkNextHop: N/A

     BkNibID: N/A             Interface: Vlan-interface11

     TableID: 0xa           BkInterface: N/A

        Flag: 0x80d0a          BfdSrcIp: N/A

     DbIndex: 0x3            BfdIfIndex: 0x0

        Type: Normal        BfdVrfIndex: 0

  TrackIndex: 0xffffffff          Label: NULL

  Preference: 60            vrfIndexDst: 0

     BfdMode: N/A            vrfIndexNH: 0

   Permanent: 0          RecurseMaskLen: N/A

         Tag: 0

 

*Destination: 1::1234/128

      NibID: 0x21000000        NextHop: 2::2

   MainNibID: N/A             BkNextHop: N/A

     BkNibID: N/A             Interface: NULL0

     TableID: 0xa           BkInterface: N/A

        Flag: 0x80d0a          BfdSrcIp: N/A

     DbIndex: 0x1            BfdIfIndex: 0x0

        Type: Normal        BfdVrfIndex: 0

  TrackIndex: 0xffffffff          Label: NULL

  Preference: 60            vrfIndexDst: 0

     BfdMode: N/A            vrfIndexNH: 0

   Permanent: 0          RecurseMaskLen: N/A

         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.
DbIndex	Index of the database to which the route belongs.
Type	Route type: ·     Normal. ·     DHCP. ·     NAT. ·     IPSGT.
BfdSrcIp	This field is not supported in the current software version. Source IPv6 address of the indirect BFD session.
BfdIfIndex	This field is not supported in the current software version. Index of the interface where BFD is enabled.
BfdVrfIndex	This field is not supported in the current software version. Index of the VPN instance where BFD is enabled. This field displays 0 if BFD is enabled for the public network.
BfdMode	This field is not supported in the current software version. BFD session mode: ·     N/A—No BFD session is configured. ·     Ctrl—Control packet mode. ·     Echo—Echo packet mode.
TrackIndex	‌ NQA Track index.
Label	‌ Label of the route.
vrfIndexDst	This field is not supported in the current software version. Index of the VPN instance to which the destination belongs. For the public network, this field displays 0.
vrfIndexNH	This field is not supported in the current software version. Index of the VPN instance to which the next hop belongs. For the public network, this field displays 0.
Permanent	Permanent static route flag. 1 indicates a permanent static route.
RecurseMaskLen	Exact mask length for route recursion. If the device uses the longest match principle for route recursion, this field displays N/A.
BfdStatic	Name of the static BFD session associated with the route. If no static BFD session is associated with the route, this field is not available.

 

ipv6 route-static

Use ipv6 route-static to configure an IPv6 static route.

Use undo ipv6 route-static to remove an IPv6 static route.

Syntax

ipv6 route-static ipv6-address prefix-length { interface-type interface-number [ next-hop-address ] | next-hop-address } [ permanent | track track-entry-number ] [ preference preference ] [ tag tag-value ] [ description text ]

ipv6 route-static ipv6-address prefix-length interface-type interface-number gateway [ track track-entry-number ] [ preference preference ] [ tag tag-value ] [ description text ]

undo ipv6 route-static ipv6-address prefix-length [ interface-type interface-number [ next-hop-address | gateway ] | next-hop-address ] [ preference preference ]

Default

No IPv6 static route is configured.

Views

System view

Predefined user roles

network-admin

Parameters

ipv6-address prefix-length: Specifies the IPv6 address and prefix length.

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 point-to-point (P2P) interface, the next hop address must be specified.

next-hop-address: Specifies the next hop IPv6 address.

gateway: Specifies the next hop IPv6 address of the IPv6 static route as the gateway address obtained by the interface in IPv6 address autoconfiguration. When the gateway address changes, the device automatically updates the next hop IPv6 address of the IPv6 static route accordingly. For more information about IPv6 address autoconfiguration, see IPv6 basics and DHCPv6 in Network Connectivity Configuration Guide.

permanent: Specifies the IPv6 route as a permanent IPv6 static route. After you specify this keyword, the IPv6 static route will always be active, even if the output interface is down.

track track-entry-number: Associates the IPv6 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.

preference preference: Specifies a preference for IPv6 static routes, in the range of 1 to 255. The default is 60. The smaller the value, the higher the preference. To enable load sharing for multiple routes to the same destination, assign the same preference to the routes. To enable the routes to back up one another, assign different preferences to them.

tag tag-value: Sets a tag for marking the static route, in the range of 1 to 4294967295. The default is 0.

description text: Configures a description for the IPv6 static route, which consists of 1 to 60 characters, including special characters such as the space, but excluding the question mark (?).

Usage guidelines

Application scenarios

If a network's topology is simple, you only need to configure static routes for the network to work correctly. You can also configure static routes when the device cannot use dynamic routing protocols or cannot establish routes to the destination network.

Restrictions and guidelines

You can configure the output interface, next hop address, or both for a static route. If the output interface is a broadcast interface (for example, an Ethernet interface or a VLAN interface), the next hop address must be specified.

For IPv6 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 the specified interface has not obtained the gateway address, the IPv6 static route with the gateway address as the next hop address does not take effect.

Examples

# Configure an IPv6 static route, with the destination address 1:1:2::/64 and next hop 1:1:3::1.

<Sysname> system-view

[Sysname] ipv6 route-static 1:1:2:: 64 1:1:3::1

Related commands

display ipv6 routing-table protocol

ipv6 route-static default-preference

Use ipv6 route-static default-preference to set a default preference for IPv6 static routes.

Use undo ipv6 route-static default-preference to restore the default.

Syntax

ipv6 route-static default-preference default-preference

undo ipv6 route-static default-preference

Default

The default preference of IPv6 static routes is 60.

Views

System view

Predefined user roles

network-admin

Parameters

default-preference: Specifies a default preference for IPv6 static routes, in the range of 1 to 255. The smaller the value, the higher the preference.

Usage guidelines

If no preference is specified for an IPv6 static route, the default preference applies.

When the default preference is reconfigured, it applies only to newly added IPv6 static routes.

Examples

# Set a default preference of 120 for IPv6 static routes.

<Sysname> system-view

[Sysname] ipv6 route-static default-preference 120

Related commands

display ipv6 routing-table protocol

ipv6 route-static fast-reroute auto

Use ipv6 route-static fast-reroute auto to configure IPv6 static route FRR to automatically select a backup next hop.

Use undo ipv6 route-static fast-reroute auto to disable IPv6 static route FRR from automatically selecting a backup next hop.

Syntax

ipv6 route-static fast-reroute auto

undo ipv6 route-static fast-reroute auto

Default

IPv6 static route FRR is disabled from automatically selecting a backup next hop.

Views

System view

Predefined user roles

network-admin

Examples

# Configure IPv6 static route FRR to automatically select a backup next hop.

<Sysname> system-view

[Sysname] ipv6 route-static fast-reroute auto