# 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 ipv6 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 ipv6 pim events severity 1 verbosity low
- Use the no version to disable the display.
- See debug ipv6 pim.

undebug ipv6 pim

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

## Monitoring PIM Settings

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

show ipv6 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 message 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
  - 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 ipv6 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 ipv6 pim.

show ipv6 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 or not 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
  - 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
  - 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 ipv6 pim bsr
      This PIM router is a Candidate BSR.
        Configured on intf ATM3/0.101, address: ::107:9
        hashMaskLen 30, priority 2, period 60 seconds.
      Elected BSR is this router, next BSM in 3 seconds.
      Local candidate RP mapping(s):
      Candidate RP ::107:9
      ::108:86, BSR, hold-time 150, interval 60, priority 192
      ::108:87, BSR, hold-time 150, interval 60, priority 192, from access-list acl
      ::108:88, 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 ipv6 pim bsr
      This PIM router is a Candidate BSR.
        Configured on intf ATM3/0.100, address: ::107:9
        hashMaskLen 30, priority 2, period 60 seconds.
      Elected BSR is ::107:8 (priority 0), expires in 73 seconds.

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

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

- See show ipv6 pim bsr.

show ipv6 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 detail keyword to view detailed information for all PIM interfaces or for a specified PIM interface.
- Specify the summary keyword to view the number of configured, enabled, and disabled PIM sparse-mode interfaces.
- Specify the count keyword to view the number of multicast packets that the interface has sent and received.
- Field descriptions
  - Interface Addr—IPv6 address of the interface
  - Interface Name—Type and identifier 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
  - Nbr Count—Number of neighbors connected to this interface
  - Hello Intvl—Time interval at which the interface sends hello messages to neighbors
  - J/P Interval—Total number of join/prune message interval, in seconds, at which the interface sends the join/prune messages
  - DR Address—Address of the designated router
  - SM—Number of PIM sparse mode interfaces
    - enabled—Number of interfaces administratively enabled
    - disabled—Number of interfaces administratively disabled
  - ▪ DR Pri— Designated router priority value
  - ControlPkt Count In | Out—PIM messages received on and sent from this interface
    - Hello—Number of hello messages
    - JoinPrune—Total number of join and prune messages
    - Assert—Number of assert messages
- Example 1

      host1# show ipv6 pim interface

      PIM Interface Table
      Interface Addr Interface   State Ver Mode    Nbr    Hello  J/P    DR    DR Addr   JoinFilter
                                                   Count  Intvl  Intvl  Pri
      101::1         ATM2/0.100  Up     2  Sparse   1      30    150     5    101::2    -
      102::1         ATM2/0.101  Up     2  Sparse   1      30    100     2    102::2    silver
      103::1         ATM3/0.102  Up     2  Sparse   1      30    100     2    103::1    gold

- Example 2

      host1#show ipv6 pim interface summary
      PIM Interface Summary
        SM:    0, 0 enabled, 0 disabled

- Example 3

      host1#show ipv6 pim interface count
      PIM Interface Count
      Interface Addr  Interface Name       ControlPktCount In|Out
                                           Hello     JoinPrune  Assert
      ::107:84        ATM3/0.20             0         0           0
                                            0         0           0

- See show ipv6 pim interface

show ipv6 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.
- Specify the detail keyword to view detailed information for all PIM neighbors or for a specified PIM neighbor.
- Field descriptions
  - Neighbor Addr—IPv6 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
  - 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 will no longer be a neighbor.
  - Ver—Version of PIM that the neighbor is running
  - Mode—PIM mode that the neighbor is using: sparse
- Example

      host1#show ipv6 pim neighbor
      PIM Neighbor Table
      Neighbor Addr   Interface Name        Uptime         Expires  Ver Mode
      ::107:48        atm2/1.109            1d15:47:35     00:01:41 2   Sparse
      ::108:58        atm2/1.108            1d15:47:34     00:01:42 2   Sparse
      ::111:98        atm2/0.110            1d15:48:02     00:01:44 2   Sparse

- See show ipv6 pim neighbor

show ipv6 pim remote-neighbor

- Use to view information about PIM remote neighbors.
- Field descriptions
  - Remote Nbr Addr—IPv6 address of remote neighbor
  - OurEnd Addr—IPv6 address of local interface, such as the local endpoint of a tunnel, that transmits data to remote neighbor
  - Ver—Version of PIM running on the local interface
  - Mode—PIM mode running on the local interface; always PIM sparse mode
  - Nbr Count—Number of remote neighbors detected: 0 or 1
  - Hello Intvl—Time interval at which the interface sends hello messages to neighbors
  - DR Addr—Address of designated router
  - In interface—Type and identifier of the interface on which PIM router receives packets from remote neighbor. For details about interface types and specifiers, see Interface Types and Specifiers in JunosE Command Reference Guide.
  - Out interface—Type and identifier of the interface on which PIM router sends packets to remote neighbor. For details about interface types and specifiers, see Interface Types and Specifiers in JunosE Command Reference Guide.
