جونیپر نیٹ ورکس نیٹ کانف اور یانگ API سافٹ ویئر صارف گائیڈ

اس دستاویز کا مقصد
یہ دستاویز بیان کرتی ہے کہ Paragon Active Assurance کو کنٹرول سینٹر NETCONF اور YANG API کے ذریعے نیٹ ورک سروس آرکیسٹریٹر کے ساتھ کیسے مربوط کیا جائے۔ ہینڈ آن سابقamples اس میں شامل اہم کاموں میں سے ہیں، بشمول: ورچوئل ٹیسٹ ایجنٹ بنانا اور ان کی تعیناتی، ٹیسٹ اور مانیٹر چلانا، اور ان سرگرمیوں سے نتائج حاصل کرنا۔
اس دستاویز میں، آزادانہ طور پر دستیاب Python NETCONF کلائنٹ ncclient کو آرکیسٹریٹر کے کردار میں استعمال کیا گیا ہے۔

کنونشنز
اس دستاویز میں درج ذیل مخففات استعمال کیے گئے ہیں۔

مخفف	مطلب
سی ایل آئی	کمانڈ لائن انٹرفیس
EM	عنصر مینیجر
ES	دوسری غلطی
ایم ای پی	MEG (مینٹیننس اینٹیٹی گروپ) اینڈ پوائنٹ (ITU-T Y.1731 تعریف) یا مینٹیننس اینڈ پوائنٹ (سسکو تعریف)
این ایف وی	نیٹ ورک فنکشن ورچوئلائزیشن
این ایف وی او	نیٹ ورک فنکشن ورچوئلائزیشن آرکیسٹریٹر
این ایس ڈی	نیٹ ورک سروس ڈسکرپٹر
آر پی سی	ریموٹ پروسیجر کال
ایس آئی پی	سیشن انیشیشن پروٹوکول
ایس ایل اے	سروس لیول کا معاہدہ
S-VNFM	خصوصی VNF مینیجر
وی این ایف	ورچوئل نیٹ ورک فنکشن
وی ٹی اے	ورچوئل ٹیسٹ ایجنٹ

پسماندہ مطابقت پر نوٹس

NETCONF اور YANG API کے ورژن 2.35.4/2.36.0 میں، کچھ درخواستوں کی توثیق کو NETCONF معیار پر عمل کرنے کے لیے زیادہ سخت بنایا گیا تھا۔ اس کا مطلب ہے کہ اس گائیڈ کے پرانے ورژنز پر مبنی کلائنٹ کوڈ کو اب مسترد کیا جا سکتا ہے۔
سابق کے لیےample، پچھلے ازگر سابق میںample کوڈ، کوئی نام کی جگہ کا وصف فراہم نہیں کیا گیا تھا۔ جب بھی آپ کسی ConfD وسائل میں ترمیم کرنا چاہتے ہیں تو اب نام کی جگہ کو درخواست XML میں فراہم کرنے کی ضرورت ہے۔

پیشگی شرائط اور تیاری

ConfD انسٹالیشن
ConfD (ٹیل-f سے ایک پروڈکٹ) پیراگون ایکٹیو ایشورنس سسٹم اور NETCONF کے درمیان ایک ثالث کے طور پر استعمال ہوتا ہے۔ ConfD Paragon Active Assurance کنفیگریشن اور آپریشنل ڈیٹا کو NETCONF اور YANG API سے جوڑتا ہے۔
ConfD کو کنٹرول سینٹر سافٹ ویئر کے ساتھ انسٹال کیا جانا چاہیے تھا، جیسا کہ انسٹالیشن گائیڈ میں بیان کیا گیا ہے۔

تصدیق کرنا کہ ConfD چل رہا ہے۔
اس بات کی تصدیق کرنے کے لیے کہ ConfD چل رہا ہے، کمانڈ چلائیں۔
ssh -s @localhost -p 830 netconf
یہ چیک کرنے کے لیے کہ ConfD پورٹ 830 پر جواب دیتا ہے۔ کمانڈ میں، جیسا کہ netconf صارف تخلیق کے ذریعہ بیان کیا گیا ہے۔
انسٹالیشن گائیڈ میں کمانڈ، سیکشن انسٹال کرنا ConfD۔ اسی کمانڈ کے ذریعے بیان کردہ پاس ورڈ دیں۔
آؤٹ پٹ میں، تصدیق کریں کہ کنٹرول سینٹر ماڈیول شامل ہے۔ آؤٹ پٹ میں درج ذیل لائن پر مشتمل ہونا چاہئے:
http://ncc.netrounds.com?module=netrounds-ncc&ampنظر ثانی=2017-06-15

کنفیگریشن ڈیٹا بیس کو کنٹرول سینٹر کے ساتھ ہم آہنگ کرنا

آخر میں، ہمیں NETCONF کے ذریعے کنفیگریشن ڈیٹا بیس کو اپ ڈیٹ کرنے کی ضرورت ہے۔ ہم یہاں ncclient (NETCONF کلائنٹ) نامی ایک Python لائبریری کے ذریعے ایسا کریں گے۔ تاہم، یہ کام ایک مختلف پروگرامنگ زبان میں بھی مکمل کیا جا سکتا ہے جب تک کہ یہ NETCONF/YANG پروٹوکول استعمال کرتا ہے۔
ncclient کا کردار ConfD سرور کی طرف ایک کلائنٹ کے طور پر کام کرنا ہے جو NETCONF/YANG API کی میزبانی کرتا ہے۔

یہ بتانے کے قابل ہے کہ ncclient کسی بھی طرح سے کنٹرول سینٹر (پہلے "Netrounds Control Center") سے متعلق نہیں ہے، حالانکہ نام "ncc" سے شروع ہوتا ہے۔
ncclient کو انسٹال کرنے کا طریقہ یہاں ہے:

سے سافٹ ویئر ڈاؤن لوڈ کریں۔ https://github.com/ncclient/ncclient.
اس کمانڈ کو چلائیں: pip install ncclient

ہم اب ہم آہنگی کو حسب ذیل انجام دے سکتے ہیں۔ احتیاط سے نوٹ کریں کہ یہ ایک علیحدہ کمپیوٹر پر کرنے کی ضرورت ہے، نہ کہ خود کنٹرول سینٹر سرور پر:

#
# نوٹ:
# یہ اسکرپٹ NCC سرور پر چلنے والے ConfD کی طرف ایک کلائنٹ کے طور پر کام کرتا ہے۔
# یہ مواصلات کے لیے NETCONF/YANG API استعمال کرے گا۔

نوٹ: جب بھی ٹیسٹ ایجنٹوں کو NETCONF سے آزادانہ طور پر انسٹال اور رجسٹر کیا گیا ہو تو یہ طریقہ کار بھی ضروری ہے۔ سیکشن میں نوٹ دیکھیں "اوورview مزید معلومات کے لیے صفحہ 17 پر ٹیسٹ ایجنٹ آرکیسٹریشن کا۔

متعدد NETCONF کے زیر کنٹرول پیراگون ایکٹیو ایشورنس اکاؤنٹس ترتیب دینا

نیچے دیئے گئے اقدامات کی ضرورت صرف اس صورت میں ہے جب آپ مزید Paragon Active Assurance اکاؤنٹس کو NETCONF کے ذریعے کنٹرول کرنے کے لیے سیٹ اپ کرنا چاہتے ہیں، اس کے علاوہ انسٹالیشن گائیڈ، سیکشن "Installing ConfD" میں اس طریقے سے تشکیل کردہ اکاؤنٹ کے علاوہ۔
اس طرح کے ہر اکاؤنٹ کے لیے، درج ذیل کے طور پر آگے بڑھیں:

کنٹرول سینٹر میں، اکاؤنٹ میں لاگ ان کریں اور اکاؤنٹ > اجازتوں پر جائیں۔

صارف کو شامل کریں "confd@netrounds.com"، اور اس ConfD صارف کو GUI میں انوائٹ بٹن پر کلک کر کے ایڈمن کی اجازت دیں۔
کنفیگریشن ڈیٹا بیس کو کنٹرول سینٹر کے ساتھ ہم آہنگ کریں جیسا کہ صفحہ 4 پر سیکشن "کنفیگریشن ڈیٹا بیس کو کنٹرول سینٹر کے ساتھ ہم آہنگ کرنا" میں بیان کیا گیا ہے۔
اب آپ کو ایک ہی ConfD صارف کے ساتھ متعدد Paragon Active Assurance اکاؤنٹس کو کنٹرول کرنے کے قابل ہونا چاہیے۔

نوٹ: ایک بار جب آپ ConfD کے ذریعے Paragon Active Assurance اکاؤنٹ کو کنٹرول کرنا شروع کر دیں، تو آپ کو اس اکاؤنٹ میں تبدیلیاں نہیں کرنی چاہئیں۔ web پیراگون ایکٹیو ایشورنس کی کسی بھی خصوصیت کے حوالے سے GUI جو "تنگ" ہیں (صفحہ 9 پر باب "پیراگون ایکٹیو ایشورنس میں معاون خصوصیات" دیکھیں)۔ اگر آپ ایسا کرتے ہیں، تو مطابقت پذیری کا نقصان ہو گا۔

NETCONF آرکیسٹریشن API کا تعارف

ختمview

فریق ثالث NFVO یا سروس آرکیسٹریٹر عام طور پر وہ جزو ہوتا ہے جو کنٹرول سینٹر API کا استعمال کرتے ہوئے ٹیسٹ اور مانیٹرنگ سیشن شروع کرتا ہے۔ یہ آرکیسٹریٹر ٹیسٹ ایجنٹ کی سرگرمیوں سے مجموعی پیمائش کے نتائج کو بھی بازیافت کرتا ہے۔ پرفارمنس KPIs کو تھرڈ پارٹی پرفارمنس مینجمنٹ سسٹمز کے ذریعے بازیافت کیا جا سکتا ہے، جبکہ ایونٹس – ایک بار کنٹرول سینٹر میں مقرر کردہ حد کی خلاف ورزیوں سے شروع ہونے والے – کو تھرڈ پارٹی فالٹ مینجمنٹ سسٹمز کو بھیجا جا سکتا ہے۔
خلاصہ کرنے کے لیے، نیچے دی گئی تصویر دکھاتی ہے کہ پیراگون ایکٹیو ایشورنس OSS لینڈ اسکیپ میں دوسرے فریق ثالث کے نظاموں کے ساتھ کس طرح تعامل کرتا ہے۔

NFVO/سروس آرکیسٹریٹر: VNF مینیجر کو vTAs کو تعینات کرنے اور سروس چین میں پیراگون ایکٹیو ایشورنس کو ترتیب دینے کی ہدایت کرتا ہے۔ سروس ایکٹیویٹ ہونے کے بعد، آرکیسٹریٹر سروس ایکٹیویشن ٹیسٹ کو متحرک کرنے اور پاس/فیل نتائج کی بازیافت کے لیے کنٹرول سینٹر کی طرف API کا استعمال کرتا ہے۔ اگر ٹیسٹ پاس ہو جاتے ہیں، تو آرکیسٹریٹر سروس کی فعال نگرانی شروع کرنے کے لیے کنٹرول سینٹر کی طرف API کا استعمال کرے گا۔ نگرانی سے KPIs کو یا تو آرکیسٹریٹر کے ذریعہ یا ایک علیحدہ پرفارمنس مینجمنٹ پلیٹ فارم کے ذریعہ مسلسل بازیافت کیا جاتا ہے۔
کنٹرول سینٹر: NFVO یا سروس آرکیسٹریٹر کی ہدایت کے مطابق وی ٹی اے کو تعینات، ترازو، اور ختم کرتا ہے۔

پرفارمنس مینجمنٹ سسٹم یا سروس کوالٹی مینجمنٹ سسٹم: کنٹرول سینٹر API کے ذریعے فعال نگرانی سے KPIs کو پڑھتا ہے۔
فالٹ مینجمنٹ سسٹم: اگر SLAs کی خلاف ورزی ہوتی ہے تو NETCONF، SNMP، یا کنٹرول سینٹر سے ای میل اطلاعات موصول ہوتی ہے۔

پیراگون ایکٹیو ایشورنس میں تصورات کی تعریف

ٹیسٹ ایجنٹ: وہ اجزاء جو پیراگون ایکٹیو ایشورنس سسٹم میں پیمائش کرتے ہیں (ٹیسٹ کے ساتھ ساتھ مانیٹر کے لیے)۔ ٹیسٹ ایجنٹس سافٹ ویئر پر مشتمل ہوتے ہیں جن میں حقیقی نیٹ ورک ٹریفک پیدا کرنے، وصول کرنے اور تجزیہ کرنے کی صلاحیت ہوتی ہے۔
اس دستاویز میں جس قسم کے ٹیسٹ ایجنٹ پر بات کی گئی ہے وہ ورچوئل ٹیسٹ ایجنٹ (vTA) ہے، ایک ورچوئل نیٹ ورک فنکشن (VNF) جو ہائپر وائزر پر تعینات ہے۔ ٹیسٹ ایجنٹ کی دیگر اقسام بھی موجود ہیں۔

پیراگون ایکٹیو ایشورنس میں پیمائش کی دو بنیادی اقسام ہیں، ٹیسٹ اور مانیٹر۔
ٹیسٹ: ایک ٹیسٹ ایک یا کئی مراحل پر مشتمل ہوتا ہے، جن میں سے ہر ایک کا ایک مخصوص، محدود دورانیہ ہوتا ہے۔ مراحل کو ترتیب وار عمل میں لایا جاتا ہے۔ ہر قدم میں متعدد کاموں کو بیک وقت چلانے کی ضرورت پڑ سکتی ہے۔

مانیٹر: مانیٹر کی کوئی مخصوص مدت نہیں ہوتی لیکن غیر معینہ مدت تک اس پر عمل درآمد ہوتا ہے۔ ٹیسٹ کے ایک قدم کی طرح، ایک مانیٹر متعدد ہم آہنگی کاموں کو انجام دے سکتا ہے۔
ٹیمپلیٹ: جب پیراگون ایکٹیو ایشورنس کو آرکیسٹریٹر کے ذریعے کنٹرول کیا جاتا ہے، تو ٹیسٹ اور مانیٹر ہمیشہ ٹیمپلیٹس کے ذریعے کیے جاتے ہیں جن میں ٹیسٹ یا مانیٹر کی تعریف کی جاتی ہے۔ پیرامیٹر کی ترتیبات کو رن ٹائم کے وقت ٹیمپلیٹ میں ان پٹ کے طور پر منتقل کیا جا سکتا ہے۔

آٹومیشن کے لیے ورک فلو
ڈیزائن کا وقت

ڈیزائن کے وقت، آپ پیراگون ایکٹو ایشورنس میں ٹیسٹ اور مانیٹر کے لیے ٹیمپلیٹس بنا کر پیمائش تیار کرتے ہیں۔ اسے کیسے کرنا ہے اس کا احاطہ صفحہ 15 پر باب "ٹیسٹ اور مانیٹر ٹیمپلیٹس" میں کیا گیا ہے۔

رن ٹائم
رن ٹائم پر، آپ اپنے آلات ترتیب دیتے ہیں اور اصل پیمائش کرتے ہیں۔

ایک اوورview تمام سابقamples دیئے گئے باب میں پایا جاتا ہے "سابقamples of Controlling Paragon Active Assurance via NETCONF & YANG API” صفحہ 15 پر۔
ٹیسٹ ایجنٹوں کو تعینات اور ترتیب دینے کا طریقہ باب "Examples: ٹیسٹ ایجنٹس" صفحہ 16 پر۔

انوینٹری آئٹمز کو کیسے درآمد کیا جائے جیسے TWAMP ریفلیکٹرز اور آئی پی ٹی وی چینلز باب "سابقہ" میں گزرے ہیں۔amples: انوینٹری آئٹمز" صفحہ 29 پر۔
الارم کو ترتیب دینے کا طریقہ باب "سابقہ" میں بیان کیا گیا ہے۔amples: الارم" صفحہ 35 پر۔

NETCONF کے ذریعے پیراگون ایکٹیو ایشورنس ٹیمپلیٹس کو عمل میں لا کر ٹیسٹ اور مانیٹر کیسے چلائے جائیں ابواب میں بیان کیا گیا ہے۔amples: ٹیسٹ" صفحہ 43 پر اور "سابقamples: Monitors" صفحہ 54 پر۔

پیراگون ایکٹیو ایشورنس میں معاون خصوصیات

پیراگون ایکٹیو ایشورنس میں ٹیسٹ اور مانیٹر کی تمام اقسام ٹیمپلیٹس کے استعمال سے بنائی اور ان پر عمل درآمد کیا جا سکتا ہے۔ ایسا کرنے کا طریقہ "ٹیسٹ اور مانیٹر" > "ٹیمپلیٹس بنانا" کے تحت ایپ میں مدد میں شامل ہے۔

Paragon Active Assurance اکاؤنٹس کی تخلیق فی الحال تعاون یافتہ نہیں ہے۔ تاہم، صارف کے لیے ایک یا متعدد پہلے سے طے شدہ اکاؤنٹس قائم کیے جائیں گے۔
نیچے دی گئی جدولوں میں بتایا گیا ہے کہ پیراگون ایکٹیو ایشورنس میں اس ریلیز میں کون سی خصوصیات دستیاب ہیں، اور یہ خصوصیات YANG میں کیسے پیش کی جاتی ہیں۔

یانگ تعمیرات کی وضاحت

سہولت کے لیے، فیچر ٹیبل میں ذکر کردہ YANG تعمیرات کی یہاں تعریفیں دی گئی ہیں۔

کنفیگ (config=true): کنفیگریشن ڈیٹا، ایک سسٹم کو ایک حالت سے دوسری حالت میں تبدیل کرنے کے لیے درکار ہے۔
اسٹیٹ (config=false): اسٹیٹ ڈیٹا: ایک سسٹم پر اضافی ڈیٹا جو کنفیگریشن ڈیٹا نہیں ہے، جیسے کہ صرف پڑھنے کے لیے اسٹیٹس کی معلومات اور اکٹھے کیے گئے اعدادوشمار۔
RPC: ایک ریموٹ پروسیجر کال، جیسا کہ NETCONF پروٹوکول میں استعمال ہوتا ہے۔
اطلاع: NETCONF سرور سے NETCONF کلائنٹ کو ایونٹ کی اطلاعات بھیجی گئیں۔

آرکیسٹریشن کے لیے دستیاب پیراگون ایکٹیو ایشورنس فیچرز کے ٹیبلز
وسیلہ: نگرانی
یانگ پاتھ:/اکاؤنٹس/اکاؤنٹ/مانیٹر

فیچر	ذیلی خصوصیت	یانگ کی تعمیر
مانیٹر بنائیں / ترمیم کریں / حذف کریں۔	مانیٹر ٹیمپلیٹ پر مبنی	ترتیب
مانیٹر شروع / بند کرو	–	ترتیب
مانیٹر ٹیمپلیٹس	ان پٹ کے ساتھ موجودہ مانیٹر ٹیمپلیٹس کی فہرست بنائیں	ریاست
NETCONF اطلاعات	الارم کی حالت بدل گئی۔	اطلاع
نتائج کی نگرانی کریں۔	اعلی سطح کے لیے SLA/ES کاؤنٹر (%) ٹاسک لیول کے لیے SLA/ES کاؤنٹر (%)	ریاست

ٹیسٹوں کے برعکس (ذرائع کا موازنہ کریں: نیچے ٹیسٹ)، مانیٹر کو آر پی سی کے ساتھ شروع نہیں کیا جاتا ہے بلکہ مانیٹر کنفیگریشن کے ذریعے شروع کیا جاتا ہے۔
وسیلہ: ٹیسٹ
یانگ راستہ: /اکاؤنٹس/اکاؤنٹ/ٹیسٹ

فیچر	ذیلی خصوصیت	یانگ کی تعمیر
ٹیسٹ شروع کریں۔	ٹیسٹ ٹیمپلیٹ پر مبنی	آر پی سی
ٹیسٹوں کا انتظام کریں۔	سٹیٹس کے ساتھ ٹیسٹ کی فہرست بنائیں	ریاست
ٹیسٹ ٹیمپلیٹس	ان پٹ کے ساتھ موجودہ ٹیسٹ ٹیمپلیٹس کی فہرست بنائیں	ریاست
NETCONF اطلاعات	ٹیسٹ کی حیثیت بدل گئی۔	اطلاع
ٹیسٹ کے نتائج	ٹیسٹ مرحلہ کی حیثیت حاصل کریں (پاس، فیل، غلطی، …)	ریاست

وسیلہ: ٹیسٹ ایجنٹس
یانگ راستے:

/accounts/account/test-Agents (Config)
/accounts/account/رجسٹرڈ-ٹیسٹ-ایجنٹس (ریاست)

/accounts/account/test-agents کے تحت ٹیسٹ ایجنٹ وہ ہوتے ہیں جو اکاؤنٹ میں تشکیل ہوتے ہیں۔ آرکیسٹریٹر کے ذریعے NETCONF کے ذریعے ٹیسٹ اور مانیٹر میں صرف ان ٹیسٹ ایجنٹوں کو کنفیگر اور استعمال کیا جا سکتا ہے۔
آپ کے ٹیسٹ ایجنٹ کو ترتیب دینے اور اس کے اکاؤنٹ میں رجسٹر ہونے کے بعد، ٹیسٹ ایجنٹ /accounts/account/registered-test-agents کے تحت ظاہر ہوگا۔ آپ NETCONF میں "get" کمانڈ کا استعمال کرتے ہوئے تمام رجسٹرڈ ٹیسٹ ایجنٹ تلاش کر سکتے ہیں (باب سابق کا موازنہ کریںamples: ٹیسٹ ایجنٹس)۔
/accounts/account/registered-test-agents کے تحت آپ کو ٹیسٹ ایجنٹ بھی مل سکتے ہیں جو ابھی تک کنفیگر نہیں ہوئے ہیں۔ اس طرح کے کسی بھی ٹیسٹ ایجنٹ کو استعمال کرنے سے پہلے ترتیب دینا ضروری ہے۔
آرکیسٹریشن کے منظر نامے میں، عام طور پر یہ تجویز کیا جاتا ہے کہ آپ اپنے پیراگون ایکٹو ایشورنس اکاؤنٹ کی تمام ترتیب NETCONF کے ذریعے کریں۔ یہ یقینی بناتا ہے کہ ٹیسٹ ایجنٹ اور رجسٹرڈ ٹیسٹ ایجنٹ الگ نہیں ہوتے ہیں۔

فیچر	ذیلی خصوصیت	یانگ کی تعمیر
سرور پر پہلے سے ٹیسٹ ایجنٹ بنائیں	–	ترتیب
آف لائن ٹیسٹ ایجنٹ کو ترتیب دیں۔	(کنٹرول سینٹر تشکیل کو ٹیسٹ ایجنٹ پر دھکیلتا ہے۔ جب یہ آن لائن آتا ہے)	ترتیب
موجودہ/بیرونی ترتیب شدہ ٹیسٹ ایجنٹس کا استعمال کریں۔	ٹیسٹ/مانیٹر میں استعمال کریں۔	ترتیب
	انٹرفیس کو ترتیب دیں۔	ترتیب
	حیثیت حاصل کریں۔	ریاست
ٹیسٹ ایجنٹ کو ترتیب دیں (صرف ٹیسٹ آلات)	NTP کو ترتیب دیں۔	ترتیب
	پلوں کو ترتیب دیں۔	ترتیب
	VLAN انٹرفیس کو ترتیب دیں۔	ترتیب
	SSH چابیاں تشکیل دیں	ترتیب
	IPv6	ترتیب
Utils	دوبارہ شروع کریں۔	آر پی سی
	اپڈیٹ کریں۔	آر پی سی
NETCONF اطلاعات	آن لائن اسٹیٹس بدل گیا۔	اطلاع
حیثیت	سسٹم کی حیثیت حاصل کریں (اپ ٹائم، میموری کا استعمال، لوڈ اوسط، ورژن)	ریاست

وسیلہ: انوینٹری
یانگ کا راستہ: /accounts/account/twamp- عکاس

تعاون یافتہ NETCONF صلاحیتیں۔

نیچے دی گئی جدول IETF RFCs کی طرف اشارہ کرتی ہے جو پیراگون ایکٹیو ایشورنس آرکیسٹریشن کے مقصد کے لیے استعمال ہونے والی NETCONF صلاحیتوں کو بیان کرتی ہے۔

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 فرنٹ اینڈ یوزر انٹرفیس کے ذریعے دستی طور پر ترتیب دینے کی ضرورت ہے۔ ایسا کرنے کا طریقہ "ٹیسٹ اور مانیٹر" > "ٹیمپلیٹس بنانا" کے تحت ایپ میں مدد میں شامل ہے۔

ExampNETCONF اور YANG API کے ذریعے کنٹرولنگ پیراگون ایکٹیو ایشورنس کا لیس

اس کے بعد آنے والے ابواب میں، یہ فرض کیا گیا ہے کہ مناسب ٹیسٹ اور مانیٹر ٹیمپلیٹس کی وضاحت صفحہ 15 پر باب "ٹیسٹ اور مانیٹر ٹیمپلیٹس" میں دی گئی ہدایات کے مطابق کی گئی ہے۔

سابق میں استعمال ہونے والے اوزارamples
تمام سابقampبعد کے ابواب میں les کو درج ذیل آزادانہ طور پر دستیاب ٹولز کا استعمال کرتے ہوئے بنایا گیا ہے۔

Pang: YANG ماڈلز کو دیکھنے اور براؤز کرنے کے لیے استعمال کیا جاتا ہے۔
پر دستیاب ہے۔ https://github.com/mbj4668/pyang (گٹ سے کلون کریں اور python setup.py انسٹال چلائیں)۔
Python NETCONF کلائنٹ "ncclient": NETCONF کا استعمال کرتے ہوئے کنٹرول سینٹر کے ساتھ بات چیت کرنے کے لیے استعمال کیا جاتا ہے۔

https://github.com/ncclient/ncclient پر دستیاب ہے (پپ انسٹال ncclient چلائیں)۔
netrounds-ncc.yang ڈیٹا ماڈل /opt/netrounds-confd میں پایا جاتا ہے جب ConfD انسٹالیشن گائیڈ کے مطابق انسٹال ہو جاتا ہے)۔

ختمview کئے گئے کلیدی کاموں کی

(کچھ مزید کاموں کی مثال بھی درج ذیل میں دی گئی ہے۔)

صفحہ 16 پر "ایک نیا ٹیسٹ ایجنٹ بنانا اور تعینات کرنا"
صفحہ 29 پر "انوینٹری آئٹمز (مثلاً ریفلیکٹرز) بنانا"
صفحہ 35 پر "الارم ٹیمپلیٹس کو ترتیب دینا اور الارم کہاں بھیجنا ہے"

صفحہ 45 پر "ٹیسٹ بنانا اور چلانا"
صفحہ 50 پر "ٹیسٹ کے نتائج کی بازیافت"
صفحہ 60 پر "مانیٹر شروع کرنا (الارمز کا سیٹ اپ بھی شامل ہے)"
صفحہ 67 پر "مانیٹر کے لیے SLA اسٹیٹس کو بازیافت کرنا"
"کے ساتھ کام کرنا tagsصفحہ 71 پر۔

Examples: ٹیسٹ ایجنٹ

ختمview ٹیسٹ ایجنٹ آرکیسٹریشن کا
پیراگون ایکٹو ایشورنس میں ٹیسٹ ایجنٹوں کو آرکیسٹریشن کے تناظر میں "کنفیگریشن" سمجھا جاتا ہے۔ اس کا مطلب یہ ہے کہ ٹیسٹ ایجنٹوں کی تخلیق، کنٹرول، اور حذف کرنا پیراگون ایکٹیو ایشورنس GUI کے بجائے آرکیسٹریٹر اور NETCONF کے ذریعے کیا جانا چاہیے۔
اہم: اگر ٹیسٹ ایجنٹ کو کسی ٹیکنیشن کے ذریعے انسٹال کیا جاتا ہے اور اسے پہلے NETCONF اور YANG API کے ذریعے بنائے بغیر کنٹرول سینٹر میں رجسٹر کیا جاتا ہے، تو ٹیسٹ ایجنٹ کنفیگریشن ڈیٹا بیس میں موجود نہیں ہوگا، اور سسٹم کی مطابقت پذیری سے باہر ہو جائے گا۔ اس معاملے میں ConfD کو ٹیسٹ ایجنٹ سے آگاہ کرنے کے لیے، یہ ضروری ہو گا کہ کنٹرول سینٹر کے ساتھ ایک نئی ہم آہنگی انجام دے، جیسا کہ صفحہ 4 پر سیکشن "کنفیگریشن ڈیٹا بیس کو کنٹرول سینٹر کے ساتھ ہم آہنگ کرنا" میں تفصیل سے بتایا گیا ہے۔

ورچوئل ٹیسٹ ایجنٹس (vTAs) کی آرکیسٹریشن اس کے بجائے درج ذیل مراحل میں کی جانی چاہیے:

ورچوئل ٹیسٹ ایجنٹ بنائیں، بشمول اس کے انٹرفیس کنفیگریشن، NETCONF اور YANG انٹرفیس کو کنٹرول سینٹر کا استعمال کرتے ہوئے۔ ٹیسٹ ایجنٹ کا نام اس کی منفرد کلید ہو گی۔
وی ٹی اے کو ورچوئلائزیشن پلیٹ فارم پر تعینات کریں۔ ٹیسٹ ایجنٹس > انسٹالیشن کے تحت آن لائن مدد میں دی گئی ہدایات پر عمل کریں۔ بنیادی انٹرفیس کنفیگریشن جو vTA کو کنٹرول سینٹر سے جڑنے کی اجازت دیتی ہے، نیز تصدیق کے لیے اسناد، کلاؤڈ-init صارف ڈیٹا کا استعمال کرتے ہوئے vTA میں فراہم کی جاتی ہیں۔
وی ٹی اے کے بوٹ ہونے کے بعد، یہ خود بخود ایک انکرپٹڈ اوپن وی پی این کنکشن کا استعمال کرتے ہوئے کنٹرول سینٹر سے جڑ جائے گا۔ ایک NETCONF نوٹیفکیشن بھیجا جاتا ہے کیونکہ vTA کے test-agent-statuschange پیرامیٹر کی قدر اب "آن لائن" میں تبدیل ہو گئی ہے۔
نوٹ: چونکہ vTA کا نام کنٹرول سینٹر میں اس کا شناخت کنندہ ہے، اس لیے یہ نام وہی ہونا چاہیے جو کہ صفحہ 1 پر "مرحلہ 17" میں کنٹرول سینٹر میں بیان کیا گیا ہے۔
ایک بار جب vTA کنٹرول سینٹر سے منسلک اور تصدیق شدہ ہو جاتا ہے، تو انٹرفیس کنفیگریشن کو vTA میں دھکیل دیا جاتا ہے۔ یہ انٹرفیس کی ترتیب ہے جو صفحہ 1 پر "مرحلہ 17" میں فراہم کی گئی ہے جب vTA کو کنٹرول سینٹر میں بنایا گیا تھا۔

وی ٹی اے کے اپنا مقصد پورا کرنے کے بعد، وی ٹی اے کو حذف کر دیں۔

ایک نیا ٹیسٹ ایجنٹ بنانا اور تعینات کرنا

