Dell Networking SONiC-routekaart

Summary: In dit artikel wordt uitleg gegeven over Route Map aan de hand van een eenvoudig voorbeeld in Dell Networking SONiC.

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Instructions

 
Voorwaarden
We gebruiken standaard interfacenaamgeving om de concepten te demonstreren. Lees het artikel Dell Networking S-serie: Basic Interface Configuration - SONiC 4.0 voor meer informatie over interfacenaamgeving 
 

Index

Wat is een routekaart.
Overeenkomen met en instellen van statementwaarden.
Configuratiesyntaxis
Routekaart
makenWedstrijdverklaring
Instructie
instellenOproepverklaring
Configuratie
van routekaart verwijderenRoutekaart
verifiërenVoorbeeldconfiguratie                                          

 

Wat is een routekaart.

Route-Map wordt gebruikt voor het bewerken en controleren van routeleren in het OSPF- of BGP-routeringsproces. Het speelt ook een rol bij het genereren van een standaardroute binnen een OSPF-routeringsproces. In wezen geeft een routekaart aan welke routes van een gespecificeerd routeringsprotocol opnieuw mogen worden verdeeld in het doelrouteringsproces. 

Om routes voor herverdeling te filteren, gebruikt u routekaarten met IP-voorvoegsellijsten en/of AS-padlijst.

De onderstaande tabel geeft een overzicht van de acties die worden ondernomen wanneer meerdere overeenkomstopdrachten worden aangetroffen binnen een enkele routekaartreeks.
Verklaring van de routekaart Verklaring van lijst met voorvoegsels Route komt overeen/niet overeen Actie
Vergunning Vergunning Overeenkomen met Route is toegestaan en kan instellen of aanroepen uitvoeren.
Vergunning Geen overeenkomsten Ga verder met de volgende routekaartreeks
Weigeren Overeenkomen met Ga verder met de volgende routekaartreeks
Weigeren Geen overeenkomsten Ga verder met de volgende routekaartreeks
Weigeren Vergunning Overeenkomen met Route wordt geweigerd.
Vergunning Geen overeenkomsten Ga verder met de volgende routekaartreeks
Weigeren Overeenkomen met Ga verder met de volgende routekaartreeks
Weigeren Geen overeenkomsten Ga verder met de volgende routekaartreeks


 

Overeenkomen met en instellen van statementwaarden.

Elke routekaartinstructie heeft twee soorten waarden:
  • Een overeenkomstwaarde selecteert routes waarop deze instructie moet worden toegepast.
  • Een ingestelde waarde wijzigt de informatie die opnieuw moet worden gedistribueerd naar het doelprotocol.
Voor elke route die wordt herverdeeld, evalueert de router eerst de matchcriteria van een instructie in de routekaart. Als de overeenkomstcriteria slagen, wordt de route opnieuw verdeeld of afgewezen zoals bepaald door de instructie Toestaan of Weigeren, en kunnen sommige kenmerken worden gewijzigd door de waarden die zijn ingesteld met de ingestelde opdrachten.

Als de overeenkomende criteria niet voldoen en deze instructie niet van toepassing is op de route, gaat DELL SONiC verder met het evalueren van de route aan de hand van de volgende instructie in de routekaart. Het scannen van de routekaart gaat door totdat een verklaring is gevonden die overeenkomt met de route of totdat het einde van de routekaart is bereikt.

Een overeenkomst of ingestelde waarde in elke instructie kan worden gemist of meerdere keren worden herhaald als een van deze voorwaarden aanwezig is:
  • Als er meerdere overeenkomstitems aanwezig zijn in een instructie, moeten ze allemaal slagen voor een bepaalde route om ervoor te zorgen dat die route overeenkomt met de instructie (er wordt een logisch EN-algoritme toegepast)
  • Als een vergelijkingsitem meerdere objecten in één item ziet, moet een van deze overeenkomen (er wordt een logisch OF-algoritme toegepast)
  • Als er geen overeenkomstvermelding aanwezig is, komen alle routes overeen met de instructie.
  • Als een vaste vermelding niet aanwezig is in de vergunningsverklaring van de routekaart, wordt de route herverdeeld zonder wijziging van de huidige kenmerken.
  • Een routekaartinstructie zonder een overeenkomst of set-item voert wel een actie uit. Een lege vergunningsverklaring maakt een herverdeling van de resterende routes mogelijk zonder aanpassingen.
  • Een lege weigeringsinstructie staat geen herverdeling van andere routes toe, omdat dit de standaardactie is als een routekaart volledig is gescand, maar er geen expliciete overeenkomst wordt gevonden.
 