- Example

      host1:boston#show ipv6 pim remote-neighbor
      PIM RemoteNbr Table
      RemoteNbr Addr  OurEnd Addr     Ver Mode        Nbr   Hello  DR Addr
                                                      Count Intvl
      1001::1         2001::1         2   Sparse      1     30     ::107:84
            In interface : atm2/1.109
            Out interface: atm2/1.108

- See show ipv6 pim remote-neighbor

show ipv6 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.
- To display all group-to-RP mappings that the router has recorded, specify the mapping keyword.
- Field descriptions
  - Group—Prefix of the multicast group
  - RP—IP address of RP router for the multicast group
  - priority—This field is not functional
  - via—Method by which the RP router was assigned (static, BSR)
- Example

      host1:8#show ipv6 pim rp mapping
      PIM Group-to-RP mapping(s)
      Group(s) ff00::/12
        RP ::122:1,  priority 0,  via  static
      Group(s) ff0e::1:0/96
        RP ::120:1,  priority 0,  via  static

- See show ipv6 pim rp

show ipv6 pim rp-hash

- Use to show which RP router a multicast group is using.
- Field descriptions
  - Group—Multicast group
  - RP—RP router for the multicast group
  - priority—This field is not functional
  - via—Method by which the RP router was assigned (static, BSR)
- Example

      host1:2#show ipv6 pim rp-hash 232.1.1.1
      Group(s) ff00::/12
        RP ::122:1,  priority 0,  via  static

- See show ipv6 pim rp-hash

show ipv6 pim sparse-mode sg-state

- Use to display information for each (S,G) entry for PIM sparse mode and PIM SSM.
- Field descriptions
  - Group-to-RP mapping—IPv6 addresses and network mask of the multicast group
  - RP—IPv6 address of RP router
  - SSM group—Indicates that this is an SSM group
  - RPF route—IPv6 address and network mask of the RPF route
  - IIF—IPv6 address of the incoming interface for the RPF route
  - UpNbr—IPv6 address of the upstream neighbor
  - Oifs—Outgoing interface
  - Register Oif to RP—IP address of RP router for the outgoing interface; suppressed for SSM
  - Address—IPv6 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 count of (S,G) pair mappings
- Example

      host1:2#show ipv6 pim sparse-mode sg-state
      PIM SM route table and oif information
      <*, ff0e::1:3>
        Group-to-RP mapping: ff00::/12 RP: ::123:1
        RPF Route: ::123:1/96 IIF: :106:73 UpNbr: ::106:37
        Oifs:
         Address: ::78:7:7 Interface: loopback7
          Local group membership present.
      <*, ff0e::a:1>
        Group-to-RP mapping: ff001:/12 RP: ::123:1
        RPF Route: :123:1/96 IIF: :106:73 UpNbr: :106:37
        Oifs:
         Address: ::78:7:7 Interface: loopback7
          Local group membership present.
      <::118:34, ff3e::1>
        SSM Group
        RPF Route: ::118:0/96 IIF: :118:1 (Directly attached)
        Oifs:
         Register Oif to RP: ::141:2 suppressed for SSM Group.
         Address: ::134:1 Interface: ATM3/0.104
          Joined as <S, G>   Join Expires: 161
      <::118:35, ff3e::1>
        SSM Group
        RPF Route: ::118:0/96 IIF: ::118:1 (Directly attached)
        Oifs:
         Register Oif to RP: ::141:2 suppressed for SSM Group.
         Address: ::134:1 Interface: ATM3/0.104
          Joined as <S, G>   Join Expires: 161
      <::10:8, ff0e::5:1>      EntryExpires: 143
        Group-to-RP mapping: ff00::/12 RP: ::123:1
        RPF Route: ::10:0/96 IIF: ::106:73 UpNbr: ::106:37
        Oifs:
         Address: ::78:7:7 Interface: loopback7
          Joined as <*, G>
      Count of entries - <S, G>    : 3
                         <*, G>    : 2
                         <*, *, RP>: 0

- See show ipv6 pim sparse-mode sg-state

show ipv6 pim sparse-mode unicast-route

- Use to display the unicast routes that PIM sparse mode is using.
- Field descriptions
  - Route—IPv6 address and network mask for the unicast route
  - RpfNbr—RPF neighbor
  - Iif—Incoming interface for the unicast route
  - Pref—Preference 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 ipv6 pim sparse-mode unicast-route
      PIM SM unicast route table information
      Route                          RpfNbr          Iif             Pref  Metric
      ---------------------------------------------------------------------------
      ::122:0       /96                              ::122:1         255   1
      Count of entries: 1

- See show ipv6 pim sparse-mode unicast-route

show ipv6 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 IPv6 access list that specifies the groups to which the threshold applies
  - SptThreshold (in kbps)—Value at which PIM sparse mode should switch from a shared tree to an SPT. A value of infinity indicates that PIM sparse mode should never switch to an SPT.
- Example

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

- See show ipv6 pim spt-threshold.