Monitoring PIM

You can display information about PIM events and parameters.

Monitoring PIM Events

You can use the debug PIM commands to view information about PIM events.

debug ip pim

Use to show information about the selected event.
To control the type of events displayed, specify a severity level.
To control how much information to display, specify a verbosity level.
Example
host1#debug ip pim events severity 1 verbosity low
Use the no version to disable the display.
See debug ip pim.

undebug ip pim

Use to turn off the display of information previously enabled with the debug ip pim command.
Example
host1#undebug ip pim events
There is no no version.
See undebug ip pim.

Monitoring PIM Settings

You can use the show ip pim commands to display information about PIM settings.

show ip pim

Use to view general PIM router-level information.
Field descriptions
- Default PIM Version—Default PIM version number (always 2)
- Default Domain Id—Default Domain Id (always 0)
- Default Hello period—Default interval (in minutes) at which the router sends hello messages to neighbors
- Default Hello Hold Time—Default time (in minutes) for which the router keeps the neighbor state alive
- Join-Prune Interval—Interval value (in seconds) set in the join/prune message originated by the PIM router
- Join-Prune Holdtime— Hold time value (in seconds) set in the join/prune messages originated by the PIM router. The hold time is 3.5 times the PIM join/prune message interval value.
- Keepalive Period—Time SG join state is maintained in the absence of SG Join message
- Assert Time—Period after last assert before assert state is timed out
- Register Suppression Time—Period during which a designated router stops sending registers to the RP
- Register Probe Time—Time before register suppression time (RST) expires when a designated router might send a NULL-Register to the RP
- Register TTL—TTL value (in PIM register packets) originated by this PIM router
- SSM—State of SSM on this PIM router (enabled or disabled)
- range—Default SSM group range or name of the access list specifying the range
- Sparse-Mode Graceful Restart Duration—Restart interval in seconds
- Join filter—Name of the join filter access-list (if configured) for this PIM router
- Designated Router Priority—Designated router priority value

Example

host1:1#show ip pim
Default PIM Version: 2
Default Domain Id: 0
Default Hello Period: 30
Default Hello HoldTime: 105
Join-Prune Interval: 100
Join-Prune Holdtime: 350
Keepalive Period: 210
Assert Time: 210
Register Suppression Time: 60
Register Probe Time: 5
Register TTL: 64
SSM enabled, range default
Sparse-Mode Graceful Restart Duration: 30
Graceful restart is complete (timer 0 seconds)
Join filter, access-list bronze
Designated Router Priority: 2

See show ip pim.

show ip pim auto-rp

Use to display information about RP routers and the RP mapping agent in a PIM sparse mode environment.
Field descriptions
- Configured with ttl—Number of hops for which the RP discovery message is valid
- Using interface addr—IP address of the interface from which the router sends RP discovery messages
- interval—Time interval, in seconds, at which the router sends RP discovery messages
- PIM AutoRP candidate RP mapping(s)—Routers that the RP mapping agent is evaluating to determine an RP router for this interface

Example 1

host1:1#show ip pim auto-rp 
This PIM router is an Auto RP mapping agent.
  Configured with ttl 64
  [ Using interface addr 121.0.0.1, interval 60 ].
PIM AutoRP candidate RP mapping(s)

Example 2

host1:1# show ip pim auto-rp
This PIM router is _not_ an Auto RP mapping agent.
PIM AutoRP candidate RP mapping(s)
Candidate RP 122.0.0.1
  Group(s) 224.0.0.0/4, AutoRP, ttl 64, interval 60, from access List 1
Candidate RP 122.0.0.1
  Group(s) 224.0.1.39/32 (negative), AutoRP, ttl 64, interval 60, from access List 1
Candidate RP 122.0.0.1
  Group(s) 224.0.1.40/32 (negative), AutoRP, ttl 64, interval 60, from access List 1

See show ip pim auto-rp.

show ip pim bsr

Use to display BSR information and the group prefixes for which the local router is a candidate RP in a PIM sparse mode environment.
Field descriptions
- Candidacy—Whether the router is a candidate BSR
- Configured on—Interface on which the router is configured
- address—Address of the router
- hashMaskLen—Hash mask length
- priority—Priority of the router
- period—Time between bootstrap messages, in seconds
- Elected BSR—This router or IP address of the elected bootstrap router
- next BSM—If BSR is this router, time until the next bootstrap message is sent, in seconds
- expires in—If BSR is not this router, time until the elected BSR expires if no bootstrap messages are received
- Local candidate RP mapping(s)—Routers that the mapping agent is evaluating to determine an RP router for this interface

