[no] pim
config>router
Supported on all 7210 SAS platforms as described in this document.
This command configures a Protocol Independent Multicast (PIM) instance.
PIM is used for multicast routing within the network. Devices in the network can receive the multicast feed requested, and non-participating routers can be pruned. The router OS supports PIM sparse mode (PIM-SM). By default, this command is not enabled.
[no] interface ip-int-name
config>router>pim
Supported on all 7210 SAS platforms as described in this document.
This command configures a logical IP routing interface.
Interface names are case-sensitive and must be unique within the group of IP interfaces defined for the config router interface and config service ies interface commands. Interface names must not be in the dotted decimal notation of an IP address. For example, the name ‟1.1.1.1” is not allowed, but ‟int-1.1.1.1” is allowed. Show commands for router interfaces use either the interface names or the IP addresses. Ambiguity can exist if an IP address is used as an IP address and an interface name. Duplicate interface names can exist in different router instances, although this is not recommended because it is confusing.
The no form of this command removes the IP interface and all the associated configurations.
Specifies the name of the IP interface. An interface name cannot be in the form of an IP address. Interface names can be any string of up to 32 alphanumeric characters. If the string contains special characters (#, $, spaces, and so on), the entire string must be enclosed within double quotes.
If the ip-int-name already exists, the context is changed to maintain that IP interface. If ip-int-name does not exist, the interface is created and the context is changed to that interface for further command processing.
assert-period assert-period
no assert-period
config>router>pim>if
Supported on all 7210 SAS platforms as described in this document.
This command configures the period for refreshes of PIM Assert messages on an interface.
The no form of this command removes the assert period from the configuration.
no assert-period
Specifies the period for refreshes of PIM Assert messages on an interface.
[no] bfd-enable {ipv4}
config>router>pim>interface
Supported on all 7210 SAS platforms as described in this document.
This command enables the use of IPv4 bidirectional forwarding (BFD) to control the state of the associated protocol interface. By enabling BFD on a specific protocol interface, the state of the protocol interface is tied to the state of the BFD session between the local node and the remote node. The parameters used for the BFD are set using the BFD command under the IP interface.
For information about the protocols and platforms that support BFD, see the 7210 SAS-Mxp, R6, R12, S, Sx, T Router Configuration Guide.
The no form of this command removes BFD from the associated IGP protocol adjacency.
no bfd-enable
[no] enable-mdt-spt
config>router>pim
7210 SAS-T, 7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12
This command enables SPT switchover for default MDT. When enabled, the PIM instance resets all MDTs and reinitiates setup.
The no form of this command disables SPT switchover for default MDT. When disabled, the PIM instance resets all MDTs and reinitiates setup.
no enable-mdt-spt
import {join-policy | register-policy} [policy-name [policy-name... (up to 5 max)]]
no import {join-policy | register-policy}
config>router>pim
Supported on all 7210 SAS platforms as described in this document.
This command specifies the import route policy to be used. Route policies are configured in the config>router>policy-options context.
When an import policy is not specified, BGP routes are accepted by default. Up to five import policy names can be specified.
The no form of this command removes the policy association from the instance.
no import join-policy
no import register-policy
Keyword to filter PIM join messages, which prevent unwanted multicast streams from traversing the network.
Keyword to filter register messages. PIM register filters prevent register messages from being processed by the RP. This filter can only be defined on an RP. When a match is found, the RP immediately sends back a register-stop message.
Specifies the route policy name. Allowed values are any string up to 32 characters composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, and so on), the entire string must be enclosed within double quotes. Route policies are configured in the config>router>policy-options context.
[no] mc-ecmp-balance
configure>router>pim
Supported on all 7210 SAS platforms as described in this document.
This command enables multicast balancing of traffic over ECMP links. When enabled, each multicast stream that needs to be forwarded over an ECMP link is re-evaluated for the total multicast bandwidth utilization. Re-evaluation occurs on the specified ECMP interface.
The no form of this command disables the multicast balancing.
mc-ecmp-balance-hold minutes
no mc-ecmp-balance-hold
configure>router>pim
Supported on all 7210 SAS platforms as described in this document.
This command configures the hold time for multicast balancing over ECMP links.
Specifies the hold time, in minutes, that applies after an interface has been added to the ECMP link.
[no] mc-ecmp-hashing-enabled
configure>router>pim
Supported on all 7210 SAS platforms as described in this document.
This command enables hash-based multicast balancing of traffic over ECMP links and causes PIM joins to be distributed over the multiple ECMP paths based on a hash of S and G (and possibly next-hop IP). When a link in the ECMP set is removed, the multicast streams that were using that link are redistributed over the remaining ECMP links using the same hash algorithm. When a link is added to the ECMP set, new joins may be allocated to the new link based on the hash algorithm, but existing multicast streams using the other ECMP links stay on those links until they are pruned.
Hash-based multicast balancing is supported for both IPv4 and IPv6.
This command is mutually exclusive with the mc-ecmp-balance command in the same context.
The no form of this command disables the hash-based multicast balancing of traffic over ECMP links.
no mc-ecmp-hashing-enabled
hello-interval hello-interval
no hello-interval
config>router>pim>interface
Supported on all 7210 SAS platforms as described in this document.
This command configures the frequency at which PIM Hello messages are transmitted on this interface.
The no form of this command reverts to the default value.
hello-interval 30
Specifies the hello interval in seconds. A 0 (zero) value disables the sending of hello messages (the PIM neighbor never times out the adjacency).
hello-multiplier deci-units
no hello-multiplier
config>router>pim>interface
Supported on all 7210 SAS platforms as described in this document.
This command configures the multiplier to determine the hold time for a PIM neighbor on this interface.
The hello-multiplier in conjunction with the hello-interval determines the hold time for a PIM neighbor.
Specifies the value, in multiples of 0.1, for the formula used to calculate the hello-hold time based on the hello-multiplier:
(hello-interval * hello-multiplier) / 10
This allows the PIMv2 default timeout of 3.5 seconds to be supported.
[no] improved-assert
config>router>pim>interface
Supported on all 7210 SAS platforms as described in this document.
The PIM assert process establishes a forwarder for a LAN and requires interaction between the control and forwarding planes. The assert process is started when data is received on an outgoing interface, meaning that duplicate traffic is forwarded to the LAN until the forwarder is negotiated among the routers.
When the improved-assert command is enabled, the PIM assert process is done entirely in the control plane. The advantage is that it eliminates duplicate traffic forwarding to the LAN. It also improves performance by removing the required interaction between the control and data planes.
This command is still fully interoperable with the implementations described in draft-ietf-pim-sm-v2-new-xx, Protocol Independent Multicast - Sparse Mode (PIM-SM): Revised, and RFC 2362, Protocol Independent Multicast-Sparse Mode (PIM-SM). However, there may be conformance tests that fail if the tests expect control-data plane interaction in determining the assert winner. Nokia recommends disabling the improved-assert command when performing conformance tests.
improved-assert
[no] instant-prune-echo
config>router>pim>interface
Supported on all 7210 SAS platforms as described in this document.
This command enables the PIM router to echo the PIM prune message received from a downstream router. It is typically used in a multi-access broadcast network, for example in an Ethernet LAN, to reduce the probability of loss of PIM prune messages.
no instant-prune-echo
multicast-senders {auto | always | never}
no multicast-senders
config>router>pim>interface
Supported on all 7210 SAS platforms as described in this document.
This command configures how traffic from directly-attached multicast sources should be treated on broadcast interfaces. It can also be used to treat all traffic received on an interface as traffic coming from a directly-attached multicast source. This is particularly useful if a multicast source is connected to a point-to-point or unnumbered interface.
multicast-senders auto
Keyword to specify that, on broadcast interfaces, the forwarding plane performs a subnet-match check on multicast packets received on the interface to determine whether the packet is from a directly-attached source. On unnumbered or point-to-point interfaces, all traffic is implicitly treated as coming from a remote source.
Keyword that treats all traffic received on the interface as coming from a directly-attached multicast source.
Keyword to specify that, on broadcast interfaces, traffic from directly-attached multicast sources is not forwarded. Traffic from a remote source is still forwarded if there is a multicast state for it. On unnumbered or point-to-point interfaces, it means that all traffic received on that interface must not be forwarded.
priority dr-priority
no priority
config>router>pim>interface
Supported on all 7210 SAS platforms as described in this document.
This command configures the priority value to elect the designated router (DR). The DR election priority is a 32-bit unsigned number, and the numerically larger priority is always preferred.
The no form of this command reverts to the default values.
priority 1
Specifies the priority to become the designated router. The higher the value, the higher the priority.
sticky-dr [priority dr-priority]
no sticky-dr
config>router>pim>interface
Supported on all 7210 SAS platforms as described in this document.
This command enables sticky-dr operation on this interface. When enabled, the priority in PIM Hello messages sent on this interface when elected as the designated router (DR) are modified to the value configured in dr-priority. This is done to avoid the delays in forwarding caused by DR recovery, when switching back to the old DR on a LAN when it comes back up.
By enabling sticky-dr on this interface, it continues to act as the DR for the LAN even after the old DR comes back up.
The no form of this command disables sticky-dr operation on this interface.
no sticky-dr
Specifies the DR priority to be sent in PIM Hello messages following the election of that interface as the DR, when sticky-dr operation is enabled.
three-way-hello
no three-way-hello
config>router>pim>interface
Supported on all 7210 SAS platforms as described in this document.
This command enables three-way hello. By default, the three-way-hello command is disabled on all interfaces and the standard two-way hello is supported.
no three-way-hello
[no] tracking-support
config>router>pim>interface
Supported on all 7210 SAS platforms as described in this document.
This command sets the T bit in the LAN Prune Delay option of the Hello Message. This indicates the capability of the router to enable join message suppression. This capability allows for upstream routers to explicitly track join membership.
no tracking-support
rp
config>router>pim
Supported on all 7210 SAS platforms as described in this document.
Commands in this context configure rendezvous point (RP) parameters. The address of the root of the group shared multicast distribution tree is known as its RP. Packets received from a source upstream, and join messages from downstream routers, rendezvous at this router.
If this command is not enabled, the router cannot become the RP.
[no] anycast rp-ip-address
config>router>pim>rp
Supported on all 7210 SAS platforms as described in this document.
This command configures a PIM anycast protocol instance for the configured RP. Anycast enables fast convergence when a PIM RP router fails by allowing receivers and sources to rendezvous at the closest RP.
The no form of this command removes the anycast instance from the configuration.
Specifies the loopback IP address shared by all routes that form the RP set for this anycast instance. Only a single address can be configured. If another anycast command is entered with an address, the old address is replaced with the new address. If no IP address is entered, the command is used to enter the anycast CLI level.
[no] rp-set-peer ip-address
config>router>pim>rp>anycast
Supported on all 7210 SAS platforms as described in this document.
This command configures a peer in the anycast RP set. The ip-address identifies the address used by the other node as the RP candidate address for the same multicast group address range as configured on this node.
This is a manual procedure. Caution should be taken to produce a consistent configuration of an RP set for a specific multicast group address range. The priority should be identical on each node and be a higher value than any other configured RP candidate that is not a member of this RP set.
Although there is no set maximum number of addresses that can be configured in an RP set, up to 15 IP addresses is recommended.
The no form of this command removes an entry from the list.
Specifies a peer in the anycast RP set.
bootstrap-export policy-name [policy-name...(up to 5 max)]
no bootstrap-export
config>router>pim>rp
Supported on all 7210 SAS platforms as described in this document.
This command applies export policies to the PIM configuration. The policies control the flow of bootstrap messages from the RP. Up to five policy names can be specified.
no bootstrap-export
Specifies the export policy name up to 32 characters.
bootstrap-import policy-name [..policy-name...(up to 5 max)]
no bootstrap-import
config>router>pim>rp
Supported on all 7210 SAS platforms as described in this document.
This command to applies import policies to the PIM configuration. The policies control the flow of bootstrap messages to the RP. Up to 5 policy names can be specified.
no bootstrap-import
Specifies the import policy name up to 32 characters.
bsr-candidate
config>router>pim>rp
Supported on all 7210 SAS platforms as described in this document.
Commands in this context configure Candidate Bootstrap (BSR) parameters.
bsr-candidate shutdown
address ip-address
config>router>pim>rp>bsr-candidate
Supported on all 7210 SAS platforms as described in this document.
This command configures the candidate BSR IP address. This address is for bootstrap router election.
Specifies the IP host address that is used by the IP interface within the subnet. This address must be unique within the subnet and specified in dotted decimal notation.
hash-mask-len hash-mask-length
no hash-mask-len
config>router>pim>rp>bsr-candidate
Supported on all 7210 SAS platforms as described in this document.
This command configures the length of a mask that is to be combined with the group address before the hash function is called. All groups with the same hash result map to the same RP. For example, if the hash-mask-length value is 24, only the first 24 bits of the group addresses matter. This mechanism is used to map one group or multiple groups to an RP.
hash-mask-len 30
Specifies the hash mask length.
priority bootstrap-priority
no priority
config>router>pim>rp>bsr-candidate
Supported on all 7210 SAS platforms as described in this document.
This command configures the bootstrap priority of the router. The RP is sometimes called the bootstrap router. The priority determines if the router is eligible to be a bootstrap router. In the case of a tie, the router with the highest IP address is elected to be the bootstrap router.
priority 0
Specifies the priority to become the bootstrap router. The higher the value, the higher the priority. A value of 0 means the router is not eligible to be the bootstrap router. A value of 1 means router is the least likely to become the designated router.
rp-candidate
config>router>pim>rp
Supported on all 7210 SAS platforms as described in this document.
Commands in this context configure candidate RP parameters.
Routers use a set of available rendezvous points distributed in bootstrap messages to get the correct group-to-RP mapping. A set of routers within a domain are also configured as candidate RPs (C-RPs); typically, these are the same routers that are configured as candidate BSRs.
Every multicast group has a shared tree through which receivers learn about new multicast sources, and new receivers learn about all multicast sources. The RP is the root of this shared tree.
rp-candidate shutdown
[no] address ip-address
config>router>pim>rp>rp-candidate
Supported on all 7210 SAS platforms as described in this document.
This command configures the local RP address. This address is sent in the RP candidate advertisements to the bootstrap router.
Specifies the ip-address.
[no] group-range {grp-ip-address/mask | grp-ip-address netmask}
config>router>pim>rp>rp-candidate
Supported on all 7210 SAS platforms as described in this document.
This command configures the address ranges of the multicast groups for which this router can be an RP.
Specifies the multicast group IP address expressed in dotted decimal notation (224.0.0.0 to 239.255.255.255).
Specifies the mask associated with the IP prefix expressed as a mask length or in dotted decimal notation; for example /16 for a sixteen-bit mask. The mask can also be entered in dotted decimal notation (255.255.0.0).
Specifies the subnet mask in dotted decimal notation (0.0.0.0 to 255.255.255.255).
holdtime holdtime
no holdtime
config>router>pim>rp>rp-candidate
Supported on all 7210 SAS platforms as described in this document.
This command configures the length of time, in seconds, that neighbors should consider the sending router to be operationally up. A local RP cannot be configured on a logical router.
Specifies the hold time, in seconds.
priority priority
no priority
config>router>pim>rp>rp-candidate
Supported on all 7210 SAS platforms as described in this document.
This command configures the candidate RP priority for becoming an RP. This value is used to elect RP for a group range.
priority 192
Specifies the priority to become an RP. A value of 0 is considered the highest priority.
static
config>router>pim>rp
Supported on all 7210 SAS platforms as described in this document.
Commands in this context configure static RP addresses for a multicast group range.
Entries can be created or destroyed. If no IP addresses are configured in the config>router>pim>rp>static>address context, the multicast group to RP mapping is derived from the RP set messages received from the bootstrap router.
address ip-address
no address
config>router>pim>rp>static
Supported on all 7210 SAS platforms as described in this document.
This command configures the RP address used by the router for the range of multicast groups configured by the range command.
Specifies the static IP address of the RP. The ip-address value of the address command specifies the IP host address that is used by the IP interface within the subnet. This address must be unique within the subnet and specified in dotted decimal notation.
[no] group-prefix {grp-ip-address/mask | grp-ip-address netmask}
config>router>pim>rp>static>address
Supported on all 7210 SAS platforms as described in this document.
This command specifies the range of multicast group addresses to be used by the router as the RP. The config>router>pim>rp>static>address a.b.c.d command implicitly defaults to deny all for all multicast groups (224.0.0.0/4). A group-prefix must be specified for that static address. This command does not apply to the whole group range.
The no form of this command removes the group-prefix from the configuration.
Specifies the multicast group IP address expressed in dotted decimal notation.
Specifies the mask associated with the IP prefix expressed as a mask length or in dotted decimal notation; for example /16 for a sixteen-bit mask. The mask can also be entered in dotted decimal notation (255.255.0.0).
Specifies the subnet mask in dotted decimal notation.
[no] override
config>router>pim>rp>static>address
Supported on all 7210 SAS platforms as described in this document.
This command changes the precedence of static RP over dynamically learned RP.
When enabled, the static group-to-RP mappings take precedence over the dynamically learned mappings.
no override
[no] non-dr-attract-traffic
config>router>pim
Supported on all 7210 SAS platforms as described in this document.
This command specifies whether the router should ignore the designated router state and attract traffic even when it is not the designated router.
An operator can configure an interface (router, IES, or VPRN) to IGMP and PIM. The interface state is synchronized to the backup node if it is associated with the redundant peer port. The interface can be configured to use PIM, which causes multicast streams to be sent to the elected DR only. The DR is also the router sending traffic to the DSLAM. Because it may be required to attract traffic to both routers, a non-dr-attract-traffic flag can be used in the PIM context to have the router ignore the DR state and attract traffic when it is not the DR. When using this flag, the router may not send the stream down to the DSLAM while it is not the DR.
When enabled, the designated router state is ignored. When disabled, the designated router value is honored.
no non-dr-attract-traffic
rpf-table {rtable-u}
no rpf-table
config>router>pim
Supported on all 7210 SAS platforms as described in this document.
This command configures the sequence of route tables used to find a Reverse Path Forwarding (RPF) interface for a particular multicast route.
By default, only the unicast route table is looked up to calculate RPF interface toward the source/rendezvous point. However, the user can specify use of the unicast route table (rtable-u).
The no form of this command reverts to the default value.
rpf-table rtable-u
Specifies that only the unicast route table is used by the multicast protocol (PIM) for IPv4 RPF checks. This route table contains routes submitted by all unicast routing protocols.
spt-switchover-threshold {grp-ip-prefix/ip-prefix-length | grp-ipv4-prefix netmask} spt-threshold
config>router>pim
Supported on all 7210 SAS platforms as described in this document
This command configures the shortest path tree (SPT) switchover thresholds for group prefixes.
PIM-SM routers with directly connected routers receive multicast traffic initially on a shared tree rooted at the RP. When the traffic arrives on the shared tree and the source of the traffic is known, a switchover to the SPT tree rooted at the source is attempted.
For a group that falls in the range of a prefix configured in the table, the corresponding threshold value determines when the router switches over from the shared tree to the source specific tree. The switchover is attempted only if the traffic rate on the shared tree for the group exceeds the configured threshold.
On 7210 SAS, this command enables or disables switchover to the SPT. To disable switchover to SPT, a threshold value of infinity must be configured (that is, to continue using the shared tree for ever, configure the IP multicast prefix with this command and set the threshold to infinity). To use the SPT, do not configure the IP multicast address prefix using this command, and the default behavior applies to the multicast group. The default behavior is to switch over to SPT when the first packet is received.
In the absence of any matching prefix in the table, the default behavior is to switch over when the first packet is seen. In the presence of multiple prefixes matching a specific group, the most specific entry is used.
Specifies the multicast group IP address expressed in dotted decimal notation.
Specifies the mask associated with the IP prefix expressed as a mask length or in dotted decimal notation; for example /16 for a sixteen-bit mask. The mask can also be entered in dotted decimal notation (255.255.0.0).
Specifies the threshold in kilobits per second (kbps) for a group prefix. A switchover is attempted only if the traffic rate on the shared tree for the group exceeds this threshold. When the infinity keyword is specified, no switchover occurs at any time, regardless of the traffic level detected
ssm-assert-compatible-mode [enable | disable]
config>router>pim
Supported on all 7210 SAS platforms as described in this document.
When enabled, this command treats packets as if the SPT bit is set, regardless of whether it is set.
ssm-assert-compatible-mode disable
ssm-default-range-disable ipv4
no ssm-default-range-disable ipv4
config>router>pim
Supported on all 7210 SAS platforms as described in this document.
This command enables and disables the reservation and allows PIM to accept and create (*,G) entries for addresses in this range on receiving IGMPv2 reports. PIM SSM has a default range of 232/8 (232.0.0.0 to 232.255.255.255) reserved by IANA. These addresses are not used by PIM ASM.
ssm-default-range-disable ipv4
Keyword to specify IPv4 as the SSM default range.
Keyword to specify IPv6 as the SSM default range.
[no] ssm-groups
config>router>pim
Supported on all 7210 SAS platforms as described in this document.
Commands in this context configure an SSM group instance.
[no] group-range {ip-prefix/mask | ip-prefix netmask}
config>router>pim>ssm-groups
Supported on all 7210 SAS platforms as described in this document.
This command configures the address ranges of the multicast groups for this router. When there are parameters present, the command configures the SSM group ranges for IPv6 addresses and netmasks.
Specifies the IP prefix for the range used by the ABR to advertise that summarizes the area into another area.
Specifies the subnet mask in dotted decimal notation.