أستكشاف أخطاء ACI وإصلاحها حول الحالة الأساسية للمحول باستخدام أوامر CLI

المقدمة

يصف هذا وثيقة cisco ACI ورقة وعمود أساسي يتحرى، بما في ذلك جدول فرز، شيكات خاص بمحول، وترابط APIC جانب.

نظرة عامة

يمكنك أستكشاف أخطاء معظم مشاكل محولات قائمة التحكم في الوصول (ACI) وإصلاحها بشكل أسرع عند إستخدام تسلسل أوامر مرتب بدلا من القفز مباشرة إلى الأوامر الداخلية العميقة. ابدأ بفحوصات الخط الأساسي للبرامج والأجهزة، واستمر في التشخيصات والحالة البيئية، ثم قم بربط مشاكل المحولات النشطة على APIC قبل الانتقال إلى الأوامر الخاصة بالميزة.

• الهوية الأساسية والبرنامج — تحقق من وضع الصورة والإصدار سبب إعادة التعيين ووقت التشغيل.
• الأجهزة والبيئة — التحقق من الوحدات النمطية ومصادر الطاقة والمراوح ودرجات الحرارة.
• التشخيصات - تحقق من التشخيصات المتوفرة عبر الإنترنت للمشرفين وبطاقات الخط ووحدات البنية.
• إرتباط APIC — تحقق من الأخطاء النشطة ومحفوظات الأعطال للعقدة المتأثرة.
• تحققات خاصة بالميزة — أستخدم الطبقة 2، الطبقة 3، وأوامر السياسة فقط بعد فهم الخط الأساسي.

جدول الفرز السريع

هدف		ما الذي يجب البحث عنه	ما العمل بعد ذلك
تأكيد وضع ACI وإصداره	show version	صورة بدء التشغيل ل ACI، الإصدار المتوقع، سبب إعادة الضبط السليم	إذا لم يكن المحول في وضع قائمة التحكم في الوصول (ACI)، فقم بإيقاف صورة التمهيد وتصحيحها أولا.
التحقق من صحة الوحدة النمطية	show module	الوحدات النمطية هي "موافق" والتشخيصات عبر الإنترنت هي "pass"	إذا لم تكن أي وحدة نمطية نشطة "موافق" أو فشلت التشخيصات، فعليك بالتعامل معها كمشكلة أجهزة أولا.
التحقق من حالة الطاقة والمروحة والحرارة	بيئة العرض	وحدات التزويد بالطاقة العاملة "على ما يرام"، وحالة المروحة "على ما يرام"، ودرجات الحرارة "عادية"	إذا كانت الحالة الشاذة الوحيدة هي وحدة تزويد بالطاقة (PSU) إحتياطية في حالة "إيقاف التشغيل"، فتحقق من نية التصميم قبل التصاعد.
التحقق من نتائج التشخيص	show diagnostic result module all	تظهر الاختبارات '.' للتمرير عبر الوحدات النشطة	إذا كان أي إختبار هو 'F' أو 'A' أو 'I'، يرتبط مع الوحدة النمطية وخرج الخطأ.
التحقق من الاكتشاف والخط الأساسي للبنية	show discoveryIssues	حالة النظام والتجاور وشبكة VLAN الداخلية وفحص تنزيل السياسة	في حالة فشل عمليات التحقق من الاكتشاف، قم بإصلاح اتصال الخط الأساسي قبل أستكشاف المشكلات وإصلاحها من خلال المستأجرين أو التوجيه.
ربط على APIC	إظهار صفحة الأخطاء <node-id> أو إظهار صفحة محفوظات الأخطاء <node-id>	رمز الخطأ وخطورته و DN المتأثر	أستخدم طريقة عرض APIC لفصل الأعراض النشطة عن الأحداث التاريخية التي تم تخليصها بالفعل.

التحقق من التكوين

قبل ترجمة حالة وقت التشغيل، تحقق من اكتشاف العقدة وتسجيلها وتشغيلها لبرنامج وضع قائمة التحكم في الوصول (ACI). للحصول على عمليات التحقق من تركيب المحول والخط الأساسي لاكتشاف البيانات، أستخدم الأمرshow discoveryissuesالمدمج وتأكد من أن APIC يقوم بالإعلام عن العقدة كموجودة في الخدمة.

التحقق من أن المحول في وضع ACI

leaf-A# show version
Software
  BIOS:      version 05.53
  kickstart: version 16.1(3f) [build 16.1(3f)]
  system:    version 16.1(3f) [build 16.1(3f)]
  PE:        version 6.1(3f)
  kickstart image file is: /bootflash/aci-n9000-dk9.16.1.3f.bin   <--- ACI mode indicator
  system image file is:    /bootflash/auto-s

Hardware
  cisco N9K-C93108TC-FX ("supervisor")
  Device name: leaf-A

Last reset at 241000 usecs after Wed Mar 11 17:28:38 2026 JST
  Reason: reset-requested-by-cli-command-reload

كيف يبدو هذا جيدا: Kickstart وخطوط النظام موجودة، وتبدأ صورة Kickstart ب 'aci-N9000'، ويكون سبب إعادة الضبط قابلا للتوضيح.

ما الذي يبدو سيئا: تعرض المخرجات ملف صورة NXOS مستقل بدون واجهة ACI أو خطوط النظام.

مجموعة أوامر التحويل الطرفي

يستخدم هذا القسم محول ورقة ذو شكل ثابت كخط أساس. يعتمد الناتج على ورقة ACI حية ويعكس كلا من الظروف الصحية والمتدهورة التي تكون مفيدة أثناء عملية الفرز.

show version

قم بتشغيل هذا الأمر للتحقق من مستوى البرنامج ووضع الصورة ووقت التشغيل وآخر سبب لإعادة التعيين.

leaf-A# show version
Software
  BIOS:      version 05.53
  kickstart: version 16.1(3f) [build 16.1(3f)]
  system:    version 16.1(3f) [build 16.1(3f)]
  PE:        version 6.1(3f)
  kickstart image file is: /bootflash/aci-n9000-dk9.16.1.3f.bin
  system image file is:    /bootflash/auto-s

Hardware
  cisco N9K-C93108TC-FX ("supervisor")
  Device name: leaf-A

Kernel uptime is 29 day(s), 19 hour(s), 52 minute(s), 45 second(s)

Last reset at 241000 usecs after Wed Mar 11 17:28:38 2026 JST
  Reason: reset-requested-by-cli-command-reload
  Service: PolicyElem Ch reload

show module

قم بتشغيل هذا الأمر للتحقق من حالة بطاقة الخط ونتائج التشخيص عبر الإنترنت على مستوى الوحدة النمطية.

leaf-A# show module
Mod  Ports  Module-Type                         Model              Status
---  -----  ----------------------------------- ------------------ ----------
1    54     48x10G+6x40/100G Switch             N9K-C93108TC-FX    ok

Mod  Online Diag Status
---  ------------------
1    pass                                       <--- basic diagnostic baseline

كيف يبدو هذا جيدا: الوحدة النمطية النشطة موافق وحالة التشخيص عبر الإنترنت هي pass.

ما الذي يبدو سيئا: حالة الوحدة النمطية غير صحيحة أو أن حالة التشخيص ليست pass.

بيئة العرض

قم بتشغيل هذا الأمر للتحقق من حالة وحدة التزويد بالطاقة والمروحة والحرارة.

leaf-A# show environment
Power Supply:
Supply    Model             Output   Capacity   Status
1         NXA-PAC-500W-PE      0 W      500 W   shut       <--- redundant PSU not in use
2         NXA-PAC-500W-PE    219 W      500 W   ok

Fan:
Fan1(sys_fan1)  NXA-FAN-30CFM-F  Status: ok
Fan2(sys_fan2)  NXA-FAN-30CFM-F  Status: ok
Fan3(sys_fan3)  NXA-FAN-30CFM-F  Status: ok
Fan4(sys_fan4)  NXA-FAN-30CFM-F  Status: ok

Temperature:
1  Inlet(1)          37  normal
1  outlet(2)         38  normal
1  x86 processor(3)  71  normal
1  Homewood(4)       56  normal

كيف يبدو هذا جيدا: وحدة التزويد بالطاقة (PSU) النشطة على ما يرام، والمراوح على ما يرام، ودرجات الحرارة عادية.

