ipv6 mroute

Configures a static IPv6 route to direct multicast traffic along a specific path.
Syntax
ipv6 mroute[vrfvrf-name]ipv6-address-prefix/prefix-length{ethernetunit/slot/port|venum|tunnelnum}[cost ][distancedistance-value][namename]
no ipv6 mroute[vrfvrf-name]ipv6-address-prefix/prefix-length{ethernetunit/slot/port|venum|tunnelnum}[cost ][distancedistance-value][namename]
Command Default

No static IPv6 multicast route is configured.

Parameters
vrfvrf-name
Configures a static mroute for this virtual routing and forwarding (VRF) route.
ipv6-address-prefix/prefix-length
Configures the destination IPv6 address and prefix for which the route should be added.
ethernetunit/slot/port
Configures an Ethernet interface as the route path.
venum
Configures a virtual interface as the route path.
tunnelnum
Configures a tunnel interface as the route path.
cost
Configures a metric for comparing the route to other static routes in the IPv6 static route table that have the same destination. The range is 1 to 16; the default is 1.
distancedistance-value
Configures the route's administrative distance. The range is 1 to 255. The default is 1.
namename
Name for this static route.
Modes

Global configuration mode

VRF configuration mode

Usage Guidelines

The no form of this command deletes a previously configured static multicast route.

The ethernetunit/slot/port designation for the destination does not apply to PIM SM.

Connected routes on PIM-enabled interfaces are automatically added to the mRTM table.

Examples

The following example configures a static IPv6 mroute to directly connected network 2020::0/120 on virtual interface ve 130. 

Device# configure terminal
Device(config)# ipv6 mroute 2020::0/120 ve 130

The following example configures a static IPv6 mroute within a VRF called vpn1. The VRF has a route descriptor of 100:200. IPv6 addressing is specified for the VRF. The static multicast route has a destination of 2001:0DB8:0:1::1/120, and the address of the next hop gateway is 5100::192:1:1:1. 

Device# configure terminal
Device(config)# ipv6 unicast-routing
Device(config)# vrf vpn1
Device (config-vrf-vpn1)# rd 100:200
Device (config-vrf-vpn1)# address-family ipv6
Device (config-vrf-vpn1-ipv6)# ipv6 mroute 2001:0DB8:0:1::1/120 5100::192:1:1:1
History
Release version Command history
08.0.10a This command was introduced.
Parent topic: Commands I