# 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.