أستكشاف أخطاء ACI Fabric Port-Track وإصلاحها

المقدمة

يصف هذا وثيقة ACI Fabric Port Tracking سمة، steps ل حل، و ركن حالة سيناريو. 

نظرة عامة

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

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

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

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

مثال للسلوك:

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

المخطط 

قائمة إختيار أستكشاف الأخطاء وإصلاحها الموصى بها

أستخدم القائمة المرجعية عند التحقيق في مشاكل مسار منفذ بنية واجهة التحكم في الوصول (ACI) من Cisco. تتضمن كل خطوة أوامر التحقق من الصحة أو أستكشاف الأخطاء وإصلاحها ذات الصلة.

---

تأكيد العرض

تحقق ما إذا كانت منافذ واجهة المضيف/الارتباط معطلة وما إذا كان الحدث مرتبطا بتتبع منفذ البنية.

التحقق من وجود عطل في مسار منفذ البنية للطراز F0532:

moquery -c faultInst -f 'fault.Inst.code=="F0532"'

مثال إشارة:

descr    : Port is down, reason being fabricTrack(connected)
severity : critical
subject  : port-down

إذا كان الخطأ F0532 موجودا، فإن الواجهة تم إسقاطها بسبب Fabric Port-Track.

---

التحقق من سياسة مسار منفذ البنية

تأكد ما إذا تم تمكين مسار منفذ البنية وراجع المعلمات التي تم تكوينها.

moquery -c infraPortTrackPol | egrep "adminSt|delay|includeApicPorts|minlinks"

مراجعة القيم المقدمة:

بارامتر	الغرض
adminSt	الإشارة إلى ما إذا كان مسار منفذ البنية ممكنا أو معطلا.
تأخير	قم باستعادة التأخير قبل إعادة تمكين منافذ التنزيل.
includeApicPorts	يشير إلى ما إذا كان يتم تضمين منافذ APIC المتصلة أم لا.
روابط دقيقة	الحد الأدنى لعدد روابط البنية التشغيلية المطلوبة.

مثال:

adminSt          : on
delay            : 300
includeApicPorts : no
minlinks         : 0

---

التحقق من صحة منافذ توصيل البنية المجاورة لبروتوكول LLDP

تأكدوا من ان الورقة لا تزال ترى مناطق العمود الفقري المتوقعة فوق وصلات النسيج.

show lldp neighbors

للحصول على معلومات تفصيلية حول وصلات بنيوية معينة:

show lldp neighbors int ethernet 1/49 detail

أستخدم هذا الإخراج لتأكيد:

• الواجهة الطرفية المحلية.
• عقدة العمود الفقري البعيدة.
• واجهة العمود الفقري البعيدة.
• وقت تعليق بروتوكول LLDP.
• ما إذا كان الجار المتوقع لا يزال موجودا.

---

التحقق من حالة واجهة توصيل البنية ومحفوظات الرفرفة

تحقق ما إذا كانت واجهة واجهة الهيكل قد تعرضت للفشل مؤخرا.

show int eth 1/49 | egrep "flapped|state"

مثال:

admin state is up, Dedicated Interface
  Last link flapped 00:02:57

يمكن أن يفسر الرفرفة الأخيرة على وصلة البنية سبب تشغيل مسار منفذ البنية.

---

التحقق من حالة واجهة التنزيل المتأثرة

دققت الدولة و رفرفة محفوظات من المضيف-يواجه/داونlink قارن.

show int eth 1/17 | egrep "flapped|state|fabric-track"

هذا يساعد على ربط حدث منفذ التنزيل مع فشل وصلة البنية.

---

مراجعة سجلات تصحيح أخطاء مسار منفذ البنية

تحقق من سجل عملية تتبع منفذ البنية على الورقة المتأثرة.

cat /var/sysmgr/tmp_logs/fabric_track.py.dbg | tail -n 15

مثال على إخراج السجل أثناء العملية العادية:

cat /var/sysmgr/tmp_logs/fabric_track.py.dbg | tail -n 15
 Reading the port track Mo
