Mappa del percorso di Dell Networking SONiC

Summary: Questo articolo illustra la mappa delle route con un esempio di base 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.
Check out other resources

Instructions

 
Prerequisiti
Usiamo la denominazione dell'interfaccia standard per dimostrare i concetti. Consultare l'articolo Dell Networking serie S: Configurazione dell'interfaccia di base - SONiC 4.0 (in inglese) per maggiori informazioni sulla denominazione dell'interfaccia 
 

Indice

Che cos'è una mappa del percorso.
Abbinare e impostare i valori delle istruzioni.
Sintassi
di configurazioneCrea mappa del
percorsoDichiarazione
di corrispondenzaIstruzione
SetDichiarazione
di invitoRimuovere la configurazione
della route-mapVerificare la mappa
del percorsoConfigurazione di esempio                                          

 

Che cos'è una mappa del percorso.

Route-Map viene utilizzato per modificare e controllare l'apprendimento del percorso nel processo di routing OSPF o BGP. Svolge inoltre un ruolo nella generazione di una route predefinita all'interno di un processo di routing OSPF. In sostanza, una route-map specifica quali route di un protocollo di routing specificato possono essere ridistribuite nel processo di routing di destinazione. 

Per filtrare le route per la ridistribuzione, utilizzare route-map con elenchi di prefissi IP e/o AS Path List.

La tabella seguente descrive le azioni da intraprendere quando vengono rilevati più comandi di corrispondenza all'interno di una singola sequenza di route-map.
Istruzione routemap Istruzione dell'elenco di prefissi Corrispondenza route/Nessuna corrispondenza Action
Permesso Permesso Partita La route è consentita e può eseguire, impostare o chiamare.
Permesso Nessuna corrispondenza Continuare con la sequenza della mappa del percorso successiva
Deny Partita Continuare con la sequenza della mappa del percorso successiva
Deny Nessuna corrispondenza Continuare con la sequenza della mappa del percorso successiva
Deny Permesso Partita La route è negata.
Permesso Nessuna corrispondenza Continuare con la sequenza della mappa del percorso successiva
Deny Partita Continuare con la sequenza della mappa del percorso successiva
Deny Nessuna corrispondenza Continuare con la sequenza della mappa del percorso successiva


 

Abbinare e impostare i valori delle istruzioni.

Ogni istruzione route-map ha due tipi di valori:
  • Un valore di corrispondenza seleziona le route a cui applicare questa istruzione.
  • Un valore impostato modifica le informazioni che devono essere ridistribuite nel protocollo di destinazione.
Per ogni route ridistribuita, il router valuta prima i criteri di corrispondenza di un'istruzione nella mappa della route. Se i criteri di corrispondenza hanno esito positivo, la route viene ridistribuita o rifiutata in base all'istruzione permit o deny e alcuni dei suoi attributi possono essere modificati dai valori impostati dai comandi set.

Se i criteri di corrispondenza hanno esito negativo, questa istruzione non è applicabile alla route, DELL SONiC procederà alla valutazione della route rispetto all'istruzione successiva nella mappa della route. La scansione della mappa della route continua fino a quando non viene trovata un'istruzione corrispondente alla route o fino a quando non viene raggiunta la fine della mappa della route.

Una corrispondenza o un valore impostato in ogni istruzione può essere mancato o ripetuto più volte, se si verifica una delle seguenti condizioni:
  • Se in un'istruzione sono presenti diverse voci di corrispondenza, tutte devono avere esito positivo per una determinata route affinché tale route corrisponda all'istruzione (viene applicato un algoritmo AND logico)
  • Se una voce di corrispondenza vede diversi oggetti in una voce, uno di essi deve corrispondere (viene applicato un algoritmo OR logico)
  • Se non è presente una voce di corrispondenza, tutte le route corrispondono all'istruzione.
  • Se una voce impostata non è presente nell'istruzione di autorizzazione della mappa della route, la route viene ridistribuita senza modificare i relativi attributi correnti.
  • Un'istruzione route-map senza una voce di corrispondenza o set esegue un'azione. Un'istruzione di autorizzazione vuota consente una ridistribuzione delle route rimanenti senza modifiche.
  • Un'istruzione Deny vuota non consente una ridistribuzione di altre route, in quanto questa è l'azione predefinita se una route-map viene analizzata completamente, ma non viene trovata alcuna corrispondenza esplicita.
 

Sintassi di configurazione

 

Crea mappa del percorso

Creare una route-map in modo che corrisponda ai parametri della route elencati nel passaggio successivo. Specificare un'istruzione permit o deny per configurare il modo in cui vengono gestite le route corrispondenti. Immettere il numero progressivo per l'ordine di elaborazione dell'istruzione nella mappa.

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

Dichiarazione di corrispondenza

In modalità di configurazione route-map, immettere una di queste istruzioni di corrispondenza per selezionare le route.
Sintassi dei comandi 
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.
 
 

Istruzione Set

In modalità di configurazione route-map, immettere una di queste istruzioni set per modificare l'attributo BGP specificato nelle route corrispondenti.
Sintassi dei comandi 
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
 

Dichiarazione di invito

L'istruzione "call" consente di chiamare un'altra route-map se la condizione di corrispondenza è soddisfatta.
Sintassi dei comandi 
admin@DELLSONiC :~$ sonic-cli
DELLSONiC # configure
DELLSONiC (config)# route-map map-name {permit | deny} {sequence-number}
DELLSONiC (config-route-map)# call {route-map-name}
 

Rimuovere la configurazione

Assicurarsi di rimuovere qualsiasi associazione route-map prima di rimuovere route-map. 

Per rimuovere un valore configurato in una voce della mappa route, immettere la versione no del comando match or set.
Esempio 
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
Per rimuovere route-map. 
admin@DELLSONiC :~$ sonic-cli
DELLSONiC # configure
DELLSONiC (config)# no route-map map-name
 

Verificare la mappa del percorso

Utilizzare i comandi seguenti per verificare la configurazione della mappa delle route.  
DELLSONiC# show route-map
 
DELLSONiC# show route-map {route-map-name}

Utilizzare i comandi seguenti per trovare la mappa della route applicata a un router adiacente. 
DELLSONiC# show bgp ipv4 unicast neighbors
 
DELLSONiC# show bgp ipv6 unicast neighbors

È inoltre possibile eseguire il comando grep con policy nei comandi precedenti per visualizzare un output più piccolo.  
DELLSONiC#show bgp ipv4 unicast neighbors <neighbor>| find policy


 

Configurazione di esempio

Requisiti: Vedere la topologia riportata di seguito. L'IP di loopback triplo 1.1.1.1/32, 2.2.2.2/32 e 3.3.3.3/32 viene annunciato da DELL-SONiC-R1 a DELL-SONiC-R2 utilizzando BGP.
                      Tenere presente che è necessario annunciare la route a 1.1.1.1/32 come avente EGP di origine per essere ricevuti su DELL-SONiC-R3.  
                       I percorsi 2.2.2.2/32 e 3.3.3.3/32 non devono essere modificati.

Topologia di esempio

Per prima cosa configuriamo un elenco di prefissi. Denominiamo l'elenco di prefissi IP-LIST-TO-MODIFY e consentiamo il prefisso 1.1.1.1/32.
  
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#

Configuriamo la mappa del percorso su DELL-SONiC-R2. Chiamiamo la mappa del percorso MAP-TO-MODIFICATION  
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#
 
Analizziamo la configurazione per ulteriori spiegazioni. 
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#

Verifichiamo la configurazione della route-map.

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#

Applichiamo la mappa della route MAP-TO-MODIFICATION nella direzione in uscita al router adiacente 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#

Verifichiamo la configurazione bgp. 
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#

Possiamo vedere la mappa della route MAP-TO-MODIFICATION applicata al router adiacente 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#



Verifica

Vediamo come appaiono le route 1.1.1.1/32, 2.2.2.2/32 e 3.3.3.3/32 su DELL-SONiC-R1, DELL-SONiC-R2, DELL-SONiC-R3.

Su 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


Su 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


Su 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.