NETCONF & YANG API Orchestration
Treoraí
Foilsithe
2023-07-07
SCAOILEADH 4.2
Réamhrá
Aidhm an Doiciméid seo
Déanann an doiciméadú seo cur síos ar conas Paragon Active Assurance a chomhtháthú le ceolfhoireann seirbhíse líonra tríd an Lárionad Rialaithe NETCONF & YANG API. Lámh-ar examptugtar sonraí ar na príomhthascanna a bhíonn i gceist, lena n-áirítear: Gníomhairí Fíorúla Tástála a chruthú agus a imscaradh, tástálacha agus monatóirí a rith, agus torthaí a aisghabháil ó na gníomhaíochtaí sin.
Sa doiciméad seo, úsáidtear an cliant ncclient Python NETCONF atá ar fáil saor in aisce i ról an cheoltóra.
Coinbhinsiúin
Úsáidtear na giorrúcháin seo a leanas sa doiciméad seo:
| Giorrúchán | Brí |
| CLI | Comhéadan Líne Ordú |
| EM | Bainisteoir Eilimint |
| ES | Earráid Dara |
| FPE | MEG (Grúpa Aonán Cothabhála) Deireadhphointe (sainmhíniú ITU-T Y.1731) nó Deireadhphointe Cothabhála (sainmhíniú Cisco) |
| NFV | Fíorúú Feidhm an Líonra |
| NFVO | Ceolfhoireann Fíorúlaithe Feidhm Líonra |
| NSD | Tuairisceoir Seirbhíse Líonra |
| RPC | Glaoch ar Nós Imeachta Cianda |
| SIP | Prótacal Tionscnaimh Seisiúin |
| SLA | Comhaontú Leibhéil Seirbhíse |
| S-VNFM | Bainisteoir Speisialta VNF |
| VNF | Feidhm Líonra Fíorúil |
| vTA | Gníomhaire tástála fíorúil |
Nótaí ar Chomhoiriúnacht Siar
I leaganacha 2.35.4/2.36.0 den API NETCONF & YANG, rinneadh bailíochtú iarratas áirithe chun cloí le caighdeán NETCONF. Ciallaíonn sé seo go bhféadfadh sé go ndiúltófaí anois do chód cliaint atá bunaithe ar leaganacha níos sine den treoir seo.
Le haghaidh example, i Python roimhe seo example cód, níor soláthraíodh aitreabúid ainmspáis. Ní mór an t-ainmspás a sholáthar anois san iarratas XML aon uair is mian leat acmhainn ConfD a mhodhnú.
Réamhriachtanais agus Ullmhóidí
Suiteáil ConfD
Úsáidtear ConfD (táirge ó Tail-f) mar idirghabhálaí idir an córas Paragon Active Assurance agus NETCONF. Ceanglaíonn ConfD cumraíocht Paragon Active Assurance agus sonraí oibriúcháin leis an NETCONF & YANG API.
Ba cheart go mbeadh confD suiteáilte in éineacht le bogearraí an Lárionaid Rialaithe, mar a thuairiscítear sa Treoir Suiteála.
Ag Fíorú Go bhfuil ConfD ag Rith
Chun a fhíorú go bhfuil an ConfD ag feidhmiú, rith an t-ordú
ssh -s @ localhost -p 830 netconf
chun a sheiceáil go bhfreagraíonn ConfD ar phort 830. Sa ordú, mar atá sainmhínithe ag an úsáideoir netconf create
ordú sa Treoir Suiteála, alt Suiteáil ConfD. Tabhair an focal faire atá sainmhínithe ag an ordú céanna.
San aschur, deimhnigh go bhfuil modúl an Ionaid Rialaithe san áireamh. Ba cheart go mbeadh líne mar seo a leanas san aschur:
http://ncc.netrounds.com?module=netrounds-ncc&léirmheas=2017-06-15
An Bunachar Sonraí Cumraíochta a shioncronú leis an Lárionad Rialaithe
Ar deireadh, ní mór dúinn an bunachar sonraí cumraíochta a nuashonrú trí NETCONF. Déanfaimid amhlaidh anseo trí leabharlann Python ar a dtugtar ncclient (NETCONF Cliant). Mar sin féin, d’fhéadfaí an tasc a chur i gcrích i dteanga ríomhchlárúcháin eile chomh fada agus a úsáideann sé prótacal NETCONF/YANG.
Is é ról ncclient feidhmiú mar chliant i dtreo an fhreastalaí ConfD a dhéanann óstáil ar an NETCONF/YANG API.
Is fiú a thabhairt le fios nach bhfuil baint ar bith ag ncclient leis an Lárionad Rialaithe (“Netrounds Control Centre roimhe seo”), cé go dtarlaíonn an t-ainm chun tús a chur le “ncc”.
Seo conas ncclient a shuiteáil:
- Íoslódáil an bogearraí ó https://github.com/ncclient/ncclient.
- Rith an t-ordú seo: pip install ncclient
Is féidir linn an sioncrónú a dhéanamh anois mar seo a leanas. Tabhair faoi deara go cúramach gur gá é seo a dhéanamh ar ríomhaire ar leith, agus ní ar fhreastalaí an Ionaid Rialaithe féin:
#
# NÓTA:
# Feidhmíonn an script seo mar chliant i dtreo ConfD a ritheann ar fhreastalaí an NCC.
# Bainfidh sé úsáid as an NETCONF/YANG API le haghaidh cumarsáide.
NÓTA: Tá an nós imeachta seo ag teastáil freisin nuair a bhíonn Gníomhairí Tástála suiteáilte agus cláraithe go neamhspleách ar NETCONF. Féach an nóta sa rannán “Tharview of Test Gníomhaire Orchestration” ar leathanach 17 le haghaidh tuilleadh eolais.
Ag Bunú Ilchuntais Dearbhaithe Paragon Gníomhacha atá rialaithe ag NECONF
Níl na céimeanna thíos ag teastáil ach amháin más mian leat cuntais bhreise Paragon Active Assurance a bhunú a bheidh faoi rialú NETCONF, chomh maith leis an gcuntas atá cumraithe ar an mbealach seo sa Treoir Suiteála, sa rannán “Installing ConfD”.
I gcás gach cuntas den sórt sin, lean ar aghaidh mar a leanas:
- Sa Lárionad Rialaithe, logáil isteach sa chuntas agus déan nascleanúint chuig Cuntas > Ceadanna.
- Cuir an t-úsáideoir leis "confd@netrounds.com“, agus deonaigh cead riaracháin don úsáideoir ConfD seo sa GUI trí chliceáil ar an gcnaipe Cuireadh.
- Sioncrónaigh an bunachar sonraí cumraíochta leis an Lárionad Rialaithe mar a thuairiscítear sa rannán “An Bunachar Sonraí Cumraíochta a Shioncronú leis an Lárionad Rialaithe” ar leathanach 4.
Ba cheart go mbeifeá in ann cuntais iolracha Paragon Active Assurance a rialú anois leis an úsáideoir ConfD céanna.
NÓTA: Nuair a thosaíonn tú ag rialú cuntas Paragon Active Assurance trí ConfD, NÍ cead duit athruithe a dhéanamh ar an gcuntas seo tríd an web GUI maidir le haon ghnéithe Paragon Active Assurance atá “config” (féach an chaibidil “Gnéithe Tacaithe i Paragon Active Assurance” ar leathanach 9). Má dhéanann tú, caillfear an sioncronú.
Réamhrá ar NETCONF Orchestration API
Tharview
Is gnách gurb é NFVO nó ceolfhoireann seirbhíse tríú páirtí an chomhpháirt a chuireann tús le seisiúin tástála agus monatóireachta ag baint úsáide as API an Ionaid Rialaithe. Aisghabhann an ceolfhoireann seo na torthaí tomhais comhiomlána ó ghníomhaíochtaí an Ghníomhaire Tástála freisin. Féadfaidh Córais Bhainistíochta Feidhmíochta tríú páirtí KPIanna feidhmíochta a aisghabháil, agus is féidir imeachtaí - a luaithe a spreagtar sáruithe tairsí a socraíodh san Lárionad Rialaithe - a sheoladh chuig córais Bainistíochta Lochtanna tríú páirtí.
Mar achoimre, léiríonn an figiúr thíos conas a idirghníomhaíonn Paragon Active Assurance le córais tríú páirtí eile sa tírdhreach OSS.
- NFVO/Ceolfhoireann Seirbhíse: Tugann sé treoir don Bhainisteoir VNF na vTAanna a imscaradh agus Paragon Active Assurance a chumrú isteach sa slabhra seirbhíse. Nuair a bhíonn an tseirbhís curtha i ngníomh, úsáideann an ceolfhoireann an API i dtreo an Lárionaid Rialaithe chun tástálacha gníomhachtaithe seirbhíse a thionscnamh agus chun torthaí pas/teip a fháil. Má dhéantar na tástálacha a rith, úsáidfidh an ceolfhoirneoir an API i dtreo an Ionaid Rialaithe chun monatóireacht ghníomhach a thosú ar an tseirbhís. Aisghabhann an ceolfhoirneoir nó ardán Bainistíochta Feidhmíochta ar leith na KPIanna go leanúnach ón monatóireacht.
- Lárionad Rialaithe: Déanann sé an vTA a imscaradh, a scálaí agus a fhoirceannadh mar a threoraíonn an NFVO nó an ceolfhoireann seirbhíse.
- Córas Bainistíochta Feidhmíochta nó córas Bainistíochta Cáilíochta Seirbhíse: Léann sé KPIanna ó mhonatóireacht ghníomhach trí API an Ionaid Rialaithe.
- Córas Bainistíochta Lochtanna: Faigheann NETCONF, SNMP, nó fógraí ríomhphoist ón Lárionad Rialaithe má sháraítear CLSanna.
Sainmhínithe ar Choincheapa i nDeimhniú Gníomhach Paragon
- Gníomhairí Tástála: Na comhpháirteanna a dhéanann tomhais (le haghaidh tástálacha chomh maith le monatóireacht) i gcóras Dearbhaithe Gníomhach Paragon. Is éard atá i nGníomhairí Tástála bogearraí a bhfuil an cumas acu fíorthrácht líonra a ghiniúint, a fháil agus a anailísiú.
- Is é an cineál Gníomhaire Tástála a phléitear sa doiciméad seo ná an Gníomhaire Tástála Fíorúil (vTA), feidhm líonra fíorúil (VNF) a imscartar ar hypervisor. Tá cineálacha eile Gníomhairí Tástála ann freisin.
- Tá dhá chineál tomhais bhunúsacha in Paragon Active Assurance, tástálacha agus monatóireacht.
- Tástáil: Is éard atá i dtástáil ná céim amháin nó roinnt céimeanna, a bhfuil fad chríochnaithe sonraithe ag gach ceann acu. Déantar céimeanna a fhorghníomhú go seicheamhach. D’fhéadfadh go mbeadh i gceist le gach céim go n-imreofaí tascanna iolracha i gcomhthráth.
- Monatóir: Níl achar sonraithe ag monatóir ach feidhmíonn sé ar feadh tréimhse éiginnte. Cosúil le céim i dtástáil, féadfaidh monatóir tascanna iolracha comhthráthacha a dhéanamh.
- Teimpléad: Nuair a bhíonn Paragon Active Assurance á rialú ag ceolfhoirneoir, déantar tástálacha agus monatóirí i gcónaí trí theimpléid ina sainítear an tástáil nó an monatóir. Is féidir socruithe paraiméadar a chur ar aghaidh mar ionchuir chuig an teimpléad ag am rite.
Sreabhadh oibre le haghaidh Uathoibriú
Am Dearaidh
Ag am dearaidh, ullmhaíonn tú tomhais trí theimpléid a chruthú do thástálacha agus do mhonatóirí i Paragon Active Assurance. Tá conas é sin a dhéanamh clúdaithe sa chaibidil “Teimpléid Tástála agus Monatóireachta” ar leathanach 15.
Am rite
Ag am rite, socraíonn tú do ghléasanna agus déanann tú na tomhais iarbhír.
- An os cionnview de gach examptá níos lú tugtha sa chaibidil “Exampníos lú de Rialú Paragon Active Assurance via NETCONF & YANG API” ar leathanach 15.
- Tá conas Gníomhairí Tástála a imscaradh agus a chumrú imithe tríd sa chaibidil “Examples: Gníomhairí Tástála” ar leathanach 16.
- Conas earraí fardail a allmhairiú mar TWAMP tá frithchaiteoirí agus cainéil IPTV imithe tríd sa chaibidil “Examples: Míreanna Fardail” ar leathanach 29.
- Mínítear conas aláraim a chumrú sa chaibidil “Examples: Aláraim” ar leathanach 35.
- Déantar cur síos sna caibidlí “Examples: Tástálacha” ar leathanach 43 agus “Examples: Monatóirí” ar leathanach 54.
Gnéithe Tacaithe i Paragon Active Assurance
Is féidir gach cineál tástála agus monatóireachta i Paragon Active Assurance a chruthú agus a fhorghníomhú trí úsáid a bhaint as teimpléid. Tá conas é seo a dhéanamh clúdaithe sa chabhair in-app faoi “Tástálacha agus monatóirí” > “Teimpléid a chruthú”.
Ní thacaítear faoi láthair le cuntais Paragon Active Assurance a chruthú; áfach, beidh cuntas réamhshainithe amháin nó níos mó curtha ar bun don úsáideoir.
Sonraíonn na táblaí thíos cad iad na gnéithe i Paragon Active Assurance atá ar fáil san eisiúint seo, agus conas a léirítear na gnéithe seo i YANG.
Míniú ar YANG Constructs
Ar mhaithe le caoithiúlacht, tugtar sainmhínithe anseo ar na tógálacha YANG dá dtagraítear sa tábla gnéithe.
- Cumraíocht (config=true): Sonraí cumraíochta, atá riachtanach chun córas a athrú ó stát amháin go stát eile.
- Luaigh (config= bréagach): Luaigh sonraí: sonraí breise ar chóras nach sonraí cumraíochta é, amhail faisnéis stádais inléite amháin agus staitisticí bailithe.
- RPC: Glao ar Nós Imeachta Cianda, mar a úsáidtear laistigh de phrótacal NETCONF.
- Fógra: Fógraí imeachta seolta ó fhreastalaí NETCONF chuig cliant NETCONF.
Táblaí de Ghnéithe Dearbhaithe Gníomhacha Paragon Ar Fáil le haghaidh Ceolfhoirne
Acmhainn: Monatóireacht
Cosán YANG:/cuntais/cuntas/monatóireacht
| Gné | Foghné | Yang tógáil |
| Cruthaigh/mionathraigh/scrios monatóir | Bunaithe ar an teimpléad monatóireacht a dhéanamh | Cumraíocht |
| Monatóir tosaithe/stad | – | Cumraíocht |
| Monatóireacht a dhéanamh ar teimpléid | Liostaigh na teimpléid mhonatóra atá ann cheana féin le hionchuir | Stáit |
| Fógraí NETCONF | D'athraigh staid an aláraim | Fógra |
| Monatóireacht a dhéanamh ar thorthaí | Cuntar SLA/ES don ardleibhéal (%) Áiritheoir SLA/ES do leibhéal an taisc (%) |
Stáit |
Murab ionann agus tástálacha (comparáid Acmhainn: Tástálacha thíos), ní chuirtear tús le monatóirí le RPC ach ina áit sin trí chumraíocht an mhonatóra a dhéanamh.
Acmhainn: Tástálacha
Cosán YANG: /cuntais/cuntas/tástálacha
| Gné | Foghné | Yang tógáil |
| Tosaigh tástáil | Bunaithe ar an teimpléad tástála | RPC |
| Bainistigh tástálacha | Déan liosta de na tástálacha le stádas | Stáit |
| Teimpléid tástála | Liostaigh na teimpléid thástála atá ann cheana féin le hionchuir | Stáit |
| Fógraí NETCONF | Athraíodh stádas na tástála | Fógra |
| Torthaí tástála | Faigh stádas na céime tástála (pas, teip, earráid, ...) | Stáit |
Acmhainn: Gníomhairí Tástála
cosáin YANG:
- /cuntais/cuntas/gníomhairí tástála (Cumraíocht)
- /cuntais/cuntas/gníomhairí tástála-cláraithe (Stát)
Is iad Gníomhairí Tástála faoi /cuntais/cuntas/gníomhairí tástála na cinn atá cumraithe i gcuntas. Ní féidir leis an gceolfhoireann ach na Gníomhairí Tástála seo a chumrú agus a úsáid i dtástálacha agus i monatóirí trí NETCONF.
Tar éis duit Gníomhaire Tástála a chumrú agus é cláraithe leis an gcuntas, beidh an Gníomhaire Tástála le feiceáil faoi /accounts/account/registered-test-agents. Is féidir leat gach Gníomhaire Tástála cláraithe a aimsiú trí ordú “faigh” in NETCONF (cuir an chaibidil Examples: Gníomhairí Tástála).
Faoi /accounts/account/registered-test-agents seans go bhfaighidh tú Gníomhairí Tástála nach bhfuil cumraithe fós. Ní mór aon Ghníomhairí Tástála dá leithéid a chumrú sular féidir iad a úsáid.
I gcás ceolfhoirne, moltar go ginearálta go ndéanann tú gach cumraíocht de do chuntas Paragon Active Assurance trí NETCONF. Cinntíonn sé seo nach bhfuil éagsúlachtaí idir gníomhairí tástála agus gníomhairí tástála cláraithe.
| Gné | Foghné | Yang tógáil |
| Réamh-chruthaigh Gníomhaire Tástála ar an bhfreastalaí | – | Cumraíocht |
| Cumraigh Gníomhaire Tástála as líne | (Cuireann an Lárionad Rialaithe an cumraíocht chuig Gníomhaire Tástála nuair a thagann sé ar líne) |
Cumraíocht |
| Úsáid Gníomhairí Tástála atá ann cheana nó atá cumraithe go seachtrach | Úsáid sa tástáil/monatóireacht | Cumraíocht |
| Cumraigh comhéadain | Cumraíocht | |
| Faigh stádas | Stáit | |
| Cumraigh Gníomhaire Tástála (Fearas Tástála amháin) | Cumraigh NTP | Cumraíocht |
| Cumraigh droichid | Cumraíocht | |
| Cumraigh comhéadain VLAN | Cumraíocht | |
| Cumraigh eochracha SSH | Cumraíocht | |
| IPv6 | Cumraíocht | |
| Utils | Atosaigh | RPC |
| Nuashonrú | RPC | |
| Fógraí NETCONF | Athraíodh an stádas ar líne | Fógra |
| Stádas | Faigh stádas córais (aga fónaimh, úsáid cuimhne, meán luchtaithe, leagan) |
Stáit |
Acmhainn: Fardal
Cosán YANG: /cuntais/cuntas/twamp-fhrithchaiteoirí
Cumais NECONF tacaithe
Léiríonn an tábla thíos RFCanna an IETF ina ndéantar cur síos ar na cumais NETCONF a úsáidtear chun críocha ceolfhoirneacht Paragon Active Assurance.
- ietf-netconf.yang
- IETF RFC 6241, Prótacal Cumraíochta Líonra (NETCONF), https://tools.ietf.org/html/rfc6241
- Is é an t-aon mhodh láimhseála earráidí a dtacaítear leis ná ais-rolladh ar earráid.
- Tá an t-aon stór sonraí tacaithe inscríofa.
- ietf-netconf-notifications.yang
- IETF RFC 5277, Fógraí Imeachta NETCONF, https://tools.ietf.org/html/rfc5277
Teimpléid Thástáil agus Monatóireacht
Ní mór teimpléid le haghaidh cineálacha tástála agus monatóireachta a shocrú de láimh trí chomhéadan úsáideora tosaigh Paragon Active Assurance. Tá conas é seo a dhéanamh clúdaithe sa chabhair in-app faoi “Tástálacha agus monatóirí” > “Teimpléid a chruthú”.
Examples de Rialú Paragon Gníomhach Dearbhaithe trí NETCONF & YANG API
Sna caibidlí a leanann, glactar leis go bhfuil teimpléid oiriúnacha tástála agus monatóireachta sainmhínithe de réir na dtreoracha a thugtar sa chaibidil “Teimpléid Tástála agus Monatóireachta” ar leathanach 15.
Uirlisí a Úsáidtear in Examples
Gach an seanampLes sna caibidlí ina dhiaidh sin ag baint úsáide as na huirlisí seo a leanas atá ar fáil go héasca:
- Pang: Úsáidtear é chun samhlacha YANG a shamhlú agus a bhrabhsáil.
- Ar fáil ag https://github.com/mbj4668/pyang (clóin ó git agus rith python setup.py install).
- Cliant NETCONF Python “ncclient”: Úsáidtear é chun cumarsáid a dhéanamh leis an Lárionad Rialaithe ag baint úsáide as NETCONF.
- Ar fáil ag https://github.com/ncclient/ncclient (run pip install ncclient).
Faightear an tsamhail sonraí netrounds-ncc.yang in /opt/netrounds-confd nuair a bheidh ConfD suiteáilte de réir an Treoir Suiteála).
Tharview de na Príomhthascanna a Rinneadh
(Tá roinnt tascanna breise le fáil sa mhéid seo a leanas freisin.)
- “Gníomhaire Tástála nua á chruthú agus á imscaradh” ar leathanach 16
- “Míreanna fardail a chruthú (m.sh. frithchaiteoirí)” ar leathanach 29
- “Teimpléid aláraim a shocrú agus cá háit le haláraim a sheoladh” ar leathanach 35
- “Triail a chruthú agus a rith” ar leathanach 45
- “Torthaí trialacha a aisghabháil” ar leathanach 50
- “Tosú ar mhonatóir (lena n-áirítear socruithe aláraim)” ar leathanach 60
- “Stádas CLS a aisghabháil le haghaidh monatóra” ar leathanach 67
- “Ag obair le tags”Ar leathanach 71
Examples: Gníomhairí Tástála
Tharview de Cheolfhoireann Tástála Gníomhaire
Breathnaítear ar Ghníomhairí Tástála in Paragon Active Assurance mar “chumraíocht” i gcomhthéacs na ceolfhoirne. Ciallaíonn sé seo gur cheart cruthú, rialú agus scriosadh Gníomhairí Tástála a dhéanamh tríd an gceolfhoireann agus NETCONF seachas tríd an Paragon Active Assurance GUI.
TÁBHACHTACH: Má tá Gníomhaire Tástála suiteáilte ag teicneoir agus cláraithe sa Lárionad Rialaithe gan é a chruthú ar dtús tríd an API NETCONF & YANG, ní bheidh an Gníomhaire Tástála ann sa bhunachar sonraí cumraíochta, agus éireoidh an córas as sioncronú. Chun confD a chur ar an eolas faoin nGníomhaire Tástála sa chás seo, beidh sé riachtanach sioncrónú nua a dhéanamh leis an Lárionad Rialaithe, mar a shonraítear sa chuid “An Bunachar Sonraí Cumraíochta a Shioncronú leis an Lárionad Rialaithe” ar leathanach 4.
Ba cheart, dá bhrí sin, Orchestration of Virtual Test Agents (vTAs) a dhéanamh sna céimeanna seo a leanas:
- Cruthaigh an Gníomhaire Tástála Fíorúil, lena n-áirítear a chumraíocht chomhéadain, ag baint úsáide as comhéadan NETCONF & YANG go dtí an Lárionad Rialaithe. Is é ainm an Ghníomhaire Tástála a eochair uathúil.
- Imscaradh an vTA ar ardán fíorúlaithe. Lean na treoracha sa chabhair ar líne faoi Gníomhairí Tástála > Suiteáil. Cuirtear cumraíocht bhunúsach an chomhéadain a ligeann don vTA nascadh leis an Lárionad Rialaithe, chomh maith le dintiúir le haghaidh fíordheimhnithe, isteach sa vTA ag baint úsáide as sonraí úsáideora scamall-init.
Nuair a bheidh an vTA tosaithe, nascfaidh sé go huathoibríoch leis an Lárionad Rialaithe ag baint úsáide as nasc criptithe OpenVPN. Seoltar fógra NETCONF ós rud é go bhfuil luach pharaiméadar um athrú stádas gníomhaire-tástála an vTA athraithe go “ar líne”.
NÓTA: Ós é ainm an vTA a aitheantóir san Lárionad Rialaithe, caithfidh an t-ainm seo a bheith mar an gcéanna leis an gceann atá sainmhínithe sa Lárionad Rialaithe i “Céim 1” ar leathanach 17. - Nuair a bheidh an vTA nasctha agus fíordheimhnithe leis an Lárionad Rialaithe, déantar cumraíocht an chomhéadain a bhrú chuig an vTA. Seo é cumraíocht an chomhéadain a cuireadh ar fáil i “Céim 1” ar leathanach 17 nuair a cruthaíodh an vTA san Lárionad Rialaithe.
- Tar éis don VTA a chuspóir a chomhlíonadh, scrios an vTA.
Gníomhaire Tástála Nua a Chruthú agus a Imscaradh
Ní mór dúinn Gníomhaire Tástála a chruthú ar dtús ag baint úsáide as comhéadan NETCONF & YANG go dtí an Lárionad Rialaithe. Nuair a chruthaítear Gníomhaire Tástála ar an mbealach seo, ní gá sioncrónú ar bith leis an Lárionad Rialaithe.
Tá múnla YANG do Ghníomhaire Tástála mar a léirítear thíos. Faightear é mar aschur ón ordú
pyang -f crann netrounds-ncc.yang
Tá samhail iomlán YANG tugtha in “Aguisín: Struchtúr na gCrann de Mhúnla Iomlán YANG” ar leathanach 81, ina bhfuil finscéal freisin a mhíníonn na coinbhinsiúin a úsáidtear sa mhúnla seo agus i léaráidí eile de mhúnla YANG sa doiciméad seo.
Leanaimid ar aghaidh sna céimeanna seo a leanas, atá mionsonraithe sna céimeanna seo a leanas:
- Ag an tús, níl aon Ghníomhairí Tástála ina fhardal ag “taispeántas” chuntas Paragon Active Assurance.
- Cruthaítear Gníomhaire Tástála ar a dtugtar “vta1” le ncclient. Ag seo stage, níl aon Ghníomhaire Tástála fíor ann fós (is é sin, níl sé tosaithe fós).
- Tá an Gníomhaire Tástála imlonnaithe in OpenStack. (Roghnaítear imscaradh ar an ardán sin anseo mar fhéidearthacht amháin i measc cinn eile.)
- Nascann an Gníomhaire Tástála le “taispeántas” chuntas an Ionaid Rialaithe agus tá sé réidh le húsáid anois.
Céim 1: Ag an tús, níl aon Ghníomhairí Tástála sa chuntas “taispeántas”. Féach an scáileán thíos ó GUI an Ionaid Rialaithe.
Céim 2: Cruthaítear Gníomhaire Tástála san Ionad Rialaithe ag baint úsáide as cliant Python NETCONF “ncclient”. Anseo thíos tá cód ncclient chun Gníomhaire Tástála a chruthú a bhfuil comhéadan fisiceach amháin aige le seoladh DHCP:
allmhairiú argparse
ó bhainisteoir allmhairiú ncclient
parser = argparse.ArgumentParser(cur síos='Tástáil ag cruthú Gníomhaire Tástála')
parser.add_argument('–host', help='An óstainm ina bhfaightear ConfD', riachtanach=Fíor)
parser.add_argument('–port', help='An port le ceangal le ConfD', riachtanach=Fíor)
parser.add_argument('–username', help='An t-ainm úsáideora le nascadh le ConfD', riachtanach=Fíor)
parser.add_argument('–password', help='Pasfhocal chuig an gcuntas ConfD', riachtanach=Fíor)
parser.add_argument('–netrounds-account', help='Ainm gearr an chuntais NCC', riachtanach=Fíor)
parser.add_argument('–test-agent-name', help='Ainm an Ghníomhaire Tástála', riachtanach=Fíor)
args = parser.parse_args()
le manager.connect(óstach=args.host, port=args.port, ainm úsáideora=args.username,
password=args.password, hostkey_verify=Bréagach) mar m:
# Cruthaigh Gníomhaire Tástála san Ionad Rialaithe
xml = “””
)print m.edit_config(target='ag rith', config=xml)
NÓTA: Fágtar an cód a thagann roimhe le manager.connect(…) ar lár ón seanfhocal ina dhiaidh sinample gearrthóga cód.
Tá freastalaí NTP cumraithe ar eth0, agus is é eth0 an comhéadan bainistíochta freisin (is é sin, an comhéadan a nascann leis an Lárionad Rialaithe).
Ní cheadaíonn Feidhmchlár Gníomhaire Tástála comhéadain a chumrú faoi láthair. Ar an ábhar sin, ó leagan 2.34.0 ar aghaidh, is féidir cumraíocht an chomhéadain i scéimre YANG a fhágáil ar lár. Mar sin déantar an XML comhfhreagrach a shimpliú go bunúsach sa chás seo:
Nuair a bheidh an Gníomhaire Tástála cruthaithe, bíonn sé sa bhunachar sonraí cumraíochta agus san Lárionad Rialaithe. Féach an gabháil scáileáin thíos d’fhardal an Ghníomhaire Tástála, a thaispeánann an Gníomhaire Tástála “vta1”:
Céim 3: Tá sé in am anois an Gníomhaire Tástála “vta1” a imscaradh in OpenStack.
Úsáidfidh an Gníomhaire Tástála sonraí úsáideora néil-init chun an fhaisnéis a aisghabháil maidir le conas ceangal leis an Lárionad Rialaithe. Go sonrach, an téacs sonraí úsáideora file tá an t-ábhar seo a leanas aige (Tabhair faoi deara go gcaithfidh na línte #cloud-config agus netrounds_test_agent a bheith i láthair, agus nach mór na línte atá fágtha a eangú):
Le haghaidh tuilleadh faisnéise, féach le do thoil don doiciméad Conas Gníomhairí Tástála Fíorúla a Imscaradh in OpenStack.
Nuair a bheidh an Gníomhaire Tástála imlonnaithe agus nasctha leis an Lárionad Rialaithe, déanfar an chumraíocht a bhrú ón Lárionad Rialaithe go dtí an Gníomhaire Tástála.
Céim 4: Tá an Gníomhaire Tástála ar líne anois san Ionad Rialaithe agus tá a chumraíocht faighte aige. Tá an Gníomhaire Tástála réidh le húsáid i dtástálacha agus i monatóireacht. Féach ar na hailt seo:
- “Tástáil á Thosú” ar leathanach 45
- “Monatóir a Thosú” ar leathanach 60
Na Gníomhairí Tástála a liostú i do Chuntas Dearbhaithe Gníomhach Paragon
Anseo thíos tá example ncclient cód Python chun na Gníomhairí Tástála a liostú i gcuntas Paragon Active Assurance:
Má ritheann tú an cód seo, faightear aschur mar seo thíos:
Gníomhaire Tástála a scriosadh
Tar éis don tástáil a bheith críochnaithe, d'fhéadfadh sé a bheith ábhartha i gcásanna úsáide áirithe an Gníomhaire Tástála a scriosadh.
Seo thíos blúire cód a thaispeánann conas é seo a dhéanamh le ncclient:
Fógraí NETCONF
Anseo thíos, cuirimid i láthair simplí example script chun éisteacht le gach fógra NETCONF a thagann isteach ón Lárionad Rialaithe. Seoltar na fógraí seo aon uair a tharlaíonn imeachtaí áirithe, mar shampla Gníomhaire Tástála ag dul as líne nó tástáil arna dtionscnamh ag an úsáideoir á cur i gcrích. Bunaithe ar an bhfaisnéis a thugtar sna fógraí, is féidir le húsáideoirí gníomhaíochtaí leantacha uathoibrithe a shannadh san cheolfhoireann.
Nuair a fhorghníomhófar an script thuas, cuirfidh cliant NC an fógra a fuarthas i láthair i XML struchtúrtha. Féach ar an seanample aschur thíos, a thaispeánann Gníomhaire Tástála ag dul as líne gan choinne.
2017-02-03T15:09:55.939156+00:00</eventTime>
<test-agent-status-change xmlns=’http://ncc.netrounds.com'>
taispeána
HW1
as líne
Examples: Míreanna Fardail
Ag cruthú (allmhairiú) agus ag bainistiú míreanna fardail ar nós TWAMP frithchaiteoirí agus Y.1731 Feisirí Eorpacha a dhéantar ar an mbealach céanna agus a dhéantar i gcás Gníomhairí Tástála. Anseo thíos tá cód XML agus NETCONF chun aonáin dá leithéid a shainiú in Paragon Active Assurance tríd an NETCONF & YANG API agus chun liostaí de na míreanna sainithe a aisghabháil.
TW a chruthúAMP Frithchaiteoir
FPE Y.1731 á chruthú
Cainéal IPTV a chruthú
Óstach Ping a Chruthú
Cuntas SIP a Chruthú
Míreanna Fardail a Aisghabháil
Anseo thíos tá cód Python chun gach earra fardail a shainítear i gcuntas a aisghabháil. (Gabhtar gach cineál ítimí fardail in aon turas amháin anseo chun roinnt athrá a sheachaint sa doiciméad. Ar ndóigh, is féidir aon fho-thacar d’earraí fardail a fháil ach cuid de na línte atá sa chuntas thíos a fhágáil amach.)
Má ritheann tú an cód seo, faightear aschur mar seo thíos:
Examples: Aláraim
Cruthaítear agus bainistítear teimpléid aláraim agus míreanna gaolmhara (bainisteoirí SNMP, liostaí ríomhphoist aláraim) ar bhealach cosúil le míreanna fardail. Tá cód XML agus NETCONF sa chaibidil seo chun aonáin dá leithéid a shainiú in Paragon Active Assurance trí API NETCONF & YANG agus chun liostaí de na míreanna sainithe a aisghabháil.
Liostaí Ríomhphoist Aláraim
Ag Cruthú Liosta Ríomhphoist Aláraim
Gach Liosta Ríomhphoist Aláraim a Fháil
Bainisteoirí SNMP
Bainisteoir SNMP a chruthú
Gach Bainisteoir SNMP a aisghabháil
Teimpléid Aláraim
Teimpléad Aláraim á Chruthú
Gach Teimpléad Aláraim a Fháil
Examples: Eochracha SSH
Is féidir leat eochracha poiblí SSH a chur le Gníomhaire Tástála tríd an API NETCONF & YANG. Trí úsáid a bhaint as an eochair phríobháideach chomhfhreagrach is féidir leat logáil isteach sa Ghníomhaire Tástála trí SSH.
Seo a leanas liosta iomlán na n-oibríochtaí atá ar fáil ar eochracha SSH:
- Cuir eochair SSH leis
- Athraigh eochair SSH
- Iniúchadh eochair SSH
- Liosta eochracha SSH
- Scrios eochair SSH.
Anseo thíos, tugtar samplaí de na hoibríochtaí cuir leis agus scrios.
Eochair SSH a scriosadh
Más mian leat eochair SSH a scriosadh, bain úsáid as an ordú seo a leanas:
Examples: Tástálacha
Glactar leis anseo gur cruthaíodh Gníomhairí Tástála (an méid is gá do na tástálacha) de réir na rannóige “Gníomhaire Tástála Nua a Chruthú agus a Imscaradh” ar leathanach 17.
Cosáin Samhail YANG le haghaidh Tástálacha
| Mír | Conair mhúnla YANG: /cuntais/cuntas/tástálacha … |
| tástálacha | /. |
| tástáil[id] | /tástáil |
| id | /tástáil/id |
| ainm | /tástáil/ainm |
| stádas | /tástáil/stádas |
| am tosaithe | /tástála/tús-am |
| am deiridh | /tástála/deireadh-am |
| tuairisc-url | /tástáil/tuairisc-url |
| céimeanna | /tástáil/céimeanna |
| céim[id] | /tástáil/céimeanna/céim |
| ainm | /tástáil/céimeanna/céim/ainm |
| id | /tástáil/céimeanna/céim/id |
| am tosaithe | /tástáil/céimeanna/céim/am tosaigh |
| am deiridh | /tástáil/céimeanna/céim/deireadh-am |
| stádas | /tástáil/céimeanna/céim/stádas |
| teachtaireacht stádais | /test/steps/step/status-teachtaireacht |
| teimpléid | /teimpléid |
| teimpléad[ainm] | /teimpléid/teimpléad |
| ainm | /templates/template/name |
| tuairisc | /templates/template/cur síos |
| paraiméadair | /teimpléid/teimpléad/paraiméadair |
| paraiméadar[eochair] | /templates/template/parameters/parameter |
| eochair | /templates/template/parameters/parameter/key |
| cineál | /teimpléid/teimpléad/paraiméadair/paraiméadar/cineál |
Réamhriachtanais don Cheolfhoireann Tástála
- Chun tástáil a thosú trí NETCONF ag baint úsáide as cliant NC, ní mór teimpléad tástála a thógáil ar dtús ag baint úsáide as GUI an Ionaid Rialaithe mar atá sonraithe sa chabhair in-app faoi “Tástálacha agus monatóirí” > “Teimpléid a chruthú”. Beidh gach réimse a shonraítear sa teimpléad sin mar “Ionchur Teimpléad” ag teastáil mar pharaiméadair san XML agus an teimpléad tástála á thionscnamh.
- Meastar gur “staid” é trialacha a rith i Paragon Active Assurance i gcomhthéacs na ceolfhoirne. Is sonraí neamhscríofa iad sonraí stáit nach stóráiltear sa bhunachar sonraí cumraíochta, seachas na sonraí cumraíochta a luaitear sa rannán “ Tharview de Cheolfhoireann Tástála Gníomhaire” ar leathanach 17. Ciallaíonn sé seo go bunúsach nach gcruthóidh athruithe ar thástálacha nó ar theimpléid i GUI an Lárionaid Rialaithe aon saincheisteanna a bhaineann le sioncronú idir an Lárionad Rialaithe agus an bunachar sonraí cumraíochta.
- Chun tuairisc a fháil -URL ceart i dtuarascálacha tástála, ní mór duit an Lárionad Rialaithe a chinntiú URL atá cumraithe i gceart. Déantar é seo sa file /opt/netrounds-confd/settings.py. De réir réamhshocraithe faightear óstainm an Ionaid Rialaithe le socket.gethostname(): féach thíos. Mura dtugann sé seo an toradh ceart, ní mór duit ainm an óstaigh (nó ainm iomlán URL) de láimh sa file.
# URL den Lárionad Rialaithe gan slaise leantach.
# Tá sé seo le haghaidh example húsáid sa tuarascáil tástála-url.
HOSTNAME = socket.gethostname()
NETROUNDS_URL = ' https:// %s ' % HOSTNAME
Tástáil a Thosú
Mar a thuairiscítear sa rannán “Gníomhaire Tástála Nua a Chruthú agus a Imscaradh” ar leathanach 17, reáchtáil an t-ordú pang -f tree netrounds-ncc.yang
ón eolaire /opt/netrounds-confd/ chun samhail YANG a aschur. Sa tsamhail seo, is mar seo a leanas a bhreathnaíonn an RPC chun tástáil a thosú ag baint úsáide as cliant NC:
Le haghaidh mínithe, féach an rannán “Eochair” ar leathanach 81 san Fhoscríbhinn.
Taispeántar na céimeanna seo a leanas thíos:
- Tá Gníomhairí Tástála cláraithe le cuntas Paragon Active Assurance, ach níor cuireadh tús le haon tástálacha fós.
- Sainaithnítear na paraiméadair ionchuir riachtanacha sa teimpléad tástála a reáchtálfar.
- Cuirtear tús le tástáil HTTP 60 soicind ag baint úsáide as ncclient.
Céim 1: Ag an tús, níor cuireadh tús le haon tástálacha i gcuntas Paragon Active Assurance. Féach ar an scáileán thíos ó GUI an Lárionaid Rialaithe.
Céim 2: An teimpléad a úsáidfimid chun an tástáil a thionscnamh san exampIs teimpléad tástála HTTP é le. Tá dhá réimse ionchuir éigeantacha aige (Cliant agus URL) atá sonraithe againn mar sin agus an teimpléad á thógáil againn i GUI an Lárionaid Rialaithe.
Déanfaimid na paraiméadair seo a shainiú (i measc cinn eile) sa chumraíocht XML a chuir ár mbainisteoir NETCONF (ncclient) in iúl don bhunachar sonraí cumraíochta.
Céim 3: Cuirtear tús leis an tástáil HTTP ag baint úsáide as ncclient.
Anseo thíos tá example cód ina bhfuil an fhaisnéis chumraíocht riachtanach agus paraiméadair sonraithe don teimpléad tástála HTTP. Ag brath ar an gcaoi ar tógadh an teimpléad, féadfaidh na sonraí anseo athrú.
I gcás gach paraiméadar, beidh an ní mór tréith a sholáthar. Tá an eochair comhionann le paraiméadar
Ainm athróg san Lárionad Rialaithe. Is féidir leat ainmneacha athróg a iniúchadh mar seo a leanas:
- Cliceáil Tests ar an taobhbharra agus roghnaigh Seicheamh Tástála Nua.
- Cliceáil Mo Teimpléid.
- Cliceáil ar an nasc Edit thíos an teimpléad spéise.
- Cliceáil ar an gcnaipe Cuir ionchur in Eagar sa chúinne uachtarach ar dheis.
In ár seanample, agus de réir réamhshocraithe, níl sna hainmneacha athróg ach leaganacha beaga de na hainmneacha taispeána a fheictear san Lárionad Rialaithe (“url” vs.URL”, etc.). Mar sin féin, i GUI an Lárionaid Rialaithe, is féidir leat na hathróga a athainmniú go dtí cibé rud is mian leat.
Seachas an eochair, ní mór a chineál a bheith sonraithe ag gach paraiméadar: le haghaidh example, le haghaidh an URL.
Tabhair faoi deara go gcaithfidh tú athview an tsamhail iomlán YANG chun faisnéis iomlán a fháil ar chineálacha. Maidir le Comhéadain Tástála Gníomhaire tá struchtúr níos casta ag an gcineál, mar is léir faoi sa chód thíos.
Is féidir linn an script a rith anois ag baint úsáide as ncclient. Ag glacadh leis go bhfuil gach rud ceart, cuirfear tús leis an tástáil agus taispeánfar cur i gcrích sa Lárionad Rialaithe:
Má thosaítear go rathúil leis an tástáil, freagróidh an Lárionad Rialaithe le haitheantas na tástála. Sa seanample, is é 3 an ID tástála:
Is féidir an ID tástála a fháil freisin sa URL don tástáil i GUI an Lárionaid Rialaithe. Sa seanample, go URL is https://host/demo/testing/3/.
Torthaí Tástála a Aisghabháil
Is é an bealach is simplí chun torthaí tástála a fháil ná an t-aitheantas tástála a dhíriú.
Anseo thíos tá cód Python chun na torthaí a fháil ón tástáil HTTP thuas le ID = 3:
le bainisteoir. Ceangail(host=args.host, port=args.port, ainm úsáideora=args.username, password=args.password, hostkey_verify=Bréagach) mar m:
Beidh cuma mar seo ar an aschur:
Teimpléid Tástála a Easpórtáil agus a Iompórtáil
Is féidir teimpléid tástála a easpórtáil i bhformáid JSON agus a ath-allmhairiú san fhormáid sin chuig an Lárionad Rialaithe. Tá sé seo úsáideach más mian leat teimpléid tástála a úsáid i suiteáil eile den Lárionad Rialaithe. (Is fearr cruthú tosaigh na dteimpléad a láimhseáil trí GUI an Ionaid Rialaithe.)
Anseo thíos tá an cód le haghaidh onnmhairiú agus allmhairiú.
Teimpléid Tástála Easpórtála
# Faigh cumraíocht json ón bhfreagra
root = ET.fromstring(freagra._raw)
json_config = fréamh[0].text
priontáil json_config
Tá an teimpléad san oibiacht json_config.
Teimpléid Tástála á Iompórtáil
Is féidir teimpléid tástála a bhfuil réad cumraíochta JSON ina seilbh acu a athallmhairiú isteach sa Lárionad Rialaithe mar seo a leanas.
Examples: Monatóirí
Glacann an chuid seo leis go bhfuil Gníomhairí Tástála (an oiread agus a theastaíonn ó na monatóirí) cruthaithe de réir na rannóige “Gníomhaire Tástála Nua a Chruthú agus a Imscaradh” ar leathanach 17.
Cosáin Samhail YANG le haghaidh Monatóirí
| Mír | Cosán samhla YANG: /cuntais/cuntas/monatóireacht… |
| monatóirí | /. |
| monatóir[ainm] | / monatóireacht a dhéanamh |
| ainm | /monatóireacht/ainm |
| tuairisc | /monatóireacht/cur síos |
| thosaigh | /monatóireacht/thosaigh |
| teimpléad | /monatóireacht/teimpléad |
| aláraim-configs | /monitor/alarm-configs |
| Mír | Conair mhúnla YANG: /cuntais/cuntas/monatóireacht/monatóireacht/aláram-configs … |
| cumraíocht aláraim[ aitheantóir] | /alarm-config |
| aitheantóir | /alarm-config/ aitheantóir |
| teimpléad | /alarm-config/template |
| ríomhphost | /alarm-config/ríomhphost |
| snmp | /alarm-config/snmp |
| thr-es-criticiúil | /alarm-config/thr-es-critical |
| thr-es-criticiúil-soiléir | /alarm-config/thr-es-critical-clear |
| thr-es-mór | /alarm-config/thr-es-major |
| thr-es-mór-soiléir | /alarm-config/thr-es-major-clear |
| thr-es-mion | /alarm-config/thr-es-minor |
| thr-es-mion-soiléir | /alarm-config/thr-es-minor-clear |
| thr-es-rabhadh | /alarm-config/thr-es-rabhadh |
| thr-es-rabhadh-soiléir | /alarm-config/thr-es-warning-clear |
| gan-sonraí-déine | /alarm-config/no-data-severity |
| Teorainn ama gan sonraí | /alarm-config/gan-sonraí-am istigh |
| gníomh | /alarm-config/action |
| méid fuinneoige | /alarm-config/window-size |
| eatramh | /alarm-config/eatramh |
| seol-amháin | /alarm-config/seol-amháin-aon uair amháin |
| snmp-gaiste-in aghaidh an tsrutha | /alarm-config/snmp-trap-per-stream |
| Mír | Cosán samhla YANG: /cuntais/cuntas/monatóireacht… |
| paraiméadair | /monatóireacht/paraiméadair |
| Mír | Conair mhúnla YANG: /cuntais/cuntas/monatóireacht/monatóireacht/paraiméadair … |
| paraiméadar[eochair] | /paraiméadar |
| eochair | /paraiméadar/eochair |
| (cineál luacha) | /paraiméadar |
| :( slánuimhir) | /paraiméadar |
| slánuimhir | /paraiméadar/ slánuimhir |
| :(snámh) | /paraiméadar |
| snámh | /paraiméadar/snámhphointe |
| :( teaghrán) | /paraiméadar |
| Mír | Conair mhúnla YANG: /cuntais/cuntas/monatóireacht/monatóireacht/paraiméadair … |
| teaghrán | /paraiméadar/teaghrán |
| :(comhéadain-tástála-ghníomhaire) | /paraiméadar |
| tástála-ghníomhaire-comhéadain | /parameter/test-agent-interfaces |
| test-agent-interface[“1” ar leathanach 58 | /paraiméadar/comhéadain-ghníomhaire-tástála/ |
| cuntas | /parameter/test-agent-interfaces/test-agent-interface/account |
| tástála-ghníomhaire | /parameter/test-agent-interfaces/test-agent-interface/test-agent |
| comhéadan | /parameter/test-agent-interfaces/test-agent-interface/interface |
| leagan ip | /parameter/test-agent-interfaces/test-agent-interface/ip-version |
| :( dóamp-frithchaiteoirí) | /paraiméadar |
| twamp-fhrithchaiteoirí | /paraiméadar/twamp-fhrithchaiteoirí |
| twamp-frithchaiteoir[ainm] | /paraiméadar/twamp-frithchaiteoirí/twamp-léiritheoir |
| ainm | /paraiméadar/twamp-frithchaiteoirí/twamp-frithchaiteoir/ainm |
| :(y1731- Feisirí) | /paraiméadar |
| y1731-fPE | /parameter/y1731-fPE |
| y1731- fPE[ainm] | /parameter/y1731-feps/y1731-fep |
| ainm | /parameter/y1731-meps/y1731-mep/name |
| :(sip-cuntais) | /paraiméadar |
| sip-chuntais | /parameter/sip-cuntais |
| sip-chuntas[“2” ar leathanach 58] | /parameter/sip-accounts/sip-account |
| cuntas | /parameter/sip-accounts/sip-account/cuntas |
| tástála-ghníomhaire | /parameter/sip-accounts/sip-account/test-agent |
| comhéadan | /parameter/sip-accounts/sip-account/interface |
| sip-seoladh | /parameter/sip-accounts/sip-account/sip-seoladh |
| :( cainéil iptv) | /paraiméadar |
| cainéil iptv | /parameter/iptv-chainéil |
| cainéal iptv[ainm] | /parameter/iptv-channels/iptv-channel |
| ainm | /parameter/iptv-channels/iptv-channel/name |
- comhéadan tástála-ghníomhaire cuntais
- cuntas tástála-ghníomhaire comhéadan sip-seoladh
| Mír | Cosán samhla YANG: /cuntais/cuntas/monatóireacht… |
| stádas | /monatóireacht/stádas |
| deireanach-15-nóiméad | /monatóireacht/stádas/15 nóiméad deireanach |
| stádas | /monatóireacht/stádas/15-nóiméad deireanach/stádas |
| stádas-luach | /monitor/status/last-15-minutes/status-value |
| uair dheireanach | /monatóireacht/stádas/uair dheireanach |
| stádas | /monatóireacht/stádas/uair dheireanach/status |
| stádas-luach | /monitor/status/last-uair/status-value |
| seo caite-24-uair an chloig | /monatóireacht/stádas/24 uair an chloig caite |
| stádas | /monatóireacht/status/last-24-hours/status |
| stádas-luach | /monitor/status/last-24-hours/status-value |
| teimpléid | /teimpléid |
| teimpléad[ainm] | /teimpléid/teimpléad |
| ainm | /templates/template/name |
| tuairisc | /templates/template/cur síos |
| paraiméadair | /teimpléid/teimpléad/paraiméadair |
| paraiméadar[eochair] | /templates/template/parameters/parameter |
| eochair | /templates/template/parameters/parameter/key |
| cineál | /teimpléid/teimpléad/paraiméadair/paraiméadar/cineál |
Réamhriachtanais do Cheolfhoireann Faireacháin
Sular féidir leat monatóir a thosú trí NETCONF ag baint úsáide as ncclient, ní mór duit teimpléad monatóra a thógáil sa GUI Lárionad Rialaithe mar a mhínítear sa chabhair in-app faoi “Tástálacha agus monatóirí” > “Teimpléid a chruthú”. Beidh gach réimse a shonraítear mar “Ionchur Teimpléad” sa teimpléad sin ag teastáil mar pharaiméadair san XML nuair a bheidh tionscnamh an teimpléid á stiúradh.
Paraiméadair Ionchuir a Fháil ó Theimpléid Monatóirí
Anseo thíos, taispeántar dhá theimpléad. Tá an chéad cheann le haghaidh monatóireachta UDP idir dhá chomhéadan Gníomhaire Tástála, agus tá an dara ceann le haghaidh HTTP ag baint úsáide as comhéadan Gníomhaire Tástála amháin.
Chun paraiméadair ionchuir teimpléid a fháil amach, cliceáil ar an mbosca a léiríonn an teimpléad. Maidir leis an teimpléad HTTP, seans go mbeidh cuma mar seo ar na paraiméadair:
Ní mór dúinn na paraiméadair seo a shainiú sa chéad chéim eile agus monatóireacht á thosú againn.
Monatóir a Thosú
Trí úsáid a bhaint as na Gníomhairí Tástála a shainmhínigh muid agus a d’imlonníomar sa rannán “Gníomhaire Tástála Nua a Chruthú agus a Imscaradh” ar leathanach 17, is féidir linn monatóir a thosú ón teimpléad “HTTP” mar a thaispeántar thíos.
I gcás gach paraiméadar, beidh an ní mór tréith a sholáthar. Tá an eochair comhionann le hainm Athróg an pharaiméadar san Ionad Rialaithe. Is féidir leat ainmneacha athróg a iniúchadh mar seo a leanas:
- Cliceáil Monatóireacht ar an mbarra taobh agus roghnaigh Monatóireacht Nua.
- Cliceáil Mo Teimpléid.
- Cliceáil ar an nasc Edit thíos an teimpléad spéise.
- Cliceáil ar an gcnaipe Cuir ionchur in Eagar sa chúinne uachtarach ar dheis.
In ár seanample, agus de réir réamhshocraithe, níl sna hainmneacha athróg ach leaganacha beaga de na hainmneacha taispeána a fheictear san Lárionad Rialaithe (“url” vs.URL”, etc.). Mar sin féin, i GUI an Lárionaid Rialaithe, is féidir leat na hathróga a athainmniú go dtí cibé rud is mian leat.
Seachas an eochair, ní mór a chineál a bheith sonraithe ag gach paraiméadar: le haghaidh example, le haghaidh an URL. Tabhair faoi deara le do thoil go bhfuil faisnéis iomlán ar an gcineál paraiméadar le fáil i múnla YANG. I gcás comhéadain Gníomhaire Tástála tá struchtúr níos casta ag an gcineál, mar is léir sa chód thíos.
Sa seanampmar seo a leanas, níl aon aláram bainteach leis an monatóir. Le haghaidh exampníos lú a bhaineann le haláraim, téigh chuig an rannán “Tosú Monatóir le hAláram” ar leathanach 62.
Monatóir a Thosú le hAláram
Chun aláram a cheangal le monatóir, is féidir leat tagairt a dhéanamh do theimpléad aláraim atá sainmhínithe, nó is féidir leat cumraíocht iomlán an aláraim a sholáthar agus an monatóir á chruthú. Tabharfaimid example gach cur chuige thíos.
Aláram Monatóireachta a Shocrú trí Theimpléad Aláraim a Dhíriú
Chun úsáid a bhaint as teimpléad aláraim, ní mór duit a ID a bheith ar eolas agat. Chuige sin, faigh ar ais ar dtús do theimpléid aláraim go léir mar a thuairiscítear sa rannán “Ag Aisghabháil Gach Teimpléad Aláraim” ar leathanach 39 agus nótáil ainm an teimpléid ábhartha. Is féidir leat tagairt a dhéanamh don teimpléad sin mar seo a leanas:
Aláram Monatóireachta a Shocrú trína Chumrú Directly
Mar mhalairt air sin, is féidir leat aláram a shocrú le haghaidh monatóireacht a dhéanamh trína chumraíocht iomlán a sholáthar nuair a bhíonn an monatóir á chruthú, gan tagairt a dhéanamh do theimpléad aláraim. Déantar é seo mar a thaispeántar san example.
Monatóirí Rith a Fháil
Chun gach monatóir atá á fheidhmiú faoi láthair a fháil, rith an script seo:
le bainisteoir. connect(host=args.host, port=args.port, ainm úsáideora=args. ainm úsáideora, pasfhocal=args.password, hostkey_verify=Bréagach) mar m:
Is éard atá san aschur ná liosta de na monatóirí reatha go léir mar a thaispeántar thíos:
Stádas CLS do Mhonatóir a aisghabháil
Seo conas an stádas CLS do mhonatóir a fháil ar ais. Sa seanample, táimid ag aisghabháil an stádas CLS don mhonatóir “Cáilíocht Líonra” ar feadh trí eatramh ama: na 15 nóiméad deireanach, an uair dheireanach, agus na 24 uair an chloig deiridh.
Beidh cuma mar seo ar an aschur:
Fógraí NETCONF
Is sáruithe SLA a spreagann fógraí NETCONF do mhonatóirí. Tarlaíonn siad seo nuair a thiteann an CLS don mhonatóir faoi thairseach SLA (“Maith” nó “Inghlactha”) laistigh de fhuinneog ama ar leith, de réir réamhshocraithe le 15 nóiméad anuas. Ba chóir a thabhairt faoi deara go bhfuil fógraí sáraithe CLS le feiceáil go tapa tar éis do sheirbhís dul i bhfeidhm ar shaincheist, agus ní fhillfidh an stádas CLS go “Maith” ach amháin tar éis 15 nóiméad, agus mura dtarlaíonn aon sáruithe breise amháin.
Is féidir an fhuinneog ama a athrú tríd an socrú SLA_STATUS_WINDOW (luach i soicindí) a chur in eagar /etc/netrounds/netrounds.conf.
Teimpléid Monatóirí a Easpórtáil agus a Iompórtáil
Déantar é seo díreach ar an mbealach céanna agus a dhéantar i gcás teimpléid tástála; déan comparáid idir an roinn “Teimpléid Tástála a Easpórtáil agus a Iompórtáil” ar leathanach 52. Léiríonn na gearrthóga cód thíos conas teimpléid le haghaidh monatóirí a easpórtáil agus a iompórtáil.
Teimpléid Monatóirí Easpórtála
Teimpléid Monatóirí a Iompórtáil
Tags sainmhínithe i Paragon Active Assurance is féidir a chur i bhfeidhm ar:
- monatóirí
- teimpléid monatóireacht a dhéanamh
- Gníomhairí Tástála
- TWAMP frithchaiteoirí
- Óstach ping.
Le haghaidh example, is féidir leat tag monatóir leis an gcéanna tag mar fho-thacar de Ghníomhairí Tástála atá chun an monatóir a rith. Tá an ghné seo cabhrach go háirithe má tá líon mór monatóirí agus teimpléid sainmhínithe agat.
Má tá aláram socraithe agat le gaistí SNMP do mhonatóir, sannfar na gaistí SNMP mar an gcéanna tags mar mhonatóir, más ann dó.
Ag cruthú Tags
Anseo thíos léirímid conas a tag le hainm agus dath mar atá sainmhínithe ag an XMLtag> fostruchtúr.
Ag sannadh a Tag
A shannadh a tag le hacmhainn, cuireann tú é mar acmhainn nuatag> eilimint faoi natags> eilimint don acmhainn sin.
Seo conas a shannadh tag chuig Gníomhaire Tástála:
A shannadh a tag chuig TWAMP frithchaiteoir, déan an méid seo a leanas:
Ag sannadh a tag le monatóir a láimhseáil mar an gcéanna:
Nó, is féidir leat ceann atá ann cheana féin a shannadh tag le haon cheann de na cineálacha acmhainne seo agus an acmhainn á cruthú, trí natags> eilimint ina bhfuil an tag i gceist.
Ag nuashonrú a Tag
Nuashonrú atá ann cheana féin tag le tréithe nua ar aon dul le cruthú a tag:
Díshannadh a Tag
Chun díshannadh a tag ó acmhainn, cuir an aitreabúid nc:operation=”scrios” leis antag> eilimint a bhaineann leis an acmhainn. Anseo thíos, díshannaimid a tag ó mhonatóir.
Ag scriosadh a Tag
Chun scriosadh a tag go hiomlán ón Lárionad Rialaithe, úsáidtear an aitreabúid nc:operation="scrios" arís, ach an uair seo cuireadh i bhfeidhm ar an tag féin, sainithe faoi .
Fabhtcheartú
Fadhb: Orchestrator and Paragon Active Assurance As Sync
Féadfaidh an ceolfhoireann agus an Paragon Active Assurance deireadh a chur le sioncrónú le haghaidh example má tá athruithe cumraíochta déanta i GUI an Lárionaid Rialaithe, nó murar éirigh le cur i bhfeidhm cumraíocht agus gur theip ar rolladh ar ais go dtí an staid roimhe sin.
I gcás aisrolladh teipthe, ní ghlacfaidh freastalaí NETCONF le hathruithe cumraíochta a thuilleadh; freagróidh sé le teachtaireacht earráide á rá go bhfuil an chumraíocht faoi ghlas go dtí ar ais i sioncronaithe. Chun sioncronú a dhéanamh arís agus athruithe cumraíochta a dhíghlasáil, ní mór duit an t-ordú rpc sync-from-ncc a rith a shioncrónaíonn gach cumraíocht ón Lárionad Rialaithe go dtí an bunachar cumraíochta.
NÓTA: Tá an confd@netrounds.com ní mór go mbeadh pribhléidí sárúsáideora ag an úsáideoir (nó cibé rud atá cumraithe) chun gach rud a shioncronú go rathúil. Is féidir é seo a bhaint amach leis an ordú ncc úsáideora-nuashonrú confd@netrounds.com –is-superuser Mura sár-úsáideoir é an t-úsáideoir, beidh rabhadh le feiceáil á rá nach bhféadfaí gach rud a shioncronú, ach go ndearnadh gach rud a d’fhéadfaí a láimhseáil.
NÓTA: Má stórálann do cheolfhoireann an chumraíocht freisin, beidh ort é sin a athshioncrónú freisin ós rud é nach mbeidh an chumraíocht iarrtha (an chumraíocht a bhfuil an ceolfhoireann ag súil go mbeidh an Lárionad Rialaithe aici) curtha i bhfeidhm.
Fadhb: Theip ar Shioncronú Tosaigh (sionc-ó-ncc) Mar gheall ar Acmhainní Gan Tacaíocht
Má dhéanann tú iarracht rpc sync-from-ncc a rith ar chuntas a bhfuil a chumraíocht cruthaithe i GUI an Lárionaid Rialaithe, seans go mbeidh fadhbanna agat má tá acmhainní gan tacaíocht sa chuntas. Moltar duit tosú le cuntas folamh agus gach cumraíocht de a dhéanamh trí NETCONF. Seachas sin, má bhíonn fadhbanna agat le coinbhleachtaí acmhainne, beidh ort na hacmhainní contrártha a bhaint den chuntas.
Fadhb: teipeann ar orduithe NETCONF le ncclient.operations.rpc.RPCError: teip cumarsáide feidhmchláir
Ní athshocraíonn an freastalaí NETCONF nascacht le freastalaí an Lárionaid Rialaithe go huathoibríoch má atosaítear Lárionad Rialaithe. Chun an nasc chuig an Lárionad Rialaithe a athbhunú, atosaigh an próiseas NETCONF: atosú sudo systemctl netrounds-confd
Nótaí ar Iarratais Ghníomhaire Tástála agus Fearais Ghníomhaire Tástála
Feidhmchláir Tástála Gníomhaire i confD
I measc Gníomhairí Tástála, oibríonn an Feidhmchlár Gníomhaire Tástála (níosaí) beagán difriúil ón bhFearas Gníomhaire Tástála (níos sine).
Ní thacaíonn Feidhmchláir Tástála Gníomhaire le cumraíocht an chomhéadain faoi láthair. Dá bhrí sin, ceadaíonn scéimre YANG cumraíocht comhéadan folamh a shonrú le haghaidh Gníomhairí Tástála dá leithéid. Féach “an sliocht seo” ar leathanach 23 le haghaidh seanample.
Agus an bunachar sonraí ConfD á shioncronú leis an Lárionad Rialaithe ag baint úsáide as an ordú sync-from-ncc, ba mhaith leat go bhfanfaidh cumraíocht an chomhéadain folamh agus gan a bheith forscríofa leis an méid atá le fáil san Lárionad Rialaithe. Mar sin ní mór duit bratach speisialta a úsáid -without_interface_config leis an ordú sin agus tú ag obair le Feidhmchláir Gníomhaire Tástála.
Cumraíocht Chomhéadain Folamh le haghaidh Fearas Gníomhaire Tástála
Mar a luadh thuas, ní thacaíonn Feidhmchlár Gníomhaire Tástála le cumraíocht an chomhéadain, agus mar sin is féidir comhéadain a fhágáil ar lár i scéimre YANG.
Ach tá cásanna úsáide ann freisin ina mb’fhéidir gur mhaith leat cumraíocht an chomhéadain a fhágáil ar lár ó Fhearas Gníomhaire Tástála. Tá seanample of this could be a orchestration case where you are spin up a Test Gníomhaire ag baint úsáide as cloud-init, agus ba mhaith leat an chumraíocht comhéadan as sin a úsáid, in ionad ligean do ConfD é a fhorscríobh de réir mar a thagann an Gníomhaire Tástála ar líne.
Athruithe Scéimre YANG maidir le Comhéadain Neamhshainithe
Ós rud é go gceadaítear cumraíocht chomhéadain folamh anois (ó leagan 2.34.0 ar aghaidh), is féidir aon ainm comhéadan a shonrú mar ionchur do thasc atá ar siúl mar chuid de thástáil nó monatóireacht.
Ní mór é seo a bheith in ann Feidhmchlár Gníomhaire Tástála a úsáid, mar ní shainmhínítear aon ainmneacha comhéadain i confD dóibh seo. Tabhair faoi deara, áfach, go gciallaíonn sé seo freisin go mbeidh fadhbanna agat má dhéanann tú tástáil nó monatóir a chumrú trí thimpiste chun comhéadan nach bhfuil ann cheana a úsáid. Mar sin bí aireach faoi seo le do thoil.
Teorainneacha le linn Gníomhaire Tástála a Cruthaíodh i ConfD a Chlárú
Agus Gníomhaire Tástála á chruthú againn tríd an API REST nó NETCONF/YANG, ní féidir a fhios againn roimh ré cén cineál é: Fearas Gníomhaire Tástála nó Feidhmchlár Gníomhaire Tástála. Ní bhíonn sé seo soiléir ach amháin tar éis don Ghníomhaire Tástála clárú.
Nuair a bheidh an Gníomhaire Tástála cláraithe agus tar éis iompú isteach i gceann de na cineálacha nithiúla seo, níl cead agat é a athchlárú mar Ghníomhaire Tástála de chineál eile. Ciallaíonn sé seo nach bhfuil cead agat é a chlárú ar dtús mar Fhearas Gníomhaire Tástála, ansin é a athchlárú mar Iarratas Gníomhaire Tástála, nó vice versa. Má theastaíonn Gníomhaire Tástála de chineál difriúil uait, beidh ort Gníomhaire Tástála nua a chruthú.
Aguisín: Struchtúr Crann de Mhúnla Iomlán YANG
San aguisín seo, míníonn an rannán “Eochair” ar leathanach 81 comhréir struchtúr crann samhalta YANG a ghintear leis an gcrann ordú pyang -f.
Tugann an rannán “YANG Model Struchtúr Crainn” ar leathanach 82 an t-aschur ón ordú sin a chuirtear i bhfeidhm ar netrounds-ncc.yang. Déantar codanna den aschur seo a atáirgeadh áit eile sa doiciméad.
Finscéal
Struchtúr Crann Samhail YANG
Is trádmharcanna cláraithe de chuid Juniper Networks, Inc. sna Stáit Aontaithe agus i dtíortha eile iad Juniper Networks, lógó Juniper Networks, Juniper, agus Junos. Is leis a n-úinéirí faoi seach gach trádmharc, marc seirbhíse, marc cláraithe, nó marc seirbhíse cláraithe. Ní ghlacann Juniper Networks freagracht ar bith as aon mhíchruinneas sa doiciméad seo. Forchoimeádann Juniper Networks an ceart an foilseachán seo a athrú, a mhodhnú, a aistriú nó a leasú ar shlí eile gan fógra. Cóipcheart © 2023 Juniper Networks, Inc. Gach ceart ar cosaint.
Doiciméid / Acmhainní
 |
Juniper NETWORKS Bogearraí NETCONF & YANG API [pdfTreoir Úsáideora Bogearraí NETCONF YANG API, Bogearraí API YANG, Bogearraí API, Bogearraí |