نشر Yang Suite واختبار XPath على Catalyst 9800 WLC

المقدمة

يوضح هذا المستند كيفية نشر مجموعة Yang في بيئة Python واختبار XPath على Cisco Catalyst 9800 WLC.

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

المتطلبات

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

- تكوين Catalyst 9800 WLC

- معرفة أساسية بالبيثون والبيئات الافتراضية

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

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

• Cisco Catalyst 9800 WLC Cisco IOS® XE، الإصدار 17.15.3

• Microsoft Windows 11 Enterprise مع تثبيت Python 3.8.2

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

التكوين

الخطوة 1. تثبيت Python على Windows PC.

تنزيل Python 3.8.2 ل Windows وتثبيته.

تنزيل الارتباط: إصدارات Python ل Windows

الشرح:
يلزم شركة Python لتشغيل جناح يانغ. يتم إستخدام الإصدار 3.8.2 هنا للتوافق.

الخطوة 2. التحقق من تثبيت Python و PIP.

بعد التثبيت، تأكد من أن Python و PIP يعملان بشكل صحيح.

الأوامر:

C:\Users\Administrator>python --version
C:\Users\Administrator>pip --version

النتيجة المتوقعة (مثال):

C:\Users\Administrator>python --version
Python 3.8.2

C:\Users\Administrator>pip --version
pip 25.0.1 from c:\users\administrator\appdata\local\programs\python\python38-32\lib\site-packages\pip (python 3.8)

الخطوة 3. ترقية PIP إلى أحدث إصدار لضمان التوافق مع مجموعة Yang.

:

C:\Users\Administrator>python -m pip install --upgrade pip

الشرح:
يقوم هذا الأمر بإلغاء تثبيت الإصدار القديم من PIP وتثبيت أحدث إصدار لضمان التوافق مع مجموعة Yang.
النتيجة المتوقعة (مثال):
- تم إزالة تثبيت الإصدار القديم (على سبيل المثال، PIP 19.2.3).
- تم تثبيت الإصدار الجديد (على سبيل المثال، PIP 25.0.1) بنجاح.

الخطوة 4. قم بإنشاء بيئة افتراضية لإبقاء التبعيات معزولة عن بايثون النظام.

:

C:\Users\Administrator>python -m venv yangsuitevenv

النتيجة المتوقعة:
تم إنشاء مجلد جديد باسم Yangsuitevenv على الكمبيوتر C:\Users\Administrator.

الخطوة 5. تنشيط البيئة الظاهرية.

قم بتنشيط البيئة قبل تثبيت الحزم.

:

C:\Users\Administrator>.\yangsuitevenv\Scripts\activate

النتيجة المتوقعة:
يتغير موجه الأمر لإظهار البيئة النشطة، على سبيل المثال:

(يانغسويتيفييف) C:\Users\Administrator>

الخطوة 6. تركيب مجموعة يانغ.

قم بتركيب مجموعة Yang والوحدات النمطية المطلوبة لضمان تركيب مجموعة Yang Suite وتبعياتها دون أخطاء.

:

(yangsuitevenv) C:\Users\Administrator>pip install yangsuite[core]

إذا واجهت أخطاء الوكيل:

WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ProxyError('Your proxy appears to only use HTTP and not HTTPS, try changing your proxy URL to be HTTP. See: https://xxx.xxx.xx/en/1.26.x/advanced-usage.html#https-proxy-error-http-proxy', SSLError(SSLError(1, '[SSL: WRONG_VERSION_NUMBER] wrong version number (_ssl.c:1108)')))': /simple/yangsuite/

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

:

(yangsuitevenv) C:\Users\Administrator>pip install yangsuite[core] --proxy http://x.x.x.x:port

الخطوة 7. ترقية وحدات مجموعة YANG.

قم بتحديث جميع وحدات مجموعة YANG لضمان تحقيق الوظائف الكاملة.

:

pip3 install --upgrade yangsuite yangsuite-devices yangsuite-filemanager yangsuite-yangtree yangsuite-coverage yangsuite-gnmi yangsuite-grpc-telemetry yangsuite-netconf yangsuite-restconf

الشرح:
تضمن هذه الخطوة أن مجموعة Yang Suite تحتوي على أحدث المكونات الإضافية ل NetConf و Restconf و gNMI وقياس tele.

الخطوة 8. بدء مجموعة يانغ.

قم بتشغيل عملية التهيئة لإدخال وضع التكوين التفاعلي.

:

(yangsuitevenv) C:\Users\Administrator>yangsuite

الخطوة 9. تكوين إعدادات مجموعة Yang.

أثناء التهيئة، يوعز إليك بتكوين منفذ الخدمة واسم المضيف واسم المستخدم وكلمة المرور :

إنشاء مجلد يسمى YangsutSpecialData لتخزين البيانات الخاصة بالمستخدم (وحدات YANG، وملفات تعريف الأجهزة وما إلى ذلك).

