Controleer contracten en regels in de ACI-fabric

Inleiding

Dit document beschrijft hoe u kunt controleren of contracten zijn geconfigureerd en hoe u zich correct gedraagt in de Application Centric Infrastructure (ACI)-fabric. 

Topologie

In het voorbeeld dat in dit document wordt gebruikt, is Virtual Machine-A (VM) gekoppeld aan Leaf1, en is er een contract dat het mogelijk maakt om te communiceren met VM-B, dat is gekoppeld aan Leaf2. Het contract staat zowel Internet Control Message Protocol (ICMP) als HTTP toe.

Dit beeld illustreert de topologie:

Procesoverzicht

Dit is de beleidsinteractie en stroom voor contracten en regels:

1. De Policy Manager op de Application Policy Infrastructure Controller (APIC) communiceert met de Policy Element Manager op de switch.
   
   
2. De Policy Element Manager op de switch programmeert de Object Store op de switch.
   
   
3. De Policy Manager op de switch communiceert met de Access Control List Quality of Service (ACLQOS)-client op de switch.
   
   
4. De ACLQOS-client programmeert de hardware.

Identificeer de gebruikte contract/zones-regel

Hier is een voorbeeld van show zoning-rule opdrachtoutput van het blad, voordat het contract wordt toegevoegd voor de twee Eindpunt Groepen (EPGs).

fab1_leaf1# show zoning-rule

Rule ID  SrcEPG  DstEPG  FilterID  operSt   Scope     Action

=======  ======  ======  ========  ======   =====     ======

4096     0       0       implicit  enabled  16777200  deny,log

4097     0       0       implicit  enabled  3080192   deny,log

4098     0       0       implicit  enabled  2686976   deny,log

4099     0       49154   implicit  enabled  2686976   permit

4102     0       0       implicit  enabled  2097152   deny,log

4103     0       32771   implicit  enabled  2097152   permit

4117     16387   16386   12        enabled  2097152   permit

4116     16386   16387   13        enabled  2097152   permit

4100     16386   49154   default   enabled  2097152   permit

4101     49154   16386   default   enabled  2097152   permit

4104     0       32770   implicit  enabled  2097152   permit

4105     49155   16387   13        enabled  2097152   permit

4112     16387   49155   13        enabled  2097152   permit

4113     49155   16387   12        enabled  2097152   permit

4114     16387   49155   12        enabled  2097152   permit

[snip]

Dit is dezelfde opdrachtoutput nadat het contract is toegevoegd, zodat de twee EPG’s met elkaar kunnen communiceren:

fab1_leaf1# show zoning-rule

Rule ID  SrcEPG  DstEPG  FilterID  operSt   Scope     Action

=======  ======  ======  ========  ======   ========  ========

4096     0       0       implicit  enabled  16777200  deny,log

4097     0       0       implicit  enabled  3080192   deny,log

4098     0       0       implicit  enabled  2686976   deny,log

4099     0       49154   implicit  enabled  2686976   permit

4131     49155   32771   7         enabled  2686976   permit

4132     32771   49155   6         enabled  2686976   permit

4102     0       0       implicit  enabled  2097152   deny,log

4103     0       32771   implicit  enabled  2097152   permit

4117     16387   16386   12        enabled  2097152   permit

4116     16386   16387   13        enabled  2097152   permit

4100     16386   49154   default   enabled  2097152   permit

4101     49154   16386   default   enabled  2097152   permit

4104     0       32770   implicit  enabled  2097152   permit

4105     49155   16387   13        enabled  2097152   permit

4112     16387   49155   13        enabled  2097152   permit

4113     49155   16387   12        enabled  2097152   permit

4114     16387   49155   12        enabled  2097152   permit

[snip]

Opmerking: Let op de nieuwe regel-ID's (4131 en 4132) die zijn toegevoegd, de filter-ID's van 7 en 6 en het bereik van 2686976.

Waarschuwing: met deze opdrachtoutput kunt u de regels die u moet onderzoeken in een laboratoriumsysteem gemakkelijk vinden; dit kan echter lastig zijn in een productieomgeving met de dynamische veranderingen die zich voordoen.

Een andere methode die u kunt gebruiken om de belangenregels te vinden is Visore te gebruiken. Voer een zoekopdracht uit op het context Managed Object (MO) voor fvCtx. U kunt dan op dat scherm zoeken naar uw specifieke context Distinguished Name (DN), zoals hier getoond:

Neemt u nota van de mogelijkheden die deze context biedt. U kunt dit gebruiken om aan de opdrachtoutput van de show-zoning-regel in kaart te brengen zodat u de regels kunt vinden die u moet opvragen:

