Juniper NETWORKS NETCONF & YANG API Gwida għall-Utent tas-Software

Għan ta' Dan id-Dokument
Din id-dokumentazzjoni tiddeskrivi kif tintegra Paragon Active Assurance ma' orkestratur tas-servizz tan-netwerk permezz taċ-Ċentru ta' Kontroll NETCONF & YANG API. Hands-on exampJingħataw il-ħidmiet prinċipali involuti, inklużi: il-ħolqien u l-iskjerament ta' Aġenti tat-Test Virtwali, it-tmexxija ta' testijiet u monitors, u l-irkupru tar-riżultati minn dawn l-attivitajiet.
F'dan id-dokument, il-klijent ncclient Python NETCONF disponibbli liberament jintuża fir-rwol ta 'orkestratur.

Konvenzjonijiet
L-abbrevjazzjonijiet li ġejjin huma użati f'dan id-dokument:

Abbrevjazzjoni	Tifsira
CLI	Interface tal-Linja tal-Kmand
EM	Maniġer tal-Element
ES	Żbaljat It-Tieni
MEP	MEG (Grupp ta' Entitajiet ta' Manutenzjoni) End Point (definizzjoni ITU-T Y.1731) jew Maintenance End Point (definizzjoni Cisco)
NFV	Virtualizzazzjoni tal-Funzjoni tan-Netwerk
NFVO	Orkestratur tal-Virtwalizzazzjoni tal-Funzjoni tan-Netwerk
NSD	Deskrittur tas-Servizz tan-Netwerk
RPC	Sejħa għal Proċedura Remota
SIP	Protokoll tal-Bidu tas-Sessjoni
SLA	Ftehim dwar il-Livell ta' Servizz
S-VNFM	Maniġer speċjali tal-VNF
VNF	Funzjoni tan-Netwerk Virtwali
vTA	Aġent tat-Test Virtwali

Noti dwar il-Kompatibbiltà b'lura

Fil-verżjonijiet 2.35.4/2.36.0 tan-NETCONF & YANG API, il-validazzjoni ta 'ċerti talbiet saret aktar stretti biex jaderixxu mal-istandard NETCONF. Dan ifisser li l-kodiċi tal-klijent ibbażat fuq verżjonijiet eqdem ta' din il-gwida issa jista' jiġi rrifjutat.
Per example, fil-Python preċedenti example code, l-ebda attribut namespace ma ġie pprovdut. L-ispazju tal-isem issa jeħtieġ li jiġi fornut fit-talba XML kull meta trid timmodifika riżorsa tal-ConfD.

Prerekwiżiti u Preparazzjonijiet

Installazzjoni tal-ConfD
ConfD (prodott minn Tail-f) jintuża bħala intermedjarju bejn is-sistema ta' Assigurazzjoni Attiva Paragon u NETCONF. Il-ConfD jgħaqqad il-konfigurazzjoni ta' Paragon Active Assurance u d-dejta operattiva mal-API NETCONF & YANG.
Il-ConfD kellu jkun installat flimkien mas-softwer taċ-Ċentru tal-Kontroll, kif deskritt fil-Gwida tal-Installazzjoni.

Verifika Li l-ConfD Qed Tmexxi
Biex tivverifika li l-ConfD tkun qed taħdem, mexxi l-kmand
ssh -s @localhost -p 830 netconf
biex tivverifika li ConfD tirrispondi fuq il-port 830. Fil-kmand, huwa kif definit mill-utent netconf joħolqu
kmand fil-Gwida ta 'Installazzjoni, taqsima Installazzjoni ta' ConfD. Agħti l-password definita mill-istess kmand.
Fl-output, ivverifika li l-modulu taċ-Ċentru tal-Kontroll huwa inkluż. L-output għandu jkun fih linja bħal din li ġejja:
http://ncc.netrounds.com?module=netrounds-ncc&reviżjoni=2017-06-15

Is-sinkronizzazzjoni tad-Database tal-Konfigurazzjoni maċ-Ċentru tal-Kontroll

Fl-aħħarnett, għandna bżonn naġġornaw id-database tal-konfigurazzjoni permezz ta 'NETCONF. Aħna se nagħmlu dan hawn permezz ta 'librerija Python imsejħa ncclient (NETCONF Klijent). Madankollu, il-kompitu jista 'jitwettaq ukoll f'lingwa ta' programmar differenti sakemm juża l-protokoll NETCONF/YANG.
Ir-rwol ta 'ncclient huwa li jaġixxi bħala klijent lejn is-server ConfD li jospita l-API NETCONF/YANG.

Ta 'min jinnota li ncclient mhu relatat bl-ebda mod maċ-Ċentru ta' Kontroll (qabel "Ċentru ta 'Kontroll Netrounds"), għalkemm l-isem jiġri li jibda b' "ncc".
Hawn hu kif tinstalla ncclient:

Niżżel is-softwer minn https://github.com/ncclient/ncclient.
Mexxi dan il-kmand: pip install ncclient

Issa nistgħu nwettqu s-sinkronizzazzjoni kif ġej. Innota bir-reqqa li dan jeħtieġ li jsir fuq kompjuter separat, u mhux fuq is-server taċ-Ċentru tal-Kontroll innifsu:

#
# NOTA:
# Dan l-iskript jaġixxi bħala klijent lejn ConfD li jaħdem fuq is-server NCC.
# Se juża l-API NETCONF/YANG għall-komunikazzjoni.

NOTA: Din il-proċedura hija meħtieġa wkoll kull meta Aġenti tat-Test ikunu ġew installati u rreġistrati indipendentement minn NETCONF. Ara n-nota fit-taqsima “Fuqview tal-Orkestrazzjoni tal-Aġent tat-Test” f’paġna 17 għal aktar informazzjoni.

Twaqqif ta' Kontijiet ta' Assigurazzjoni Attiva Paragon ikkontrollati minn NETCONF multipli

Il-passi hawn taħt huma meħtieġa biss jekk tixtieq twaqqaf aktar kontijiet ta’ Paragon Active Assurance biex jiġu kkontrollati minn NETCONF, minbarra l-kont konfigurat b’dan il-mod fil-Gwida ta’ Installazzjoni, taqsima “Installazzjoni ta’ ConfD”.
Għal kull kont bħal dan, ipproċedi kif ġej:

Fiċ-Ċentru tal-Kontroll, idħol fil-kont u naviga għal Kont > Permessi.

Żid l-utent "confd@netrounds.com", u agħti lil dan il-permess tal-amministratur tal-utent tal-ConfD fil-GUI billi tikklikkja l-buttuna Jistieden.
Issinkronizza d-database tal-konfigurazzjoni maċ-Ċentru tal-Kontroll kif deskritt fit-taqsima “Is-sinkronizzazzjoni tad-database tal-konfigurazzjoni maċ-Ċentru tal-Kontroll” f’paġna 4.
Issa għandek tkun tista' tikkontrolla kontijiet multipli ta' Paragon Active Assurance mal-istess utent tal-ConfD.

NOTA: Ladarba tibda tikkontrolla kont ta' Paragon Active Assurance permezz ta' ConfD, GĦANDEKX tagħmel bidliet f'dan il-kont permezz tal- web GUI fir-rigward ta’ kwalunkwe karatteristika ta’ Paragon Active Assurance li hija “konfigurata” (ara l-kapitolu “Faratteristiċi Sapportjati f’Paragon Active Assurance” f’paġna 9). Jekk tagħmel hekk, tirriżulta telf tas-sinkronizzazzjoni.

Introduzzjoni għal NETCONF Orchestration API

Fuqview

NFVO ta' parti terza jew orkestratur tas-servizz huwa tipikament il-komponent li jibda sessjonijiet ta' test u monitoraġġ bl-użu tal-API taċ-Ċentru tal-Kontroll. Dan l-orkestratur jirkupra wkoll ir-riżultati tal-kejl aggregati mill-attivitajiet tal-Aġent tat-Test. Il-KPIs tal-Prestazzjoni jistgħu jiġu rkuprati minn Sistemi ta’ Ġestjoni tal-Prestazzjoni ta’ partijiet terzi, filwaqt li l-avvenimenti – ladarba jiġu attivati minn ksur tal-limitu stabbilit fiċ-Ċentru ta’ Kontroll – jistgħu jintbagħtu lil sistemi ta’ Ġestjoni ta’ Ħsara ta’ partijiet terzi.
Fil-qosor, il-figura hawn taħt turi kif Paragon Active Assurance jinteraġixxi ma 'sistemi oħra ta' partijiet terzi fil-pajsaġġ OSS.

