DXS-3600-32S CLI Reference Guide

DXS-3600-32S 10GbE Layer 2/3 Switch CLI Reference Guide

Route Map Commands

48-1 route-map

This command is used to create or configure a route map or enter route map configuration mode. Use the no form of this command to delete a route map or remove a clause of route map.

route-map MAP-NAME [permit | deny] [SEQUENCE-NUM]

no route-map MAP-NAME [permit | deny] [SEQUENCE-NUM]

Parameters

MAP-NAME

permit deny

SEQUENCE-NUM

Specifies the name of route map. It can accept up to 16 characters. The syntax is general string that does not allow space.

(Optional) Specifies a permit clause. If the match commands of one permit clause are met, the route will be redistributed while the set commands of this clause may modify the information of the route to be redistributed. If the match commands of one permit clause are not met, the next clause of this route map will be tested.

(Optional) Specifies a deny clause. If the match commands of one deny clause are met, the route will not be redistributed.

(Optional) Specifies the sequence number of clause. Each clause has a sequence number, which indicates the position of the clause. The clause with lower sequence number is preferred. The range is 1 to 65535.

Default

The permit keyword is the default.

The default value of the sequence number of the first clause is 10.

Global Configuration Mode.

Command Mode

Command Default Level

Level: 8

Usage Guideline

The route map can be used in route redistribution and route filtering. A route map could be configured with multiple permit/deny clauses, which can have multiple match or set commands.

The clause with lower sequence number has higher priority. If the route map clause with low sequence number is not met, the next clause with higher sequence number will be tested. If all clauses are not met, the test result is to deny (This means the route map is ended with a implicit deny clause if this route map is not empty). If one clause is met, next clauses will be skipped.

When one clause is tested, the logical AND algorithm is applied for multiple match commands and the logical OR algorithm is applied for multiple objects within one match command.

There is a limitation about sequence number. If the route map has been configured with one clause, the sequence number must be specified when configure more clauses for this route map.

If no argument is specified when use no route-map command, the route map is deleted.

You can verify your settings by entering the show route-map command.

Example

This example shows how to add one route map and enter the route map configuration mode.

DXS-3600-32S#configure terminal

DXS-3600-32S(config)#route-map rmap1 permit 10

DXS-3600-32S(config-route-map)#

436


48-2 match as-path

This command is used to add a match command to match a BGP autonomous system (AS) path access list. Use the no form of this command to delete the match command with BGP autonomous system path access list.

match as-path ACCESS-LIST-NAME

no match as-path

Parameters

ACCESS-LIST-NAME

Specifies the name of the path access list. The length is up to 16 characters.

Default

Command Mode

None.

Route Map Configuration Mode.


Level: 8. (EI Mode Only Command)

Usage Guideline

Only one path access list is supported. If this command is executed with a different path access list, the old one will be overwritten.


Example

This example shows how to add a match clause to match AS path access list.



DXS-3600-32S(config-route-map)#match as-path PATH_AC


48-3 match community

This command is used to add a match command to match a Border Gateway Protocol (BGP) community list. Use the no form of this command to delete the match command with BGP community list.

match community COMMUNITY-LIST-NAME [exact]

no match community

Parameters

COMMUNITY-LIST-NAME

Specifies the name of BGP community list. The length is up to 16 characters.

exact

(Optional) Specifies to match BGP community list exactly.

Default

Command Mode

None.




Usage Guideline

The BGP community list is created with the command ip community-list. If exact is specified, the communities in the community list must be exactly same as the communities of the route.

If exact is not specified, this command is matched as long as one community is matched.

Only one community list is supported. If this command is executed with a different community list, the old one will be overwritten.


437


Example

This example shows how to add a match command to match a BGP community list.

DXS-3600-32S(config)#ip community-list standard A-COMMUNITY permit 101:1


DXS-3600-32S(config-route-map)#match community A-COMMUNITY exact


48-4 match interface

This command is used to add a match command to match the outgoing interface of routes. Use the no form of this command to delete the match command with outgoing interface of routes.

match interface ipif_name

no match interface

Parameters

ipif_name

Specifies the name of the outgoing interface of routes.

Default

None.

Command Mode



Level: 8

Usage Guideline

Only one interface is supported. If this command is executed with a different interface, the old one will be overwritten.


Example

This example shows how to add a match command to match a outgoing interface of routes.



DXS-3600-32S(config-route-map)#match interface System


48-5 match ip address

This command is used to add a match command to match the destination network address of routes. Use the no form of this command to delete the match command with destination network address of routes.

match ip address {ACCESS-LIST-NAME | prefix-list PREFIX-LIST-NAME}

no match ip address {ACCESS-LIST-NAME | prefix-list PREFIX-LIST-NAME}

Parameters

ACCESS-LIST-NAME

PREFIX-LIST-NAME

Specifies the name of a standard IP access list. The maximum length is 16 characters.

Specifies the name of an IP prefix list. The maximum length is 16 characters.

Default

Command Mode

None.



Level: 8

438

Usage Guideline


The standard IP access list is created with the command ip standard access-list. The prefix list is created with the command ip prefix-list.

Only one of them can be supported for matching destination network address at one time.

The destination network address is testes with the specified standard IP access list or prefix list.


Example

This example shows how to add a match command to match destination network address of routes using standard IP access list.


DXS-3600-32S(config)#ip standard access-list Strict-Control

DXS-3600-32S(config-ip-acl)#permit 10.1.1.0/24

DXS-3600-32S(config-ip-acl)#exit


DXS-3600-32S(config-route-map)#match ip address Strict-Control


48-6 match ip next-hop

This command is used to add a match command to match the next hop of routes. Use the no form of this command to delete the match command with next hop of routes.

match ip next-hop {ACCESS-LIST-NAME | prefix-list PREFIX-LIST-NAME}

no match ip next-hop {ACCESS-LIST-NAME | prefix-list PREFIX-LIST-NAME}

Parameters

ACCESS-LIST-NAME

PREFIX-LIST-NAME


Specifies the name of an IP prefix list. The maximum length is 16 characters.

Default

None.

Command Mode



Level: 8

Usage Guideline

The standard IP access list is created with the command ip standard access-list. The prefix list is created with the command ip prefix-list.

Only one of them can be supported for matching the next hop of routes at one time.

The next hop of routes is testes with the specified standard IP access list or prefix list.


Example

This example shows how to add a match command to match destination network address of routes using standard IP access list.






DXS-3600-32S(config-route-map)#match ip next-hop Strict-Control


439


48-7 match ip route-source

This command is used to add a match command to match the source router IP address of the routes. Use the no form of this command to delete the match command with source router IP address.

match ip route-source ACCESS-LIST-NAME

no match ip route-source

Parameters

ACCESS-LIST-NAME


Default

Command Mode

None.



Level: 8

Usage Guideline

The standard IP access list is created with the command ip standard access-list.

Only one standard IP access list is supported. If this command is executed with a different standard IP access list, the old one will be overwritten.


Example

This example shows how to add a match command to match source router IP address of routes using standard IP access list.


DXS-3600-32S(config)#ip standard access-list LocalServer




DXS-3600-32S(config-route-map)#match ip route-source LocalServer


48-8 match metric

This command is used to add a match command to match the metric of routes. Use the no form of this command to delete the match command with metric of routes.

match metric NUMBER

no match metric

Parameters

NUMBER

Specifies the metric of routes. The range is 0 to 4294967294.

Default

Command Mode

None.



Level: 8

Usage Guideline


440


Example

This example shows how to add a match command to match the metric of routes.



DXS-3600-32S(config-route-map)#match metric 5


48-9 match route-type

This command is used to add a match command to match the type of routes. Use the no form of this command to delete the match command with type of routes.

match route-type {internal | external | type-1 | type-2} no match route-type

Parameters internal external type-1 type-2

Specifies the Intra-area and inter-area routes of Open Shortest Path First (OSPF).

Specifies the Autonomous System external route of OSPF, including type-1 and type-2 external routes.

Specifies the Type-1 external route of OSPF

Specifies the Type-2 external route of OSPF

Default

None.

Command Mode



Level: 8

Usage Guideline

All types of routes, internal, external, type-1 and type-2, are only for OSPF.


Example

This example shows how to add a match command to match the metric of routes.



DXS-3600-32S(config-route-map)#match route-type internal


48-10 set as-path prepend

This command is used to add a set command to modify an autonomous system path of BGP routes. Use the no form of this command to delete this set command.

set as-path prepend ASPATH-LIST

no set as-path prepend

Parameters

ASPATH-LIST

Specifies the path list to be appended before the autonomous system path of the route. It could be an AS number or a list of AS numbers separated by comma.

Default

None.

Command Mode




441

Usage Guideline


Use this command to change the length of the autonomous system path of BGP route. This can affect the best path selection.


Example

This example shows how to add a set command to append an autonomous system path list to BGP routes.


DXS-3600-32S(config)#route-map mapaspath permit 10

DXS-3600-32S(config-route-map)#set as-path prepend 1,10,100,200


48-11 set community

This command is used to add a set command to modify the BGP communities attribute. Use the no form of this command to delete this set command.

set community [COMMUNITY-SET | internet | local-as | no-advertise | no-export](1) [additive]

no set community

Parameters

COMMUNITY-SET

internet local-as no-advertise no-export additive

(Optional) Specifies a 32-bits integer number represented by AA:NN, where AA (AS number) is the upper part of the word and NN (community number, user-specified) is the lower part of the word