Example 1—On a router that is the elected BSR

host1:1#show ip pim bsr

This PIM router is a Candidate BSR.
  Configured on intf ATM3/0.101, address: 101.0.0.1
  hashMaskLen 30, priority 2, period 60 seconds.
Elected BSR is this router, next BSM in 3 seconds.

Local candidate RP mapping(s):
Candidate RP 101.0.0.1
  224.0.0.0/4, BSR, hold-time 150, interval 60, priority 192
  228.0.0.0/24, BSR, hold-time 150, interval 60, priority 192, from access-list acl
  230.0.0.0/24, BSR, hold-time 150, interval 60, priority 192, from access-list acl

Example 2—On a router that is a candidate BSR

host1:1#show ip pim bsr
This PIM router is a Candidate BSR.
  Configured on intf ATM3/0.100, address: 100.0.0.1
  hashMaskLen 30, priority 2, period 60 seconds.
Elected BSR is 101.0.0.1 (priority 0), expires in 73 seconds.

Example 3—On a router that is not a candidate BSR

host1:1#show ip pim bsr
This PIM router is not a Candidate BSR.
Elected BSR is 101.0.0.1 (priority 0), expires in 73 seconds.

See show ip pim bsr.

show ip pim data-mdt

Use to display information about active data MDTs.
To display information about data MDTs on which the provider edge transmits data, use the sender keyword.
To display information about data MDTs on which the provider edge receives data, use the receiver keyword.
To display information about an IP PIM group address pool, use the group keyword.
To display a summary of configuration for each data MDT, use the summary keyword.
To display the number of data MDTs, use the count keyword.
Field descriptions
- PE Name—Name of the PE
- C-SG—Address of the C-SG
- P-SG—Address of the P-SG
- MTI—Name of the dynamic IP tunnel on which the data MDT was created
- Data rate/Threshold—Rate and threshold of multicast data
- Time until next MDT Join TLV—Configured delay until next MDT Join TLV
- Time until MDT Join TLV expires—Configured delay until MDT Join TLV expires
- Time until switchover from default-MDT—Configured delay until the data MDT switches over to the default MDT

Example 1—Displays information about a data MDT sender

host1:PE1#show ip pim data-mdt 225.1.1.1
PE11 - Sender
  C-SG: 10.11.0.100, 225.1.1.1
  P-SG: 1.1.1.1, 235.0.1.1
  MTI: TUNNEL gre:mvpn-dynamic-1
    Data rate/Threshold: 10012/500 Kbps
    Time until next MDT Join TLV: 25 seconds

Example 2—Displays information about a data MDT receiver

host1:PE1#show ip pim data-mdt 225.2.2.2
PE31 - Receiver
  C-SG: 10.13.0.100, 225.2.2.2
  P-SG: 3.3.3.3, 235.0.1.1
  MTI: TUNNEL gre:mvpn-dynamic-3
    Time until MDT Join TLV expires: 29 seconds

Example 3—Displays a summary of data MDT senders

host1:PE1#show ip pim data-mdt senders summary

VRF    S/R       C-Group     C-Source      P-Group    P-Source           MTI           
----   -------   ---------   -----------   ---------  --------   ---------------
PE11   Sender   225.1.1.1   10.11.0.100    235.0.1.1  1.1.1.1    TUNNEL gre:mvpn-dynamic-1
PE12   Sender   225.1.1.1   10.12.0.100    235.0.1.2  1.1.1.1    TUNNEL gre:mvpn-dynamic-2

Counts: 2 senders, 0 receivers, total 3.

Example 4—Displays the number of data MDT senders and receivers

host1:PE1#show ip pim data-mdt count
Counts: 2 senders, 1 receivers, total 3.

See show ip pim data-mdt.

show ip pim dense-mode sg-state

Use to display information for each (Source, Group) pair for PIM dense mode.
Field descriptions
- (Source, Group) pair—IP addresses of multicast source and group
- EntryExpires—Time until the (S,G) pair entry expires
- RPF Route—Reverse-path forwarding route
- IIF—IP address of incoming interface
- UpNbr—IP address of upstream neighbor
- Pruned Oifs—Outgoing interfaces that have been pruned
  - Address—IP address of outgoing interface
  - IfId—Index of the interface
  - Pruned due to—Reason for prune: assert or explicit prune
  - Pruned time remaining—Time in seconds until the prune expires