ما الذي يبدو سيئا: تتعطل وحدة التزويد بالطاقة (PSU) أثناء التشغيل أو أن حالة المروحة ليست على ما يرام أو أن أي مستشعر حراري ليس طبيعيا.

show diagnostic result module all

قم بتشغيل هذا الأمر للتحقق من صحة الاختبارات التشخيصية الفعلية عبر الإنترنت، وليس حقل الملخص فقط في وحدة العرض النمطية.

leaf-A# show diagnostic result module all
Current bootup diagnostic level: bypass
Module 1: 48x10G  (Active)

Test results: (. = Pass, F = Fail, I = Incomplete,
U = Untested, A = Abort, E = Error disabled)

 1) bios-mem----------------------->  .
 2) mgmtp-lb----------------------->  .
22) cpu-cache---------------------->  .
23) mem-health--------------------->  .
24) ssd-acc------------------------>  .
33) fpga-reg-chk------------------->  .
43) tahoe-mem---------------------->  .

كيف يبدو هذا جيدا: تظهر جميع الاختبارات المطلوبة '.'.

ما الذي يبدو سيئا: أي نتيجة F أو I أو A للأجهزة النشطة.

show discoveryIssues

قم بتشغيل هذا الأمر للتحقق من صحة الانضمام والتجاور والشبكة المحلية الظاهرية (VLAN) وإمكانية وصول وحدة التحكم. هذا أحد أنفع أوامر المرور الأول للمحولات الطرفية.

leaf-A# show discoveryissues
Check 3 HW Modules Check
Test01 Fans status check                                                   PASSED
Test02 Power Supply status check                                           FAILED
      [Warn] Operational state of sys/ch/psuslot-1/psu is: shut
      [Info] Ignore this if it is a redundant power supply

Check 5 System State
Test01 Check System State                                                  PASSED
      [Info] TopSystem State is : in-service

Check 8 Infra VLAN Check
Test01 Check if infra VLAN is received                                     PASSED
      [Info] Infra VLAN received is : 4093

Check 10 IS-IS Adj Info
Test01 check IS-IS adjacencies                                             PASSED
      [Info] IS-IS adjacencies found on interfaces:
      [Info] eth1/54.30
      [Info] eth1/51.31
      [Info] eth1/53.32

Check 11 Reachability to APIC
Test01 Ping check to APIC                                                  FAILED
      [Error] Ping to APIC IP 198.51.100.1 from 198.51.100.64 with MTU 1450 failed.

وهذا المثال مفيد لأنه يوضح نتيجة مختلطة واقعية - العقدة في الخدمة ولديها عمليات تجاور بنيوية، ولكن لا يزال يمكن الوصول إلى وحدة التحكم يفشل بينما يتم إيقاف تشغيل وحدة تزويد بالطاقة (PSU) إحتياطية واحدة. يجب أن تفسر كل فشل في السياق بدلا من التعامل مع كل سطر فاشل على نفس القدر من القسوة.

مجموعة أوامر العامود الأساسي النمطي

يستخدم هذا القسم محول العمود الفقري النمطي. يختلف هيكل المخرجات عن الورقة الثابتة لأنه يجب عليك تقييم بطاقات الخط، وحدات البنية، المشرفين، ووحدات التحكم في النظام بشكل منفصل.

show version

spine-A# show version
Software
  BIOS:      version 05.53
  kickstart: version 16.1(3f) [build 16.1(3f)]
  system:    version 16.1(3f) [build 16.1(3f)]
  PE:        version 6.1(3f)
  kickstart image file is: /bootflash/aci-n9000-dk9.16.1.3f-cs_64.bin   <--- modular spine image
  system image file is:    /bootflash/auto-s

Hardware
  cisco N9K-SUP-A+ ("supervisor")
  Device name: spine-A

Last reset at 983000 usecs after Wed Mar 11 17:31:09 2026 JST
  Reason: reset-requested-by-cli-command-reload

show module

قم بتشغيل هذا الأمر للتحقق من جميع مستويات الأجهزة في الهيكل.

