ipv6 route

Use this command to add or remove a static IPv6 route.

Syntax

ipv6 route prefix/length {ipv6-address [recursive | interface interface-name] | interface interface-name | vlan vlan-id | vrf egress-vrf | blackhole | reject | probe {default | probe-name}} [distance] [tag tag-id]
no ipv6 route prefix/length {ipv6-address [recursive] | interface interface-name | vlan vlan-id | vrf egress-vrf | blackhole | reject | probe {default | probe-name}} [distance] [tag tag-id]

Parameters

prefix/prefix-length Specifies a destination IP address in prefix/prefix-length format.
ipv6-address Specifies a next hop IP address.
interface interface-name Specifies a next hop interface ID. When entered with the next-hop IPv6 address, it specifies the interface ID the IPv6 address is assigned to.
vlan vlan-id Specifies the next hop VLAN. Valid values for VLAN ID: 1 - 4094.
vrf egress-vrf Specifies the egress VRF router as the next hop (S-, K-Series).
blackhole Specifies that packets destined for this route‘s subnet are silently dropped. An ICMP network unreachable message is not sent to the packet source.
reject Specifies that packets destined for this route‘s subnet are dropped, and an ICMP network unreachable message is sent to the packet source.
recursive (Optional) Specifies that the next hop interface is determined by route lookup.
probe default | probe-name Specifies either a default or named probe to be configured for this static route.
distance (Optional) Specifies an administrative distance metric for this route. Valid values are 1 (default) to 255. Routes with lower values receive higher preference in route selection.
tag tag-id (Optional) Specifies an OSPF tag ID for this route. Valid values are 1 - 4294967295.

Defaults

  • If interface interface-name is not specified when configuring an IPv6 address, a specific interface is not configured for the static route.
  • If distance is not specified, the default value of 1 will be applied.
  • If an OSPF tag ID is not specified, no OSPF tag is associated with the route.
  • If recursive or interface interface-name are not specified when configuring an IP address, see usage section below.

Mode

Global configuration.

Usage

This command is used to configure static routes that will route transit frames.

On the S- and K-Series, use the vrf egress-vrf parameter to point to the egress VRF instance that will perform the next hop lookup for this static route.

When specifying an IP address as the next hop, it is recommended that you specify the interface the IP address is assigned to. If only the prefix with mask/length and the IP address of the next hop router are entered, and you do not specify the optional recursive or the interface interface-name parameter, when entering the IP address, all configured subnets are searched for a subnet containing the next hop. If found, the static route will be anchored to that interface, else it will become a recursive route.

When configuring a probe for the static route using the probe option, the probe session is created on the nexthop address. When the probe session goes down, the static route is disabled. When the probe session comes up, the static route is enabled.

The no ipv6 route command removes the specified static IPv6 route.

Examples

This example shows how to:

  • Configure a static route with a prefix and length of 2001:11ac:fd34::/48 and a next hop IPv6 address of 2001:11ac:fd34:3333::4
  • Specify that the next-hop interface should be determined using route lookup
  • Assign the OSPF tag 65514 to the route
    System(su)->configure
    System(su-config)->ipv6 route 2001:11ac:fd34::/48 2001:11ac:fd34:3333::4 recursive tag 65514
    System(su-config)->