Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?


clear pim join-distribution



Clear the PIM join-redistribute states.

Use the show pim source command to find out if there are multiple paths available for a source (for example, an RP).

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.



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


Automatically clear all PIM join/prune states.

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


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

Release Information

Command introduced in Junos OS Release 10.0.