ہمیں سب سے پہلے کنٹرول سینٹر میں NETCONF اور YANG انٹرفیس کا استعمال کرتے ہوئے ایک ٹیسٹ ایجنٹ بنانے کی ضرورت ہے۔ جب ایک ٹیسٹ ایجنٹ اس طرح بنایا جاتا ہے، تو کنٹرول سینٹر کے ساتھ ہم آہنگی کی ضرورت نہیں ہوتی ہے۔
ٹیسٹ ایجنٹ کے لیے YANG ماڈل جیسا کہ ذیل میں دکھایا گیا ہے۔ یہ کمانڈ سے آؤٹ پٹ کے طور پر حاصل کیا جاتا ہے۔
پیانگ -f درخت نیٹ گراؤنڈ-ncc.yang
یانگ کا مکمل ماڈل صفحہ 81 پر "ضمیمہ: مکمل یانگ ماڈل کا درختوں کا ڈھانچہ" میں دیا گیا ہے، جس میں ایک افسانہ بھی ہے جس میں موجودہ دستاویز میں اس اور یانگ ماڈل کی دیگر مثالوں میں استعمال ہونے والے کنونشنز کی وضاحت کی گئی ہے۔

ہم درج ذیل مراحل میں آگے بڑھتے ہیں، جن کی تفصیل درج ذیل ہے:

شروع میں، پیراگون ایکٹیو ایشورنس اکاؤنٹ "ڈیمو" کی انوینٹری میں کوئی ٹیسٹ ایجنٹ نہیں ہے۔
"vta1" نامی ایک ٹیسٹ ایجنٹ ncclient کا استعمال کرتے ہوئے بنایا گیا ہے۔ اس پر ایسtage، ابھی تک کوئی حقیقی ٹیسٹ ایجنٹ موجود نہیں ہے (یعنی یہ ابھی شروع نہیں ہوا ہے)۔
ٹیسٹ ایجنٹ OpenStack میں تعینات ہے۔ (اس پلیٹ فارم پر تعیناتی کو یہاں دوسروں کے درمیان ایک امکان کے طور پر منتخب کیا گیا ہے۔)

ٹیسٹ ایجنٹ کنٹرول سینٹر اکاؤنٹ "ڈیمو" سے جڑتا ہے اور اب استعمال کے لیے تیار ہے۔
مرحلہ 1: شروع میں، اکاؤنٹ "ڈیمو" میں کوئی ٹیسٹ ایجنٹ نہیں ہیں۔ کنٹرول سینٹر GUI سے نیچے اسکرین شاٹ دیکھیں۔مرحلہ 2: Python NETCONF کلائنٹ "ncclient" کا استعمال کرتے ہوئے کنٹرول سینٹر میں ایک ٹیسٹ ایجنٹ بنایا جاتا ہے۔ DHCP ایڈریس کے ساتھ ایک فزیکل انٹرفیس رکھنے والا ٹیسٹ ایجنٹ بنانے کے لیے ذیل میں ncclient کوڈ ہے۔