(Optional) Specifies routes to be advertised to all peers (internal and external)

(Optional) Specifies routes not to be advertised to external BGP peers.

(Optional) Specifies routes not to be advertised to other BGP peers.

(Optional) Specifies routes not to be advertised outside of autonomous system boundary.

(Optional) Specifies to add the community to the existed communities.

Default

Command Mode

None.




Usage Guideline

Use this command to modify the BGP community attribute. If additive is not specified, the existing communities in the routes will be replaced.


Example

This example shows how to add a set command to replace the BGP communities attribute.


DXS-3600-32S(config)#route-map mapdampending permit 10

DXS-3600-32S(config-route-map)#set community 2:1


48-12 set dampening

This command is used to add a set command specify the dampening parameters of routes. Use the no form of this command to delete this set command.

set dampening HALF-LIFE REUSE SUPPRESS MAX-SUPPRESS-TIME UN-REACHABILITY-HALF-LIFE

no set dampening

442


Parameters

HALF-LIFE

REUSE

SUPPRESS

MAX-SUPPRESS-TIME

UN-REACHABILITY-HALF-

LIFE

Specifies the time (in minutes) after which the penalty of the reachable routes is decreased by half. The range is 1 to 45.

Specifies that if the penalty of a route is lower than this value, the route is unsuppressed. The range is 1 to 20000.

Specifies that if the penalty of a route is higher than this value, the route is suppressed. The range is 1 to 20000.

Specifies the maximum time (in minutes) a route can be suppressed. The range is 1 to 255.

Specifies the time (in minutes) after which the penalty of the unreachable routes is decreased by half. The range is 1 to 45.

Default

Command Mode

HALF-LIFE: 15 minutes.

REUSE: 750.

SUPPRESS: 2000.

MAX-SUPPRESS-TIME: 60 minutes

UN-REACHABILITY-HALF-LIFE: 15 minutes



Level: 8

Usage Guideline

Use this command to modify the dampening parameters of routes when match conditions are met.


Example

This example shows how to add a set command to modify the dampening parameters of route 120.1.1.0/24.







DXS-3600-32S(config-route-map)#set dampening 14 500 900 60 15


48-13 set ip next-hop

This command is used to add a set command to modify the next hop of routes. Use the no form of this command to delete this set command.

set ip next-hop {IP-ADDRESS | peer-address}

no set ip next-hop

Parameters

IP-ADDRESS

peer-address

Specifies the IP address the next hop.

This setting will take effect for both the ingress and egress directions. When set next hop to peer’s address, for ingress direction, the next hop will be set to the neighbor peer address. For egress direction, the next hop associated with the route in the packet will be local router id.

Default

Command Mode

None.


443



Level: 8

Usage Guideline

Use this command to modify the next hop of route when match conditions are met.


Example

This example shows how to add a set command to modify the next hop of route

10.1.1.0/24.





DXS-3600-32S(config)#route-map mapnexthop permit 10


DXS-3600-32S(config-route-map)#set ip next-hop 120.1.2.2


48-14 set local-preference

This command is used to add a set command to modify the local preference attribute of routes. Use the no form of this command to delete this set command.

set local-preference NUMBER

no set local-preference

Parameters

NUMBER

Specifies the value of local preference. The range is 0 to 4294967295.

Default

The default value of local preference is 100.

Command Mode



Level: 8

Usage Guideline

Use this command to modify the local preference attribute of route when match conditions are met.

By default, the BGP router will send the default local preference with the routes to

IBGP neighbors and to EBGP neighbors which are in one confederation. It can be overwritten by the local preference set by the route map. For the received route, the local preference sent with the route will be used in the best path selection. This local preference will be overwritten if the local preference is ingress set by the route map.

For the connected routes, the default local preference will be used for them in the best path selection.

This will take effect for both ingress and egress directions.


Example

This example shows how to add a set command to modify the local preference of route 120.1.1.0/24.





DXS-3600-32S(config)#route-map mapprefer permit 10


DXS-3600-32S(config-route-map)#set local-preference 500


444


48-15 set metric

This command is used to add a set command to modify the metric of routes. Use the no form of this command to delete this command.

set metric NUMBER

no set metric

Parameters

NUMBER

Specifies the metric of routes. The range is 0 to 4294967294.

Default

Command Mode

None.



Level: 8

Usage Guideline

.

Use this command to modify the metric of routes to be redistributed


Example

This example shows how to add a set command to modify the metric of routes.


DXS-3600-32S(config)#route-map mapmetric permit 10

DXS-3600-32S(config-route-map)#set metric 100


48-16 set metric-type

This command is used to add a set command to modify the metric type of routes. Use the no form of this command to delete this set command.

