Displaying PIM data and configuration settings

Displaying PIM route data

Syntax:

show ip [mroute]

Without parameters, lists multicast route entries in the following situations:

  • When the PIM-DM router is actively forwarding a multicast flow out an interface (VLAN.)

  • On a PIM-DM originator router (source directly connected) when traffic is entering the router but not forwarding


    [NOTE: ]

    NOTE: The neighbor field will be empty in this case.


  • On a PIM-DM Non-originator router for a short duration after a flow's initial flood/prune cycle is seen. This entry is cleared after 5 minutes unless the flow is connected within that time period.

[Group Address]



The multicast group IP address for the specific flow (source-group pair.)

[Source Address]



The unicast address of the flow's source.

[neighbor]



The IP address of the upstream multicast router interface (VLAN) from which the multicast flow is coming. A blank field indicates that the multicast source is directly connected to the router.

[VLAN]



The interface on which the router receives the multicast flow.

Showing the route entry data on the “#2” routing switch

The next figure displays the show ip mroute output on the “8212zl #2” routing switch shown in Multicast network with a multinetted VLAN. This case illustrates two multicast groups from the same multicast source.

HP Switch(config)# show ip mroute
IP Multicast Route Entries
Total number of entries : 2
Group Address Source Address Neighbor VLAN
--------------- --------------- --------------- ----
239.255.255.1 10.27.30.2 10.29.30.1 29
239.255.255.5 10.27.30.2 10.29.30.1 29

Displays the PIM interfaces currently configured

Syntax

show ip [mroute] [interfacevid]

Lists the PIM interfaces (VLANs) currently configured in the routing switch.

  • VLAN: Lists the VID of each VLAN configured on the switch to support PIM-DM.

  • IP Address: Lists the IP addresses of the PIM interfaces (VLANs.)

  • Mode: Shows dense only.

Output for routing switch “#1”

HP Switch(config)# show ip mroute interface
PIM Interfaces
VLAN IP Address Mode
---- --------------- ------------
25 10.38.10.1 dense
27 10.27.30.1 dense
29 10.29.30.1 dense

Viewing VLAN, protocol identity, and TTL settings

Syntax:

show ip [mroute] [interface vid]

The show ip mroute interface command on routing switch "#2" in Multicast network with a multinetted VLAN

HP Switch(config)# show ip mroute interface 29
 IP Multicast Interface
  VLAN       :  29
  Protocol   :  PIM-DM
  TTL Threshold  :  0

Viewing data for a specified flow (multicast group)

Syntax:

show ip [mroute] [multicast-ip-addr source-ip-addr]

Lists the following data for the specified multicast flow (source-group pair):

[Group Address]



The multicast group IP address for the specified flow.

[Source Address]



The source IP address for the specified flow.

[neighbor]



Lists the IP address of the upstream next-hop router running PIM-DM; that is, the router from which the routing switch is receiving datagrams for the current multicast group.

This value is 0.0.0.0 if the routing switch has not detected the upstream next-hop router's IP address. This field is empty if the multicast server is directly connected to the routing switch.

[VLAN]



The interface on which the router receives the multicast flow.

[Up Time (Sec)]



The elapsed time in seconds since the routing switch learned the information for the current instance of the indicated multicast flow.


[NOTE: ]

NOTE: On an originator router, when a forwarding flow moves to a non-forwarding state (i.e. when pruned) the Up Time value for that flow is reset to 0.


[Expire Time (Sec)]



An mroute which is in a forwarding state — one which represents an active, connected flow for which there are downstream routers and/or locally connected hosts interested in the flow — does not expire. When other PIM-DM routers or locally connected hosts are no longer interested in an active flow, the related mroute on an originator router moves to a blocking state, and an mroute in this state does not expire either. In both cases the mroute is only removed by the system when it is no longer needed and so the displayed value for expire time in these situations is not meaningful.

For an mroute on an originator router whose flow is no longer active - including mroutes on non-originators whose flow has been pruned — expire time indicates when the mroute entry will eventually be cleared.

