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
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 allOutput 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