Configuring PIM

In addition, see show router-configuration.

Syntax:

set pim

      assert-interval {<1-3600> | default}

      assert-limit {<10-10000> | default}

      assert-rank protocol <Protocol> rank {<0-255> | default}

      bootstrap-candidate

            local-address <IP Address>

            {off | on}

            priority {<0-255> | default}

      candidate-rp

            advertise-interval {<1-3600> | default}

            local-address <IP Address>

            multicast group <IPv4 Address>/<Subnet Mask> {off | on}

            {off | on}

            priority {<0-255> | default}

      cisco compatibility {off | on}

      data-interval {<11-3600> | default}

      hello-interval {<1-21845> | default}

      ha-mode {off | on}

      interface <Name of Interface>

            {off | on}

            local-address <IP Address>

            dr-priority {<0-4294967295> } default}

      jp-delay-interval {<1-3600> | default}

      jp-interval {<1-3600> | default}

      mode {dense | sparse | ssm}

      nat-mode {off | on}

      register-suppress-interval {<60-3600> | default}

      spt-threshold <options>

      state-refresh {off | on}

      state-refresh-interval <0 - 255>

      state-refresh-ttl <1 - 255>

      static-rp

            {off | on}

            rp-address <IP Address>

                  multicast-group <IPv4 Address>/<Subnet Mask> {off | on}

                  {off | on}

Parameters:

Parameter

Description

assert-interval {<1-3600> | default}

Configures the assert interval.

If an assert battle on an upstream interface results in the selection of a PIM neighbor other than the unicast reverse-path-forwarding (RPF) neighbor towards the source of the data traffic (for which the assert battle was generated) as the designated forwarder on that interface, then the winner is used as the upstream neighbor for all subsequent join/prune messages.

This change is timed-out after expiry of the assert interval.

Range: 1-3600 seconds

Default: 180 seconds

assert-limit {<10-10000> | default}

Reserved for future use.

Configures the PIM assert limit.

Range: 10-10000

Default: 10

assert-rank protocol <Protocol>

Configures the protocol, for which to configure the assert rank:

  • bgp - Routes learned via the BGP protocol

  • direct - Routes directly connected to a network interface

  • igrp - Routes learned via the IGRP protocol

  • kernel - Kernel routes

  • ospf - Routes learned via the OSPF protocol

  • ospfase - External routes learned via OSPF

  • rip - Routes learned via the RIP protocol

  • static - Static routes

bootstrap-candidate local-address {<IPv4 address> | default}

Configures the Bootstrap Candidate Local Address used for the C-BSR state machine and the bootstrap messages.

Important:

  • On a single Security Gateway, this address can be that of the PIM interfaces or an address configured on the loopback interface. If an address from the loopback interface is used, do not select an address in the 127/8 address range.

  • On a ClusterXL Cluster Member, you must configure the Cluster Virtual IP address configured on this PIM interface.

Range: Address of PIM interface, or a non 127.0.0.0/8 loopback address.

Default: The IP address of one of the interfaces on which PIM is enabled. The default does not apply on Cluster Members.

bootstrap-candidate {off | on}

Disables (off) or enables (on) the Bootstrap Candidate.

Range: off, on

Default: off

bootstrap-candidate priority {<0-255> | default}

Configures the priority advertised in C-BSR messages.

The candidate bootstrap router with the highest priority value is selected as the bootstrap router for the domain.

The C-RP with the lowest priority has the highest preference.

The highest priority value is 0.

Range: 0-255

Default: 0

candidate-rp advertise-interval {<1-3600> | default}

Configures the candidate Rendezvous Point (RP) Advertisement Interval.

candidate-rp local-address {<IPv4 address> | default}

Configures the Candidate Rendezvous Point router address used for the C-RP state machine and in the C-RP-Advertisements sent to the elected bootstrap router.

Important:

  • On a single Security Gateway, this address can be that of the PIM interfaces or an address configured on the loopback interface. If an address from the loopback interface is used, do not select an address in the 127/8 address range.

  • In ClusterXL Cluster Member or VRRP Cluster Member, you must configure the Cluster Virtual IP address configured on this PIM interface.

Range: Address of PIM interface or a non 127.0.0.0/8 loopback address.

Default: Selects the IP address of one of the interfaces on which PIM is enabled. The default does not apply on Cluster Members.

candidate-rp multicast-group <IPv4 address>/<Subnet mask> {off | on}

Configure the Multicast Group, for which this router is designated as the candidate rendezvous point.

  • <IPv4 address>

    The multicast IP address of the group(s) in CIDR notation, for which this rendezvous point is responsible.

    Range: Dotted-quad ([224-239].[0-255].[0-255].[0-255])

    Default: 224.0.0.0/4

  • <Subnet mask>

    Mask length.

    Range: 1-32

    Default: None

candidate-rp {off | on}

Disables (off) or enables (on) Gaia Embedded as a candidate rendezvous point router.

Range: off, on

Default: off

candidate-rp priority {<0-255> | default}

Configures the priority of this C-RP.

All PIM routers select the same RP for a multicast group address from the list of C-RPs received in the bootstrap messages from the elected BSR.

The lower the Local Preference of the C-RP, the higher the priority.

Range: 0-255

Default: 0

cisco compatibility {off | on}

Configures the Cisco Compatibility for Register Checksums.

Does not support the PIM Dense Mode.

Range: off, on

Default: off

data-interval {<11-3600> | default}

Configures the life-time of a new PIM forwarding entry.

Subsequently, the life of the entry is extended in different ways based on the location of this router in the network.

For example, in some cases the receipt of PIM control messages (periodic join/prune messages) extends the life of the entry and in others the presence of local senders of multicast traffic prevents the deletion of the entry.