Multicast Routing Protocol

Identifies the multicast routing protocol through which the current flow was learned.

Unicast Routing Protocol

Identifies the IP routing protocol through which the routing switch learned the upstream interface for the current multicast flow. The listed protocol will be one of the following:

  • RIP

  • connected

  • OSPF

  • static route

  • other

Metric

Indicates the path cost upstream to the multicast source. Used when multiple multicast routers contend to determine the best path to the multicast source. The lower the value, the better the path.

Metric Pref

Used when multiple multicast routers contend to determine the path to the multicast source. When this value differs between routers, PIM selects the router with the lowest value. If Metric Pref is the same between contending multicast routers, then PIM selects the router with the lowest Metric value to provide the path for the specified multicast traffic. (Different vendors assign differing values for this setting.)

Asset Timer

The time remaining until the router ceases to wait for a response from another multicast router to negotiate the best path back to the multicast source. If this timer expires without a response from any contending multicast routers, then the router assumes it is the best path, and the specified multicast group traffic will flow through the router.

RP Tree

This field is not relevant to PIM-DM and will always display No.

Downstream interfaces

For each downstream interface the following information is shown:

[VLAN]



Lists the

[VID]

of the VLAN that the routing switch is using to send the outbound packets of the current multicast flow to the next-hop router.

[state]



Indicates whether the outbound VLAN and next-hop router for the current multicast flow are receiving datagrams.

Pruned

The routing switch has not detected any joins from the current multicast flow and is not currently forwarding datagrams in the current VLAN.

Forwarding

The routing switch has received a join for the current multicast flow and is forwarding datagrams in the current VLAN.

Up Time (Sec)

The natural state of a downstream interface in PIM-DM is to forward multicast flows and DM will flood a new flow out all interfaces on a router where there are connected PIM-DM neighbors and/or joined hosts. If there are ultimately no receivers for the flow downstream, the flow will be pruned back to the originator router. This prune state is maintained on all PIM-DM routers by state refresh message sends by the originator and corresponding prune replies from downstream routers. However if a prune reply is not received (i.e. there is now a receiver), expire time indicates how long before the interface will return to a forwarding state.

Expire Time (sec)

The natural state of a downstream interface in PIM-DM is to forward multicast flows and DM will flood a new flow out all interfaces on a router where there are connected PIM-DM neighbors and/or joined hosts. If there are ultimately no receivers for the flow downstream, the flow will be pruned back to the originator router. This prune state is maintained on all PIM-DM routers by state refresh message sends by the originator and corresponding prune replies from downstream routers. However if a prune reply is not received (i.e. there is now a receiver), expire time indicates how long before the interface will return to a forwarding state.

Output for routing switch "#1" in Multicast network with a multinetted VLAN

A populated neighbor field indicates that the multicast server is directly connected to the routing switch (neighbor field is highlighted in bold below.)

HP Switch(config)# show ip mroute 239.255.255.5 10.27.30.2
 IP Multicast Route Entry
  Group Address  : 239.255.255.5
  Source Address : 10.27.30.2
  Source Mask    : 255.255.255.0
  

Neighbor       : 10.30.229.1
  VLAN           : 27
  Up time (sec)     : 408
  Expire Time (sec) : 150
  Multicast Routing Protocol : PIM-DM 
  Unicast Routing Protocol   : rip

Downstream Interfaces
  VLAN State      Up time (sec)      Expire Time (sec)
  ---- ---------- ------------------ -----------------
  28   pruned     408                98

Show IP PIM

Syntax

show ip pim neighbors

Show PIM protocol operational and configuration information.

neighbors

Show PIM neighbor information.

show ip pim

PIM Global Parameters
PIM Status                   : Enabled
State Refresh Interval (sec) : 60 
Join/Prune Interval (sec)    : 60
SPT Threshold                : Enabled  
Traps                        : none

show ip pim neighbors

Lists PIM neighbor information for all PIM neighbors connected to the routing switch.

neighbor

Show PIM neighbor information.

IP Address,