Configuratiesyntaxis

 

Routekaart maken

Maak een routekaart die overeenkomt met de routeparameters die in de volgende stap worden vermeld. Geef een toestemmings- of weigeringsinstructie op om te configureren hoe overeenkomende routes worden afgehandeld. Voer het volgnummer in voor de volgorde waarin het afschrift op de kaart wordt verwerkt.

Opdrachtsyntaxis
admin@DELLSONiC :~$ sonic-cli
DELLSONiC # configure
DELLSONiC (config)# route-map map-name {permit | deny} {sequence-number}
 

Wedstrijdverklaring

Voer in de configuratiemodus van de routekaart een van deze overeenkomstinstructies in om routes te selecteren.
Opdrachtsyntaxis
admin@DELLSONiC :~$ sonic-cli
DELLSONiC # configure
DELLSONiC (config)# route-map map-name {permit | deny} {sequence-number}
DELLSONiC(config-route-map)# match {match statement}
Possible Match Statements

  as-path           Set routing policy match criteria as-path
  community         Set routing policy match criteria to BGP community
  evpn              Set routing policy match criteria to BGP Ethernet Virtual Private Network
  ext-community     Set routing policy match criteria to BGP extended community
  interface         Set routing policy match criteria to interface
  ip                Set routing policy match criteria
  ipv6              Set routing policy match criteria
  local-preference  Set routing policy match criteria to local-preference
  metric            Set routing policy match criteria to metric
  origin            Specify BGP origin
  peer              Set routing policy match criteria to peer IP
  source-protocol   Specify source protocol
  source-vrf        Source VRF
  tag               Redistributes routes in the routing table that match the specified tags.
 
 

Instructie instellen

Voer in de configuratiemodus routekaart een van deze ingestelde instructies in om het opgegeven BGP-kenmerk in overeenkomende routes te wijzigen.
Opdrachtsyntaxis
admin@DELLSONiC :~$ sonic-cli
DELLSONiC # configure
DELLSONiC (config)# route-map map-name {permit | deny} {sequence-number}
DELLSONiC(config-route-map)# set {Set-statement}
Possible Set-Statement

  as-path           Transform BGP AS-path attribute
  comm-list         Set BGP community list (for deletion)
  community         BGP community attribute
  extcommunity      BGP extended community attribute
  ip                IPv4 information
  ipv6              IPv6 information
  local-preference  BGP local preference path attribute
  metric            Set metric value action for the routing policy
  origin            BGP origin code
  tag               Tag value for routing protocol
  weight            BGP weight for routing table

 

Oproepverklaring

De "call"-instructie maakt het mogelijk om een andere routekaart aan te roepen als aan de wedstrijdvoorwaarde is voldaan.
Opdrachtsyntaxis
admin@DELLSONiC :~$ sonic-cli
DELLSONiC # configure
DELLSONiC (config)# route-map map-name {permit | deny} {sequence-number}
DELLSONiC (config-route-map)# call {route-map-name}
 

Configuratie verwijderen

Zorg ervoor dat u eventuele routekaartkoppelingen verwijdert voordat u de routekaart verwijdert. 

Als u een geconfigureerde waarde in een routekaartvermelding wilt verwijderen, voert u de opdracht Geen versie van de overeenkomst of Instellen in
.Voorbeeld
admin@DELLSONiC :~$ sonic-cli
DELLSONiC # configure
DELLSONiC (config)# route-map map-name {permit | deny} {sequence-number}
DELLSONiC (config-route-map)# no match as-path
DELLSONiC (config-route-map)# no set origin
DELLSONiC (config-route-map)# no call
Om de routekaart te verwijderen.
admin@DELLSONiC :~$ sonic-cli
DELLSONiC # configure
DELLSONiC (config)# no route-map map-name
 