Range: 11-3600 seconds

Default: 210 seconds

hello-interval {<1-21845> | default}

Configures the interval between PIM Hello messages that are sent on a multicast-capable interface.

Hello messages are addressed to the All-PIM-Routers multicast group (224.0.0.13), so that PIM routers may discover neighbors on a multi-access network.

Range: 1-21845 seconds

Default: 30 seconds

jp-delay-interval {<1-3600> | default}

Configures the maximal interval from the time when the unicast Reverse Path Forwarding (RPF) neighbor (towards a source or the RP) changes, and a triggered Join/Prune message is sent.

Range: 1-3600 seconds

Default: 5 seconds

jp-interval {<1-3600> | default}

Configures the interval between sending Join/Prune messages.

Range: 1-3600 seconds

Default: 60 seconds

ha-mode {off | on}

Disables (off) or enables (on) the High-Availability mode in PIM Sparse-Mode.

Enable the High-Availability (HA) mode when two routers are configured to back each other up to forward multicast traffic and PIM Sparse-Mode is implemented.

When this option is enabled, all PIM-enabled interfaces are available only if each interface is up and has a valid address assigned.

If any PIM-enabled interface goes down or all its valid addresses are deleted, then all PIM-enabled interfaces become unavailable and remain in that state until all interfaces are back up.

The HA mode feature applies only to Sparse-Mode PIM.

The HA mode feature does not affect the functioning of Dense-Mode PIM.

Range: off, on

Default: off

interface <Name of Interface>

Specifies the interface, on which to enable PIM.

interface <Name of Interface> local-address <IP Address>

Specifies the local IP address used in all advertisements sent on the interface.

This option is useful when multiple IP addresses are configured on the interface.

If you enter an address other than one configured for that interface, PIM ignores your configured address and selects one of the addresses configured on the interface.

Thus, a PIM router on a shared LAN must have at least one interface address with a subnet prefix shared by all neighboring PIM routers.

Warning - If neighboring routers choose advertisement addresses that do not appear to be on a shared subnet, all messages from the neighbor will be rejected.

interface <Name of Interface> {off | on}

Disables (off) or enables (on) PIM on the specified interface.

interface <Name of Interface> dr-priority {<0-4294967295> | default}

Configures the Designated Router priority advertised in the PIM Hello messages that are sent on the interface.

This is used for DR selection on a LAN.

The router with the highest priority is selected as the designated router.

To break a tie, the DR is selected on the basis of the highest IP address.

If even one router does not advertise a DR priority configured, the DR election is based on the IP address.

Note - To make sure that a PIM neighbor supports DR Priority:

  1. Run this command in Gaia Clish on the Security Gateway:

    show pim neighbor <IP Address of Neighbor>

  2. For neighbors that advertise a DR selection priority value, this message shows in the summary:

    DRPriorityCapable Yes

Range: 0-4294967295

Default: 1

mode {dense | sparse | ssm}

Configures the PIM mode:

  • dense - Dense Mode
  • sparse - Sparse Mode
  • ssm - Source-Specific Multicast

nat-mode {off | on}

Disables (off) or enables (on) PIM NAT mode to translate the IP addresses in a PIM protocol message to the relevant IP address(es) for the interface, on which the message is being sent.

Range: off, on

Default: off

register-suppress-interval {<60-3600> | default}

Configures the mean interval between receipt of a register-stop and the time when registers can be sent again.

A lower value means more frequent register bursts at the rendezvous point.

A higher value means a longer join latency for new receivers.

Range: 60-3600 seconds

Default: 60

spt-threshold <options>

This command is deprecated and not supported.

state-refresh {off | on}

Disables (off) or enables (on) the use of state refresh messages to delay timing out prune state of multicast traffic that has no active receivers.

This helps suppress the flood-and-prune cycle inherent to Dense Mode.

state-refresh-interval {<1-255> | default}

For Dense Mode, configures the interval at which state refresh messages are sent for multicast traffic originated by directly-connected sources.

Range: 1-255 seconds

Default: 60 seconds

state-refresh-ttl {<1-255> | default}

For Dense Mode, configures the time-to-live (TTL) placed in the state refresh messages originated for multicast traffic from directly-connected sources.

You can use this value to limit the forwarding of state refresh messages in the network.

In the absence of user configuration, it is derived from the multicast data.

Range: 1-255

Default: None

static-rp {off | on}

Disables (off) or enables (on) the router as a Static Rendezvous Point.

static-rp rp-address <IPv4 address>

Configures the Static Rendezvous Point IP address.

If an associated multicast group and prefix is not configured, the Static Rendezvous Point (RP) is considered to be responsible for all multicast groups (224.0.0.0/4).

This needs to be consistent with the RP information at other routers in a multicast domain irrespective of the RP-dissemination mechanism (bootstrap or autoRP) used.

Note - The static RP overrides the RP information received from other RP-dissemination mechanisms, such as bootstrap routers.

Range: Any IP address

Default: None

static-rp rp-address <IPv4 address> multicast-group <IPv4 address>/<Subnet mask> {off | on}

Configures the Multicast Group, for which this router is designated as the static rendezvous point.

  • <IPv4 address>

    The multicast IP address of the group(s) in CIDR notation, for which this rendezvous point is responsible.

    Range: Dotted-quad ([224-239].[0-255].[0-255].[0-255])

    Default: 224.0.0.0/4

  • <Subnet mask>

    Mask length.

    Range: 1-32

    Default: None

static-rp rp-address <IPv4 address> {off | on}

Disables (off) or enables (on) the specified static Rendezvous Point.

Range: off, on

Default: off