| Sun Ethernet Fabric Operating System CLI Enterprise Reference Manual
|
   
|
PIMv6 |
PIMv6 is a portable software implementation of the PIM (sparse mode) specification for IPv6 networks. PIMv6 provides support for inter-domain routing between domains using PIMv6-SM. It also avoids the performance problems of earlier multicast routing protocols. This software provides multicast routing and forwarding capabilities to a router that runs the IPv6 protocol along with MLD. PIMv6 routes multicast data packets independent of any unicast routing protocol.
5.1 PIMv6 Commands
The list of CLI commands for the configuration of PIMv6 is as follows:
5.1.1 set ip pim
Enables or disables PIM globally.
| Note - In addition to the set ipv6 pim enable command, the set ip pim enable command must be executed to enable PIMv6.
|
set ip pim {enable | disable}
|
|
Syntax Description
|
enable - Enables PIM.
disable - Disables PIM.
|
|
Mode
|
Global Configuration
|
|
Defaults
|
Disabled.
|
|
Example
|
SEFOS(config)# set ip pim enable
|
|
Notes
|
- PIM mode will be set as sparse, when PIM is enabled globally.
- IGMP proxy service must be disabled in the system, before enabling the PIM globally.
|
5.1.2 set ipv6 pim
Enables or disables PIMv6 globally.
set ipv6 pim {enable | disable}
|
|
Syntax Description
|
enable - Enables PIMv6.
disable - Disables PIMv6.
|
|
Mode
|
Global Configuration
|
|
Defaults
|
Disabled.
|
|
Example
|
SEFOS (config)# set ipv6 pim enable
|
|
Notes
|
When PIMv6 is globally enabled, the mode will be sparse.
|
5.1.3 set ip pim threshold
Configures the SPT group or source threshold, when exceeded, switching to shortest path tree is initiated.
set ip pim threshold {spt-grp | spt-src} number-of-packets_0-2147483647
|
|
Syntax Description
|
spt-grp - The threshold of data rate for any group. When exceeded, source specific counters are initiated for that particular group. It is based on number of bits per second.
spt-src - The switching to shortest path tree is initiated when the threshold of data rate for any source is exceeded. It is based on number of bits per second.
number-of-packets_0-2147483647 - Number of packets.
|
|
Mode
|
Global Configuration
|
|
Defaults
|
0
|
|
Example
|
SEFOS (config)# set ip pim threshold spt-grp 50
|
5.1.4 set ip pim spt-switchperiod
Configures the period (in seconds) over which the data rate is to be monitored for switching to shortest path tree.
set ip pim spt-switchperiod seconds_0-2147483647
|
|
Mode
|
Global Configuration
|
|
Defaults
|
0
|
|
Example
|
SEFOS (config)# set ip pim spt-switchperiod 60
|
|
Notes
|
- The same period is used for monitoring the data rate for both source and group. To switch to SPT, this period must be configured.
- The SPT is used for multicast transmission of packets with the shortest path from sender to recipients.
|
5.1.5 set ip pim rp-threshold
Sets the threshold at which RP initiates switching to source specific shortest path tree.
set ip pim rp-threshold number-of-reg-pkts_0-2147483647
|
|
Mode
|
Global Configuration
|
|
Example
|
SEFOS (config)# set ip pim rp-threshold 200
|
5.1.6 set ip pim rp-switchperiod
Sets the period (in seconds) over which RP monitors register packets for switching to the source specific shortest path tree.
set ip pim rp-switchperiod seconds_0-2147483647
|
|
Mode
|
Global Configuration
|
|
Defaults
|
0
|
|
Example
|
SEFOS (config)# set ip pim rp-switchperiod 100
|
|
Notes
|
- To switch to SPT, this period must be configured
- RP-tree is a pattern that multicast packets are sent to a PIM-SM router by unicast and then forwarded to actual recipients from RP
|
5.1.7 set ip pim regstop-ratelimit-period
Sets the period over which RP monitors the number of register packets after sending the register stop message.
set ip pim regstop-ratelimit-period seconds_0-2147483647
|
|
Mode
|
Global Configuration
|
|
Defaults
|
5
|
|
Example
|
SEFOS (config)# set ip pim regstop-ratelimit-period 100
|
|
Notes
|
The register stop message is used to avoid encapsulation of multicast data packets from the first hop router to the RP.
|
5.1.8 set ip pim pmbr
Enables or disables the PMBR (PIM multicast border router) status.
set ip pim pmbr {enable | disable}
|
|
Syntax Description
|
enable - Enables the PMBR status.
disable - Disables the PMBR status.
|
|
Mode
|
Global Configuration
|
|
Defaults
|
Disabled.
|
|
Example
|
SEFOS (config)# set ip pim pmbr enable
|
|
Notes
|
- A PMBR integrates two different PIM domains (either PIM-SM or PIM-DM).
- A PMBR connects a PIM domain to other multicast routing domain(s).
|
5.1.9 set ip pim static-rp
Enables or disables the static RP configuration status. This command specifies whether to use the configured static RP.
set ip pim static-rp {enable | disable}
|
|
Syntax Description
|
enable - Enables the static RP configuration status.
disable - Disables the static RP configuration status.
|
|
Mode
|
Global Configuration
|
|
Defaults
|
Disabled.
|
|
Example
|
SEFOS (config)# set ip pim static-rp enable
|
5.1.10 ip pim component
Configures the PIMv6 component in the router. The no form of the command destroys the PIMv6 component.
ip pim component component-id_1-255
|
no ip pim component component-id_1-255
|
|
Mode
|
Global Configuration
|
|
Example
|
SEFOS(config)# ip pim component 1
|
|
Notes
|
- PIMv6 component 1 cannot be deleted, as it is the default component.
- The PIMv6 component corresponds to each instance of a PIMv6 domain and classifies it as sparse or dense mode. Currently, only sparse mode is supported.
|
5.1.11 ipv6 pim rp-candidate rp-address
Sets the address of the interface, which will be advertised as a candidate-RP. The no form of the command disables the address of the interface, which will be advertised as a candidate-RP.
ipv6 pim rp-candidate rp-address group-address group-mask rp-address
|
no ipv6 pim rp-candidate rp-address group-address group-mask rp-address
|
|
Syntax Description
|
group-address - IPv6 multicast group address.
group-mask - IPv6 multicast group address mask that gives the group prefix for which the entry contains information about RP.
rp-address - IPv6 address of the rendezvous point.
|
|
Mode
|
PIM Component
|
|
Example
|
SEFOS(pim-comp)# ipv6 pim rp-candidate rp-address ff02::e001:0000 112 3333::1111
|
|
Notes
|
A candidate-RP is a router configured to send periodic candidate-RP-advertisement messages to the BSR, and processes join/prune or register messages for the advertised group prefix, when it is elected as a RP.
|
5.1.12 ipv6 pim rp-static rp-address
Sets the address of the IPv6 interface, which will be advertised as a Static-RP. The no form of the command disables the address of the IPv6 interface, which will be advertised as a Static-RP.
ipv6 pim rp-static rp-address group-address group-mask rp-address
|
no ipv6 pim rp-static rp-address group-address group-mask rp-address
|
|
Syntax Description
|
group-address - IPv6 multicast group address.
group-mask - IPv6 multicast group address mask that gives the group prefix for which the entry contains information about RP.
rp-address - IPv6 address of the rendezvous point.
|
|
Mode
|
PIM Component
|
|
Example
|
SEFOS(pim-comp)# ipv6 pim rp-static rp-address ff02::e001:0000 112 3333::1111
|
|
Notes
|
The static configuration allows additional structuring of the multicast traffic by directing the multicast join or prune messages to statically configured RPs.
|
5.1.13 ipv6 pim query-interval
Sets the frequency at which PIMv6 hello messages are transmitted on the interface. The no form of the command sets the default hello timer interval for the interface.
ipv6 pim query-interval seconds_0-65535
|
no ipv6 pim query-interval
|
|
Mode
|
Interface Configuration
|
|
Defaults
|
30
|
|
Example
|
SEFOS (config-if)# ipv6 pim query-interval 60
|
|
Notes
|
The query message informs the presence of a PIMv6 router on the interface to the neighboring PIMv6 routers.
|
5.1.14 ipv6 pim message-interval
Sets the frequency at which the PIMv6 join or prune messages are transmitted on the PIMv6 interface. The no form of the command sets the default value for the PIMv6 join/prune messages.
ipv6 pim message-interval seconds_0-65535
|
no ipv6 pim message-interval
|
|
Mode
|
Interface Configuration
|
|
Defaults
|
60
|
|
Example
|
SEFOS (config-if)# ipv6 pim message-interval 120
|
|
Notes
|
The join/prune message interval used on all the PIMv6 routers in the PIMv6 domain must be the same. If all the routers do not use the same timer interval, the performance of PIMv6 sparse can be adversely affected.
|
5.1.15 ipv6 pim bsr-candidate
Sets the preference value for the local PIMv6 interface as a candidate bootstrap router. The no form of the command sets the default preference value for the local PIMv6 interface as a candidate bootstrap router.
ipv6 pim bsr-candidate 0-255
|
no ipv6 pim bsr-candidate
|
|
Mode
|
Interface Configuration
|
|
Defaults
|
0
|
|
Example
|
SEFOS (config-if)# ipv6 pim bsr-candidate 1
|
|
Notes
|
A BSR is a dynamically elected router within the PIMv6 domain.
|
5.1.16 ipv6 pim componentId
Adds the interface to the component.
ipv6 pim component-id_1-255
|
|
Mode
|
Interface Configuration
|
|
Defaults
|
1
|
|
Example
|
SEFOS (config-if)# ipv6 pim componentId 1
|
|
Notes
|
This command adds the current VLAN into the specified PIMv6 component.
|
5.1.17 ipv6 pim dr-priority
Sets the designated router priority value configured for the PIMv6 router interface. The no form of the command sets the default designated router priority value for the PIMv6 router interface.
ipv6 pim dr-priority 1-65535
|
|
Mode
|
Interface Configuration
|
|
Defaults
|
1
|
|
Example
|
SEFOS (config-if)# ipv6 pim dr-priority 100
|
|
Notes
|
The DR sets up multicast route entries and sends corresponding join/prune and register messages on behalf of directly-connected receivers and sources, respectively.
|
5.1.18 ipv6 pim override-interval
Sets the override interval configured for the PIMv6 router interface. The no form of the command sets the default override interval for the PIMv6 router interface.
ipv6 pim override-interval seconds_0-65535
|
no ipv6 pim override-interval
|
|
Mode
|
Interface Configuration
|
|
Defaults
|
0
|
|
Example
|
SEFOS (config-if)# ipv6 pim override-interval 100
|
|
Notes
|
The override interval is the random amount of time delayed for sending override messages to avoid synchronization of override messages when multiple downstream routers share a multi-access link.
|
5.1.19 ipv6 pim lan-delay
Sets the LanDelay configured for the PIMv6 router interface. The no form of the command sets the default LanDelay for the PIMv6 router per interface.
ipv6 pim lan-delay seconds_0-65535
|
|
Mode
|
Interface Configuration
|
|
Defaults
|
0
|
|
Example
|
SEFOS (config-if)# ipv6 pim lan-delay 120
|
|
Notes
|
The LAN delay inserted by a router in the LAN prune delay option expresses the expected message propagation delay on the interface. It is used by upstream routers to find out the delayed time interval for a Join override message before pruning an interface.
|
5.1.20 set ipv6 pim lan-prune-delay
Sets the LanPruneDelay bit configured for the PIMv6 router interface to advertise the LAN delay. The command specifies whether to use LAN prune delay or not.
set ipv6 pim lan-prune-delay {enable | disable}
|
|
Syntax Description
|
enable - Enables LAN-prune-delay.
disable - Disables LAN-prune-delay.
|
|
Mode
|
Interface Configuration
|
|
Defaults
|
Disabled.
|
|
Example
|
SEFOS (config-if)# set ipv6 pim lan-prune-delay enable
|
5.1.21 no ipv6 pim interface
Deletes the IPv6 PIM Interface. That is, this command destroys the interface at PIMv6.
|
Mode
|
Interface Configuration
|
|
Example
|
SEFOS (config-if)# no ipv6 pim interface
|
5.1.22 debug ipv6 pim
Enables PIMv6 trace. The no form of the command disables PIMv6 trace.
debug ipv6 pim {[nbr] [grp] [jp] [ast] [bsr] [io] [pmbr] [mrt] [mdh] [mgmt] | [all]}
|
no debug ipv6 pim {[nbr] [grp] [jp] [ast] [bsr] [io] [pmbr] [mrt] [mdh] [mgmt] | [all]}
|
|
Syntax Description
|
nbr - Neighbor Discovery traces
grp - Group Membership traces
jp - Join or Prune traces
ast - Assert state traces
bsr - Bootstrap/RP traces
io - Input Output traces
pmbr - Interoperability traces
mrt - Multicast Route Table Update traces
mdh - Multicast Data Handling traces
mgmt - Configuration traces
all - All traces
|
|
Mode
|
Privileged EXEC
|
|
Example
|
SEFOS# debug ipv6 pim all
|
|
Notes
|
A 4-byte integer value is specified for enabling the level of debugging. Each bit in the 4-byte integer variable represents a level of debugging. Combinations of levels are also allowed. The user has to enter the corresponding integer value for the bit set.
|
5.1.23 show ipv6 pim interface
Displays the PIMv6 interfaces of the router. The command shows the list of interface addresses, the mode of the interface, designated router on that interface, hello interval, join or prune interval of the interface.
show ipv6 pim interface [{Vlan vlan-id | detail}]
|
|
Syntax Description
|
Vlan - VLAN identifier.
detail - Detailed information of the interface.
|
|
Mode
|
Privileged EXEC
|
|
Example
|
SEFOS# show ipv6 pim interface
Address IfName/ Ver/ Nbr Qry DR DR
IfId Mode Count Interval Address Prio-
--------- ----- ----- ------ ------- ------- -----
fe80::2:a00:1 vlan1/33 2/Sparse 0 150 fe80::2:a00:1 1
fe80::2:1400:1 vlan2/34 2/Sparse 0 30 fe80::2:1400:1 1
fe80::2:1e00:1 vlan3/35 2/Sparse 0 30 fe80::2:1e00:1 1
|
|
|
SEFOS# show ipv6 pim interface vlan 1
Address IfName/ Ver/ Nbr Qry DR DR
IfId Mode Count Interval Address Prio-
--------- ----- ------ ------ ------- ------ -----
fe80::2:a00:1 vlan1/33 2/Sparse 0 150 fe80::2:a00:1 1
|
|
|
SEFOS# show ipv6 pim interface detail
vlan1 33 is up
Internet Address is fe80::2:a00:1
Muticast Switching : Enabled
PIM : Enabled
PIMv6 : Enabled
PIM version : 2, mode: Sparse
PIM DR : fe80::2:a00:1
PIM DR Priority : 1
PIM Neighbour Count : 0
PIM Hello/Query Interval : 150
PIM Message Interval : 200
PIM Override Interval : 0
PIM Lan Delay : 0
PIM Lan-Prune-Delay : Disabled
PIM Component Id : 1
PIM domain border : disabled
|
5.1.24 show ipv6 pim neighbor
Displays the PIMv6 neighbor(s) information of the router. It displays the neighbor address, the interface used to reach the PIMv6 neighbor, the up time (the time since this neighbor became the neighbor of the local router), expiry time (the minimum time remaining before this PIMv6 neighbor will be aged out), LAN delay and override interval.
show ipv6 pim neighbor [Vlan vlan-id]
|
|
Syntax Description
|
Vlan - VLAN identifier.
|
|
Mode
|
Privileged EXEC
|
|
Example
|
SEFOS# show ipv6 pim neighbor
Nbr If Uptime/ Ver DRPri/ Comp Over- Lan
Address Name Expiry Mode Id ride Delay
/Idx Interval
------------- --------- ------------ --- ------ ---- ---- -----
fe80::2:a00:a vlan1/33 00:02:33/0 v2 0/S 1 0 0
fe80::2:1400:a vlan2/34 00:02:33/0 v2 0/S 1 0 0
SEFOS# show ipv6 pim neighbor vlan 1
Nbr If Uptime/ Ver DRPri/ Comp Over- Lan
Address Name Expiry Mode Id ride Delay
/Idx Interval
------------- --------- ------------ --- ------ ---- ---- -----
fe80::2:a00:a vlan1/33 00:02:58/0 v2 0/S 1 0 0
|
5.1.25 show ipv6 pim rp-candidate
Displays the PIMv6 RP-candidate information. It displays the group addresses, the group mask and the RP address that indicates the IP address of the rendezvous point (RP) for the listed PIM Sparse group.
show ipv6 pim rp-candidate component-id_1-255
|
|
Mode
|
Privileged EXEC
|
|
Example
|
SEFOS# show ipv6 pim rp-candidate 1
CompId GroupAddress/PrefixLength RPAddress/Priority
------ ------------------------- ---------- -------
1 ff02::e000:0/112 3333::a00:1/192
|
5.1.26 show ipv6 pim rp-set
Displays the PIMv6 RP-set information. It displays details of the group prefix, RP address, hold time, and expiry time.
show ipv6 pim rp-set rp-address
|
|
Syntax Description
|
rp-address - Indicates the IPv6 address of the rendezvous point (RP) for the listed PIM sparse group.
|
|
Mode
|
Privileged EXEC
|
|
Example
|
SEFOS# show ipv6 pim rp-set 3333::a00:a
PIM Group-to-RP mappings
------------------------
Group Address : ff00::Group Mask : 8
RP: 3333::a00:a
Component-Id : 1
Hold Time : 102, Expiry Time : 00:00:35
|
5.1.27 show ipv6 pim bsr
This command displays the PIMv6 BSR information.
show ipv6 pim bsr component-id_1-255
|
|
Mode
|
Privileged EXEC
|
|
Example
|
SEFOS# show ipv6 pim bsr 1
PIMv2 Bootstrap Configuration For Component 1
------------------------------------------------
Elected BSR for Component 1
V6 BSR Address : 3333::a00:1
V6 BSR Priority : 100, Hash Mask Length : 126
This System is V6 Candidate BSR for Component 1
V6 BSR Address : 3333::a00:1
V6 BSR Priority : 100
|
5.1.28 show ipv6 pim rp-static
Displays the static RP information.
show ipv6 pim rp-static component-id_1-255
|
|
Mode
|
Privileged EXEC
|
|
Example
|
SEFOS# show ipv6 pim rp-static
Static-RP Enabled
CompId GroupAddress/PrefixLength RPAddress
------ ------------------------- ---------
1 ff02::1111:2222/64 3333::4444
|
5.1.29 show ipv6 pim component
Displays the component information.
show ipv6 pim component component-id_1-255
|
|
Mode
|
Privileged EXEC
|
|
Example
|
SEFOS# show ipv6 pim component 1
PIM Component Information
---------------------------
Component-Id: 1
PIM Mode: sparse, PIM Version: 2
Elected BSR: 10.0.0.1
Candidate RP Holdtime: 0
|
5.1.30 show ipv6 pim thresholds
Displays threshold configured for SPT, RP thresholds, and rate limit values for both SM and DM.
|
Mode
|
Privileged EXEC
|
|
Example
|
SEFOS# show ipv6 pim thresholds
PIM SPT Threshold Information
-----------------------------
Group Threshold : 111
Source Threshold : 222
Switching Period : 100
PIM SPT-RP Threshold Information
--------------------------------
Register Threshold : 333
RP Switching Period : 300
Register Stop rate limit : 400
|
5.1.31 show ipv6 pim mroute
Displays the IPv6 PIM mroute information.
show ipv6 pim mroute [ {component-id_1-255 | group group-address | source source-address} summary]
|
|
Syntax Description
|
component-id_1-255 - Component identifier.
group-address - Indicates the PIMv6 multicast group address using the listed RP.
source-address - The network address which identifies the sources for which this entry contains multicast routing information.
summary - Summary of PIMv6 mroute information.
|
|
Mode
|
Privileged EXEC
|
|
Example
|
SEFOS# show ipv6 pim mroute
IP Multicast Routing Table
--------------------------
Route Flags S: SPT Bit W: Wild Card Bit R: RPT Bit
Timers: Uptime/Expires
Interface State: Interface, State/Mode
PIM Multicast Routing Table For Component 1
(*, ff02::e001:0) ,00:03:54/---3401:510a::3401:51a) Incoming Interface : vlan1
,RPF nbr : fe80::2:a00:a ,Route Flags : WR
Outgoing InterfaceList :
vlan2, Forwarding/Sparse ,00:03:54/---
|
|
|
SEFOS# show ipv6 pim mroute group ff02::e001:0 summary
IP Multicast Routing Table
--------------------------
Route Flags S: SPT Bit W: Wild Card Bit R: RPT Bit
Timers: Uptime/Expires
PIM Multicast Routing Table For Component 1
(*, ff02::e001:0) ,00:02:49/---3401:510a::3401:51a) ,Route Flags : WR
|
|
|
SEFOS# show ipv6 pim mroute source ca8d:5102::ca8d:5102 summary
IP Multicast Routing Table
--------------------------
Route Flags S: SPT Bit W: Wild Card Bit R: RPT Bit
Timers: Uptime/Expires
(ca8d:5102::ca8d:5102,ff02::e001:0) ,00:01:04/04:01:45 ,Route Flags : ---
|
|
Notes
|
It shows details of the (S ,G) ,(*,G) and (*,*,RP) entries.
|
- ipv6 pim bsr-candidate - Sets the preference value for the local IPv6 interface as a candidate bootstrap router
| Sun Ethernet Fabric Operating System CLI Enterprise Reference Manual
|
E26514-03
|
|
Copyright © 2013, Oracle and/or its affiliates. All rights reserved.