رقم منفذ الخدمة: الافتراضي هو 8480.

اسم المضيف: يوصى باستخدام Localhost أو 127.0.0.1.

حفظ الإعدادات: تأكد مع y.

خلقت username و كلمة: للوصول إلى واجهة مستخدم ويب مجموعة Yang.

النتيجة المتوقعة:
يتم حفظ التكوين، ويمكن بدء تشغيل الخدمات باستخدام الأمر yangsuite:

(yangsuitevenv) C:\Users\Administrator>yangsuite

الخطوة 10. سجل الدخول إلى مجموعة Yang عبر المستعرض: http://localhost:8480/ للوصول إلى مجموعة Cisco Yang:

التحقق من الصحة

خطوة 1. شكلت المادة حفازة 9800 WLC.

ضمنت أن NetConf يانغ وضع وSSH ميناء مكنت على ال WLC.

انتقل إلى WLC > الإدارة > الإدارة > HTTP/HTTPS/NetConf/VTY لتمكين حالة تكوين NetConf Yang وتمكين منفذ SSH 830.

CLI تشكيل:

9800(config)#netconf-yang

تكوين إعدادات AAA.

CLI تشكيل:

9800(config)#aaa authentication login default local
9800(config)#aaa authorization exec default local

الخطوة 2. أضف عنصر التحكم في الشبكة المحلية اللاسلكية (WLC) إلى مجموعة يانغ.

في مجموعة Yang، انتقل إلى الإعداد > ملفات تعريف الأجهزة > إنشاء جهاز جديد.

 أدخل اسم ملف التعريف، وعنوان IP ل WLC، واسم المستخدم وكلمة المرور.

قم بتنشيط NetConf عن طريق النقر فوق الجهاز يدعم NetConf والنقر فوق تجاوز التحقق من صحة مفتاح SSH لهذا الجهاز.

قم بتنشيط Restconf عن طريق النقر فوق الجهاز يدعم RESTCONF وامسح URL الأساسي ل RESTCONF الافتراضي إلى فارغ.

قم بتنشيط SSH عن طريق النقر فوق الجهاز للسماح بتسجيل دخول SSH والتحقق من معلومات عنصر التحكم في الشبكة المحلية اللاسلكية (WLC).

الخطوة 3. تحقق من إمكانية الوصول إلى الجهاز.

انقر فوق التحقق من إمكانية الوصول إلى الجهاز المحدد وحدد ملف تعريف الجهاز للتحقق مما إذا كان يمكن الوصول إلى عنصر التحكم في الشبكة المحلية اللاسلكية (WLC) من مجموعة Yang.

الخطوة 4. إنشاء مستودع مجموعة Yang.

قم بإنشاء مستودع لتخزين نماذج WLC Yang المطلوبة.

حدد NETconf وحدد ملف تعريف الجهاز إلى الحصول على قائمة المخطط لتنزيل كل المخطط من WLC

الخطوة 5. قم بإنشاء وحدة Yang جديدة تم تعيينها إلى مستودع ملفات Yang المرتبط.

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

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

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

الخطوة 6. إختبار استعلامات XPath.

أستخدم XPath الذي يوفره يانغ Suite للحصول على البيانات من WLC.

احصل على الاكس بي سات المطلوب في جناح يانغ.

خذ هنا اسم واجهة إدارة وحدة التحكم كمثال.

تكوين IETF للقياس عن بعد على WLC CLI

C9800(config)#telemetry ietf subscription <subscription-id>
C9800(config-mdt-subs)#encoding encode-kvgpb
C9800(config-mdt-subs)#filter xpath <xpath-expression>
C9800(config-mdt-subs)#source-address <wlc-ip>
C9800(config-mdt-subs)#stream yang-push
C9800(config-mdt-subs)#update-policy periodic <interval-in-centiseconds>
C9800(config-mdt-subs)#receiver ip address <collector-ip> <collector-port> protocol grpc-tcp

على سبيل المثال:

C9800(config)#telemetry ietf subscription 104
C9800(config-mdt-subs)#encoding encode-kvgpb
C9800(config-mdt-subs)#filter xpath /general-oper-data/mgmt-intf-data/intf-name
C9800(config-mdt-subs)#source-address 10.124.38.111
C9800(config-mdt-subs)#stream yang-push
C9800(config-mdt-subs)#update-policy periodic 2500
C9800(config-mdt-subs)#receiver ip address 10.124.41.144 18800 protocol grpc-tcp

قم بتمكين المراقبة في تتبع بيانات gRPC للحصول على البيانات المطلوبة المرسلة بواسطة WLC.

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

• دليل نشر Catalyst 9800 لقابلية البرمجة والقياس عن بعد
• مرحبا بكم في مجموعة Cisco Yang!
• مجتمع Cisco ل DevNet