Mapa trasy Dell Networking SONiC

Summary: W tym artykule wyjaśniono mapę tras na podstawowym przykładzie w systemie operacyjnym 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

 
Wymagania wstępne
Używamy standardowego nazewnictwa interfejsu, aby zademonstrować koncepcje. Zapoznaj się z artykułem Dell Networking z serii S: podstawowa konfiguracja interfejsu — SONiC 4.0 znajdziesz więcej informacji na temat nazewnictwa interfejsu 
 

Indeks

Co to jest mapa trasy.
Dopasuj i ustaw wartości instrukcji.
Składnia
konfiguracjiUtwórz mapę
trasyOświadczenie
o dopasowaniuInstrukcja
SetOświadczenie o zaproszeniu
do rozmowyUsuń konfigurację
mapy trasSprawdź mapę
trasyPrzykładowa konfiguracja                                          

 

Co to jest mapa trasy.

Route-Map służy do edytowania i kontrolowania uczenia się tras w procesie routingu OSPF lub BGP. Odgrywa również rolę w generowaniu trasy domyślnej w procesie routingu OSPF. Zasadniczo mapa tras określa, które trasy z określonego protokołu routingu mogą być redystrybuowane do docelowego procesu routingu. 

Aby filtrować trasy do redystrybucji, użyj map tras z listami prefiksów IP i/lub listą ścieżek AS.

W poniższej tabeli przedstawiono działania podejmowane w przypadku napotkania wielu poleceń dopasowania w ramach jednej sekwencji mapy trasy.
Deklaracja mapy trasy Instrukcja listy prefiksów Dopasowanie trasy/brak dopasowania Czynność
Zezwolenia Zezwolenia Mecz Trasa jest dozwolona i może wykonywać set lub call.
Zezwolenia Brak dopasowania Kontynuuj do następnej sekwencji mapy trasy
Odmów Mecz Kontynuuj do następnej sekwencji mapy trasy
Odmów Brak dopasowania Kontynuuj do następnej sekwencji mapy trasy
Odmów Zezwolenia Mecz Trasa jest odrzucona.
Zezwolenia Brak dopasowania Kontynuuj do następnej sekwencji mapy trasy
Odmów Mecz Kontynuuj do następnej sekwencji mapy trasy
Odmów Brak dopasowania Kontynuuj do następnej sekwencji mapy trasy


 

Dopasuj i ustaw wartości instrukcji.

Każda instrukcja mapy trasy ma dwa typy wartości:
  • Wartość dopasowania wybiera trasy, do których należy zastosować tę instrukcję.
  • Ustawiona wartość modyfikuje informacje, które mają być redystrybuowane do protokołu docelowego.
Dla każdej trasy, która jest redystrybuowana, router najpierw ocenia kryteria dopasowania instrukcji na mapie tras. Jeśli kryteria dopasowania powiodą się, trasa jest redystrybuowana lub odrzucana zgodnie z instrukcją zezwalania lub odrzucania, a niektóre z jej atrybutów mogą być modyfikowane przez wartości ustawione z poleceń set.

Jeśli kryteria dopasowania nie powiodą się, to stwierdzenie nie ma zastosowania do trasy, a system SONiC firmy DELL oceni trasę względem następnej instrukcji na mapie trasy. Skanowanie mapy trasy jest kontynuowane do momentu znalezienia instrukcji pasującej do trasy lub do momentu osiągnięcia końca mapy trasy.

Dopasowanie lub wartość zestawu w każdej instrukcji może zostać pominięte lub powtórzone kilka razy, jeśli istnieją następujące warunki:
  • Jeśli w instrukcji znajduje się kilka wpisów dopasowania, wszystkie muszą zakończyć się powodzeniem dla danej trasy, aby trasa była zgodna z instrukcją (stosowany jest algorytm logiczny AND)
  • Jeśli wpis dopasowania widzi kilka obiektów w jednym wpisie, jeden z nich powinien być zgodny (stosowany jest logiczny algorytm OR)
  • Jeśli wpis dopasowania nie jest obecny, wszystkie trasy są zgodne z instrukcją.
  • Jeśli wpis zestawu nie jest obecny w instrukcji zezwolenia mapy trasy, trasa jest redystrybuowana bez modyfikacji jej bieżących atrybutów.
  • Instrukcja mapy trasy bez wpisu match lub set wykonuje akcję. Oświadczenie o pustym zezwoleniu pozwala na redystrybucję pozostałych tras bez modyfikacji.
  • Pusta instrukcja deny nie zezwala na redystrybucję innych tras, ponieważ jest to akcja domyślna, jeśli mapa tras została zeskanowana, ale nie znaleziono wyraźnego dopasowania.
 

Składnia konfiguracji

 

Utwórz mapę trasy

Utwórz mapę trasy, aby dopasować ją do parametrów trasy wymienionych w następnym kroku. Określ instrukcję zezwalania lub odmowy, aby skonfigurować sposób obsługi pasujących tras. Wprowadź numer sekwencyjny dla kolejności, w jakiej zestawienie jest przetwarzane na mapie.

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

Oświadczenie o dopasowaniu

W trybie konfiguracji mapy tras wprowadź dowolną z tych instrukcji dopasowania, aby wybrać trasy.
Składnia polecenia
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.
 
 

Instrukcja Set

W trybie konfiguracji mapy tras wprowadź dowolną z tych instrukcji set, aby zmienić określony atrybut BGP w pasujących trasach.
Składnia polecenia
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

 

Oświadczenie o zaproszeniu do rozmowy

Instrukcja "call" pozwala na wywołanie innej mapy trasy, jeśli warunek dopasowania jest spełniony.
Składnia polecenia
admin@DELLSONiC :~$ sonic-cli
DELLSONiC # configure
DELLSONiC (config)# route-map map-name {permit | deny} {sequence-number}
DELLSONiC (config-route-map)# call {route-map-name}
 

Usuń konfigurację

Pamiętaj, aby usunąć wszelkie skojarzenia mapy trasy przed usunięciem mapy trasy. 

Aby usunąć skonfigurowaną wartość z wpisu mapy trasy, wprowadź brak wersji polecenia match lub set.
Przykład
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
Aby usunąć mapę trasy.
admin@DELLSONiC :~$ sonic-cli
DELLSONiC # configure
DELLSONiC (config)# no route-map map-name
 

Sprawdź mapę trasy

Użyj poniższych poleceń, aby zweryfikować konfigurację mapy trasy. 
DELLSONiC# show route-map
DELLSONiC# show route-map {route-map-name}

Użyj poniższych poleceń, aby znaleźć mapę trasy zastosowaną do sąsiada.
DELLSONiC# show bgp ipv4 unicast neighbors
DELLSONiC# show bgp ipv6 unicast neighbors

Możesz także grep z zasadami w powyższych poleceniach, aby zobaczyć mniejsze dane wyjściowe. 
DELLSONiC#show bgp ipv4 unicast neighbors <neighbor>| find policy


 

Przykładowa konfiguracja

Wymagania: Patrz poniższa topologia. Trzy adresy IP 1.1.1.1/32, 2.2.2/32 i 3.3.3.3/32 są anonsowane przez DELL-SONiC-R1 do DELL-SONiC-R2 przy użyciu protokołu BGP.
                      
Należy wziąć pod uwagę, że trasa do wersji 1.1.1.1/32 musi być reklamowana jako mająca Origin EGP, aby zostać odebrana na DELL-SONiC-R3.  
                       Trasy 2.2.2.2/32 i 3.3.3.3/32 nie powinny być zmieniane.


Przykładowa topologia

Skonfigurujmy najpierw listę prefiksów. Nazwijmy listę prefiksów IP-LIST-TO-MODIFY i zezwól na prefiks 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#

Skonfigurujmy mapę trasy na DELL-SONiC-R2. Nazwijmy mapę trasy 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#
 
Przeanalizujmy konfigurację w celu uzyskania dalszych wyjaśnień.
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#

Zweryfikujmy konfigurację mapy trasy.

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#

Zastosujmy mapę trasy MAP-TO-MODIFICATION w kierunku wychodzącym do sąsiedniego 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#

Sprawdźmy konfigurację protokołu 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#

Widzimy, że mapa trasy MAP-TO-MODIFICATION została zastosowana na sąsiednim 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#



Weryfikacja

Zobaczmy, jak wyglądają trasy 1.1.1.1/32, 2.2.2.2/32 i 3.3.3.3/32 na DELL-SONiC-R1, DELL-SONiC-R2, DELL-SONiC-R3.

W modelu 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


W systemie 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


W modelu 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.