Fortinet black logo

CLI Reference

router multicast

Configure router multicast.

  config router multicast
      Description: Configure router multicast.
      set route-threshold {integer}
      set route-limit {integer}
      set multicast-routing [enable|disable]
      config pim-sm-global
          Description: PIM sparse-mode global settings.
          set message-interval {integer}
          set join-prune-holdtime {integer}
          set accept-register-list {string}
          set accept-source-list {string}
          set bsr-candidate [enable|disable]
          set bsr-interface {string}
          set bsr-priority {integer}
          set bsr-hash {integer}
          set bsr-allow-quick-refresh [enable|disable]
          set cisco-register-checksum [enable|disable]
          set cisco-register-checksum-group {string}
          set cisco-crp-prefix [enable|disable]
          set cisco-ignore-rp-set-priority [enable|disable]
          set register-rp-reachability [enable|disable]
          set register-source [disable|interface|...]
          set register-source-interface {string}
          set register-source-ip {ipv4-address}
          set register-supression {integer}
          set null-register-retries {integer}
          set rp-register-keepalive {integer}
          set spt-threshold [enable|disable]
          set spt-threshold-group {string}
          set ssm [enable|disable]
          set ssm-range {string}
          set register-rate-limit {integer}
          config rp-address
              Description: Statically configure RP addresses.
              edit <id>
                  set ip-address {ipv4-address}
                  set group {string}
              next
          end
      end
      config interface
          Description: PIM interfaces.
          edit <name>
              set ttl-threshold {integer}
              set pim-mode [sparse-mode|dense-mode]
              set passive [enable|disable]
              set bfd [enable|disable]
              set neighbour-filter {string}
              set hello-interval {integer}
              set hello-holdtime {integer}
              set cisco-exclude-genid [enable|disable]
              set dr-priority {integer}
              set propagation-delay {integer}
              set state-refresh-interval {integer}
              set rp-candidate [enable|disable]
              set rp-candidate-group {string}
              set rp-candidate-priority {integer}
              set rp-candidate-interval {integer}
              set multicast-flow {string}
              set static-group {string}
              set rpf-nbr-fail-back [enable|disable]
              set rpf-nbr-fail-back-filter {string}
              config join-group
                  Description: Join multicast groups.
                  edit <address>

                  next
              end
              config igmp
                  Description: IGMP configuration options.
                  set access-group {string}
                  set version [3|2|...]
                  set immediate-leave-group {string}
                  set last-member-query-interval {integer}
                  set last-member-query-count {integer}
                  set query-max-response-time {integer}
                  set query-interval {integer}
                  set query-timeout {integer}
                  set router-alert-check [enable|disable]
              end
          next
      end
  end

config router multicast

