PIMv6 Commands
This chapter describes the commands for Protocol-Independent Multicast (PIM).
clear ipv6 mroute
Use this command to delete all multicast route table entries and all multicast routes at the PIM protocol level.
Command Syntax
clear ipv6 mroute *
clear ipv6 mroute * pim (dense-mode|sparse-mode)
clear ipv6 mroute X:X::X:X
clear ipv6 mroute X:X::X:X X:X::X:X
clear ipv6 mroute X:X::X:X X:X::X:X pim (dense-mode|sparse-mode)
clear ipv6 mroute X:X::X:X pim sparse-mode
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 (vrf NAME|) *
clear ipv6 mroute (vrf NAME|) * pim (dense-mode|sparse-mode)
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|) X:X::X:X X:X::X:X pim (dense-mode|sparse-mode)
clear ipv6 mroute (vrf NAME|) X:X::X:X pim sparse-mode
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
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
*
Delete all multicast routes
statistics
Clears multicast route statistics
X:X::X:X
Clears group IP address
X:X::X:X
Clears source IP address
dense-mode
Clear multicast rout table for PIM dense-mode
sparse-mode
Clear multicast route table for PIM sparse mode
Command Mode
Exec mode and Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#clear ipv6 mroute * pim sparse-mode
#clear ipv6 mroute 3ffe::24:3 ff00::3 pim sparse-mode
clear ipv6 pim sparse-mode bsr
Use this command to clear all rendezvous point (RP) sets learned through the PIMv2 Bootstrap Router (BSR).
Command Syntax
clear ipv6 pim sparse-mode bsr rp-set *
clear ipv6 pim (vrf NAME|) sparse-mode bsr rp-set *
Parameters
rp-set
PIMv2 bootstrap router RP set
*
Clear all RP sets
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
Command Mode
Exec mode and Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#clear ipv6 pim sparse-mode bsr rp-set *
debug ipv6 pim
Use this command to enable debugging for PIM.
Use the no option with this command to deactivate debugging for PIM.
Command Syntax
debug ipv6 pim (all|events|mfc|mib|mtrace|nexthop|nsm|packet|state|timer)
debug ipv6 pim (vrf NAME|) (all|events|mfc|mib|mtrace|nexthop|nsm|packet|state |timer)
no debug ipv6 pim (all|events|mfc|mib|mtracenexthop|nsm|packet|state|timer)
no debug ipv6 pim (vrf NAME|) (all|events|mfc|mib|mtracenexthop|nsm|packet |state|timer)
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
all
Enable debugging for all PIM events
events
Enable debugging for general configuration, Virtual Routing (VR), and VRF context
mfc
Enable debugging for MFC updates
mib
Enable debugging for MIB entries
mtrace
Enable debugging for MTRACE messages
nexthop
Enable debugging for Reverse Path Forwarding (RPF) neighbor nexthop cache handling
nsm
Enable debugging for NSM
packet
Enable debugging for PIM packets
state
Enable debugging for PIM states
timer
Enable debugging for PIM timers
Command Mode
Exec mode, Privileged Exec mode, and Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#debug ipv6 pim state
debug ipv6 pim packet
Use this command to activate debugging of incoming or outgoing PIM packets.
Use the no option with this command to deactivate debugging of incoming or outgoing PIM packets.
Command Syntax
debug ipv6 pim packet
debug ipv6 pim packet in
debug ipv6 pim packet out
debug ipv6 pim (vrf NAME|) packet
debug ipv6 pim (vrf NAME|) packet in
debug ipv6 pim (vrf NAME|) packet out
no debug ipv6 pim packet
no debug ipv6 pim packet in
no debug ipv6 pim packet out
no debug ipv6 pim (vrf NAME|) packet
no debug ipv6 pim (vrf NAME|) packet in
no debug ipv6 pim (vrf NAME|) packet out
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
in
Debug incoming packets
out
Debug outgoing packets
Command Mode
Configure and Privileged Exec modes
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#debug ipv6 pim packet in
debug ipv6 pim timer assert
Use this command to enable debugging of the PIM assert timers.
Use the no option with this command to disable debugging for PIM assert timers.
Command Syntax
debug ipv6 pim timer assert
debug ipv6 pim timer assert at
debug ipv6 pim (vrf NAME|) timer assert
debug ipv6 pim (vrf NAME|) timer assert at
no debug ipv6 pim timer assert
no debug ipv6 pim timer assert at
no debug ipv6 pim (vrf NAME|) timer assert
no debug ipv6 pim (vrf NAME|) timer assert at
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
at
Use this option to turn on or turn off debugging of the PIM Assert Timer
Command Mode
Exec mode, Privileged Exec mode, and Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#debug ipv6 pim timer assert at
debug ipv6 pim timer bsr
Use this command to enable debugging of the PIM BSR time.
Use the no option with this command to disable debugging of the PIM BSR timer.
Command Syntax
debug ipv6 pim timer bsr
debug ipv6 pim timer bsr bst
debug ipv6 pim timer bsr crp
debug ipv6 pim (vrf NAME|) timer bsr
debug ipv6 pim (vrf NAME|) timer bsr bst
debug ipv6 pim (vrf NAME|) timer bsr crp
no debug ipv6 pim timer bsr
no debug ipv6 pim timer bsr bst
no debug ipv6 pim timer bsr crp
no debug ipv6 pim (vrf NAME|) timer bsr
no debug ipv6 pim (vrf NAME|) timer bsr bst
no debug ipv6 pim (vrf NAME|) timer bsr crp
Parameters
bst
Turn on or turn off the bootstrap debugging timer
crp
Turn on or turn off the Candidate-RP debugging timer
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
Command Mode
Exec mode, Privileged Exec mode, and Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#debug ipv6 pim timer bsr bst
debug ipv6 pim timer hello
Use this command to enable debugging of various PIM Hello timers.
Use the no option with this command to disable debugging of the PIM Hello timers.
Command Syntax
debug ipv6 pim timer hello
debug ipv6 pim timer hello ht
debug ipv6 pim timer hello nlt
debug ipv6 pim timer hello tht
debug ipv6 pim (vrf NAME|) timer hello
debug ipv6 pim (vrf NAME|) timer hello ht
debug ipv6 pim (vrf NAME|) timer hello nlt
debug ipv6 pim (vrf NAME|) timer hello tht
no debug ipv6 pim timer hello
no debug ipv6 pim timer hello ht
no debug ipv6 pim timer hello nlt
no debug ipv6 pim timer hello tht
no debug ipv6 pim (vrf NAME|) timer hello
no debug ipv6 pim (vrf NAME|) timer hello ht
no debug ipv6 pim (vrf NAME|) timer hello nlt
no debug ipv6 pim (vrf NAME|) timer hello tht
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
ht
Turn on or turn off the PIM Hello debugging timer (ht)
nlt
Turn on or turn off the PIM Neighbor Liveliness debugging timer (nlt)
tht
Turn on or turn off the Triggered Hello Timer (tht)
Command Mode
Exec mode, Privileged Exec mode, and Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#debug ipv6 pim timer hello ht
debug ipv6 pim timer joinprune
Use this command to enable debugging of various PIM JoinPrune timers.
Use the no option with this command to disable the debugging of the PIM JoinPrune timers.
Command Syntax
debug ipv6 pim timer joinprune
debug ipv6 pim timer joinprune et
debug ipv6 pim timer joinprune kat
debug ipv6 pim timer joinprune jt
debug ipv6 pim timer joinprune ot
debug ipv6 pim timer joinprune ppt
debug ipv6 pim (vrf NAME|) timer joinprune
debug ipv6 pim (vrf NAME|) timer joinprune et
debug ipv6 pim (vrf NAME|) timer joinprune kat
debug ipv6 pim (vrf NAME|) timer joinprune jt
debug ipv6 pim (vrf NAME|) timer joinprune ot
debug ipv6 pim (vrf NAME|) timer joinprune ppt
no debug ipv6 pim timer joinprune
no debug ipv6 pim timer joinprune et
no debug ipv6 pim timer joinprune kat
no debug ipv6 pim timer joinprune jt
no debug ipv6 pim timer joinprune ot
no debug ipv6 pim timer joinprune ppt
no debug ipv6 pim (vrf NAME|) timer joinprune
no debug ipv6 pim (vrf NAME|) timer joinprune et
no debug ipv6 pim (vrf NAME|) timer joinprune kat
no debug ipv6 pim (vrf NAME|) timer joinprune jt
no debug ipv6 pim (vrf NAME|) timer joinprune ot
no debug ipv6 pim (vrf NAME|) timer joinprune ppt
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
et
Turn on or turn off the PIM JoinPrune expiry timer (et)
jt
Turn on or turn off the PIM JoinPrune upstream Join Timer (jt)
kat
Turn on or turn off the PIM JoinPrune Keep Alive timer (kat)
ot
Turn on or turn off the PIM JoinPrune Upstream Override Timer (ot)
ppt
Turn on or turn off the f PIM JoinPrune PrunePending Timer ((ppt)
Command Mode
Exec mode, Privileged Exec mode, and Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#debug ipv6 pim timer joinprune et
debug ipv6 pim timer register
Use this command to enable debugging of the PIM register timer.
Use the no option with this command to disable debugging of the PIM register timer.
Command Syntax
debug ipv6 pim timer register
debug ipv6 pim timer register rst
debug ipv6 pim (vrf NAME|) timer register
debug ipv6 pim (vrf NAME|) timer register rst
no debug ipv6 pim timer register
no debug ipv6 pim timer register rst
no debug ipv6 pim (vrf NAME|) timer register
no debug ipv6 pim (vrf NAME|) timer register rst
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
rst
Turn on or turn off the PIM Register Stop Timer (rst)
Command Mode
Exec mode, Privileged Exec mode, and Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#debug ipv6 pim timer register
ipv6 pim accept-register
Use this command to configure the ability to filter out multicast sources specified by the given access-list at the RP, so that the RP will accept/refuse to perform the Register mechanism for the packets sent by the specified sources. By default, the RP accepts Register packets from all multicast sources.
Use the no option with this command to revert to default.
Command Syntax
ipv6 pim (vrf NAME|) accept-register list WORD
no ipv6 pim (vrf NAME|) accept-register
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
WORD
Name of a standard access list
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#ipv6 pim accept-register list 121
(config)#no ipv6 pim accept-register
ipv6 pim anycast-rp
Use this command to configure an Anycast-RP in the RP set.
Use the no option with this command to remove the Anycast-RP configuration.
Command Syntax
ipv6 pim anycast-rp X:X::X:X X:X::X:X
ipv6 pim (vrf NAME|) anycast-rp X:X::X:X X:X::X:X
no ipv6 pim anycast-rp X:X::X:X
no ipv6 pim anycast-rp X:X::X:X X:X::X:X
no ipv6 pim (vrf NAME|) anycast-rp X:X::X:X
no ipv6 pim (vrf NAME|) anycast-rp X:X::X:X X:X::X:X
Parameters
vrf
The VPN routing/forwarding instance.
NAME
Specify the name of the VPN routing/forwarding instance.
X:X::X:X
Unicast IPv6 address of the Anycast RP set. An Anycast RP set is a collection of RPs in the same domain.
X:X::X:X
Destination IPv6 address where Register messages are copied and sent. A Member RP is an individual RP member in the Anycast RP set.
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
The following example shows how to configure the Anycast RP in the RP set.
#configure terminal
(config)#ipv6 pim anycast-rp 2:2::2:2 20:20::20:20
The following example shows how to remove the configuration.
#configure terminal
(config)#no ipv6 pim anycast-rp 2:2::2:2 20:20::20:20
ipv6 pim bfd
Use this command to enable PIMv6 BFD on an interface.
Use the no option with this command to revert to default.
Command Syntax
ipv6 pim bfd (disable|)
no ipv6 pim bfd
Parameters
disable
Useful when PIMv6 BFD is enabled at global level (refer command ipv6 pim bfd all-interfaces) and it is required to disable PIMv6 BFD on a particular interface.
Default
By default, PIMv6 BFD is disabled on the interface.
Command Mode
Interface mode
Applicability
This command was introduced in OcNOS-DC version 5.1.
Examples
#configure terminal
(config)#interface eth1
(config-if)#ipv6 pim bfd
(config-if)#ipv6 pim bfd disable
(config-if)#no ipv6 pim bfd
ipv6 pim bfd all-interfaces
Use this command to enable PIMv6 BFD on all the interfaces of a VRF instance.
Use the no option with this command to revert to default.
Command Syntax
ipv6 pim (vrf NAME|) bfd all-interfaces
no ipv6 pim (vrf NAME|) bfd all-interfaces
Parameters
vrf
The VPN routing/forwarding instance.
NAME
Specify the name of the VPN routing/forwarding instance.
Default
By default, PIMv6 BFD is disabled on all interfaces.
Command Mode
Configure mode
Applicability
This command was introduced in OcNOS-DC version 5.1.
Examples
#configure terminal
(config)#ipv6 pim bfd all-interfaces
(config)#ipv6 pim vrf TEST_VRF bfd all-interfaces
(config)#no ipv6 pim bfd all-interfaces
(config)#no ipv6 pim vrf TEST_VRF bfd all-interfaces
ipv6 pim bind ecmp-bundle
Use this command to bind interfaces to an ECMP Bundles.
Use the no option with this command to unbind the interfaces from an ECMP Bundles
Command Syntax
ipv6 pim bind ecmp-bundle WORD
no ipv6 pim bind ecmp-bundle
Parameter
WORD
ECMP bundle name
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#interface eth1
(config-if)#ipv6 pim bind ecmp-bundle ebund1
(config-if)#no ipv6 pim bind ecmp-bundle
ipv6 pim bsr-border
Use this command to prevent bootstrap router (BSR) messages from being sent or received through an interface.
When this command is configured on an interface, no PIM Version 2 BSR messages are sent or received through the interface. Use this command to configure an interface bordering another PIM domain to avoid the exchange of BSR messages between the two domains. BSR messages should not be exchanged between different domains because routers in one domain may elect rendezvous points (RPs) in the other domain, resulting in a protocol malfunction or loss of isolation between the domains.
Use the no option with this command to remove the BSR border configuration.
Note: This command does not set up multicast boundaries. It only sets up a PIM domain BSR message border.
Command Syntax
ipv6 pim bsr-border
no ipv6 pim bsr-border
Parameters
None
Default
Bootstrap router border configuration is disabled by default.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
The following example configures the interface to be the PIM domain border:
#configure terminal
(config)#interface eth0
(config-if)#ipv6 pim bsr-border
(config)#interface eth0
(config-if)#no ipv6 pim bsr-border
ipv6 pim bsr-candidate
Use this command to give the router the candidate BSR status using the name the interface.
Use the no option with this command to disable this function.
Note: This command does not set up multicast boundaries. It only sets up a PIM domain BSR message candidate
Command Syntax
ipv6 pim (vrf NAME|) bsr-candidate IFNAME
no ipv6 pim (vrf NAME|) bsr-candidate
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
IFNAME
Specify the name of the interface
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#ipv6 pim bsr-candidate eth0
(config)#no ipv6 pim bsr-candidate
ipv6 pim cisco-register-checksum
Use this command to configure the option to calculate the register checksum over the whole packet. This command is used to inter-operate with older Cisco IOS versions.
Use the no option with this command to revert to the default settings.
Command Syntax
ipv6 pim cisco-register-checksum
ipv6 pim cisco-register-checksum group-list (<1-99>|<1300-1999>|WORD)
ipv6 pim (vrf NAME|) cisco-register-checksum
ipv6 pim (vrf NAME|) cisco-register-checksum group-list (<1-99>|<1300-1999>|WORD)
no ipv6 pim cisco-register-checksum
no ipv6 pim cisco-register-checksum group-list (<1-99>|<1300-1999>|WORD)
no ipv6 pim (vrf NAME|) cisco-register-checksum
no ipv6 pim (vrf NAME|) cisco-register-checksum group-list (<1-99>|<1300-1999>|WORD)
Parameters
vrf
The VPN routing/forwarding instance.
NAME
Specify the name of the VPN routing/forwarding instance.
group-list
Use this parameter to configure the option to calculate the register checksum over the whole packet on multicast groups specified by the access-list.
<1-99>
Specify an IP standard access-list.
<1300-1999>
Specify an IP access-list (expanded range).
WORD
IP named standard access list.
Default
This command is disabled by default. By default, Register Checksum is calculated only over the header.
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#ipv6 pim cisco-register-checksum
(config)#ipv6 pim cisco-register-checksum group-list G1
(config)#ipv6 access-list filter permit ff1e:10/128
ipv6 pim crp-cisco-prefix
Use this command to turn on or turn the Candidate-RP debugging timerworking with Cisco BSR.
Use the no form of this command to turn off the Candidate-RP debugging timerworking with Cisco BSR.
Command Syntax
ipv6 pim crp-cisco-prefix
no ipv6 pim crp-cisco-prefix
Parameters
crp-cisco-prefix
Candidate-RP debugging timerworking with Cisco BSR.
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#ipv6 pim crp-cisco-prefix
(config)#noipv6 pim crp-cisco-prefix
ipv6 pim
Use this command to enable IPv6 PIM dense-mode or sparse-mode on the current interface.
Use the no option with this command to disable IPv6 PIM dense-mode or sparse-mode on the interface.
Command Syntax
ipv6 pim (dense-mode|sparse-mode|)
no ipv6 pim (dense-mode|sparse-mode|)
Parameters
dense-mode
Enable IPv6 PIM dense-mode operation
sparse-mode
Enable IPv6 PIM sparse-mode operation
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#interface eth0
(config-if)#ipv6 pim dense-mode
(config)#interface eth0
(config-if)#no ipv6 pim dense-mode
(config)#interface eth0
(config-if)#ipv6 pim sparse-mode
(config-if)#no ipv6 pim sparse-mode
ipv6 pim passive
Use this command to enable or disable passive mode operation for local members on the interface. Passive mode essentially stops PIM transactions on the interface, allowing only the Internet Group Management Protocol (IGMP) mechanism to be active.
Use the no option with this command to disable the passive mode.
Command Syntax
ipv6 pim (dense-mode|sparse-mode) passive
no ipv6 pim (dense-mode|sparse-mode) passive
Parameters
dense-mode
Enable passive operation for PIM dense-mode
sparse-mode
Enable passive operation for PIM sparse-mode
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#interface eth0
(config-if)#ipv6 pim dense-mode passive
(config)#interface eth0
(config-if)#no ipv6 pim dense-mode passive
#configure terminal
(config)#interface eth0
(config-if)#ipv6 pim sparse-mode passive
(config)#interface eth0
(config-if)#no ipv6 pim sparse-mode passive
ipv6 pim dr-priority
Use this command to set the designated router’s priority value.
Use the no option with this command to remove the priority from the DR.
Command Syntax
ipv6 pim dr-priority <0-4294967294>
no ipv6 pim dr-priority
Parameter
<0-4294967294>
Valid range of values for DR priority, with a higher value resulting in a higher preference
Default
The default DR priority value is 1.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#interface eth0
(config-if)#ipv6 pim dr-priority 11234
(config)#interface eth0
(config-if)#no ipv6 pim dr-priority
ipv6 pim ecmp-bundle
Use this command to create an ECMP bundle.
Use the no option with this command to delete an ECMP bundle.
Command Syntax
ipv6 pim ecmp-bundle WORD
ipv6 pim (vrf NAME|) ecmp-bundle WORD
ipv6 pim ecmp-bundle WORD
no ipv6 pim (vrf NAME|) ecmp-bundle WORD
Parameter
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
WORD
ECMP bundle name
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#ipv6 pim exmp-bundle ebund1
(config)#no ipv6 pim ecmp-bundle ebund1
ipv6 pim exclude-genid
Use this command to exclude the GenID (generated ID) option from Hello packets sent by the PIM module on an interface.This command is used to inter-operate with older Cisco IOS versions.
Use the no option with this command to restore PIM its default setting.
Command Syntax
ipv6 pim exclude-genid
no ipv6 pim exclude-genid
Parameters
None
Default
By default, this command is disabled; that is, the GenID option is included.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#interface eth0
(config-if)#ipv6 pim exclude-genid
(config)#interface eth0
(config-if)#no ipv6 pim exclude-genid
ipv6 pim hello-holdtime
Use this command to configure a hello holdtime other than the default(3.5 * hello_interval seconds).
When configuring hello-holdtime, if the configured value is less than the current hello_interval, it is refused.
When removing a configured hello_holdtime, the value is reset to (3.5 * current hello_interval) value.
Every time the hello_interval is updated, the hello-holdtime is also updated according to rules below:
If the hello_holdtime is not configured, or if the hello_holdtime is configured, but is less than the current hello_interval value, it is modified to (3.5 * hello_interval). Otherwise, the configured value is maintained.
Use the no option with this command to remove the configured hello-holdtime.
Command Syntax
ipv6 pim hello-holdtime <1-65535>
no ipv6 pim hello-holdtime
Parameter
<1-65535>
Range of values for hello-holdtime, in seconds
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#interface fxp0
(config-if)#ipv6 pim hello-holdtime 123
(config)#interface fxp0
(config-if)#no ipv6 pim hello-holdtime
ipv6 pim hello-interval
Use this command to configure a hello interval value other than the default. When a hello-interval is configured and hello-holdtime is not configured, or when the hello-holdtime value configured is less than the new hello-interval value, the holdtime value is modified to (3.5 * hello_interval). Otherwise, the hello-holdtime value is the configured value.
Use the no option with this command to reset the hello-interval to its default value.
Command Syntax
ipv6 pim hello-interval <1-65535>
no ipv6 pim hello-interval
Parameter
<1-65535>
Range of values for the hello-interval
Note: No fractional values are allowed.
Default
The default value for hello-interval is 30 seconds.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#interface eth0
(config-if)#ipv6 pim hello-interval 123
(config)#interface eth0
(config-if)#no ipv6 pim hello-interval
ipv6 pim ignore-rp-set-priority
Use this command to ignore the RP-SET priority value, and use only the hashing mechanism for RP selection. This command is used to inter-operate with older Cisco IOS versions.
Use the no option with this command to remove this setting.
Command Syntax
ipv6 pim ignore-rp-set-priority
ipv6 pim (vrf NAME|) ignore-rp-set-priority
no ipv6 pim ignore-rp-set-priority
no ipv6 pim (vrf NAME|) ignore-rp-set-priority
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#ipv6 pim ignore-rp-set-priority
#configure terminal
(config)#no ipv6 pim ignore-rp-set-priority
ipv6 pim jp-timer
Use this command to set a PIM join/prune timer.
Use the no option with this command to remove the join/prune timer.
Command Syntax
ipv6 pim (vrf NAME|) jp-timer <1-65535>
no ipv6 pim (vrf NAME|) jp-timer
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
<1-65535>
Range of values for the Join/Prune timer, in seconds
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#ipv6 pim jp-timer 234
#configure terminal
(config)#no ipv6 pim jp-timer
ipv6 pim neighbor-filter
Use this command to enable filtering of neighbors on the interface.
When configuring a neighbor filter and when denied by filtering access list, PIM either does not establish adjacency with a neighbor or terminates adjacency with existing neighbors.
Use the no option with this command to disable filtering of neighbors on the interface.
Command Syntax
ipv6 pim neighbor-filter WORD
no ipv6 pim neighbor-filter
Parameters
WORD
Name of an IP standard access list
Command Mode
Interface mode
Default
This command is disabled; by default, there is no filtering.
Applicability
This command was introduced before OcNOS version 1.3.
Example
(config)#interface fxp0
(config-if)#ipv6 pim neighbor-filter F1
(config-if)#no ipv6 neighbor-filter
ipv6 pim propagation-delay
Use this command to configure the propagation delay value.
Use the no option with this command to return the propagation delay to its default value.
Command Syntax
ipv6 pim propagation-delay <0-32767>
no ipv6 pim propagation-delay
Parameter
<0-32767>
Range of values for propagation delay, in milliseconds
Default
The default propagation delay is 1000 milliseconds.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#interface eth0
(config-if)#ipv6 pim propagation-delay 1000
(config)#interface eth0
(config-if)#no ipv6 pim propagation-delay
ipv6 pim register-rate-limit
Use this command to configure the rate of Register packets sent by this designated router (DR), in number of packets per second.
Use the no option to remove the register-rate-limit configuration.
Note: The configured rate is per (S,G) state, and is not a system-wide rate.
Command Syntax
ipv6 pim (vrf NAME|) register-rate-limit <1-65535>
no ipv6 pim (vrf NAME|) register-rate-limit
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
<1-65535>
Range of values for packets to send per second
Command mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#ipv6 pim register-rate-limit 3444
#configure terminal
(config)#no ipv6 pim register-rate-limit
ipv6 pim register-rp-reachability
Use this command to enable/disable the RP reachability check for PIM Registers at the DR.
Use the no option to reset to the default state.
Command Syntax
ipv6 pim (vrf NAME|) register-rp-reachability (disable|enable)
no ipv6 pim (vrf NAME|) register-rp-reachability
Parameter
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
Command Mode
Configure mode
Default
The default setting is no checking for rendezvous point reachability,
Applicability
This command was introduced before OcNOS version 1.3.
Example
(config)#ipv6 pim register-rp-reachability enable
(config)#commit
(config)#ipv6 pim register-rp-reachability disable
(config)#commit
(config)#no ipv6 pim register-rp-reachability
ipv6 pim register-source
Use this command to configure the source address of Register packets sent by this DR, overriding the default source address, which is the address of the RPF interface toward the source host.
Use the no option to remove the source address of register packets sent by this DR, and reset it to use the default source address, that is, the address of the RPF interface toward the source host.
The configured address must be a reachable address so the RP can send corresponding Register-Stop messages in response. This address is usually the loopback interface address, but can also be other physical addresses. The address must be advertised by unicast routing protocols on the DR.
Note: The interface configured does not require PIM to be enabled.
Command Syntax
ipv6 pim (vrf NAME|) register-source (X:X::X:X |IFNAME)
no ipv6 pim (vrf NAME|) register-source
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
X:X::X:X
The IP address to be used as the source of the register packets
IFNAME
The name of the interface to be used as the source of the register packets
Command mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#ipv6 pim register-source 3ffe:406::1
#configure terminal
(config)#no ipv6 pim register-source
ipv6 pim register-suppression
Use this command to configure the register-suppression time, in seconds, overriding the default value of 60 seconds. Configuring this value modifies register-suppression time at the DR; configuring this value at the RP modifies the RP-keepalive-period value if the ipv6 pim rp-register-kat command is not used.
Use the no option to remove the register-suppression setting.
Command Syntax
ipv6 pim (vrf NAME|) register-suppression <11-65535>
no ipv6 pim (vrf NAME|) register-suppression
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
<11-65535>
Register suppression time, in seconds
Command mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#ipv6 pim register-suppression 555
#configure terminal
(config)#no ipv6 pim register-suppression
ipv6 pim router-id
Use this command to configure PIM router-ID to uniquely identify the router. By default, PIM registers for the NSM router-id service. This command will override the router-id received from NSM.
Use the no option with this command to unconfigure PIM router-ID. This will make PIM fall back to the NSM router-id
Command Syntax
ipv6 pim (vrf NAME|) router-id A.B.C.D
no ipv6 pim (vrf NAME|) router-id
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
A.B.C.D
Specify the Router ID
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#ipv6 pim router-id 1.1.1.1
(config)#no ipv6 pim router-id
ipv6 pim rp-address
Use this command to statically configure an RP address for multicast groups.
Use the no option to remove the RP address.
OcNOS PIMv6 supports multiple static RPs. It also supports usage of static-RP and BSR mechanism simultaneously. The following list states the correct usage of this command:
• To support embedded RP, the router configured as the RP must use a configured access-list that permits the embedded RP group ranges derived from the embedded RP address. If embedded RP support is available, only the RP must be statically configured as the RP for the embedded RP ranges – no additional configuration is required on other PIMv6 routers. The other routers will discover the RP address from the IPv6 group address. For these routers to select a static RP instead of the embedded RP, the specific embedded RP group range must be configured in the access list of the static RP, and embedded RP support must be disabled.
• If RP-address configured through BSR and RP-address configured statically are both available for a group range, the RP-address configured through BSR is chosen over statically configured RP-address.
• A single static-RP can be configured for multiple group ranges using Access Lists. However, configuring multiple static RPs (using ipv6 pim rp-address command) with the same RP address is not allowed. The static-RP can be configured either for the whole multicast group range ff00::/8 (without ACL) or for specific group ranges (using ACL).
For example, configuring ipv6 pim rp-address 3ffe:10:10:5::153 will configure static-RP 3ffe:10:10:5::153 for the default group range ff00::/8. Configuring ipv6 pim rp-address 3ffe:20:20:5::153 grp-list will configure static-RP 3ffe:20:20:5::153 for all the group ranges represented by permit filters in grp-list ACL.
• If multiple static-RPs are available for a group range, then one with the highest IP address is chosen.
• Only permit filters in ACL are considered as valid group ranges. The default permit filter ::/0 is converted to default multicast filter ff00::/8.
• When selecting static-RPs for a group range, the first element, with static-RP with the highest IP address is chosen.
• Group mode and RP address mappings learned through BSR take precedence over mappings statistically defined by the ipv6 pim rp-address command without the override keyword. Commands with the override keyword take precedence over dynamically learned mappings.
Command Syntax
ipv6 pim (vrf NAME|) rp-address X:X::X:X (override|)
no ipv6 pim (vrf NAME|) rp-address X:X::X:X (override|)
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
X:X::X:X
IPv6 address for the RP
override
Static RP overrides dynamically-learned RP
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#ipv6 pim rp-address 30:30:5::153 override
#configure terminal
(config)#no ipv6 pim rp-address 30:30:5::153 override
ipv6 pim rp-candidate
Use this command to give the router a candidate RP status using the IPv6 address of the specified interface.
Additionally, the groups specified will operate in PIM sparse mode; group-list specifies the standard IP access list number or name that defines the group prefixes that are advertised in association with the RP address.
Use the no option along with this command to remove the settings.
Command Syntax
ipv6 pim (vrf NAME) rp-candidate IFNAME(group-list(<1-99>|WORD))|)(interval <1-16383>|) (priority <0-255>|)
no ipv6 pim (vrf NAME) rp-candidate (IFNAME|)
Parameters
vrf NAME
The VPN routing/forwarding instance
IFNAME
Specify an interface name
<1-99>
An IP Standard access-list
WORD
A named standard access list
<0-16383>
Range of values for candidate-RP advertisement interval, in seconds
<0-255>
Range of values for priority of an RP candidate
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#ipv6 pim rp-candidate eth3
(config)#no ipv6 pim rp-candidate eth3
ipv6 pim rp embedded
Use this command to embed the PIM Rendezvous Point.
Use the no option with this command to remove the Rendezvous Point.
Command Syntax
ipv6 pim rp embedded (disable|enable)
no ipv6 pim rp embedded
Parameter
embedded
Embed the Rendezvous Point
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#ipv6 pim rp embedded enable
(config)#ipv6 pim rp embedded disable
(config)#no ipv6 pim rp embedded
ipv6 pim rp-register-kat
Use this command to configure a Keepalive Timer (KAT) value for (S,G) states at RP to monitor PIM register packets, overriding the generic KAT timer value.
Use the no option to remove this configuration.
Command Syntax
ipv6 pim rp-register-kat <1-65535>
ipv6 pim (vrf NAME|) rp-register-kat <1-65535>
no ipv6 pim rp-register-kat
no ipv6 pim (vrf NAME|) rp-register-kat
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
<1-65535>
Range of values for a KAT time in seconds
Command mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#ipv6 pim rp-register-kat 3454
(config)#no ipv6 pim rp-register-kat
ipv6 pim spt-threshold
Use this command to configure an SPT (System Posture Token) threshold.
Use the no option with this command to remove a configured SPT threshold.
Note: This option is binary, meaning that switching to SPT happens either the first data packet is received, or not at all. It is not rate-based.
Command Syntax
ipv6 pim spt-threshold
ipv6 pim spt-threshold group-list (<1-99>|<1300-1999>|WORD)
ipv6 pim (vrf NAME|) spt-threshold
ipv6 pim (vrf NAME|) spt-threshold group-list (<1-99>|<1300-1999>|WORD)
no ipv6 pim spt-threshold
no ipv6 pim spt-threshold group-list (<1-99>|<1300-1999>|WORD)
no ipv6 pim (vrf NAME|) spt-threshold
no ipv6 pim (vrf NAME|) spt-threshold group-list (<1-99>|<1300-1999>|WORD)
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
group-list
Enable the ability for the last-hop PIM router to switch to SPT for multicast group addresses indicated by the given access-list
<1-99>
An IP Standard access-list
<1300-1999>
An IP Standard access-list (expanded range)
WORD
A named standard access list
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#ipv6 pim spt-threshold group-list LIST1
#configure terminal
(config)#no ipv6 pim spt-threshold
ipv6 pim ssm
Use this command to configure Source Specific Multicast (SSM), and define a range of IP multicast addresses. The default keyword defines the SSM range as ff3x::/32. To define a SSM range other than the default, specify an access-list.
When an SSM range of IP multicast addresses is defined with this command, the no (*,G) or (S,G,rpt) state is initiated for groups in the SSM range.
The messages corresponding to these states are not accepted or originated in the SSM range.
Use the no form of this command to disable the SSM range.
Command Syntax
ipv6 pim ssm default
ipv6 pim ssm range (<1-99>|WORD)
ipv6 pim (vrf NAME|) ssm default
ipv6 pim (vrf NAME|) ssm range (<1-99>|WORD)
no ipv6 pim ssm
no ipv6 pim (vrf NAME|) ssm
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
default
Defines the FF3x::/32 group range for SSM
range
Define an access-list for group range to use for SSM
<1-99>
Range of values for a standard access-list
WORD
A named standard access list
Command Mode
Configure mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
The following example shows how to configure SSM service for the IP address range defined by access list 10:
#configure terminal
(config)#access-list 10 permit 225.1.1.1
(config)#ipv6 pim ssm range 4
ipv6 pim state-refresh origination-interval
Use this command to configure a PIM State-Refresh origination interval other than the default value. The origination interval is the number of seconds between PIM State Refresh control messages.
Use the no option with this command to return the origination interval to its default value.
Command Syntax
ipv6 pim state-refresh origination-interval <1-100>
no ipv6 pim state-refresh origination-interval
Parameter
<1-100>
Range of values for state-refresh origination interval, in seconds
Note: No fractional values are allowed for the interval time.
Default
The default state-refresh origination interval is 60 seconds.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#interface eth0
(config-if)#ipv6 pim state-refresh origination-interval 65
(config)#interface eth0
(config-if)#no ipv6 pim state-refresh origination-interval
ipv6 pim unicast-bsm
Command Syntax
ipv6 pim unicast-bsm
no ipv6 pim unicast-bsm
Parameters
None
Default
Unicast bootstrap messaging is disabled by default.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#configure terminal
(config)#interface eth0
(config-if)#ipv6 pim unicast-bsm
(config)#interface eth0
(config-if)#no ipv6 pim unicast-bsm
show debugging ipv6 pim
Use this command to display the debug status for the IPv6 PIM process.
Command Syntax
show debugging ipv6 pim
show debugging ipv6 pim (vrf NAME|)
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
Command Mode
Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
# show debugging ipv6 pim
PIMv6 Debugging status:
PIMv6 event debugging is on
PIMv6 MFC debugging is on
PIMv6 state debugging is on
PIMv6 incoming packet debugging is on
PIMv6 outgoing packet debugging is on
PIMv6 Hello HT timer debugging is on
PIMv6 Hello NLT timer debugging is on
PIMv6 Hello THT timer debugging is on
PIMv6 Join/Prune JT timer debugging is on
PIMv6 Join/Prune ET timer debugging is on
PIMv6 Join/Prune PPT timer debugging is on
PIMv6 Join/Prune KAT timer debugging is on
PIMv6 Join/Prune OT timer debugging is on
PIMv6 Assert AT timer debugging is on
PIMv6 Register RST timer debugging is on
PIMv6 Bootstrap BST timer debugging is on
PIMv6 Bootstrap CRP timer debugging is on
PIMv6 mib debugging is on
PIMv6 nexthop debugging is on
PIMv6 mtrace debugging is on
PIMv6 NSM debugging is on
PIMv6 MSDP debugging is on
show ipv6 pim bsr-router
Use this command to show the bootstrap router v2 address.
Command Syntax
show ipv6 pim bsr-router
show ipv6 pim (vrf NAME|) bsr-router
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
Command Mode
Privileged Exec and Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show ipv6 pim bsr-router
PIMv2 Bootstrap information
This system is the Bootstrap Router (BSR)
BSR address: 3ffe:b00:c18:1::10
Uptime: 00:37:12, BSR Priority: 64, Hash mask length: 10
Next bootstrap message in 00:00:04
Role: Candidate BSR
State: Elected BSR
Candidate RP: fe80::5054:ff:fe21:5e56(eth1)
Advertisement interval 60 seconds
Next C-RP advertisement in 00:00:27
Table 5-22 explains the fields for each pim entry.
Table 5-22: show ipv6 pim bsr-router
Entry | Description |
|---|
BSR address | Address of the Bootstrap router (BSR). |
Uptime | As Stated. |
BSR Priority | The current priority of the BSR (this is configurable). |
Hash mask length | For Rendezvous Point (RP) addresses in the matching group-range-to-RP mappings, compute a value — Value(G,M,C(i))= (1103515245 * ((1103515245 * (G&M)+12345) XOR C(i)) + 12345) mod 2^31 where C(i) is the RP address and M is a hash-mask. |
Next bootstrap message | Time until next boostrap message. |
Role | AS stated.. |
State | As stated.. |
Candidate RP | Address of the rendezvous point (RP). |
Advertisement interval | As stated. |
Next C-RP advertisement | Time before the next Candidate RP is advertised. |
show ipv6 pim interface
Use this command to display information about interfaces configured for PIM.
Command Syntax
show ipv6 pim interface
show ipv6 pim interface detail
show ipv6 pim (vrf NAME|) interface
show ipv6 pim (vrf NAME|) interface detail
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
detail
Display detailed information about a PIM interface
Command Mode
Exec mode and Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#show ipv6 pim interface detail
eth1 (vif 0):
Address fe80::5054:ff:fe14:857, DR fe80::5054:ff:fe14:857
Hello period 30 seconds, Next Hello in 20 seconds
Triggered Hello period 5 seconds
Propagation delay is 1000 milli-seconds
Interface ID: Router-ID:1.1.1.1 Local-ID 3
Secondary addresses:
3ffe:192:168:10::53
Neighbors:
eth2 (vif 2):
Address fe80::5054:ff:fe52:219e, DR fe80::5054:ff:fe63:c0ae
Hello period 30 seconds, Next Hello in 20 seconds
Triggered Hello period 5 seconds
Propagation delay is 1000 milli-seconds
Interface ID: Router-ID:1.1.1.1 Local-ID 4
ECMP REDIRECT, bundle : bundle1, status : allowed
Secondary addresses:
3ffe:192:168:1::53
Neighbors:
fe80::5054:ff:fe21:5e56
fe80::5054:ff:fe29:f7f3
fe80::5054:ff:fe63:c0ae
Table 5-23 explains the fields for each pim entry.
Note: For show ipv6 pim (vrf NAME|) interface detail command:
• Output shall contain 'Bidirectional Forwarding Detection is enabled' in case PIMv6 BFD is enabled on an interface either by global command or at interface level.
• Output shall contain 'Bidirectional Forwarding Detection is disabled' in case PIMv6 BFD is explicitly disabled on an interface.
Table 5-23: show ipv6 pim interface detail
Entry | Description |
|---|
Interface name | As stated |
Address | The IPv6 address of the interface. |
DR | The IPv6 address of the Designated Router (DR). |
Hello period | When PIM is enabled on an interface or a router first starts, the Hello Timer of that interface is set to a random value between 0 and Triggered_Hello_Delay. This prevents synchronization of Hello messages if multiple routers are powered on simultaneously. After the initial randomized interval, Hello messages MUST be sent every Hello_Period seconds. The Hello Timer should not be reset except when it expires. |
Next Hello | The time period before the next Hello is sent. |
Triggered Hello period | A per-interface Hello Timer (HT(I)) is used to trigger sending Hello messages on each active interface. When PIM is enabled on an interface or a router first starts, the Hello Timer of that interface is set to a random value between 0 and Triggered_Hello_Delay. |
Propagation delay | The Propagation Delay field of the LAN Prune Delay option (if present) in the Hello message. |
ECMP REDIRECT | Whether Equal-Cost Multiple-Path (ECMP) is allowed and on which bundle. |
Secondary address | As stated. |
Neighbors | The IPv6 addresses of known Multicast neighbors. |
show ipv6 pim mroute
Use this command to display information the IPv6 multicast routing table, or the IPv6 multicast routing table based on the specified address or addresses.
Command Syntax
show ipv6 pim mroute (detail|)
show ipv6 pim mroute X:X::X:X (detail|)
show ipv6 pim mroute X:X::X:X X:X::X:X (detail|)
show ipv6 pim (vrf NAME|) mroute (detail|)
show ipv6 pim (vrf NAME|) mroute X:X::X:X (detail|)
show ipv6 pim (vrf NAME|) mroute X:X::X:X X:X::X:X (detail|)
Parameter
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
X:X::X:X
Display all entries for this group IPv6 address
X:X::X:X
Display all entries for this source IPv6 address
detail
Display detailed PIM multicast routing table information
Note: A group IP address and a source IP address cannot be used simultaneously.
Command Mode
Exec mode and Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show ipv6 pim mroute
IPv6 Multicast Routing Table
(*,*,RP) Entries: 0
(*,G) Entries: 2
(S,G) Entries: 1
(S,G,rpt) Entries: 1
FCR Entries: 1
(*, ff05::2)
RP: 3ffe:192:168:1::53
RPF nbr: ::
RPF idx: None
Upstream State: JOINED
Local i.i.............................
Joined j...............................
Asserted ................................
FCR:
(*, ff1e::10)
RP: 3ffe:192:168:1::53
RPF nbr: ::
RPF idx: None
Upstream State: JOINED
Local ................................
Joined ..j.............................
Asserted ................................
FCR:
Source: 3ffe:172:31:1::96
Outgoing ..o.............................
KAT timer running, 207 seconds remaining
Packet count 1
(3ffe:172:31:1::96, ff1e::10)
RPF nbr: fe80::202:a5ff:fe4f:1073
RPF idx: eth3
SPT bit: 0
Upstream State: JOINED
Local ................................
Joined ................................
Asserted ................................
Outgoing ..o.............................
(3ffe:172:31:1::96, ff1e::10, rpt)
RP: 3ffe:192:168:1::53
RPF nbr: ::
RPF idx: None
Upstream State: NOT PRUNED
Local ................................
Pruned ................................
Outgoing ................................
#
Table 5-24 explains the fields for each pim entry.
Table 5-24: show ipv6 pim mroute
Entries | Description |
|---|
(*,*,RP) Entries | Optional (*,*,RP) (RFC 4601), PIM Multicast Border Router feature and authentication using IPsec that lack sufficient deployment experience. this is obsoleted by RFC 7761. |
(*,G) Entries | A wild card Group entry for all sources within group G. |
(S,G) Entries | Source Specific to a Group. IGMPv3 permits a receiver to join a group and specify that it only wants to receive traffic for a group if that traffic comes from a particular source. |
(S, G, rpt) Entries | Source Specific to a Group and Rendezvous Point Tree entries. |
RP | Rendezvous Point address |
RPF nbr | “Reverse Path Forwarding Neighbor” address. The RPF Neighbor of a router with respect to an address is the neighbor that the MRIB indicates should be used to forward packets to that address. |
RPF idx | RPF interface (RP) is the interface the MRIB indicates would be used to route packets to the RP, except at the RP when it is the decapsulation interface (the “virtual” interface on which Register packets are received). |
SPT bit | The SPT bit is used to indicate whether forwarding is taking place on the (S,G) Shortest Path Tree (SPT) or on the (*,G) tree. |
Upstream State | The state of the a particular entry. States are: Local, Joined, Pruned Not Pruned, Asserted, or Outgoing. |
KAT timer running | Keep Alive Timer. |
Source | The Source address. |
show ipv6 pim neighbor
Use this command to display IPv6 PIM neighbor information.
Command Syntax
show ipv6 pim neighbor (detail|)
show ipv6 pim neighbor IFNAME (detail|)
show ipv6 pim neighbor IFNAME X:X::X:X (detail|)
show ipv6 pim (vrf NAME|) neighbor (detail|)
show ipv6 pim (vrf NAME|) neighbor IFNAME (detail|)
show ipv6 pim (vrf NAME|) neighbor IFNAME X:X::X:X (detail|)
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
IFNAME
Name of the interface
X:X::X:X
IPv6 address of the neighbor interface
detail
Display detailed information for a PIM neighbor
Command Mode
Exec mode and Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Examples
#show ipv6 pim neighbor detail
rtr6# show ipv6 pim neighbor detail
Nbr fe80::5054:ff:fe21:5e56 (eth2)
Expires in 83 seconds, uptime 01:37:14
Holdtime: 105 secs, T-bit: off, Lan delay: 1, Override interval: 3
DR priority: 1, Gen ID: 321289676,
Interface ID: Router-ID: 4.4.4.4 Local-ID: 4,
ECMP REDIRECT enabled
Secondary addresses:
3ffe:192:168:1::150
Nbr fe80::5054:ff:fe29:f7f3 (eth2)
Expires in 79 seconds, uptime 01:37:15
Holdtime: 105 secs, T-bit: off, Lan delay: 1, Override interval: 3
DR priority: 1, Gen ID: 847253139,
Interface ID: Router-ID: 2.2.2.2 Local-ID: 4,
ECMP REDIRECT enabled
Secondary addresses:
3ffe:192:168:1::149
Table 5-25 explains the fields for each pim entry.
Note: For show ipv6 pim (vrf NAME|) neighbor detail command:
• Output shall contain ‘Bidirectional Forwarding Detection is enabled’ in case PIMv6 BFD detection is enabled for this neighbor.
Table 5-25: show ipv6 pim Neighbor
Entry | Description |
|---|
Interface name | As stated |
Address | The IPv6 address of the interface. |
DR | The IPv6 address of the Designated Router (DR). |
Hello period | When PIM is enabled on an interface or a router first starts, the Hello Timer of that interface is set to a random value between 0 and Triggered_Hello_Delay. This prevents synchronization of Hello messages if multiple routers are powered on simultaneously. After the initial randomized interval, Hello messages MUST be sent every Hello_Period seconds. The Hello Timer should not be reset except when it expires. |
Next Hello | The time period before the next Hello is sent. |
Triggered Hello period | A per-interface Hello Timer (HT(I)) is used to trigger sending Hello messages on each active interface. When PIM is enabled on an interface or a router first starts, the Hello Timer of that interface is set to a random value between 0 and Triggered_Hello_Delay. |
Propagation delay | The Propagation Delay field of the LAN Prune Delay option (if present) in the Hello message. |
ECMP REDIRECT | Whether Equal-Cost Multiple-Path (ECMP) is allowed and on which bundle. |
Secondary address | As stated. |
show ipv6 pim nexthop
Use this command to display the nexthop information from NSM as used by IPv6 PIM.
Command Syntax
show ipv6 pim nexthop
show ipv6 pim (vrf NAME|) nexthop
Parameter
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
Command Mode
Exec mode and Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show ipv6 pim nexthop
Flags: N = New, R = RP, S = Source, U = Unreachable
Destination Type Nexthop Nexthop Nexthop Nexthop Metric Pref Refcnt
Num Addr Ifindex Name
_____________________________________________________________________________________
2001:db8:10:5::153 .RS. 1 fe80::20e:cff:fe01:facc 2 30 110 1
show ipv6 pim local-members
Use this command to display information about local membership for PIM interfaces.
Command Syntax
show ipv6 pim local-members
show ipv6 pim local-members IFNAME
show ipv6 pim (vrf NAME|) local-members
show ipv6 pim (vrf NAME|) local-members IFNAME
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
IFNAME
Display neighbors for an interface name
Command Mode
Privileged Exec and Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show ipv6 pim local-members
PIM Local membership information
eth1:
(*, ff05::2) : Include
eth2:
(*, ff05::2) : Include
(*, ff1e::10) : Include
#
Table 5-26 explains the fields for each pim entry.
Table 5-26: show ipv6 pim local-members output
Entries | Description |
|---|
Port | Port name |
(*, G) | State that maintains the Rendezvous Point for the Group (G). |
show ipv6 pim rp-hash
Use this command to display the rendezvous point (RP) based on the group selected.
Command Syntax
show ipv6 pim rp-hash X:X::X:X
show ipv6 pim (vrf NAME|) rp-hash X:X::X:X
Parameters
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
X:X::X:X
Specify a group address
Command Mode
Privileged Exec mode and Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show ipv6 pim rp-hash ff1e::10
RP: 3ffe:192:168:1::57
Info source: 3ffe:192:168:1::57, via bootstrap
#
Table 5-27 explains the fields for each pim entry.
Table 5-27: show ipv6 pim rp-hash
Entries | Description |
|---|
RP | Address of the Rendezvous Point |
Info source | Address of the information source. In this case the information comes from the Bootstrap router. |
show ipv6 pim rp mapping
Use this command to display the mappings for the PIM group to the active rendezvous points.
Command Syntax
show ipv6 pim rp mapping
show ipv6 pim (vrf NAME|) rp mapping
Parameter
vrf
The VPN routing/forwarding instance
NAME
Specify the name of the VPN routing/forwarding instance
Command Mode
Privileged Exec mode and Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#sh ipv6 pim rp mapping
PIM Group-to-RP Mappings
Override RP cnt: 0
Group(s): ff00::/8, Static
RP: aab1:23::1
Uptime: 00:05:44
RP: a121:33::1
Uptime: 00:00:29
RP: 3ffe:172:31:12::2
Uptime: 00:14:54
Embedded RP Groups: