NETCONF & YANG API Orchestration
Tywysydd
Cyhoeddwyd
2023-07-07
RHYDDHAU 4.2
Rhagymadrodd
Pwrpas y Ddogfen Hon
Mae'r ddogfennaeth hon yn disgrifio sut i integreiddio Paragon Active Assurance â cherddorfawr gwasanaeth rhwydwaith trwy'r Ganolfan Reoli NETCONF & YANG API. Ymarferol examprhoddir gwybod am y prif dasgau dan sylw, gan gynnwys: creu a defnyddio Asiantau Prawf Rhithwir, rhedeg profion a monitorau, ac adalw canlyniadau o'r gweithgareddau hyn.
Yn y ddogfen hon, defnyddir yr ncclient cleient Python NETCONF sydd ar gael am ddim yn rôl cerddorfaol.
Confensiynau
Defnyddir y talfyriadau canlynol yn y ddogfen hon:
| Talfyriad | Ystyr geiriau: |
| CLI | Rhyngwyneb Llinell Orchymyn |
| EM | Rheolwr Elfennau |
| ES | Gwall Ail |
| ASE | MEG (Grŵp Endid Cynnal a Chadw) Pwynt Terfyn (diffiniad ITU-T Y.1731) neu Bwynt Terfyn Cynnal a Chadw (diffiniad Cisco) |
| NFV | Rhwydweithio Swyddogaeth Rhwydwaith |
| NFVO | Cerddorfa Rhithwiroli Swyddogaeth Rhwydwaith |
| NSD | Disgrifydd Gwasanaeth Rhwydwaith |
| RPC | Galwad Gweithdrefn Anghysbell |
| SIP | Protocol Cychwyn Sesiwn |
| CLG | Cytundeb Lefel Gwasanaeth |
| S-VNFM | Rheolwr VNF Arbennig |
| VNF | Swyddogaeth Rhwydwaith Rhithwir |
| vTA | Asiant Prawf Rhithwir |
Nodiadau ar Gydweddoldeb Nôl
Yn fersiynau 2.35.4/2.36.0 o API NETCONF & YANG, gwnaed y broses o ddilysu rhai ceisiadau yn fwy llym i gadw at safon NETCONF. Mae hyn yn golygu y gallai cod cleient sy'n seiliedig ar fersiynau hŷn o'r canllaw hwn gael ei wrthod nawr.
Am gynample, mewn blaenorol Python example code, ni ddarparwyd priodoledd namespace. Mae angen darparu'r gofod enw yn y cais XML pryd bynnag y byddwch am addasu adnodd ConfD.
Rhagofynion a Pharatoadau
Gosodiad confD
Defnyddir ConfD (cynnyrch o Tail-f) fel cyfryngwr rhwng y system Paragon Active Assurance a NETCONF. Mae ConfD yn cysylltu cyfluniad Paragon Active Assurance a data gweithredol i'r NETCONF & YANG API.
Dylai ConfD fod wedi'i osod ynghyd â meddalwedd y Ganolfan Reoli, fel y disgrifir yn y Canllaw Gosod.
Gwirio Bod ConfD yn Rhedeg
I wirio bod y ConfD ar waith, rhedwch y gorchymyn
ssh -s @localhost -p 830 netconf
i wirio bod ConfD yn ymateb ar borth 830. Yn y gorchymyn, fel y'i diffinnir gan y defnyddiwr netconf creu
gorchymyn yn y Canllaw Gosod, adran Gosod ConfD. Rhowch y cyfrinair a ddiffinnir gan yr un gorchymyn.
Yn yr allbwn, gwiriwch fod modiwl y Ganolfan Reoli wedi'i gynnwys. Dylai'r allbwn gynnwys llinell fel y canlynol:
http://ncc.netrounds.com?module=netrounds-ncc&adolygiad=2017-06-15
Cydamseru'r Gronfa Ddata Ffurfweddu â'r Ganolfan Reoli
Yn olaf, mae angen i ni ddiweddaru'r gronfa ddata ffurfweddu trwy NETCONF. Byddwn yn gwneud hynny yma trwy gyfrwng llyfrgell Python o'r enw ncclient (NETCONF Client). Fodd bynnag, gallai'r dasg hefyd gael ei chyflawni mewn iaith raglennu wahanol cyn belled â'i bod yn defnyddio'r protocol NETCONF/YANG.
Rôl ncclient yw gweithredu fel cleient tuag at y gweinydd ConfD sy'n cynnal yr API NETCONF/YANG.
Mae'n werth tynnu sylw at y ffaith nad yw ncclient yn perthyn mewn unrhyw ffordd i'r Ganolfan Reoli ("Canolfan Reoli Rhwydweithiau'n flaenorol"), er bod yr enw'n digwydd i ddechrau gyda "ncc".
Dyma sut i osod ncclient:
- Lawrlwythwch y meddalwedd o https://github.com/ncclient/ncclient.
- Rhedeg y gorchymyn hwn: pip install ncclient
Gallwn nawr berfformio'r cydamseriad fel a ganlyn. Sylwch yn ofalus bod angen gwneud hyn ar gyfrifiadur ar wahân, ac nid ar weinydd y Ganolfan Reoli ei hun:
#
# NODYN:
# Mae'r sgript hon yn gweithredu fel cleient tuag at ConfD sy'n rhedeg ar y gweinydd NCC.
# Bydd yn defnyddio API NETCONF/YANG ar gyfer cyfathrebu.
NODYN: Mae angen y weithdrefn hon hefyd pryd bynnag y bydd Asiantau Prawf wedi'u gosod a'u cofrestru'n annibynnol ar NETCONF. Gweler y nodyn yn yr adran “Drosoddview of Test Asiant Orchestration” ar dudalen 17 am ragor o wybodaeth.
Sefydlu Cyfrifon Sicrwydd Paragon Actif Lluosog a reolir gan NETCONF
Mae angen y camau isod dim ond os ydych chi'n dymuno sefydlu cyfrifon Paragon Active Assurance pellach i'w rheoli gan NETCONF, yn ogystal â'r cyfrif sydd wedi'i ffurfweddu fel hyn yn y Canllaw Gosod, adran “Gosod ConfD”.
Ar gyfer pob cyfrif o'r fath, ewch ymlaen fel a ganlyn:
- Yn y Ganolfan Reoli, mewngofnodwch i'r cyfrif a llywio i Cyfrif > Caniatâd.
- Ychwanegu'r defnyddiwr "confd@netrounds.com“, a rhowch ganiatâd gweinyddol defnyddiwr ConfD hwn yn y GUI trwy glicio ar y botwm Gwahodd.
- Cydamserwch y gronfa ddata ffurfweddu â'r Ganolfan Reoli fel y disgrifir yn yr adran “Cydamseru'r Gronfa Ddata Ffurfweddu â'r Ganolfan Reoli” ar dudalen 4.
Dylech nawr allu rheoli cyfrifon Paragon Active Assurance lluosog gyda'r un defnyddiwr ConfD.
NODYN: Unwaith y byddwch yn dechrau rheoli cyfrif Paragon Active Assurance trwy ConfD, ni ddylech wneud newidiadau i'r cyfrif hwn trwy'r web GUI mewn perthynas ag unrhyw nodweddion Paragon Active Assurance sy'n “config” (gweler y bennod “Nodweddion a Gefnogir yn Sicrwydd Gweithredol Paragon” ar dudalen 9). Os gwnewch hynny, bydd colli cysoni yn arwain at hynny.
Cyflwyniad i NETCONF Orchestration API
Drosoddview
Fel arfer NFVO trydydd parti neu gerddorfawr gwasanaeth yw'r gydran sy'n cychwyn sesiynau profi a monitro gan ddefnyddio API y Ganolfan Reoli. Mae'r cerddor hefyd yn adfer y canlyniadau mesur cyfanredol o weithgareddau'r Asiant Prawf. Gall Systemau Rheoli Perfformiad trydydd parti adfer DPAau perfformiad, tra gellir anfon digwyddiadau - unwaith y cânt eu hysgogi gan droseddau trothwy a osodwyd yn y Ganolfan Reoli - i systemau Rheoli Namau trydydd parti.
I grynhoi, mae'r ffigur isod yn dangos sut mae Paragon Active Assurance yn rhyngweithio â systemau trydydd parti eraill yn nhirwedd OSS.
- NFVO/Cerddorfawr Gwasanaeth: Yn cyfarwyddo'r Rheolwr VNF i ddefnyddio'r vTAs a ffurfweddu Paragon Active Assurance i'r gadwyn gwasanaeth. Unwaith y bydd y gwasanaeth wedi'i actifadu, mae'r cerddorfa'n defnyddio'r API tuag at y Ganolfan Reoli i ysgogi profion ysgogi gwasanaeth ac adalw canlyniadau pasio / methu. Os caiff y profion eu pasio, bydd y cerddorfa'n defnyddio'r API tuag at y Ganolfan Reoli i ddechrau monitro'r gwasanaeth yn weithredol. Mae Dangosyddion Perfformiad Allweddol o'r monitro yn cael eu hadalw'n barhaus naill ai gan y cerddor neu drwy lwyfan Rheoli Perfformiad ar wahân.
- Canolfan Reoli: Yn defnyddio, yn graddio, ac yn terfynu'r vTA yn unol â chyfarwyddiadau'r NFVO neu gerddorfawr gwasanaeth.
- System Rheoli Perfformiad neu system Rheoli Ansawdd Gwasanaeth: Yn darllen DPA o waith monitro gweithredol trwy API y Ganolfan Reoli.
- System Rheoli Nam: Yn derbyn NETCONF, SNMP, neu hysbysiadau e-bost gan y Ganolfan Reoli os caiff CLGau eu torri.
Diffiniadau o Gysyniadau yn Sicrwydd Gweithredol Paragon
- Asiantau Prawf: Y cydrannau sy'n perfformio mesuriadau (ar gyfer profion yn ogystal â monitorau) mewn system Sicrwydd Gweithredol Paragon. Mae Asiantau Prawf yn cynnwys meddalwedd sydd â'r gallu i gynhyrchu, derbyn a dadansoddi traffig rhwydwaith go iawn.
- Y math o Asiant Prawf a drafodir yn y ddogfen hon yw'r Asiant Prawf Rhithwir (vTA), swyddogaeth rhwydwaith rhithwir (VNF) a ddefnyddir ar hypervisor. Mae mathau eraill o Asiantau Prawf yn bodoli hefyd.
- Mae dau fath sylfaenol o fesuriad yn Paragon Active Assurance, profion a monitorau.
- Prawf: Mae prawf yn cynnwys un neu sawl cam, ac mae gan bob un ohonynt gyfnod penodol, cyfyngedig. Gweithredir camau yn ddilyniannol. Gall pob cam olygu rhedeg tasgau lluosog ar yr un pryd.
- Monitro: Nid oes gan fonitor hyd penodol ond mae'n gweithredu am gyfnod amhenodol. Fel cam mewn prawf, gall monitor gyflawni tasgau cydamserol lluosog.
- Templed: Pan fo Paragon Active Assurance yn cael ei reoli gan gerddorfawr, mae profion a monitorau bob amser yn cael eu gweithredu trwy dempledi lle mae'r prawf neu'r monitor wedi'i ddiffinio. Gellir trosglwyddo gosodiadau paramedr fel mewnbynnau i'r templed ar amser rhedeg.
Llif gwaith ar gyfer Awtomeiddio
Amser Dylunio
Ar amser dylunio, byddwch yn paratoi mesuriadau trwy greu templedi ar gyfer profion a monitorau yn Paragon Active Assurance. Ymdrinnir â sut i wneud hynny yn y bennod “Templedi Profi a Monitro” ar dudalen 15.
Amser rhedeg
Ar amser rhedeg, rydych chi'n gosod eich dyfeisiau ac yn perfformio'r mesuriadau gwirioneddol.
- Mae drosoddview o bob cynampceir les a roddir yn y bennod “Exampllai o Reoli Sicrwydd Gweithredol Paragon trwy NETCONF & YANG API” ar dudalen 15.
- Mae sut i ddefnyddio a ffurfweddu Asiantau Prawf yn cael ei drafod yn y bennod “Examples: Asiantau Prawf” ar dudalen 16.
- Sut i fewnforio eitemau rhestr eiddo fel TWAMP adlewyrchwyr a sianeli IPTV yn cael ei drafod yn y bennod “Examples: Eitemau Rhestr Eiddo” ar dudalen 29.
- Esbonnir sut i ffurfweddu larymau yn y bennod “Examples: Larymau” ar dudalen 35.
- Disgrifir sut i redeg profion a monitorau trwy weithredu templedi Paragon Active Assurance trwy NETCONF yn y penodau “Examples: Profion” ar dudalen 43 ac “Examples: Monitors” ar dudalen 54.
Nodweddion â Chymorth yn Sicrwydd Gweithredol Paragon
Gellir creu a gweithredu pob math o brawf a monitro yn Paragon Active Assurance trwy ddefnyddio templedi. Ymdrinnir â sut i wneud hyn yn y cymorth mewn-app o dan “Profion a monitorau” > “Creu templedi”.
Nid yw creu cyfrifon Paragon Active Assurance yn cael ei gefnogi ar hyn o bryd; fodd bynnag, bydd un neu nifer o gyfrifon rhagddiffiniedig wedi'u sefydlu ar gyfer y defnyddiwr.
Mae'r tablau isod yn manylu ar ba nodweddion yn Paragon Active Assurance sydd ar gael yn y datganiad hwn, a sut mae'r nodweddion hyn yn cael eu cynrychioli yn YANG.
Eglurhad o YANG Constructs
Er hwylustod, rhoddir diffiniadau yma o'r lluniadau YANG y cyfeirir atynt yn y tabl nodweddion.
- Ffurfweddu (config = true): Data ffurfweddu, sydd ei angen i drawsnewid system o un cyflwr i'r llall.
- Cyflwr (config=false): Nodwch ddata: data ychwanegol ar system nad yw'n ddata ffurfweddu, megis gwybodaeth statws darllen yn unig ac ystadegau a gasglwyd.
- RPC: Galwad Gweithdrefn Anghysbell, fel y'i defnyddir o fewn protocol NETCONF.
- Hysbysiad: Hysbysiadau digwyddiad a anfonwyd o weinydd NETCONF at gleient NETCONF.
Tablau o Nodweddion Sicrwydd Gweithredol Paragon Ar Gael ar gyfer Cerddorfa
Adnodd: Monitro
Llwybr YANG:/cyfrifon/cyfrif/monitro
| Nodwedd | Is-nodwedd | Yang adeiladu |
| Creu/addasu/dileu monitor | Yn seiliedig ar dempled monitor | Config |
| Monitor cychwyn/stop | – | Config |
| Monitro templedi | Rhestrwch dempledi monitor presennol gyda mewnbynnau | Cyflwr |
| Hysbysiadau NETCONF | Cyflwr larwm wedi newid | Hysbysu |
| Monitro canlyniadau | Cownter CLG/ES ar gyfer lefel uchaf (%) Rhifydd CLG/ES ar gyfer lefel tasg (%) |
Cyflwr |
Yn wahanol i brofion (cymharer Adnodd: Profion isod), nid yw monitorau yn cael eu cychwyn gyda RPC ond yn hytrach trwy ymrwymo cyfluniad y monitor.
Adnodd: Profion
Llwybr YANG: /cyfrifon/cyfrif/profion
| Nodwedd | Is-nodwedd | Yang adeiladu |
| Cychwyn prawf | Yn seiliedig ar dempled prawf | RPC |
| Rheoli profion | Rhestrwch brofion gyda statws | Cyflwr |
| Templedi prawf | Rhestrwch dempledi prawf presennol gyda mewnbynnau | Cyflwr |
| Hysbysiadau NETCONF | Newidiodd statws y prawf | Hysbysu |
| Canlyniadau profion | Sicrhewch statws cam prawf (pasio, methu, gwall, ...) | Cyflwr |
Adnodd: Asiantau Prawf
llwybrau Yang:
- /cyfrifon/cyfrif/asiantau prawf (Config)
- /cyfrifon/cyfrif/asiantau prawf cofrestredig (Gwladwriaeth)
Asiantau Prawf o dan /cyfrifon/cyfrif/asiantau prawf yw'r rhai sy'n cael eu ffurfweddu mewn cyfrif. Dim ond yr Asiantau Prawf hyn y gellir eu ffurfweddu a'u defnyddio mewn profion a monitorau trwy NETCONF gan y cerddor.
Ar ôl i chi ffurfweddu Asiant Prawf a'i fod wedi cofrestru i'r cyfrif, bydd yr Asiant Prawf yn ymddangos o dan /accounts/account/registered-test-agents. Gallwch ddod o hyd i'r holl Asiantau Prawf cofrestredig gan ddefnyddio gorchymyn “get” yn NETCONF (cymharer y bennod Examples: Asiantau Prawf).
O dan /accounts/account/registered-test-agents efallai y byddwch hefyd yn dod o hyd i Asiantau Prawf nad ydynt wedi'u ffurfweddu eto. Rhaid i unrhyw Asiantau Prawf o'r fath gael eu ffurfweddu cyn y gellir eu defnyddio.
Mewn senario offeryniaeth, argymhellir yn gyffredinol eich bod yn gwneud yr holl gyfluniad o'ch cyfrif Paragon Active Assurance trwy NETCONF. Mae hyn yn sicrhau nad yw asiantau prawf ac asiantau prawf cofrestredig yn dargyfeirio.
| Nodwedd | Is-nodwedd | Yang adeiladu |
| Cyn-greu Asiant Prawf ar y gweinydd | – | Config |
| Ffurfweddu Asiant Prawf all-lein | (Canolfan Reoli yn gwthio ffurfweddu i Asiant Prawf pan ddaw ar-lein) |
Config |
| Defnyddiwch Asiantau Prawf presennol/wedi'u ffurfweddu'n allanol | Defnyddiwch mewn prawf/monitro | Config |
| Ffurfweddu rhyngwynebau | Config | |
| Cael statws | Cyflwr | |
| Ffurfweddu Asiant Prawf (Offer Prawf yn unig) | Ffurfweddu NTP | Config |
| Ffurfweddu pontydd | Config | |
| Ffurfweddu rhyngwynebau VLAN | Config | |
| Ffurfweddu allweddi SSH | Config | |
| IPv6 | Config | |
| Utils | Ailgychwyn | RPC |
| Diweddariad | RPC | |
| Hysbysiadau NETCONF | Statws ar-lein wedi newid | Hysbysu |
| Statws | Cael statws system (uptime, defnydd cof, cyfartaledd llwyth, fersiwn) |
Cyflwr |
Adnodd: Rhestr
Llwybr YANG: /cyfrifon/cyfrif/twamp-adlewyrchwyr
Galluoedd NETCONF a Gefnogir
Mae’r tabl isod yn cyfeirio at RFCs IETF sy’n disgrifio’r galluoedd NETCONF a ddefnyddir at ddiben cerddorfa Paragon Active Assurance.
- ietf-netconf.yang
- IETF RFC 6241, Protocol Ffurfweddu Rhwydwaith (NETCONF), https://tools.ietf.org/html/rfc6241
- Yr unig ddull trin gwall a gefnogir yw dychwelyd-ar-wall.
- Mae'r unig storfa ddata a gefnogir yn un y gellir ei hysgrifennu.
- ietf-netconf-hysbysiadau.yang
- IETF RFC 5277, Hysbysiadau Digwyddiad NETCONF, https://tools.ietf.org/html/rfc5277
Profi a Monitro Templedi
Mae angen gosod templedi ar gyfer mathau o brofion a monitorau â llaw trwy ryngwyneb defnyddiwr pen blaen Paragon Active Assurance. Ymdrinnir â sut i wneud hyn yn y cymorth mewn-app o dan “Profion a monitorau” > “Creu templedi”.
Exampllai o Reoli Sicrwydd Gweithredol Paragon trwy NETCONF & YANG API
Yn y penodau sy’n dilyn, tybir bod templedi prawf a monitor addas wedi’u diffinio yn unol â’r cyfarwyddiadau a roddir yn y bennod “Templau Profi a Monitro” ar dudalen 15.
Offer a Ddefnyddir yn Examples
Mae'r holl gynampmae les yn y penodau dilynol wedi'u llunio gan ddefnyddio'r offer canlynol sydd ar gael yn rhwydd:
- Pang: Fe'i defnyddir i ddelweddu a phori'r modelau YANG.
- Ar gael yn https://github.com/mbj4668/pyang (clôn o git a rhedeg python setup.py install).
- Cleient Python NETCONF “ncclient”: Fe'i defnyddir i gyfathrebu â'r Ganolfan Reoli gan ddefnyddio NETCONF.
- Ar gael yn https://github.com/ncclient/ncclient (rhedeg pip install ncclient).
Mae model data netrounds-ncc.yang i'w gael yn /opt/netrounds-confd unwaith y bydd ConfD wedi'i osod yn ôl y Canllaw Gosod).
Drosoddview o'r Tasgau Allweddol a Berfformiwyd
(Mae rhai tasgau pellach hefyd yn cael eu hamlinellu yn yr hyn a ganlyn.)
- “Creu a defnyddio Asiant Prawf newydd” ar dudalen 16
- “Creu eitemau stocrestr (ee adlewyrchyddion)” ar dudalen 29
- “Gosod templedi larwm a ble i anfon larymau” ar dudalen 35
- “Creu a rhedeg prawf” ar dudalen 45
- “Adalw canlyniadau profion” ar dudalen 50
- “Cychwyn monitor (gan gynnwys gosod larymau)” ar dudalen 60
- “Adalw statws CLG ar gyfer monitor” ar dudalen 67
- “Gweithio gyda tags”Ar dudalen 71
Examples: Asiantau Prawf
Drosoddview of Test Asiant Orchestration
Mae Asiantau Prawf yn Sicrwydd Gweithredol Paragon yn cael eu hystyried yn “gyfluniad” yng nghyd-destun offeryniaeth. Mae hyn yn golygu y dylid creu, rheoli a dileu Asiantau Prawf trwy'r cerddorfa a NETCONF yn hytrach na thrwy'r Paragon Active Assurance GUI.
PWYSIG: Os yw Asiant Prawf yn cael ei osod gan dechnegydd a'i gofrestru i'r Ganolfan Reoli heb gael ei greu yn gyntaf trwy'r API NETCONF & YANG, ni fydd yr Asiant Prawf yn bodoli yn y gronfa ddata ffurfweddu, a bydd y system yn mynd allan o gysoni. Er mwyn i ConfD ddod yn ymwybodol o'r Asiant Prawf yn yr achos hwn, bydd angen perfformio cydamseriad newydd gyda'r Ganolfan Reoli, fel y manylir yn yr adran "Cydamseru'r Gronfa Ddata Ffurfweddu â'r Ganolfan Reoli" ar dudalen 4.
Felly, dylai'n well gwneud Cerddorfa Asiantau Prawf Rhithwir (vTAs) yn y camau canlynol:
- Creu'r Asiant Prawf Rhithwir, gan gynnwys ei ffurfweddiad rhyngwyneb, gan ddefnyddio'r rhyngwyneb NETCONF & YANG i'r Ganolfan Reoli. Enw'r Asiant Prawf fydd ei allwedd unigryw.
- Defnyddio'r vTA ar blatfform rhithwiroli. Dilynwch y cyfarwyddiadau yn y cymorth ar-lein o dan Asiantau Prawf > Gosod. Mae'r cyfluniad rhyngwyneb sylfaenol sy'n caniatáu i'r vTA gysylltu â'r Ganolfan Reoli, yn ogystal â manylion ar gyfer dilysu, yn cael ei ddarparu i'r vTA gan ddefnyddio data defnyddwyr cwmwl-init.
Unwaith y bydd y vTA wedi cychwyn, bydd yn cysylltu'n awtomatig â'r Ganolfan Reoli gan ddefnyddio cysylltiad OpenVPN wedi'i amgryptio. Anfonir hysbysiad NETCONF gan fod gwerth paramedr prawf-asiant-newid statws y vTA bellach wedi newid i “ar-lein”.
NODYN: Gan mai enw’r vTA yw ei ddynodwr yn y Ganolfan Reoli, rhaid i’r enw hwn fod yr un fath â’r un a ddiffinnir yn y Ganolfan Reoli yng ngham 1 ar dudalen 17. - Unwaith y bydd y vTA wedi cysylltu a dilysu i'r Ganolfan Reoli, mae ffurfweddiad y rhyngwyneb yn cael ei wthio i'r vTA. Dyma'r cyfluniad rhyngwyneb a ddarparwyd yn “cam 1” ar dudalen 17 pan grëwyd y vTA yn y Ganolfan Reoli.
- Ar ôl i'r vTA gyflawni ei ddiben, dilëwch y vTA.
Creu a Defnyddio Asiant Prawf Newydd
Yn gyntaf mae angen i ni greu Asiant Prawf gan ddefnyddio rhyngwyneb NETCONF & YANG i'r Ganolfan Reoli. Pan fydd Asiant Prawf yn cael ei greu yn y modd hwn, nid oes angen cydamseru â'r Ganolfan Reoli.
Mae model YANG ar gyfer Asiant Prawf fel y dangosir isod. Fe'i ceir fel allbwn o'r gorchymyn
pyang -f coeden netrounds-ncc.yang
Rhoddir model YANG llawn yn “Atodiad: Strwythur Coed o Fodel YANG Llawn” ar dudalen 81, sydd hefyd yn cynnwys chwedl sy'n esbonio'r confensiynau a ddefnyddir yn y darluniau model YANG hwn ac eraill yn y ddogfen bresennol.
Rydym yn symud ymlaen yn y camau canlynol, y manylir arnynt yn y canlynol:
- O'r cychwyn cyntaf, nid oes gan “demo” cyfrif Paragon Active Assurance Asiantau Prawf yn ei restr.
- Mae Asiant Prawf o'r enw “vta1” yn cael ei greu gan ddefnyddio ncclient. Ar hyn stage, nid oes unrhyw Asiant Prawf go iawn yn bodoli eto (hynny yw, nid yw wedi'i ddechrau eto).
- Mae'r Asiant Prawf yn cael ei ddefnyddio yn OpenStack. (Dewisir lleoli ar y platfform hwnnw yma fel un posibilrwydd ymhlith eraill.)
- Mae'r Asiant Prawf yn cysylltu â “demo” cyfrif y Ganolfan Reoli ac mae bellach yn barod i'w ddefnyddio.
Cam 1: Ar y cychwyn, nid oes unrhyw Asiantau Prawf yn y cyfrif “demo”. Gweler y sgrin isod o GUI y Ganolfan Reoli.
Cam 2: Crëir Asiant Prawf yn y Ganolfan Reoli gan ddefnyddio cleient Python NETCONF “ncclient”. Isod mae cod ncclient ar gyfer creu Asiant Prawf sydd ag un rhyngwyneb corfforol gyda chyfeiriad DHCP:
mewnforio argparse
gan reolwr mewnforio ncclient
parser = argparse.ArgumentParser(description='Profi creu Asiant Prawf')
parser.add_argument('–host', help='Yr enw gwesteiwr lle canfyddir ConfD', gofynnol=Gwir)
parser.add_argument('–port', help='Y porth i gysylltu â ConfD', gofynnol=Gwir)
parser.add_argument('–username', help='Yr enw defnyddiwr i gysylltu â ConfD', gofynnol=Gwir)
parser.add_argument('–password', help='Cyfrinair i'r cyfrif ConfD', gofynnol=Gwir)
parser.add_argument('–netrounds-account', help='Enw byr y cyfrif NCC', gofynnol=Gwir)
parser.add_argument('–test-agent-name', help='Enw'r Asiant Prawf', gofynnol=Gwir)
args = parser.parse_args()
gyda manager.connect(host=args.host, port=args.port, enw defnyddiwr=args.username,
password=args.password, hostkey_verify=Gau) fel m:
# Creu Asiant Prawf yn y Ganolfan Reoli
xml = “””
)argraffu m.edit_config(target='rhedeg', config=xml)
NODYN: Mae'r cod sy'n rhagflaenu gyda manager.connect(…) yn cael ei hepgor o ex dilynolamppytiau cod.
Mae gweinydd NTP wedi'i ffurfweddu ar eth0, ac eth0 hefyd yw'r rhyngwyneb rheoli (hynny yw, y rhyngwyneb sy'n cysylltu â'r Ganolfan Reoli).
Nid yw Cymhwysiad Asiant Prawf yn caniatáu ffurfweddu rhyngwynebau ar hyn o bryd. Am y rheswm hwn, o fersiwn 2.34.0 ymlaen, mae'n bosibl hepgor cyfluniad y rhyngwyneb yn sgema YANG. Felly mae'r XML cyfatebol wedi'i symleiddio'n sylweddol yn yr achos hwn:
Unwaith y bydd yr Asiant Prawf wedi'i greu, mae'n bodoli yn y gronfa ddata ffurfweddu ac yn y Ganolfan Reoli. Gweler y sgrinlun isod o restr yr Asiant Prawf, sy'n dangos yr Asiant Prawf “vta1”:
Cam 3: Mae bellach yn bryd defnyddio'r Asiant Prawf “vta1” yn OpenStack.
Bydd yr Asiant Prawf yn defnyddio data defnyddwyr cwmwl-init i adalw'r wybodaeth ar sut i gysylltu â'r Ganolfan Reoli. Yn benodol, y data defnyddiwr testun file mae ganddo'r cynnwys canlynol (Sylwer bod yn rhaid i'r llinellau #cloud-config a netrounds_test_agent fod yn bresennol, a bod rhaid mewnoli'r llinellau sy'n weddill):
Am ragor o wybodaeth, cyfeiriwch at y ddogfen Sut i Ddefnyddio Asiantau Prawf Rhithwir yn OpenStack.
Unwaith y bydd yr Asiant Prawf wedi'i leoli a'i gysylltu â'r Ganolfan Reoli, bydd y cyfluniad yn cael ei wthio o'r Ganolfan Reoli i'r Asiant Prawf.
Cam 4: Mae'r Asiant Prawf bellach ar-lein yn y Ganolfan Reoli ac wedi cael ei ffurfweddiad. Mae'r Asiant Prawf yn barod i'w ddefnyddio mewn profion a monitro. Gweler yr adrannau hyn:
- “Dechrau Prawf” ar dudalen 45
- “Dechrau Monitor” ar dudalen 60
Rhestru'r Asiantau Prawf yn Eich Cyfrif Sicrwydd Gweithredol Paragon
Isod mae example ncclient cod Python ar gyfer rhestru'r Asiantau Prawf mewn cyfrif Paragon Active Assurance:
Mae rhedeg y cod hwn yn rhoi allbwn fel hwn isod:
Dileu Asiant Prawf
Ar ôl cwblhau prawf, gallai fod yn berthnasol mewn rhai achosion defnydd i ddileu'r Asiant Prawf.
Isod mae pyt cod yn dangos sut i wneud hyn gydag ncclient:
Hysbysiadau NETCONF
Isod, rydym yn cyflwyno ex symlample script ar gyfer gwrando ar yr holl hysbysiadau NETCONF sy'n dod i mewn o'r Ganolfan Reoli. Anfonir yr hysbysiadau hyn pryd bynnag y bydd digwyddiadau penodol yn digwydd, megis Asiant Prawf yn mynd all-lein neu brawf a gychwynnir gan y defnyddiwr yn cael ei gwblhau. Yn seiliedig ar y wybodaeth a gariwyd yn yr hysbysiadau, gall defnyddwyr aseinio gweithredoedd dilynol awtomataidd yn y cerddorfa.
Pan weithredir y sgript uchod, bydd cleient NC yn cyflwyno'r hysbysiad a dderbyniwyd mewn XML strwythuredig. Gweler y cynample allbwn isod, sy'n dangos Asiant Prawf yn mynd all-lein yn annisgwyl.
2017-02-03T15:09:55.939156+00:00</eventTime>
<test-agent-status-change xmlns=’http://ncc.netrounds.com'>
demo
HW1
all-lein
Examples: Eitemau Rhestr
Creu (mewnforio) a rheoli eitemau stocrestr fel TWAMP adlewyrchwyr a Y.1731 ASE yn cael ei wneud mewn ffordd debyg ag ar gyfer Asiantau Prawf. Isod mae cod XML a NETCONF ar gyfer diffinio endidau o'r fath yn Paragon Active Assurance trwy API NETCONF & YANG ac ar gyfer adalw rhestrau o'r eitemau a ddiffinnir.
Creu TWAMP Adlewyrchydd
Creu Y.1731 ASE
Creu Sianel IPTV
Creu Gwesteiwr Ping
Creu Cyfrif SIP
Adalw Eitemau Stoc
Isod mae cod Python ar gyfer adfer yr holl eitemau rhestr eiddo a ddiffinnir mewn cyfrif. (Mae pob math o eitemau stocrestr yn cael eu casglu ar yr un pryd yma er mwyn osgoi rhywfaint o ailadrodd yn y ddogfen. Yn naturiol, gellir nôl unrhyw is-set o eitemau stocrestr trwy hepgor rhai o'r llinellau dan sylw isod.)
Mae rhedeg y cod hwn yn rhoi allbwn fel hwn isod:
Examples: Larymau
Mae templedi larwm ac eitemau cysylltiedig (rheolwyr SNMP, rhestrau e-bost larwm) yn cael eu creu a'u rheoli mewn ffordd debyg i eitemau stocrestr. Mae'r bennod hon yn cynnwys cod XML a NETCONF ar gyfer diffinio endidau o'r fath yn Paragon Active Assurance trwy API NETCONF & YANG ac ar gyfer adalw rhestrau o'r eitemau a ddiffinnir.
Rhestrau E-bost Larwm
Creu Rhestr E-bost Larwm
Nôl Pob Rhestr E-bost Larwm
Rheolwyr SNMP
Creu Rheolwr SNMP
Adalw Pob Rheolwr SNMP
Templedi Larwm
Creu Templed Larwm
Nôl Pob Templed Larwm
Examples: Allweddi SSH
Gallwch ychwanegu allweddi cyhoeddus SSH at Asiant Prawf trwy'r API NETCONF & YANG. Gan ddefnyddio'r allwedd breifat gyfatebol gallwch chi wedyn fewngofnodi i'r Asiant Prawf trwy SSH.
Mae'r rhestr lawn o weithrediadau sydd ar gael ar allweddi SSH fel a ganlyn:
- Ychwanegu allwedd SSH
- Addasu allwedd SSH
- Archwiliwch allwedd SSH
- Rhestrwch allweddi SSH
- Dileu allwedd SSH.
Isod, mae'r gweithrediadau ychwanegu a dileu wedi'u enghreifftio.
Dileu Allwedd SSH
Os ydych chi am ddileu allwedd SSH, defnyddiwch y gorchymyn canlynol:
Examples: Profion
Tybir yma bod Asiantau Prawf (cymaint ag sy'n ofynnol ar gyfer y profion) wedi'u creu yn unol â'r adran “Creu a Defnyddio Asiant Prawf Newydd” ar dudalen 17.
YANG Llwybrau Model ar gyfer Profion
| Eitem | Llwybr model YANG: /cyfrifon/cyfrif/profion … |
| profion | /. |
| prawf[id] | /prawf |
| id | /prawf/id |
| enw | /prawf/enw |
| statws | /prawf/statws |
| amser cychwyn | /prawf/amser cychwyn |
| amser diwedd | /prawf/amser gorffen |
| adrodd-url | /prawf/adroddiad-url |
| camau | /prawf/camau |
| cam[id] | /prawf/camau/cam |
| enw | /prawf/camau/cam/enw |
| id | /prawf/camau/cam/id |
| amser cychwyn | /prawf/camau/cam/amser cychwyn |
| amser diwedd | /prawf/camau/cam/amser gorffen |
| statws | /prawf/camau/cam/statws |
| neges statws | /prawf/camau/cam/statws-neges |
| templedi | /templedi |
| templed[enw] | /templedi/templed |
| enw | /templedi/templed/enw |
| disgrifiad | /templedi/templed/disgrifiad |
| paramedrau | /templedi/templed/paramedrau |
| paramedr[allwedd] | /templedi/templed/paramedrau/paramedr |
| cywair | /templedi/templed/paramedrau/paramedr/allwedd |
| math | /templedi/templed/paramedrau/paramedr/math |
Rhagofynion ar gyfer Cerddorfa Brawf
- Er mwyn cychwyn prawf trwy NETCONF gan ddefnyddio cleient NC, mae'n ofynnol yn gyntaf adeiladu templed prawf gan ddefnyddio GUI y Ganolfan Reoli fel y nodir yn y cymorth mewn-app o dan “Profion a monitorau” > “Creu templedi”. Bydd angen pob maes a nodir yn y templed hwnnw fel “Mewnbwn Templed” fel paramedrau yn yr XML wrth drefnu cychwyn y templed prawf.
- Mae cynnal profion yn Paragon Active Assurance yn cael ei ystyried yn “gyflwr” yng nghyd-destun offeryniaeth. Mae data cyflwr yn ddata anysgrifenadwy nad yw'n cael ei storio yn y gronfa ddata ffurfweddu, yn hytrach na'r data ffurfweddu a grybwyllir yn yr adran “Drosview o Test Asiant Orchestration” ar dudalen 17. Mae hyn yn y bôn yn golygu na fydd newidiadau i brofion neu dempledi yn GUI y Ganolfan Reoli yn achosi unrhyw faterion sy'n ymwneud â chysoni rhwng y Ganolfan Reoli a'r gronfa ddata ffurfweddu.
- I gael adroddiad -URL iawn mewn adroddiadau prawf, mae angen i chi wneud yn siŵr y Ganolfan Reoli URL wedi'i ffurfweddu'n gywir. Gwneir hyn yn y file /opt/netrounds-confd/settings.py. Yn ddiofyn, mae enw gwesteiwr y Ganolfan Reoli yn cael ei adfer gan ddefnyddio socket.gethostname(): gweler isod. Os nad yw hyn yn rhoi'r canlyniad cywir, mae angen i chi osod enw'r gwesteiwr (neu'r cyfan URL) â llaw yn hyn file.
# URL o Ganolfan Reoli heb slaes llusgo.
# Mae hyn ar gyfer cynampa ddefnyddir mewn adroddiad prawf -url.
HOSTNAME = socket.gethostname()
NETROUNDS_URL = ' https:// %s ' % HOSTNAME
Dechrau Prawf
Fel y disgrifir yn yr adran “Creu a Defnyddio Asiant Prawf Newydd” ar dudalen 17, rhedwch y gorchymyn pang -f tree netrounds-ncc.yang
o'r cyfeiriadur /opt/netrounds-confd/ er mwyn allbynnu'r model YANG. Yn y model hwn, mae'r RPC ar gyfer dechrau prawf gan ddefnyddio cleient NC yn edrych fel a ganlyn:
Am esboniadau, gweler yr adran “Chwedl” ar dudalen 81 yn yr Atodiad.
Dangosir y camau canlynol isod:
- Mae Asiantau Prawf wedi'u cofrestru i gyfrif Paragon Active Assurance, ond nid oes unrhyw brofion wedi'u cychwyn eto.
- Nodir y paramedrau mewnbwn gofynnol yn y templed prawf a fydd yn cael ei redeg.
- Dechreuir prawf HTTP 60 eiliad gan ddefnyddio ncclient.
Cam 1: Ar y cychwyn, nid oes unrhyw brofion wedi'u cychwyn yn y cyfrif Paragon Active Assurance. Gweler y sgrin isod o GUI y Ganolfan Reoli.
Cam 2: Y templed y byddwn yn ei ddefnyddio i gychwyn y prawf yn yr exampMae le yn dempled prawf HTTP. Mae ganddo ddau faes mewnbwn gorfodol (Cleientiaid a URL) yr ydym wedi'i nodi felly wrth adeiladu'r templed yn GUI y Ganolfan Reoli.
Byddwn yn diffinio'r paramedrau hyn (ymhlith eraill) yn y ffurfweddiad XML a gyfathrebir i'r gronfa ddata ffurfweddu gan ein rheolwr NETCONF (ncclient).
Cam 3: Mae'r prawf HTTP yn cael ei gychwyn gan ddefnyddio ncclient.
Isod mae example cod lle mae'r wybodaeth ffurfweddu angenrheidiol a pharamedrau wedi'u nodi ar gyfer y templed prawf HTTP. Yn dibynnu ar sut mae'r templed wedi'i adeiladu, gall y manylion yma amrywio.
Ar gyfer pob paramedr, mae'r mae angen darparu priodoledd. Mae'r allwedd yn union yr un fath â'r paramedr
Enw newidiol yn y Ganolfan Reoli. Gallwch archwilio enwau newidyn fel a ganlyn:
- Cliciwch Profion ar y bar ochr a dewiswch New Test Sequence.
- Cliciwch Fy Templedi.
- Cliciwch ar y ddolen Golygu o dan y templed o ddiddordeb.
- Cliciwch ar y botwm Golygu mewnbwn yn y gornel dde uchaf.
Yn ein cynample, ac yn ddiofyn, mae'r enwau newidyn yn fersiynau llythrennau bach yn unig o'r enwau arddangos a welir yn y Ganolfan Reoli (“url” vs.URL”, ac ati). Fodd bynnag, yn GUI y Ganolfan Reoli, gallwch ailenwi'r newidynnau i beth bynnag a fynnwch.
Heblaw am yr allwedd, mae angen i bob paramedr gael ei fath wedi'i nodi: ar gyfer example, ar gyfer y URL.
Sylwch fod angen i chi ailview y model YANG cyflawn er mwyn cael gwybodaeth lawn am fathau. Ar gyfer rhyngwynebau Asiant Prawf mae gan y math strwythur mwy cymhleth, fel y dangosir isod yn y cod isod.
Gallwn nawr redeg y sgript gan ddefnyddio ncclient. Gan dybio bod popeth yn gywir, bydd y prawf yn cael ei gychwyn a bydd ei weithrediad yn cael ei arddangos yn y Ganolfan Reoli:
Os caiff y prawf ei ddechrau'n llwyddiannus, bydd y Ganolfan Reoli yn ymateb gydag ID y prawf. Yn y cynampLe, ID y prawf yw 3:
Gellir dod o hyd i'r ID prawf hefyd yn y URL ar gyfer y prawf yn GUI y Ganolfan Reoli. Yn y cynample, bod URL yw https://host/demo/testing/3/.
Adalw Canlyniadau Profion
Y ffordd fwyaf syml o adalw canlyniadau profion yw trwy bwyntio at ID y prawf.
Isod mae cod Python ar gyfer cael y canlyniadau o'r prawf HTTP uchod gydag ID = 3:
gyda rheolwr. Cysylltwch (host=args.host, port=args.port, enw defnyddiwr=args.username, password=args.password, hostkey_verify=Gau) fel m:
Bydd yr allbwn yn edrych rhywbeth fel hyn:
Allforio a Mewnforio Templedi Prawf
Gellir allforio templedi prawf yn fformat JSON a'u hail-fewnforio yn y fformat hwnnw i'r Ganolfan Reoli. Mae hyn yn ddefnyddiol os ydych chi am ddefnyddio templedi prawf mewn gosodiad gwahanol o'r Ganolfan Reoli. (Mae'n well delio â chreu'r templedi cychwynnol trwy GUI y Ganolfan Reoli.)
Isod mae cod ar gyfer perfformio'r allforio a mewnforio.
Allforio Templedi Prawf
# Cael cyfluniad json o'r ymateb
gwraidd = ET.fromstring(ymateb._raw)
json_config = gwraidd[0].text
argraffu json_config
Mae'r templed wedi'i gynnwys yn y gwrthrych json_config.
Mewnforio Templedi Prawf
Gellir ail-fewnforio gwrthrych config JSON sy'n dal templedi prawf i'r Ganolfan Reoli fel a ganlyn.
Examples: Monitors
Mae’r adran hon yn cymryd bod Asiantau Prawf (cymaint ag sy’n ofynnol gan y monitorau) wedi’u creu yn unol â’r adran “Creu a Defnyddio Asiant Prawf Newydd” ar dudalen 17.
Llwybrau Model YANG ar gyfer Monitoriaid
| Eitem | Llwybr model YANG: /cyfrifon/cyfrif/monitro… |
| monitorau | /. |
| monitor[enw] | / monitro |
| enw | /monitro/enw |
| disgrifiad | /monitro/disgrifiad |
| dechrau | /monitro/dechrau |
| templed | /monitro/templed |
| larwm-configs | /monitor/alarm-configs |
| Eitem | Llwybr model YANG: /cyfrifon/cyfrif/monitro/monitro/cyfluniadau larwm … |
| larwm-config[dynodydd] | /alarm-config |
| dynodwr | /alarm-config/dynodydd |
| templed | /alarm-config/template |
| ebost | /alarm-config/e-bost |
| snmp | /alarm-config/snmp |
| thr-es-feirniadol | /alarm-config/thr-es-critical |
| thr-es-beirniadol-clir | /alarm-config/thr-es-critical-clear |
| thr-es-mawr | /alarm-config/thr-es-major |
| thr-es-mawr-clir | /alarm-config/thr-es-major-clear |
| thr-es-mân | /alarm-config/thr-es-mân |
| thr-es-mân-glir | /alarm-config/thr-es-mân-clir |
| thr-es-rhybudd | /alarm-config/thr-es-rhybudd |
| thr-es-rhybudd-clir | /alarm-config/thr-es-warning-clear |
| dim-data-difrifoldeb | /alarm-config/dim-data-difrifoldeb |
| dim-data-amser allan | /alarm-config/no-data-timeout |
| gweithred | /alarm-config/gweithredu |
| maint ffenestr | /alarm-config/window-size |
| cyfwng | /alarm-config/interval |
| anfon-unwaith | /alarm-config/anfon-dim ond-unwaith |
| snmp-trap-per-nant | /alarm-config/snmp-trap-per-stream |
| Eitem | Llwybr model YANG: /cyfrifon/cyfrif/monitro… |
| paramedrau | /monitro/paramedrau |
| Eitem | Llwybr model YANG: /cyfrifon/cyfrif/monitro/monitro/paramedrau … |
| paramedr[allwedd] | /paramedr |
| cywair | /paramedr/allwedd |
| (math o werth) | /paramedr |
| :(cyfanrif) | /paramedr |
| cyfanrif | /paramedr/cyfanrif |
| :( arnofio) | /paramedr |
| arnofio | /paramedr/ arnofio |
| :(llinyn) | /paramedr |
| Eitem | Llwybr model YANG: /cyfrifon/cyfrif/monitro/monitro/paramedrau … |
| llinyn | /paramedr/llinyn |
| : (rhyngwynebau-asiant-prawf) | /paramedr |
| prawf-asiant-rhyngwynebau | /paramedr/profion-asiant-rhyngwynebau |
| test-asiant-interface[“1” ar dudalen 58 | /paramedr/rhyngwynebau-asiant-prawf/ |
| cyfrif | /parameter/test-asiant-rhyngwynebau/prawf-asiant-rhyngwyneb/cyfrif |
| prawf-asiant | /parameter/test-asiant-interfaces/test-asiant-interface/test-asiant |
| rhyngwyneb | /paramedr/prawf-asiant-rhyngwynebau/prawf-asiant-rhyngwyneb/rhyngwyneb |
| ip-fersiwn | /parameter/test-asiant-interfaces/test-agent-interface/ip-version |
| :(twamp-adlewyrchwyr) | /paramedr |
| twamp-adlewyrchwyr | /paramedr/twamp-adlewyrchwyr |
| twamp-adlewyrchydd[enw] | /paramedr/twamp-adlewyrchwyr/twamp-adlewyrchydd |
| enw | /paramedr/twamp-adlewyrchwyr/twamp-adlewyrchydd/enw |
| :(y1731-meps) | /paramedr |
| y1731- meps | /parameter/y1731-meps |
| y1731- ASE[enw] | /parameter/y1731-meps/y1731-mep |
| enw | /parameter/y1731-meps/y1731-mep/name |
| :(sip-cyfrifon) | /paramedr |
| sip-cyfrifon | /parameter/sip-cyfrifon |
| sip-cyfrif[“2” ar dudalen 58] | /parameter/sip-accounts/sip-cyfrif |
| cyfrif | /parameter/sip-accounts/sip-cyfrif/cyfrif |
| prawf-asiant | /parameter/sip-accounts/sip-count/test-agent |
| rhyngwyneb | /parameter/sip-accounts/sip-cyfrif/rhyngwyneb |
| sip-cyfeiriad | /parameter/sip-accounts/sip-account/sip-address |
| :(sianeli iptv) | /paramedr |
| iptv-sianeli | /parameter/iptv-sianeli |
| sianel iptv[enw] | /parameter/iptv-sianels/iptv-channel |
| enw | /parameter/iptv-sianels/iptv-channel/name |
- rhyngwyneb prawf-asiant cyfrif
- cyfrif prawf-asiant rhyngwyneb sip-cyfeiriad
| Eitem | Llwybr model YANG: /cyfrifon/cyfrif/monitro… |
| statws | /monitro/statws |
| olaf-15-munud | /monitor/status/last-15-minutes |
| statws | /monitor/status/last-15-minutes/status |
| statws-gwerth | /monitor/status/last-15-minutes/status-value |
| awr olaf | /monitro/statws/awr olaf |
| statws | /monitro/statws/awr-olaf/statws |
| statws-gwerth | /monitor/status/last-hour/status-value |
| olaf-24-awr | /monitor/status/last-24-awr |
| statws | /monitor/status/last-24-hours/status |
| statws-gwerth | /monitor/status/last-24-hours/status-value |
| templedi | /templedi |
| templed[enw] | /templedi/templed |
| enw | /templedi/templed/enw |
| disgrifiad | /templedi/templed/disgrifiad |
| paramedrau | /templedi/templed/paramedrau |
| paramedr[allwedd] | /templedi/templed/paramedrau/paramedr |
| cywair | /templedi/templed/paramedrau/paramedr/allwedd |
| math | /templedi/templed/paramedrau/paramedr/math |
Rhagofynion ar gyfer Monitro Cerddorfa
Cyn i chi allu cychwyn monitor trwy NETCONF gan ddefnyddio ncclient, mae angen i chi adeiladu templed monitor yn GUI y Ganolfan Reoli fel yr eglurir yn y cymorth mewn-app o dan “Profion a monitorau” > “Creu templedi”. Bydd angen pob maes a nodir fel “Mewnbwn Templed” yn y templed hwnnw fel paramedrau yn yr XML wrth drefnu cychwyn y templed.
Cael Paramedrau Mewnbwn o Dempledi Monitor
Isod, dangosir dau dempled. Mae'r cyntaf ar gyfer monitro CDU rhwng dau ryngwyneb Asiant Prawf, a'r ail ar gyfer HTTP gan ddefnyddio un rhyngwyneb Asiant Prawf.
I ddarganfod paramedrau mewnbwn templed, cliciwch y blwch sy'n cynrychioli'r templed. Ar gyfer y templed HTTP, gall y paramedrau edrych fel hyn:
Mae angen inni ddiffinio'r paramedrau hyn yn y cam nesaf wrth ddechrau monitor.
Dechrau Monitor
Gan ddefnyddio’r Asiantau Prawf y gwnaethom eu diffinio a’u defnyddio yn yr adran “Creu a Defnyddio Asiant Prawf Newydd” ar dudalen 17, gallwn ddechrau monitor o’r templed “HTTP” fel y dangosir isod.
Ar gyfer pob paramedr, mae'r mae angen darparu priodoledd. Mae'r allwedd yn union yr un fath ag enw Newidyn y paramedr yn y Ganolfan Reoli. Gallwch archwilio enwau newidyn fel a ganlyn:
- Cliciwch Monitro ar y bar ochr a dewiswch Monitor Newydd.
- Cliciwch Fy Templedi.
- Cliciwch ar y ddolen Golygu o dan y templed o ddiddordeb.
- Cliciwch ar y botwm Golygu mewnbwn yn y gornel dde uchaf.
Yn ein cynample, ac yn ddiofyn, mae'r enwau newidyn yn fersiynau llythrennau bach yn unig o'r enwau arddangos a welir yn y Ganolfan Reoli (“url” vs.URL”, ac ati). Fodd bynnag, yn GUI y Ganolfan Reoli, gallwch ailenwi'r newidynnau i beth bynnag a fynnwch.
Heblaw am yr allwedd, mae angen i bob paramedr gael ei fath wedi'i nodi: ar gyfer example, ar gyfer y URL. Sylwch fod gwybodaeth lawn am y math o baramedr i'w chael yn y model YANG. Ar gyfer rhyngwynebau Asiantau Prawf mae gan y math strwythur mwy cymhleth, fel y gwelir yn y cod isod.
Yn y cynampGyda hynny'n dilyn, nid oes larwm yn gysylltiedig â'r monitor. Am gynampllai yn ymwneud â larymau, ewch i’r adran “Dechrau Monitor gyda Larwm” ar dudalen 62.
Dechrau Monitor gyda Larwm
I gysylltu larwm â monitor, gallwch naill ai bwyntio at dempled larwm sydd wedi'i ddiffinio, neu gallwch gyflenwi'r cyfluniad larwm cyfan wrth greu'r monitor. Byddwn yn rhoi un exampar gyfer pob agwedd isod.
Gosod Larwm Monitor trwy Bwyntio at Dempled Larwm
Er mwyn gwneud defnydd o dempled larwm, rhaid i chi wybod ei ID. I’r perwyl hwn, yn gyntaf adalw’ch holl dempledi larwm fel y disgrifir yn yr adran “Adalw Pob Templed Larwm” ar dudalen 39 a nodwch enw’r templed perthnasol. Yna gallwch gyfeirio at y templed hwnnw fel a ganlyn:
Gosod Larwm Monitor trwy ei Gyflunio'n Uniongyrcholy
Fel arall, gallwch chi osod larwm ar gyfer monitor trwy gyflenwi ei gyfluniad cyfan wrth greu'r monitor, heb gyfeirio at dempled larwm. Gwneir hyn fel y dangosir yn yr ecsample.
Adalw Rhedeg Monitors
I adalw'r holl fonitorau sy'n gweithredu ar hyn o bryd, rhedwch y sgript hon:
gyda rheolwr. connect(host=args.host, port=args.port, enw defnyddiwr=args. enw defnyddiwr, cyfrinair=args.password, hostkey_verify=Gau) fel m:
Mae'r allbwn yn rhestr o'r holl fonitorau rhedeg fel y dangosir isod:
Adalw Statws CLG ar gyfer Monitor
Dyma sut i adfer y statws CLG ar gyfer monitor. Yn y cynampLe, rydym yn adennill y statws CLG ar gyfer y monitor “Ansawdd Rhwydwaith” am dri chyfnod: y 15 munud olaf, yr awr olaf, a'r 24 awr olaf.
Bydd yr allbwn yn edrych rhywbeth fel hyn:
Hysbysiadau NETCONF
Mae hysbysiadau NETCONF ar gyfer monitorau yn cael eu sbarduno gan droseddau CLG. Mae'r rhain yn digwydd pan fydd y CLG ar gyfer y monitor yn disgyn o dan drothwy CLG (“Da” neu “Derbyniol”) o fewn cyfnod penodol o amser, yn ddiofyn y 15 munud olaf. Dylid nodi bod hysbysiadau torri CLG yn ymddangos yn gyflym ar ôl i wasanaeth gael ei effeithio gan broblem, tra bydd y statws CLG yn dychwelyd i “Da” dim ond ar ôl 15 munud, a dim ond os na fydd unrhyw droseddau pellach yn digwydd.
Gellir newid y ffenestr amser trwy olygu'r gosodiad SLA_STATUS_WINDOW (gwerth mewn eiliadau) i mewn /etc/netrounds/netrounds.conf.
Allforio a Mewnforio Templedi Monitor
Gwneir hyn yn union yr un ffordd ag ar gyfer templedi prawf; cymharwch yr adran “Allforio a Mewnforio Templedi Prawf” ar dudalen 52. Mae'r pytiau cod isod yn dangos sut i allforio a mewnforio templedi ar gyfer monitorau.
Allforio Templedi Monitor
Mewnforio Templedi Monitor
Tags a ddiffinnir yn Paragon Active Assurance gellir ei gymhwyso i:
- monitorau
- monitro templedi
- Asiantau Prawf
- TWAMP adlewyrchwyr
- Gwesteiwyr ping.
Am gynample, gallwch tag monitor gyda'r un peth tag fel is-set o Asiantau Prawf sy'n mynd i redeg y monitor. Mae'r nodwedd hon yn arbennig o ddefnyddiol os oes gennych nifer fawr o fonitorau a thempledi wedi'u diffinio.
Os ydych wedi gosod larwm gyda thrapiau SNMP ar gyfer monitor, yna bydd yr un trapiau SNMP yn cael eu neilltuo tags fel y monitor, os o gwbl.
Creu Tags
Isod rydym yn dangos sut i greu a tag gydag enw a lliw fel y'u diffinnir gan yr XMLtag> is-strwythur.
aseinio a Tag
I neilltuo a tag at adnodd, rydych chi'n ei ychwanegu fel newyddtag> elfen o dan ytags> elfen ar gyfer yr adnodd hwnnw.
Dyma sut i aseinio a tag i Asiant Prawf:
I neilltuo a tag i TWAMP adlewyrchydd, gwnewch y canlynol:
aseinio a tag i fonitor yn cael ei drin yn yr un modd:
Fel arall, gallwch neilltuo un sy'n bodoli eisoes tag i unrhyw un o'r mathau hyn o adnoddau wrth greu'r adnodd, drwy gynnwys ytags> elfen yn cynnwys y tag dan sylw.
Wrthi'n diweddaru a Tag
Diweddaru un sy'n bodoli eisoes tag gyda phriodoleddau newydd yn cyfateb i greu a tag:
dadneilltuo a Tag
I ddadneilltuo a tag o adnodd, ychwanegwch y priodoledd nc:operation=”dileu” i'rtag> elfen sy'n perthyn i'r adnodd. Isod, rydym yn dadneilltuo a tag o fonitor.
Wrthi'n dileu a Tag
Er mwyn dileu a tag yn gyfan gwbl o'r Ganolfan Reoli, mae'r briodwedd nc:operation="dileer" yn cael ei ddefnyddio eto, ond y tro hwn yn berthnasol i'r tag ei hun, a ddiffinnir o dan .
Datrys problemau
Problem: Sicrwydd Gweithredol y Cerddorfa a'r Paragon Allan o Gysoni
Gall y cerddorfawr a Paragon Active Assurance ddod i ben allan o sync ar gyfer cynample os yw newidiadau cyfluniad wedi'u gwneud yn GUI y Ganolfan Reoli, neu os nad oedd cymhwyso cyfluniad yn llwyddiannus a bod dychwelyd i'r cyflwr blaenorol wedi methu.
Os bydd dychweliad yn methu, ni fydd gweinydd NETCONF bellach yn derbyn newidiadau cyfluniad; bydd yn ateb gyda neges gwall yn nodi bod y ffurfweddiad wedi'i gloi nes ei fod wedi'i gysoni. Er mwyn dychwelyd i gysoni a datgloi newidiadau cyfluniad, mae angen i chi redeg y gorchymyn rpc sync-from-ncc sy'n cydamseru'r holl gyfluniad o'r Ganolfan Reoli i'r gronfa ddata ffurfweddu.
NODYN: Mae'r confd@netrounds.com rhaid i ddefnyddiwr (neu beth bynnag sydd wedi'i ffurfweddu) gael breintiau superuser er mwyn i bopeth gael ei gysoni'n llwyddiannus. Gellir cyflawni hyn gyda'r diweddariad defnyddiwr gorchymyn ncc confd@netrounds.com –is-superuser Os nad yw'r defnyddiwr yn uwch-ddefnyddiwr, bydd rhybudd yn ymddangos yn dweud na ellid cysoni popeth, ond mai'r cyfan y gellid ei drin sydd wedi digwydd.
NODYN: Os yw eich cerddorfa hefyd yn storio'r cyfluniad, bydd angen i chi ail-gydamseru hwnnw hefyd gan na fydd y cyfluniad y gofynnwyd amdano (y ffurfweddiad y mae'r cerddorfawr yn disgwyl i'r Ganolfan Reoli) wedi'i gymhwyso.
Problem: Methwyd Cysoni Cychwynnol (sync-from-ncc) Oherwydd Adnoddau Heb eu Cefnogi
Os ceisiwch redeg rpc sync-from-ncc ar gyfrif sydd â'i ffurfweddiad wedi'i greu yn GUI y Ganolfan Reoli, efallai y byddwch chi'n cael problemau os yw'r cyfrif yn cynnwys adnoddau heb eu cefnogi. Argymhellir eich bod yn dechrau gyda chyfrif gwag a gwneud yr holl gyfluniad ohono trwy NETCONF. Fel arall, os byddwch yn dod ar draws problemau gyda gwrthdaro adnoddau, bydd yn rhaid i chi dynnu'r adnoddau sy'n gwrthdaro o'r cyfrif.
Problem: Mae gorchmynion NETCONF yn methu gyda ncclient.operations.rpc.RPCError: methiant cyfathrebu cais
Nid yw gweinydd NETCONF yn adfer cysylltedd â gweinydd y Ganolfan Reoli yn awtomatig os caiff y Ganolfan Reoli ei hailddechrau. I adfer y cysylltiad â'r Ganolfan Reoli, ailgychwynnwch y broses NETCONF: ailgychwyn sudo systemctl netrounds-confd
Nodiadau ar Geisiadau Asiantau Prawf a Chyfarpar Asiantau Prawf
Ceisiadau Asiant Prawf yn ConfD
Ymhlith Asiantau Prawf, mae'r Cais Asiant Prawf (mwy newydd) yn gweithio ychydig yn wahanol i'r Offer Asiant Prawf (hŷn).
Nid yw Cymwysiadau Asiant Prawf yn cefnogi cyfluniad rhyngwyneb ar hyn o bryd. Felly, mae sgema YANG yn caniatáu pennu cyfluniad rhyngwyneb gwag ar gyfer Asiantau Prawf o'r fath. Gweler “y darn hwn” ar dudalen 23 am gynample.
Wrth gydamseru'r gronfa ddata ConfD â'r Ganolfan Reoli gan ddefnyddio'r gorchymyn sync-from-ncc, rydych chi am i'r cyfluniad rhyngwyneb aros yn wag a pheidio â chael ei drosysgrifo â'r hyn a geir yn y Ganolfan Reoli. Felly mae angen i chi ddefnyddio baner arbennig -without_interface_config gyda'r gorchymyn hwnnw wrth weithio gyda Chymwysiadau Asiant Prawf.
Ffurfweddiad Rhyngwyneb Gwag ar gyfer Offer Asiant Prawf
Fel y nodwyd uchod, nid yw Test Asiant Application yn cefnogi cyfluniad rhyngwyneb, ac felly mae'n bosibl hepgor rhyngwynebau yn sgema YANG.
Ond mae yna hefyd achosion defnydd lle efallai y byddwch am hepgor cyfluniad y rhyngwyneb o Gyfarpar Asiant Prawf. Mae cynampGallai hyn fod yn senario offeryniaeth lle rydych chi'n troi Asiant Prawf gan ddefnyddio cloud-init, a'ch bod am i'r cyfluniad rhyngwyneb o'r fan honno gael ei ddefnyddio, yn lle gadael i ConfD ei drosysgrifo wrth i'r Asiant Prawf ddod ar-lein.
Newidiadau Sgema YANG Ynghylch Rhyngwynebau Anniffiniedig
Gan fod cyfluniad rhyngwyneb gwag bellach yn cael ei ganiatáu (o fersiwn 2.34.0 ymlaen), mae'n bosibl nodi unrhyw enw rhyngwyneb fel mewnbwn i dasg sy'n rhedeg fel rhan o brawf neu fonitor.
Mae angen hwn er mwyn gallu defnyddio Cymhwysiad Asiant Prawf, oherwydd ar gyfer y rhain nid oes unrhyw enwau rhyngwyneb wedi'u diffinio yn ConfD. Sylwch, fodd bynnag, fod hyn hefyd yn golygu y gallwch fynd i broblemau os byddwch yn ffurfweddu prawf neu fonitor ar ddamwain i ddefnyddio rhyngwyneb nad yw'n bodoli. Felly cofiwch hyn.
Cyfyngiadau Wrth Gofrestru Asiant Prawf Wedi'i Greu yn ConfD
Wrth greu Asiant Prawf trwy'r API REST neu NETCONF/YANG, ni allwn wybod ymlaen llaw pa fath ydyw: Offer Asiant Prawf neu Gais Asiant Prawf. Daw hyn yn glir dim ond ar ôl i'r Asiant Prawf gofrestru.
Unwaith y bydd yr Asiant Prawf wedi'i gofrestru ac wedi troi'n un o'r mathau concrit hyn, ni chaniateir i chi ei ailgofrestru fel math gwahanol o Asiant Prawf. Mae hyn yn golygu na chaniateir i chi ei gofrestru yn gyntaf fel Offer Asiant Prawf, yna ei ailgofrestru fel Cais Asiant Prawf, neu i'r gwrthwyneb. Os oes angen Asiant Prawf o fath gwahanol arnoch, bydd angen i chi greu Asiant Prawf newydd.
Atodiad: Strwythur Coed Model YANG Llawn
Yn yr atodiad hwn, mae'r adran “Chwedl” ar dudalen 81 yn esbonio cystrawen strwythur coeden enghreifftiol YANG a gynhyrchir gyda'r goeden gorchymyn pyang -f.
Mae'r adran “YANG Model Tree Structure” ar dudalen 82 yn rhoi'r allbwn o'r gorchymyn hwnnw a gymhwyswyd i netrounds-ncc.yang. Mae rhannau o'r allbwn hwn yn cael eu hatgynhyrchu mewn man arall yn y ddogfen.
Chwedl
Strwythur Coed Model YANG
Mae Juniper Networks, logo Juniper Networks, Juniper, a Junos yn nodau masnach cofrestredig Juniper Networks, Inc. yn yr Unol Daleithiau a gwledydd eraill. Mae'r holl nodau masnach, nodau gwasanaeth, nodau cofrestredig, neu nodau gwasanaeth cofrestredig eraill yn eiddo i'w perchnogion priodol. Nid yw Juniper Networks yn cymryd unrhyw gyfrifoldeb am unrhyw wallau yn y ddogfen hon. Mae Juniper Networks yn cadw'r hawl i newid, addasu, trosglwyddo, neu fel arall ddiwygio'r cyhoeddiad hwn heb rybudd. Hawlfraint © 2023 Juniper Networks, Inc Cedwir pob hawl.
Dogfennau / Adnoddau
 |
Juniper NETWORKS Meddalwedd API NETCONF & Yang [pdfCanllaw Defnyddiwr Meddalwedd API NETCONF YANG, Meddalwedd API YANG, Meddalwedd API, Meddalwedd |