تنسيق NETCONF وYANG API
مرشد
نُشرت
2023-07-07
الإصدار 4.2
مقدمة
غرض هذه الوثيقة
توضح هذه الوثائق كيفية دمج Paragon Active Assurance مع منسق خدمة الشبكة عبر Control Center NETCONF & YANG API. التدريب العملي على سبيل المثالampتم تقديم المهام الرئيسية المعنية، بما في ذلك: إنشاء ونشر وكلاء الاختبار الافتراضيين، وتشغيل الاختبارات وأجهزة المراقبة، واسترجاع النتائج من هذه الأنشطة.
في هذا المستند، يتم استخدام عميل Python NETCONF ncclient المتوفر مجانًا في دور المنسق.
الاتفاقيات
يتم استخدام الاختصارات التالية في هذه الوثيقة:
| اختصار | معنى |
| سطر الأوامر | واجهة سطر الأوامر |
| EM | مدير العناصر |
| ES | خطأ ثانيا |
| عضو البرلمان الأوروبي | نقطة نهاية MEG (مجموعة كيانات الصيانة) (تعريف ITU-T Y.1731) أو نقطة نهاية الصيانة (تعريف Cisco) |
| القيمة الافتراضية | وظيفة الشبكة الافتراضية |
| NFVO | منسق المحاكاة الافتراضية لوظيفة الشبكة |
| ن.س.د | واصف خدمة الشبكة |
| ار بي سي | استدعاء الإجراء عن بعد |
| رشفة | بروتوكول بدء الجلسة |
| اتفاقية مستوى الخدمة | اتفاقية مستوى الخدمة |
| S-VNFM | مدير VNF خاص |
| في إن إف | وظيفة الشبكة الافتراضية |
| vTA | وكيل الاختبار الظاهري |
ملاحظات حول التوافق مع الإصدارات السابقة
في الإصدارات 2.35.4/2.36.0 من NETCONF & YANG API، أصبح التحقق من صحة بعض الطلبات أكثر صرامة للالتزام بمعيار NETCONF. وهذا يعني أنه قد يتم الآن رفض كود العميل المستند إلى الإصدارات الأقدم من هذا الدليل.
على سبيل المثالample، في Python السابقampرمز le، لم يتم توفير سمة مساحة الاسم. يجب الآن توفير مساحة الاسم في طلب XML عندما تريد تعديل مورد ConfD.
المتطلبات والاستعدادات
تثبيت الكونفد
يتم استخدام ConfD (منتج من Tail-f) كوسيط بين نظام Paragon Active Assurance وNETCONF. يقوم ConfD بربط تكوين Paragon Active Assurance والبيانات التشغيلية بـ NETCONF & YANG API.
يجب أن يتم تثبيت ConfD مع برنامج مركز التحكم، كما هو موضح في دليل التثبيت.
التحقق من تشغيل ConfD
للتحقق من أن ConfD قيد التشغيل، قم بتشغيل الأمر
سش-س @localhost -p 830 netconf
للتحقق من استجابة ConfD على المنفذ 830. في الأمر، كما هو محدد بواسطة إنشاء مستخدم netconf
الأمر في دليل التثبيت، قسم تثبيت ConfD. قم بإعطاء كلمة المرور المحددة بواسطة نفس الأمر.
في المخرجات، تأكد من تضمين وحدة مركز التحكم. يجب أن يحتوي الإخراج على سطر مثل ما يلي:
http://ncc.netrounds.com?module=netrounds-ncc&المراجعة=2017-06-15
مزامنة قاعدة بيانات التكوين مع مركز التحكم
وأخيرًا، نحتاج إلى تحديث قاعدة بيانات التكوين من خلال NETCONF. سنفعل ذلك هنا عن طريق مكتبة Python تسمى ncclient (عميل NETCONF). ومع ذلك، يمكن أيضًا إنجاز المهمة بلغة برمجة مختلفة طالما أنها تستخدم بروتوكول NETCONF/YANG.
يتمثل دور ncclient في العمل كعميل تجاه خادم ConfD الذي يستضيف واجهة برمجة تطبيقات NETCONF/YANG.
تجدر الإشارة إلى أن ncclient لا يرتبط بأي شكل من الأشكال بمركز التحكم (المعروف سابقًا باسم "مركز التحكم Netrounds")، على الرغم من أن الاسم يبدأ بـ "ncc".
إليك كيفية تثبيت ncclient:
- تنزيل البرنامج من https://github.com/ncclient/ncclient.
- قم بتشغيل هذا الأمر: pip install ncclient
يمكننا الآن إجراء المزامنة على النحو التالي. لاحظ بعناية أن هذا يجب أن يتم على جهاز كمبيوتر منفصل، وليس على خادم مركز التحكم نفسه:
#
# ملحوظة:
# يعمل هذا البرنامج النصي كعميل تجاه ConfD الذي يعمل على خادم NCC.
# سيتم استخدام NETCONF/YANG API للاتصال.
ملحوظة: هذا الإجراء مطلوب أيضًا عندما يتم تثبيت وكلاء الاختبار وتسجيلهم بشكل مستقل عن NETCONF. انظر الملاحظة في قسم "انتهىview "تنسيق وكيل الاختبار" في الصفحة 17 لمزيد من المعلومات.
إعداد حسابات Paragon Active Assurance المتعددة التي تسيطر عليها NETCONF
الخطوات التالية مطلوبة فقط إذا كنت ترغب في إعداد المزيد من حسابات Paragon Active Assurance ليتم التحكم فيها بواسطة NETCONF، بالإضافة إلى الحساب الذي تم تكوينه بهذه الطريقة في دليل التثبيت، القسم "تثبيت ConfD".
بالنسبة لكل حساب من هذا القبيل، اتبع ما يلي:
- في مركز التحكم، قم بتسجيل الدخول إلى الحساب وانتقل إلى الحساب > الأذونات.
- أضف المستخدم "confd@netrounds.com"، وامنح إذن مسؤول مستخدم ConfD هذا في واجهة المستخدم الرسومية بالنقر فوق الزر "دعوة".
- قم بمزامنة قاعدة بيانات التكوين مع مركز التحكم كما هو موضح في قسم "مزامنة قاعدة بيانات التكوين مع مركز التحكم" في الصفحة 4.
يجب أن تكون الآن قادرًا على التحكم في حسابات Paragon Active Assurance المتعددة باستخدام نفس مستخدم ConfD.
ملحوظة: بمجرد البدء في التحكم في حساب Paragon Active Assurance عبر ConfD، يجب عليك عدم إجراء تغييرات على هذا الحساب من خلال web واجهة المستخدم الرسومية فيما يتعلق بأي ميزات Paragon Active Assurance التي تكون "config" (راجع الفصل "الميزات المدعومة في Paragon Active Assurance" في الصفحة 9). إذا قمت بذلك، سيؤدي ذلك إلى فقدان المزامنة.
مقدمة إلى واجهة برمجة تطبيقات تنسيق NETCONF
زيادةview
عادةً ما يكون NFVO أو منسق الخدمة التابع لجهة خارجية هو المكون الذي يبدأ جلسات الاختبار والمراقبة باستخدام Control Center API. يقوم هذا المنسق أيضًا باسترداد نتائج القياس المجمعة من أنشطة وكيل الاختبار. قد يتم استرداد مؤشرات الأداء الرئيسية للأداء بواسطة أنظمة إدارة الأداء التابعة لجهات خارجية، في حين يمكن إرسال الأحداث - بمجرد حدوثها بسبب انتهاكات الحدود المحددة في مركز التحكم - إلى أنظمة إدارة الأخطاء التابعة لجهات خارجية.
للتلخيص، يوضح الشكل أدناه كيفية تفاعل Paragon Active Assurance مع أنظمة الطرف الثالث الأخرى في مشهد OSS.
- NFVO/منسق الخدمة: يوجه مدير VNF لنشر vTAs وتكوين Paragon Active Assurance في سلسلة الخدمة. بمجرد تنشيط الخدمة، يستخدم المنسق واجهة برمجة التطبيقات (API) في مركز التحكم لبدء اختبارات تنشيط الخدمة واسترداد نتائج النجاح/الفشل. إذا تم اجتياز الاختبارات، فسيستخدم المنسق واجهة برمجة التطبيقات (API) في مركز التحكم لبدء المراقبة النشطة للخدمة. يتم استرداد مؤشرات الأداء الرئيسية من المراقبة بشكل مستمر إما عن طريق المنسق أو عن طريق نظام أساسي منفصل لإدارة الأداء.
- مركز التحكم: يقوم بنشر vTA وقياسه وإنهائه وفقًا لتعليمات NFVO أو منسق الخدمة.
- نظام إدارة الأداء أو نظام إدارة جودة الخدمة: يقرأ مؤشرات الأداء الرئيسية من المراقبة النشطة عبر واجهة برمجة تطبيقات مركز التحكم.
- نظام إدارة الأخطاء: يتلقى إشعارات NETCONF أو SNMP أو البريد الإلكتروني من مركز التحكم في حالة انتهاك اتفاقيات مستوى الخدمة.
تعريفات المفاهيم في Paragon Active Assurance
- وكلاء الاختبار: المكونات التي تقوم بإجراء القياسات (للاختبارات وكذلك المراقبين) في نظام Paragon Active Assurance. يتكون وكلاء الاختبار من برنامج يتمتع بالقدرة على إنشاء واستقبال وتحليل حركة مرور الشبكة الحقيقية.
- نوع وكيل الاختبار الذي تمت مناقشته في هذا المستند هو وكيل الاختبار الظاهري (vTA)، وهو وظيفة شبكة افتراضية (VNF) منتشرة على برنامج Hypervisor. توجد أيضًا أنواع أخرى من وكيل الاختبار.
- هناك نوعان أساسيان من القياسات في Paragon Active Assurance، وهما الاختبارات وأجهزة المراقبة.
- الاختبار: يتكون الاختبار من خطوة أو عدة خطوات، ولكل منها مدة محددة ومحددة. يتم تنفيذ الخطوات بالتسلسل. قد تستلزم كل خطوة تشغيل مهام متعددة في وقت واحد.
- الشاشة: ليس للشاشة مدة محددة ولكن يتم تنفيذها إلى أجل غير مسمى. مثل خطوة في الاختبار، قد تقوم الشاشة بتنفيذ عدة مهام متزامنة.
- القالب: عندما يتم التحكم في Paragon Active Assurance بواسطة منسق، يتم دائمًا تنفيذ الاختبارات وأجهزة المراقبة عن طريق القوالب التي يتم فيها تعريف الاختبار أو جهاز المراقبة. يمكن تمرير إعدادات المعلمة كمدخلات إلى القالب في وقت التشغيل.
سير العمل للأتمتة
وقت التصميم
في وقت التصميم، يمكنك إعداد القياسات عن طريق إنشاء قوالب للاختبارات وأجهزة المراقبة في Paragon Active Assurance. يتم تناول كيفية القيام بذلك في الفصل "نماذج الاختبار والمراقبة" في الصفحة 15.
وقت التشغيل
في وقت التشغيل، يمكنك إعداد أجهزتك وإجراء القياسات الفعلية.
- انتهىview من كل السابقينampتم العثور على ما ورد في الفصل "على سبيل المثالampملفات التحكم في Paragon Active Assurance عبر NETCONF & YANG API" في الصفحة 15.
- تم شرح كيفية نشر وكلاء الاختبار وتكوينهم في الفصل "على سبيل المثالamples: وكلاء الاختبار" في الصفحة 16.
- كيفية استيراد عناصر المخزون مثل TWAMP تم تناول العاكسات وقنوات IPTV في الفصل "على سبيل المثالamples: عناصر المخزون” في الصفحة 29.
- تم شرح كيفية تكوين الإنذارات في الفصل "على سبيل المثالamp"Les: الإنذارات" في الصفحة 35.
- تم توضيح كيفية تشغيل الاختبارات وأجهزة المراقبة عن طريق تنفيذ قوالب Paragon Active Assurance من خلال NETCONF في الفصول "على سبيل المثالamples: الاختبارات" في الصفحة 43 و"على سبيل المثالamples: الشاشات" في الصفحة 54.
الميزات المدعومة في Paragon Active Assurance
يمكن إنشاء جميع أنواع الاختبارات والمراقبة في Paragon Active Assurance وتنفيذها من خلال استخدام القوالب. يتم تناول كيفية القيام بذلك في المساعدة داخل التطبيق ضمن "الاختبارات والشاشات" > "إنشاء النماذج".
إنشاء حسابات Paragon Active Assurance غير مدعوم حاليًا؛ ومع ذلك، سيتم إعداد حساب واحد أو عدة حسابات محددة مسبقًا للمستخدم.
توضح الجداول أدناه بالتفصيل الميزات المتوفرة في Paragon Active Assurance في هذا الإصدار، وكيفية تمثيل هذه الميزات في YANG.
شرح بنيات يانغ
للراحة، يتم تقديم تعريفات هنا لبنيات YANG المشار إليها في جدول الميزات.
- التكوين (التكوين = صحيح): بيانات التكوين المطلوبة لتحويل النظام من حالة إلى أخرى.
- الحالة (config=false): بيانات الحالة: بيانات إضافية على نظام ليست بيانات تكوين، مثل معلومات الحالة للقراءة فقط والإحصائيات المجمعة.
- RPC: استدعاء إجراء عن بعد، كما هو مستخدم في بروتوكول NETCONF.
- الإعلام: يتم إرسال إعلامات الأحداث من خادم NETCONF إلى عميل NETCONF.
جداول ميزات Paragon Active Assurance المتوفرة للتنسيق
المصدر: الرصد
مسار يانغ:/الحسابات/الحساب/الشاشات
| ميزة | ميزة فرعية | بناء يانغ |
| إنشاء/تعديل/حذف الشاشة | استنادا إلى قالب الشاشة | تكوين |
| تشغيل/إيقاف الشاشة | – | تكوين |
| مراقبة القوالب | قم بإدراج قوالب الشاشة الموجودة مع المدخلات | ولاية |
| إشعارات NETCONF | تغيرت حالة التنبيه | إشعار |
| نتائج المراقبة | عداد SLA/ES للمستوى الأعلى (%) عداد SLA/ES لمستوى المهمة (%) |
ولاية |
على عكس الاختبارات (قارن المورد: الاختبارات أدناه)، لا يتم بدء تشغيل الشاشات باستخدام RPC ولكن بدلاً من ذلك عن طريق الالتزام بتكوين الشاشة.
المصدر: الاختبارات
مسار يانغ: /accounts/account/tests
| ميزة | ميزة فرعية | بناء يانغ |
| بدء الاختبار | بناء على قالب الاختبار | ار بي سي |
| إدارة الاختبارات | قائمة الاختبارات مع الحالة | ولاية |
| قوالب الاختبار | قم بإدراج قوالب الاختبار الموجودة مع المدخلات | ولاية |
| إشعارات NETCONF | تغيرت حالة الاختبار | إشعار |
| نتائج الاختبار | الحصول على حالة خطوة الاختبار (نجاح، فشل، خطأ، ...) | ولاية |
المصدر: وكلاء الاختبار
مسارات يانغ:
- /الحسابات/الحساب/وكلاء الاختبار (التكوين)
- /accounts/account/registered-test-agents (الولاية)
وكلاء الاختبار ضمن /accounts/account/test-agents هم الوكلاء الذين تم تكوينهم في الحساب. يمكن تكوين وكلاء الاختبار هؤلاء فقط واستخدامهم في الاختبارات والشاشات عبر NETCONF بواسطة المنسق.
بعد قيامك بتكوين وكيل اختبار وتسجيله في الحساب، سيظهر وكيل الاختبار ضمن /accounts/account/registered-test-agents. يمكنك العثور على جميع وكلاء الاختبار المسجلين باستخدام أمر "get" في NETCONF (قارن الفصل Exampليه: وكلاء الاختبار).
ضمن /accounts/account/registered-test-agents، قد تجد أيضًا وكلاء اختبار لم يتم تكوينهم بعد. يجب تكوين أي من عوامل الاختبار هذه قبل أن يتم استخدامها.
في سيناريو التنسيق، يوصى عمومًا بإجراء جميع عمليات التكوين لحساب Paragon Active Assurance الخاص بك من خلال NETCONF. وهذا يضمن عدم تباعد وكلاء الاختبار ووكلاء الاختبار المسجلين.
| ميزة | ميزة فرعية | بناء يانغ |
| قم بإنشاء وكيل الاختبار مسبقًا على الخادم | – | تكوين |
| تكوين وكيل الاختبار دون اتصال | (يقوم مركز التحكم بدفع التكوين إلى وكيل الاختبار عندما يتعلق الأمر بالإنترنت) |
تكوين |
| استخدم وكلاء الاختبار الموجودين/المكونين خارجيًا | استخدم في الاختبار/المراقبة | تكوين |
| تكوين الواجهات | تكوين | |
| احصل على الحالة | ولاية | |
| تكوين وكيل الاختبار (جهاز الاختبار فقط) | تكوين NTP | تكوين |
| تكوين الجسور | تكوين | |
| تكوين واجهات VLAN | تكوين | |
| تكوين مفاتيح SSH | تكوين | |
| بروتوكول الإنترنت الإصدار 6 | تكوين | |
| الأدوات | إعادة التشغيل | ار بي سي |
| تحديث | ار بي سي | |
| إشعارات NETCONF | تغيرت حالة الانترنت | إشعار |
| حالة | الحصول على حالة النظام (وقت التشغيل، واستخدام الذاكرة، متوسط التحميل، الإصدار) |
ولاية |
الموارد: المخزون
مسار يانغ: /accounts/account/twamp-عاكسات
قدرات NETCONF المدعومة
يشير الجدول أدناه إلى طلبات IETF RFCs التي تصف إمكانيات NETCONF المستخدمة لغرض تنسيق Paragon Active Assurance.
- ietf-netconf.yang
- IETF RFC 6241، بروتوكول تكوين الشبكة (NETCONF)، https://tools.ietf.org/html/rfc6241
- الطريقة الوحيدة المدعومة لمعالجة الأخطاء هي التراجع عن الخطأ.
- مخزن البيانات الوحيد المدعوم هو قابل للكتابة.
- ietf-netconf-notifications.yang
- IETF RFC 5277، إخطارات أحداث NETCONF، https://tools.ietf.org/html/rfc5277
نماذج الاختبار والمراقبة
يجب إعداد قوالب أنواع الاختبار والمراقبة يدويًا من خلال واجهة المستخدم الأمامية لـ Paragon Active Assurance. يتم تناول كيفية القيام بذلك في المساعدة داخل التطبيق ضمن "الاختبارات والشاشات" > "إنشاء النماذج".
Exampأدوات التحكم في Paragon Active Assurance عبر NETCONF & YANG API
في الفصول التالية، من المفترض أنه تم تحديد نماذج الاختبار والمراقبة المناسبة وفقًا للتعليمات الواردة في الفصل "نماذج الاختبار والمراقبة" في الصفحة 15.
الأدوات المستخدمة في السابقينampليه
كل السابقampتم إنشاء الملفات في الفصول اللاحقة باستخدام الأدوات التالية المتوفرة مجانًا:
- Pang: يستخدم لتصور وتصفح نماذج YANG.
- متوفر في https://github.com/mbj4668/pyang (استنساخ من git وتشغيل تثبيت python setup.py).
- عميل Python NETCONF "ncclient": يستخدم للتواصل مع مركز التحكم باستخدام NETCONF.
- متوفر على https://github.com/ncclient/ncclient (قم بتشغيل pip install ncclient).
تم العثور على نموذج بيانات netrounds-ncc.yang في /opt/netrounds-confd بمجرد تثبيت ConfD وفقًا لدليل التثبيت).
زيادةview من المهام الرئيسية المنجزة
(يتم توضيح بعض المهام الأخرى أيضًا في ما يلي.)
- "إنشاء ونشر وكيل اختبار جديد" في الصفحة 16
- "إنشاء عناصر المخزون (مثل العاكسات)" في الصفحة 29
- "إعداد نماذج الإنذارات ومكان إرسال الإنذارات" في الصفحة 35
- "إنشاء الاختبار وإجراؤه" في الصفحة 45
- "استرجاع نتائج الاختبار" في الصفحة 50
- "بدء تشغيل جهاز المراقبة (يتضمن إعداد الإنذارات)" في الصفحة 60
- "استرداد حالة اتفاقية مستوى الخدمة (SLA) لشاشة" في الصفحة 67
- "العمل مع tags"في الصفحة 71
Examples: وكلاء الاختبار
زيادةview تنسيق وكيل الاختبار
يعتبر وكلاء الاختبار في Paragon Active Assurance بمثابة "تكوين" في سياق التنسيق. وهذا يعني أن إنشاء وكلاء الاختبار والتحكم بهم وحذفهم يجب أن يتم عبر المنسق وNETCONF بدلاً من واجهة المستخدم الرسومية Paragon Active Assurance GUI.
هام: إذا تم تثبيت وكيل اختبار بواسطة فني وتسجيله في مركز التحكم دون إنشائه أولاً عبر NETCONF & YANG API، فلن يكون وكيل الاختبار موجودًا في قاعدة بيانات التكوين، وسيخرج النظام من المزامنة. لكي يصبح ConfD على علم بعامل الاختبار في هذه الحالة، سيكون من الضروري إجراء مزامنة جديدة مع مركز التحكم، كما هو مفصل في قسم "مزامنة قاعدة بيانات التكوين مع مركز التحكم" في الصفحة 4.
ولذلك ينبغي أن يتم تنسيق وكلاء الاختبار الافتراضيين (vTAs) من خلال الخطوات التالية:
- قم بإنشاء وكيل الاختبار الظاهري، بما في ذلك تكوين الواجهة الخاصة به، باستخدام واجهة NETCONF & YANG لمركز التحكم. سيكون اسم وكيل الاختبار هو مفتاحه الفريد.
- نشر vTA على منصة المحاكاة الافتراضية. اتبع الإرشادات الموجودة في التعليمات عبر الإنترنت ضمن وكلاء الاختبار > التثبيت. يتم توفير تكوين الواجهة الأساسي الذي يسمح لـ vTA بالاتصال بمركز التحكم، بالإضافة إلى بيانات الاعتماد للمصادقة، في vTA باستخدام بيانات مستخدم cloud-init.
بمجرد تشغيل vTA، سيتم توصيله تلقائيًا بمركز التحكم باستخدام اتصال OpenVPN مشفر. يتم إرسال إشعار NETCONF نظرًا لأن قيمة معلمة test-agent-statuschange الخاصة بـ vTA قد تغيرت الآن إلى "online".
ملحوظة: نظرًا لأن اسم vTA هو معرفه في مركز التحكم، فيجب أن يكون هذا الاسم هو نفس الاسم المحدد في مركز التحكم في "الخطوة 1" في الصفحة 17. - بمجرد اتصال vTA ومصادقته بمركز التحكم، يتم دفع تكوين الواجهة إلى vTA. هذا هو تكوين الواجهة المتوفر في "الخطوة 1" في الصفحة 17 عندما تم إنشاء vTA في مركز التحكم.
- بعد أن يؤدي vTA غرضه، قم بحذف vTA.
إنشاء ونشر وكيل اختبار جديد
نحتاج أولاً إلى إنشاء وكيل اختبار باستخدام واجهة NETCONF & YANG لمركز التحكم. عند إنشاء وكيل اختبار بهذه الطريقة، لا تكون هناك حاجة إلى المزامنة مع مركز التحكم.
نموذج YANG لعامل الاختبار كما هو موضح أدناه. يتم الحصول عليها كإخراج من الأمر
بيانغ -f شجرة netrounds-ncc.yang
يرد نموذج YANG الكامل في "الملحق: الهيكل الشجري لنموذج YANG الكامل" في الصفحة 81، والذي يحتوي أيضًا على وسيلة إيضاح تشرح الاصطلاحات المستخدمة في هذا النموذج وغيره من الرسوم التوضيحية لنموذج YANG في هذه الوثيقة.
ونقوم بالخطوات التالية، والتي نوضحها بالتفصيل فيما يلي:
- في البداية، لا يحتوي حساب Paragon Active Assurance "التجريبي" على وكلاء اختبار في مخزونه.
- يتم إنشاء وكيل اختبار يسمى "vta1" باستخدام ncclient. في هذا سtagهـ، لا يوجد وكيل اختبار حقيقي حتى الآن (أي أنه لم يبدأ بعد).
- يتم نشر وكيل الاختبار في OpenStack. (تم اختيار النشر على هذا النظام الأساسي هنا كأحد الاحتمالات من بين احتمالات أخرى.)
- يتصل وكيل الاختبار بحساب مركز التحكم "التجريبي" وهو الآن جاهز للاستخدام.
الخطوة 1: في البداية، لا يوجد وكلاء اختبار في الحساب "التجريبي". انظر لقطة الشاشة أدناه من واجهة المستخدم الرسومية لمركز التحكم.
الخطوة 2: يتم إنشاء وكيل اختبار في مركز التحكم باستخدام عميل Python NETCONF "ncclient". يوجد أدناه رمز ncclient لإنشاء وكيل اختبار له واجهة فعلية واحدة بعنوان DHCP:
استيراد argparse
من مدير الاستيراد ncclient
parser = argparse.ArgumentParser(description='اختبار إنشاء وكيل اختبار')
parser.add_argument('–host', help='اسم المضيف الذي تم العثور على ConfD فيه', مطلوب=صحيح)
parser.add_argument('–port', help='المنفذ للاتصال بـ ConfD', مطلوب=صحيح)
parser.add_argument('–اسم المستخدم', help='اسم المستخدم للاتصال بـ ConfD', مطلوب=صحيح)
parser.add_argument('–password', help='كلمة المرور لحساب ConfD', مطلوب=صحيح)
parser.add_argument('–netrounds-account', help='الاسم المختصر لحساب NCC'، مطلوب=صحيح)
parser.add_argument('–اسم وكيل الاختبار'، مساعدة='اسم وكيل الاختبار'، مطلوب=صحيح)
args = parser.parse_args()
مع manager.connect(host=args.host, port=args.port, username=args.username,
كلمة المرور = args.password، hostkey_verify = False) مثل م:
# إنشاء وكيل اختبار في مركز التحكم
أكس أم أل = """
)طباعة m.edit_config(target='running', config=xml)
ملحوظة: تم حذف الكود السابق لـ manager.connect(...) من المثال اللاحقampلو مقتطفات التعليمات البرمجية.
تم تكوين خادم NTP على eth0، كما أن eth0 هو أيضًا واجهة الإدارة (أي الواجهة التي تتصل بمركز التحكم).
لا يسمح تطبيق وكيل الاختبار حاليًا بتكوين الواجهات. لهذا السبب، بدءًا من الإصدار 2.34.0 وما بعده، من الممكن حذف تكوين الواجهة في مخطط YANG. لذلك تم تبسيط XML المقابل بشكل جذري في هذه الحالة:
بمجرد إنشاء وكيل الاختبار، فإنه يكون موجودًا في قاعدة بيانات التكوين وفي مركز التحكم. انظر لقطة الشاشة أدناه لمخزون وكيل الاختبار، والتي تعرض وكيل الاختبار "vta1":
الخطوة 3: حان الوقت الآن لنشر وكيل الاختبار "vta1" في OpenStack.
سيستخدم وكيل الاختبار بيانات مستخدم cloud-init لاسترداد المعلومات حول كيفية الاتصال بمركز التحكم. على وجه التحديد، نص بيانات المستخدم file يحتوي على المحتويات التالية (لاحظ أن أسطر #cloud-config وnetrounds_test_agent يجب أن تكون موجودة، ويجب وضع مسافة بادئة للأسطر المتبقية):
لمزيد من المعلومات، يرجى الرجوع إلى المستند كيفية نشر وكلاء الاختبار الظاهري في OpenStack.
بمجرد نشر وكيل الاختبار واتصاله بمركز التحكم، سيتم دفع التكوين من مركز التحكم إلى وكيل الاختبار.
الخطوة 4: أصبح وكيل الاختبار متصلاً بالإنترنت الآن في مركز التحكم وحصل على تكوينه. وكيل الاختبار جاهز للاستخدام في الاختبارات والمراقبة. انظر هذه الأقسام:
- "بدء الاختبار" في الصفحة 45
- "بدء تشغيل الشاشة" في الصفحة 60
إدراج وكلاء الاختبار في حساب Paragon Active Assurance الخاص بك
أدناه هو السابقampكود Python ncclient لإدراج وكلاء الاختبار في حساب Paragon Active Assurance:
تشغيل هذا الكود يعطي مخرجات مثل تلك أدناه:
حذف وكيل الاختبار
بعد اكتمال الاختبار، قد يكون من المناسب في بعض حالات الاستخدام حذف وكيل الاختبار.
يوجد أدناه مقتطف تعليمات برمجية يوضح كيفية القيام بذلك باستخدام ncclient:
إخطارات NETCONF
أدناه، نقدم مثال بسيطampالبرنامج النصي للاستماع إلى جميع إشعارات NETCONF الواردة من مركز التحكم. يتم إرسال هذه الإشعارات عند وقوع أحداث معينة، مثل توقف وكيل الاختبار عن الاتصال بالإنترنت أو اكتمال الاختبار الذي بدأه المستخدم. واستنادًا إلى المعلومات الواردة في الإشعارات، يمكن للمستخدمين تعيين إجراءات متابعة تلقائية في المُنسق.
عند تنفيذ البرنامج النصي أعلاه، سيقدم عميل NC الإشعار المستلم بتنسيق XML منظم. شاهد السابقampالإخراج أدناه، والذي يُظهر أن وكيل الاختبار أصبح غير متصل بالإنترنت بشكل غير متوقع.
2017-02-03T15:09:55.939156+00:00</eventTime>
<test-agent-status-change xmlns=’http://ncc.netrounds.com'>
تجريبي
HW1
غير متصل على الانترنت
Examples: عناصر المخزون
إنشاء (استيراد) وإدارة عناصر المخزون مثل TWAMP يتم إجراء العاكسات وY.1731 MEPs بطريقة مماثلة لوكلاء الاختبار. يوجد أدناه رمز XML وNETCONF لتعريف مثل هذه الكيانات في Paragon Active Assurance من خلال NETCONF & YANG API ولاسترجاع قوائم العناصر المحددة.
إنشاء TWAMP العاكس
إنشاء Y.1731 MEP
إنشاء قناة IPTV
إنشاء مضيف Ping
إنشاء حساب SIP
استرجاع عناصر المخزون
يوجد أدناه رمز Python لاسترداد جميع عناصر المخزون المحددة في الحساب. (يتم جلب جميع أنواع عناصر المخزون دفعة واحدة هنا لتجنب بعض التكرار في المستند. وبطبيعة الحال، يمكن جلب أي مجموعة فرعية من عناصر المخزون عن طريق ترك بعض الأسطر تحت الحساب أدناه.)
تشغيل هذا الكود يعطي مخرجات مثل تلك أدناه:
Exampليه: الإنذارات
يتم إنشاء قوالب الإنذار والعناصر المرتبطة بها (مديرو SNMP، وقوائم البريد الإلكتروني للإنذار) وإدارتها بطريقة مشابهة لعناصر المخزون. يحتوي هذا الفصل على كود XML وNETCONF لتعريف مثل هذه الكيانات في Paragon Active Assurance من خلال NETCONF & YANG API ولاسترجاع قوائم العناصر المحددة.
قوائم البريد الإلكتروني التنبيه
إنشاء قائمة بريد إلكتروني للإنذار
استرداد كافة قوائم البريد الإلكتروني التنبيه
مدراء SNMP
إنشاء مدير SNMP
استرداد كافة مديري SNMP
قوالب الإنذار
إنشاء قالب إنذار
استرداد جميع قوالب الإنذار
Exampليه: مفاتيح SSH
يمكنك إضافة مفاتيح SSH العامة إلى وكيل الاختبار عبر NETCONF & YANG API. باستخدام المفتاح الخاص المقابل، يمكنك بعد ذلك تسجيل الدخول إلى وكيل الاختبار عبر SSH.
القائمة الكاملة للعمليات المتاحة على مفاتيح SSH هي كما يلي:
- أضف مفتاح SSH
- تعديل مفتاح SSH
- فحص مفتاح SSH
- قائمة مفاتيح SSH
- حذف مفتاح SSH.
أدناه، يتم توضيح عمليات الإضافة والحذف.
حذف مفتاح SSH
إذا كنت تريد حذف مفتاح SSH، استخدم الأمر التالي:
Exampليه: الاختبارات
من المفترض هنا أنه تم إنشاء وكلاء الاختبار (العدد المطلوب للاختبارات) وفقًا للقسم "إنشاء وكيل اختبار جديد ونشره" في الصفحة 17.
مسارات نموذج يانغ للاختبارات
| غرض | مسار نموذج YANG: /accounts/account/tests... |
| الاختبارات | /. |
| اختبار [معرف] | /امتحان |
| id | /اختبار/معرف |
| اسم | /اسم الاختبار |
| حالة | /اختبار/الحالة |
| وقت البدء | /اختبار/وقت البدء |
| نهاية الزمان | /اختبار/نهاية الوقت |
| تقرير-url | /تقرير الاختبار-url |
| خطوات | /اختبار/خطوات |
| الخطوة [معرف] | /اختبار/خطوات/خطوة |
| اسم | /اختبار/خطوات/خطوة/اسم |
| id | /اختبار/خطوات/خطوة/معرف |
| وقت البدء | /اختبار/خطوات/خطوة/وقت البدء |
| نهاية الزمان | /اختبار/خطوات/خطوة/نهاية الوقت |
| حالة | /اختبار/خطوات/خطوة/حالة |
| رسالة الحالة | /test/steps/step/status-message |
| قوالب | / قوالب |
| اسم القالب] | /قوالب/قالب |
| اسم | /قوالب/قالب/اسم |
| وصف | /قوالب/قالب/وصف |
| حدود | /قوالب/قالب/معلمات |
| المعلمة [مفتاح] | /قوالب/قالب/معلمات/معلمة |
| مفتاح | /قوالب/قالب/معلمات/معلمة/مفتاح |
| يكتب | /قوالب/قالب/معلمات/معلمة/نوع |
المتطلبات الأساسية لتنسيق الاختبار
- لبدء اختبار من خلال NETCONF باستخدام عميل NC، يلزم أولاً إنشاء قالب اختبار باستخدام واجهة المستخدم الرسومية لمركز التحكم كما هو مفصل في المساعدة داخل التطبيق ضمن "الاختبارات وأجهزة المراقبة" > "إنشاء القوالب". ستكون جميع الحقول المحددة في هذا القالب باسم "إدخال القالب" مطلوبة كمعلمات في XML عند تنسيق بدء قالب الاختبار.
- يعتبر إجراء الاختبارات في Paragon Active Assurance بمثابة "حالة" في سياق التنسيق. بيانات الحالة هي بيانات غير قابلة للكتابة ولا يتم تخزينها في قاعدة بيانات التكوين، على عكس بيانات التكوين المذكورة في القسم "انتهىview "تنسيق وكيل الاختبار" في الصفحة 17. وهذا يعني بشكل أساسي أن التغييرات في الاختبارات أو القوالب في واجهة المستخدم الرسومية لمركز التحكم لن تسبب أي مشكلات متعلقة بالمزامنة بين مركز التحكم وقاعدة بيانات التكوين.
- للحصول على التقرير-URL الحق في تقارير الاختبار، تحتاج إلى التأكد من مركز التحكم URL تم تكوينه بشكل صحيح. ويتم ذلك في file /opt/netrounds-confd/settings.py. بشكل افتراضي، يتم استرداد اسم مضيف مركز التحكم باستخدام المقبس.gethostname(): انظر أدناه. إذا لم يسفر ذلك عن النتيجة الصحيحة، فستحتاج إلى تعيين اسم المضيف (أو اسم المضيف بالكامل). URL) يدويا في هذا file.
# URL من مركز التحكم بدون شرطة مائلة زائدة.
# هذا على سبيل المثالampلو المستخدمة في تقرير الاختبار-url.
HOSTNAME = المقبس.gethostname()
NETROUNDS_URL = 'https://%s' % HOSTNAME
بدء الاختبار
كما هو موضح في قسم "إنشاء ونشر وكيل اختبار جديد" في الصفحة 17، قم بتشغيل الأمر pang -f Tree netrounds-ncc.yang
من الدليل /opt/netrounds-confd/ لإخراج نموذج YANG. في هذا النموذج، يبدو RPC لبدء الاختبار باستخدام عميل NC كما يلي:
للحصول على التوضيحات، راجع القسم "الأسطورة" في الصفحة ٨١ في الملحق.
الخطوات التالية مبينة أدناه:
- تم تسجيل وكلاء الاختبار في حساب Paragon Active Assurance، ولكن لم يتم بدء أي اختبارات بعد.
- يتم تحديد معلمات الإدخال المطلوبة في قالب الاختبار الذي سيتم تشغيله.
- يتم بدء اختبار HTTP لمدة 60 ثانية باستخدام ncclient.
خطوة 1: في البداية، لم يتم بدء أي اختبارات في حساب Paragon Active Assurance. انظر لقطة الشاشة أدناه من واجهة المستخدم الرسومية لمركز التحكم.
خطوة 2: القالب الذي سنستخدمه لبدء الاختبار في هذا المثالample هو قالب اختبار HTTP. يحتوي على حقلين إدخال إلزاميين (العملاء و URL) والذي حددناه على هذا النحو عند إنشاء القالب في واجهة المستخدم الرسومية لمركز التحكم.
سوف نقوم بتعريف هذه المعلمات (من بين أمور أخرى) في تكوين XML الذي يتم توصيله إلى قاعدة بيانات التكوين بواسطة مدير NETCONF (ncclient).
الخطوة 3: بدء اختبار HTTP باستخدام ncclient.
أدناه هو السابقampرمز le حيث يتم تحديد معلومات التكوين والمعلمات المطلوبة لقالب اختبار HTTP. اعتمادًا على كيفية إنشاء القالب، قد تختلف التفاصيل هنا.
لكل معلمة يجب توفير السمة. المفتاح مطابق للمعلمة
اسم المتغير في مركز التحكم. يمكنك فحص أسماء المتغيرات كما يلي:
- انقر فوق الاختبارات على الشريط الجانبي وحدد تسلسل اختبار جديد.
- انقر فوق القوالب الخاصة بي.
- انقر فوق الرابط تحرير الموجود أسفل القالب محل الاهتمام.
- انقر فوق زر تحرير الإدخال في الزاوية اليمنى العليا.
في علاقتنا السابقةample، وبشكل افتراضي، تكون أسماء المتغيرات مجرد إصدارات صغيرة من أسماء العرض التي تظهر في مركز التحكم ("url" ضد. "URL"، إلخ.). ومع ذلك، في واجهة المستخدم الرسومية لمركز التحكم، يمكنك إعادة تسمية المتغيرات إلى ما تريد.
إلى جانب المفتاح، يجب أن يتم تحديد نوع كل معلمة: على سبيل المثالampلو, ل URL.
يرجى ملاحظة أنك بحاجة إلى إعادةview نموذج YANG الكامل للحصول على معلومات كاملة عن الأنواع. بالنسبة لواجهات وكيل الاختبار، يكون للنوع بنية أكثر تعقيدًا، كما هو موضح أدناه في الكود أدناه.
يمكننا الآن تشغيل البرنامج النصي باستخدام ncclient. بافتراض أن كل شيء صحيح، سيتم بدء الاختبار وعرض تنفيذه في مركز التحكم:
إذا تم بدء الاختبار بنجاح، فسوف يستجيب مركز التحكم بمعرف الاختبار. في هذا السابقampلو، معرف الاختبار هو 3:
يمكن أيضًا العثور على معرف الاختبار في URL للاختبار في واجهة المستخدم الرسومية لمركز التحكم. في هذا السابقampلو ذلك URL هو https://host/demo/testing/3/.
استرجاع نتائج الاختبار
الطريقة الأكثر مباشرة لاسترداد نتائج الاختبار هي الإشارة إلى معرف الاختبار.
يوجد أدناه رمز Python للحصول على النتائج من اختبار HTTP أعلاه بالمعرف = 3:
مع المدير. Connect(host=args.host, port=args.port, username=args.username,password=args.password, hostkey_verify=False) كـ m:
سيبدو الإخراج كما يلي:
تصدير واستيراد قوالب الاختبار
يمكن تصدير قوالب الاختبار بتنسيق JSON وإعادة استيرادها بهذا التنسيق إلى مركز التحكم. يعد هذا مفيدًا إذا كنت تريد استخدام قوالب الاختبار في تثبيت مختلف لمركز التحكم. (من الأفضل التعامل مع الإنشاء الأولي للقوالب من خلال واجهة المستخدم الرسومية لمركز التحكم.)
يوجد أدناه رمز لتنفيذ التصدير والاستيراد.
تصدير قوالب الاختبار
# احصل على تكوين json من الاستجابة
الجذر = ET.fromstring(response._raw)
json_config = root[0].text
طباعة json_config
القالب موجود في كائن json_config.
استيراد قوالب الاختبار
يمكن إعادة استيراد كائن تكوين JSON الذي يحتوي على قوالب الاختبار إلى مركز التحكم على النحو التالي.
Exampليه: الشاشات
يفترض هذا القسم أنه تم إنشاء وكلاء الاختبار (بقدر ما تطلبه أجهزة المراقبة) وفقًا للقسم "إنشاء وكيل اختبار جديد ونشره" في الصفحة 17.
مسارات نموذج YANG للشاشات
| غرض | مسار نموذج YANG: /الحسابات/الحساب/الشاشات... |
| شاشات | /. |
| مراقب [الاسم] | /شاشة |
| اسم | /مراقبة/اسم |
| وصف | /مراقبة/وصف |
| بدأت | / مراقبة / بدأت |
| نموذج | /مراقبة/قالب |
| تكوينات التنبيه | /monitor/alarm-configs |
| غرض | مسار نموذج YANG: /accounts/account/monitors/monitor/alarm-configs... |
| إنذار التكوين [المعرف] | / إنذار التكوين |
| معرف | /alarm-config/identifier |
| نموذج | /alarm-config/template |
| بريد إلكتروني | /alarm-config/email |
| بروتوكول سنمب | /alarm-config/snmp |
| th-es-حرجة | /alarm-config/thr-es-critical |
| th-es-حرجة-واضحة | /alarm-config/thr-es-critical-clear |
| th-es-major | /alarm-config/thr-es-major |
| thr-es-major-clear | /alarm-config/thr-es-major-clear |
| th-es-minor | /alarm-config/thr-es-minor |
| th-es-minor-واضح | /alarm-config/thr-es-minor-clear |
| تحذير th-es | /alarm-config/thr-es-warning |
| th-es-warning-clear | /alarm-config/thr-es-warning-clear |
| عدم خطورة البيانات | /alarm-config/no-data-severity |
| لا مهلة البيانات | /alarm-config/no-data-timeout |
| فعل | /alarm-config/action |
| بحجم النافذه | /alarm-config/window-size |
| فاصلة | /alarm-config/interval |
| إرسال مرة واحدة فقط | /alarm-config/send-only-once |
| snmp-فخ لكل تيار | /alarm-config/snmp-trap-per-stream |
| غرض | مسار نموذج YANG: /الحسابات/الحساب/الشاشات... |
| حدود | /مراقبة/معلمات |
| غرض | مسار نموذج YANG: /accounts/account/monitors/monitor/parameters... |
| المعلمة [مفتاح] | /معامل |
| مفتاح | / المعلمة / المفتاح |
| (نوع القيمة) | /معامل |
| :(عدد صحيح) | /معامل |
| عدد صحيح | / المعلمة / عدد صحيح |
| :(يطفو) | /معامل |
| يطفو | / المعلمة / تعويم |
| :(خيط) | /معامل |
| غرض | مسار نموذج YANG: /accounts/account/monitors/monitor/parameters... |
| خيط | / المعلمة / سلسلة |
| :(واجهات وكيل الاختبار) | /معامل |
| واجهات وكيل الاختبار | /parameter/test-agent-interfaces |
| واجهة وكيل الاختبار ["1" في الصفحة 58 | /المعلمة/واجهات وكيل الاختبار/ |
| حساب | /parameter/test-agent-interfaces/test-agent-interface/account |
| وكيل اختبار | /parameter/test-agent-interfaces/test-agent-interface/test-agent |
| واجهة | /parameter/test-agent-interfaces/test-agent-interface/interface |
| نسخة الملكية الفكرية | /parameter/test-agent-interfaces/test-agent-interface/ip-version |
| :(توamp-عاكسات) | /معامل |
| twamp-عاكسات | /المعلمة/twamp-عاكسات |
| twamp-عاكس [الاسم] | /المعلمة/twamp-عاكسات/توamp-العاكس |
| اسم | /المعلمة/twamp-عاكسات/توamp-عاكس/اسم |
| :(y1731-ميبس) | /معامل |
| y1731-ميبس | /parameter/y1731-meps |
| y1731-mep[الاسم] | /parameter/y1731-meps/y1731-mep |
| اسم | /parameter/y1731-meps/y1731-mep/name |
| :(حسابات رشفة) | /معامل |
| حسابات رشفة | /parameter/sip-accounts |
| حساب sip["2" في الصفحة 58] | /parameter/sip-accounts/sip-account |
| حساب | /parameter/sip-accounts/sip-account/account |
| وكيل اختبار | /parameter/sip-accounts/sip-account/test-agent |
| واجهة | /parameter/sip-accounts/sip-account/interface |
| عنوان رشفة | /parameter/sip-accounts/sip-account/sip-address |
| :(قنوات-iptv) | /معامل |
| قنوات البث التلفزيوني عبر الانترنت | /parameter/iptv-channels |
| قناة البث التلفزيوني عبر الانترنت[الاسم] | /parameter/iptv-channels/iptv-channel |
| اسم | /parameter/iptv-channels/iptv-channel/name |
- واجهة وكيل اختبار الحساب
- واجهة وكيل اختبار الحساب sip-address
| غرض | مسار نموذج YANG: /الحسابات/الحساب/الشاشات... |
| حالة | /مراقبة/الحالة |
| آخر 15 دقيقة | /مراقبة/الحالة/آخر 15 دقيقة |
| حالة | /monitor/status/last-15-Minutes/status |
| قيمة الحالة | /monitor/status/last-15-Minutes/status-value |
| الساعة الأخيرة | /مراقبة/الحالة/الساعة الماضية |
| حالة | /monitor/status/last-hour/status |
| قيمة الحالة | /monitor/status/last-hour/status-value |
| أخر 24 ساعه | /مراقبة/الحالة/آخر 24 ساعة |
| حالة | /monitor/status/last-24-hours/status |
| قيمة الحالة | /monitor/status/last-24-hours/status-value |
| قوالب | / قوالب |
| اسم القالب] | /قوالب/قالب |
| اسم | /قوالب/قالب/اسم |
| وصف | /قوالب/قالب/وصف |
| حدود | /قوالب/قالب/معلمات |
| المعلمة [مفتاح] | /قوالب/قالب/معلمات/معلمة |
| مفتاح | /قوالب/قالب/معلمات/معلمة/مفتاح |
| يكتب | /قوالب/قالب/معلمات/معلمة/نوع |
المتطلبات الأساسية لتنسيق المراقبة
قبل أن تتمكن من بدء تشغيل شاشة من خلال NETCONF باستخدام ncclient، تحتاج إلى إنشاء قالب شاشة في واجهة المستخدم الرسومية لمركز التحكم كما هو موضح في التعليمات داخل التطبيق ضمن "الاختبارات وأجهزة العرض" > "إنشاء القوالب". ستكون جميع الحقول المحددة كـ "إدخال القالب" في هذا القالب مطلوبة كمعلمات في XML عند تنسيق بدء القالب.
الحصول على معلمات الإدخال من قوالب المراقبة
أدناه، يتم عرض نموذجين. الأول مخصص لمراقبة UDP بين واجهتين لعامل الاختبار، والثاني مخصص لـ HTTP باستخدام واجهة وكيل اختبار واحدة.
لمعرفة معلمات الإدخال الخاصة بالقالب، انقر فوق المربع الذي يمثل القالب. بالنسبة لقالب HTTP، قد تبدو المعلمات كما يلي:
نحتاج إلى تحديد هذه المعلمات في الخطوة التالية عند بدء تشغيل الشاشة.
بدء تشغيل جهاز المراقبة
باستخدام وكلاء الاختبار الذين قمنا بتعريفهم ونشرهم في قسم "إنشاء ونشر وكيل اختبار جديد" في الصفحة 17، يمكننا بدء مراقبة من القالب "HTTP" كما هو موضح أدناه.
لكل معلمة يجب توفير السمة. المفتاح مطابق لاسم المتغير الخاص بالمعلمة في مركز التحكم. يمكنك فحص أسماء المتغيرات كما يلي:
- انقر فوق المراقبة على الشريط الجانبي وحدد شاشة جديدة.
- انقر فوق القوالب الخاصة بي.
- انقر فوق الرابط تحرير الموجود أسفل القالب محل الاهتمام.
- انقر فوق زر تحرير الإدخال في الزاوية اليمنى العليا.
في علاقتنا السابقةample، وبشكل افتراضي، تكون أسماء المتغيرات مجرد إصدارات صغيرة من أسماء العرض التي تظهر في مركز التحكم ("url" ضد. "URL"، إلخ.). ومع ذلك، في واجهة المستخدم الرسومية لمركز التحكم، يمكنك إعادة تسمية المتغيرات إلى ما تريد.
إلى جانب المفتاح، يجب أن يتم تحديد نوع كل معلمة: على سبيل المثالampلو, ل URL. يرجى ملاحظة أن المعلومات الكاملة عن نوع المعلمة موجودة في نموذج YANG. بالنسبة لواجهات وكيل الاختبار، يحتوي النوع على بنية أكثر تعقيدًا، كما هو موضح في الكود أدناه.
في السابقampما يلي، لا يوجد إنذار مرتبط بالشاشة. على سبيل المثالampللملفات التي تتضمن إنذارات، انتقل إلى القسم "بدء تشغيل شاشة باستخدام إنذار" في الصفحة 62.
بدء تشغيل الشاشة باستخدام إنذار
لربط إنذار بجهاز عرض، يمكنك إما الإشارة إلى قالب إنذار تم تعريفه، أو يمكنك توفير تكوين الإنذار بالكامل عند إنشاء الشاشة. سنقدم واحدا السابقينampلو من كل نهج أدناه.
إعداد إنذار الشاشة عن طريق الإشارة إلى قالب الإنذار
لكي تتمكن من الاستفادة من قالب التنبيه، يجب أن تعرف معرفه. ولتحقيق هذه الغاية، قم أولاً باسترداد جميع قوالب الإنذارات الخاصة بك كما هو موضح في القسم "استرداد كافة قوالب الإنذار" في الصفحة 39 ولاحظ اسم القالب ذي الصلة. يمكنك بعد ذلك الرجوع إلى هذا القالب على النحو التالي:
إعداد إنذار الشاشة عن طريق تكوينه بشكل مباشرy
وبدلاً من ذلك، يمكنك إعداد إنذار لشاشة ما عن طريق توفير تكوينها بالكامل عند إنشاء الشاشة، دون الرجوع إلى قالب التنبيه. ويتم ذلك كما هو موضح في المثال التاليampليه.
استرجاع شاشات التشغيل
لاسترداد كافة أجهزة العرض التي يتم تنفيذها حاليًا، قم بتشغيل هذا البرنامج النصي:
مع المدير. Connect(host=args.host, port=args.port, username=args.اسم المستخدم, كلمة المرور=args.password, hostkey_verify=False) كـ m:
الإخراج عبارة عن قائمة بجميع الشاشات قيد التشغيل كما هو موضح أدناه:
استرداد حالة اتفاقية مستوى الخدمة (SLA) للشاشة
فيما يلي كيفية استرداد حالة اتفاقية مستوى الخدمة (SLA) للشاشة. في هذا السابقampإذا، فإننا نقوم باسترداد حالة اتفاقية مستوى الخدمة (SLA) للشاشة "جودة الشبكة" لمدة ثلاث فترات زمنية: آخر 15 دقيقة، وآخر ساعة، وآخر 24 ساعة.
سيبدو الإخراج كما يلي:
إخطارات NETCONF
يتم تشغيل إعلامات NETCONF للشاشات بسبب انتهاكات اتفاقية مستوى الخدمة. تحدث هذه الحالات عندما ينخفض مستوى مستوى الخدمة (SLA) الخاص بالشاشة إلى ما دون حد مستوى مستوى الخدمة (“جيد” أو “مقبول”) خلال فترة زمنية معينة، بشكل افتراضي آخر 15 دقيقة. تجدر الإشارة إلى أن إشعارات انتهاك اتفاقية مستوى الخدمة (SLA) تظهر سريعًا بعد تأثر الخدمة بمشكلة ما، بينما ستعود حالة اتفاقية مستوى الخدمة (SLA) إلى "جيد" فقط بعد 15 دقيقة، وفقط في حالة عدم حدوث انتهاكات أخرى.
يمكن تغيير الإطار الزمني عن طريق تحرير الإعداد SLA_STATUS_WINDOW (القيمة بالثواني) في /etc/netrounds/netrounds.conf.
تصدير واستيراد قوالب المراقبة
يتم ذلك بنفس الطريقة تمامًا كما هو الحال مع قوالب الاختبار؛ قارن القسم "تصدير واستيراد قوالب الاختبار" في الصفحة 52. توضح مقتطفات التعليمات البرمجية أدناه كيفية تصدير واستيراد القوالب للشاشات.
تصدير قوالب المراقبة
استيراد قوالب المراقبة
Tags يمكن تطبيق المحدد في Paragon Active Assurance على:
- شاشات
- قوالب المراقبة
- وكلاء الاختبار
- TWAMP عاكسات
- المضيفين بينغ.
على سبيل المثالampنعم، يمكنك tag جهاز مع نفسه tag كمجموعة فرعية من وكلاء الاختبار الذين سيقومون بتشغيل الشاشة. تعتبر هذه الميزة مفيدة بشكل خاص إذا كان لديك عدد كبير من الشاشات والقوالب المحددة.
إذا قمت بإعداد إنذار باستخدام مصائد SNMP لشاشة ما، فسيتم تعيين مصائد SNMP بنفس الطريقة tags كما الشاشة، إن وجدت.
إنشاء Tags
أدناه نعرض كيفية إنشاء tag بالاسم واللون كما هو محدد بواسطة XMLtag> البنية التحتية.
تعيين Tag
لتعيين أ tag إلى أحد الموارد، يمكنك إضافته كمورد جديدtag> عنصر تحتtags> عنصر لهذا المورد.
إليك كيفية تعيين أ tag إلى وكيل الاختبار:
لتعيين أ tag إلى TWAMP العاكس، قم بما يلي:
تعيين tag يتم التعامل مع الشاشة بالمثل:
وبدلاً من ذلك، يمكنك تعيين موجود tag إلى أي من أنواع الموارد هذه عند إنشاء المورد، عن طريق تضمينtags> العنصر الذي يحتوي على tag في السؤال.
تحديث Tag
تحديث موجود tag مع السمات الجديدة يشبه إنشاء ملف tag:
إلغاء تعيين Tag
لإلغاء تعيين أ tag من أحد الموارد، قم بإضافة السمة nc:operation=”delete” إلى الملفtag> العنصر الذي ينتمي إلى المورد. أدناه، نقوم بإلغاء تعيين أ tag من الشاشة.
حذف Tag
من أجل حذف tag تمامًا من مركز التحكم، يتم استخدام السمة nc:operation=”delete” مرة أخرى، ولكن هذه المرة يتم تطبيقها على tag نفسها، المعرفة تحت .
استكشاف الأخطاء وإصلاحها
المشكلة: Orchestrator وParagon Active Assurance خارج المزامنة
يمكن أن ينتهي الأمر بالمنسق وParagon Active Assurance غير متزامنين على سبيل المثالampإذا تم إجراء تغييرات التكوين في واجهة المستخدم الرسومية لمركز التحكم، أو إذا لم يكن تطبيق التكوين ناجحًا وفشلت العودة إلى الحالة السابقة.
في حالة فشل الاستعادة، لن يقبل خادم NETCONF تغييرات التكوين بعد الآن؛ سيتم الرد برسالة خطأ تفيد بأن التكوين مقفل حتى تتم المزامنة مرة أخرى. لاستعادة المزامنة وإلغاء قفل تغييرات التكوين، تحتاج إلى تشغيل الأمر rpc sync-from-ncc الذي يقوم بمزامنة كل التكوينات من مركز التحكم إلى قاعدة بيانات التكوين.
ملحوظة: ال confd@netrounds.com يجب أن يتمتع المستخدم (أو أي شيء تم تكوينه) بامتيازات المستخدم المتميز حتى تتم مزامنة كل شيء بنجاح. يمكن تحقيق ذلك باستخدام الأمر ncc user-update confd@netrounds.com –is-superuser إذا لم يكن المستخدم مستخدمًا متميزًا، فسيظهر تحذير يفيد بأنه لا يمكن مزامنة كل شيء، ولكن تمت مزامنة كل ما يمكن التعامل معه.
ملحوظة: إذا قام المنسق الخاص بك أيضًا بتخزين التكوين، فستحتاج إلى إعادة مزامنة ذلك أيضًا نظرًا لأن التكوين المطلوب (التكوين الذي يتوقع المنسق وجوده في مركز التحكم) لن يتم تطبيقه.
المشكلة: فشلت المزامنة الأولية (المزامنة من ncc) بسبب عدم دعم الموارد
إذا حاولت تشغيل rpc sync-from-ncc على حساب تم تكوينه في واجهة المستخدم الرسومية لمركز التحكم، فقد تواجه مشكلات إذا كان الحساب يحتوي على موارد غير مدعومة. من المستحسن أن تبدأ بحساب فارغ وأن تقوم بكل تكويناته من خلال NETCONF. بخلاف ذلك، إذا واجهت مشكلات تتعلق بتعارضات الموارد، فسيتعين عليك إزالة الموارد المتعارضة من الحساب.
المشكلة: فشل أوامر NETCONF مع ncclient.operations.rpc.RPCEخطأ: فشل اتصال التطبيق
لا يقوم خادم NETCONF باستعادة الاتصال بخادم مركز التحكم تلقائيًا في حالة إعادة تشغيل مركز التحكم. لاستعادة الاتصال بمركز التحكم، أعد تشغيل عملية NETCONF: sudo systemctl Restart netrounds-confd
ملاحظات حول تطبيقات وكيل الاختبار وأجهزة وكيل الاختبار
تطبيقات وكيل الاختبار في ConfD
من بين وكلاء الاختبار، يعمل تطبيق وكيل الاختبار (الأحدث) بشكل مختلف قليلاً عن جهاز وكيل الاختبار (الأقدم).
لا تدعم تطبيقات وكيل الاختبار حاليًا تكوين الواجهة. ولذلك، يسمح مخطط YANG بتحديد تكوين واجهة فارغ لوكلاء الاختبار هؤلاء. انظر "هذا المقطع" في الصفحة 23 للحصول على مثال سابقampليه.
عند مزامنة قاعدة بيانات ConfD مع مركز التحكم باستخدام الأمر sync-from-ncc، فإنك تريد أن يظل تكوين الواجهة فارغًا ولا يتم استبداله بما هو موجود في مركز التحكم. لذلك تحتاج إلى استخدام علامة خاصة –without_interface_config مع هذا الأمر عند العمل مع تطبيقات وكيل الاختبار.
تكوين الواجهة الفارغة لجهاز وكيل الاختبار
كما هو مذكور أعلاه، لا يدعم تطبيق وكيل الاختبار تكوين الواجهة، وبالتالي من الممكن حذف الواجهات في مخطط YANG.
ولكن هناك أيضًا حالات استخدام قد ترغب فيها في حذف تكوين الواجهة من جهاز وكيل الاختبار. سابقampيمكن أن يكون هذا سيناريو تزامن حيث تقوم بتدوير وكيل اختبار باستخدام cloud-init، وتريد استخدام تكوين الواجهة من هناك، بدلاً من السماح لـ ConfD بالكتابة فوقه عندما يأتي وكيل الاختبار عبر الإنترنت.
تغييرات مخطط YANG فيما يتعلق بالواجهات غير المحددة
نظرًا لأنه أصبح مسموحًا الآن بتكوين واجهة فارغة (من الإصدار 2.34.0 فصاعدًا)، فمن الممكن تحديد أي اسم واجهة كمدخل لمهمة تعمل كجزء من اختبار أو شاشة.
يعد هذا مطلوبًا لتتمكن من استخدام تطبيق وكيل الاختبار، حيث لم يتم تحديد أسماء الواجهة في ConfD. ومع ذلك، لاحظ أن هذا يعني أيضًا أنه من الممكن أن تواجه مشكلات إذا قمت عن طريق الخطأ بتكوين اختبار أو جهاز مراقبة لاستخدام واجهة غير موجودة. لذا يرجى أن تضع في اعتبارها هذا.
القيود عند تسجيل وكيل اختبار تم إنشاؤه في ConfD
عند إنشاء وكيل اختبار عبر REST أو NETCONF/YANG API، لا يمكننا معرفة نوعه مسبقًا: جهاز وكيل الاختبار أو تطبيق وكيل الاختبار. يصبح هذا واضحًا فقط بعد تسجيل وكيل الاختبار.
بمجرد تسجيل وكيل الاختبار وتحوله إلى أحد هذه الأنواع الملموسة، لا يُسمح لك بإعادة تسجيله كنوع مختلف من وكيل الاختبار. وهذا يعني أنه لا يُسمح لك بتسجيله أولاً كجهاز وكيل اختبار، ثم إعادة تسجيله كتطبيق وكيل اختبار، أو العكس. إذا كنت بحاجة إلى وكيل اختبار من نوع مختلف، فستحتاج إلى إنشاء وكيل اختبار جديد.
الملحق: الهيكل الشجري لنموذج YANG الكامل
في هذا الملحق، يشرح قسم "وسيلة الإيضاح" في الصفحة 81 بناء جملة بنية شجرة نموذج YANG التي تم إنشاؤها باستخدام الأمر pyang -f Tree.
يوفر قسم "YANG Model Tree Structure" الموجود في الصفحة 82 مخرجات هذا الأمر المطبق على netrounds-ncc.yang. يتم نسخ أجزاء من هذا الإخراج في مكان آخر من المستند.
أسطورة
هيكل شجرة يانغ النموذجي
Juniper Networks وشعار Juniper Networks وJuniper وJunos هي علامات تجارية مسجلة لشركة Juniper Networks, Inc. في الولايات المتحدة ودول أخرى. جميع العلامات التجارية الأخرى وعلامات الخدمة والعلامات المسجلة أو علامات الخدمة المسجلة هي ملك لأصحابها. لا تتحمل Juniper Networks أي مسؤولية عن أي أخطاء في هذه الوثيقة. تحتفظ Juniper Networks بالحق في تغيير أو تعديل أو نقل أو مراجعة هذا المنشور بأي شكل آخر دون إشعار. حقوق الطبع والنشر © 2023 Juniper Networks, Inc. جميع الحقوق محفوظة.
المستندات / الموارد
 |
برنامج Juniper NETWORKS NETCONF وYANG API [بي دي اف] دليل المستخدم برنامج NETCONF YANG API، برنامج YANG API، برنامج API، برنامج |