spine-A# show module
Mod  Ports  Module-Type                         Model              Status
---  -----  ----------------------------------- ------------------ ----------
1    32     32p 40/100G Ethernet Module         N9K-X9732C-EX      ok
2    32     32p 40/100G Ethernet Module         N9K-X9732C-EX      ok
3    36     36p 40/100G Ethernet Module         N9K-X9736C-FX      ok
22   0      Fabric Module                       N9K-C9504-FM-E     ok
23   0      Fabric Module                       N9K-C9504-FM-E     ok
24   0      Fabric Module                       N9K-C9504-FM-E     ok
26   0      Fabric Module                       N9K-C9504-FM-E     ok
27   0      Supervisor Module                   N9K-SUP-A+         active
28   0      Supervisor Module                   N9K-SUP-A+         standby
29   0      System Controller                   N9K-SC-A           standby
30   0      System Controller                   N9K-SC-A           active

Mod  Online Diag Status
---  ------------------
1    pass
2    pass
3    pass
22   pass
23   pass
24   pass
26   pass
27   pass
28   pass
29   pass
30   pass

كيف يبدو هذا جيدا: تتوفر بطاقات الخط ووحدات البنية والمشرفين ووحدات التحكم في النظام، كما يتم تمرير التشخيصات.

ما الذي يبدو سيئا: وحدات بنيوية مفقودة أو غير متوفرة، أو حالات تجاوز فشل المشرف للشذوذ، أو أي تشخيصات للوحدة النمطية الفاشلة.

بيئة العرض

spine-A# show environment
Power Supply:
Supply    Model           Output   Capacity   Status
1         N9K-PAC-3000W-B 1031 W    3000 W    ok
2         N9K-PAC-3000W-B    0 W    3000 W    shut
3         N9K-PAC-3000W-B  992 W    3000 W    ok
4         ------------      N/A W      0 W    Absent

Power Usage Summary:
Power Supply redundancy mode (operational)               Non-Redundant(combined)
Total Power Output (actual draw)                               1523 W
Total Power Available for additional modules                   1793 W

Fan:
Fan1(sys_fan1)  N9K-C9504-FAN  Status: ok
Fan2(sys_fan2)  N9K-C9504-FAN  Status: ok
Fan3(sys_fan3)  N9K-C9504-FAN  Status: ok
Fan4(sys_fan4)  N9K-C9504-FAN  Status: ok
Fan5(sys_fan5)  N9K-C9504-FAN  Status: ok
Fan6(sys_fan6)  N9K-C9504-FAN  Status: ok

Temperature:
1   ATOM processor(1)          32  normal
3   Homewood instance 2(3)     78  normal
22  LAC instance 1(2)          70  normal
27  x86 processor(4)           36  normal

هذا الإخراج هو مثال جيد للهيكل الذي يتمتع بصحة جيدة على الرغم من إيقاف وحدة تزويد بالطاقة (PSU) واحدة وعدم وجود فتحة أخرى. يشرح وضع التكرار الذي تم تكوينه سبب إستمرار تشغيل الهيكل.

show diagnostic result module all

spine-A# show diagnostic result module all
Current bootup diagnostic level: bypass
Module 1: 32p 40/100G Ethernet Module
 1) bios-mem----------------------->  .
 9) mvl4p-eobc-snake--------------->  .
39) lcfc-conn---------------------->  .
43) tahoe-mem---------------------->  .

Module 22: Fabric Module
10) mvl10p-snake------------------->  .
42) fclc-conn---------------------->  .
43) tahoe-mem---------------------->  .

Module 27: Supervisor Module  (Active)
24) ssd-acc------------------------>  .
32) nvram-cksum-------------------->  .
35) eobc-mon----------------------->  .

Module 30: System Controller
11) bcm28p-snake------------------->  .
41) pcie-bus----------------------->  .

على عمود فقري قابل لإضافة وحدات أخرى، تكون القيمة الرئيسية لهذا الأمر هي العرض. يمكنك تأكيد بطاقات الخط ووحدات البنية والمشرفين كلهم يجتازون التشخيصات في طريقة عرض واحدة.

المقطع المرافق ل APIC