Example

host1:8#show ip pim dense-mode sg-state 
PIM DM route table and pruned oif information
<122.0.0.1, 224.0.1.39>   EntryExpires: 99
  RPF Route: 122.0.0.0/255.0.0.0   IIF: 107.0.8.4   UpNbr: 107.0.4.8
  Pruned Oifs: 
   Address: 108.0.8.5   IfId: 95
    Pruned due to assert 
    Pruned time remaining 129
<130.0.0.2, 224.0.1.39>   EntryExpires: 100
  RPF Route: 130.0.0.0/255.0.0.0   IIF: 107.0.8.4   UpNbr: 107.0.4.8
  Pruned Oifs: 
   Address: 108.0.8.5   IfId: 95
    Pruned due to assert 
    Pruned time remaining 130
<121.0.0.1, 224.0.1.40>   EntryExpires: 102
  RPF Route: 121.0.0.0/255.0.0.0   IIF: 107.0.8.4   UpNbr: 107.0.4.8
  Pruned Oifs: 
   Address: 108.0.8.5   IfId: 95
    Pruned due to assert 
    Pruned time remaining 133

See show ip pim dense-mode sg-state.

show ip pim interface

Use to display information about PIM interfaces.
Specify no keywords or variables to view information about all PIM interfaces.
Provide an interface type and specifier (such as atm 3/0) to display information about that interface only. For details about interface types and specifiers, see Interface Types and Specifiers in JunosE Command Reference Guide.
Specify the summary keyword to view the number of configured, enabled, and disabled PIM dense mode, PIM sparse mode, and PIM sparse-dense mode interfaces.
Specify the count keyword to view the number of multicast packets that the interface has sent and received.
Field descriptions
- Interface Addr—IP address of the interface
- Interface Name—Type and specifier of the interface. For details about interface types and specifiers, see Interface Types and Specifiers in JunosE Command Reference Guide.
- Ver—Version of PIM running on this interface
- Mode—PIM mode running on this interface: Sparse, Dense, or SparseDense
- Nbr Count—Number of neighbors connected to this interface
- Hello Intvl—Time interval, in seconds, at which the interface sends hello messages to neighbors
- J/P Interval—Time interval, in seconds, at which the interface sends the join/prune messages
- DR Addr—Address of the designated router
- SM—Number of PIM sparse mode interfaces
- DM—Number of PIM dense mode interfaces
- SM/DM—Number of PIM sparse-dense mode interfaces
  - enabled—Number of interfaces administratively enabled
  - disabled—Number of interfaces administratively disabled
- DR Pri— Designated router priority value
- ControlPktCount In|Out—PIM messages received on and sent from this interface
  - Hello—Total number of hello messages
  - JoinPrune—Total number of join and prune messages
  - Assert—Total number of assert messages

Example 1

host1# show ip pim interface
PIM Interface Table
Interface Addr Interface   State Ver Mode    Nbr    Hello  J/P    DR    DR Addr   JoinFilter
                                             Count  Intvl  Intvl  Pri
101.0.0.1      ATM2/0.100  Up     2  Sparse   1      30    150     5    101.0.0.2  -
102.0.0.1      ATM2/0.101  Up     2  Sparse   1      30    100     2    102.0.0.2  silver
103.0.0.1      ATM3/0.102  Up     2  Sparse   1      30    100     2    103.0.0.1  gold

Example 2

host1#show ip pim interface summary
PIM Interface Summary
  SM:    0, 0 enabled, 0 disabled
  DM:    0, 0 enabled, 0 disabled
  SM/DM: 1, 0 enabled, 1 disabled

Example 3

host1#show ip pim interface count
PIM Interface Count
Interface Addr  Interface Name       ControlPktCount In|Out
                                     Hello     JoinPrune  Assert
192.32.10.20    ATM3/0.20             0         0           0
                                      0         0           0

See show ip pim interface.

show ip pim neighbor