Parameter Name Description Type Size
route-threshold Generate warnings when the number of multicast routes exceeds this number, must not be greater than route-limit. integer Minimum value: 1 Maximum value: 2147483647
route-limit Maximum number of multicast routes. integer Minimum value: 1 Maximum value: 2147483647
multicast-routing Enable/disable IP multicast routing.
enable: Enable IP multicast routing.
disable: Disable IP multicast routing.
option -
Parameter Name Description Type Size
message-interval Period of time between sending periodic PIM join/prune messages in seconds (1 - 65535, default = 60). integer Minimum value: 1 Maximum value: 65535
join-prune-holdtime Join/prune holdtime (1 - 65535, default = 210). integer Minimum value: 1 Maximum value: 65535
accept-register-list Sources allowed to register packets with this Rendezvous Point (RP). string Maximum length: 35
accept-source-list Sources allowed to send multicast traffic. string Maximum length: 35
bsr-candidate Enable/disable allowing this router to become a bootstrap router (BSR).
enable: Allow this router to function as a BSR.
disable: Do not allow this router to function as a BSR.
option -
bsr-interface Interface to advertise as candidate BSR. string Maximum length: 15
bsr-priority BSR priority (0 - 255, default = 0). integer Minimum value: 0 Maximum value: 255
bsr-hash BSR hash length (0 - 32, default = 10). integer Minimum value: 0 Maximum value: 32
bsr-allow-quick-refresh Enable/disable accept BSR quick refresh packets from neighbors.
enable: Allow quick refresh packets.
disable: Do not allow quick refresh packets.
option -
cisco-register-checksum Checksum entire register packet(for old Cisco IOS compatibility).
enable: register checksum entire packet.
disable: Do not register checksum entire packet.
option -
cisco-register-checksum-group Cisco register checksum only these groups. string Maximum length: 35
cisco-crp-prefix Enable/disable making candidate RP compatible with old Cisco IOS.
enable: Do not allow sending group prefix of zero.
disable: Allow sending group prefix of zero.
option -
cisco-ignore-rp-set-priority Use only hash for RP selection (compatibility with old Cisco IOS).
enable: Ignore RP-SET priority value.
disable: Do not ignore RP-SET priority value.
option -
register-rp-reachability Enable/disable check RP is reachable before registering packets.
enable: Check target RP is unicast reachable before registering.
disable: Do not check RP unicast reachability.
option -
register-source Override source address in register packets.
disable: Use source address of RPF interface.
interface: Use primary IP of an interface.
ip-address: Use a local IP address.
option -
register-source-interface Override with primary interface address. string Maximum length: 15
register-source-ip Override with local IP address. ipv4-address Not Specified
register-supression Period of time to honor register-stop message (1 - 65535 sec, default = 60). integer Minimum value: 1 Maximum value: 65535
null-register-retries Maximum retries of null register (1 - 20, default = 1). integer Minimum value: 1 Maximum value: 20
rp-register-keepalive Timeout for RP receiving data on (S,G) tree (1 - 65535 sec, default = 185). integer Minimum value: 1 Maximum value: 65535
spt-threshold Enable/disable switching to source specific trees.
enable: Switch to Source tree when available.
disable: Do not switch to Source tree when available.
option -
spt-threshold-group Groups allowed to switch to source tree. string Maximum length: 35
ssm Enable/disable source specific multicast.
enable: Allow source specific multicast.
disable: Do not allow source specific multicast.
option -
ssm-range Groups allowed to source specific multicast. string Maximum length: 35
register-rate-limit Limit of packets/sec per source registered through this RP (0 - 65535, default = 0 which means unlimited). integer Minimum value: 0 Maximum value: 65535

config rp-address

Parameter Name Description Type Size
ip-address RP router address. ipv4-address Not Specified
group Groups to use this RP. string Maximum length: 35
Parameter Name Description Type Size
ttl-threshold Minimum TTL of multicast packets that will be forwarded (applied only to new multicast routes) (1 - 255, default = 1). integer Minimum value: 1 Maximum value: 255
pim-mode PIM operation mode.
sparse-mode: sparse-mode
dense-mode: dense-mode
option -
passive Enable/disable listening to IGMP but not participating in PIM.
enable: Listen only.
disable: Participate in PIM.
option -
bfd Enable/disable Protocol Independent Multicast (PIM) Bidirectional Forwarding Detection (BFD).
enable: Enable Protocol Independent Multicast (PIM) Bidirectional Forwarding Detection (BFD).
disable: Disable Protocol Independent Multicast (PIM) Bidirectional Forwarding Detection (BFD).
option -
neighbour-filter Routers acknowledged as neighbor routers. string Maximum length: 35
hello-interval Interval between sending PIM hello messages (0 - 65535 sec, default = 30). integer Minimum value: 1 Maximum value: 65535
hello-holdtime Time before old neighbor information expires (0 - 65535 sec, default = 105). integer Minimum value: 1 Maximum value: 65535
cisco-exclude-genid Exclude GenID from hello packets (compatibility with old Cisco IOS).
enable: Do not send GenID.
disable: Send GenID according to standard.
option -
dr-priority DR election priority. integer Minimum value: 1 Maximum value: 4294967295
propagation-delay Delay flooding packets on this interface (100 - 5000 msec, default = 500). integer Minimum value: 100 Maximum value: 5000
state-refresh-interval Interval between sending state-refresh packets (1 - 100 sec, default = 60). integer Minimum value: 1 Maximum value: 100
rp-candidate Enable/disable compete to become RP in elections.
enable: Compete for RP elections.
disable: Do not compete for RP elections.
option -
rp-candidate-group Multicast groups managed by this RP. string Maximum length: 35
rp-candidate-priority Router's priority as RP. integer Minimum value: 0 Maximum value: 255
rp-candidate-interval RP candidate advertisement interval (1 - 16383 sec, default = 60). integer Minimum value: 1 Maximum value: 16383
multicast-flow Acceptable source for multicast group. string Maximum length: 35
static-group Statically set multicast groups to forward out. string Maximum length: 35
rpf-nbr-fail-back Enable/disable fail back for RPF neighbor query.
enable: Enable fail back for RPF neighbor query.
disable: Disable fail back for RPF neighbor query.
option -
rpf-nbr-fail-back-filter Filter for fail back RPF neighbors. string Maximum length: 35

