route-map policy

Use this command to create a named route-map entry for policy-based routing and to enable policy-based routing configuration mode.

Syntax

route-map policy name [permit | deny] [sequence-number]
no route-map policy name [permit | deny] [sequence-number]

Parameters

name Specifies a name for this route-map.
permit (Optional) Permits the packet to bypass route lookup and be forwarded to the next hop configured in the matching route-map.
deny (Optional) Denies policy-based routing, forcing the packet to continue on its normal routing path.
sequence-number (Optional) Specifies the order of this map entry in the route-map list, and the order in which this route-map entry will be checked for matching access list criteria. The packet check will exit with the first map entry in the list which matches the packet data. The default value is 10.

Defaults

  • If permit or deny is not specified, the route-map defaults to permit.
  • If sequence-number is not specified, 10 will be applied.

Mode

Global configuration.

Usage

Route-map names can be up to 32 alphanumeric characters in length. This firmware release identifies route-map types, policy and redistribution, exclusively by the command entered and not the name identifying the route-map.

Note

Note

Legacy route-map ID-numbers are supported (1 - 99 for redistribution; 100 - 199 for policy) but are no longer required and, in any case, no longer identify the route-map type. When upgrading from a firmware version that identified a redistribution or policy route-map solely on the basis of the number range, the upgrade process will correctly identify and configure the correct route-map type and use the legacy route-map ID-number as the route-map name.

Each named policy route-map can have one or more entries. Each policy route-map entry is identified by a unique sequence-number. Each entry can be optionally configured as a permit or deny. Route-map entries default to sequence-number 10. If you enter a route-map entry without specifying a sequence-number, and entry 10 already exists for that route-map, the new entry will replace the existing entry. Use show route-map to display current route-map entries, by sequence-number, for a specified route-map.

Executing the route-map policy command enters route-map policy configuration command mode for the specified entry. Once in route-map policy configuration command mode, each entry can be configured for one or more clauses made up of match ip-address (see match ip address (policy)) or set next-hop (see set next-hop (policy)) configurations.

See the release notes that come with your product for the number of supported:

  • Policy route-maps
  • Set or match clauses across all configured route-maps

The “no” form of this command removes the specified route-map list, or, if the sequence number is specified, route-map entry.

Example

This example shows how to create a policy route-map named rm1 with a sequence order of 20:

System(rw-config)->route-map policy rm1 permit 20
System(rw-config-route-map-pbr)->