route-map

Description                                                    Configure a rule in a route map. You can use route maps to provide input to routing com­mands, like the “redistribute” or “default-information originate” command for OSPF. See the Network Configuration Guide for more information.

Syntax                                                                  [no] route-map map-name {deny | permit} sequence-num

Parameter

Description

map-name

Route map name.

deny | permit

Action to perform on data that matches the rule.

sequence-num

Sequence number of the rule within the route map, 1-65535. Rules are used in ascending sequence order.

The action in the first matching rule is used, and no further match­ing is performed.

You do not need to configure route map rules in numerical order. The CLI automatically places them in the configuration (running-config) in ascending numerical order.

This command changes the CLI to the configuration level for the specified route map rule, where the following commands are available.

Command

Description

match attribute

Specifies the match criteria for routes:

  match as-path list-id – Matches on the BGP AS paths in the specified AS path list.

  match community list-id [exact-match] – Matches on the BGP communities in the specified community list.

  match extcommunity list-id [exact-match]– Matches on the BGP communities listed in the specified extended community list.

  match group num {active | standby} – Matches on VRRP-A set ID and state (active or standby).

  match interface {ethernet portnum | loopback num | trunk num |
ve ve-num} – Matches on the data interface used as the first hop for a route.

  match ip address {acl-id | prefix-list list-name} – Matches on the route IP addresses in the specified ACL or prefix list.

  match ip next-hop {acl-id | prefix-list list-name}– Matches on the next-hop router IP addresses in the specified ACL or prefix list.

  match ip peer acl-id – Matches on the peer router IP addresses in the specified list.

  match ipv6 address {acl-id | prefix-list list-name} – Matches on the route IP addresses in the specified ACL or prefix list.

  match ipv6 next-hop {acl-id | prefix-list list-name | ipv6-addr} – Matches on the next-hop router IP addresses in the specified ACL or prefix list, or the speci­fied IPv6 address.

  match ipv6 peer acl-id – Matches on the peer router IP addresses in the specified ACL.

  match local-preference num – Matches on the specified local preference value, 0-4294967295.

  match metric num – Matches on the specified route metric value, 0-4294967295.

  match origin {egp | igp | incomplete} – Matches on the specified BGP origin code.

  match route-type external {type-1 | type-2} – Matches on the specified external route type.

  match tag tag-value – Matches on the specified TAG value, 0-4294967295.

set attribute

Sets information for matching routes:

  set aggregator as as-num ipaddr – Sets the aggregator attribute.

  set as-path prepend as-num [...]– Adds the specified BGP AS number(s) to the front of the AS-path attribute.

  set atomic-aggregate – Specifies that a BGP route has been aggregated, and that path information for the individual routes that were aggregated together is not available.

  set comm-list list-id delete – Sets the specified BGP community list to be deleted.

  set community community-value – Sets the BGP community ID to the specified value:

1-4294967295

AS:NN, where AS is the AS number and NN is a numeric value in the range 1-4294967295.

internet – Internet route.

local-AS – Advertises routes only within the local Autonomous System (AS), not to exter­nal BGP peers.

no-advertise – Does not advertise routes.

no-export – Does not advertise routes outside the AS boundary.

none – No community attribute.

  set dampening [reachability-half-life [reuse-value [suppress-value] [max-duration [unreachability-half-life]]]] – Enables route-flap dampening. Route-flap dampening helps minimize network instability caused by unstable routes.

reachability-half-life – Reachability half life, 1-45 minutes. After a route remains reachable for this period of time, the penalty value for that route is divided in half. The default is 15 minutes.

reuse-value [suppress-value] – Penalty thresholds for the suppression and reuse (re-advertisement) of a route. The supported range for each value is 1-20000. The default suppress-value is 2000. the default reuse-value is 750.

max-duration – Maximum amount of time a route will remain suppressed, 1-255 minutes. The default is 4 times the reachability-half-life.

unreachability-half-life Unreachability half life, 1-45 minutes. After a route remains unreachable for this period of time, the penalty value for that route is divided in half.

(cont.)

set attribute

  set extcommunity comm-id [...]– Sets the BGP extended community attribute.

  set ip next-hop ipaddr – Sets the next hop for matching IPv4 routes.

  set ipv6 [local] ipv6addr – Set the next hop for matching IPv6 routes. If the address is for an inside network (not globally routable), use the local option.

  set level {level-1 | level-1-2 | level-2} – Sets the IS-IS level for exporting a route to IS-IS.

  et local-preference num – Sets the BGP local preference path attribute.

  set metric metric-value – Sets the metric value for the destination routing protocol.

  set metric-type {external | internal | type-1 | type-2} – Sets the metric type for the destination routing protocol.

  set origin {egp | igp | incomplete} – Sets the origin attribute:

egp – Exterior gateway protocol.

igp – Interior gateway protocol.

incomplete – Unknown heritage.

  set originator-id ipaddr – Sets the BGP originator attribute.

  set tag tag-value – Sets the tag value for the destination routing protocol.

  set weight num – Sets the BGP weight value for the routing table.

Default                                                                None

Mode                                                                   Configuration mode

Usage                                                                  For options that use an ACL, the ACL must use a permit action. Otherwise, the route map action is deny.

Table of Contents

Index

Glossary

-Search-

Back