أستكشاف أخطاء شبكة IMM وإصلاحها على مجال UCS باستخدام مستكشف واجهة برمجة التطبيقات (API) ونظام التشغيل NXOS

المقدمة

يصف هذا المستند تحليل اتصال الشبكة أو العمر الافتراضي للحزمة لمجال نظام الحوسبة الموحدة (UCS) في وضع Intersight Managed ويحدد الاتصال الداخلي للخوادم باستخدام أوامر API Explorer و NXOS.

قدمه لويس أوريبي، مهندس مركز المساعدة الفنية التابع لشركة Cisco.

المتطلبات الأساسية

المتطلبات

توصي Cisco بأن تكون لديك معرفة بالمواضيع التالية:

• Intersight
• الاتصال الفعلي بالشبكة
• واجهة برمجة التطبيقات (API)

المكونات المستخدمة

تستند المعلومات الواردة في هذا المستند إلى إصدارات البرامج والمكونات المادية التالية:

• الارتباطات النسيجية Cisco UCS 6454، البرنامج الثابت 4.2(1e)
• خادم UCSB-B200-M5 المتعدد اللوحات، البرنامج الثابت 4.2(1a)
• برنامج Intersight كخدمة (SaaS)

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

معلومات أساسية

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

في وضع Intersight المدار لا يوجد أمر يقوم بتعيين الواجهات الظاهرية مع كل خادم مثل show service-profile circuit. يمكن إستخدام أوامر API Explorer/NXOS لتحديد علاقة الدوائر الداخلية التي تم إنشاؤها ضمن مجال UCS.

مستكشف واجهة برمجة التطبيقات

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

يحتوي مستكشف واجهة برمجة التطبيقات (API) على مرجع واجهة برمجة تطبيقات (API)، والذي يسرد المكالمات المتوفرة. كما يتضمن واجهة عميل نقل الحالة التمثيلية (REST) لاختبار مكالمات API.

التعرف على VIF من خلال مكالمات API

يمكنك إستخدام مجموعة من إستدعاءات واجهة برمجة التطبيقات (API) لتحديد VIF الذي يتوافق مع كل بطاقة واجهة شبكة (vNIC) افتراضية. وهذا يتيح لك أستكشاف أخطاء NXOS وإصلاحها بشكل أكثر فاعلية.

لأغراض هذا المستند، يتم التنقل باستخدام مكالمات واجهة برمجة التطبيقات من خلال هذه العناصر: الهيكل والخادم ومهايئ الشبكة وتقنية vNIC/vHBA.

اتصال API	بناء جملة
الحصول على معرف الهيكل	/redfish/v1/Chassis
الحصول على معرف المحول	/redfish/v1/chassis/{chassisId}/مهايئات الشبكة
الحصول على تفاصيل الشبكة (قائمة ببطاقات VNIC/VHBAs)	/redfish/v1/chassis/{chassisId}/NetworkAdapters/{NetworkAdapterId}
الحصول على عمليات تكوين جهاز الشبكة (تكوين بطاقة واجهة الشبكة (vNIC))	/redfish/v1/chassis/{chassisId}/NetworkAdapters/{NetworkAdapterId}/NetworkDeviceFunctions

إسترداد معرف الهيكل

انسخ معرف الهيكل لاستدعاء واجهة برمجة التطبيقات (API).

/redfish/v1/Chassis/FLM2402001F

إسترداد معرف محول الشبكة

انسخ معرف الشبكة لاستدعاء API التالي.

/redfish/v1/Chassis/FLM2402001F/NetworkAdapters/UCSB-MLOM-40G-04_FCH23527C67

إسترداد معرف بطاقة واجهة الشبكة (NIC)

انسخ معرف (معرفات) محول الشبكة.

/redfish/v1/Chassis/FLM2402001F/NetworkAdapters/UCSB-MLOM-40G-04_FCH23527C67/NetworkDeviceFunctions/Vnic-A
/redfish/v1/Chassis/FLM2402001F/NetworkAdapters/UCSB-MLOM-40G-04_FCH23527C67/NetworkDeviceFunctions/Vnic-B

إسترداد معرف معرف معرف معرف معرف فئة المورد (VIF) الخاص ببطاقة واجهة الشبكة (NIC) المقابلة

في هذه الحالة، يترجم vNIC-A إلى VIF 800. من هنا، تحتوي أوامر NXOS على هذه الواجهة الظاهرية.

تعريف VIF بمرشحات NXOS و GREP

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

