Monitoring PIM

[Contents] [Prev] [Next] [Index] [Report an Error] [No Frames]

JUNOSe 9.1.x Multicast Routing Configuration Guide > Configuring PIM for IPv6 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 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.
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.
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

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

Join filter—Name of the join filter access-list (if configured) for this PIM router
Example
host1:1#show ipv6 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
Join filter, access-list bronze
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.
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 JUNOSe Command Reference Guide, About This 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 JUNOSe Command Reference Guide, About This 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

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

ControlPkt Count In | Out—PIM messages received on and sent from this interface

Hello—Number of hello messages

JoinPrune—Number of join and prune messages

Assert—Number of assert messages

Example 1
host1#show ipv6 pim interface
PIM Interface Table
Interface Addr  Interface Name        Ver Mode        Nbr   Hello  DR Addr
                                                      Count Intvl
::108:85        atm2/1.108            2   Sparse      1     30     ::108:85
::107:84        atm2/1.109            2   Sparse      1     30     ::107:84
::111:89        atm2/0.110            2   Sparse      1     30     ::111:89
::110:8c        loopback8             2   Sparse      0     30     ::110:8c
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
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 JUNOSe Command Reference Guide, About This 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 JUNOSe Command Reference Guide, About This 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
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 JUNOSe Command Reference Guide, About This 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 JUNOSe Command Reference Guide, About This 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
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
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
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 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 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
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
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

[Contents] [Prev] [Next] [Index] [Report an Error] [No Frames]