...
 Reading the port track Mo

مثال سجل ملف أثناء نافذة الفشل:

cat /var/sysmgr/tmp_logs/fabric_track.py.dbg | tail -n 15
Reading Isis Mo to check for Isis Adjacency
1 Fabric links are up
Reading l1PhysIf Mos of fabric links to check number of up fabric links
Bringdown: 0 Fabric links left up
PortTrackIf Mo is not present. Creating PortTrackIf Mo for eth1/17
Committing the port track Mo

تشير هذه الرسائل إلى أن الورقة كشفت عن إرتباطات بنيوية غير كافية وأنشأت كائنات واجهة PortTrack لمنافذ الارتباطات المتأثرة.

ملاحظات رئيسية:

• اكتشفت الورقة رابط نسيج واحدا لأعلى.
• بعد ذلك بوقت قصير، اكتشفت صفرا من روابط الأقمشة.
• إنشاء PortTrack لتتبع منافذ البنية إذا كانت الكائنات المدارة للواجهات المتأثرة.
• تم إيقاف واجهة الارتباط الخلفي، مثل ETH1/17.

---

فحص تفاصيل جهاز الإرسال والاستقبال

قم بجمع المعلومات الضوئية لوصلة النسيج المتأثرة.

show interface ethernet 1/49 transceiver details | egrep "type|name|serial"

مثال:

type is QSFP-40/100-SRBD
name is CISCO-FINISAR
serial number is FIW2440004Z-B

وهذا مهم بشكل خاص عند أستكشاف الأخطاء وإصلاحها:

• أخطاء ضوئية.
• أجهزة BiDi الضوئية.
• ضغطات خاملة.
• تفاعل أداة المراقبة.
• علامات ربط غير متوقعة.

---

تخطيط الواجهة المادية للمنفذ الداخلي

التعرف على رقم المنفذ الداخلي المقترن بالواجهة المادية.

vsh_lc -c 'show platform internal usd port info' | egrep "Eth1/49" -A 1

مثال:

Port  61.0 (Eth1/49)  : Admin UP  (1) Link UP   Cfg_Fec Disabled Fec Disabled Fcot Fiber retimer 0x0
                AN_knob No AN_cfg Yes   AN_operSt No In_debounce 0, Debounce-Time 0 usecs qsa: No

في هذا المثال، يتم تعيين ETH1/49 إلى المنفذ الداخلي 61.0.

---

مراجعة محفوظات حدث إرتباط النظام الأساسي

بعد تحديد المنفذ الداخلي، راجع محفوظات حدث الارتباط.

vsh_lc -c 'show platform internal tah event-history linkevents' | grep Port "61.0" -A 1

مثال بدون انقطاع:

Port 61.0: tahusd_port_handle_debounce: No debounce required!!

مثال على تعطيل تم تكوينه:

Port 61.0: tahusd_port_handle_debounce/9481: Started Debounce Timer for 10000 ms

وهذا يؤكد ما إذا كان قد تم تطبيق إعلان الارتباط أثناء حدث الارتباط أم لا.

---

التحقق من صحة الارتباط وتكوينه إذا لزم الأمر

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

تحقق من سياسة واجهة البنية:

moquery -c fabricFIfPol | egrep "dn|linkDebounce"

مثال:

dn           : uni/fabric/fintfpol-default
linkDebounce : 0

تحقق من الدين مباشرة من الواجهة:

show interface eth1/49 debounce

مثال بدون انقطاع:

------------------------------------------------------------------------------------
 Port          Debounce time  Value(ms)
------------------------------------------------------------------------------------
 Eth1/49       disable                0

إذا تم تعطيل تعطيل تعطيل تعطيل عمليات ترحيل البيانات الصغيرة وتشتبه في ذلك، فقم بتكوين عملية تعطيل على واجهة البنية:

configure
leaf 101
interface ethernet 1/49
link debounce time 100

هام:

• القيمة بالمللي ثانية.
• 100 = ثانية واحدة.

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