آرگ پارس درآمد کریں۔
این سی کلائنٹ امپورٹ مینیجر سے
parser = argparse.ArgumentParser(description='Test create Test Agent')
parser.add_argument('–host', help='میزبان نام جہاں ConfD پایا جاتا ہے'، مطلوبہ=True)
parser.add_argument('–port', help='ConfD سے جڑنے کے لیے پورٹ'، درکار=True)
parser.add_argument('–username', help='User name to connect to ConfD', required=True)
parser.add_argument('–password', help='ConfD اکاؤنٹ میں پاس ورڈ'، مطلوبہ=True)
parser.add_argument('–netrounds-account', help='NCC اکاؤنٹ کا مختصر نام'، مطلوبہ=True)
parser.add_argument('–test-agent-name', help='ٹیسٹ ایجنٹ کا نام'، مطلوبہ=True)
args = parser.parse_args()
manager.connect کے ساتھ(host=args.host, port=args.port, username=args.username,
password=args.password، hostkey_verify=False) بطور m:
# کنٹرول سینٹر میں ٹیسٹ ایجنٹ بنائیں
xml = """

پرنٹ کریں m.edit_config(target='running', config=xml)

نوٹ: manager.connect(…) کے ساتھ پہلے والے کوڈ کو بعد والے سابق سے ہٹا دیا گیا ہے۔ample کوڈ کے ٹکڑے۔
ایک NTP سرور eth0 پر ترتیب دیا گیا ہے، اور eth0 مینجمنٹ انٹرفیس بھی ہے (یعنی وہ انٹرفیس جو کنٹرول سینٹر سے جڑتا ہے)۔
ٹیسٹ ایجنٹ کی درخواست فی الحال انٹرفیس کو ترتیب دینے کی اجازت نہیں دیتی ہے۔ اس وجہ سے، ورژن 2.34.0 کے بعد سے، YANG اسکیما میں انٹرفیس کی ترتیب کو چھوڑنا ممکن ہے۔ اس معاملے میں متعلقہ XML کو بنیادی طور پر آسان بنایا گیا ہے:ٹیسٹ ایجنٹ بننے کے بعد، یہ کنفیگریشن ڈیٹا بیس اور کنٹرول سینٹر میں موجود ہوتا ہے۔ ٹیسٹ ایجنٹ کی انوینٹری کا نیچے اسکرین شاٹ دیکھیں، جس میں ٹیسٹ ایجنٹ "vta1" دکھایا گیا ہے:

مرحلہ 3: اب ٹیسٹ ایجنٹ "vta1" کو OpenStack میں تعینات کرنے کا وقت آگیا ہے۔
ٹیسٹ ایجنٹ کلاؤڈ-اِنِٹ صارف کا ڈیٹا استعمال کرے گا تاکہ کنٹرول سنٹر سے جڑنے کے طریقے سے متعلق معلومات حاصل کی جا سکے۔ خاص طور پر، صارف کے ڈیٹا کا متن file مندرجہ ذیل مواد ہیں (نوٹ کریں کہ #cloud-config اور netrounds_test_agent لائنیں موجود ہونی چاہئیں، اور یہ کہ بقیہ لائنوں کا حاشیہ ہونا ضروری ہے):

مزید معلومات کے لیے، براہ کرم اس دستاویز سے رجوع کریں کہ OpenStack میں ورچوئل ٹیسٹ ایجنٹس کو کیسے تعینات کیا جائے۔
ٹیسٹ ایجنٹ کے تعینات ہونے اور کنٹرول سینٹر سے منسلک ہونے کے بعد، کنفیگریشن کو کنٹرول سینٹر سے ٹیسٹ ایجنٹ تک پہنچا دیا جائے گا۔

مرحلہ 4: ٹیسٹ ایجنٹ اب کنٹرول سینٹر میں آن لائن ہے اور اس نے اپنی ترتیب حاصل کر لی ہے۔ ٹیسٹ ایجنٹ ٹیسٹوں اور نگرانی میں استعمال کے لیے تیار ہے۔ یہ حصے دیکھیں:

صفحہ 45 پر "ٹیسٹ شروع کرنا"
صفحہ 60 پر "مانیٹر شروع کرنا"

آپ کے پیراگون ایکٹیو ایشورنس اکاؤنٹ میں ٹیسٹ ایجنٹوں کی فہرست بنانا
ذیل میں سابق ہے۔ampپیراگون ایکٹیو ایشورنس اکاؤنٹ میں ٹیسٹ ایجنٹوں کی فہرست کے لیے ncclient Python کوڈ:

اس کوڈ کو چلانے سے نیچے کی طرح آؤٹ پٹ ملتا ہے۔

ٹیسٹ ایجنٹ کو حذف کرنا
ٹیسٹ مکمل ہونے کے بعد، ٹیسٹ ایجنٹ کو حذف کرنا کچھ استعمال کے معاملات میں متعلقہ ہو سکتا ہے۔
ذیل میں ایک کوڈ کا ٹکڑا ہے جس میں دکھایا گیا ہے کہ اسے ncclient کے ساتھ کیسے کرنا ہے:

NETCONF اطلاعات
ذیل میں، ہم ایک سادہ سابقہ پیش کرتے ہیں۔ampکنٹرول سینٹر سے آنے والی تمام NETCONF اطلاعات کو سننے کے لیے le اسکرپٹ۔ یہ اطلاعات اس وقت بھیجی جاتی ہیں جب بھی کچھ واقعات ہوتے ہیں، جیسے کہ ٹیسٹ ایجنٹ آف لائن جانا یا صارف کی طرف سے شروع کردہ ٹیسٹ مکمل ہونا۔ اطلاعات میں دی گئی معلومات کی بنیاد پر، صارفین آرکیسٹریٹر میں خودکار فالو اپ کارروائیاں تفویض کر سکتے ہیں۔

جب مندرجہ بالا اسکرپٹ پر عمل کیا جائے گا، NC کلائنٹ موصول ہونے والی اطلاع کو سٹرکچرڈ XML میں پیش کرے گا۔ سابق دیکھیںampذیل میں لی آؤٹ پٹ، جو ظاہر کرتا ہے کہ ٹیسٹ ایجنٹ غیر متوقع طور پر آف لائن ہو رہا ہے۔

2017-02-03T15:09:55.939156+00:00</eventTime>
<test-agent-status-change xmlns=’http://ncc.netrounds.com'>
ڈیمو
HW1
آف لائن

Examples: انوینٹری آئٹمز

TW جیسی انوینٹری آئٹمز بنانا (درآمد کرنا) اور ان کا انتظام کرناAMP ریفلیکٹرز اور Y.1731 MEPs اسی طرح کیے جاتے ہیں جیسے ٹیسٹ ایجنٹوں کے لیے۔ ذیل میں XML اور NETCONF کوڈ ہے Paragon Active Assurance میں NETCONF اور YANG API کے ذریعے اس طرح کے اداروں کی وضاحت کرنے اور بیان کردہ اشیاء کی فہرستوں کو بازیافت کرنے کے لیے۔

ایک TW بناناAMP ریفلیکٹر

Y.1731 MEP بنانا

آئی پی ٹی وی چینل بنانا

پنگ ہوسٹ بنانا

ایک SIP اکاؤنٹ بنانا

انوینٹری آئٹمز کو بازیافت کرنا
ذیل میں ایک اکاؤنٹ میں بیان کردہ تمام انوینٹری آئٹمز کو بازیافت کرنے کے لیے Python کوڈ ہے۔ (دستاویز میں کچھ تکرار سے بچنے کے لیے تمام قسم کے انوینٹری آئٹمز کو یہاں ایک ہی بار میں لایا جاتا ہے۔ قدرتی طور پر، ذیل میں اکاؤنٹ کے تحت کچھ سطروں کو چھوڑ کر انوینٹری آئٹمز کے کسی بھی ذیلی سیٹ کو حاصل کیا جا سکتا ہے۔)

اس کوڈ کو چلانے سے نیچے کی طرح آؤٹ پٹ ملتا ہے۔

Examples: الارم

الارم ٹیمپلیٹس اور متعلقہ آئٹمز (SNMP مینیجر، الارم ای میل کی فہرستیں) اسی طرح انوینٹری آئٹمز کی طرح بنائے اور منظم کیے جاتے ہیں۔ اس باب میں NETCONF اور YANG API کے ذریعے پیراگون ایکٹیو ایشورنس میں اس طرح کے اداروں کی وضاحت کرنے اور بیان کردہ آئٹمز کی فہرستوں کو بازیافت کرنے کے لیے XML اور NETCONF کوڈ شامل ہے۔
الارم ای میل کی فہرستیں۔
الارم ای میل کی فہرست بنانا

تمام الارم ای میل فہرستوں کو بازیافت کرنا

SNMP مینیجرز
ایک SNMP مینیجر بنانا

تمام SNMP مینیجرز کو بازیافت کرنا

الارم ٹیمپلیٹس
الارم ٹیمپلیٹ بنانا

تمام الارم ٹیمپلیٹس کو بازیافت کیا جا رہا ہے۔

Examples: SSH کیز

آپ NETCONF اور YANG API کے ذریعے ٹیسٹ ایجنٹ میں SSH پبلک کیز شامل کر سکتے ہیں۔ متعلقہ نجی کلید کا استعمال کرتے ہوئے آپ SSH کے ذریعے ٹیسٹ ایجنٹ میں لاگ ان کر سکتے ہیں۔
SSH کیز پر دستیاب کارروائیوں کی مکمل فہرست درج ذیل ہے:

ایک SSH کلید شامل کریں۔
SSH کلید میں ترمیم کریں۔
SSH کلید کا معائنہ کریں۔
SSH کیز کی فہرست بنائیں
ایک SSH کلید کو حذف کریں۔
ذیل میں شامل کریں اور حذف کرنے کی کارروائیوں کی مثال دی گئی ہے۔

ایک SSH کلید شامل کرنا

یہاں ایک نئی SSH کلید بنانے کا طریقہ ہے۔

جونیپر نیٹ ورکس نیٹ کانف اور یانگ API سافٹ ویئر - کلید

SSH کلید کو حذف کرنا
اگر آپ SSH کلید کو حذف کرنا چاہتے ہیں تو درج ذیل کمانڈ کا استعمال کریں:

Examples: ٹیسٹ

یہاں یہ فرض کیا جاتا ہے کہ ٹیسٹ ایجنٹس (جتنے ٹیسٹوں کے لیے درکار ہیں) صفحہ 17 پر "نئے ٹیسٹ ایجنٹ کی تخلیق اور تعیناتی" کے سیکشن کے مطابق بنائے گئے ہیں۔
ٹیسٹ کے لیے یانگ ماڈل کے راستے

آئٹم	یانگ ماڈل کا راستہ: /اکاؤنٹس/اکاؤنٹ/ٹیسٹ…
ٹیسٹ	/.
ٹیسٹ [آئی ڈی]	/ٹیسٹ
id	/ٹیسٹ/آئی ڈی
نام	/ٹیسٹ/نام
حیثیت	/ٹیسٹ/سٹیٹس
وقت آغاز	/ٹیسٹ/اسٹارٹ ٹائم
اختتامی وقت	/ٹیسٹ/اینڈ ٹائم
رپورٹ-url	/جانچ کی رپورٹ-url
قدم	/ٹیسٹ/اقدامات
قدم [آئی ڈی]	/test/steps/step
نام	/test/steps/step/name
id	/test/steps/step/id
وقت آغاز	/test/steps/step/start-time
اختتامی وقت	/test/steps/step/end-time
حیثیت	/test/steps/step/status
اسٹیٹس میسج	/test/steps/step/status-message
ٹیمپلیٹس	/ٹیمپلیٹس
سانچہ[نام]	/templates/template
نام	/templates/template/name
تفصیل	/templates/template/description
پیرامیٹرز	/templates/template/parameters
پیرامیٹر[کلید]	/templates/template/parameters/parameter
کلید	/templates/template/parameters/parameter/key
قسم	/templates/template/parameters/parameter/type

ٹیسٹ آرکیسٹریشن کے لیے شرائط

NC کلائنٹ کا استعمال کرتے ہوئے NETCONF کے ذریعے ٹیسٹ شروع کرنے کے لیے، پہلے کنٹرول سینٹر GUI کا استعمال کرتے ہوئے ایک ٹیسٹ ٹیمپلیٹ بنانا ضروری ہے جیسا کہ "ٹیسٹ اور مانیٹر" > "ٹیمپلیٹس بنانے" کے تحت ایپ مدد میں تفصیل سے بتایا گیا ہے۔ اس ٹیمپلیٹ میں "ٹیمپلیٹ ان پٹ" کے بطور متعین تمام فیلڈز کو ٹیسٹ ٹیمپلیٹ کے آغاز کو ترتیب دیتے وقت XML میں پیرامیٹرز کے طور پر درکار ہوگا۔

پیراگون ایکٹیو ایشورنس میں ٹیسٹ چلانے کو آرکیسٹریشن کے تناظر میں "ریاست" سمجھا جاتا ہے۔ اسٹیٹ ڈیٹا غیر تحریری ڈیٹا ہوتا ہے جو کنفیگریشن ڈیٹا بیس میں محفوظ نہیں ہوتا ہے، جیسا کہ سیکشن "اوورview صفحہ 17 پر ٹیسٹ ایجنٹ آرکیسٹریشن کا۔ بنیادی طور پر اس کا مطلب یہ ہے کہ کنٹرول سینٹر GUI میں ٹیسٹوں یا ٹیمپلیٹس میں تبدیلیاں کنٹرول سینٹر اور کنفیگریشن ڈیٹا بیس کے درمیان مطابقت پذیری سے متعلق کوئی مسئلہ پیدا نہیں کرے گی۔
رپورٹ حاصل کرنے کے لیے-URL ٹیسٹ رپورٹس میں، آپ کو کنٹرول سینٹر کو یقینی بنانا ہوگا۔ URL صحیح طریقے سے ترتیب دیا گیا ہے۔ یہ میں کیا جاتا ہے۔ file /opt/netrounds-confd/settings.py. پہلے سے طے شدہ طور پر کنٹرول سینٹر کے میزبان کا نام socket.gethostname(): نیچے دیکھیں۔ اگر اس سے صحیح نتیجہ نہیں نکلتا ہے، تو آپ کو میزبان کا نام (یا مکمل URLاس میں دستی طور پر file.

# URL ٹریلنگ سلیش کے بغیر کنٹرول سینٹر کا۔
# یہ سابق کے لیے ہے۔ampٹیسٹ رپورٹ میں استعمال کیا جاتا ہے-url.
HOSTNAME = socket.gethostname()
NETROUNDS_URL = 'https://%s' % HOSTNAME
ٹیسٹ شروع کرنا
جیسا کہ صفحہ 17 پر سیکشن "ایک نیا ٹیسٹ ایجنٹ بنانا اور تعینات کرنا" میں بیان کیا گیا ہے، کمانڈ چلائیں pang -f tree netrounds-ncc.yang
یانگ ماڈل کو آؤٹ پٹ کرنے کے لیے ڈائریکٹری /opt/netrounds-confd/ سے۔ اس ماڈل میں، NC کلائنٹ کا استعمال کرتے ہوئے ٹیسٹ شروع کرنے کے لیے RPC اس طرح نظر آتا ہے:

وضاحت کے لیے، سیکشن دیکھیں صفحہ 81 پر "لیجنڈ" ضمیمہ میں

درج ذیل اقدامات ذیل میں دکھائے گئے ہیں۔

ٹیسٹ ایجنٹوں کو پیراگون ایکٹو ایشورنس اکاؤنٹ میں رجسٹر کیا گیا ہے، لیکن ابھی تک کوئی ٹیسٹ شروع نہیں کیا گیا ہے۔
مطلوبہ ان پٹ پیرامیٹرز کی شناخت ٹیسٹ ٹیمپلیٹ میں کی گئی ہے جو چلائی جائے گی۔

ncclient کا استعمال کرتے ہوئے 60 سیکنڈ کا HTTP ٹیسٹ شروع کیا گیا ہے۔

قدم 1: شروع میں، Paragon Active Assurance اکاؤنٹ میں کوئی ٹیسٹ شروع نہیں کیے گئے ہیں۔ کنٹرول سینٹر GUI سے نیچے اسکرین شاٹ دیکھیں۔
قدم 2: ٹیمپلیٹ جو ہم اس سابق میں ٹیسٹ شروع کرنے کے لیے استعمال کریں گے۔ample ایک HTTP ٹیسٹ ٹیمپلیٹ ہے۔ اس میں دو لازمی ان پٹ فیلڈز ہیں (کلائنٹس اور URL) جسے ہم نے کنٹرول سینٹر GUI میں ٹیمپلیٹ بناتے وقت اس طرح بیان کیا ہے۔

ہم اپنے NETCONF مینیجر (ncclient) کی طرف سے کنفیگریشن ڈیٹا بیس کو بھیجے گئے XML کنفیگریشن میں ان پیرامیٹرز (دوسروں کے درمیان) کی وضاحت کریں گے۔
مرحلہ 3: HTTP ٹیسٹ ncclient کا استعمال کرتے ہوئے شروع کیا گیا ہے۔
ذیل میں سابق ہے۔ample کوڈ جہاں HTTP ٹیسٹ ٹیمپلیٹ کے لیے مطلوبہ کنفیگریشن معلومات اور پیرامیٹرز کی وضاحت کی گئی ہے۔ ٹیمپلیٹ کو کیسے بنایا گیا ہے اس پر منحصر ہے، یہاں کی تفصیلات مختلف ہو سکتی ہیں۔
ہر پیرامیٹر کے لیے، خصوصیت فراہم کرنے کی ضرورت ہے۔ کلید پیرامیٹر کی طرح ہے۔
کنٹرول سینٹر میں متغیر نام۔ آپ مندرجہ ذیل متغیر ناموں کا معائنہ کر سکتے ہیں:

سائیڈ بار پر ٹیسٹ پر کلک کریں اور نئے ٹیسٹ کی ترتیب کو منتخب کریں۔

میرے ٹیمپلیٹس پر کلک کریں۔
دلچسپی کے سانچے کے نیچے ترمیم کے لنک پر کلک کریں۔
اوپر دائیں کونے میں ترمیم ان پٹ بٹن پر کلک کریں۔

ہمارے سابق میںample، اور پہلے سے طے شدہ طور پر، متغیر نام صرف کنٹرول سینٹر میں دکھائے جانے والے ڈسپلے ناموں کے چھوٹے ورژن ہیں (“url"بمقابلہ"URL"، وغیرہ)۔ تاہم، کنٹرول سینٹر GUI میں، آپ متغیرات کا نام بدل کر اپنی پسند کے مطابق رکھ سکتے ہیں۔
کلید کے علاوہ، ہر پیرامیٹر کو اس کی قسم کی وضاحت کرنے کی ضرورت ہے: سابق کے لیےampلی، کے لئے URL.
براہ کرم نوٹ کریں کہ آپ کو دوبارہ کرنے کی ضرورت ہے۔view اقسام کے بارے میں مکمل معلومات حاصل کرنے کے لیے مکمل یانگ ماڈل۔ ٹیسٹ ایجنٹ انٹرفیس کے لیے اس قسم کی زیادہ پیچیدہ ساخت ہوتی ہے، جیسا کہ ذیل میں ثبوت ہے۔ ذیل کے کوڈ میں۔

اب ہم ncclient کا استعمال کرکے اسکرپٹ چلا سکتے ہیں۔ یہ فرض کرتے ہوئے کہ سب درست ہے، ٹیسٹ شروع کیا جائے گا اور اس کا عمل کنٹرول سینٹر میں دکھایا جائے گا:اگر ٹیسٹ کامیابی سے شروع ہو جاتا ہے، تو کنٹرول سنٹر ٹیسٹ ID کے ساتھ جواب دے گا۔ اس میں سابقampلی، ٹیسٹ ID 3 ہے:ٹیسٹ ID میں بھی پایا جا سکتا ہے۔ URL کنٹرول سینٹر GUI میں ٹیسٹ کے لیے۔ اس میں سابقampلی، وہ URL https://host/demo/testing/3/ ہے۔
ٹیسٹ کے نتائج کی بازیافت
ٹیسٹ کے نتائج کو بازیافت کرنے کا سب سے سیدھا طریقہ ٹیسٹ ID کی طرف اشارہ کرنا ہے۔
ID = 3 کے ساتھ مندرجہ بالا HTTP ٹیسٹ سے نتائج حاصل کرنے کے لیے Python کوڈ درج ذیل ہے:
مینیجر کے ساتھ. جڑیں(host=args.host, port=args.port, username=args.username,password=args.password, hostkey_verify=False) بطور m:

آؤٹ پٹ کچھ اس طرح نظر آئے گا:

ٹیسٹ ٹیمپلیٹس کو برآمد اور درآمد کرنا
ٹیسٹ ٹیمپلیٹس کو JSON فارمیٹ میں ایکسپورٹ کیا جا سکتا ہے اور اس فارمیٹ میں کنٹرول سینٹر میں دوبارہ درآمد کیا جا سکتا ہے۔ اگر آپ کنٹرول سینٹر کی مختلف تنصیب میں ٹیسٹ ٹیمپلیٹس استعمال کرنا چاہتے ہیں تو یہ مفید ہے۔ (ٹیمپلیٹس کی ابتدائی تخلیق کو کنٹرول سینٹر GUI کے ذریعے بہترین طریقے سے سنبھالا جاتا ہے۔)
ذیل میں برآمد اور درآمد کو انجام دینے کا کوڈ ہے۔
ٹیسٹ ٹیمپلیٹس برآمد کرنا

# جواب سے json config حاصل کریں۔
root = ET.fromstring(response._raw)
json_config = root[0].text
پرنٹ json_config
ٹیمپلیٹ json_config آبجیکٹ میں موجود ہے۔
ٹیسٹ ٹیمپلیٹس درآمد کرنا
JSON config آبجیکٹ ہولڈنگ ٹیسٹ ٹیمپلیٹس کو کنٹرول سینٹر میں درج ذیل میں دوبارہ درآمد کیا جا سکتا ہے۔

Examples: مانیٹر

یہ سیکشن فرض کرتا ہے کہ ٹیسٹ ایجنٹس (جتنے مانیٹرز کی ضرورت ہے) صفحہ 17 پر "نئے ٹیسٹ ایجنٹ کی تخلیق اور تعیناتی" کے سیکشن کے مطابق بنائے گئے ہیں۔
مانیٹر کے لیے یانگ ماڈل کے راستے

آئٹم	یانگ ماڈل پاتھ: /اکاؤنٹس/اکاؤنٹ/مانیٹر…
مانیٹر	/.
مانیٹر[نام]	/ مانیٹر
نام	/مانیٹر/نام
تفصیل	/مانیٹر/تفصیل
شروع کیا	/مانیٹر/شروع
ٹیمپلیٹ	/مانیٹر/ٹیمپلیٹ
الارم کنفیگرز	/monitor/alarm-configs
آئٹم	YANG ماڈل پاتھ: /accounts/account/monitors/monitor/alarm-configs …
الارم کی تشکیل[شناخت کنندہ]	/alarm-config
شناخت کنندہ	/alarm-config/identifier
ٹیمپلیٹ	/alarm-config/template
ای میل	/alarm-config/email
snmp	/alarm-config/snmp
thr-es-critical	/alarm-config/thr-es-critical
thr-es-critical-clear	/alarm-config/thr-es-critical-clear
thr-es-major	/alarm-config/thr-es-major
thr-es-major-clear	/alarm-config/thr-es-major-clear
thr-es-minor	/alarm-config/thr-es-minor
thr-es-minor-clear	/alarm-config/thr-es-minor-clear
thr-es-انتباہ	/alarm-config/thr-es-warning
thr-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-one
snmp-trap-per-stream	/alarm-config/snmp-trap-per-stream
آئٹم	یانگ ماڈل پاتھ: /اکاؤنٹس/اکاؤنٹ/مانیٹر…
پیرامیٹرز	/مانیٹر/پیرامیٹر
آئٹم	یانگ ماڈل کا راستہ: /اکاؤنٹس/اکاؤنٹ/مانیٹر/مانیٹر/پیرامیٹر …
پیرامیٹر[کلید]	/پیرامیٹر
کلید	/پیرامیٹر/کلید
(قدر کی قسم)	/پیرامیٹر
:(عدد)	/پیرامیٹر
عدد	/پیرامیٹر/انٹیجر
:(تیرنا)	/پیرامیٹر
تیرنا	/پیرامیٹر/فلوٹ
:(سٹرنگ)	/پیرامیٹر
آئٹم	یانگ ماڈل کا راستہ: /اکاؤنٹس/اکاؤنٹ/مانیٹر/مانیٹر/پیرامیٹر …
تار	/پیرامیٹر/سٹرنگ
:(ٹیسٹ-ایجنٹ-انٹرفیس)	/پیرامیٹر
ٹیسٹ ایجنٹ انٹرفیس	/پیرامیٹر/ٹیسٹ-ایجنٹ-انٹرفیس
test-agent-interface["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- منعکس/twamp- عکاس
نام	/پیرامیٹر/twamp- منعکس/twamp- عکاس/نام
:(y1731-meps)	/پیرامیٹر
y1731-meps	/پیرامیٹر/y1731-meps
y1731-mep[نام]	/پیرامیٹر/y1731-meps/y1731-mep
نام	/پیرامیٹر/y1731-meps/y1731-mep/name
:(سپ اکاؤنٹس)	/پیرامیٹر
گھونٹ اکاؤنٹس	/پیرامیٹر/sip-اکاؤنٹس
گھونٹ اکاؤنٹ["2" صفحہ 58 پر]	/پیرامیٹر/sip-accounts/sip-account
اکاؤنٹ	/پیرامیٹر/sip-accounts/sip-account/account
ٹیسٹ ایجنٹ	/پیرامیٹر/sip-accounts/sip-account/test-agent
انٹرفیس	/پیرامیٹر/sip-accounts/sip-account/interface
گھونٹ کا پتہ	/پیرامیٹر/sip-accounts/sip-account/sip-address
:(آئی پی ٹی وی چینلز)	/پیرامیٹر
آئی پی ٹی وی چینلز	/پیرامیٹر/آئی پی ٹی وی چینلز
آئی پی ٹی وی چینل[نام]	/پیرامیٹر/iptv-channels/iptv-channel
نام	/پیرامیٹر/iptv-channels/iptv-channel/name

اکاؤنٹ ٹیسٹ ایجنٹ انٹرفیس
اکاؤنٹ ٹیسٹ ایجنٹ انٹرفیس گھونٹ ایڈریس

آئٹم	یانگ ماڈل پاتھ: /اکاؤنٹس/اکاؤنٹ/مانیٹر…
حیثیت	/مانیٹر/سٹیٹس
آخری 15 منٹ	/monitor/status/last-15-minutes
حیثیت	/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 گھنٹے	/monitor/status/last-24-hours
حیثیت	/monitor/status/last-24-hours/status
حیثیت کی قدر	/monitor/status/last-24-hours/status-value
ٹیمپلیٹس	/ٹیمپلیٹس
سانچہ[نام]	/templates/template
نام	/templates/template/name
تفصیل	/templates/template/description
پیرامیٹرز	/templates/template/parameters
پیرامیٹر[کلید]	/templates/template/parameters/parameter
کلید	/templates/template/parameters/parameter/key
قسم	/templates/template/parameters/parameter/type

مانیٹر آرکیسٹریشن کے لیے ضروری شرائط
اس سے پہلے کہ آپ ncclient کا استعمال کرتے ہوئے NETCONF کے ذریعے مانیٹر شروع کر سکیں، آپ کو کنٹرول سینٹر GUI میں مانیٹر ٹیمپلیٹ بنانے کی ضرورت ہے جیسا کہ "ٹیسٹ اور مانیٹر" > "ٹیمپلیٹس بنانا" کے تحت ایپ مدد میں بیان کیا گیا ہے۔ اس ٹیمپلیٹ میں "ٹیمپلیٹ ان پٹ" کے بطور متعین تمام فیلڈز کو ٹیمپلیٹ کے آغاز کو ترتیب دیتے وقت XML میں پیرامیٹرز کے طور پر درکار ہوگا۔
مانیٹر ٹیمپلیٹس سے ان پٹ پیرامیٹرز حاصل کرنا
ذیل میں دو ٹیمپلیٹس دکھائے گئے ہیں۔ پہلا دو ٹیسٹ ایجنٹ انٹرفیس کے درمیان UDP مانیٹرنگ کے لیے ہے، اور دوسرا ایک ہی ٹیسٹ ایجنٹ انٹرفیس کا استعمال کرتے ہوئے HTTP کے لیے ہے۔
ٹیمپلیٹ کے ان پٹ پیرامیٹرز کو جاننے کے لیے، ٹیمپلیٹ کی نمائندگی کرنے والے باکس پر کلک کریں۔ HTTP ٹیمپلیٹ کے لیے، پیرامیٹرز اس طرح نظر آ سکتے ہیں:

مانیٹر شروع کرتے وقت ہمیں اگلے مرحلے میں ان پیرامیٹرز کی وضاحت کرنے کی ضرورت ہے۔
مانیٹر شروع کرنا
ان ٹیسٹ ایجنٹوں کا استعمال کرتے ہوئے جن کی ہم نے صفحہ 17 پر سیکشن "ایک نئے ٹیسٹ ایجنٹ کی تخلیق اور تعیناتی" میں وضاحت اور تعیناتی کی ہے، ہم ذیل میں دکھایا گیا ٹیمپلیٹ "HTTP" سے مانیٹر شروع کر سکتے ہیں۔
ہر پیرامیٹر کے لیے، خصوصیت فراہم کرنے کی ضرورت ہے۔ کلید کنٹرول سینٹر میں پیرامیٹر کے متغیر نام کی طرح ہے۔ آپ مندرجہ ذیل متغیر ناموں کا معائنہ کر سکتے ہیں:

سائیڈ بار پر مانیٹرنگ پر کلک کریں اور نیا مانیٹر منتخب کریں۔

میرے ٹیمپلیٹس پر کلک کریں۔
دلچسپی کے سانچے کے نیچے ترمیم کے لنک پر کلک کریں۔
اوپر دائیں کونے میں ترمیم ان پٹ بٹن پر کلک کریں۔

ہمارے سابق میںample، اور پہلے سے طے شدہ طور پر، متغیر نام صرف کنٹرول سینٹر میں دکھائے جانے والے ڈسپلے ناموں کے چھوٹے ورژن ہیں (“url"بمقابلہ"URL"، وغیرہ)۔ تاہم، کنٹرول سینٹر GUI میں، آپ متغیرات کا نام بدل کر اپنی پسند کے مطابق رکھ سکتے ہیں۔
کلید کے علاوہ، ہر پیرامیٹر کو اس کی قسم کی وضاحت کرنے کی ضرورت ہے: سابق کے لیےampلی، کے لئے URL. براہ کرم نوٹ کریں کہ پیرامیٹر کی قسم پر مکمل معلومات YANG ماڈل میں پائی جاتی ہے۔ ٹیسٹ ایجنٹ انٹرفیس کے لیے قسم کی ساخت زیادہ پیچیدہ ہوتی ہے، جیسا کہ ذیل کے کوڈ میں دکھایا گیا ہے۔
سابق میںampاس کے بعد، کوئی الارم مانیٹر سے وابستہ نہیں ہے۔ سابق کے لیےamples جس میں الارم شامل ہیں، صفحہ 62 پر سیکشن "الارم کے ساتھ مانیٹر شروع کرنا" پر جائیں۔

الارم کے ساتھ مانیٹر شروع کرنا
الارم کو مانیٹر کے ساتھ منسلک کرنے کے لیے، آپ یا تو کسی الارم ٹیمپلیٹ کی طرف اشارہ کر سکتے ہیں جس کی وضاحت کی گئی ہے، یا مانیٹر بناتے وقت آپ پوری الارم کنفیگریشن فراہم کر سکتے ہیں۔ ہم ایک سابق دیں گے۔ampذیل میں ہر ایک نقطہ نظر کی لی.
الارم ٹیمپلیٹ کی طرف اشارہ کرکے مانیٹر الارم ترتیب دینا
الارم ٹیمپلیٹ کا استعمال کرنے کے لیے، آپ کو اس کی شناخت کا علم ہونا چاہیے۔ اس مقصد کے لیے، پہلے اپنے تمام الارم ٹیمپلیٹس کو بازیافت کریں جیسا کہ صفحہ 39 پر "تمام الارم ٹیمپلیٹس کی بازیافت" کے سیکشن میں بیان کیا گیا ہے اور متعلقہ ٹیمپلیٹ کا نام نوٹ کریں۔ اس کے بعد آپ اس ٹیمپلیٹ کو مندرجہ ذیل طور پر دیکھ سکتے ہیں:

اسے ڈائریکٹ کنفیگر کرکے مانیٹر الارم ترتیب دیناy
متبادل طور پر، آپ مانیٹر بناتے وقت الارم ٹیمپلیٹ کا حوالہ دیئے بغیر، مانیٹر کے لیے اس کی پوری ترتیب فراہم کر کے الارم ترتیب دے سکتے ہیں۔ یہ کیا جاتا ہے جیسا کہ مندرجہ ذیل سابق میں دکھایا گیا ہے۔ample

رننگ مانیٹر کو بازیافت کرنا
ان تمام مانیٹروں کو بازیافت کرنے کے لیے جو فی الحال ایکسیکیوٹ ہو رہے ہیں، اس اسکرپٹ کو چلائیں:
مینیجر کے ساتھ. connect(host=args.host, port=args.port, username=args. user name, password=args.password, hostkey_verify=False) بطور m:

آؤٹ پٹ تمام چلنے والے مانیٹروں کی فہرست ہے جیسا کہ ذیل میں دکھایا گیا ہے:

مانیٹر کے لیے SLA اسٹیٹس کو بازیافت کرنا
یہاں یہ ہے کہ مانیٹر کے لیے SLA اسٹیٹس کو کیسے حاصل کیا جائے۔ اس میں سابقampلی، ہم مانیٹر "نیٹ ورک کوالٹی" کے لیے وقت کے تین وقفوں کے لیے SLA اسٹیٹس بازیافت کر رہے ہیں: آخری 15 منٹ، آخری گھنٹہ، اور آخری 24 گھنٹے۔

آؤٹ پٹ کچھ اس طرح نظر آئے گا:

NETCONF اطلاعات
مانیٹرس کے لیے NETCONF اطلاعات SLA کی خلاف ورزیوں سے متحرک ہوتی ہیں۔ یہ اس وقت ہوتا ہے جب مانیٹر کے لیے SLA ایک مقررہ ٹائم ونڈو کے اندر SLA حد ("اچھا" یا "قابل قبول") سے نیچے گر جاتا ہے، بطور ڈیفالٹ آخری 15 منٹ۔ واضح رہے کہ سروس کے کسی مسئلے سے متاثر ہونے کے بعد SLA کی خلاف ورزی کی اطلاع فوری طور پر ظاہر ہوتی ہے، جبکہ SLA کی حیثیت صرف 15 منٹ کے بعد "اچھی" پر واپس آجائے گی، اور صرف اس صورت میں جب مزید خلاف ورزیاں نہ ہوں۔
ترتیب SLA_STATUS_WINDOW (سیکنڈ میں قدر) میں ترمیم کرکے ٹائم ونڈو کو تبدیل کیا جاسکتا ہے۔ /etc/netrounds/netrounds.conf.
مانیٹر ٹیمپلیٹس کو برآمد اور درآمد کرنا
یہ بالکل اسی طرح کیا جاتا ہے جیسے ٹیسٹ ٹیمپلیٹس کے لیے؛ صفحہ 52 پر سیکشن "Exporting and Importing Test Templates" کا موازنہ کریں۔ ذیل میں کوڈ کے ٹکڑوں میں یہ واضح کیا گیا ہے کہ مانیٹر کے لیے ٹیمپلیٹس کو کیسے برآمد اور درآمد کیا جائے۔
مانیٹر ٹیمپلیٹس برآمد کرنا

مانیٹر ٹیمپلیٹس درآمد کرنا

استعمال کرنا Tags

Tags پیراگون ایکٹیو ایشورنس میں بیان کردہ اس پر لاگو کیا جا سکتا ہے:

مانیٹر
مانیٹر ٹیمپلیٹس
ٹیسٹ ایجنٹس
TWAMP عکاس
پنگ میزبان۔
سابق کے لیےampلی، آپ کر سکتے ہیں۔ tag اسی کے ساتھ ایک مانیٹر tag ٹیسٹ ایجنٹوں کے ذیلی سیٹ کے طور پر جو مانیٹر چلانے جا رہے ہیں۔ یہ خصوصیت خاص طور پر مددگار ہے اگر آپ کے پاس بڑی تعداد میں مانیٹر اور ٹیمپلیٹس کی وضاحت کی گئی ہے۔

اگر آپ نے مانیٹر کے لیے SNMP ٹریپس کے ساتھ الارم لگایا ہے، تو SNMP ٹریپس کو وہی تفویض کیا جائے گا۔ tags مانیٹر کے طور پر، اگر کوئی ہے۔
تخلیق کرنا Tags
ذیل میں ہم دکھاتے ہیں کہ ایک کیسے بنایا جائے۔ tag نام اور رنگ کے ساتھ جیسا کہ XML کے ذریعے بیان کیا گیا ہے۔tag> ذیلی ڈھانچہ۔

تفویض کرنا a Tag
تفویض کرنا a tag کسی وسائل میں، آپ اسے ایک نئے کے طور پر شامل کرتے ہیں۔tag> کے تحت عنصرtags> اس وسائل کے لیے عنصر۔
یہاں ایک تفویض کرنے کا طریقہ ہے۔ tag ٹیسٹ ایجنٹ کو:

تفویض کرنا a tag ایک TW کوAMP ریفلیکٹر، درج ذیل کام کریں:

تفویض کرنا a tag ایک مانیٹر کو اسی طرح سنبھالا جاتا ہے:

متبادل طور پر، آپ ایک موجودہ تفویض کر سکتے ہیں tag وسائل تخلیق کرتے وقت ان وسائل کی اقسام میں سے کسی کو شامل کرکےtags> پر مشتمل عنصر tag سوال میں
اپ ڈیٹ کرنا a Tag
موجودہ کو اپ ڈیٹ کرنا tag نئی صفات کے ساتھ ایک تخلیق کرنے کے مترادف ہے۔ tag:

تفویض ختم کرنا a Tag
تفویض ختم کرنا a tag کسی وسائل سے، nc:operation=”delete” میں وصف شامل کریں۔tag> وسائل سے تعلق رکھنے والا عنصر۔ ذیل میں، ہم غیر تفویض a tag مانیٹر سے۔

حذف کرنا a Tag
حذف کرنے کے لیے a tag مکمل طور پر کنٹرول سینٹر سے، وصف nc:operation="delete" دوبارہ استعمال کیا جاتا ہے، لیکن اس بار اس کا اطلاق tag خود، کے تحت بیان کیا گیا ہے .

خرابی کا سراغ لگانا

مسئلہ: آرکیسٹریٹر اور پیراگون ایکٹیو ایشورنس ہم آہنگی سے باہر ہے۔
آرکیسٹریٹر اور پیراگون ایکٹیو ایشورنس سابق کے لیے ہم آہنگی سے باہر ہو سکتے ہیں۔ample اگر کنٹرول سینٹر GUI میں کنفیگریشن تبدیلیاں کی گئی ہیں، یا اگر کنفیگریشن کا اطلاق کامیاب نہیں ہوا اور پچھلی حالت میں واپس جانا ناکام ہو گیا۔
ناکام رول بیک کی صورت میں، NETCONF سرور مزید کنفیگریشن تبدیلیوں کو قبول نہیں کرے گا۔ یہ ایک غلطی کے پیغام کے ساتھ جواب دے گا جس میں کہا جائے گا کہ کنفیگریشن دوبارہ مطابقت پذیر ہونے تک بند ہے۔ مطابقت پذیری میں واپس آنے اور کنفیگریشن تبدیلیوں کو غیر مقفل کرنے کے لیے، آپ کو rpc sync-from-ncc کمانڈ چلانے کی ضرورت ہے جو کنٹرول سینٹر سے کنفیگریشن ڈیٹا بیس تک تمام کنفیگریشن کو ہم آہنگ کرتی ہے۔
نوٹ: دی confd@netrounds.com صارف (یا جو کچھ بھی ترتیب دیا گیا ہے) کو ہر چیز کے کامیابی کے ساتھ مطابقت پذیر ہونے کے لیے سپر یوزر کے مراعات کا ہونا ضروری ہے۔ یہ کمانڈ ncc user-update کے ساتھ حاصل کیا جا سکتا ہے۔ confd@netrounds.com -is-superuser اگر صارف سپر یوزر نہیں ہے تو، ایک انتباہ ظاہر ہوگا جس میں کہا جائے گا کہ ہر چیز کو مطابقت پذیر نہیں کیا جاسکتا ہے، لیکن یہ کہ سب کچھ سنبھالا جا سکتا ہے.
نوٹ: اگر آپ کا آرکیسٹریٹر بھی کنفیگریشن کو اسٹور کرتا ہے، تو آپ کو اسے دوبارہ سنکرونائز کرنے کی ضرورت ہوگی کیونکہ درخواست کردہ کنفیگریشن (وہ کنفیگریشن جس کی آرکیسٹریٹر کو توقع ہے کہ کنٹرول سنٹر کو ہونا چاہیے) کو لاگو نہیں کیا جائے گا۔
مسئلہ: ابتدائی مطابقت پذیری (sync-from-ncc) غیر تعاون یافتہ وسائل کی وجہ سے ناکام
اگر آپ کسی ایسے اکاؤنٹ پر rpc sync-from-ncc چلانے کی کوشش کرتے ہیں جس کی کنفیگریشن کنٹرول سینٹر GUI میں بنائی گئی ہے، تو آپ کو مسائل کا سامنا کرنا پڑ سکتا ہے اگر اکاؤنٹ میں غیر تعاون یافتہ وسائل ہوں۔ یہ تجویز کیا جاتا ہے کہ آپ ایک خالی اکاؤنٹ سے شروع کریں اور اس کی تمام ترتیب NETCONF کے ذریعے کریں۔ دوسری صورت میں، اگر آپ کو وسائل کے تنازعات کے ساتھ مسائل کا سامنا کرنا پڑتا ہے، تو آپ کو اکاؤنٹ سے متضاد وسائل کو ہٹانا پڑے گا۔
مسئلہ: NETCONF کمانڈز ncclient.operations.rpc.RPCError کے ساتھ ناکام: ایپلیکیشن کمیونیکیشن کی ناکامی
اگر کنٹرول سینٹر دوبارہ شروع ہوتا ہے تو NETCONF سرور خود بخود کنٹرول سینٹر سرور سے رابطہ بحال نہیں کرتا ہے۔ کنٹرول سینٹر سے کنکشن بحال کرنے کے لیے، NETCONF عمل کو دوبارہ شروع کریں: sudo systemctl دوبارہ شروع کریں netrounds-confd

ٹیسٹ ایجنٹ کی درخواستوں اور ٹیسٹ ایجنٹ کے آلات پر نوٹس

ConfD میں ایجنٹ کی درخواستوں کی جانچ کریں۔
ٹیسٹ ایجنٹوں میں، (نئے) ٹیسٹ ایجنٹ کی درخواست (پرانے) ٹیسٹ ایجنٹ آلات سے کچھ مختلف طریقے سے کام کرتی ہے۔
ٹیسٹ ایجنٹ ایپلیکیشنز فی الحال انٹرفیس کنفیگریشن کو سپورٹ نہیں کرتی ہیں۔ لہذا، YANG اسکیما ایسے ٹیسٹ ایجنٹوں کے لیے خالی انٹرفیس کنفیگریشن کی وضاحت کرنے کی اجازت دیتا ہے۔ ایک سابق کے لیے صفحہ 23 پر "یہ حوالہ" دیکھیںample
sync-from-ncc کمانڈ کا استعمال کرتے ہوئے ConfD ڈیٹا بیس کو کنٹرول سینٹر کے ساتھ ہم وقت سازی کرتے وقت، آپ چاہتے ہیں کہ انٹرفیس کنفیگریشن خالی رہے اور کنٹرول سینٹر میں موجود چیزوں کے ساتھ اوور رائٹ نہ ہو۔ لہذا آپ کو ٹیسٹ ایجنٹ ایپلی کیشنز کے ساتھ کام کرتے وقت اس کمانڈ کے ساتھ ایک خاص جھنڈا -without_interface_config استعمال کرنے کی ضرورت ہے۔
ٹیسٹ ایجنٹ آلات کے لیے خالی انٹرفیس کنفیگریشن
جیسا کہ اوپر بتایا گیا ہے، ٹیسٹ ایجنٹ ایپلیکیشن انٹرفیس کنفیگریشن کو سپورٹ نہیں کرتی ہے، اور اس لیے YANG اسکیما میں انٹرفیس کو چھوڑنا ممکن ہے۔
لیکن استعمال کے ایسے معاملات بھی ہیں جہاں آپ ٹیسٹ ایجنٹ ایپلائینس سے انٹرفیس کی ترتیب کو چھوڑنا چاہتے ہیں۔ ایک سابقampاس میں سے ایک آرکیسٹریشن کا منظر نامہ ہوسکتا ہے جہاں آپ کلاؤڈ-init کا استعمال کرتے ہوئے ٹیسٹ ایجنٹ کو گھما رہے ہیں، اور آپ چاہتے ہیں کہ وہاں سے انٹرفیس کنفیگریشن کو استعمال کیا جائے، بجائے اس کے کہ ConfD کو ٹیسٹ ایجنٹ کے آن لائن آنے پر اسے اوور رائٹ کرنے دیں۔
غیر متعینہ انٹرفیس کے حوالے سے یانگ اسکیما تبدیلیاں
چونکہ ایک خالی انٹرفیس کنفیگریشن کی اب اجازت ہے (ورژن 2.34.0 کے بعد)، یہ ممکن ہے کہ کسی بھی انٹرفیس کا نام بطور ان پٹ ایک ٹیسٹ یا مانیٹر کے حصے کے طور پر چلائے جانے والے کام کے لیے بیان کیا جائے۔
ٹیسٹ ایجنٹ کی درخواست استعمال کرنے کے قابل ہونے کے لیے یہ ضروری ہے، کیونکہ ان کے لیے ConfD میں انٹرفیس کے ناموں کی وضاحت نہیں کی گئی ہے۔ نوٹ کریں، تاہم، اس کا مطلب یہ بھی ہے کہ اگر آپ حادثاتی طور پر کسی غیر موجود انٹرفیس کو استعمال کرنے کے لیے کسی ٹیسٹ یا مانیٹر کو ترتیب دیتے ہیں تو آپ مسائل کا شکار ہو سکتے ہیں۔ تو برائے مہربانی اس بات کا خیال رکھیں۔
ConfD میں بنائے گئے ٹیسٹ ایجنٹ کو رجسٹر کرتے وقت حدود
REST یا NETCONF/YANG API کے ذریعے ٹیسٹ ایجنٹ بناتے وقت، ہم پہلے سے نہیں جان سکتے کہ یہ کس قسم کا ہے: ٹیسٹ ایجنٹ ایپلائینس یا ٹیسٹ ایجنٹ ایپلیکیشن۔ ٹیسٹ ایجنٹ کے رجسٹر ہونے کے بعد ہی یہ واضح ہو جاتا ہے۔
ایک بار جب ٹیسٹ ایجنٹ رجسٹر ہو جاتا ہے اور ان میں سے کسی ایک قسم میں تبدیل ہو جاتا ہے، تو آپ کو اسے مختلف قسم کے ٹیسٹ ایجنٹ کے طور پر دوبارہ رجسٹر کرنے کی اجازت نہیں ہے۔ اس کا مطلب ہے کہ آپ کو پہلے اسے ٹیسٹ ایجنٹ ایپلائینس کے طور پر رجسٹر کرنے کی اجازت نہیں ہے، پھر اسے ٹیسٹ ایجنٹ کی درخواست کے طور پر دوبارہ رجسٹر کریں، یا اس کے برعکس۔ اگر آپ کو مختلف قسم کے ٹیسٹ ایجنٹ کی ضرورت ہے، تو آپ کو ایک نیا ٹیسٹ ایجنٹ بنانا ہوگا۔

ضمیمہ: مکمل یانگ ماڈل کا درختوں کا ڈھانچہ

اس ضمیمہ میں، صفحہ 81 پر سیکشن "لیجنڈ" پیانگ - ایف ٹری کمانڈ کے ساتھ تیار کردہ YANG ماڈل ٹری ڈھانچے کے نحو کی وضاحت کرتا ہے۔
صفحہ 82 پر سیکشن "YANG ماڈل ٹری سٹرکچر" netrounds-ncc.yang پر لاگو اس کمانڈ سے آؤٹ پٹ دیتا ہے۔ اس آؤٹ پٹ کے کچھ حصے دستاویز میں کہیں اور دوبارہ تیار کیے جاتے ہیں۔
لیجنڈ

یانگ ماڈل درخت کی ساخت

Juniper Networks، Juniper Networks لوگو، Juniper، اور Junos ریاستہائے متحدہ اور دیگر ممالک میں Juniper Networks, Inc. کے رجسٹرڈ ٹریڈ مارک ہیں۔ دیگر تمام ٹریڈ مارکس، سروس مارکس، رجسٹرڈ مارکس، یا رجسٹرڈ سروس مارکس ان کے متعلقہ مالکان کی ملکیت ہیں۔ Juniper Networks اس دستاویز میں کسی بھی غلطی کی ذمہ داری قبول نہیں کرتا ہے۔ Juniper Networks بغیر اطلاع کے اس اشاعت کو تبدیل کرنے، ترمیم کرنے، منتقل کرنے یا دوسری صورت میں نظر ثانی کرنے کا حق محفوظ رکھتا ہے۔ کاپی رائٹ © 2023 Juniper Networks, Inc. جملہ حقوق محفوظ ہیں۔

دستاویزات / وسائل

جونیپر نیٹ ورکس نیٹ کانف اور یانگ API سافٹ ویئر [پی ڈی ایف] یوزر گائیڈ
NETCONF یانگ API سافٹ ویئر، یانگ API سافٹ ویئر، API سافٹ ویئر، سافٹ ویئر

حوالہ جات

صارف دستی

تعارف