clear pim join-distribution
Syntax
clear pim join-distribution <all> <instance instance-name> <logical-system (all | logical-system-name)>
Description
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.
Options
| all | (Optional) Clear
the PIM |
| none | 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
clear
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
Release Information
Command introduced in Junos OS Release 10.0.