NFVO/Orkestratur tas-Servizz: Jagħti istruzzjonijiet lill-Maniġer tal-VNF biex juża l-vTAs u jikkonfigura Paragon Active Assurance fil-katina tas-servizz. Ladarba s-servizz ikun ġie attivat, l-orkestratur juża l-API lejn iċ-Ċentru tal-Kontroll biex jagħti bidu għal testijiet ta’ attivazzjoni tas-servizz u jirkupra r-riżultati li jgħaddu/falli. Jekk it-testijiet jgħaddu, l-orkestratur juża l-API lejn iċ-Ċentru tal-Kontroll biex jibda l-monitoraġġ attiv tas-servizz. KPIs mill-monitoraġġ jiġu rkuprati kontinwament jew mill-orkestratur jew minn pjattaforma separata tal-Ġestjoni tal-Prestazzjoni.
Ċentru ta 'Kontroll: Jiskjera, tiskala, u jtemm il-vTA kif ordnat mill-NFVO jew l-orkestratur tas-servizz.

Sistema ta 'Ġestjoni tal-Prestazzjoni jew sistema ta' Ġestjoni tal-Kwalità tas-Servizz: Taqra KPIs minn monitoraġġ attiv permezz tal-API taċ-Ċentru ta 'Kontroll.
Sistema ta’ Ġestjoni tal-Ħsara: Jirċievi notifiki ta’ NETCONF, SNMP, jew email miċ-Ċentru ta’ Kontroll jekk jinkisru l-SLAs.

Definizzjonijiet ta' Kunċetti f'Assigurazzjoni Attiva Paragon

Aġenti tat-Test: Il-komponenti li jwettqu kejl (għal testijiet kif ukoll moniters) f'sistema ta' Assigurazzjoni Attiva ta' Paragon. L-Aġenti tat-Test jikkonsistu f'softwer bil-kapaċità li jiġġeneraw, jirċievu u janalizzaw it-traffiku tan-netwerk reali.
It-tip ta 'Aġent tat-Test diskuss f'dan id-dokument huwa l-Aġent tat-Test Virtwali (vTA), funzjoni ta' netwerk virtwali (VNF) skjerata fuq hypervisor. Jeżistu wkoll tipi oħra ta 'Aġent tat-Test.

Hemm żewġ tipi bażiċi ta 'kejl f'Paragon Active Assurance, testijiet u monitors.
Test: Test jikkonsisti f'pass wieħed jew diversi, li kull wieħed minnhom għandu tul ta' żmien finit speċifikat. Il-passi huma esegwiti b'mod sekwenzjali. Kull pass jista' jinvolvi t-tmexxija ta' kompiti multipli fl-istess ħin.

Monitor: Monitor m'għandux tul ta' żmien speċifikat iżda jesegwixxi b'mod indefinit. Bħal pass f'test, monitor jista' jesegwixxi diversi kompiti konkorrenti.
Mudell: Meta Paragon Active Assurance tkun ikkontrollata minn orkestratur, it-testijiet u l-monitors dejjem isiru permezz ta' mudelli li fihom it-test jew il-monitor huwa definit. Is-settings tal-parametri jistgħu jiġu mgħoddija bħala inputs għall-mudell waqt ir-runtime.

Fluss tax-xogħol għall-Awtomazzjoni
Ħin tad-Disinn

Fiż-żmien tad-disinn, inti tipprepara l-kejl billi toħloq mudelli għal testijiet u monitors f'Paragon Active Assurance. Kif tagħmel dan huwa kopert fil-kapitolu “Test u Mudelli ta’ Monitoraġġ” f’paġna 15.

Runtime
Fil-ħin tar-runtime, inti twaqqaf it-tagħmir tiegħek u twettaq il-kejl attwali.

An fuqview ta' kull examples mogħtija tinsab fil-kapitlu “Eżamples ta’ Kontroll ta’ Paragon Active Assurance permezz ta’ NETCONF & YANG API” f’paġna 15.
Kif jiġu skjerati u kkonfigurati l-Aġenti tat-Test huwa għaddej fil-kapitolu “Eżamples: Aġenti tat-Test” f’paġna 16.

Kif timporta oġġetti tal-inventarju bħal TWAMP rifletturi u kanali IPTV huwa għadda minnu fil-kapitolu “Eżamples: Oġġetti tal-Inventarju” f’paġna 29.
Kif tikkonfigura l-allarmi huwa spjegat fil-kapitolu “Eżamples: Allarmi” f’paġna 35.

Kif tmexxi testijiet u monitors billi tesegwixxi mudelli ta’ Assigurazzjoni Attiva ta’ Paragon permezz ta’ NETCONF hija deskritta fil-kapitoli “Eżamples: Testijiet” f’paġna 43 u “Eżamples: Monituri” f’paġna 54.

Karatteristiċi appoġġjati f'Paragon Active Assurance

It-tipi kollha tat-test u l-monitor f’Paragon Active Assurance jistgħu jinħolqu u jiġu esegwiti permezz tal-użu ta’ mudelli. Kif tagħmel dan huwa kopert fl-għajnuna fl-app taħt "Testijiet u monitors" > "Ħolqien ta 'mudelli".

Il-ħolqien ta' kontijiet ta' Paragon Active Assurance bħalissa mhux appoġġjat; madankollu, kont wieħed jew diversi kontijiet predefiniti jkunu ġew stabbiliti għall-utent.
It-tabelli hawn taħt jiddettaljaw liema karatteristiċi f'Paragon Active Assurance huma disponibbli f'dan ir-rilaxx, u kif dawn il-karatteristiċi huma rappreżentati f'YANG.

Spjegazzjoni ta 'YANG Constructs

Għall-konvenjenza, hawn huma mogħtija definizzjonijiet tal-kostruzzjonijiet YANG imsemmija fit-tabella tal-karatteristiċi.

Konfigurazzjoni (config=true): Data tal-konfigurazzjoni, meħtieġa biex tittrasforma sistema minn stat għal ieħor.
Stat (konfigurazzjoni=falza): dejta tal-istat: dejta addizzjonali fuq sistema li mhix dejta tal-konfigurazzjoni, bħal informazzjoni dwar l-istatus li tinqara biss u statistika miġbura.
RPC: Sejħa ta' Proċedura Remota, kif użata fi ħdan il-protokoll NETCONF.
Notifika: Notifiki tal-avvenimenti mibgħuta minn server NETCONF lil klijent NETCONF.

Tabelli ta' Karatteristiċi ta' Assigurazzjoni Attiva ta' Paragon Disponibbli għall-Orkestrazzjoni
Riżors: Monitoraġġ
YANG path:/accounts/account/monitors

Karatteristika	Subkaratteristika	jibni YANG
Oħloq / timmodifika / ħassar monitor	Ibbażat fuq il-mudell tal-moniter	Konfigurazzjoni
Start/stop monitor	–	Konfigurazzjoni
Tissorvelja mudelli	Elenka mudelli ta' moniter eżistenti b'inputs	Stat
notifiki NETCONF	L-istat ta' l-allarm inbidel	Notifika
Tissorvelja r-riżultati	SLA/ES counter għall-ogħla livell (%) SLA/ES counter għal-livell ta' kompitu (%)	Stat

B'differenza mit-testijiet (qabbel Riżorsi: Testijiet hawn taħt), il-monitors ma jinbdewx b'RPC iżda pjuttost billi tikkommetti l-konfigurazzjoni tal-monitor.
Riżors: Testijiet
Mogħdija YANG: /accounts/account/tests

Karatteristika	Subkaratteristika	jibni YANG
Ibda t-test	Ibbażat fuq il-mudell tat-test	RPC
Immaniġġja t-testijiet	Lista testijiet bl-istatus	Stat
Mudelli tat-test	Elenka mudelli eżistenti tat-test bl-inputs	Stat
notifiki NETCONF	L-istatus tat-test inbidel	Notifika
Riżultati tat-test	Ikseb l-istatus tal-pass tat-test (jgħaddi, ifalli, żball, ...)	Stat

Riżors: Aġenti tat-Test
mogħdijiet YANG:

/accounts/account/test-agents (Konfigurazzjoni)
/accounts/account/registered-test-agents (Stat)