بعد التحقق من صحة الخط الأساسي لواجهة سطر الأوامر (CLI) للمحول، انتقل إلى واجهة برمجة التطبيقات (APIC) لربط العقدة بكائنات خطأ نشطة وتاريخية. هذه هي الطريقة الأسرع لتحديد ما إذا كانت مشكلة المحول معزولة أو مرتبطة بالسياسات أو بيئية أو تم مسحها بالفعل.

show version

apic-A# show version
Role        Pod  Node  Name       Version
----------  ---  ----  ---------  -----------
controller  1    1     apic-A     6.1(3f)
controller  1    2     apic-B     6.1(3f)
controller  1    3     apic-C     6.1(3f)
leaf        1    101   leaf-A     n9000-16.1(3f)
spine       1    201   spine-A    n9000-16.1(3f)

أستخدم هذا الأمر للتحقق من محاذاة الإصدار بين وحدات التحكم والمحولات قبل افتراض عدم تطابق البرنامج.

إظهار ورقة الأخطاء <node-id>

apic-A# show faults leaf 101
Code            : F0532
Severity        : critical
Lifecycle       : raised
DN              : topology/pod-1/node-101/sys/phys-[eth1/11]/phys/fault-F0532
Description     : Port is down, reason being Link Not Connected(Connected),
                  used by EPG on node 101 with hostname leaf-A

Code            : F1451
Severity        : minor
Lifecycle       : raised
DN              : topology/pod-1/node-101/sys/ch/psuslot-1/psu/fault-F1451
Description     : Power supply shutdown.

Code            : F1699
Severity        : warning
Lifecycle       : raised
DN              : topology/pod-1/node-101/sys/time/prov-198.51.100.10/status/fault-F1699
Description     : NTP configuration on Leaf leaf-A is not synced to NTP server

هذا الإخراج مفيد لأنه يفصل على الفور ثلاثة مجالات - منافذ الوصول المستخدمة من قبل EPGs وحالة وحدة التزويد بالطاقة (PSU) ومزامنة الوقت.

إظهار ورقة محفوظات الأخطاء <node-id>

apic-A# show faults history leaf 101
ID                     : 8589940065
Description            : Port is down, reason:Link Not Connected(Connected), used by:Fabric
Severity               : minor
Code                   : F1394
Action                 : modification
Life Cycle             : raised

ID                     : 8589940026
Description            : TCA: ingress drop packets rate value 233 raised above threshold 200
Severity               : warning
Code                   : F112128
Action                 : creation

ID                     : 8589939383
Description            : BGP peer is not established, current state Idle
Severity               : cleared
Code                   : F0299
Action                 : deletion

أستخدم طريقة عرض المحفوظات لتمييز المشاكل النشطة عن الأحداث العابرة التي تمت استعادتها بالفعل.

استعلام عن إرتباط العقدة

apic-A# moquery -c topSystem -f 'top.System.name=="spine-A"'
# top.System
dn            : topology/pod-1/node-201/sys
name          : spine-A
role          : spine
state         : in-service
oobMgmtAddr   : 198.51.100.201
version       : n9000-16.1(3f)

أستخدم هذا الاستعلام لتأكيد تطابق طريقة عرض APIC للعقدة مع المحول الذي تقوم باستكشاف الأخطاء وإصلاحها.

أستكشاف أخطاء سير العمل وإصلاحها

1. قم بتشغيل show version على المحول للتحقق من وضع قائمة التحكم في الوصول (ACI) والإصدار ووقت التشغيل وسبب إعادة التعيين.
2. قم بتشغيل عرض الوحدة النمطية للتحقق من وجود الوحدة النمطية وحالتها وتشخيصات الملخص.
3. قم بتشغيل بيئة العرض للتحقق من حالة وحدة التزويد بالطاقة والمروحة ودرجة الحرارة.
4. قم بتشغيل show diagnostic result module all للتحقق من صحة التشخيصات الفعلية عبر الإنترنت.
5. في المحولات الطرفية، قم بتشغيل عرض مشاكل الاكتشاف للتحقق من إمكانية الوصول إلى وحدة التحكم وتجاور البنية.
6. في APIC، قم بتشغيل عرض صفحة الأخطاء <node-id>أو إظهار Fault spine <node-id>لربط العقدة بكائنات الخطأ النشطة.
7. فقط بعد فهم الخط الأساسي، يمكنك الانتقال إلى أوامر خاصة بالميزات مثل show lldp neighbors، أو show ip route vrf all، أو show ip ospf neighbor vrf all، أو show interface ethx/y trunk، أو show vpc موجز.

