6.11. Route Policy Command Reference

This command discards changes made to a route policy.

This command enters the mode to create or edit route policies.

This command saves changes made to a route policy.

This command creates a text description, which is stored in the configuration file, to help identify the content of the entity.

The no form of this command removes the string from the configuration.

This command creates a route policy autonomous system (AS) path regular expression statement to use in route policy entries.

The no form of this command deletes the AS path regular expression statement.

This command creates a route policy community list to use in route policy entries.

The no form of this command deletes the community list or the provided community ID.

This command enables the context to configure route policies. Route policies are applied to the routing protocol used for IGMP group membership report filtering.

The no form of this command deletes the route policy configuration.

This command triggers route policy re-evaluation.

By default, when a change is made to a policy in the config router policy options context and committed, the change is effective immediately. There may be circumstances when the changes should or must be delayed; for example, if a policy change is implemented that would affect every BGP peer on a 7210 SAS router, the consequences could be dramatic. It is more effective to control changes on a peer by peer basis.

If the triggered-policy command is enabled, a specific peer is established, and you want the peer to remain up, in order for a change to a route policy to take effect, a clear command with the soft or soft-inbound option must be used. That is, when a triggered-policy is enabled, any routine policy change or policy assignment change within the protocol will not take effect until the protocol is reset or a clear command is issued to re-evaluate route policies; for example, clear router bgp neighbor x.x.x.x soft. This keeps the peer up and the change made to a route policy is applied only to that peer, or group of peers.

This command creates the context to configure a route damping profile to use in route policy entries.

The no form of this command deletes the named route damping profile.

This command configures the half-life parameter for the route damping profile.

The half life value is the time, expressed in minutes, required for a route to remain stable for the Figure of Merit (FoM) value to be reduced by one half; for example, if the half life value is 6 (minutes) and the route remains stable for 6 minutes, the new FoM value is 3 (minutes). After another 3 minutes pass and the route remains stable, the new FoM value is 1.5 (minutes).

When the FoM value falls below the reuse threshold, the route is again considered valid and can be reused or included in route advertisements. No half life value is specified. The half life value must be explicitly configured.

The no form of this command removes the half life parameter from the damping profile.

This command configures the maximum suppression parameter for the route damping profile.

This value indicates the maximum time, expressed in minutes, that a route can remain suppressed.

The no form of this command removes the maximum suppression parameter from the damping profile.

This command configures the reuse parameter for the route damping profile.

When the FoM value falls below the reuse threshold, the route is again considered valid and can be reused or included in route advertisements.

The no form of this command removes the reuse parameter from the damping profile.

This command configures the suppression parameter for the route policy damping profile.

A route is suppressed when it has flapped frequently enough to increase the FoM value to exceed the suppress threshold limit. When the FoM value exceeds the suppress threshold limit, the route is removed from the route table or inclusion in advertisements.

The no form of this command removes the suppress parameter from the damping profile.

This command enables the context to configure a prefix list to use in route policy entries.

The no form of this command deletes the named prefix list.

This command creates a prefix entry in the route policy prefix list.

The no form of this command deletes the prefix entry from the prefix list.

This command enables the context to edit route policy entries within the route policy statement.

Multiple entries can be created using unique entries. The 7210 SAS exits the filter when the first match is found and executes the action specified. For this reason, entries must be sequenced correctly from most to least explicit.

An entry does not require that matching criteria be defined (in which case, everything matches), but must have at least an action defined to be considered complete. Entries without an action are considered incomplete and will be rendered inactive.

The no form of this command removes the specified entry from the route policy statement.

This command enables the context to configure policy match criteria based on a route source or the protocol from which the route is received.

If no condition is specified, all route sources are considered to match.

The no form of this command deletes the source match criteria for the route policy statement entry.

This command specifies address families as matching conditions.

This command configures an OSPF area as a route policy match criterion.

This match criterion is only used in export policies.

All OSPF routes (internal and external) are matched using this criterion if the best path for the route is through the specified area.

The no form of this command removes the OSPF area match criterion.

This command assigns a BGP AIGP metric to routes matching the entry. The effect of this command on a route matched and accepted by a route policy entry depends on how the policy is applied (BGP import policy versus BGP export policy), the type of route, and the specific form of this command.

In a BGP import policy, this command is used to:

In a BGP export policy, this command is used to:

The no form of this command removes the AIGP attribute and any explicit AIGP metric value changes that were previously configured using this command.

This command configures an AS path regular expression statement as a match criterion for the route policy entry.

If no AS path criterion is specified, any AS path is considered to match.

AS path regular expression statements are configured at the global route policy level (config>router>policy-options>as-path).

The no form of this command removes the AS path regular expression statement as a match criterion.

This command creates a route policy AS path regular expression statement to use in route policy entries.

The no form of this command deletes the AS path regular expression statement.

This command configures a community list as a match criterion for the route policy entry.

If no community list is specified, any community is considered a match.

The no form of this command removes the community list match criterion.

This command specifies the external route matching criteria for the entry.

This command specifies the multicast group address prefix list containing multicast group addresses that are embedded in the join or prune packet as a filter criterion. The prefix list must be configured before entering this command. Prefix lists are configured in the config>router>policy-options>prefix-list context.

The no form of this command removes the criterion from the configuration.