Routekaart verifiëren

Gebruik balgopdrachten om de configuratie van de routekaart te controleren. 
DELLSONiC# show route-map
DELLSONiC# show route-map {route-map-name}

Gebruik de onderstaande opdrachten om de routekaart te vinden die op een buur is toegepast.
DELLSONiC# show bgp ipv4 unicast neighbors
DELLSONiC# show bgp ipv6 unicast neighbors

U kunt ook grepen met beleid in de bovenstaande opdrachten om een kleinere uitvoer te zien. 
DELLSONiC#show bgp ipv4 unicast neighbors <neighbor>| find policy


 

Voorbeeldconfiguratie

Vereiste: Zie onderstaande topologie. Drie loopback IP 1.1.1.1/32, 2.2.2.2/32 en 3.3.3.3/32 wordt geadverteerd door DELL-SONiC-R1 naar DELL-SONiC-R2 met behulp van BGP.
                      
Bedenk dat de route naar 1.1.1.1/32 moet worden geadverteerd als Origin EGP om te worden ontvangen op DELL-SONiC-R3.  
                       De routes 2.2.2.2/32 en 3.3.3.3/32 mogen niet worden gewijzigd.


Voorbeeldtopologie

Laten we eerst een lijst met voorvoegsels configureren. Laten we de lijst met voorvoegsels IP-LIST-TO-MODIFY noemen en het voorvoegsel 1.1.1.1/32 toestaan.
 
DELL-SONiC-R2# configure
DELL-SONiC-R2(config)# ip prefix-list IP-LIST-TO-MODIFY seq 1 permit 1.1.1.1/32
DELL-SONiC-R2(config)# exit
DELL-SONiC-R2#
DELL-SONiC-R2# show ip prefix-list
IP prefix list IP-LIST-TO-MODIFY:
     seq 1 permit 1.1.1.1/32
DELL-SONiC-R2#

Laten we de routekaart configureren op DELL-SONiC-R2. Laten we de routekaart MAP-TO-MODIFICATION noemen 
DELL-SONiC-R2# configure
DELL-SONiC-R2(config)# route-map MAP-TO-MODIFICATION permit 1
DELL-SONiC-R2(config-route-map)# match ip address prefix-list IP-LIST-TO-MODIFY
DELL-SONiC-R2(config-route-map)# set origin egp
DELL-SONiC-R2(config-route-map)# exit
DELL-SONiC-R2(config)# route-map MAP-TO-MODIFICATION permit 2
DELL-SONiC-R2(config-route-map)# exit
DELL-SONiC-R2(config)# exit
DELL-SONiC-R2#
 
Laten we de configuratie opsplitsen voor verdere uitleg.
Here under sequence 1 the match condition is to match any IP in prefix list IP-LIST-TO-MODIFY where we already have specified 1.1.1.1/32.
So when 1.1.1.1/32 IP matches the cation to be taken is set the origin code to egp.

DELL-SONiC-R2# configure
DELL-SONiC-R2(config)# route-map MAP-TO-MODIFICATION permit 1
DELL-SONiC-R2(config-route-map)# match ip address prefix-list IP-LIST-TO-MODIFY
DELL-SONiC-R2(config-route-map)# set origin egp
DELL-SONiC-R2(config-route-map)# exit
The next sequence is to allow all other routes (2.2.2.2/32 and 3.3.3.3/32) without any modification. 
You can write a separate prefix list for this but for simplicity we are not defining any match entry. 
If a match entry is not present, all routes are considered match under the sequence. 
If no set action is specified the default action is redistribute the route without any modification. 

DELL-SONiC-R2(config)# route-map MAP-TO-MODIFICATION permit 2
DELL-SONiC-R2(config-route-map)# exit
DELL-SONiC-R2(config)# exit
DELL-SONiC-R2#

Laten we de configuratie van de routekaart controleren.

DELL-SONiC-R2# show running-configuration route-map
!
route-map MAP-TO-MODIFICATION permit 1
 match ip address prefix-list IP-LIST-TO-MODIFY
 set origin egp
