IPv6 Multicast Commands
OcNOS multicast protocol modules work with the Multicast Routing Information Base (MRIB).
Note: Supported only in Qumran2 platforms.
clear ipv6 mroute
Use this command to delete entries from the IPv6 multicast routing table. This command clears the multicast route entries in the multicast route table and removes the entries from the multicast forwarder. MRIB sends a clear message to the multicast protocols. Each multicast protocol has its own clear multicast route command. The protocol-specific clear command clears multicast routes from the protocol and clears the routes from the MRIB.
Command Syntax
clear ipv6 mroute *
clear ipv6 mroute X:X::X:X
clear ipv6 mroute X:X::X:X X:X::X:X
clear ipv6 mroute statistics *
clear ipv6 mroute statistics X:X::X:X
clear ipv6 mroute statistics X:X::X:X X:X::X:X
clear ipv6 mroute X:X::X:X pim sparse-mode
clear ipv6 mroute X:X::X:X X:X::X:X pim (dense mode| sparse-mode)
clear ipv6 mroute (vrf NAME|) *
clear ipv6 mroute (vrf NAME|) X:X::X:X
clear ipv6 mroute (vrf NAME|) X:X::X:X X:X::X:X
clear ipv6 mroute (vrf NAME|) statistics *
clear ipv6 mroute (vrf NAME|) statistics X:X::X:X
clear ipv6 mroute (vrf NAME|) statistics X:X::X:X X:X::X:X
clear ipv6 mroute (vrf Name|) X:X::X:X pim sparse-mode
clear ipv6 mroute (vrf Name|) X:X::X:X X:X::X:X pim (dense-mode | sparse-mode)
Parameters
*
All multicast routes.
X:X::X:X
Group IPv6 address.
X:X::X:X
Source IPv6 address.
vrf
VRF name.
statistics
Multicast route statistics.
dense-mode
Dense Mode (PIM-DM).
sparse-mode
Sparse Mode (PIM-SM)
Command Mode
Exec mode and Privileged Exec mode
Applicability
This command was introduced in OcNOS version 6.2.0.
Example
#clear ip mroute vrf VRF_A 1001::12 ff0e::1/128
debug ipv6 mrib
Use this command to set debug options for IPv6 multicast.
Use the no parameter with this command to disable debugging IPv6 multicast.
Command Syntax
debug ipv6 mrib (all|event|vif|mrt|stats|fib-msg|register-msg|nsm-msg|mrib-msg|mtrace|mtrace-detail)
debug ipv6 mrib (vrf NAME|)(all|event|vif|mrt|stats|fib-msg|register-msg|nsm-msg|mrib-msg|mtrace|mtrace-detail)
no debug ipv6 mrib (all|event|vif|mrt|stats|fib-msg|register-msg|nsm-msg|mrib-msg|mtrace|mtrace-detail)
no debug ipv6 mrib (vrf NAME|) ((all|event|vif|mrt|stats|fib-msg|register-msg|nsm-msg|mrib-msg|mtrace|mtrace-detail)
Parameters
all
Enable all IPv4 multicast debugging.
event
Enable debugging of multicast events.
fib-msg
Enable debugging of multicast FIB messages
mrib-msg
Enable debugging of multicast MRIB messages
mrt
Enable debugging of multicast route
mtrace
Enable debugging of multicast traceroute
mtrace-detail
Enable detailed debugging of multicast traceroute messages
nsm-msg
Enable debugging of multicast NSM messages
register-msg
Enable debugging of multicast PIM Register messages
stats
Enable debugging of multicast statistics.
vif
Enable debugging of multicast interface
vrf
Specify the VRF name
Command Mode
Exec mode, Privileged Exec mode, and Configure mode
Applicability
This command was introduced in OcNOS version 6.2.0.
Example
#debug ipv6 mrib all
ipv6 mroute
Use this command to create a multicast static route.
Multicast static routes are unicast routes which allow multicast and unicast topologies to be incongruous. These routes are used by multicast routing protocols to perform Reverse Path Forwarding (RPF) checks.
Use the no form of this command to clear a multicast static route.
Command Syntax
ipv6 mroute (vrf NAME|) X:X::X:X (static|rip|ospf|bgp|isis|) X:X::X:X
ipv6 mroute (vrf NAME|) X:X::X:X (static|rip|ospf|bgp|isis|) X:X::X:X <1-255>
no ipv6 mroute (vrf NAME|) X:X::X:X (static|rip|ospf|bgp|isis|)
Parameters
NAME
Virtual Routing and Forwarding name
X:X::X:X
Multicast source IPv6 address and mask of the source
static
Static routes.
rip
Routing Information Protocol.
ospf
Open Shortest Patch First protocol.
bgp
Border Gateway Protocol.
isis
Intermediate System to Intermediate System protocol.
X:X::X:X
IPv6 address to use as the RPF address. A host IPv6 address can be a directly connected system or a remote system. For remote systems, a recursive lookup is done from the unicast routing table to find a directly connected system. Recursive lookup is done up to one level.
<1-255>
Administrative distance for the multicast static route. This value determines whether a unicast route or multicast static route is used for the RPF lookup. Lower distances have preference. If the multicast static route has the same distance as the other RPF sources, the multicast static route takes precedence.
Default
The default administrative distance for the multicast static route is 0.
Command Mode
Configure mode
Applicability
This command was introduced in OcNOS version 6.2.0.
Examples
#configure terminal
(config)#ipv6 mroute ff0e::1/128 1001::12
#configure terminal
(config)#ipv6 mroute vrf VRF_A ff0e::1/128 1001::12 1
ipv6 multicast route-limit
Use this command to limit the number of multicast routes that can be added to a multicast routing table. It generates an error message when the limit is exceeded. If the threshold parameter is set, a threshold warning message is generated when this threshold is exceeded and the message continues to occur until the number of mroutes reaches the limit set by the limit argument.
Note: The mroute warning threshold must not exceed the mroute limit.
Use the no parameter with this command to disable this configuration.
Command Syntax
ipv6 multicast route-limit <1-2147483647>
ipv6 multicast route-limit <1-2147483647> <1-2147483647>
ipv6 multicast (vrf NAME|) route-limit <1-2147483647>
ipv6 multicast (vrf NAME|) route-limit <1-2147483647> <1-2147483647>
no ipv6 multicast route-limit
no ipv6 multicast (vrf NAME|) route-limit
Parameters
vrf
VRF name
<1-2147483647>
Number of routes
<1-2147483647>
Threshold at which to generate a warning message
Default
The default limit and threshold value is 2147483647.
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#ipv6 multicast route-limit 34 24
ipv6 multicast-routing
Use this command to turn on/off multicast routing on the router; when turned off, the multicast protocol daemon remains present, but does not perform multicast functions. When multicast routing is enabled, the MRIB re-creates tunnels, and starts processing any VIF addition/deletion requests, MRT addition/deletion requests, and any multicast forwarding events.
Use the no parameter with this command to disable this function. When the no parameter is used, the MRIB releases all VIFs and tunnels, cleans up MRTs, stops IGMPv2 operation and stops relaying multicast forwarder events to multicast protocols.
Command Syntax
ipv6 multicast-routing
ipv6 multicast-routing (vrf NAME|)
no ipv6 multicast-routing
no ipv6 multicast-routing (vrf NAME|)
Parameter
vrf
Specify the VRF name.
Default
By default, multicast routing is disabled.
Command Mode
Configure mode
Applicability
This command was introduced in OcNOS version 6.2.0.
Example
#configure terminal
(config)#ipv6 multicast-routing
ipv6 mroute
Use this command to create a multicast static route.
Multicast static routes are unicast routes that allow multicast and unicast topologies to be incongruous. These routes are used by multicast routing protocols to perform Reverse Path Forwarding (RPF) checks.
Use the no form of this command to clear a multicast static route.
Command Syntax
ipv6 mroute (vrf NAME|) X:X::X:X/M (static|rip|ospf|bgp|isis|) X:X::X:X
ipv6 mroute (vrf NAME|) X:X::X:X/M (static|rip|ospf|bgp|isis|) X:X::X:X <1-255>
no ipv6 mroute (vrf NAME|) X:X::X:X/M (static|rip|ospf|bgp|isis|)
Parameters
NAME
Virtual Routing and Forwarding name
X:X::X:X/M
Specify multicast source IP address and mask
static
Static routes.
rip
Routing Information Protocol.
bgp
Border Gateway Protocol.
ospf
Open Shortest Path First.
isis
Intermediate System to Intermediate System.
X:X::X:X
RPF address for the multicast route. A host IP address can be a directly connected system or a remote system. For remote systems, a recursive lookup is done from the unicast routing table to find a directly connected system. Recursive lookup is done up one level.
<1-255>
Administrative distance for the multicast static route. This value determines whether a unicast route or multicast static route is used for the RPF lookup. Lower distances have preference. If the multicast static route has the same distance as the other RPF sources, the multicast static route takes precedence.
Default
The default administrative distance for the multicast static route is 0.
Command Mode
Configure mode
Applicability
This command was introduced in OcNOS version 6.2.0.
Example
(config)#ipv6 mroute 10:10::10:10/64 10:10::10:12 1
show debugging ipv6 mrib
Use this command to display IPv6 multicast debugging information.
Command Syntax
show debugging ipv6 mrib
show debugging ipv6 mrib (vrf NAME|)
Parameters
vrf
Display routes from a VPN Routing/Forwarding instance.
Command Mode
Exec mode and Privileged Exec mode
Applicability
This command was introduced in OcNOS version 6.2.0.
Examples
The following is a sample output of the show debugging ipv6 mrib command.
#show debugging ipv6 mrib
MRIBv6 debugging status:
MRIBv6 event debugging is on
MRIBv6 route debugging is on
show ipv6 mroute
Use this command to display the IPv6 multicast routing (mroute) table. The routing table is based on the pairing of Source Addresses with their respective Destination Multicast Group Address (S, G).
Command Syntax
show ipv6 mroute (dense|sparse|) (count|summary|)
show ipv6 mroute X:X::X:X (dense|sparse|)(count|summary|)
show ipv6 mroute X:X::X:X X:X::X:X (dense|sparse|) (count|summary|)
show ipv6 mroute (vrf NAME|) (dense|sparse|) (count|summary|)
show ipv6 mroute (vrf NAME|) X:X::X:X (dense|sparse|) (count|summary|)
show ipv6 mroute (vrf NAME|) X:X::X:X X:X::X:X (dense|sparse|) (count|summary|)
Parameters
X:X::X:X
Source or Group IPv6 address.
count
Route and packet count data.
summary
Provide abbreviated display.
dense
Show dense multicast routes.
sparse
Show sparse multicast routes.
vrf
Specify the VRF name.
Command Mode
Exec and Privileged Exec mode
Applicability
This command was introduced in OcNOS version 6.2.0.
Example
The following is a sample output of this command displaying the IPv6 multicast routing table, with and without specifying the group and source IPv6 address:
rtr6#show ipv6 mroute
IPv6 Multicast Routing Table
Flags: I - Immediate Stat, T - Timed Stat, F - Forwarder installed
B - BIDIR
Timers: Uptime/Stat Expiry
Interface State: Interface
(5001::2, ff3e::1), uptime 00:00:16, stat expires 00:03:14
Owner PIM, Flags: TF
Incoming interface: xe17
Outgoing interface list:
xe18 (1)
show ipv6 mif
Use this command to display the MRIB VIF table entries.
The Virtual Host Interface (VIF) used in Pragmatic General Multicast (PGM) or “Reliable Multicast.” The VIF enables the router to send and receive IP multicast packets on several different interfaces at once, as dictated by the multicast routing tables on the router.
Command Syntax
show ipv6 mif
show ipv6 mif IFNAME
show ipv6 mif (vrf NAME|)
show ipv6 mif (vrf NAME|) IFNAME
Parameters
IFNAME
Specify the interface name.
vrf
Specify the VRF name.
Command Mode
Exec and Privileged Exec mode
Applicability
This command was introduced in OcNOS version 6.2.0.
Example
The following are sample outputs of this command displaying the contents for the MRIB VIF table, both with and without the interface parameter specified:
#show ipv6 mif
Interface Mif Owner TTL Uptime
Idx Module
ce9 0 PIM 1 00:00:04
Register 1 PIM 1 00:00:04
ce10 2 PIM 1 00:00:04
show running-config interface ipv6 multicast
Use this command to show the running system status and configuration for an IPv6 multicast interface.
Command Syntax
show running-config interface IFNAME ipv6 multicast
Parameters
IFNAME
Interface name.
Command Mode
Privileged exec mode and configure mode
Applicability
This command was introduced in OcNOS version 6.2.0.
Example
#show running-config interface ce9 ipv6 multicast
!
interface ce9
!
snmp restart mrib
Use this command to restart SNMP in Multicast Routing Information Base (MRIB)
Command Syntax
snmp restart mrib
Parameters
None
Command Mode
Configure mode
Applicability
This command was introduced in OcNOS version 6.2.0.
Examples
#configure terminal
(config)#snmp restart mrib