ipv6 mroute

Configures a static IPv6 route to direct multicast traffic along a specific path.
Syntax
ipv6 mroute [ vrf vrf-name ] ipv6-address-prefix/prefix-length { ethernet unit / slot / port | ve num | tunnel num } [cost ] [ distance distance-value ] [ name name ]
no ipv6 mroute [ vrf vrf-name ] ipv6-address-prefix/prefix-length { ethernet unit / slot / port | ve num | tunnel num } [cost ] [ distance distance-value ] [ name name ]
Command Default

No static IPv6 multicast route is configured.

Parameters
vrf vrf-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.
ethernet unit / slot /port
Configures an Ethernet interface as the route path.
ve num
Configures a virtual interface as the route path.
tunnel num
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.
distance distance-value
Configures the route's administrative distance. The range is 1 to 255. The default is 1.
name name
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 ethernet unit/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 and description should be verified by a SME.
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