config igmp

Parameter Name Description Type Size
access-group Groups IGMP hosts are allowed to join. string Maximum length: 35
version Maximum version of IGMP to support.
3: Version 3 and lower.
2: Version 2 and lower.
1: Version 1.
option -
immediate-leave-group Groups to drop membership for immediately after receiving IGMPv2 leave. string Maximum length: 35
last-member-query-interval Timeout between IGMPv2 leave and removing group (1 - 65535 msec, default = 1000). integer Minimum value: 1 Maximum value: 65535
last-member-query-count Number of group specific queries before removing group (2 - 7, default = 2). integer Minimum value: 2 Maximum value: 7
query-max-response-time Maximum time to wait for a IGMP query response (1 - 25 sec, default = 10). integer Minimum value: 1 Maximum value: 25
query-interval Interval between queries to IGMP hosts (1 - 65535 sec, default = 125). integer Minimum value: 1 Maximum value: 65535
query-timeout Timeout between queries before becoming querier for network (60 - 900, default = 255). integer Minimum value: 60 Maximum value: 900
router-alert-check Enable/disable require IGMP packets contain router alert option.
enable: Require Router Alert option in IGMP packets.
disable: don't require Router Alert option in IGMP packets
option -

Configure router multicast.

  config router multicast
      Description: Configure router multicast.
      set route-threshold {integer}
      set route-limit {integer}
      set multicast-routing [enable|disable]
      config pim-sm-global
          Description: PIM sparse-mode global settings.
          set message-interval {integer}
          set join-prune-holdtime {integer}
          set accept-register-list {string}
          set accept-source-list {string}
          set bsr-candidate [enable|disable]
          set bsr-interface {string}
          set bsr-priority {integer}
          set bsr-hash {integer}
          set bsr-allow-quick-refresh [enable|disable]
          set cisco-register-checksum [enable|disable]
          set cisco-register-checksum-group {string}
          set cisco-crp-prefix [enable|disable]
          set cisco-ignore-rp-set-priority [enable|disable]
          set register-rp-reachability [enable|disable]
          set register-source [disable|interface|...]
          set register-source-interface {string}
          set register-source-ip {ipv4-address}
          set register-supression {integer}
          set null-register-retries {integer}
          set rp-register-keepalive {integer}
          set spt-threshold [enable|disable]
          set spt-threshold-group {string}
          set ssm [enable|disable]
          set ssm-range {string}
          set register-rate-limit {integer}
          config rp-address
              Description: Statically configure RP addresses.
              edit <id>
                  set ip-address {ipv4-address}
                  set group {string}
              next
          end
      end
      config interface
          Description: PIM interfaces.
          edit <name>
              set ttl-threshold {integer}
              set pim-mode [sparse-mode|dense-mode]
              set passive [enable|disable]
              set bfd [enable|disable]
              set neighbour-filter {string}
              set hello-interval {integer}
              set hello-holdtime {integer}
              set cisco-exclude-genid [enable|disable]
              set dr-priority {integer}
              set propagation-delay {integer}
              set state-refresh-interval {integer}
              set rp-candidate [enable|disable]
              set rp-candidate-group {string}
              set rp-candidate-priority {integer}
              set rp-candidate-interval {integer}
              set multicast-flow {string}
              set static-group {string}
              set rpf-nbr-fail-back [enable|disable]
              set rpf-nbr-fail-back-filter {string}
              config join-group
                  Description: Join multicast groups.
                  edit <address>

                  next
              end
              config igmp
                  Description: IGMP configuration options.
                  set access-group {string}
                  set version [3|2|...]
                  set immediate-leave-group {string}
                  set last-member-query-interval {integer}
                  set last-member-query-count {integer}
                  set query-max-response-time {integer}
                  set query-interval {integer}
                  set query-timeout {integer}
                  set router-alert-check [enable|disable]
              end
          next
      end
  end