Use to display information about PIM neighbors that the router discovered.
Provide an interface type and specifier (such as atm 3/0) to display information about that interface only. For details about interface types and specifiers, see Interface Types and Specifiers in JunosE Command Reference Guide.
Field descriptions
- Neighbor Addr—IP address of the neighbor
- Interface Name—Type and specifier of the interface to which the neighbor connects. For details about interface types and specifiers, see Interface Types and Specifiers in JunosE Command Reference Guide.
- Uptime—Time since the router discovered this neighbor in days hours:minutes:seconds format
- Expires—Time available for the neighbor to send a hello message to the interface. If the neighbor does not send a hello message during this time, it no longer is a neighbor.
- Ver—Version of PIM that the neighbor is running
- Mode—PIM mode that the neighbor is using: Sparse, Dense, or SparseDense
- BFD—BFD status: up or down

Example

host1#show ip pim neighbor 

Neighbor
  Addr     Interface Name     Uptime    Expires    Ver    Mode    BFD
--------   ---------------   --------   --------   ---   ------   ---
1.1.1.1    FastEthernet1/1   00:02:49   00:01:27   2     Sparse        
Neighbor
  Addr     Interface Name     Uptime    Expires    Ver    Mode    BFD
--------   ---------------   --------   --------   ---   ------   ---
1.1.1.1    FastEthernet1/1   00:03:16   00:01:30   2     Sparse   up         
Neighbor
  Addr     Interface Name     Uptime    Expires    Ver    Mode    BFD
--------   ---------------   --------   --------   ---   ------   ----
1.1.1.1    FastEthernet1/1   00:00:07   00:01:39   2     Sparse   down

See show ip pim neighbor.

show ip pim rp

Use to display information about PIM group-to-RP mappings.
Specify the address of a group to view PIM group-to-RP mappings for a particular group.
Specify the mapping keyword to display all group-to-RP mappings that the router has recorded.
Field descriptions
- Group(s)—Prefix of the multicast group
- RP—IP address of RP router for the multicast group
- priority—Priority of the router
- via—Method by which the RP router was assigned: AutoRP, Static RP, or BSR
- expiryTime—Time in seconds at which the RP mapping becomes invalid, unless the mapping agent (access list) reassigns the RP router to this group

Example 1

host1:8#show ip pim rp mapping 
PIM Group-to-RP mapping(s)
Group(s) 224.0.0.0/4
  RP 122.0.0.1,  priority 0,  via  AutoRP, expiryTime 88
Group(s) 224.0.1.39/32 (negative)
  RP 122.0.0.1,  priority 0,  via  AutoRP (Negative), expiryTime 88
Group(s) 224.0.1.40/32 (negative)
  RP 122.0.0.1,  priority 0,  via  AutoRP (Negative), expiryTime 88

Example 2

host1:8#show ip pim rp mapping 
PIM Group-to-RP mapping(s)
Group(s) 224.0.0.0/4
  RP 134.0.0.1, priority 0, via Static, from access-list 1
Group(s) 232.0.0.0/16
  RP 134.0.0.1, priority 0, via BSR, expires in 121 seconds

See show ip pim rp.

show ip pim rp-hash

Use to show which RP router that a multicast group is using.
Field descriptions
- Group(s)—Multicast group or groups
- RP—RP router for the multicast group
- priority—Priority of the router
- via—Method by which the RP router was assigned: AutoRP, Static RP, or BSR
- expiryTime—Time in seconds at which the RP mapping becomes invalid, unless it is renewed by the mapping agent

Example 1

host1:2#show ip pim rp-hash 232.1.1.1
Group(s) 224.0.0.0/4
  RP 122.0.0.1,  priority 0,  via  AutoRP, expiryTime 128

Example 2

host1:2#show ip pim rp-hash 226.0.0.1
Group(s) 226.0.0.0/24
  RP 101.0.0.1, priority 192, via BSR, expires in 145 seconds
 *RP 145.0.0.3, priority 192, via BSR, expires in 145 seconds

See show ip pim rp-hash.

show ip pim sparse-mode sg-state

Use to display information for each (S,G) pair for PIM sparse mode and PIM SSM.
Field descriptions
- (S, G) pair—Source, Group pair for which information is provided
- Group-to-RP mapping—IP addresses and network mask of the multicast group
- RP—IP address of RP router
- SSM group—Indicator that this is an SSM group
- RPF Route—IP address and network mask of the RPF route
- IIF—IP address of the incoming interface for the RPF route
- UpNbr—IP address of the upstream neighbor
- Oifs—Outgoing interface
- Auto RP Discovery SELF oif—Indicates that RP router for this group was assigned through auto-RP
- Register Oif to RP—IP address of RP router for the outgoing interface; suppressed for SSM
- Address—IP address of outgoing interface
- Interface—Type and specifier of the interface. For details about interface types and specifiers, see Interface Types and Specifiers in JunosE Command Reference Guide.
- Joined as—Type of mapping
  - (S, G)—Mapping from a specific source to a specific group
  - (*, G)—Mapping from any source to a specific group
  - (*, * , RP)—Mapping from any source to any group