U kunt de segment-id/het bereik voor de context ook identificeren vanuit de gebruikersinterface (UI), zoals hier wordt getoond:

Dit werkingsgebied past dat aan die in de show zoning-regels beveloutput wordt getoond:

Zodra u de informatie van werkingsgebiedsidentificatie hebt en u de regel en filter IDs identificeert, kunt u het volgende bevel gebruiken om te verifiëren dat u de nieuwe filters (en niet impliciet ontkennen berichten tussen EPGs) raakt. Het impliciete ontkennen bericht is inbegrepen zodat door gebrek, EPGs niet kan communiceren.

Het bericht in deze opdrachtoutput dat Leaf1, Filter-6 (f-6) toeneemt:

fab1_leaf1# show system internal policy-mgr stats | grep 2686976

Rule (4098) DN (sys/actrl/scope-2686976/rule-2686976-s-any-d-any-f-implicit)
 Ingress: 0, Egress: 81553

Rule (4099) DN (sys/actrl/scope-2686976/rule-2686976-s-any-d-49154-f-implicit)
 Ingress: 0, Egress: 0

Rule (4131) DN (sys/actrl/scope-2686976/rule-2686976-s-49155-d-32771-f-7)
 Ingress: 0, Egress: 0

Rule (4132) DN (sys/actrl/scope-2686976/rule-2686976-s-32771-d-49155-f-6)
 Ingress: 1440, Egress: 0

fab1_leaf1# show system internal policy-mgr stats | grep 2686976

Rule (4098) DN (sys/actrl/scope-2686976/rule-2686976-s-any-d-any-f-implicit)
 Ingress: 0, Egress: 81553

Rule (4099) DN (sys/actrl/scope-2686976/rule-2686976-s-any-d-49154-f-implicit)
 Ingress: 0, Egress: 0

Rule (4131) DN (sys/actrl/scope-2686976/rule-2686976-s-49155-d-32771-f-7)
 Ingress: 0, Egress: 0

Rule (4132) DN (sys/actrl/scope-2686976/rule-2686976-s-32771-d-49155-f-6)
 Ingress: 1470, Egress: 0

Het bericht in deze opdrachtoutput dat Leaf2, Filter-7 (f-7) toeneemt:

fab1_leaf2# show system internal policy-mgr stats | grep 268697

Rule (4098) DN (sys/actrl/scope-2686976/rule-2686976-s-any-d-any-f-implicit)
 Ingress: 0, Egress: 80257

Rule (4099) DN (sys/actrl/scope-2686976/rule-2686976-s-any-d-49153-f-implicit)
 Ingress: 0, Egress: 0

Rule (4117) DN (sys/actrl/scope-2686976/rule-2686976-s-32771-d-49155-f-6)
 Ingress: 0, Egress: 0

Rule (4118) DN (sys/actrl/scope-2686976/rule-2686976-s-49155-d-32771-f-7)
 Ingress: 2481, Egress: 0

fab1_leaf2# show system internal policy-mgr stats | grep 268697

Rule (4098) DN (sys/actrl/scope-2686976/rule-2686976-s-any-d-any-f-implicit)
 Ingress: 0, Egress: 80257

Rule (4099) DN (sys/actrl/scope-2686976/rule-2686976-s-any-d-49153-f-implicit)
 Ingress: 0, Egress: 0

Rule (4117) DN (sys/actrl/scope-2686976/rule-2686976-s-32771-d-49155-f-6)
 Ingress: 0, Egress: 0

Rule (4118) DN (sys/actrl/scope-2686976/rule-2686976-s-49155-d-32771-f-7)
 Ingress: 2511, Egress: 0

Tip: kennis van de scope, regel-ID, bestemming, bron-pcTags en filter is belangrijk bij pogingen om deze kwestie verder op te lossen. Het is ook nuttig om kennis van de EPG's te hebben waartussen de regel-ID bestaat.

U kunt een zoekopdracht uitvoeren op de MO met de DN-naam fvAEPg en grep voor de betreffende pcTag via de opdracht moquery, zoals hier getoond:

admin@RTP_Apic1:~> moquery -c fvAEPg | grep 49155 -B 5

dn : uni/tn-Prod/ap-commerceworkspace/epg-Web
lcOwn : local
matchT : AtleastOne
modTs : 2014-10-16T01:27:35.355-04:00
monPolDn : uni/tn-common/monepg-default
pcTag : 49155

U kunt de filteroptie ook gebruiken met de opdracht moquery, zoals hier wordt getoond:

admin@RTP_Apic1:~> moquery -c fvAEPg -f 'fv.AEPg.pcTag=="49155"'
Total Objects shown: 1

# fv.AEPg
name : Web
childAction : 
configIssues : 
configSt : applied
descr : 
dn : uni/tn-Prod/ap-commerceworkspace/epg-Web
lcOwn : local
matchT : AtleastOne
modTs : 2014-10-16T01:27:35.355-04:00
monPolDn : uni/tn-common/monepg-default
pcTag : 49155
prio : unspecified
rn : epg-Web
scope : 2523136
status : 
triggerSt : triggerable
uid : 15374

Verifieer hardwareprogrammering

U kunt nu de hardware-ingang voor de regel controleren. Om de hardware-informatie te bekijken, voert u de opdracht voor het invullen van het show platform internal ns table mth_lux_slvz_DHS_SecurityGroupStatTable_memif_data in (dit is een vsh_lc opdracht):

In dit voorbeeld wordt het aantal hardware-items 41 (ITEM [000041]) verhoogd.

Opmerking: de vorige getoonde opdracht wordt gebruikt voor de Northstar ASIC. De opdracht die wordt gebruikt voor Donner of Donner+ is tonen platform interne ns table mth_luxh_slvy_DHS_SecurityGroupStatTable_memif_data.

Opmerking: het gebruik van deze opdracht is niet praktisch in een productieomgeving, maar u kunt de andere opdrachten gebruiken die in deze sectie worden beschreven.

Denk aan de regel (4132) en het toepassingsgebied (268976).

Voer deze opdracht in om de regel-ID te bepalen voor de Ternary Content-Adressable Memory (TCAM) hardware-index-entry-mapping en filter op basis van de regel-ID en/of filter-ID:

module-1# show system internal aclqos zoning-rules

[snip]

===========================================
Rule ID: 4131 Scope 4 Src EPG: 49155 Dst EPG: 32771 Filter 7

Curr TCAM resource:
=============================
   unit_id: 0
   === Region priority: 771 (rule prio: 3 entry: 3)===
       sw_index = 62 | hw_index = 40
   === Region priority: 772 (rule prio: 3 entry: 4)===
       sw_index = 63 | hw_index = 45

===========================================
Rule ID: 4132 Scope 4 Src EPG: 32771 Dst EPG: 49155 Filter 6

Curr TCAM resource:
=============================
   unit_id: 0
   === Region priority: 771 (rule prio: 3 entry: 3)===
       sw_index = 66 | hw_index = 41
   === Region priority: 771 (rule prio: 3 entry: 3)===
       sw_index = 67 | hw_index = 42

[snip]

In dit voorbeeld is de belangencombinatie bron en bestemming EPG 32771=0x8003, 49155=0xC003. Daarom kunt u alle TCAM-vermeldingen overwegen voor deze bron- en doelklassen die overeenkomen met de regel-ID’s (4131 en 4132) en filter-ID’s (6 en 7).

In dit voorbeeld worden sommige van deze TCAM-vermeldingen gedumpt. Hier is bijvoorbeeld de contractconfiguratie die pings en webverkeer voor deze EPG's toestaat:

module-1# show platform internal ns table mth_lux_slvz_DHS_SecurityGroupKeyTable0
 _memif_data 41

=======================================================================
                         TABLE INSTANCE : 0
=======================================================================
ENTRY[000041] =
               sg_label=0x4            

               sclass=0x8003            

               dclass=0xc003            

               prot=0x1  (IP Protocol 0x01 = ICMP) 

Opmerking: de vorige getoonde opdracht wordt gebruikt voor de Northstar ASIC. De opdracht die wordt gebruikt voor Donner of Donner+ is tonen platform interne ns table mth_luxh_slvq_DHS_SecurityGroupKeyTable0_memif_data.

sup_tx_mask=0x1            
               src_policy_incomplete_mask=0x1           

               dst_policy_incomplete_mask=0x1            

               class_eq_mask=0x1

               aclass_mask=0x1ff

               port_dir_mask=0x1            

               dport_mask=0xffff            

               sport_mask=0xffff           

               tcpflags_mask=0xff
            
               ip_opt_mask=0x1
            
               ipv6_route_mask=0x1
            
               ip_fragment_mask=0x1
            
               ip_frag_offset0_mask=0x1            

               ip_frag_offset1_mask=0x1            

               ip_mf_mask=0x1
            
               l4_partial_mask=0x1            

               dst_local_mask=0x1            

               routeable_mask=0x1            

               spare_mask=0x7ff            

               v4addr_key_mask=0x1            

               v6addr_key_mask=0x1            

               valid=0x1