config router multicast

Parameter Name Description Type Size
route-threshold Generate warnings when the number of multicast routes exceeds this number, must not be greater than route-limit. integer Minimum value: 1 Maximum value: 2147483647
route-limit Maximum number of multicast routes. integer Minimum value: 1 Maximum value: 2147483647
multicast-routing Enable/disable IP multicast routing.
enable: Enable IP multicast routing.
disable: Disable IP multicast routing.
option -
Parameter Name Description Type Size
message-interval Period of time between sending periodic PIM join/prune messages in seconds (1 - 65535, default = 60). integer Minimum value: 1 Maximum value: 65535
join-prune-holdtime Join/prune holdtime (1 - 65535, default = 210). integer Minimum value: 1 Maximum value: 65535
accept-register-list Sources allowed to register packets with this Rendezvous Point (RP). string Maximum length: 35
accept-source-list Sources allowed to send multicast traffic. string Maximum length: 35
bsr-candidate Enable/disable allowing this router to become a bootstrap router (BSR).
enable: Allow this router to function as a BSR.
disable: Do not allow this router to function as a BSR.
option -
bsr-interface Interface to advertise as candidate BSR. string Maximum length: 15
bsr-priority BSR priority (0 - 255, default = 0). integer Minimum value: 0 Maximum value: 255
bsr-hash BSR hash length (0 - 32, default = 10). integer Minimum value: 0 Maximum value: 32
bsr-allow-quick-refresh Enable/disable accept BSR quick refresh packets from neighbors.
enable: Allow quick refresh packets.
disable: Do not allow quick refresh packets.
option -
cisco-register-checksum Checksum entire register packet(for old Cisco IOS compatibility).
enable: register checksum entire packet.
disable: Do not register checksum entire packet.
option -
cisco-register-checksum-group Cisco register checksum only these groups. string Maximum length: 35
cisco-crp-prefix Enable/disable making candidate RP compatible with old Cisco IOS.
enable: Do not allow sending group prefix of zero.
disable: Allow sending group prefix of zero.
option -
cisco-ignore-rp-set-priority Use only hash for RP selection (compatibility with old Cisco IOS).
enable: Ignore RP-SET priority value.
disable: Do not ignore RP-SET priority value.
option -
register-rp-reachability Enable/disable check RP is reachable before registering packets.
enable: Check target RP is unicast reachable before registering.
disable: Do not check RP unicast reachability.
option -
register-source Override source address in register packets.
disable: Use source address of RPF interface.
interface: Use primary IP of an interface.
ip-address: Use a local IP address.
option -
register-source-interface Override with primary interface address. string Maximum length: 15
register-source-ip Override with local IP address. ipv4-address Not Specified
register-supression Period of time to honor register-stop message (1 - 65535 sec, default = 60). integer Minimum value: 1 Maximum value: 65535
null-register-retries Maximum retries of null register (1 - 20, default = 1). integer Minimum value: 1 Maximum value: 20
rp-register-keepalive Timeout for RP receiving data on (S,G) tree (1 - 65535 sec, default = 185). integer Minimum value: 1 Maximum value: 65535
spt-threshold Enable/disable switching to source specific trees.
enable: Switch to Source tree when available.
disable: Do not switch to Source tree when available.
option -
spt-threshold-group Groups allowed to switch to source tree. string Maximum length: 35
ssm Enable/disable source specific multicast.
enable: Allow source specific multicast.
disable: Do not allow source specific multicast.
option -
ssm-range Groups allowed to source specific multicast. string Maximum length: 35
register-rate-limit Limit of packets/sec per source registered through this RP (0 - 65535, default = 0 which means unlimited). integer Minimum value: 0 Maximum value: 65535

