Use this command to add or remove a static IP multicast route. This command is valid only when an ipv4 multicast topology is configured for this router.
| prefix | Specifies a destination IP address prefix. |
| prefix mask | Specifies a destination prefix mask. |
| prefix/prefix-length | Specifies a destination IP address in prefix/prefix-length format. |
| ip-address | Specifies a next-hop router IP address. |
| interface interface-name | Specifies the next-hop interface. |
| vlan vlan-id | Specifies the next-hop VLAN. Valid values are 1 - 4094. |
| vrf vrf-name | Specifies that the destination is in VRF router with this name. |
| blackhole | Specifies that packets destined for this route‘s subnet are silently dropped. An ICMP network unreachable message is not sent to the packet source. |
| reject | Specifies that packets destined for this route‘s subnet are dropped, and an ICMP network unreachable message is sent to the packet source. |
| recursive | (Optional) Specifies that the next-hop interface is determined by route lookup. |
| distance | (Optional) Specifies an administrative distance metric for this route. Valid values are 1 (default) to 255. Routes with lower values receive higher preference in route selection. |
| tag tag-id | (Optional) Specifies an OSPF tag ID for this route. Valid values are 1 - 4294967295. |
| default | Uses the default static route probe |
| probe-name | Specifies the name of a probe to use. |
Configuration command mode.
This command is used to configure static multicast routes. The route forwards IP traffic depending upon the IP forwarding setting of the routing interface. Routing interfaces are set for IP forwarding by default. To configure a static multicast route as a non-forwarding IP route, set IP forwarding for the routing interface to non-forwarding using the no ip forwarding command in interface configuration mode.
Use the vrf egress-vrf parameter to point to the egress VRF router that will perform the next-hop lookup for this static route. Using the vrf egress-vrf parameter is more dynamic than configuring a standard static route, in that it determines the next hop based upon a route table lookup. A standard static route specifies a single next hop. Should that next hop be unavailable, the subnet is no longer reachable. A standard static route can be configured to reach the next hop that is a member of a different VRF using the syntax: ip route destination-prefix/length next-hop-address interface next-hop-interface. Because the vrf egress-vrf parameter provides greater flexibility in determining the next hop, it is recommended that you use the vrf egress-vrf parameter.
Note
The default VRF router is referred to as the global router. Named VRF routers within a device configured using the set router vrf create command are referred to as non-global VRF routers. Static routes are supported between both the global router and any non-global VRF router and between any two non-global VRF routers.If you only enter the prefix/length and the IP address of the nexthop router and do not specify the optional recursive parameter, a search is performed of all configured subnets for a subnet containing the next?hop. If found, the static route is anchored to that interface, else it becomes a recursive route.
See ipv6 mroute for IPv6 static multicast route configuration command information.
The “no” form of this command removes the static IP multicast route.
This example shows how to set IP address 10.1.2.3 as the next hop gateway to destination address 10.0.0.0.:
System(rw-router-config)->ip mroute 10.0.0.0 255.0.0.0 10.1.2.3
This example shows how to set VLAN 100 as the next hop interface to destination address 10.0.0.0:
System(rw-router-config)->ip mproute 10.0.0.0 255.0.0.0 vlan 100
Print
this page
Email this topic
Feedback
View PDF
Download EPUB