- Join expires—Number of seconds before the (S,G) membership expires
- Count of entries—Total counts of (S,G) pair mappings

Example

host1:2# show ip pim sparse-mode sg-state
<*, 224.0.1.40>
  Group-to-RP mapping: 224.0.0.0/240.0.0.0   RP: 123.0.0.1
  RPF Route: 123.0.0.0/255.0.0.0   IIF: 106.0.7.3   UpNbr: 106.0.3.7
  Oifs: 
   Auto RP Discovery SELF oif.
    Joined as <*, G>   
<*, 225.1.2.3>
  Group-to-RP mapping: 224.0.0.0/240.0.0.0   RP: 123.0.0.1
  RPF Route: 123.0.0.0/255.0.0.0   IIF: 106.0.7.3   UpNbr: 106.0.3.7
  Oifs: 
   Address: 78.7.7.7   Interface: loopback7
    Local group membership present.
<*, 235.1.1.1>
  Group-to-RP mapping: 224.0.0.0/240.0.0.0   RP: 123.0.0.1
  RPF Route: 123.0.0.0/255.0.0.0   IIF: 106.0.7.3   UpNbr: 106.0.3.7
  Oifs: 
   Address: 78.7.7.7   Interface: loopback7
    Local group membership present.
<118.1.33.34, 232.0.0.1>   
  SSM Group
  RPF Route: 118.1.0.0/255.255.0.0   IIF: 118.1.0.1 (Directly attached)
  Oifs: 
   Register Oif to RP: 141.0.0.2 suppressed for SSM Group.
   Address: 134.0.0.1   Interface: ATM3/0.104
    Joined as <S, G>   Join Expires: 161
<118.1.33.35, 232.0.0.1>   
  SSM Group
  RPF Route: 118.1.0.0/255.255.0.0   IIF: 118.1.0.1 (Directly attached)
  Oifs: 
   Register Oif to RP: 141.0.0.2 suppressed for SSM Group.
   Address: 134.0.0.1   Interface: ATM3/0.104
    Joined as <S, G>   Join Expires: 161
<10.0.1.8, 235.1.1.1>      EntryExpires: 143
  Group-to-RP mapping: 224.0.0.0/240.0.0.0   RP: 123.0.0.1
  RPF Route: 10.0.0.0/255.0.0.0   IIF: 106.0.7.3   UpNbr: 106.0.3.7
  Oifs: 
   Address: 78.7.7.7   Interface: loopback7
    Joined as <*, G> 
Count of entries - <S, G>    : 3
                   <*, G>    : 3
                   <*, *, RP>: 0

See show ip pim sparse-mode sg-state.

show ip pim sparse-mode unicast-route

Use to display the unicast routes that PIM sparse mode is using.
Field descriptions
- Route—IP address and network mask for the unicast route
- RpfNbr—RPF neighbor
- Iif—Incoming interface for the unicast route
- Pref—Preference value for the unicast route
- Metric—Value of metric for the unicast route (type of metric varies with the unicast protocol)
- Count of entries—Number of unicast routes that PIM sparse mode is using

Example

host1:2#show ip pim sparse-mode unicast-route
PIM SM unicast route table information
Route                          RpfNbr          Iif             Pref  Metric
---------------------------------------------------------------------------
122.0.0.0      /255.0.0.0                       122.0.0.1       255   1
Count of entries: 1

See show ip pim sparse-mode unicast-route

show ip pim spt-threshold

Use to display the threshold for switching to the shortest path tree at a PIM designated router.
Field descriptions
- Access List Name—Name of the IP access list that specifies the groups to which the threshold applies
- SptThreshold (in kbps)—Value at which PIM sparse mode switches from a shared tree to an SPT. A value of infinity indicates that PIM sparse mode never switches to an SPT.

Example

host1:2#show ip pim spt-threshold
Access List Name                  SptThreshold(in kbps)
-------------------------------------------------------
1                                 infinity

See show ip pim spt-threshold.