module-1# show platform internal ns table mth_lux_slvz_DHS_SecurityGroupKeyTable0
 _memif_data 42

=======================================================================
                         TABLE INSTANCE : 0
=======================================================================
ENTRY[000042] =

               sg_label=0x4            

               sclass=0x8003            

               dclass=0xc003            

               prot=0x6 <--            

               dport=0x50 <--

sup_tx_mask=0x1
            
               src_policy_incomplete_mask=0x1            

               dst_policy_incomplete_mask=0x1            

               class_eq_mask=0x1            

               aclass_mask=0x1ff            

               port_dir_mask=0x1            

               sport_mask=0xffff            

               tcpflags_mask=0xff            

               ip_opt_mask=0x1            

               ipv6_route_mask=0x1            

               ip_fragment_mask=0x1            

               ip_frag_offset0_mask=0x1            

               ip_frag_offset1_mask=0x1            

               ip_mf_mask=0x1            

               l4_partial_mask=0x1            

               dst_local_mask=0x1

Tip: U kunt elk van de TCAM-vermeldingen met dezelfde methode verifiëren.

Problemen met hardwareprogrammering oplossen

Deze sectie biedt enkele nuttige opdrachten en tips voor probleemoplossing.

Handige opdrachten voor probleemoplossing

Hier zijn een aantal handige opdrachten die u kunt gebruiken om de pagina Policy Manager-fouten te vinden wanneer er zich problemen voordoen:

fab1_leaf1# show system internal policy-mgr event-history errors


1) Event:E_DEBUG, length:84, at 6132 usecs after Mon Sep 8 13:15:56 2014

   [103] policy_mgr_handle_ctx_mrules(779): ERROR: Failed to process prio(1537):
   (null)


2) Event:E_DEBUG, length:141, at 6105 usecs after Mon Sep 8 13:15:56 2014

   [103] policy_mgr_process_mrule_prio_aces(646): ERROR: Failed to insert iptables
   rule for rule(4120) , fentry(5_0) with priority(1537): (null)


[snip]


fab1_leaf1# show system internal policy-mgr event-histor trace

[1409945922.23737] policy_mgr_ppf_hdl_close_state:562: Got close state callback

[1409945922.23696] policy_mgr_ppf_rdy_ntf_fun:239: StatStoreEnd returned: 0x0(SU

CCESS)

[1409945922.23502] policy_mgr_ppf_rdy_ntf_fun:208: ppf ready notification: sess_

id: (0xFF0104B400005B51)

[1409945922.23475] policy_mgr_ppf_rdy_ntf_fun:205: Got ready notification callba

ck with statustype (4)

[1409945921.983476] policy_mgr_gwrap_handler:992: Dropped...now purging it...