Lists the IP address of a neighbor multicast router.

VLAN,

Lists the VLAN through which the routing switch connects to the indicated neighbor.

Up Time,

Shows the elapsed time during which the neighbor has maintained a PIM route to the routing switch.

Expire Time,

Indicates how long before the router will age-out a PIM neighbor/adjacency relationship on the specified interface (VLAN.) When a neighbor/adjacency expires and that neighbor was the last one on the interface, multicast data and state refresh packets will no longer be sent out that interface. Receipt of a periodic PIM hello message from the neighboring PIM router resets this timer to the hold time value stored in the hello message. If the ip-addr is specified then detailed information for the specified neighbor is shown.

IM Neighbors
IP Address      VLAN Up Time (sec)      Expire Time (sec) 
 --------------- ---- ------------------ ------------------
20.1.1.2        20   193                83

Listing the PIM interfaces (VLANs) currently configured in the routing switch

Syntax:

show ip pim [interface]

Lists the PIM interfaces (VLANs) currently configured in the routing switch.

[VLAN]



Lists the VID of each VLAN configured on the switch to support PIM-DM.

[ip address]



Lists the IP addresses of the PIM interfaces (VLANs.)

[mode]



Shows dense only.

Output for routing switch "#1" in Multicast network with a multinetted VLAN

HP Switch(config)# show ip pim interface
 PIM Interfaces
  VLAN IP Address      Mode
  ---- --------------- ------------
  25   10.38.10.1      dense
  27   10.27.30.1      dense
  29   10.29.30.1      dense

Viewing the current configuration for the specified VLAN (PIM interface)

Syntax:

show ip pim [interface [vid]]

Displays the current configuration for the specified VLAN (PIM interface.) See PIM interface configuration settings.

Output for routing switch "#1" in Multicast network with a multinetted VLAN

HP Switch(config)# show ip pim interface 29
 PIM Interface
  VLAN       : 29
  IP Address : 10.29.30.1
  Mode       : dense
  Hello Interval (sec) : 30
  Hello Delay (sec)    : 5
  Graft Retry Interval(sec) : 3
  Max Graft Retries         : 2
  Override Interval (msec)  : 2500     Lan Prune Delay           : Yes 
  Propagation Delay (msec)  : 500      Lan Delay Enabled         : No 
  SR TTL Threshold          : 2        State Refresh Capable     : No

PIM interface configuration settings

Field Default Control command
VLAN N/A vlan vid ip pim-dense
IP N/A vlan vid ip pim-dense any | ip-addr
Mode dense PIM-dense or PIM-sparse
Hello interval (sec) 30 ip pim-dense hello interval 5 - 30
Hello hold time 105 The routing switch computes this value from the current hello interval and includes it in the hello packets the routing switch sends to neighbor routers. Neighbor routers use this value to determine how long to wait for another hello packet from the routing switch. See the description of the hello interval on PIM VLAN (interface) configuration context.
Hello delay 5 vlan vid ip pim-dense hello delay 0 - 5
Graft retry interval (sec) 3 vlan vid ip pim-dense graft-retry-interval 1 - 10
Max graft retries 2 vlan vid ip pim-dense graft-retries 1 - 10
Override interval (msec) 2500 vlan vid ip pim-dense override-interval 500 - 6000
Propagation delay (msec) 500 vlan vid ip pim-dense propagation-delay 250-2000
SR TTL threshold (router hops) 0 vlan vid ip pim-dense ttl-threshold 0 - 255
LAN prune delay Yes vlan vid ip pim-dense lan-prune-delay
LAN delay enabled No Shows

[Yes]

if all multicast routers on the current VLAN interface enabled LAN-prune-delay. Otherwise, shows

[No]

State-refresh capable N/A Indicates whether the VLAN responds to state-refresh packets. The VLAN connected to the multicast source does not receive state-refresh packets and thus is not state-refresh capable. Downstream VLANs in the switches are state-refresh capable.

Viewing PIM-specific information from the IP multicast routing table (MRT)

Syntax:

show ip pim [mroute]

This command displays exactly the same output as the command

show ip [mroute]

.

Viewing the PIM route entry information for the specified multicast group (flow)

Syntax:

show ip pim [mroute[multicast-group-address
multicast-source-address]]

[Group Address]



Lists the specified multicast group address.

[Source Address]



Lists the specified multicast source address.

[Source Mask]



Lists the network mask for the multicast source address.

Metric

Indicates the path cost upstream to the multicast source. Used when multiple multicast routers contend to determine the best path to the multicast source. The lower the value, the better the path.

Metric Pref

Used when multiple multicast routers contend to determine the path to the multicast source. When this value differs between routers, PIM selects the router with the lowest value.

If Metric Pref is the same between contending multicast routers, PIM selects the router with the lowest Metric value to provide the path for the specified multicast traffic. (Different vendors assign differing values for this setting.)

Assert Timer

The time remaining until the routing switch ceases to wait for a response from another multicast router to negotiate the best path back to the multicast source. If this timer expires without a response from any contending multicast routers, the routing switch assumes it is the best path, and the specified multicast group traffic will flow through the routing switch.

Downstream Interfaces

[VLAN]



Lists the VID of the destination VLAN on the next-hop multicast router.

Prune Reason

Identifies the reason for pruning the flow to the indicated VLAN:

Prune

A neighbor multicast router has sent a prune request.

Assert

Another multicast router connected to the same VLAN has been elected to provide the path for the specified multicast group traffic.

Other

Used where the VLAN is in the pruned state for any reason other than the above two reasons (such as no neighbors exist and no directly connected hosts have done joins.)

Routing switch "#1" in Multicast network with a multinetted VLAN showing a multicast group from a directly connected source

HP Switch(config)# show ip pim mroute 239.255.255.1 10.27.30.2
 PIM Route Entry
   Group Address    : 239.255.255.1
   Source Address   : 10.27.30.2
   Source Mask      : 255.255.255.0
   Metric           :3
   Metric Pref      :120
   Assert Timer     : 0
Downstream Interfaces
 VLAN Prune Reason
 ---- ------------
 28   prune

Listing PIM neighbor information for all PIM neighbors connected to the routing switch

Syntax:

show ip pim [neighbor]

IP Address

Lists the IP address of a neighbor multicast router.

VLAN

Lists the VLAN through which the routing switch connects to the indicated neighbor.

Up Time

Shows the elapsed time during which the neighbor has maintained a PIM route to the routing switch.

Expire Time

Indicates how long before the routing switch ages-out the current flow (group membership.) This value decrements until:

  • Reset by a state-refresh packet originating from the upstream multicast router. (The upstream multicast router issues state-refresh packets for the current group as long as it either continues to receive traffic for the current flow or receives state-refresh packets for the current flow from another upstream multicast router.

  • Reset by a new flow for the current multicast group on the VLAN.

  • The timer expires (reaches 0.) In this case, the switch has not received either a state-refresh packet or new traffic for the current multicast group and ages-out (drops) the group entry.

If the ip-addr is specified, detailed information for the specified neighbor is shown.

PIM neighbor output

This example simulates output from routing switch “#1” in Multicast network with a multinetted VLAN. The data identifies the first downstream neighbor (“routing switch #2”.)

HP Switch(config)# show ip pim neighbor
 PIM Neighbors
  IP Address      VLAN Up Time (sec)      Expire Time (sec)
  --------------- ---- ------------------ ------------------
  10.29.30.2      29   196                89

Syntax:

show ip pim [neighbor [ ip-address ]]

Lists the same information as the show ip pim neighbor

Showing a specific neighbor

This example simulates output from routing switch “#1” in Multicast network with a multinetted VLAN. The data is from the first downstream neighbor (routing switch “#2”.)

HP Switch(config)# show ip pim neighbor 10.29.30.2
 PIM Neighbor
  IP Address  : 10.29.30.2
  VLAN        : 29
  Up Time (sec)     : 26
  Expire Time (sec) : 79