JUNOSe 9.1.x Multicast Routing Configuration Guide > Configuring PIM for IPv4 Multicast > Monitoring PIM

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.

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.

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
• Default J / P Hold Time—Hold time value (in seconds) set in Join/Prune messages originated by this PIM router
• 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

• Example

host1:1#show ip pim

Default PIM Version: 2

Default Domain Id: 0

Default Hello Period: 30

Default Hello HoldTime: 105

Default J/P HoldTime: 210

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

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

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.

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.

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

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 JUNOSe Command Reference Guide, About This 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 JUNOSe Command Reference Guide, About This 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
• 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

• 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

Interface                                             Nbr    Hello                            BFD

  Addr         Interface      State   Ver    Mode    count   Intvl   DR Addr   JoinFilter Enabled

---------   ---------------   -----   ---   ------   -----   -----   -------   ----------   -----

1.1.1.2     FastEthernet1/1   up      2     Sparse   1       30      1.1.1.2   ---          yes      

Interface                                             Nbr    Hello                            BFD

  Addr         Interface      State   Ver    Mode    count   Intvl   DR Addr  JoinFilter  Enabled

---------   ---------------   -----   ---   ------   -----   -----   -------  ----------   ------

1.1.1.2     FastEthernet1/1   up      2     Sparse   1       30      1.1.1.2   ---          no      

• 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

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 JUNOSe Command Reference Guide, About This 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 JUNOSe Command Reference Guide, About This 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 

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

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

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 JUNOSe Command Reference Guide, About This 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

PIM SM route table and oif information

<*, 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

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

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