ملاحظة: يجب أن تعرف ملف تعريف الخادم لاستخدام هذه الأوامر.

UCS-TS-MXC-P25-6454-IMM-A(nx-os)# show run interface | grep prev 1 IMM-Server-1
switchport trunk allowed vsan 1
switchport description SP IMM-Server-1, vHBA vhba-a, Blade:FLM2402001F
--
interface Vethernet800
description SP IMM-Server-1, vNIC Vnic-A, Blade:FLM2402001F
--
interface Vethernet803
description SP IMM-Server-1, vNIC Vnic-b, Blade:FLM2402001F
--
interface Vethernet804
description SP IMM-Server-1, vHBA vhba-a, Blade:FLM2402001F

صياغة الأمر	إستخدام
show run interface | GREP preV 1 <اسم ملف تعريف الخادم>	قوائم الشبكات الظاهرية المرتبطة بكل بطاقة واجهة شبكة (vNIC)/بطاقة HBA
show run interface | GREP prev 1 التالي 10 <اسم ملف تعريف الخادم>	قوائم التكوين التفصيلي لبرنامج Ethernet

أستكشاف أخطاء NXOS وإصلاحها

بمجرد تعيين بطاقة واجهة الشبكة (NIC) على برنامج Ethernet المراسل، يمكن إجراء التحليل على نظام التشغيل NXOS باستخدام نفس الأوامر المستخدمة لاستكشاف أخطاء الواجهات المادية وإصلاحها.

ترميز بطاقات واجهة الشبكة (NICs) هو VETHERNET.

show interface brief يظهر VETH800 في حالة انخفاض مع وجود فشل PIN مصدر ENM كسبب.

UCS-TS-MXC-P25-6454-IMM-A# connect nxos

UCS-TS-MXC-P25-6454-IMM-A(nx-os)# show interface brief | grep -i Veth800
Veth800 1 virt trunk down ENM Source Pin Fail auto

show interface يظهر Ethernet 800 في حالة تهيئة.

UCS-TS-MXC-P25-6454-IMM-A(nx-os)# show interface Vethernet 800
Vethernet800 is down (initializing)
    Port description is SP IMM-Server-1, vNIC Vnic-A, Blade:FLM2402001F
    Hardware is Virtual, address is 0000.abcd.dcba
    Port mode is trunk
    Speed is auto-speed
    Duplex mode is auto
  300 seconds input rate 0 bits/sec, 0 packets/sec
  300 seconds output rate 0 bits/sec, 0 packets/sec
  Rx
    0 unicast packets  0 multicast packets  0 broadcast packets
    0 input packets  0 bytes
    0 input packet drops
  Tx
    0 unicast packets  0 multicast packets  0 broadcast packets
    0 output packets  0 bytes
    0 flood packets
    0 output packet drops


UCS-TS-MXC-P25-6454-IMM-A(nx-os)# show running-config interface Vethernet 800

!Command: show running-config interface Vethernet800
!Running configuration last done at: Mon Sep 27 16:03:46 2021
!Time: Tue Sep 28 14:35:22 2021

version 9.3(5)I42(1e) Bios:version 05.42 

interface Vethernet800
  description SP IMM-Server-1, vNIC Vnic-A, Blade:FLM2402001F
  no lldp transmit
  no lldp receive
  no pinning server sticky
  pinning server pinning-failure link-down
  no cdp enable
  switchport mode trunk
  switchport trunk allowed vlan 1,470
  hardware vethernet mac filtering per-vlan
  bind interface port-channel1280 channel 800
  service-policy type qos input default-IMM-QOS
  no shutdown

يحتاج VIF أن يتم ربطه بواجهة توصيل، في هذا السيناريو لا يعرض show pinning border interface المثبت إلى أي وصلة.

UCS-TS-MXC-P25-6454-IMM-A(nx-os)# show pinning border-interfaces 

--------------------+---------+----------------------------------------
Border Interface     Status    SIFs                                    
--------------------+---------+----------------------------------------
Eth1/45              Active    sup-eth1         
Eth1/46              Active    Eth1/1/33  

وهذا يشير إلى أن الوصلات تتطلب تهيئة إضافية. يماثل هذا الإخراج تكوين show running لوصلة إيثرنت 1/46.

UCS-TS-MXC-P25-6454-IMM-B(nx-os)# show running-config interface ethernet 1/45

!Command: show running-config interface Ethernet1/45
!No configuration change since last restart
!Time: Wed Sep 29 05:15:21 2021

version 9.3(5)I42(1e) Bios:version 05.42 

