configure ipmroute add

configure ipmroute add [default | source-net mask-len | source-net mask] {{protocol} protocol} rpf-address {metric} {vr vr-name}

Description

Adds a static multicast route to the multicast routing table.

Syntax Description

default Specifies default gateway.
source-net Specifies an IP address/mask length.
mask-len Mask length for the IP multicast source's subnet. Range is [1-32].
mask Specifies a subnet mask.
protocol Unicast routing protocol that is to be used for route learning.
rpf-address Next hop through which the multicast source can be reached.
metric Specifies a cost metric.
vr-name Specifies the virtual router to which the route is added.

Default

The following defaults apply:

  • metric—1
  • vr-name—VR of the current CLI context
  • protocol—none

Usage Guidelines

This command allows you to statically configure where multicast sources are located (even though the unicast routing table has different entries). It allows you to configure a multicast static route in such a way as to have non-congruent topology for Unicast and Multicast topology and traffic.

Example

The following example configures a multicast static route for all multicast sources within network subnet 192.168.0.0/16. Those sources are reachable through the gateway 192.75.0.91.

configure ipmroute add 192.168.0.0/16 192.75.0.91

The following example configures multicast static route for all sources via a single gateway with a metric of 100:

configure ipmroute add 0.0.0.0/0 192.75.0.91 100

History

This command was first available in ExtremeXOS 11.6.

Platform Availability

This command is available on platforms that support the appropriate license. For complete information about software licensing, including how to obtain and upgrade your license and which licenses support the IPv4 multicast feature, see the ExtremeXOS 22.6 Feature License Requirements document.