This command specifies a prefix list host IP address as a match criterion for the route policy statement entry.

This command specifies the router interface, specified either by name or address, as a filter criterion.

The no form of this command removes the criterion from the configuration.

This command specifies the IS-IS route level as a match criterion for the entry.

This command specifies the neighbor address as found in the source address of the actual join and prune message as a filter criterion. If no neighbor is specified, any neighbor is considered a match.

The no form of the of the command removes the neighbor IP match criterion from the configuration.

This command configures a BGP origin attribute as a match criterion for a route policy statement entry.

If no origin attribute is specified, any BGP origin attribute is considered a match.

The no form of this command removes the BGP origin attribute match criterion.

This command enables the context to configure a route policy statement.

Route policy statements enable appropriate processing of IGMP group membership reports received from hosts. The processing action taken is determined by the action associated with the entries configured in the policy statement.

The policy-statement is a logical grouping of match and action criteria.

The no form of this command deletes the policy statement.

This command configures a prefix list as a match criterion for a route policy statement entry.

If no prefix list is specified, any network prefix is considered a match.

The prefix lists specify the network prefix (this includes the prefix and length) a specific policy entry applies.

A maximum of five prefix names can be specified.

The no form of this command removes the prefix list match criterion.

This command configures a routing protocol as a match criterion for a route policy statement entry. This command is used for both import and export policies depending how it is used.

If no protocol criterion is specified, any protocol is considered a match.

The no form of this command removes the protocol match criterion.

This command specifies the source address that is embedded in the join or prune packet as a filter criterion.

The no form of this command removes the criterion from the configuration.

This command specifies a multicast data source address as a match criterion for this entry.

This command adds an integer tag to the static route. These tags are then matched on to control route redistribution.

The no form of this command removes the tag field match criterion.

This command enables the context to configure export policy match criteria based on a route destination or the protocol into which the route is being advertised.

If no condition is specified, all route destinations are considered to match.

The to command context only applies to export policies. If it is used for an import policy, match criteria is ignored.

The no form of this command deletes export match criteria for the route policy statement entry.

This command configures an OSPF type metric as a match criterion in the route policy statement entry.

If no type is specified, any OSPF type is considered a match.

The no form of this command removes the OSPF type match criterion.

This command enables the context to configure actions to take for routes matching a route policy statement entry.

This command is required and must be entered for the entry to be active.

Any route policy entry without the action command will be considered incomplete and will be inactive.

The no form of this command deletes the action context from the entry.

This command assigns a BGP AS path list to routes matching the route policy statement entry.

If no AS path list is specified, the AS path attribute is not changed.

The no form of this command disables the AS path list editing action from the route policy entry.

This command prepends a BGP ASN once or multiple times to the AS path attribute of routes matching the route policy statement entry.

If an ASN is not configured, the AS path is not changed.

If the optional number is specified, the ASN is prepended as many times as indicated by the number.

The no form of this command disables the AS path prepend action from the route policy entry.

This command adds or removes a BGP community list to or from routes matching the route policy statement entry.

If no community list is specified, the community path attribute is not changed.

The community list changes the community path attribute according to the add and remove keywords.

The no form of this command disables the action to edit the community path attribute for the route policy entry.

This command configures a damping profile used for routes matching the route policy statement entry.

If no damping criteria is specified, the default damping profile is used.

The no form of this command removes the damping profile associated with the route policy entry.

This command enables the context to configure actions for routes packets that do not match any route policy statement entries when the accept parameter is specified.

The default action clause can be set to all available action states, including accept, reject, next-entry and next-policy. If the action states accept or reject, the policy evaluation terminates and the appropriate result is returned.

If a default action is defined and no matches occurred with the entries in the policy, the default action clause is used.

If a default action is defined and one or more matches occurred with the entries of the policy then the default action is not used.

The no form of this command deletes the default-action context for the policy statement.

This command assigns a BGP local preference to routes matching a route policy statement entry.

If no local preference is specified, the BGP configured local preference is used.

The no form of this command disables assigning a local preference in the route policy entry.

This command assigns a metric to routes matching the policy statement entry.

If no metric is specified, the configured metric is used. If neither is defined, no metric will be advertised.

The value assigned for the metric by the route policy is controlled by the required keywords.

The no form of this command disables assigning a metric in the route policy entry.

This command advertises a next hop IP address belonging to this router even if a third-party next hop is available to routes matching the policy statement entry.

The no form of this command disables advertising the next-hop-self option for the route policy entry.

This command sets the BGP origin assigned to routes exported into BGP.

If the routes are exported into protocols other than BGP, this option is ignored.

The no form of this command disables setting the BGP origin for the route policy entry.

This command assigns a route preference to routes matching the route policy statement entry.

If no preference is specified, the default route table manager (RTM) preference for the protocol is used.

The no form of this command disables setting an RTM preference in the route policy entry.

This command assigns an OSPF tag to routes matching the entry. The tag value is used to apply a tag to a route for either an OSPF or RIP route. A hexadecimal value of 4 octets can be entered.

For OSPF, all four octets can be used.

For RIP, only the two most significant octets are used if more than two octets are configured.

The no form of this command removes the tag.

This command assigns an OSPF type metric to routes matching the route policy statement entry and being exported into OSPF.

The no form of this command disables assigning an OSPF type in the route policy entry.