set metric-type {type-1 | type-2} no set metric-type

Parameters type-1 type-2

Specifies the OSPF external type 1 metric.

Specifies the OSPF external type 2 metric.

Default

Command Mode

None.



Level: 8

Usage Guideline

This command is only applied to the routes redistributed to OSPF.


Example

This example shows how to add a set command to modify the metric type of routes.


DXS-3600-32S(config)#route-map mapmetrictype permit 10

DXS-3600-32S(config-route-map)#set metric-type type-1


445


48-17 set origin

This command is used to add a set command to modify the BGP origin code. Use the no form of this command to delete this set command.

set origin {igp | egp | incomplete} no set origin

Parameters igp egp incomplete

Specifies that the origin code of the route will be set to IGP.

Specifies that the origin code of the route will be set to EGP.

Specifies that the origin code of the route will be set to INCOMPLETE.

Default

Command Mode

None.



Level: 8

Usage Guideline

Use this command to modify the BGP origin code route attribute. The origin code

(ORIGIN) is a well-known mandatory attribute that indicates the origin of the prefix or, rather, the way in which the prefix was injected into BGP.

There are three origin codes, listed in order of preference:

IGP, meaning the prefix was originated from information learned from an interior gateway protocol.

EGP, meaning the prefix originated from the EGP protocol, which BGP replaced.

Incomplete, meaning the prefix originated from some unknown source, for example, redistribute.


Example

This example shows how to add a set command to modify the origin code of routes.


DXS-3600-32S(config)#route-map maporigin permit 10

DXS-3600-32S(config-route-map)#match as-path PATH_ACL

DXS-3600-32S(config-route-map)#set origin egp


48-18 set weight

This command is used to add a set command to specify the weight of BGP routes. Use the no form of this command to delete this set command.

set weight NUMBER

no set weight

Parameters

NUMBER

Specifies the value of the weight The range is 0 to 65535.

Default

None.

Command Mode



Level: 8

446

Usage Guideline


Weights set by this command will override the weights specified by BGP neighbor commands. In other words, the weights specified with the command set weight in route map configuration mode override the weights specified with the command

neighbor weight in BGP router mode.


Example

This example shows how to add a set command to modify the weight of BGP routes.


DXS-3600-32S(config)#route-map mapweight permit 10

DXS-3600-32S(config-route-map)#match as-path PATH_ACL

DXS-3600-32S(config-route-map)#set weight 30


48-19 show route-map

This command is used to show route map settings.

show route-map [MAP-NAME]

Parameters

MAP-NAME

(Optional) Specifies to display information about specified route map. The maximum length is 16 characters.

Default

Command Mode

None.

Privileged Mode.


Level: 3

Usage Guideline

Use this command to check the settings of route map, including permit or deny clauses and match or set commands.

Example

This example shows information of route map “rmap1”.

DXS-3600-32S#show route-map rmap1

route-map : rmap1

--------------------------

sequence : 10 (Permit)

Match clauses:

as-path : PATH_AC

community : ALPHA-COMMUNITY exact

interface : System

ip address : Strict-Control

ip next-hop : Strict-Control

route-source : LocalServer

metric : 5

route-type : internal

Set clauses:

dampening : 14 500 900 60 15

DXS-3600-32S#

Display Parameters

Route Map

Sequence

Match

Set

Description

The name of route map. It is specified with the command route-map.

The sequence number of clause. It is specified with the command route-map.

List of match commands.

List of set commands.

447

DXS-3600-32S CLI Reference Guide

Route Map Commands

48-1 route-map

48-2 match as-path

48-3 match community

48-4 match interface

48-5 match ip address

48-6 match ip next-hop

48-7 match ip route-source

48-8 match metric

48-9 match route-type

48-10 set as-path prepend

48-11 set community

48-12 set dampening

48-13 set ip next-hop

48-14 set local-preference

48-15 set metric

48-16 set metric-type

48-17 set origin

48-18 set weight

48-19 show route-map

Related manuals

Table of contents

DXS-3600-32S CLI Reference Guide

Route Map Commands

48-1 route-map

48-2 match as-path

48-3 match community

48-4 match interface

48-5 match ip address

48-6 match ip next-hop

48-7 match ip route-source

48-8 match metric

48-9 match route-type

48-10 set as-path prepend

48-11 set community

48-12 set dampening

48-13 set ip next-hop

48-14 set local-preference

48-15 set metric

48-16 set metric-type

48-17 set origin

48-18 set weight

48-19 show route-map

Related manuals

D-Link

DXS-3600-16S

D-Link

DXS-3600-16S

D-Link

DXS-3600-16S

D-Link

DXS-3600 Series

D-Link

DXS-3600 Series

D-Link

DXS-3600 Series

D-Link

DXS-1210-10TS

Table of contents