show interface eth1/49 debounce

الناتج المتوقع:

------------------------------------------------------------------------------------
 Port          Debounce time  Value(ms)
------------------------------------------------------------------------------------
 Eth1/49       enable                100

الفاصل الزمني الافتراضي للخصم هو 0 مللي ثانية. نوصي بقيمة 100 مللي ثانية، ولكن يمكنك إختيار قيمة مناسبة للنسيج الخاص بك.

---

مرجع القيادة الموحدة

المهمة
فحص أعطال مسار منفذ البنية	moquery -c faultInst -f 'fault.Inst.code="F0532"'
التحقق من سياسة مسار منفذ البنية	moquery -c infraPortTrackPol | egrep "adminSt|delay|includeApicPorts|minlinks"
التحقق من جيران بروتوكول LLDP	إظهار جيران بروتوكول LLDP
تحقق من الجوار التفصيلي لبروتوكول LLDP	show lldp neighbors int ethernet 1/49 تفصيل
التحقق من حالة وصلات البنية	عرض العدد ص 1/49 | egrep "flapped|state"
التحقق من حالة التنزيل	عرض العدد 1/17 | egrep "Flapped|state|fabric-track"
فحص سجل تصحيح أخطاء مسار منفذ البنية	cat /var/sysmgr/tmp_logs/fabric_track.py.dbg | الذيل -n 15
التحقق من تفاصيل جهاز الإرسال والاستقبال	show interface ethernet 1/49 جهاز الإرسال والاستقبال | egrep "النوع|الاسم|التسلسل"
تخطيط الواجهة المادية للمنفذ الداخلي	vsh_lc -c 'show platform internal$port info' | مصر "ETH1/49" -A 1
التحقق من أحداث إرتباط النظام الأساسي	vsh_lc -c 'show platform internal tah event-history linkevents' | GREP ميناء "61.0" -A 1
التحقق من نهج مناقشة البنية	moquery -c fabricFIfPol | egrep "dn|linkDebounce"
فحص تعطيل الواجهة	عرض الواجهة th1/49 debunk
تكوين تعليق	وقت إعلان الارتباط 10000

سيناريو حالة الركن 1: لم ترفرف الواجهة، لكن تم تشغيل مسار منفذ البنية

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

مثال:

show int eth 1/49 | egrep "flapped|state"
admin state is up, Dedicated Interface
Last link flapped 1y14w

في هذا السيناريو، لم يتم تعطيل الواجهة مؤخرا.

نظرا لأن مسار منفذ Fabric يعتمد على استعلامات الكائن المدار، تحقق مما إذا كانت الورقة يمكنها تنفيذ الاستعلام المناسب بنجاح:

moquery -c l1PhysIf -x 'query-target-filter=and(anybit(l1PhysIf.usage,"fabric"),eq(l1PhysIf.switchingSt,"enabled"))'

تحقق أيضا من إستخدام القرص، على سبيل المثال، الحالة الإشكالية:

df -h
Filesystem Size Used Avail Use% Mounted on
rootfs 2.5G 2.5G 0 100% /bin

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

الإجراء الموصى به:

• تحقق من مساحة القرص المتوفرة.
• قم بإلغاء تحديد إصدار نظام الملفات أو إصلاحه وفقا لإرشادات Cisco.
• إعادة التحقق من وظيفة الاستعلام.
• تأكد من اكتشاف وصلات البنية بشكل صحيح.

سيناريو حالة الركن 2: ضوئيات BiDi وتداخل TAP السلبي

هناك مشكلة محددة تتعلق بالأجهزة الضوئية BiDi QSFP وأجهزة TAP الضوئية السلبية المستخدمة للمراقبة.

خطر TAP السلبي

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

قد يتسبب ذلك في:

• حقن إشارة ضوئية غير متوقع.
• أحداث الارتباط المنسدل على كلا الجانبين.
• يقوم كل من الورقة والعمود الفقري بالإبلاغ عن حالات الأعطال البعيدة.
• إطلاق مسار منفذ البنية نظرا لفقد وصلات البنية العابرة.

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