!
route-map MAP-TO-MODIFICATION permit 2
DELL-SONiC-R2#
DELL-SONiC-R2# show route-map
Route map MAP-TO-MODIFICATION:
   permit, sequence 1
    Match clauses:
      ip address prefix-list IP-LIST-TO-MODIFY
    Set clauses:
      route origin EGP
    Call clauses:
    Actions:
      Exit routemap
   permit, sequence 2
    Match clauses:
    Set clauses:
    Call clauses:
    Actions:
      Exit routemap
DELL-SONiC-R2#

Laten we de routekaart MAP-TO-MODIFICATION toepassen in de uitgaande richting naar buur DELL-SONiC-R3 (20.0.0.2)
DELL-SONiC-R2(config)# router bgp 100
DELL-SONiC-R2(config-router-bgp)# neighbor 20.0.0.2
DELL-SONiC-R2(config-router-bgp-neighbor)# remote-as 200
DELL-SONiC-R2(config-router-bgp-neighbor)# no shutdown
DELL-SONiC-R2(config-router-bgp-neighbor)# address-family ipv4 unicast
DELL-SONiC-R2(config-router-bgp-neighbor-af)# route-map MAP-TO-MODIFICATION out          ===>Apply the Route-map in outbound direction
DELL-SONiC-R2(config-router-bgp-neighbor-af)# end
DELL-SONiC-R2#

Laten we de BGP-configuratie controleren.
DELL-SONiC-R2# show running-configuration bgp
!
router bgp 100
 log-neighbor-changes
 timers 60 180
 !
 neighbor 10.0.0.1
  remote-as 100
  !
  address-family ipv4 unicast
   activate
 !
 neighbor 20.0.0.2
  remote-as 200
  !
  address-family ipv4 unicast
   activate
   route-map MAP-TO-MODIFICATION out
DELL-SONiC-R2#

We kunnen de routekaart MAP-TO-MODIFICATION zien die is toegepast op buurman 20.0.0.2.
DELL-SONiC-R2# show bgp ipv4 unicast neighbors 20.0.0.2

BGP neighbor is 20.0.0.2, remote AS 200, local AS 100, external link
  BGP version 4, remote router ID 20.0.0.2 , local router ID 20.0.0.1
  BGP state = Established, up for 00:35:59
  Last read 00:00:59, Last write 00:00:59
  Hold time is 180 seconds, keepalive interval is 60 seconds
  Minimum time between advertisement runs is 0 seconds
  Neighbor capabilities:
    4 Byte AS: advertised and received
    AddPath IPv4 Unicast Receive: advertised and received
    Route refresh: advertised and received
    Multiprotocol Extension: advertised and received
    Graceful restart: advertised and received
    Hostname capability advertised (name: DELL-SONiC-R2) received (name: DELL-SONiC-R3)
  Message statistics:
    InQ depth is 0
    OutQ depth is 0
                         Sent        Rcvd
    Opens:               2           2
    Notifications:       0           0
    Updates:             10          4
    Keepalive:           37          37
    Route Refresh:       0           0
    Capability:          0           0
    Total:               49          43

  For address family: IPv4 Unicast
    Address-family enabled
    Prefixes received 0
     Export policy:
    MAP-TO-MODIFICATION                 
  Connections established 2, dropped 1
  Last reset 00:36:00, Last reset reason Peer closed the session
  Local host: 20.0.0.1, Local port: 57552
  Foreign host: 20.0.0.2, Foreign port: 179
  BGP Connect Retry Timer in Seconds 30


DELL-SONiC-R2#



Controle

Laten we eens kijken hoe de routes 1.1.1.1/32, 2.2.2.2/32 en 3.3.3.3/32 eruit zien op DELL-SONiC-R1, DELL-SONiC-R2, DELL-SONiC-R3.

On DELL-SONiC-R1
 
DELL-SONiC-R1# show bgp ipv4 unicast
BGP routing table information for VRF default
Router identifier 10.0.0.1, local AS number 100
Status codes: R - removed, S - stale, s - suppressed, * - valid
              h - history, d - damped, > - best, = - multipath, q - queued, r - RIB-failure