Aġenti tat-test taħt /accounts/account/test-agents huma dawk li huma konfigurati f'kont. Dawn l-Aġenti tat-Test biss jistgħu jiġu kkonfigurati u użati fit-testijiet u l-moniters permezz ta' NETCONF mill-orkestratur.
Wara li tkun ikkonfigurajt Aġent tat-Test u jkun irreġistra mal-kont, l-Aġent tat-Test se jidher taħt /accounts/account/registered-test-agents. Tista’ ssib l-Aġenti tat-Test irreġistrati kollha billi tuża kmand “get” f’NETCONF (qabbel il-kapitolu Examples: Aġenti tat-Test).
Taħt /accounts/account/registered-test-agents tista' ssib ukoll Aġenti tat-Test li għadhom ma ġewx konfigurati. Kwalunkwe Aġenti tat-Test bħal dawn għandhom jiġu kkonfigurati qabel ma jkunu jistgħu jintużaw.
F'xenarju ta' orkestrazzjoni, huwa ġeneralment rakkomandat li tagħmel il-konfigurazzjoni kollha tal-kont tiegħek ta' Paragon Active Assurance permezz ta' NETCONF. Dan jiżgura li l-aġenti tat-test u l-aġenti tat-test reġistrati ma jvarjawx.

Karatteristika	Subkaratteristika	jibni YANG
Oħloq minn qabel l-Aġent tat-Test fuq is-server	–	Konfigurazzjoni
Ikkonfigura l-aġent tat-test offline	(Iċ-Ċentru ta' Kontroll imbotta l-konfigurazzjoni lill-Aġent tat-Test meta tiġi online)	Konfigurazzjoni
Uża Aġenti tat-Test eżistenti/konfigurati esternament	Uża fit-test/monitor	Konfigurazzjoni
	Ikkonfigura interfaces	Konfigurazzjoni
	Ikseb l-istatus	Stat
Ikkonfigura l-Aġent tat-Test (Appliance tat-Test biss)	Ikkonfigura NTP	Konfigurazzjoni
	Ikkonfigura pontijiet	Konfigurazzjoni
	Ikkonfigura l-interfaces tal-VLAN	Konfigurazzjoni
	Ikkonfigura ċwievet SSH	Konfigurazzjoni
	IPv6	Konfigurazzjoni
Utils	Reboot	RPC
	Aġġornament	RPC
notifiki NETCONF	L-istatus onlajn inbidel	Notifika
Status	Ikseb l-istatus tas-sistema (uptime, użu tal-memorja, medja tat-tagħbija, verżjoni)	Stat

Riżorsa: Inventarju
Mogħdija YANG: /accounts/account/twamp-rifletturi

Kapaċitajiet NETCONF appoġġjati

It-tabella hawn taħt tindika l-RFCs tal-IETF li jiddeskrivu l-kapaċitajiet NETCONF użati għall-iskop tal-orkestrazzjoni tal-Assigurazzjoni Attiva Paragon.

ietf-netconf.yang
IETF RFC 6241, Protokoll ta' Konfigurazzjoni tan-Netwerk (NETCONF), https://tools.ietf.org/html/rfc6241
L-uniku metodu appoġġjat għall-immaniġġjar tal-iżbalji huwa rollback-on-error.
L-uniku maħżen tad-data appoġġjat huwa writable-running.
ietf-netconf-notifications.yang
IETF RFC 5277, Notifiki ta' Avvenimenti NETCONF, https://tools.ietf.org/html/rfc5277

Test u Mudelli Monitor
Il-mudelli għat-tipi tat-test u l-monitor jeħtieġ li jiġu stabbiliti manwalment permezz tal-interface tal-utent front-end Paragon Active Assurance. Kif tagħmel dan huwa kopert fl-għajnuna fl-app taħt "Testijiet u monitors" > "Ħolqien ta 'mudelli".

Examples ta' Kontroll ta' Paragon Active Assurance permezz ta' NETCONF & YANG API

Fil-kapitoli li ġejjin, huwa preżunt li mudelli xierqa tat-test u tal-monitor ġew definiti skont l-istruzzjonijiet mogħtija fil-kapitolu “Test u Mudelli tal-Monitoraġġ” f’paġna 15.

Għodod Użati f'Eżamples
L-ex kollhaamples fil-kapitoli sussegwenti nbnew bl-użu tal-għodod disponibbli liberament li ġejjin:

Pang: Użat biex Ħares u jibbrawżjaw il-mudelli YANG.
Disponibbli fuq https://github.com/mbj4668/pyang (klonu minn git u mexxi python setup.py install).
Klijent Python NETCONF “ncclient”: Użat biex jikkomunika maċ-Ċentru ta’ Kontroll bl-użu ta’ NETCONF.

Disponibbli fuq https://github.com/ncclient/ncclient (run pip install ncclient).
Il-mudell tad-dejta netrounds-ncc.yang jinstab f'/opt/netrounds-confd ladarba l-ConfD ikun ġie installat skont il-Gwida tal-Installazzjoni).

Fuqview tal-Kompiti Ewlenin imwettqa

(Xi kompiti oħra huma wkoll eżemplati f'dak li ġej.)

“Ħolqien u skjerament ta’ Aġent tat-Test ġdid” f’paġna 16
“Ħolqien ta’ oġġetti ta’ inventarju (eż. rifletturi)” f’paġna 29
“Twaqqif ta’ mudelli ta’ allarm u fejn tibgħat l-allarmi” f’paġna 35

“Ħolqien u tħaddim ta’ test” f’paġna 45
“L-irkupru tar-riżultati tat-test” f’paġna 50
“Bidu ta’ monitor (jinkludi s-setup ta’ allarmi)” f’paġna 60
“L-irkuprar tal-istatus SLA għal monitor” f’paġna 67
“Ħidma ma’ tags” f’paġna 71

Examples: Aġenti tat-Test

Fuqview tal-Orkestrazzjoni tal-Aġent tat-Test
L-Aġenti tat-Test f'Paragon Active Assurance jitqiesu bħala "konfigurazzjoni" fil-kuntest tal-orkestrazzjoni. Dan ifisser li l-ħolqien, il-kontroll u t-tħassir tal-Aġenti tat-Test għandhom isiru permezz tal-orkestratur u NETCONF aktar milli permezz tal-GUI tal-Assigurazzjoni Attiva Paragon.
IMPORTANTI: Jekk Aġent tat-Test jiġi installat minn tekniku u reġistrat maċ-Ċentru tal-Kontroll mingħajr ma l-ewwel inħoloq permezz tan-NETCONF & YANG API, l-Aġent tat-Test mhux se jeżisti fid-database tal-konfigurazzjoni, u s-sistema toħroġ mis-sinkronizzazzjoni. Biex il-ConfD isir konxju tal-Aġent tat-Test f'dan il-każ, ikun meħtieġ li twettaq sinkronizzazzjoni ġdida maċ-Ċentru tal-Kontroll, kif iddettaljat fit-taqsima "Is-sinkronizzazzjoni tad-Database tal-Konfigurazzjoni maċ-Ċentru tal-Kontroll" f'paġna 4.

L-orkestrazzjoni tal-Aġenti tat-Test Virtwali (vTAs) għandha għalhekk issir fil-passi li ġejjin:

Oħloq l-Aġent tat-Test Virtwali, inkluża l-konfigurazzjoni tal-interface tiegħu, billi tuża l-interface NETCONF & YANG għaċ-Ċentru tal-Kontroll. L-isem tal-Aġent tat-Test se jkun iċ-ċavetta unika tiegħu.
Uża l-vTA fuq pjattaforma tal-virtwalizzazzjoni. Segwi l-istruzzjonijiet fl-għajnuna onlajn taħt Aġenti tat-Test > Installazzjoni. Il-konfigurazzjoni bażika tal-interface li tippermetti lill-vTA tikkonnettja maċ-Ċentru tal-Kontroll, kif ukoll kredenzjali għall-awtentikazzjoni, hija pprovduta fil-vTA bl-użu tad-dejta tal-utent cloud-init.
Ladarba l-vTA ikun booted, awtomatikament se jgħaqqad maċ-Ċentru ta 'Kontroll permezz ta' konnessjoni encrypted OpenVPN. Tintbagħat notifika NETCONF peress li l-valur tal-parametru tat-test-agent-statuschange tal-vTA issa nbidel għal "online".
NOTA: Peress li l-isem tal-vTA huwa l-identifikatur tiegħu fiċ-Ċentru tal-Kontroll, dan l-isem għandu jkun l-istess bħal dak definit fiċ-Ċentru tal-Kontroll fil-“pass 1” f’paġna 17.
Ladarba l-vTA tkun konnessa u awtentikata maċ-Ċentru tal-Kontroll, il-konfigurazzjoni tal-interface tiġi mbuttata lejn il-vTA. Din hija l-konfigurazzjoni tal-interface pprovduta fil-“pass 1” f’paġna 17 meta l-vTA inħoloq fiċ-Ċentru ta’ Kontroll.

Wara li l-vTA tkun serva l-iskop tagħha, ħassar il-vTA.

Ħolqien u Skjerament ta' Aġent tat-Test Ġdid

L-ewwel għandna bżonn noħolqu Aġent tat-Test billi tuża l-interface NETCONF & YANG għaċ-Ċentru tal-Kontroll. Meta Aġent tat-Test jinħoloq b'dan il-mod, ma tkun meħtieġa l-ebda sinkronizzazzjoni maċ-Ċentru tal-Kontroll.
Il-mudell YANG għal Aġent tat-Test huwa kif muri hawn taħt. Huwa miksub bħala output mill-kmand
pyang -f tree netrounds-ncc.yang
Il-mudell YANG sħiħ huwa mogħti fl-"Appendiċi: Struttura tas-Siġra tal-Mudell Sħiħ YANG" f'paġna 81, li fiha wkoll leġġenda li tispjega l-konvenzjonijiet użati f'dan il-mudell YANG u l-illustrazzjonijiet l-oħra fid-dokument preżenti.

Nipproċedu fil-passi li ġejjin, li huma dettaljati f'dan li ġej:

Fil-bidu, il-kont ta' Paragon Active Assurance "demo" m'għandux Aġenti tat-Test fl-inventarju tiegħu.
Aġent tat-Test imsejjaħ "vta1" jinħoloq bl-użu ta 'ncclient. Fuq dan stage, għadu ma jeżisti l-ebda Aġent tat-Test reali (jiġifieri għadu ma nbediex).
L-Aġent tat-Test huwa skjerat f'OpenStack. (L-iskjerament fuq dik il-pjattaforma huwa magħżul hawnhekk bħala possibbiltà waħda fost l-oħrajn.)

L-Aġent tat-Test jgħaqqad mal-kont taċ-Ċentru tal-Kontroll "demo" u issa huwa lest għall-użu.
Pass 1: Fil-bidu, m'hemm l-ebda Aġenti tat-Test fil-kont "demo". Ara l-screenshot hawn taħt mill-GUI taċ-Ċentru tal-Kontroll.Pass 2: Aġent tat-Test jinħoloq fiċ-Ċentru tal-Kontroll bl-użu tal-klijent Python NETCONF "ncclient". Hawn taħt hemm il-kodiċi ncclient biex jinħoloq Aġent tat-Test li għandu interface fiżiku wieħed b'indirizz DHCP:

importazzjoni argparse
mill-maniġer tal-importazzjoni ncclient
parser = argparse.ArgumentParser(description='Test li joħloq l-Aġent tat-Test')
parser.add_argument('–host', help='L-isem tal-host fejn jinstab il-ConfD', meħtieġ=Veru)
parser.add_argument('–port', help='Il-port għall-konnessjoni ma' ConfD', meħtieġ=Veru)
parser.add_argument('–username', help='L-isem tal-utent biex tikkonnettja ma' ConfD', meħtieġ=Veru)
parser.add_argument('–password', help='Password għall-kont ConfD', required=Veru)
parser.add_argument('–netrounds-account', help='L-isem qasir tal-kont NCC', meħtieġ=Veru)
parser.add_argument('–test-agent-name', help='Isem tal-Aġent tat-Test', meħtieġ=Veru)
args = parser.parse_args ()
ma’ manager.connect(host=args.host, port=args.port, username=args.username,
password=args.password, hostkey_verify=Falza) bħala m:
# Oħloq Aġent tat-Test fiċ-Ċentru tal-Kontroll
xml = """

)print m.edit_config(target='running', config=xml)

NOTA: Il-kodiċi ta’ qabel ma’ manager.connect(…) jitħalla barra mill-eżample snippets tal-kodiċi.
Server NTP huwa kkonfigurat fuq eth0, u eth0 huwa wkoll l-interface ta 'ġestjoni (jiġifieri, l-interface li jgħaqqad ma' Control Center).
Applikazzjoni tal-Aġent tat-Test bħalissa ma tippermettix il-konfigurazzjoni tal-interfaces. Għal din ir-raġuni, mill-verżjoni 2.34.0 'il quddiem, huwa possibbli li titħalla barra l-konfigurazzjoni tal-interface fl-iskema YANG. L-XML korrispondenti huwa għalhekk issimplifikat radikalment f'dan il-każ:Ladarba l-Aġent tat-Test ikun inħoloq, jeżisti fid-database tal-konfigurazzjoni u fiċ-Ċentru tal-Kontroll. Ara l-screenshot hawn taħt tal-inventarju tal-Aġent tat-Test, li turi l-Aġent tat-Test “vta1”:

Pass 3: Issa wasal iż-żmien li tuża l-Aġent tat-Test "vta1" f'OpenStack.
L-Aġent tat-Test se juża data tal-utent cloud-init biex jirkupra l-informazzjoni dwar kif tikkonnettja maċ-Ċentru tal-Kontroll. Speċifikament, it-test tad-dejta tal-utent file għandu l-kontenut li ġej (Innota li l-linji #cloud-config u netrounds_test_agent għandhom ikunu preżenti, u li l-linji li jifdal għandhom ikunu indentati):

Għal aktar informazzjoni, jekk jogħġbok irreferi għad-dokument Kif Tiskjera Aġenti tat-Test Virtwali f'OpenStack.
Ladarba l-Aġent tat-Test ikun ġie skjerat u jkun ikkonnettjat maċ-Ċentru tal-Kontroll, il-konfigurazzjoni tiġi mbuttata miċ-Ċentru tal-Kontroll għall-Aġent tat-Test.

Pass 4: L-Aġent tat-Test issa jinsab onlajn fiċ-Ċentru tal-Kontroll u kiseb il-konfigurazzjoni tiegħu. L-Aġent tat-Test huwa lest għall-użu fit-testijiet u l-monitoraġġ. Ara dawn it-taqsimiet:

“Bidu ta’ Test” f’paġna 45
“Bidu ta’ Monitor” f’paġna 60

Elenkar tal-Aġenti tat-Test fil-Kont ta' Assigurazzjoni Attiva Tiegħek ta' Paragon
Hawn taħt hawn example ncclient Python code għall-elenkar tal-Aġenti tat-Test f'kont ta' Paragon Active Assurance:

It-tħaddim ta' dan il-kodiċi jagħti output bħal dak hawn taħt:

Tħassir ta' Aġent tat-Test
Wara li jitlesta test, jista' jkun rilevanti f'xi każijiet ta' użu li tħassar l-Aġent tat-Test.
Hawn taħt hemm snippet tal-kodiċi li turi kif tagħmel dan b'ncclient:

Notifiki NETCONF
Hawn taħt, nippreżentaw ex sempliċiample script għas-smigħ tan-notifiki kollha NETCONF deħlin miċ-Ċentru tal-Kontroll. Dawn in-notifiki jintbagħtu kull meta jseħħu ċerti avvenimenti, bħal aġent tat-test li jmur offline jew test mibdi mill-utent jitlesta. Ibbażat fuq l-informazzjoni li tinġarr fin-notifiki, l-utenti jistgħu jassenjaw azzjonijiet ta' segwitu awtomatizzati fl-orkestratur.

Meta l-iskrittura ta 'hawn fuq tiġi esegwita, il-klijent NC jippreżenta n-notifika riċevuta f'XML strutturat. Ara l-exampoutput tal-le hawn taħt, li juri aġent tat-test sejjer offline bla mistenni.

2017-02-03T15:09:55.939156+00:00</eventTime>
<test-agent-status-change xmlns=’http://ncc.netrounds.com'>
demo
HW1
offline

Examples: Oġġetti tal-Inventarju

Ħolqien (importazzjoni) u ġestjoni ta 'oġġetti ta' inventarju bħal TWAMP rifletturi u Y.1731 MEPs isir b'mod simili bħal għall-Aġenti tat-Test. Hawn taħt hemm kodiċi XML u NETCONF għad-definizzjoni ta' entitajiet bħal dawn f'Paragon Active Assurance permezz tan-NETCONF & YANG API u għall-irkupru tal-listi tal-oġġetti definiti.

Ħolqien ta 'TWAMP Riflettur

Il-ħolqien ta' MEP Y.1731

Ħolqien ta 'Kanal IPTV

Ħolqien ta 'Ospitanti Ping

Ħolqien ta' Kont SIP

Irkuprar Oġġetti tal-Inventarju
Hawn taħt hemm il-kodiċi Python għall-irkupru tal-oġġetti kollha tal-inventarju definiti f'kont. (It-tipi kollha ta' oġġetti tal-inventarju jinġabru f'daqqa hawn sabiex tiġi evitata xi ripetizzjoni fid-dokument. Naturalment, kwalunkwe subsett ta' oġġetti tal-inventarju jista' jinġieb billi jitħallew barra xi wħud mil-linji taħt kont hawn taħt.)

It-tħaddim ta' dan il-kodiċi jagħti output bħal dak hawn taħt:

Examples: Allarmi

Mudelli ta 'allarm u oġġetti assoċjati (maniġers SNMP, listi ta' email ta 'allarm) huma maħluqa u ġestiti b'mod simili bħal oġġetti ta' inventarju. Dan il-kapitolu fih kodiċi XML u NETCONF għad-definizzjoni ta' entitajiet bħal dawn f'Paragon Active Assurance permezz tan-NETCONF & YANG API u għall-irkupru tal-listi tal-oġġetti definiti.
Listi ta' Email ta' Allarm
Ħolqien ta 'Lista ta' Email ta' Allarm

Irkuprar tal-Listi Kollha tal-Emails tal-Allarm

Maniġers SNMP
Ħolqien ta' Maniġer SNMP

L-irkupru tal-Maniġers SNMP kollha

Mudelli ta 'allarm
Ħolqien ta 'Mudell ta' Allarm

L-irkuprar tal-Mudelli kollha tal-allarm

Examples: SSH Keys

Tista 'żżid ċwievet pubbliċi SSH ma' Aġent tat-Test permezz tan-NETCONF & YANG API. Billi tuża ċ-ċavetta privata korrispondenti tista' mbagħad tidħol fl-Aġent tat-Test permezz ta' SSH.
Il-lista sħiħa tal-operazzjonijiet disponibbli fuq iċ-ċwievet SSH hija kif ġej:

Żid ċavetta SSH
Immodifika ċavetta SSH
Spezzjona ċavetta SSH
Elenka ċwievet SSH
Ħassar ċavetta SSH.
Hawn taħt, l-operazzjonijiet ta 'żieda u tħassir huma eżemplati.

Żieda ta 'SSH Key

Hawn hu kif toħloq ċavetta SSH ġdida.

Juniper NETWORKS NETCONF & YANG API Software - Ewlenin

Tħassir ta' SSH Key
Jekk trid tħassar ċavetta SSH, uża l-kmand li ġej:

Examples: Testijiet

Huwa preżunt hawnhekk li l-Aġenti tat-Test (kemm huma meħtieġa għat-testijiet) inħolqu skont it-taqsima “Ħolqien u Skjerament ta’ Aġent tat-Test Ġdid” f’paġna 17.
YANG Mudell Mogħdijiet għat-Testijiet

Oġġett	Mogħdija tal-mudell YANG: /accounts/account/tests...
testijiet	/.
test[id]	/test
id	/test/id
isem	/test/isem
status	/test/status
ħin tal-bidu	/test/ħin tal-bidu
il-ħin tat-tmiem	/test/ħin tat-tmiem
rapport-url	/test/rapport-url
passi	/test/passi
pass[id]	/test/passi/pass
isem	/test/passi/pass/isem
id	/test/passi/pass/id
ħin tal-bidu	/test/passi/pass/ħin tal-bidu
il-ħin tat-tmiem	/test/passi/pass/ħin tat-tmiem
status	/test/passi/pass/istatus
messaġġ-istatus	/test/passi/pass/messaġġ-istatus
mudelli	/templates
mudell[isem]	/templates/template
isem	/templates/template/isem
deskrizzjoni	/templates/template/deskrizzjoni
parametri	/templates/template/parametri
parametru[ċavetta]	/templates/template/parameters/parameter
ċavetta	/templates/template/parameters/parameter/key
tip	/templates/template/parameters/parameter/type

Prerekwiżiti għall-Orkestrazzjoni tat-Test

Sabiex tibda test permezz ta 'NETCONF bl-użu ta' klijent NC, huwa meħtieġ li l-ewwel jinbena mudell ta 'test billi tuża l-GUI taċ-Ċentru ta' Kontroll kif iddettaljat fl-għajnuna fl-app taħt "Testijiet u monitors" > "Ħolqien ta 'mudelli". L-oqsma kollha speċifikati f'dak il-mudell bħala "Template input" se jkunu meħtieġa bħala parametri fl-XML meta jiġi orkestrat il-bidu tal-mudell tat-test.

It-tmexxija tat-testijiet f'Paragon Active Assurance hija meqjusa bħala "stat" fil-kuntest tal-orkestrazzjoni. Id-dejta tal-istat hija dejta li ma tistax tinkiteb li mhix maħżuna fid-dejtabejż tal-konfigurazzjoni, għall-kuntrarju tad-dejta tal-konfigurazzjoni msemmija fit-taqsima “Fuqview tal-Orkestrazzjoni tal-Aġent tat-Test” f’paġna 17. Dan bażikament ifisser li l-bidliet fit-testijiet jew il-mudelli fil-GUI taċ-Ċentru tal-Kontroll ma jikkawżawx kwistjonijiet relatati mas-sinkronizzazzjoni bejn iċ-Ċentru tal-Kontroll u d-database tal-konfigurazzjoni.
Biex tikseb rapport-URL dritt fir-rapporti tat-test, trid tiżgura li ċ-Ċentru ta 'Kontroll URL huwa kkonfigurat korrettament. Dan isir fil- file /opt/netrounds-confd/settings.py. B'mod awtomatiku l-isem tal-host taċ-Ċentru tal-Kontroll jiġi rkuprat billi tuża socket.gethostname(): ara hawn taħt. Jekk dan ma jagħtix ir-riżultat korrett, għandek bżonn issettja l-isem tal-ospitant (jew l-isem kollu URL) manwalment f'dan file.

# URL taċ-Ċentru tal-Kontroll mingħajr trailing slash.
# Dan huwa għal example użata fir-rapport tat-test-url.
HOSTNAME = socket.gethostname ()
NETROUNDS_URL = 'https://%s' % HOSTNAME
Bidu ta' Test
Kif deskritt fit-taqsima “Ħolqien u Skjerament ta’ Aġent tat-Test Ġdid” f’paġna 17, ħaddem il-kmand pang -f tree netrounds-ncc.yang
mid-direttorju /opt/netrounds-confd/ sabiex joħroġ il-mudell YANG. F'dan il-mudell, l-RPC biex jinbeda test bl-użu ta 'klijent NC jidher kif ġej:

Għal spjegazzjonijiet, ara t-taqsima “Leġġenda” f’paġna 81 fl-Appendiċi.

Il-passi li ġejjin huma murija hawn taħt:

L-Aġenti tat-Test ġew irreġistrati fil-kont ta' Paragon Active Assurance, iżda għadhom ma nbdew l-ebda test.
Il-parametri tal-input meħtieġa huma identifikati fil-mudell tat-test li se jitħaddem.

Jinbeda test HTTP ta' 60 sekonda bl-użu ta' ncclient.

Pass 1: Fil-bidu, ma nbdew l-ebda testijiet fil-kont ta' Paragon Active Assurance. Ara l-screenshot hawn taħt mill-GUI taċ-Ċentru tal-Kontroll.
Pass 2: Il-mudell li se nużaw biex nibdew it-test f'dan l-eżample huwa mudell tat-test HTTP. Għandu żewġ oqsma ta' input obbligatorji (Klijenti u URL) li speċifikajna bħala tali meta nibnu l-mudell fil-GUI taċ-Ċentru tal-Kontroll.

Aħna ser niddefinixxu dawn il-parametri (fost oħrajn) fil-konfigurazzjoni XML ikkomunikata lid-database tal-konfigurazzjoni mill-maniġer NETCONF tagħna (ncclient).
Pass 3: It-test HTTP jinbeda bl-użu ta 'ncclient.
Hawn taħt hawn exampil-kodiċi fejn l-informazzjoni u l-parametri tal-konfigurazzjoni meħtieġa huma speċifikati għall-mudell tat-test HTTP. Skont kif inbniet il-mudell, id-dettalji hawn jistgħu jvarjaw.
Għal kull parametru, il- attribut jeħtieġ li jiġi fornut. Iċ-ċavetta hija identika għal dik tal-parametru
Isem varjabbli fiċ-Ċentru tal-Kontroll. Tista' tispezzjona l-ismijiet varjabbli kif ġej:

Ikklikkja Testijiet fuq il-bar tal-ġenb u agħżel New Test Sequence.

Ikklikkja My Templates.
Ikklikkja l-link Edit taħt il-mudell ta' interess.
Ikklikkja l-buttuna Edit input fir-rokna ta 'fuq tal-lemin.

Fl-ex tagħnaample, u b'mod awtomatiku, l-ismijiet varjabbli huma sempliċiment verżjonijiet żgħar tal-ismijiet tal-wiri li jidhru fiċ-Ċentru tal-Kontroll ("url" vs "URL”, eċċ.). Madankollu, fil-GUI taċ-Ċentru ta 'Kontroll, tista' tibdel l-isem tal-varjabbli għal dak li tixtieq.
Minbarra ċ-ċavetta, kull parametru jeħtieġ li jkollu t-tip tiegħu speċifikat: pereżempjuample, ghal URL.
Jekk jogħġbok innota li għandek bżonn terġa 'view il-mudell YANG komplut sabiex tinkiseb informazzjoni sħiħa dwar it-tipi. Għall-interfaces tal-Aġent tat-Test it-tip għandu struttura aktar kumplessa, kif jidher taħt fil-kodiċi hawn taħt.

Issa nistgħu nħaddmu l-iskript bl-użu ta 'ncclient. Jekk wieħed jassumi li kollox huwa korrett, it-test jinbeda u l-eżekuzzjoni tiegħu tintwera fiċ-Ċentru tal-Kontroll:Jekk it-test jinbeda b'suċċess, iċ-Ċentru ta' Kontroll jirrispondi bl-ID tat-test. F'dan example, l-ID tat-test huwa 3:L-ID tat-test tista 'tinstab ukoll fil- URL għat-test fil-GUI taċ-Ċentru tal-Kontroll. F'dan example, dak URL huwa https://host/demo/testing/3/.
Irkupru tar-Riżultati tat-Test
L-aktar mod sempliċi biex jiġu rkuprati r-riżultati tat-test huwa billi tipponta lejn l-ID tat-test.
Hawn taħt hemm il-kodiċi Python biex tikseb ir-riżultati mit-test HTTP ta 'hawn fuq b'ID = 3:
mal-maniġer. Qabbad(host=args.host, port=args.port, username=args.username,password=args.password, hostkey_verify=Falz) bħala m:

L-output se jidher xi ħaġa bħal din:

L-esportazzjoni u l-importazzjoni ta' mudelli tat-test
Il-mudelli tat-test jistgħu jiġu esportati f'format JSON u importati mill-ġdid f'dak il-format fiċ-Ċentru tal-Kontroll. Dan huwa utli jekk trid tuża mudelli tat-test f'installazzjoni differenti taċ-Ċentru tal-Kontroll. (Il-ħolqien inizjali tal-mudelli huwa mmaniġġjat bl-aħjar mod permezz tal-GUI taċ-Ċentru tal-Kontroll.)
Hawn taħt hemm il-kodiċi għat-twettiq tal-esportazzjoni u l-importazzjoni.
Esportazzjoni tat-Test Templates

# Ikseb il-konfigurazzjoni json mir-rispons
għerq = ET.fromstring(response._raw)
json_config = root[0].test
ipprintja json_config
Il-mudell jinsab fl-oġġett json_config.
Timporta Templates tat-Test
Oġġett tal-konfigurazzjoni JSON li jżomm mudelli tat-test jista 'jiġi importat mill-ġdid fiċ-Ċentru ta' Kontroll kif ġej.

Examples: Monituri

Din it-taqsima tassumi li l-Aġenti tat-Test (kemm huma meħtieġa mill-monitors) inħolqu skont it-taqsima “Ħolqien u Skjerament ta’ Aġent tat-Test Ġdid” f’paġna 17.
Mogħdijiet Mudell YANG għall-Moniters

Oġġett	Mogħdija tal-mudell YANG: /accounts/account/monitors...
moniters	/.
monitor[isem]	/monitora
isem	/monitor/isem
deskrizzjoni	/monitor/deskrizzjoni
beda	/monitora/beda
mudell	/monitor/template
allarm-konfigurazzjonijiet	/monitor/alarm-configs
Oġġett	Mogħdija tal-mudell YANG: /accounts/account/monitors/monitor/alarm-configs...
allarm-konfigurazzjoni[identifikatur]	/alarm-config
identifikatur	/alarm-config/identifier
mudell	/alarm-config/template
email	/alarm-config/email
snmp	/alarm-config/snmp
thr-es-kritika	/alarm-config/thr-es-critical
thr-es-kritika-ċar	/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-twissija	/alarm-config/thr-es-warning
thr-es-twissija-ċar	/alarm-config/thr-es-warning-clear
bla severità tad-data	/alarm-config/no-data-severity
no-data-timeout	/alarm-config/no-data-timeout
azzjoni	/alarm-config/action
id-daqs tat-tieqa	/alarm-config/window-size
intervall	/alarm-config/intervall
ibgħat-darba biss	/alarm-config/send-only-one
snmp-nassa-per-stream	/alarm-config/snmp-trap-per-stream
Oġġett	Mogħdija tal-mudell YANG: /accounts/account/monitors...
parametri	/monitor/parametri
Oġġett	Mogħdija tal-mudell YANG: /accounts/account/monitors/monitor/parameters...
parametru[ċavetta]	/parametru
ċavetta	/parametru/ċavetta
(tip ta' valur)	/parametru
:(numru sħiħ)	/parametru
numru sħiħ	/parametru/numru sħiħ
:(float)	/parametru
galleġġjant	/parametru/float
:(string)	/parametru
Oġġett	Mogħdija tal-mudell YANG: /accounts/account/monitors/monitor/parameters...
spag	/parametru/sekwenza
:(test-agent-interfaces)	/parametru
test-agent-interfaces	/parameter/test-agent-interfaces
test-agent-interface[“1” f’paġna 58	/parametru/test-agent-interfaces/
kont	/parameter/test-agent-interfaces/test-agent-interface/kont
aġent tat-test	/parameter/test-agent-interfaces/test-agent-interface/test-agent
interface	/parameter/test-agent-interfaces/test-agent-interface/interface
ip-verżjoni	/parameter/test-agent-interfaces/test-agent-interface/ip-version
:(twamp-rifletturi)	/parametru
twamp-rifletturi	/parametru/twamp-rifletturi
twamp-riflettur[isem]	/parametru/twamp-rifletturi/twamp-riflettur
isem	/parametru/twamp-rifletturi/twamp-riflettur/isem
:(y1731-meps)	/parametru
y1731-meps	/parametru/y1731-meps
y1731-mep[isem]	/parameter/y1731-meps/y1731-mep
isem	/parameter/y1731-meps/y1731-mep/name
:(sip-accounts)	/parametru
sip-kontijiet	/parametru/sip-accounts
sip-account[“2” f’paġna 58]	/parametru/sip-accounts/sip-account
kont	/parametru/sip-accounts/sip-account/kont
aġent tat-test	/parameter/sip-accounts/sip-account/test-agent
interface	/parameter/sip-accounts/sip-account/interface
sip-indirizz	/parametru/sip-accounts/sip-account/sip-indirizz
:(kanali-iptv)	/parametru
iptv-kanali	/parametru/iptv-channels
kanal-iptv[isem]	/parametru/iptv-channels/iptv-channel
isem	/parametru/iptv-channels/iptv-channel/isem

kont test-aġent interface
kont test-aġent interface sip-indirizz

Oġġett	Mogħdija tal-mudell YANG: /accounts/account/monitors...
status	/monitora/status
l-aħħar 15-il minuta	/monitor/status/aħħar-15-il minuta
status	/monitor/status/last-15-minutes/status
status-valur	/monitor/status/last-15-minutes/status-value
l-aħħar siegħa	/monitor/status/last-hour
status	/monitor/status/last-hour/status
status-valur	/monitor/status/last-hour/status-value
l-aħħar 24 siegħa	/monitor/status/last-24-hours
status	/monitor/status/last-24-hours/status
status-valur	/monitor/status/last-24-hours/status-value
mudelli	/templates
mudell[isem]	/templates/template
isem	/templates/template/isem
deskrizzjoni	/templates/template/deskrizzjoni
parametri	/templates/template/parametri
parametru[ċavetta]	/templates/template/parameters/parameter
ċavetta	/templates/template/parameters/parameter/key
tip	/templates/template/parameters/parameter/type

Prerekwiżiti għall-Orkestrazzjoni tal-Monitoraġġ
Qabel ma tkun tista’ tibda monitor permezz ta’ NETCONF billi tuża ncclient, trid tibni mudell ta’ monitor fil-GUI taċ-Ċentru ta’ Kontroll kif spjegat fl-għajnuna fl-app taħt “Testijiet u monitors” > “Ħolqien ta’ mudelli”. L-oqsma kollha speċifikati bħala "Template input" f'dak il-mudell se jkunu meħtieġa bħala parametri fl-XML meta jiġi orkestrat il-bidu tal-mudell.
Getting Input Parametri minn Monitor Templates
Hawn taħt, huma murija żewġ mudelli. L-ewwel huwa għall-monitoraġġ UDP bejn żewġ interfaces tal-Aġent tat-Test, u t-tieni huwa għall-HTTP bl-użu ta 'interface wieħed tal-Aġent tat-Test.
Biex issir taf il-parametri tad-dħul ta' mudell, ikklikkja l-kaxxa li tirrappreżenta l-mudell. Għall-mudell HTTP, il-parametri jistgħu jidhru bħal dan:

Għandna bżonn niddefinixxu dawn il-parametri fil-pass li jmiss meta nibdew monitor.
Bidu ta' Monitor
Billi nużaw l-Aġenti tat-Test li ddefinijna u skjerati fit-taqsima "Ħolqien u Skjerament ta' Aġent tat-Test Ġdid" f'paġna 17, nistgħu nibdew monitor mill-mudell "HTTP" kif muri hawn taħt.
Għal kull parametru, il- attribut jeħtieġ li jiġi fornut. Iċ-ċavetta hija identika għall-isem Varjabbli tal-parametru fiċ-Ċentru ta 'Kontroll. Tista' tispezzjona l-ismijiet varjabbli kif ġej:

Ikklikkja Monitoraġġ fuq il-bar tal-ġenb u agħżel New Monitor.

Ikklikkja My Templates.
Ikklikkja l-link Edit taħt il-mudell ta' interess.
Ikklikkja l-buttuna Edit input fir-rokna ta 'fuq tal-lemin.

Fl-ex tagħnaample, u b'mod awtomatiku, l-ismijiet varjabbli huma sempliċiment verżjonijiet żgħar tal-ismijiet tal-wiri li jidhru fiċ-Ċentru tal-Kontroll ("url" vs "URL”, eċċ.). Madankollu, fil-GUI taċ-Ċentru ta 'Kontroll, tista' tibdel l-isem tal-varjabbli għal dak li tixtieq.
Minbarra ċ-ċavetta, kull parametru jeħtieġ li jkollu t-tip tiegħu speċifikat: pereżempjuample, ghal URL. Jekk jogħġbok innota li informazzjoni sħiħa dwar it-tip ta 'parametru tinsab fil-mudell YANG. Għall-interfaces tal-Aġent tat-Test it-tip għandu struttura aktar kumplessa, kif jidher fil-kodiċi hawn taħt.
Fl-example li ġej, l-ebda allarm ma huwa assoċjat mal-monitor. Per examplejiet li jinvolvu allarmi, mur fit-taqsima “Bidu ta’ Monitor b’Allarm” f’paġna 62.

Bidu ta' Monitor b'Allarm
Biex tassoċja allarm ma 'monitor, tista' jew tipponta lejn mudell ta 'allarm li ġie definit, jew tista' tforni l-konfigurazzjoni kollha ta 'allarm meta toħloq il-monitor. Se nagħtu ex wieħedample ta 'kull approċċ hawn taħt.
Twaqqif ta' Allarm tal-Monitor billi tipponta lejn Mudell ta' Allarm
Sabiex tagħmel użu minn mudell ta 'allarm, trid tkun taf l-ID tiegħu. Għal dan il-għan, l-ewwel irkupra l-mudelli kollha tal-allarm tiegħek kif deskritt fit-taqsima “L-Irkupru tal-Mudelli kollha tal-allarm” f’paġna 39 u nnota l-isem tal-mudell rilevanti. Imbagħad tista' tirreferi għal dak il-mudell kif ġej:

Twaqqif ta' Allarm tal-Monitor billi tikkonfigurah Directly
Alternattivament, tista 'twaqqaf allarm għal monitor billi tipprovdi l-konfigurazzjoni kollha tiegħu meta toħloq il-monitor, mingħajr ma tirreferi għal mudell ta' allarm. Dan isir kif muri fl-eżample.

Irkupru ta 'Moniters Running
Biex tirkupra l-monitors kollha li bħalissa qed iwettqu, mexxi dan l-iskript:
mal-maniġer. connect(host=args.host, port=args.port, username=args. isem tal-utent, password=args.password, hostkey_verify=Falz) bħala m:

L-output huwa lista tal-moniters kollha li qed jaħdmu kif muri hawn taħt:

L-irkupru tal-Istatus tal-SLA għal Monitor
Hawn hu kif tirkupra l-istatus SLA għal monitor. F'dan example, qed nirkupraw l-istatus SLA għall-monitor "Kwalità tan-Netwerk" għal tliet intervalli ta 'żmien: l-aħħar 15-il minuta, l-aħħar siegħa, u l-aħħar 24 siegħa.

L-output se jidher xi ħaġa bħal din:

Notifiki NETCONF
Notifiki NETCONF għall-monitors huma attivati minn ksur SLA. Dawn iseħħu meta l-SLA għall-monitor jinżel taħt limitu SLA ("Tajjeb" jew "Aċċettabbli") f'tieqa ta' żmien partikolari, b'mod awtomatiku l-aħħar 15-il minuta. Għandu jiġi nnutat li n-notifiki ta 'ksur SLA jidhru malajr wara li servizz jiġi affettwat minn kwistjoni, filwaqt li l-istatus SLA jerġa' lura għal "Tajjeb" biss wara 15-il minuta, u biss jekk ma jseħħx aktar ksur.
It-tieqa tal-ħin tista' tinbidel billi teditja l-issettjar SLA_STATUS_WINDOW (valur f'sekondi) f' /etc/netrounds/netrounds.conf.
Jesportaw u jimportaw Mudelli tal-Monitoraġġ
Dan isir eżattament bl-istess mod bħal għall-mudelli tat-test; qabbel is-sezzjoni “L-esportazzjoni u l-importazzjoni ta’ mudelli tat-test” f’paġna 52. Is-snippets tal-kodiċi hawn taħt juru kif tesporta u timporta mudelli għall-moniters.
Jesportaw Mudelli tal-Monitoraġġ

L-importazzjoni ta' Templates tal-Monitor

Bl-użu Tags

Tags definit f'Paragon Active Assurance jista' jiġi applikat għal:

moniters
mudelli tal-monitor
Aġenti tat-Test
TWAMP rifletturi
Ping hosts.
Per example, tista' tag monitor bl-istess tag bħala subsett ta 'Aġenti tat-Test li se jmexxu l-monitor. Din il-karatteristika hija partikolarment utli jekk għandek numru kbir ta 'moniters u mudelli definiti.

Jekk waqqaft allarm b'nases SNMP għal monitor, allura n-nases SNMP jiġu assenjati l-istess tags bħala l-monitor, jekk ikun hemm.
Il-ħolqien Tags
Hawn taħt nuru kif toħloq a tag bl-isem u l-kulur kif definit mill-XMLtag> sottostruttura.

Assenja a Tag
Biex tassenja a tag għal riżorsa, iżżidha bħala ġdidatag> element taħt il-tags> element għal dik ir-riżorsa.
Hawnhekk huwa kif tassenja a tag lil Aġent tat-Test:

Biex tassenja a tag għal TWAMP riflettur, agħmel dan li ġej:

Assenja a tag għal monitor jiġi ttrattat bl-istess mod:

Alternattivament, inti tista 'tassenja eżistenti tag għal xi wieħed minn dawn it-tipi ta’ riżorsi meta toħloq ir-riżorsa, billi tinkludi l-tags> element li fih il- tag in kwistjoni.
Aġġornament a Tag
Aġġornament eżistenti tag b'attributi ġodda huwa analogu għall-ħolqien a tag:

Tneħħija tal-assignment a Tag
Biex tneħħi l-assenja a tag minn riżorsa, żid l-attribut nc:operation="delete" mal-tag> element li jappartjeni għar-riżorsa. Hawn taħt, aħna unassign a tag minn monitor.

Tħassir a Tag
Sabiex titħassar a tag għal kollox miċ-Ċentru ta' Kontroll, l-attribut nc:operation="delete" jerġa' jintuża, iżda din id-darba applikat għall- tag innifsu, definit taħt .

Issolvi l-problemi

Problema: Orkestratur u Paragon Assikurazzjoni Attiva Mhux Sinkronizzata
L-orkestratur u Paragon Active Assurance jistgħu jispiċċaw mhux sinkronizzati pereżempjuample jekk saru bidliet fil-konfigurazzjoni fil-GUI taċ-Ċentru tal-Kontroll, jew jekk l-applikazzjoni ta' konfigurazzjoni ma kinitx ta' suċċess u r-ritorn lura għall-istat preċedenti falla.
F'każ ta' rollback fallut, is-server NETCONF mhux se jaċċetta aktar bidliet fil-konfigurazzjoni; se jwieġeb b'messaġġ ta 'żball li jiddikjara li l-konfigurazzjoni hija msakkra sakemm terġa' tiġi sinkronizzata. Biex terġa 'lura fis-sinkronizzazzjoni u nisfruttaw il-bidliet fil-konfigurazzjoni, għandek bżonn tmexxi l-kmand rpc sync-from-ncc li jissinkronizza l-konfigurazzjoni kollha miċ-Ċentru ta' Kontroll għad-database tal-konfigurazzjoni.
NOTA: Il- confd@netrounds.com utent (jew dak kollu li jkun ġie kkonfigurat) għandu jkollu privileġġi ta 'superuser biex kollox jiġi sinkronizzat b'suċċess. Dan jista 'jinkiseb bil-kmand ncc user-update confd@netrounds.com –is-superuser Jekk l-utent ma jkunx superuser, tidher twissija li tgħid li mhux kollox jista’ jiġi sinkronizzat, iżda li dak kollu li jista’ jiġi mmaniġġjat ġie.
NOTA: Jekk l-orkestratur tiegħek jaħżen ukoll il-konfigurazzjoni, ikollok bżonn terġa' tissinkronizza dik ukoll peress li l-konfigurazzjoni mitluba (il-konfigurazzjoni li l-orkestratur jistenna li jkollu ċ-Ċentru ta' Kontroll) ma tkunx ġiet applikata.
Problema: Sinkronizzazzjoni Inizjali (sync-from-ncc) Falliet Minħabba Riżorsi Mhux Sostnuti
Jekk tipprova tħaddem rpc sync-from-ncc fuq kont li għandu l-konfigurazzjoni tiegħu maħluqa fil-GUI taċ-Ċentru ta 'Kontroll, tista' tiffaċċja problemi jekk il-kont ikun fih riżorsi mhux appoġġjati. Huwa rakkomandat li tibda b'kont vojt u tagħmel il-konfigurazzjoni kollha tiegħu permezz ta' NETCONF. Inkella, jekk tiltaqa' ma' kwistjonijiet b'kunflitti ta' riżorsi, ikollok tneħħi r-riżorsi konfliġġenti mill-kont.
Problema: Il-kmandi NETCONF ifallu b'ncclient.operations.rpc.RPCError: ħsara fil-komunikazzjoni tal-applikazzjoni
Is-server NETCONF ma jirrestawrax il-konnettività mas-server taċ-Ċentru tal-Kontroll awtomatikament jekk iċ-Ċentru tal-Kontroll jerġa' jinbeda. Biex tirrestawra l-konnessjoni maċ-Ċentru tal-Kontroll, ibda mill-ġdid il-proċess NETCONF: sudo systemctl restart netrounds-confd

Noti dwar l-Applikazzjonijiet tal-Aġent tat-Test u l-Appliances tal-Aġent tat-Test

Applikazzjonijiet għall-Aġent tat-Test f'ConfD
Fost l-Aġenti tat-Test, l-Applikazzjoni tal-Aġent tat-Test (aktar ġdida) taħdem daqsxejn differenti mill-Appliance tal-Aġent tat-Test (eqdem).
L-applikazzjonijiet tal-Aġent tat-Test bħalissa ma jappoġġjawx il-konfigurazzjoni tal-interface. Għalhekk, l-iskema YANG tippermetti li tiġi speċifikata konfigurazzjoni ta 'interface vojta għal tali Aġenti tat-Test. Ara “din is-silta” f’paġna 23 għal example.
Meta tissinkronizza d-database tal-ConfD maċ-Ċentru tal-Kontroll bl-użu tal-kmand sync-from-ncc, trid li l-konfigurazzjoni tal-interface tibqa’ vojta u ma tinkitebx fuqu ma’ dak li jinstab fiċ-Ċentru tal-Kontroll. Għalhekk għandek bżonn tuża bandiera speċjali –without_interface_config ma' dak il-kmand meta taħdem ma' Applikazzjonijiet ta' Aġent tat-Test.
Konfigurazzjoni tal-Interface Vojta għall-Appliance tal-Aġent tat-Test
Kif innutat hawn fuq, l-Applikazzjoni tal-Aġent tat-Test ma tappoġġjax il-konfigurazzjoni tal-interface, u għalhekk huwa possibbli li jitħallew barra l-interfaces fl-iskema YANG.
Iżda hemm ukoll każijiet ta' użu fejn tista' tkun trid tħalli barra l-konfigurazzjoni tal-interface minn Appliance tal-Aġent tat-Test. ExampLe ta 'dan jista' jkun xenarju ta 'orkestrazzjoni fejn qed iddawwar Aġent tat-Test bl-użu ta' cloud-init, u trid tintuża l-konfigurazzjoni tal-interface minn hemm, minflok ma tħalli lil ConfD tikteb fuqha hekk kif l-Aġent tat-Test jiġi online.
Bidliet fl-Iskema YANG Rigward Interfaces Mhux Definiti
Peress li issa hija permessa konfigurazzjoni ta' interface vojta (mill-verżjoni 2.34.0 'l quddiem), huwa possibbli li jiġi speċifikat kwalunkwe isem ta' interface bħala input għal kompitu li jaħdem bħala parti minn test jew monitor.
Dan huwa meħtieġ biex tkun tista' tuża Applikazzjoni tal-Aġent tat-Test, peress li għal dawn l-ebda ismijiet tal-interface ma huma definiti f'ConfD. Innota, madankollu, li dan ifisser ukoll li tista 'tiffaċċja problemi jekk b'inċident tikkonfigura test jew monitor biex tuża interface li ma teżistix. Allura jekk jogħġbok kun konxju ta 'dan.
Limitazzjonijiet Meta Tirreġistra Aġent tat-Test Maħluq f'ConfD
Meta noħolqu Aġent tat-Test permezz tal-API REST jew NETCONF/YANG, ma nistgħux inkunu nafu minn qabel liema tip huwa: Applikazzjoni tal-Aġent tat-Test jew Applikazzjoni tal-Aġent tat-Test. Dan isir ċar biss wara li l-Aġent tat-Test ikun irreġistra.
Ladarba l-Aġent tat-Test ikun ġie rreġistrat u nbidel f'wieħed minn dawn it-tipi tal-konkrit, m'intix permess li terġa' tirreġistrah bħala tip differenti ta' Aġent tat-Test. Dan ifisser li m'intix permess li l-ewwel tirreġistraha bħala Appliance tal-Aġent tat-Test, imbagħad terġa' tirreġistraha bħala Applikazzjoni tal-Aġent tat-Test, jew viċeversa. Jekk għandek bżonn Aġent tat-Test ta' tip differenti, ikollok bżonn toħloq Aġent tat-Test ġdid.

Appendiċi: Struttura tas-Siġra tal-Mudell Sħiħ tal-YANG

F'dan l-appendiċi, it-taqsima "Leġġenda" f'paġna 81 tispjega s-sintassi tal-istruttura tas-siġra tal-mudell YANG ġġenerata bil-kmand pyang -f tree.
It-taqsima "Struttura tas-Siġra Mudell YANG" f'paġna 82 tagħti l-output minn dak il-kmand applikat għal netrounds-ncc.yang. Partijiet minn dan l-output huma riprodotti x'imkien ieħor fid-dokument.
Leġġenda

Struttura tas-Siġra Mudell ta 'YANG

Juniper Networks, il-logo Juniper Networks, Juniper, u Junos huma trademarks reġistrati ta’ Juniper Networks, Inc. fl-Istati Uniti u pajjiżi oħra. It-trademarks l-oħra kollha, il-marki tas-servizz, il-marki reġistrati, jew il-marki tas-servizz irreġistrati huma l-proprjetà tas-sidien rispettivi tagħhom. Juniper Networks ma jassumi l-ebda responsabbiltà għal xi ineżattezzi f'dan id-dokument. Juniper Networks jirriżerva d-dritt li jibdel, jimmodifika, jittrasferixxi, jew inkella jirrevedi din il-pubblikazzjoni mingħajr avviż. Copyright © 2023 Juniper Networks, Inc. Id-drittijiet kollha riżervati.

Dokumenti / Riżorsi

Juniper NETWORKS NETCONF & YANG API Software [pdfGwida għall-Utent
NETCONF YANG API Software, YANG API Software, API Software, Software

Referenzi

Manwal għall-Utent

Introduzzjoni