الألياف القياسية طراز SR - الطراز QSFP-40/100-SRBD

باستخدام بصريات SR القياسية، تكون مسارات الإرسال والاستقبال منفصلة:

Tx -> Rx
Rx <- Tx

حركة المرور أحادية الإتجاه لكل ليف.

تخفيف موصى به

لسيناريوهات مراقبة BiDi، أستخدم ضوئيات BiDi المناسبة التي تتلقى فقط ولا تنقل إلى مسار الإنتاج.

الألياف BiDi - QSFP-40G-BD-RX

مع بصريات BiDi، يكون الإرسال والاستقبال كلاهما حاضرين على كل ألياف:

Tx/Rx <-> Tx/Rx

ويتم وصف هذا الأمر على أنه ملف ضوئي خاص ل TAP/monitor حيث يستقبل مسار الشاشة الإشارة فقط.

اعتبارات الكمبيوتر الشخصي

بالنسبة لمنافذ الارتباط الهاتفي المتصلة ب vPC، يمكن أن يتأثر سلوك الاسترداد بكل من مؤقت تأخير مسار منفذ البنية وموقت تأخير vPC.

لتكوينات تقنية vPC، إذا فقدت عقدة طرفية جميع منافذ البنية وبالتالي فقدت عمليات تجاور "داعش"، فلن تتمكن من الاتصال بنظيرتها التي تعمل بتقنية vPC. في هذه الحالة، يعاد تنشيط منافذ التنزيل بعد مرور وقت تأخير vPC أو مؤقت تأخير تعقب المنفذ لمدة أطول.

التأثير التشغيلي:

• يجب أن تطابق منافذ الارتباط البعيد غير الخاصة بجهاز الكمبيوتر تأخير إستعادة مسار منفذ البنية.
• يمكن أن تظل منافذ إرتباط vPC للتنزيل معطلة لفترة أطول إذا كان مؤقت تأخير vPC أكبر من تأخير مسار منفذ البنية.
  
  

مثال:

• تأخير مسار منفذ البنية: 300 ثانية
• مؤقت تأخير vPC: 600 ثانية
• يجب إسترداد منافذ إرتباط التنزيل ل vPC بعد 600 ثانية

ملاحظة هامة لمنافذ APIC المتصلة

ال cisco بق id CSCva95547، يربط إلى APIC يربط ميناء و بناء مسار سلوك.

من الاعتبارات التشغيلية الأساسية أن منافذ واجهة APIC يجب ألا يتم إسقاطها بواسطة مسار منفذ البنية أثناء حالات فشل التوصيل العابرة، لأن هذا قد يؤثر على اتصال الإدارة ووحدة التحكم.

يتم إستخدام خيار تضمين ApicPorts للتحكم في ما إذا كانت واجهات APIC المتصلة مضمنة في السلوك.

هذا يشير إلى أن APIC يربط ميناء استثنيت من أن يكون أعجزت ب بناء ميناء-track.

المراجع

دليل التكوين الأساسي ل Cisco APIC > الفصل: توفير الخدمات الأساسية للبنية الخاصة بواجهة التحكم في الوصول (ACI) > الفاصل الزمني لتعطيل الارتباط

دليل تكوين شبكات الطبقة 2 لواجهة برمجة التطبيقات من Cisco > الفصل: تعقب منافذ البنية

دليل تصميم البنية الأساسية المرتكزة على التطبيقات (ACI) من Cisco > تعقب المنافذ

أساسيات بنية تحتية مرتكزة على التطبيقات من Cisco > الفصل: إمداد البنية > سياسة تعقب المنفذ لاكتشاف فشل منفذ البنية

الأخطاء المرجعية:

معرف تصحيح الأخطاء من Cisco CSCva95547: طلب ميزة تعقب المنفذ: مقبض أن يعجز ورقة مفتاح ميناء يذهب إلى ال APIC

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

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