ip rpf-route-static
Function
The ip rpf-route-static command configures a multicast static route.
The undo ip rpf-route-static command deletes a multicast static route.
Format
ip rpf-route-static [ vpn-instance vpn-instance-name ] source-address { mask | mask-length } [ isis process-id | ospf process-id | rip process-id | bgp | static ] [ route-policy route-policy-name ] { interface-type interface-number | gateway-address } [ preference preference ] [ order order-number ]
undo ip rpf-route-static [ vpn-instance vpn-instance-name ] { source-address { mask | mask-length } [ isis process-id | ospf process-id | rip process-id | bgp | static ] [ route-policy route-policy-name ] | all }
Parameters
| Parameter | Description | Value |
|---|---|---|
| vpn-instance vpn-instance-name | Specifies the VPN instance. vpn-instance-name specifies the name of the VPN instance. | The name is a string of 1 to 31 characters. If the parameter is not specified, the public network instance is used. |
| source-address | Specifies the address of the multicast source. | The address is in dotted decimal notation |
| mask | Indicates the address mask of the multicast source. | The address mask is in dotted decimal notation. |
| mask-length | Specifies the mask length of the multicast source address. | The value is a decimal integer that ranges from 0 to 32. |
| isis process-id | Specifies that matched routes must be of ISIS routing protocol. process-id indicates the process ID of ISIS protocol. | The value is a decimal integer that ranges from 1 to 65535. |
| ospf process-id | Specifies that matched routes must be of OSPF routing protocol. process-id indicates the process ID of OSPF protocol. | The value is a decimal integer that ranges from 1 to 65535. |
| rip process-id | Specifies that matched routes must be of RIP routing protocol. process-id indicates the process ID of RIP protocol. | The value is a decimal integer that ranges from 1 to 65535. |
| bgp | Specifies that matched routes must be of BGP routing protocol. | - |
| static | Specifies that matched routes must be of static routing protocol. | - |
| route-policy route-policy-name | Indicates the matching rule of multicast static routes. route-policy-name specifies the name of route matching rule. | The name is a string of 1 to 40. |
| interface-type interface-number | Specifies the type and the number of an interface, used to specify an interface. | - |
| gateway-address | Specifies the address of the gateway. | - |
| order order-number | Indicates the configuration order of routes in the same network segment. | The value is a decimal integer that ranges from 1 to 100. |
| preference preference | Indicates the preference of routes. The greater the value is, the lower the preference is. | The value is a decimal integer that ranges from 1 to 255. By default, it is 1. |
| all | Indicates all multicast static routes in the multicast static routing table. | - |
Usage Guidelines
By default, no multicast static route is configured.
When the ip rpf-route-static command is used, only the current multicast static routes and the unicast routes of this protocol type are compared if protocol is specified. If the protocol type of the optimal unicast route is different from the protocol type of the multicast static route, the optimal unicast route is preferred as the RPF route.
source-address, mask or mask-length, protocol type, route-policy-name are key elements of multicast static routes. If one of the elements of the routes is different, the configuration of the multicast static route is different from the current one.
Up to eight different configurations can be performed on each network segment.
When configuring a multicast static route, configure the next hop interface in the command if the type of the next hop interface is P2P. If the next hop interface is not P2P, configure it in the next hop address form.
After the ip rpf-route-static command is used, the multicast static route may not take effect because the downstream interface cannot be iterated or the specified interface is Down. Therefore, after this configuration is complete, use the display multicast routing-table static command to check whether this route is configured or takes effect.