Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
 

Related Documentation

  • EX, J, M, MX, PTX, T Series, QFabric System, QFX Series standalone switches
  • show pim neighbors
  • show pim join
  • EX, M, MX, PTX, SRX, T Series, QFabric System, QFX Series standalone switches
  • join-load-balance in the Multicast Protocols Configuration Guide
 

clear pim join-distribution

Syntax

clear pim join-distribution<all><instance instance-name><logical-system (all | logical-system-name)>

Release Information

Command introduced in Junos OS Release 10.0.

Description

Redistribute the Protocol Independent Multicast (PIM) join states.

You can find out if there are multiple paths available for a source (for example, an RP) with the output of the show pim source command.

When you include the join-load-balance statement in the configuration, the PIM join states are distributed evenly on available equal-cost multipath links. When an upstream neighbor link fails, Junos OS redistributes the PIM join states to the remaining links. However, when new links are added or the failed link is restored, the existing PIM joins are not redistributed to the new link. New flows will be distributed to the new links. However, in a network without new joins and prunes, the new link is not used for multicast traffic. The clear pim join-distribution command redistributes the existing flows to the new upstream neighbors. Redistributing the existing flows causes traffic to be disrupted, so we recommend that you run the clear pim join-distribution command during a maintenance window.

Options

none—Clear PIM register message counters for all family addresses, instances, and interfaces.

all

(Optional) Clear the PIM join-redistribute states for all groups and family addresses in the master instance.

instance instance-name

(Optional) Redistribute the join states for a specific PIM-enabled routing instance.

logical-system (all | logical-system-name)

(Optional) Perform this operation on all logical systems or on a particular logical system.

Additional Information

The clear pim join-distribution command cannot be used to redistribute the PIM join states on a backup Routing Engine when nonstop active routing is enabled.

Required Privilege Level

clear

 

Related Documentation

  • EX, J, M, MX, PTX, T Series, QFabric System, QFX Series standalone switches
  • show pim neighbors
  • show pim join
  • EX, M, MX, PTX, SRX, T Series, QFabric System, QFX Series standalone switches
  • join-load-balance in the Multicast Protocols Configuration Guide
 

List of Sample Output

clear pim join-distribution all

Output Fields

When you enter this command, you are provided no feedback on the status of your request. You can enter the show pim join command before and after distributing the join state to verify the operation.

Sample Output

clear pim join-distribution all

user@host> clear pim join-distribution all

Modified: 2015-08-26

 

Related Documentation

  • EX, J, M, MX, PTX, T Series, QFabric System, QFX Series standalone switches
  • show pim neighbors
  • show pim join
  • EX, M, MX, PTX, SRX, T Series, QFabric System, QFX Series standalone switches
  • join-load-balance in the Multicast Protocols Configuration Guide
 

Modified: 2015-08-26