Origin codes: i - IGP, e - EGP, ? - incomplete
     Network             Next Hop                                 Metric      LocPref     Weight Path
*>   1.1.1.1/32          0.0.0.0                                  0                       32768      ?                       
*>   2.2.2.2/32          0.0.0.0                                  0                       32768      ?
*>   3.3.3.3/32          0.0.0.0                                  0                       32768      ?
*>   10.0.0.0/24         0.0.0.0                                  0                       32768      ?
DELL-SONiC-R1#
DELL-SONiC-R1# show bgp ipv4 unicast 1.1.1.1
BGP routing table entry for 1.1.1.1/32
Paths: (1 available, best #1, table default)
  Local
    0.0.0.0 from 0.0.0.0 (10.0.0.1)
      Origin incomplete, metric 0, weight 32768, valid, best (First path received)
      Last update: 2024-02-21 17:15:48+0000
DELL-SONiC-R1#

DELL-SONiC-R1# show bgp ipv4 unicast 2.2.2.2
BGP routing table entry for 2.2.2.2/32
Paths: (1 available, best #1, table default)
  Local
    0.0.0.0 from 0.0.0.0 (10.0.0.1)
      Origin incomplete, metric 0, weight 32768, valid, best (First path received)
      Last update: 2024-02-21 17:15:48+0000
DELL-SONiC-R1#


We can see the Origin incomplete for 1.1.1.1/32 and 2.2.2.2/32


DELL-SONiC-R1# show ip route
Codes:  K - kernel route, C - connected, S - static, B - BGP, O - OSPF
        > - selected route, * - FIB route, q - queued route, r - rejected route
       Destination        Gateway                                                                    Dist/Metric   Last Update
--------------------------------------------------------------------------------------------------------------------------------
 C>*   1.1.1.1/32         Direct                          Loopback0                                  0/0           00:38:32 ago
 C>*   2.2.2.2/32         Direct                          Loopback1                                  0/0           00:38:32 ago
 C>*   3.3.3.3/32         Direct                          Loopback3                                  0/0           00:38:32 ago
 C>*   10.0.0.0/24        Direct                          Eth1/1                                     0/0           00:38:32 ago


On DELL-SONiC-R2
 
DELL-SONiC-R2# show bgp ipv4 unicast
BGP routing table information for VRF default
Router identifier 20.0.0.1, local AS number 100
Status codes: R - removed, S - stale, s - suppressed, * - valid
              h - history, d - damped, > - best, = - multipath, q - queued, r - RIB-failure
Origin codes: i - IGP, e - EGP, ? - incomplete
     Network             Next Hop                                 Metric      LocPref     Weight Path
*>   1.1.1.1/32          10.0.0.1                                 0           100         0          ?                               
*>   2.2.2.2/32          10.0.0.1                                 0           100         0          ?
*>   3.3.3.3/32          10.0.0.1                                 0           100         0          ?
*>   10.0.0.0/24         10.0.0.1                                 0           100         0          ?
DELL-SONiC-R2#
DELL-SONiC-R2# show bgp ipv4 unicast 1.1.1.1
BGP routing table entry for 1.1.1.1/32
Paths: (1 available, best #1, table default)
  Local
    10.0.0.1 from 10.0.0.1 (10.0.0.1)
      Origin incomplete, metric 0, localpref 100, valid, internal, best (First path received)
      Last update: 2024-02-21 17:17:25+0000
DELL-SONiC-R2#

DELL-SONiC-R2# show bgp ipv4 unicast 2.2.2.2
BGP routing table entry for 2.2.2.2/32
Paths: (1 available, best #1, table default)
  Local
    10.0.0.1 from 10.0.0.1 (10.0.0.1)
      Origin incomplete, metric 0, localpref 100, valid, internal, best (First path received)
      Last update: 2024-02-21 17:17:26+0000
DELL-SONiC-R2#


We can see the Origin incomplete for 1.1.1.1/32 and 2.2.2.2/32.
DELL-SONiC-R2# show ip route
Codes:  K - kernel route, C - connected, S - static, B - BGP, O - OSPF
        > - selected route, * - FIB route, q - queued route, r - rejected route
       Destination        Gateway                                                                    Dist/Metric   Last Update
--------------------------------------------------------------------------------------------------------------------------------
 B>*   1.1.1.1/32         via 10.0.0.1                    Eth1/1                                     200/0         00:39:48 ago
 B>*   2.2.2.2/32         via 10.0.0.1                    Eth1/1                                     200/0         00:39:48 ago
 B>*   3.3.3.3/32         via 10.0.0.1                    Eth1/1                                     200/0         00:39:48 ago
 B     10.0.0.0/24        via 10.0.0.1                                                               200/0         00:39:48 ago
 C>*   10.0.0.0/24        Direct                          Eth1/1                                     0/0           00:40:08 ago
 C>*   20.0.0.0/24        Direct                          Eth1/2                                     0/0           00:40:08 ago


On DELL-SONiC-R3
 
DELL-SONiC-R3# show bgp ipv4 unicast
BGP routing table information for VRF default
Router identifier 20.0.0.2, local AS number 200
Status codes: R - removed, S - stale, s - suppressed, * - valid
              h - history, d - damped, > - best, = - multipath, q - queued, r - RIB-failure
Origin codes: i - IGP, e - EGP, ? - incomplete
     Network             Next Hop                                 Metric      LocPref     Weight Path
*>   1.1.1.1/32          20.0.0.1                                                         0      100 e
*>   2.2.2.2/32          20.0.0.1                                                         0      100 ?
*>   3.3.3.3/32          20.0.0.1                                                         0      100 ?
*>   10.0.0.0/24         20.0.0.1                                                         0      100 ?
DELL-SONiC-R3# 

Note the e(highlighted in red). This means the origin is EGP for 1.1.1.1/32.
DELL-SONiC-R3# show bgp ipv4 unicast 1.1.1.1/32
BGP routing table entry for 1.1.1.1/32
Paths: (1 available, best #1, table default)
  100
    20.0.0.1 from 20.0.0.1 (20.0.0.1)
      Origin EGP, valid, best
      Last update: 2024-02-21 17:17:27+0000
DELL-SONiC-R3#

We can see 1.1.1.1/32 has Origin EGP.
Lets check 2.2.2.2/32 origin

DELL-SONiC-R3# show bgp ipv4 unicast 2.2.2.2
BGP routing table entry for 2.2.2.2/32
Paths: (1 available, best #1, table default)
  100
    20.0.0.1 from 20.0.0.1 (20.0.0.1)
      Origin incomplete, metric , valid, external, best (First path received)
      Last update: 2024-02-21 17:17:26+0000
DELL-SONiC-R3#

We can see Origin incomplete for 2.2.2.2/32. 
DELL-SONiC-R3# show ip route
Codes:  K - kernel route, C - connected, S - static, B - BGP, O - OSPF
        > - selected route, * - FIB route, q - queued route, r - rejected route
       Destination        Gateway                                                                    Dist/Metric   Last Update
--------------------------------------------------------------------------------------------------------------------------------
 B>*   1.1.1.1/32         via 20.0.0.1                    Eth1/2                                     20/0          00:41:27 ago
 B>*   2.2.2.2/32         via 20.0.0.1                    Eth1/2                                     20/0          00:41:27 ago
 B>*   3.3.3.3/32         via 20.0.0.1                    Eth1/2                                     20/0          00:41:27 ago
 B>*   10.0.0.0/24        via 20.0.0.1                    Eth1/2                                     20/0          00:41:27 ago
 C>*   20.0.0.0/24        Direct                          Eth1/2                                     0/0           00:41:39 ago
DELL-SONiC-R3#
 

Affected Products

Enterprise SONiC Distribution, PowerSwitch E3200-ON Series, Dell EMC Networking N3200-ON, PowerSwitch S5212F-ON, PowerSwitch S5224F-ON, PowerSwitch S5232F-ON, PowerSwitch S5248F-ON, PowerSwitch S5296F-ON, PowerSwitch Z9264F-ON, PowerSwitch Z9332F-ON , PowerSwitch Z9432F-ON ...
Article Properties
Article Number: 000222196
Article Type: How To
Last Modified: 21 Mar 2024
Version:  8
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.