السيناريوهات الشائعة

السيناريو: يظهر مصدر الطاقة المتكررة فاشلا في مخرجات الخط الأساسي

المشكلة: show environment أو show discoveryIssues يبلغ PSU في حالة إيقاف التشغيل.

فحص عملياتي: قارن بين حالة وحدة التزويد بالطاقة (PSU) ووضع الوحدات الاحتياطية التي تم تكوينها وتشغيلها في نفس الإخراج.

السبب الجذري: وفي العديد من عمليات النشر المعملية وغير الاحتياطية، يتم إستخدام وحدة تزويد بالطاقة (PSU) واحدة بشكل متعمد.

الحل: تعامل مع المخرجات على أنها إعلامية ما لم تكن وحدة التزويد بالطاقة النشطة مخفضة أو أن وضع التكرار لا يطابق وجهة التصميم.

السيناريو: الورقة في الخدمة لكنها لا تزال تفشل في عمليات التحقق من الوصول الخاصة ب APIC

المشكلة: إظهار DiscoveryIssues يعرض العقدة كخدمة ولكن يفشل إختبارات اتصال APIC.

فحص التكوين: تحقق من الإدارة والتصميم تحت القابل للوصول، بما في ذلك مسار واجهة APIC المستخدم في الاختبار.

فحص عملياتي: تأكيد عمليات تجاور نظام وسيط إلى نظام وسيط (IS) ونشر الشبكة المحلية الظاهرية (VLAN) داخل نظام وسيط (VLAN) وأعطال جانب APIC) النشطة للعقدة.

السبب الجذري: يمكن أن تحتوي العقدة على حالة بنية أساسية كافية للانضمام بينما لا تزال تعرض حالات حافة تنزيل النهج أو إمكانية الوصول إلى وحدة التحكم.

الحل: أستخدم طريقة عرض خطأ APIC وتكوين إدارة العقدة لعزل ما إذا كان الفشل مرتبطا بمسار الإدارة أو يتعلق بالنفق أو يتعلق بالنهج.

معايير التصعيد

جمع الدعم الفني والتصعيد عند وجود شرط واحد أو أكثر من هذه الشروط:

• الوحدة النشطة ليست موافق أو أي إختبار تشخيص عبر الإنترنت يفشل.
• تكون الحالة البيئية غير طبيعية لوحدة تزويد بالطاقة (PSU) أو درج مروحة أو مستشعر حراري قيد الاستخدام.
• show discoveryIssues يعرض APIC الدائم reachability أو فشل تنزيل النهج بعد التحقق من صحة الاتصال.
• تعرض محفوظات أخطاء APIC عمليات فشل البنية أو النفق أو BFD أو BGP المتكررة بدون سبب خارجي واضح.

ملاحظة: تحقق من صحة إجراءات الاسترداد الاقتحامية مثل عمليات إعادة التحميل والعمليات النظيفة وإجراءات إعادة بيع الأجهزة أثناء فترة الصيانة وفي بيئة غير منتجة أولا.

معلومات ذات صلة

• أستكشاف أخطاء البنية وإصلاحها ل ACI - إعداد البنية الأولية
• أستكشاف أخطاء ACI Fabric Discovery وإصلاحها - إستبدال الجهاز
• دليل إدارة أخطاء APIC والأحداث ورسائل النظام من Cisco
• أستكشاف أخطاء قائمة التحكم في الوصول (ACI) للعنوان وإصلاحها الرمز F0467: شبكة محلية ظاهرية (VLAN) غير صالحة ومسار غير صالح ومدخل قيد الاستخدام بالفعل
• تكوين تناظر المسار
• الدعم الفني والتنزيلات من Cisco

محفوظات المراجعة

المراجعة	تاريخ النشر	التعليقات
1.0	12-Jun-2026	الإصدار الأولي