config rp-address

Parameter Name Description Type Size
ip-address RP router address. ipv4-address Not Specified
group Groups to use this RP. string Maximum length: 35
Parameter Name Description Type Size
ttl-threshold Minimum TTL of multicast packets that will be forwarded (applied only to new multicast routes) (1 - 255, default = 1). integer Minimum value: 1 Maximum value: 255
pim-mode PIM operation mode.
sparse-mode: sparse-mode
dense-mode: dense-mode
option -
passive Enable/disable listening to IGMP but not participating in PIM.
enable: Listen only.
disable: Participate in PIM.
option -
bfd Enable/disable Protocol Independent Multicast (PIM) Bidirectional Forwarding Detection (BFD).
enable: Enable Protocol Independent Multicast (PIM) Bidirectional Forwarding Detection (BFD).
disable: Disable Protocol Independent Multicast (PIM) Bidirectional Forwarding Detection (BFD).
option -
neighbour-filter Routers acknowledged as neighbor routers. string Maximum length: 35
hello-interval Interval between sending PIM hello messages (0 - 65535 sec, default = 30). integer Minimum value: 1 Maximum value: 65535
hello-holdtime Time before old neighbor information expires (0 - 65535 sec, default = 105). integer Minimum value: 1 Maximum value: 65535
cisco-exclude-genid Exclude GenID from hello packets (compatibility with old Cisco IOS).
enable: Do not send GenID.
disable: Send GenID according to standard.
option -
dr-priority DR election priority. integer Minimum value: 1 Maximum value: 4294967295
propagation-delay Delay flooding packets on this interface (100 - 5000 msec, default = 500). integer Minimum value: 100 Maximum value: 5000
state-refresh-interval Interval between sending state-refresh packets (1 - 100 sec, default = 60). integer Minimum value: 1 Maximum value: 100
rp-candidate Enable/disable compete to become RP in elections.
enable: Compete for RP elections.
disable: Do not compete for RP elections.
option -
rp-candidate-group Multicast groups managed by this RP. string Maximum length: 35
rp-candidate-priority Router's priority as RP. integer Minimum value: 0 Maximum value: 255
rp-candidate-interval RP candidate advertisement interval (1 - 16383 sec, default = 60). integer Minimum value: 1 Maximum value: 16383
multicast-flow Acceptable source for multicast group. string Maximum length: 35
static-group Statically set multicast groups to forward out. string Maximum length: 35
rpf-nbr-fail-back Enable/disable fail back for RPF neighbor query.
enable: Enable fail back for RPF neighbor query.
disable: Disable fail back for RPF neighbor query.
option -
rpf-nbr-fail-back-filter Filter for fail back RPF neighbors. string Maximum length: 35

config igmp

Parameter Name Description Type Size
access-group Groups IGMP hosts are allowed to join. string Maximum length: 35
version Maximum version of IGMP to support.
3: Version 3 and lower.
2: Version 2 and lower.
1: Version 1.
option -
immediate-leave-group Groups to drop membership for immediately after receiving IGMPv2 leave. string Maximum length: 35
last-member-query-interval Timeout between IGMPv2 leave and removing group (1 - 65535 msec, default = 1000). integer Minimum value: 1 Maximum value: 65535
last-member-query-count Number of group specific queries before removing group (2 - 7, default = 2). integer Minimum value: 2 Maximum value: 7
query-max-response-time Maximum time to wait for a IGMP query response (1 - 25 sec, default = 10). integer Minimum value: 1 Maximum value: 25
query-interval Interval between queries to IGMP hosts (1 - 65535 sec, default = 125). integer Minimum value: 1 Maximum value: 65535
query-timeout Timeout between queries before becoming querier for network (60 - 900, default = 255). integer Minimum value: 60 Maximum value: 900
router-alert-check Enable/disable require IGMP packets contain router alert option.
enable: Require Router Alert option in IGMP packets.
disable: don't require Router Alert option in IGMP packets
option -