interface Ethernet1/45
  description Uplink
  pinning border
  switchport mode trunk
  switchport trunk allowed vlan 69,470
  no shutdown

 أبديت ماك عنوان طاولة تفصيل أن Veth800 يستعمل VLAN 1 أي ليس حاضر على الوصلات.

UCS-TS-MXC-P25-6454-IMM-A(nx-os)# show mac address-table 
Legend: 
        * - primary entry, G - Gateway MAC, (R) - Routed MAC, O - Overlay MAC
        age - seconds since last seen,+ - primary entry using vPC Peer-Link,
        (T) - True, (F) - False, C - ControlPlane MAC, ~ - vsan
   VLAN     MAC Address      Type      age     Secure NTFY Ports
---------+-----------------+--------+---------+------+----+------------------
*    1     0025.b501.0036   static   -         F      F    Veth800

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

VLAN 1 غير موجود على النهج لذلك يجب إضافته. 

حدد تحرير النهج للسماح بالاتصال. يتطلب هذا التغيير نشر ملف تعريف مجال UCS.

يمكن التحقق من تعيين شبكة VLAN بواسطة CLI:

UCS-TS-MXC-P25-6454-IMM-A(nx-os)# show running-config interface ethernet 1/45

!Command: show running-config interface Ethernet1/45
!Running configuration last done at: Wed Sep 29 07:50:43 2021
!Time: Wed Sep 29 07:59:31 2021

version 9.3(5)I42(1e) Bios:version 05.42 

interface Ethernet1/45
  description Uplink
  pinning border
  switchport mode trunk
  switchport trunk allowed vlan 1,69,470
  udld disable
  no shutdown

UCS-TS-MXC-P25-6454-IMM-A(nx-os)# 

الآن بعد إضافة شبكة (شبكات) VLAN الضرورية، يمكن إستخدام نفس مجموعة الأوامر للتحقق من الاتصال على Ethernet800:

UCS-TS-MXC-P25-6454-IMM-A(nx-os)# show interface brief | grep -i Veth800
Veth800       1      virt trunk  up      none                     auto 


UCS-TS-MXC-P25-6454-IMM-A(nx-os)# show interface Vethernet 800
Vethernet800 is up
    Port description is SP IMM-Server-1, vNIC Vnic-A, Blade:FLM2402001F
    Hardware is Virtual, address is 0000.abcd.dcba
    Port mode is trunk
    Speed is auto-speed
    Duplex mode is auto
  300 seconds input rate 0 bits/sec, 0 packets/sec
  300 seconds output rate 0 bits/sec, 0 packets/sec
  Rx
    0 unicast packets  1 multicast packets  6 broadcast packets
    7 input packets  438 bytes
    0 input packet drops
  Tx
    0 unicast packets  25123 multicast packets  137089 broadcast packets
    162212 output packets  11013203 bytes
    0 flood packets
    0 output packet drops




UCS-TS-MXC-P25-6454-IMM-A(nx-os)# show running-config interface Vethernet 800

!Command: show running-config interface Vethernet800
!Running configuration last done at: Wed Sep 29 07:50:43 2021
!Time: Wed Sep 29 07:55:51 2021

version 9.3(5)I42(1e) Bios:version 05.42 

interface Vethernet800
  description SP IMM-Server-1, vNIC Vnic-A, Blade:FLM2402001F
  no lldp transmit
  no lldp receive
  no pinning server sticky
  pinning server pinning-failure link-down
  switchport mode trunk
  switchport trunk allowed vlan 1,69,470
  hardware vethernet mac filtering per-vlan
  bind interface port-channel1280 channel 800
  service-policy type qos input default-IMM-QOS
  no shutdown

 

يتم سرد VETH800 على الواجهات المثبتة لواجهات إيثرنت الوصلة:

UCS-TS-MXC-P25-6454-IMM-A(nx-os)# show pinning border-interfaces 

--------------------+---------+----------------------------------------
Border Interface     Status    SIFs                                    
--------------------+---------+----------------------------------------
Eth1/45              Active    sup-eth1 Veth800 Veth803          
Eth1/46              Active    Eth1/1/33                         

Total Interfaces : 2 

UCS-TS-MXC-P25-6454-IMM-A(nx-os)# 

VIFs الآن جاهز أن يبث حركة مرور إلى شبكة up.

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

• ملفات تعريف المجال في Intersight
• ملفات تعريف الخادم في Intersight
• نهج المجال في Intersight
• الدعم التقني والمستندات - Cisco Systems