[1409945921.982882] policy_mgr_ppf_goto_state_fun:481: Sess id (0xFF0104B400005B


[snip]


module-1# show system internal aclqos event-history trace

T [Fri Sep 5 13:18:24.863283] ============= Session End ============

T [Fri Sep 5 13:18:24.862924] Commit phase: Time taken 0.62 ms, usr 0.00 ms,

sys 0.00 ms

T [Fri Sep 5 13:18:24.862302] ppf session [0xff0104b410000087] commit ... npi

nst 1

T [Fri Sep 5 13:18:24.861421] Verify phase: Time taken 0.77 ms, usr 0.00 ms,

sys 0.00 ms

T [Fri Sep 5 13:18:24.860615] ============= Session Begin ============

T [Fri Sep 5 13:18:24.830472] ============= Session End ============

T [Fri Sep 5 13:18:24.830062] Commit phase: Time taken 0.98 ms, usr 0.00 ms,

sys 0.00 ms

T [Fri Sep 5 13:18:24.829085] ppf session [0xff0104b410000086] commit ... npi

nst 1

T [Fri Sep 5 13:18:24.827685] Verify phase: Time taken 2.04 ms, usr 0.00 ms,

sys 0.00 ms

T [Fri Sep 5 13:18:24.825388] ============= Session Begin ============

T [Fri Sep 5 12:32:51.364225] ============= Session End ============

T [Fri Sep 5 12:32:51.363748] Commit phase: Time taken 0.64 ms, usr 0.00 ms,


[snip]

Tip: Sommige bestanden zijn groot, zodat het gemakkelijker is om ze naar de bootflash te sturen, en ze te onderzoeken in een editor.

module-1# show system internal aclqos ?

asic            Asic information

brcm            Broadcam information

database        Database

event-history   Show various event logs of ACLQOS

mem-stats       Show memory allocation statistics of ACLQOS

prefix          External EPG prefixes

qos             QoS related information

range-resource  Zoning rules L4 destination port range resources

regions         Security TCAM priority regions

span            SPAN related information

zoning-rules    Show zoning rules


module-1# show system internal aclqos event-history ?

errors        Show error logs of ACLQOS

msgs          Show various message logs of ACLQOS

ppf           Show ppf logs of ACLQOS

ppf-parse     Show ppf-parse logs of ACLQOS

prefix        Show prefix logs of ACLQOS

qos           Show qos logs of ACLQOS

qos-detail    Show detailed qos logs of ACLQOS

span          Show span logs of ACLQOS

span-detail   Show detailed span logs of ACLQOS

trace         Show trace logs of ACLQOS

trace-detail  Show detailed trace logs of ACLQOS

zoning-rules  Show detailed logs of ACLQOS

Tips bij het oplossen van problemen

Hier zijn enkele nuttige tips voor probleemoplossing:

• Als u een TCAM uitputtingsprobleem lijkt te ervaren, controleer de UI of CLI op fouten die zijn geassocieerd met de regel in kwestie. Deze fout kan worden gemeld:
  
  

  Fault F1203 - Rule failed due to hardware programming error.

  Eén regel kan meer dan één TCAM-ingang in het Application Specific Integrated Circuit (ASIC) tot zich nemen. Geef deze opdrachten op om het aantal vermeldingen op de ASIC te bekijken:
  
  

  fab1-leaf1# vsh_lc
  
  module-1# show platform internal ns table-health
  VLAN STATE curr usage: 0 - size: 4096
  QQ curr usage: 0 - size: 16384
  SEG STATE curr usage: 0 - size: 4096
  SRC TEP curr usage: 0 - size: 4096
  POLICY KEY curr usage: 0 - size: 1
  SRC VP curr usage: 0 - size: 4096
  SEC GRP curr usage: 43 - size: 4096

  Opmerking: in dit voorbeeld zijn 43 items aanwezig. Dit gebruik wordt ook gerapporteerd aan de APIC in de apparaatcapaciteitsklasse.

• Wanneer er meerdere overeenkomsten zijn, keert de TCAM lookup de lagere hw-index terug. Voer deze opdracht in om de index te controleren:
  
  

  show system internal aclqos zoning-rule

  Wanneer het oplossen van problemen, kunt u de daling waarnemen die door de om het even welk-om het even welke-impliciete regel wordt veroorzaakt. Deze regel bevindt zich altijd onderaan, wat betekent dat het pakket is gevallen omdat er geen regel bestaat. Dit is ofwel te wijten aan een verkeerde configuratie, of de Policy Element Manager programmeert het niet zoals verwacht.
  
  
• De pcTags kunnen een lokale of wereldwijde scope hebben:
    

Systeem gereserveerd pcTag - Deze pcTag wordt gebruikt voor systeem interne regels (1-15).

Wereldwijd opgeruimde pcTag - Deze pcTag wordt gebruikt voor gedeelde service (16-16385).

Lokaal opgeruimde pcTag - Deze pcTag wordt lokaal gebruikt per VRF (bereik van 16386-65535).

Wanneer u probleemoplossing, een snelle blik op de lengte van de waarde wijst op zijn werkingsgebied.

Contractnaam afleiden uit regel-id

Vaak is een ingenieur op zoek naar zoneringsregels wanneer er een probleemoplossing is. In sommige gevallen heeft een EPG/pcTag veel contracten en kan het lastig zijn om problemen op te lossen. Deze sectie gaat over een manier om de naam van het contract te bepalen dat tussen EPGs/pcTags van regelidentiteitskaart wordt gebruikt die op de switch CLI wordt gezien.

Om te beginnen, versmalt de vraag voor het concrete contract/regelvoorwerp acCtrlRule indien gewenst, het onderzoek door bezit: id waarde: regel-d

Zodra de juiste regel is gevonden, klikt u op het groene pijltje op de DN om de acCtrlRule objecten kinderen te bekijken. Bij de kinderen ligt ons antwoord.

Het onderliggend object hier is acCtrlRsToEPGConn. Meestal zijn er twee, één voor elke EPG. De DN van dit object toont de twee EPG's waartussen het contract wordt toegepast, evenals de richting (aanbieder of consument) en vooral de naam van het contractobject.

Zoals benadrukt is de contractnaam in dit geval brc-dpita-ssh.

Indien nodig, vraag voor vzBrCP om het juiste contract te vinden.