ipv6 mroute

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

Syntax

ipv6 mroute <prefix> {<prefix-mask>} | <prefix/prefix-length> vlan <vlan-id> {[<distance>] [tag <tag-id>]} reject {[<distance>] [tag <tag-id>]} blackhole {[<distance>] [tag <tag-id>]} interface <interface-name> {[<distance>] [tag <tag-id>]} <ip-address> {[interface <interface-name>] | [recursive] [<distance>] [tag <tag-id>] [probe {default | <probe-name>}] vrf <egress-vrf> {[<distance>] [tag <tag-id>]}

no ipv6 mroute <prefix> {<prefix-mask>} | <prefix/prefix-length>

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.
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.
`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.
default	Uses the default static route probe
probe-name	Specifies the name of a probe to use.

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.

This command is used to configure static multicast routes.

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.

See ip mroute for IPv4 static multicast route configuration command information.

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 mroute 2001:11ac:fd34::/48 2001:11ac:fd34:3333::4 recursive tag 65514
System(su-config)->

Published May 2016prev | next

Email this topic

Print this page Print this page

Leave feedback Feedback