NETCONF & YANG API orkestreerimine
Juhend
Avaldatud
2023-07-07
AVALDAMINE 4.2
Sissejuhatus
Selle dokumendi eesmärk
See dokumentatsioon kirjeldab, kuidas integreerida Paragon Active Assurance võrguteenuse orkestraatoriga juhtimiskeskuse NETCONF & YANG API kaudu. Praktiline eksampSiin on toodud peamised seotud ülesanded, sealhulgas: Virtuaalsete testiagentide loomine ja juurutamine, testide ja monitoride käitamine ning nende tegevuste tulemuste hankimine.
Selles dokumendis kasutatakse orkestreerija rollis vabalt saadaolevat Python NETCONF kliendi ncclienti.
konventsioonid
Selles dokumendis kasutatakse järgmisi lühendeid:
| Lühend | Tähendus |
| CLI | Käsurea liides |
| EM | Elementide haldur |
| ES | Viga teiseks |
| Euroopa Parlamendi liige | MEG (Maintenance Entity Group) lõpp-punkt (ITU-T Y.1731 määratlus) või Maintenance End Point (Cisco definitsioon) |
| NFV | Võrgufunktsioonide virtualiseerimine |
| NFVO | Võrgufunktsiooni virtualiseerimise orkestraator |
| NSD | Võrguteenuse deskriptor |
| RPC | Protseduuri kaugkõne |
| SIP | Seansi algatamise protokoll |
| SLA | Teenusetaseme leping |
| S-VNFM | Spetsiaalne VNF-i juht |
| VNF | Virtuaalse võrgu funktsioon |
| vTA | Virtuaalne testiagent |
Märkused tagasiühilduvuse kohta
NETCONF & YANG API versioonides 2.35.4/2.36.0 muudeti teatud päringute valideerimine rangemaks, et järgida NETCONF standardit. See tähendab, et selle juhendi vanematel versioonidel põhinev kliendikood võidakse nüüd tagasi lükata.
Näiteksample, eelmises Pythonis example koodi, nimeruumi atribuuti ei esitatud. Nimeruum tuleb nüüd esitada päringu XML-is alati, kui soovite ConfD ressurssi muuta.
Eeltingimused ja ettevalmistused
ConfD installimine
ConfD-d (Tail-f toode) kasutatakse vahendajana Paragon Active Assurance süsteemi ja NETCONF-i vahel. ConfD ühendab Paragon Active Assurance'i konfiguratsiooni ja tööandmed NETCONF & YANG API-ga.
ConfD peaks olema installitud koos juhtimiskeskuse tarkvaraga, nagu on kirjeldatud paigaldusjuhendis.
Kontrollige, kas ConfD töötab
Kontrollimaks, kas ConfD on valmis ja töötab, käivitage käsk
ssh -s @localhost -p 830 netconf
et kontrollida, kas ConfD vastab pordile 830. on netconfi kasutaja loo poolt määratletud
käsk installijuhendi jaotises ConfD installimine. Andke sama käsuga määratud parool.
Väljundis veenduge, et juhtimiskeskuse moodul on kaasas. Väljund peaks sisaldama järgmist rida:
http://ncc.netrounds.com?module=netrounds-ncc&revision=2017-06-15
Konfiguratsiooniandmebaasi sünkroonimine juhtimiskeskusega
Lõpuks peame NETCONF-i kaudu värskendama konfiguratsiooniandmebaasi. Teeme seda siin Pythoni teegi abil nimega ncclient (NETCONF Client). Kuid seda ülesannet saab täita ka teises programmeerimiskeeles, kui see kasutab NETCONF/YANG protokolli.
Ncclienti roll on tegutseda kliendina ConfD serveri suhtes, mis majutab NETCONF/YANG API-t.
Väärib märkimist, et ncclient ei ole kuidagi seotud juhtimiskeskusega (varem "Netrounds Control Center"), kuigi nimi algab "ncc"-ga.
Ncclienti installimiseks toimige järgmiselt.
- Laadige tarkvara alla aadressilt https://github.com/ncclient/ncclient.
- Käivitage see käsk: pip install ncclient
Nüüd saame sünkroonida järgmiselt. Pange tähele, et seda tuleb teha eraldi arvutis, mitte juhtimiskeskuse serveris endas:
#
# MÄRGE:
# See skript toimib kliendina NCC serveris töötava ConfD suhtes.
# See kasutab suhtluseks NETCONF/YANG API-t.
MÄRKUS: see protseduur on vajalik ka siis, kui testagendid on installitud ja registreeritud sõltumatult NETCONF-ist. Vt märget jaotises „Overview Test Agent Orchestration” leheküljel 17 lisateabe saamiseks.
Mitme NETCONF-i juhitava Paragon Active Assurance'i konto seadistamine
Alltoodud sammud on vajalikud ainult siis, kui soovite seadistada täiendavaid Paragon Active Assurance'i kontosid, mida NETCONF juhib, lisaks installijuhendi jaotises "ConfD installimine" sel viisil konfigureeritud kontole.
Iga sellise konto puhul toimige järgmiselt.
- Logige juhtimiskeskuses kontole sisse ja liikuge jaotisse Konto > Õigused.
- Lisa kasutaja "confd@netrounds.com“ ja andke sellele ConfD kasutajale GUI-s administraatori õigused, klõpsates nuppu Kutsu.
- Sünkroonige konfiguratsiooniandmebaas juhtimiskeskusega, nagu on kirjeldatud jaotises "Konfiguratsiooniandmebaasi sünkroonimine juhtimiskeskusega" lk 4.
Nüüd peaksite saama sama ConfD kasutajaga juhtida mitut Paragon Active Assurance'i kontot.
MÄRKUS: kui hakkate ConfD kaudu Paragon Active Assurance'i kontot juhtima, EI TOHI te sellel kontol muudatusi teha web GUI mis tahes Paragon Active Assurance'i funktsioonide suhtes, mis on "konfigureeritud" (vt peatükki "Paragon Active Assurance'i toetatud funktsioonid" lk 9). Kui teete seda, kaob sünkroonimine.
Sissejuhatus NETCONF Orchestration API-sse
Läbiview
Kolmanda osapoole NFVO või teenuseorkester on tavaliselt komponent, mis käivitab juhtimiskeskuse API abil testimise ja jälgimise seansid. See orkestraator hangib ka testagendi tegevuste koondatud mõõtmistulemused. Toimivuse KPI-d võivad hankida kolmanda osapoole jõudlushaldussüsteemid, samas kui sündmusi – kui need on käivitatud juhtimiskeskuses määratud lävede rikkumise tõttu – saab saata kolmanda osapoole tõrkehaldussüsteemidele.
Kokkuvõtteks võib öelda, et allolev joonis näitab, kuidas Paragon Active Assurance suhtleb OSS-i maastikul teiste kolmandate osapoolte süsteemidega.
- NFVO / Service Orchestrator: juhendab VNF-i haldurit juurutama vTA-d ja konfigureerima Paragon Active Assurance'i teenindusahelasse. Kui teenus on aktiveeritud, kasutab orkestraator API-d juhtimiskeskuse poole, et käivitada teenuse aktiveerimise teste ja hankida läbitud/mittetulemusi. Kui testid on läbitud, kasutab orkestraator API-t juhtimiskeskuse poole, et alustada teenuse aktiivset jälgimist. Järelevalve KPI-d hangib pidevalt kas orkestraator või eraldi jõudlushaldusplatvorm.
- Juhtimiskeskus: juurutab, skaleerib ja lõpetab vTA vastavalt NFVO või teenindusorganisaatori juhistele.
- Jõudlusjuhtimissüsteem või teenusekvaliteedi juhtimissüsteem: loeb juhtimiskeskuse API kaudu aktiivse jälgimise KPI-sid.
- Veahaldussüsteem: SLA-de rikkumise korral võtab vastu NETCONF-i, SNMP- või meiliteateid juhtimiskeskusest.
Paragon Active Assurance'i mõistete määratlused
- Testagendid: komponendid, mis teostavad mõõtmisi (nii testide kui ka monitoride jaoks) Paragon Active Assurance süsteemis. Testagendid koosnevad tarkvarast, mis on võimeline genereerima, vastu võtma ja analüüsima tegelikku võrguliiklust.
- Selles dokumendis käsitletav testagendi tüüp on virtuaalne testagent (vTA), virtuaalse võrgu funktsioon (VNF), mis on juurutatud hüperviisorile. Samuti on olemas muud tüüpi testagendid.
- Paragon Active Assurance'is on kaks peamist mõõtmistüüpi: testid ja monitorid.
- Test: test koosneb ühest või mitmest etapist, millest igaühel on määratud, piiratud kestus. Sammud viiakse läbi järjestikku. Iga samm võib hõlmata mitme ülesande samaaegset käitamist.
- Monitor: monitoril ei ole määratud kestust, kuid see töötab määramata aja. Sarnaselt testi etapiga võib monitor täita mitut samaaegset ülesannet.
- Mall: kui Paragon Active Assurance'i juhib orkestrant, teostatakse testid ja monitorid alati mallide abil, milles test või monitor on määratletud. Parameetri sätteid saab käitamise ajal malli sisenditena edastada.
Automatiseerimise töövoog
Disaini aeg
Projekteerimise ajal valmistate ette mõõtmised, luues Paragon Active Assurance'is testide ja monitoride jaoks mallid. Kuidas seda teha, käsitletakse peatükis "Testi- ja jälgimismallid" lk 15.
Kestus
Käitusajal seadistate oma seadmed ja teostate tegelikud mõõtmised.
- Üleview kõigist endistestamples antud on peatükis „NäitampParagon Active Assurance'i kontrollimine NETCONF & YANG API kaudu” lk 15.
- Testagentide juurutamist ja konfigureerimist kirjeldatakse peatükis „Ntamples: testagendid” lk 16.
- Kuidas importida laoartikleid, näiteks TWAMP helkurid ja IPTV kanalid on läbi käinud peatükis “Ntamples: laoartiklid” lk 29.
- Häirete konfigureerimist selgitatakse peatükis „Ntamples: alarmid” lk 35.
- Testide ja monitoride käivitamist, käivitades Paragon Active Assurance'i malle NETCONF-i kaudu, kirjeldatakse peatükkides „Nt.amples: Testid” lk 43 ja „Näitamples: monitorid” lk 54.
Paragon Active Assurance'i toetatud funktsioonid
Kõiki Paragon Active Assurance'i testi- ja monitoritüüpe saab luua ja käivitada mallide abil. Kuidas seda teha, kirjeldatakse rakendusesisese abi jaotises „Testid ja monitorid” > „Mallide loomine”.
Paragon Active Assurance'i kontode loomist praegu ei toetata; kasutaja jaoks on aga seadistatud üks või mitu eelmääratletud kontot.
Allolevates tabelites kirjeldatakse, millised Paragon Active Assurance'i funktsioonid on selles versioonis saadaval ja kuidas need funktsioonid on YANGis esindatud.
YANG konstruktsioonide selgitus
Mugavuse huvides on siin toodud funktsioonide tabelis viidatud YANG-konstruktsioonide määratlused.
- Config (config=true): konfiguratsiooniandmed, mis on vajalikud süsteemi ühest olekust teise teisendamiseks.
- Olek (config=false): olekuandmed: lisaandmed süsteemi kohta, mis ei ole konfiguratsiooniandmed, näiteks kirjutuskaitstud olekuteave ja kogutud statistika.
- RPC: Kaugprotseduuri kõne, nagu seda kasutatakse NETCONF-i protokollis.
- Teavitus: NETCONF-i serverist NETCONF-i kliendile saadetud sündmuste teatised.
Orkestreerimiseks on saadaval Paragon Active Assurance'i funktsioonide tabelid
Allikas: monitooring
YANG tee:/kontod/konto/monitorid
| Funktsioon | Alamfunktsioon | YANG konstruktsioon |
| Monitori loomine/muutmine/kustutamine | Põhineb monitori mallil | Konfig |
| Start/stopp monitor | – | Konfig |
| Monitori mallid | Loetlege olemasolevad monitori mallid koos sisenditega | osariik |
| NETCONF-i teatised | Häire olek muudetud | Teavitus |
| Jälgige tulemusi | SLA/ES loendur tipptaseme jaoks (%) SLA/ES loendur ülesande taseme jaoks (%) |
osariik |
Erinevalt testidest (vt allikas: testid allpool) ei käivitata monitore RPC-ga, vaid monitori konfigureerimisega.
Allikas: Testid
YANG tee: /accounts/account/tests
| Funktsioon | Alamfunktsioon | YANG konstruktsioon |
| Alusta testimist | Põhineb testmallil | RPC |
| Testide haldamine | Loetlege testid olekuga | osariik |
| Testmallid | Loetlege olemasolevad testimallid koos sisenditega | osariik |
| NETCONF-i teatised | Testi olek muudetud | Teavitus |
| Testi tulemused | Hankige testietapi olek (sobib, ebaõnnestus, viga jne) | osariik |
Allikas: Test Agents
YANG teed:
- /accounts/account/test-agents (Config)
- /accounts/account/registred-test-agents (osariik)
Testagendid all /accounts/account/test-agents on need, mis on kontol konfigureeritud. Korraldaja saab NETCONF-i kaudu testides ja monitorides konfigureerida ja kasutada ainult neid testagendeid.
Kui olete testagendi konfigureerinud ja see on kontole registreerunud, kuvatakse testagent kaustas /accounts/account/registered-test-agents. Kõik registreeritud testagendid leiate NETCONF-i käsuga "get" (võrrelge peatükki Ntamples: testained).
Jaotises /accounts/account/registered-test-agents võite leida ka testagendid, mida pole veel konfigureeritud. Kõik sellised testagendid tuleb enne kasutamist konfigureerida.
Orkestreerimise stsenaariumi korral on üldiselt soovitatav teha kogu Paragon Active Assurance'i konto konfigureerimine NETCONF-i kaudu. See tagab, et test-agendid ja registreeritud testagendid ei lahkne.
| Funktsioon | Alamfunktsioon | YANG konstruktsioon |
| Eellooge serveris testagent | – | Konfig |
| Võrguühenduseta testagendi konfigureerimine | (Juhtkeskus surub konfiguratsiooni testagendile kui see võrku tuleb) |
Konfig |
| Kasutage olemasolevaid/väliselt konfigureeritud testagente | Kasuta testis/monitoris | Konfig |
| Liideste konfigureerimine | Konfig | |
| Hankige staatus | osariik | |
| Testagendi konfigureerimine (ainult testseade) | Konfigureerige NTP | Konfig |
| Seadistage sillad | Konfig | |
| Konfigureerige VLAN-i liidesed | Konfig | |
| Konfigureerige SSH-võtmed | Konfig | |
| IPv6 | Konfig | |
| Utils | Taaskäivitage | RPC |
| Värskenda | RPC | |
| NETCONF-i teatised | Võrgusolekut muudeti | Teavitus |
| Olek | Saate süsteemi oleku (tööaeg, mälukasutus, koormuse keskmine versioon) |
osariik |
Allikas: Inventuur
YANG tee: /accounts/account/twamp- helkurid
Toetatud NETCONF-i võimalused
Allolev tabel viitab IETF-i RFC-dele, mis kirjeldavad Paragon Active Assurance'i orkestreerimise eesmärgil kasutatavaid NETCONF-i võimalusi.
- ietf-netconf.yang
- IETF RFC 6241, võrgukonfiguratsiooniprotokoll (NETCONF), https://tools.ietf.org/html/rfc6241
- Ainus toetatud vigade käsitlemise meetod on tagasipööramine vea korral.
- Ainus toetatud andmesalv on kirjutatav.
- ietf-netconf-notifications.yang
- IETF RFC 5277, NETCONF sündmuste teatised, https://tools.ietf.org/html/rfc5277
Testige ja jälgige malle
Testi- ja monitoritüüpide mallid tuleb Paragon Active Assurance'i esiotsa kasutajaliidese kaudu käsitsi seadistada. Kuidas seda teha, kirjeldatakse rakendusesisese abi jaotises „Testid ja monitorid” > „Mallide loomine”.
ExampParagon Active Assurance'i kontrollimine NETCONF & YANG API kaudu
Järgmistes peatükkides eeldatakse, et sobivad testi- ja monitorimallid on määratletud vastavalt juhistele, mis on antud peatükis “Testi- ja jälgimismallid” lk 15.
Tööriistad, mida kasutatakse ntamples
Kõik endisedampJärgmistes peatükkides olevad rakendused on koostatud järgmiste vabalt saadaolevate tööriistade abil:
- Pang: kasutatakse YANG mudelite visualiseerimiseks ja sirvimiseks.
- Saadaval aadressil https://github.com/mbj4668/pyang (kloonige gitist ja käivitage python setup.py install).
- Pythoni NETCONF-i klient “ncclient”: kasutatakse juhtimiskeskusega suhtlemiseks NETCONF-i abil.
- Saadaval aadressil https://github.com/ncclient/ncclient (käivitage pip install ncclient).
Netrounds-ncc.yangi andmemudel leiate failist /opt/netrounds-confd, kui ConfD on installijuhendi kohaselt installitud).
Läbiview täidetud põhiülesannetest
(Mõned täiendavad ülesanded on toodud ka järgnevas näites.)
- "Uue testagendi loomine ja juurutamine" lk 16
- “Laoartiklite (nt helkurid) koostamine” lk 29
- "Alarmimallide seadistamine ja häirete saatmise koht" lk 35
- “Testi loomine ja käitamine” lk 45
- “Testitulemuste toomine” lk 50
- „Monitori käivitamine (sisaldab häirete seadistamist)” lk 60
- “Monitori SLA oleku toomine” lk 67
- "Töötamine tags”Lk 71
Examples: testagendid
Läbiview testagendi orkestratsioonist
Paragon Active Assurance'i testiagente käsitletakse orkestreerimise kontekstis konfiguratsioonina. See tähendab, et testagentide loomine, juhtimine ja kustutamine peaks toimuma pigem orkestraatori ja NETCONF-i kui Paragon Active Assurance GUI kaudu.
TÄHTIS. Kui tehnik installib testagendi ja registreerib selle juhtimiskeskusesse ilma NETCONF & YANG API kaudu esmalt loomata, ei ole testagenti konfiguratsiooniandmebaasis ja süsteem läheb sünkroonist välja. Selleks, et ConfD saaks sel juhul testagendist teada, on vaja teha uus sünkroonimine juhtimiskeskusega, nagu on kirjeldatud jaotises „Konfiguratsiooniandmebaasi sünkroonimine juhtimiskeskusega” lk 4.
Virtuaalsete testimisagentide (vTA-de) korraldamine peaks seetõttu toimuma pigem järgmistes etappides:
- Looge virtuaalne testagent, sealhulgas selle liidese konfiguratsioon, kasutades juhtimiskeskuse liidest NETCONF & YANG. Testagendi nimi on selle kordumatu võti.
- Juurutage vTA virtualiseerimisplatvormil. Järgige juhiseid veebispikri jaotises Testagendid > Installimine. Põhiline liidese konfiguratsioon, mis võimaldab vTA-l juhtimiskeskusega ühenduse luua, ja autentimise mandaadid esitatakse vTA-sse pilvepõhise kasutajaandmete abil.
Kui vTA on käivitunud, loob see krüptitud OpenVPN-ühenduse abil automaatselt ühenduse juhtimiskeskusega. NETCONF-i teatis saadetakse, kuna vTA parameetri test-agent-statuschange väärtus on nüüd muudetud väärtuseks "online".
MÄRKUS: Kuna vTA nimi on selle identifikaator juhtimiskeskuses, peab see nimi olema sama, mis on määratletud juhtimiskeskuses punktis 1 lk 17. - Kui vTA on juhtimiskeskusega ühendatud ja autentinud, lükatakse liidese konfiguratsioon vTA-sse. See on liidese konfiguratsioon, mis on esitatud punktis “1. samm” lk 17, kui vTA loodi juhtimiskeskuses.
- Kui vTA on oma eesmärgi täitnud, kustutage vTA.
Uue testagendi loomine ja juurutamine
Esmalt peame juhtkeskusega NETCONF & YANG liidest kasutades looma testagendi. Kui testagent on sel viisil loodud, pole juhtimiskeskusega sünkroonimist vaja.
Testagendi YANG-mudel on selline, nagu allpool näidatud. See saadakse käsu väljundina
pyang -f puu netrounds-ncc.yang
Täielik YANG-mudel on toodud jaotises „Lisa: Täieliku YANG-mudeli puustruktuur” leheküljel 81, mis sisaldab ka legendi, mis selgitab selle ja teiste käesoleva dokumendi YANG-mudeli illustratsioonidel kasutatud tavasid.
Jätkame järgmiste sammudega, mida kirjeldatakse üksikasjalikult järgmises:
- Alguses ei ole Paragon Active Assurance'i konto „demo” loendis ühtegi testagenti.
- Testagent nimega "vta1" luuakse ncclienti abil. Sellel stage, tõelist testagenti pole veel olemas (st seda pole veel käivitatud).
- Testagent on juurutatud OpenStackis. (Selle platvormi juurutamine on siin valitud ühe võimalusena teiste hulgas.)
- Testagent loob ühenduse juhtimiskeskuse konto demoga ja on nüüd kasutamiseks valmis.
1. samm: alguses pole kontol „demo“ ühtegi testiagenti. Vaadake allolevat ekraanipilti juhtimiskeskuse GUI-st.
2. samm: kontrollkeskuses luuakse testagent, kasutades Pythoni NETCONF-i klienti „ncclient”. Allpool on ncclient kood testagendi loomiseks, millel on üks füüsiline liides DHCP-aadressiga:
import argparse
ncclient impordihaldurilt
parser = argparse.ArgumentParser(description='Testige testagendi loomist')
parser.add_argument('–host', help='Mastinimi, kust ConfD leitakse', required=True)
parser.add_argument('–port', help='ConfD-ga ühenduse loomiseks mõeldud port', required=True)
parser.add_argument('–kasutajanimi', help='ConfD-ga ühenduse loomiseks vajalik kasutajanimi', required=True)
parser.add_argument('–password', help='ConfD konto parool', required=True)
parser.add_argument('–netrounds-account', help='NCC konto lühinimi', required=True)
parser.add_argument('–test-agent-name', help='Testagendi nimi', required=True)
args = parser.parse_args()
with manager.connect(host=args.host, port=args.port, kasutajanimi=args.kasutajanimi,
password=args.password, hostkey_verify=False) kui m:
# Looge kontrollkeskuses testagent
xml = """
)print m.edit_config(target='jooks', config=xml)
MÄRKUS: koodile manager.connect(…) eelnev kood jäetakse järgnevatest example koodijuppe.
NTP-server on konfigureeritud eth0-s ja eth0 on ka haldusliides (st liides, mis loob ühenduse juhtimiskeskusega).
Testagendi rakendus ei luba praegu liideseid konfigureerida. Sel põhjusel on alates versioonist 2.34.0 võimalik YANG-skeemis liidese konfiguratsioon ära jätta. Seetõttu on vastav XML sel juhul radikaalselt lihtsustatud:
Kui testagent on loodud, on see konfiguratsiooniandmebaasis ja juhtimiskeskuses olemas. Vaadake allolevat ekraanipilti testagendi loendist, mis näitab testagenti "vta1".
3. samm: nüüd on aeg juurutada OpenStackis testagent "vta1".
Testagent kasutab juhtimiskeskusega ühenduse loomise teabe hankimiseks pilveiniti kasutajaandmeid. Täpsemalt kasutajaandmete tekst file on järgmise sisuga (pange tähele, et read #cloud-config ja netrounds_test_agent peavad olema olemas ning ülejäänud read peavad olema taandega):
Lisateavet leiate dokumendist Kuidas OpenStackis virtuaalseid testagente juurutada.
Kui testagent on juurutatud ja juhtimiskeskusega ühenduse loonud, lükatakse konfiguratsioon juhtimiskeskusest testagendisse.
4. toiming. Testagent on nüüd juhtimiskeskuses võrgus ja saanud oma konfiguratsiooni. Testagent on testimiseks ja jälgimiseks kasutamiseks valmis. Vaadake neid jaotisi:
- “Testi alustamine” lk 45
- “Monitori käivitamine” lk 60
Testagentide loetlemine teie Paragon Active Assurance'i kontol
Allpool on endineample ncclient Pythoni kood testagentide loetlemiseks Paragon Active Assurance'i kontol:
Selle koodi käivitamine annab järgmise väljundi:
Testagendi kustutamine
Pärast testi lõppemist võib mõnel juhul olla asjakohane testagent kustutada.
Allpool on koodilõik, mis näitab, kuidas seda ncclientiga teha:
NETCONF-i teatised
Allpool tutvustame lihtsat endistampskript kõigi sissetulevate NETCONF-i teadete kuulamiseks juhtimiskeskusest. Need teatised saadetakse alati, kui toimuvad teatud sündmused, näiteks kui testagent läheb võrguühenduseta või kui kasutaja algatatud test on lõpule viidud. Teatistes sisalduva teabe põhjal saavad kasutajad orkestraatoris määrata automatiseeritud järeltoiminguid.
Kui ülaltoodud skript on käivitatud, esitab NC-klient saadud teatise struktureeritud XML-is. Vaata endistampalloleva väljundi, mis näitab, et testagent läheb ootamatult võrguühenduseta.
2017-02-03T15:09:55.939156+00:00</eventTime>
<test-agent-status-change xmlns=’http://ncc.netrounds.com'>
demo
HW1
võrguühenduseta
Examples: laoartiklid
Varude (nt TW) loomine (importimine) ja haldamineAMP helkurid ja Y.1731 MEPid tehakse sarnaselt testainetega. Allpool on XML- ja NETCONF-kood selliste olemite määratlemiseks Paragon Active Assurance'is NETCONF & YANG API kaudu ja määratletud üksuste loendite toomiseks.
TW loomineAMP Helkur
Y.1731 MEP loomine
IPTV kanali loomine
Ping-hosti loomine
SIP konto loomine
Laokaupade väljatoomine
Allpool on Pythoni kood kõigi kontol määratletud laoüksuste toomiseks. (Siin tuuakse kõik laoartiklid ühe korraga, et vältida mõningast kordumist dokumendis. Loomulikult saab tuua mis tahes laoartiklite alamhulka, jättes mõned alloleva konto all olevad read välja.)
Selle koodi käivitamine annab järgmise väljundi:
Examples: Alarmid
Häiremallid ja nendega seotud üksused (SNMP haldurid, häirete meililoendid) luuakse ja hallatakse sarnaselt laoartikleid. See peatükk sisaldab XML- ja NETCONF-koodi selliste olemite määratlemiseks Paragon Active Assurance'is NETCONF & YANG API kaudu ja määratletud üksuste loendite toomiseks.
Häirete e-posti loendid
Häirete meililoendi loomine
Kõigi häirete meililoendite allalaadimine
SNMP haldurid
SNMP-halduri loomine
Kõigi SNMP-haldurite allalaadimine
Häiremallid
Häiremalli loomine
Kõigi häiremallide allalaadimine
Examples: SSH võtmed
Saate lisada SSH avalikke võtmeid testagendile NETCONF & YANG API kaudu. Kasutades vastavat privaatvõtit, saate seejärel SSH kaudu testagendisse sisse logida.
SSH-võtmete saadaolevate toimingute täielik loend on järgmine:
- Lisage SSH-võti
- Muutke SSH-võtit
- Kontrollige SSH-võtit
- Loetlege SSH-võtmed
- Kustutage SSH-võti.
Allpool on toodud lisamis- ja kustutamistoimingute näide.
SSH-võtme kustutamine
Kui soovite SSH-võtme kustutada, kasutage järgmist käsku:
Examples: Testid
Siin eeldatakse, et testagendid (nii palju kui testide jaoks on vaja) on loodud vastavalt jaotisele "Uue testagendi loomine ja juurutamine" lk 17.
YANG mudeliteed testide jaoks
| Üksus | YANG mudeli tee: /accounts/account/tests … |
| testid | /. |
| test[id] | /test |
| id | /test/id |
| nimi | /test/nimi |
| olek | /test/status |
| algusaeg | /test/algusaeg |
| lõpuaeg | /test/lõpuaeg |
| teata-url | /Testi tulemused-url |
| sammud | /test/sammud |
| samm[id] | /test/sammud/samm |
| nimi | /test/sammud/samm/nimi |
| id | /test/steps/step/id |
| algusaeg | /test/steps/step/start-time |
| lõpuaeg | /test/steps/step/end-time |
| olek | /test/sammud/samm/status |
| olekuteade | /test/steps/step/status-message |
| mallid | /mallid |
| mall[nimi] | /mallid/mall |
| nimi | /mallid/mall/nimi |
| kirjeldus | /templates/template/description |
| parameetrid | /mallid/mallid/parameetrid |
| parameeter [võti] | /mallid/mall/parameetrid/parameeter |
| võti | /templates/template/parameters/parameter/key |
| tüüp | /mallid/mall/parameetrid/parameeter/tüüp |
Testi orkestreerimise eeltingimused
- Testi alustamiseks NETCONF-i kaudu NC-kliendi abil tuleb esmalt luua kontrollkeskuse GUI abil testmall, nagu on üksikasjalikult kirjeldatud rakendusesisese abi jaotises „Testid ja monitorid” > „Mallide loomine”. Kõik väljad, mis on selles mallis määratud kui „Malli sisend”, on XML-i parameetritena kohustuslikud testmalli käivitamise korraldamisel.
- Paragon Active Assurance'i testide läbiviimist peetakse orkestreerimise kontekstis "olekuks". Olekuandmed on mittekirjutatavad andmed, mida ei salvestata konfiguratsiooniandmebaasi, erinevalt jaotises "Üle" mainitud konfiguratsiooniandmetest.view Põhimõtteliselt tähendab see, et juhtimiskeskuse GUI-s tehtud testide või mallide muudatused ei põhjusta juhtimiskeskuse ja konfiguratsiooniandmebaasi vahel sünkroonimisega seotud probleeme.
- Aruande saamiseks -URL otse testiaruannetes peate veenduma, et juhtimiskeskus URL on õigesti konfigureeritud. Seda tehakse file /opt/netrounds-confd/settings.py. Vaikimisi tuuakse juhtimiskeskuse hostinimi alla, kasutades socket.gethostname(): vt allpool. Kui see ei anna õiget tulemust, peate määrama hostinime (või kogu URL) selles käsitsi file.
# URL juhtimiskeskusest ilma kaldkriipsuta.
# See on näiteksampkatsearuandes kasutatudurl.
HOSTNAME = socket.gethostname()
NETROUNDS_URL = 'https://%s' % HOSTNAME
Testi alustamine
Nagu kirjeldatud jaotises "Uue testagendi loomine ja juurutamine" lk 17, käivitage käsk pang -f tree netrounds-ncc.yang
kataloogist /opt/netrounds-confd/, et väljastada YANG-mudel. Selles mudelis näeb NC-kliendiga testi alustamise RPC välja järgmine:
Selgitusi leiate jaotisest “Legend” lk 81 lisas.
Järgmised sammud on näidatud allpool.
- Testagendid on registreeritud Paragon Active Assurance'i kontole, kuid teste pole veel alustatud.
- Nõutavad sisendparameetrid tuvastatakse käivitatavas testmallis.
- 60-sekundiline HTTP-test käivitatakse ncclienti abil.
Samm 1: Paragon Active Assurance'i kontol ei algatatud ühtegi testi. Vaadake allolevat ekraanipilti juhtimiskeskuse GUI-st.
Samm 2: mall, mida kasutame testi käivitamiseks selles eksample on HTTP testmall. Sellel on kaks kohustuslikku sisestusvälja ( Kliendid ja URL), mille oleme juhtimiskeskuse GUI-s malli loomisel sellisena määratlenud.
Määratleme need parameetrid (muu hulgas) XML-konfiguratsioonis, mille meie NETCONF-i haldur (ncclient) edastab konfiguratsiooniandmebaasi.
3. samm: HTTP-test käivitatakse ncclienti abil.
Allpool on endineample kood, kus on määratud HTTP testmalli jaoks vajalik konfiguratsiooniteave ja parameetrid. Sõltuvalt malli ülesehitusest võivad üksikasjad siin erineda.
Iga parameetri jaoks on atribuut tuleb esitada. Võti on identne parameetriga
Muutuja nimi juhtimiskeskuses. Muutujate nimesid saate kontrollida järgmiselt.
- Klõpsake külgribal Testid ja valige Uus testijada.
- Klõpsake Minu mallid.
- Klõpsake huvipakkuva malli all olevat linki Redigeeri.
- Klõpsake paremas ülanurgas nuppu Redigeeri sisendit.
Meie endisesample ja vaikimisi on muutujate nimed lihtsalt juhtimiskeskuses kuvatavate kuvanimede väiketähtedega versioonid (“url" vs "URL", jne.). Kuid juhtimiskeskuse GUI-s saate muutujad ümber nimetada nii, nagu soovite.
Lisaks võtmele peab igal parameetril olema määratud tüüp: ntample, Selle eest URL.
Pange tähele, et peate uuestiview täielik YANG mudel, et saada täielikku teavet tüüpide kohta. Testagendi liideste puhul on tüübil keerulisem struktuur, nagu allpool näidatud allolevas koodis.
Nüüd saame skripti käivitada ncclienti abil. Eeldusel, et kõik on õige, käivitatakse test ja selle täitmine kuvatakse juhtimiskeskuses:
Kui test on edukalt käivitatud, vastab juhtimiskeskus testi ID-ga. Selles eksample, testi ID on 3:
Testi ID leiate ka aadressilt URL testi jaoks juhtimiskeskuse GUI-s. Selles eksample, see URL on https://host/demo/testing/3/.
Testitulemuste hankimine
Kõige lihtsam viis testitulemuste hankimiseks on testi ID-le osutamine.
Allpool on Pythoni kood ülaltoodud HTTP-testi tulemuste saamiseks ID = 3:
koos juhiga. Connect(host=args.host, port=args.port, username=args.username,password=args.password, hostkey_verify=False) kui m:
Väljund näeb välja umbes selline:
Testmallide eksportimine ja importimine
Testimalle saab eksportida JSON-vormingus ja uuesti importida selles vormingus juhtimiskeskusesse. See on kasulik, kui soovite kasutada testmalle mõnes muus juhtimiskeskuse installis. (Mallide algset loomist saab kõige paremini hallata juhtimiskeskuse GUI kaudu.)
Allpool on kood ekspordi ja impordi teostamiseks.
Testmallide eksportimine
# Hankige vastusest json-konfiguratsioon
juur = ET.fromstring(vastus._toores)
json_config = root[0].text
printida json_config
Mall sisaldub objektis json_config.
Testmallide importimine
JSON-i konfiguratsiooniobjekti, mis sisaldab testmalle, saab juhtimiskeskusesse uuesti importida järgmiselt.
Examples: monitorid
See jaotis eeldab, et testagendid (nii palju, kui monitorid nõuavad) on loodud vastavalt jaotisele „Uue testagendi loomine ja juurutamine” lk 17.
YANG mudeliteed monitoridele
| Üksus | YANG mudeli tee: /accounts/account/monitors … |
| monitorid | /. |
| monitor[nimi] | /monitor |
| nimi | /monitor/nimi |
| kirjeldus | /monitor/kirjeldus |
| alanud | /monitor/käivitatud |
| malli | /monitor/mall |
| alarm-konfiguratsioonid | /monitor/alarm-configs |
| Üksus | YANG mudeli tee: /accounts/account/monitors/monitor/alarm-configs … |
| alarm-config[identifikaator] | /alarm-config |
| identifikaator | /alarm-config/identifier |
| malli | /alarm-config/template |
| /alarm-config/email | |
| snmp | /alarm-config/snmp |
| thr-es-kriitiline | /alarm-config/thr-es-critical |
| thr-es-critical-clear | /alarm-config/thr-es-critical-clear |
| thr-es-major | /alarm-config/thr-es-major |
| thr-es-major-selge | /alarm-config/thr-es-major-clear |
| th-es-minor | /alarm-config/thr-es-minor |
| thr-es-minor-selge | /alarm-config/thr-es-minor-clear |
| thr-es-hoiatus | /alarm-config/thr-es-warning |
| thr-es-warning-clear | /alarm-config/thr-es-warning-clear |
| andmeteta-raskusaste | /alarm-config/no-data-severity |
| no-data-timeout | /alarm-config/no-data-timeout |
| tegevust | /alarm-config/action |
| akna suurus | /alarm-config/window-size |
| intervall | /alarm-config/interval |
| saata ainult üks kord | /alarm-config/send-only-one |
| snmp-trap-per-stream | /alarm-config/snmp-trap-per-stream |
| Üksus | YANG mudeli tee: /accounts/account/monitors … |
| parameetrid | /monitor/parameetrid |
| Üksus | YANG mudeli tee: /accounts/account/monitors/monitor/parameters … |
| parameeter [võti] | /parameeter |
| võti | /parameeter/võti |
| (väärtus-tüüp) | /parameeter |
| :(täisarv) | /parameeter |
| täisarv | /parameeter/täisarv |
| :(ujuda) | /parameeter |
| ujuk | /parameeter/ujuk |
| :(string) | /parameeter |
| Üksus | YANG mudeli tee: /accounts/account/monitors/monitor/parameters … |
| string | /parameeter/string |
| :(testagendi liidesed) | /parameeter |
| test-agendi liidesed | /parameter/test-agent-interfaces |
| test-agent-interface [“1” lk 58 | /parameter/test-agent-interfaces/ |
| konto | /parameter/test-agent-interfaces/test-agent-interface/account |
| test-agent | /parameter/test-agent-interfaces/test-agent-interface/test-agent |
| liides | /parameter/test-agent-interfaces/test-agent-interface/interface |
| ip-versioon | /parameter/test-agent-interfaces/test-agent-interface/ip-version |
| :(twamp- helkurid) | /parameeter |
| twamp- helkurid | /parameeter/twamp- helkurid |
| twamp-helkur[nimi] | /parameeter/twamp-helkurid/twamp- helkur |
| nimi | /parameeter/twamp-helkurid/twamp-helkur/nimi |
| :(y1731-meps) | /parameeter |
| y1731-meps | /parameter/y1731-meps |
| y1731-mep[nimi] | /parameter/y1731-meps/y1731-mep |
| nimi | /parameter/y1731-meps/y1731-mep/name |
| :(sip-kontod) | /parameeter |
| sip-kontod | /parameeter/sip-kontod |
| sip-konto["2" lk 58] | /parameter/sip-accounts/sip-account |
| konto | /parameter/sip-accounts/sip-account/account |
| test-agent | /parameter/sip-accounts/sip-account/test-agent |
| liides | /parameter/sip-accounts/sip-account/interface |
| sip-aadress | /parameter/sip-accounts/sip-account/sip-address |
| :(iptv-kanalid) | /parameeter |
| iptv-kanalid | /parameeter/iptv-kanalid |
| iptv-kanal[nimi] | /parameeter/iptv-kanalid/iptv-kanal |
| nimi | /parameeter/iptv-kanalid/iptv-kanal/nimi |
- konto test-agendi liides
- konto test-agendi liidese sip-aadress
| Üksus | YANG mudeli tee: /accounts/account/monitors … |
| olek | /monitor/status |
| viimased 15 minutit | /monitor/status/viimased 15 minutit |
| olek | /monitor/status/viimased-15-minutid/status |
| staatus-väärtus | /monitor/status/viimased-15-minutid/oleku-väärtus |
| viimane tund | /monitor/status/last-hour |
| olek | /monitor/status/last-hour/status |
| staatus-väärtus | /monitor/status/last-hour/status-value |
| viimased 24 tundi | /monitor/status/viimased 24-tunnid |
| olek | /monitor/status/viimased-24-tunnid/status |
| staatus-väärtus | /monitor/status/viimased-24-tunnid/status-väärtus |
| mallid | /mallid |
| mall[nimi] | /mallid/mall |
| nimi | /mallid/mall/nimi |
| kirjeldus | /templates/template/description |
| parameetrid | /mallid/mallid/parameetrid |
| parameeter [võti] | /mallid/mall/parameetrid/parameeter |
| võti | /templates/template/parameters/parameter/key |
| tüüp | /mallid/mall/parameetrid/parameeter/tüüp |
Monitori orkestreerimise eeltingimused
Enne monitori käivitamist NETCONF-i kaudu ncclienti abil peate juhtkeskuse GUI-s koostama monitori malli, nagu on selgitatud rakendusesisese abi jaotises „Testid ja monitorid” > „Mallide loomine”. Malli käivitamise korraldamisel on XML-is nõutavad kõik väljad, mis on selles mallis määratud kui „Malli sisend”.
Sisendparameetrite hankimine monitori mallidest
Allpool on näidatud kaks malli. Esimene on mõeldud UDP jälgimiseks kahe testagendi liidese vahel ja teine HTTP jaoks, kasutades ühte testagendi liidest.
Malli sisendparameetrite väljaselgitamiseks klõpsake malli tähistaval kastil. HTTP-malli puhul võivad parameetrid välja näha järgmised:
Peame need parameetrid määratlema järgmises etapis monitori käivitamisel.
Monitori käivitamine
Jaotises „Uue testagendi loomine ja juurutamine” lk 17 määratletud ja juurutatud testagentide abil saame käivitada monitori mallist „HTTP”, nagu allpool näidatud.
Iga parameetri jaoks on atribuut tuleb esitada. Võti on identne juhtimiskeskuse parameetri muutuja nimega. Muutujate nimesid saate kontrollida järgmiselt.
- Klõpsake külgribal Monitoring ja valige Uus monitor.
- Klõpsake Minu mallid.
- Klõpsake huvipakkuva malli all olevat linki Redigeeri.
- Klõpsake paremas ülanurgas nuppu Redigeeri sisendit.
Meie endisesample ja vaikimisi on muutujate nimed lihtsalt juhtimiskeskuses kuvatavate kuvanimede väiketähtedega versioonid (“url" vs "URL", jne.). Kuid juhtimiskeskuse GUI-s saate muutujad ümber nimetada nii, nagu soovite.
Lisaks võtmele peab igal parameetril olema määratud tüüp: ntample, Selle eest URL. Pange tähele, et täielikku teavet parameetri tüübi kohta leiate YANG mudelist. Testagendi liideste puhul on sellel tüübil keerulisem struktuur, nagu on näidatud allolevas koodis.
EksisampJärgnevalt ei seostata monitoriga häiret. Näiteksamphäireid puudutavates küsimustes lugege jaotist "Monitori käivitamine häirega" lk 62.
Monitori käivitamine häirega
Häire monitoriga seostamiseks võite osutada defineeritud häiremallile või kuvari loomisel esitada kogu häirekonfiguratsiooni. Anname ühe eksampiga allpool toodud lähenemisviisi kohta.
Monitori häire seadistamine, osutades häiremallile
Häiremalli kasutamiseks peate teadma selle ID-d. Selleks hankige esmalt kõik oma häiremallid, nagu on kirjeldatud jaotises “Kõigi häiremallide toomine” lk 39, ja märkige üles vastava malli nimi. Seejärel saate sellele mallile viidata järgmiselt.
Monitori häire seadistamine selle otse konfigureerimise teely
Teise võimalusena saate seadistada monitorile häire, esitades kuvari loomisel kogu selle konfiguratsiooni, ilma häiremallile viitamata. Seda tehakse nii, nagu on näidatud järgmises näitesample.
Töötavate monitoride allalaadimine
Kõigi praegu töötavate monitoride toomiseks käivitage see skript:
koos juhiga. connect(host=args.host, port=args.port, kasutajanimi=args. kasutajanimi, parool=args.password, hostkey_verify=False) kui m:
Väljund on kõigi töötavate monitoride loend, nagu allpool näidatud:
Monitori SLA oleku hankimine
Siin on, kuidas hankida monitori SLA olek. Selles eksample, hangime monitori "Võrgukvaliteet" SLA oleku kolme ajavahemiku jooksul: viimase 15 minuti, viimase tunni ja viimase 24 tunni jooksul.
Väljund näeb välja umbes selline:
NETCONF-i teatised
Monitoride NETCONF-i teatised käivitatakse SLA rikkumiste tõttu. Need ilmnevad siis, kui monitori SLA langeb alla SLA läve ("Hea" või "Aktsepteeritav") teatud ajaaknas, vaikimisi viimase 15 minuti jooksul. Tuleb märkida, et SLA rikkumise teatised ilmuvad kiiresti pärast seda, kui probleem on teenust mõjutanud, samas kui SLA olek naaseb olekusse "Hea" alles 15 minuti pärast ja ainult siis, kui rikkumisi enam ei esine.
Ajaakent saab muuta, muutes sätet SLA_STATUS_WINDOW (väärtus sekundites) /etc/netrounds/netrounds.conf.
Monitori mallide eksportimine ja importimine
Seda tehakse täpselt samamoodi nagu testmallide puhul; võrrelge jaotist "Testimallide eksportimine ja importimine" lk 52. Allolevad koodilõigud illustreerivad monitoride mallide eksportimist ja importimist.
Monitori mallide eksportimine
Monitori mallide importimine
Tags Paragon Active Assurance'is määratletud saab rakendada:
- monitorid
- monitori mallid
- Testagendid
- TWAMP helkurid
- Ping hosts.
Näiteksample, sa saad tag monitor samasugusega tag monitori käivitavate testagentide alamhulgana. See funktsioon on eriti kasulik, kui teil on määratletud suur hulk monitore ja malle.
Kui olete monitori jaoks seadistanud SNMP-lõksudega häire, määratakse SNMP-lõksudele sama tags kui monitor, kui see on olemas.
Loomine Tags
Allpool näitame, kuidas luua a tag nime ja värviga, nagu on määratletud XML-istag> aluskonstruktsioon.
Määrates a Tag
Määrata a tag ressursile, lisate selle uuenatag> elementi alltags> selle ressursi element.
Siin on, kuidas määrata a tag testimisagendile:
Määrata a tag TW-leAMP helkur, toimige järgmiselt.
Määrates a tag monitori käsitletakse sarnaselt:
Teise võimalusena saate määrata olemasoleva tag mis tahes nendest ressursitüüpidest ressursi loomisel, kaasatestags> elementi, mis sisaldab tag küsimuses.
Värskendamine a Tag
Olemasoleva värskendamine tag uute atribuutidega on analoogne a loomisega tag:
Määramise tühistamine a Tag
Määrangu tühistamiseks a tag ressursist lisage atribuut nc:operation=”delete”.tag> ressursile kuuluv element. Allpool tühistame a määramise tag monitorilt.
Kustutamine a Tag
Kustutamiseks a tag täielikult juhtimiskeskusest kasutatakse taas atribuuti nc:operation=”delete”, kuid seekord rakendatakse seda tag all määratletud .
Veaotsing
Probleem: Orchestrator ja Paragon Active Assurance on sünkroonist väljas
Orchestrator ja Paragon Active Assurance võivad ntample, kui juhtimiskeskuse GUI-s on tehtud konfiguratsioonimuudatusi või kui konfiguratsiooni rakendamine ei õnnestunud ja eelmisele olekule naasmine ebaõnnestus.
Ebaõnnestunud tagasipööramise korral ei aktsepteeri NETCONF-server enam konfiguratsioonimuudatusi; see vastab tõrketeatega, mis teatab, et konfiguratsioon on lukus, kuni sünkroonimine on taastatud. Sünkroonimise taastamiseks ja konfiguratsioonimuudatuste avamiseks peate käivitama käsu rpc sync-from-ncc, mis sünkroonib kogu konfiguratsiooni juhtimiskeskusest konfiguratsiooniandmebaasi.
MÄRKUS. The confd@netrounds.com kasutajal (või mis iganes on konfigureeritud) peavad kõige edukaks sünkroonimiseks olema superkasutaja õigused. Seda saab saavutada käsuga ncc user-update confd@netrounds.com –is-superuser Kui kasutaja ei ole superkasutaja, kuvatakse hoiatus, et kõike ei saa sünkroonida, kuid kõik, mida saab käsitleda, on tehtud.
MÄRKUS. Kui teie orkestraator salvestab ka konfiguratsiooni, peate ka selle uuesti sünkroonima, kuna nõutud konfiguratsiooni (konfiguratsiooni, mida orkestraator eeldab juhtimiskeskuses olevat) ei rakendata.
Probleem: esialgne sünkroonimine (sünkroonimine ncc-st) ebaõnnestus toetamata ressursside tõttu
Kui proovite käivitada rpc sync-from-ncc kontol, mille konfiguratsioon on loodud juhtimiskeskuse GUI-s, võib teil tekkida probleeme, kui konto sisaldab toetamata ressursse. Soovitatav on alustada tühja kontoga ja teha kõik selle konfiguratsioonid läbi NETCONF-i. Vastasel juhul, kui teil tekib probleeme ressursside konfliktidega, peate konfliktsed ressursid kontolt eemaldama.
Probleem: NETCONF-i käsud ebaõnnestuvad koos ncclient.operations.rpc.RPCError: rakenduse sidetõrge
NETCONF-server ei taasta juhtimiskeskuse taaskäivitamisel automaatselt ühendust juhtimiskeskuse serveriga. Juhtimiskeskusega ühenduse taastamiseks taaskäivitage NETCONF-protsess: sudo systemctl restart netrounds-confd
Märkused testagendi rakenduste ja testagendi seadmete kohta
Testagendi rakendused ConfD-s
Testagentide hulgas töötab (uuem) testagendi rakendus (vanemast) testagendi seadmest pisut erinevalt.
Testagendi rakendused ei toeta praegu liidese konfigureerimist. Seetõttu võimaldab YANG-skeem selliste testagentide jaoks määrata tühja liidese konfiguratsiooni. Vt “seda lõiku” lk 23, et näha eksample.
ConfD andmebaasi juhtimiskeskusega sünkroonimisel käsu sync-from-ncc abil soovite, et liidese konfiguratsioon jääks tühjaks ja et seda ei kirjutataks üle juhtimiskeskuses leiduvaga. Seetõttu peate testagendi rakendustega töötamisel selle käsuga kasutama spetsiaalset lippu –ilma_liidese_config.
Tühi liidese konfiguratsioon testagendi seadme jaoks
Nagu ülalpool märgitud, ei toeta testagendi rakendus liidese konfigureerimist ja seetõttu on YANG-skeemis võimalik liideseid välja jätta.
Kuid on ka juhtumeid, kus võiksite testagendi seadmest liidese konfiguratsiooni välja jätta. EndineampSee võib olla orkestratsioonistsenaarium, kus keerutate pilviniti abil testagenti ja soovite, et seal kasutataks liidese konfiguratsiooni, selle asemel, et lasta ConfD-l see testagendi võrku jõudmisel üle kirjutada.
YANG skeemi muudatused seoses määratlemata liidestega
Kuna tühi liidese konfiguratsioon on nüüd lubatud (alates versioonist 2.34.0), on testi või monitori osana töötava ülesande sisendiks võimalik määrata mis tahes liidese nimi.
See on vajalik testagendi rakenduse kasutamiseks, kuna nende jaoks pole ConfD-s liidese nimesid määratletud. Pange tähele, et see tähendab ka probleeme, kui konfigureerite testi või monitori kogemata kasutamata liidest. Seega olge sellega ettevaatlik.
Piirangud ConfD-s loodud testagendi registreerimisel
REST või NETCONF/YANG API kaudu testagendi loomisel ei saa me eelnevalt teada, mis tüüpi see on: Test Agent Appliance või Test Agent Application. See selgub alles pärast testagendi registreerumist.
Kui testagent on registreeritud ja muutunud üheks nendest konkreetsetest tüüpidest, ei ole teil lubatud seda teist tüüpi testiagendina uuesti registreerida. See tähendab, et teil ei ole lubatud seda esmalt registreerida testagendi seadmena, seejärel uuesti registreerida testagendi rakendusena ega vastupidi. Kui vajate teist tüüpi testagenti, peate looma uue testagendi.
Lisa: Täieliku YANG-mudeli puustruktuur
Selle lisa jaotises “Legend” lk 81 selgitatakse YANG-mudeli puustruktuuri süntaksit, mis on genereeritud käsuga pyang -f tree.
Jaotis "YANG mudelipuu struktuur" lk 82 annab selle käsu väljundi, mida rakendatakse failile netrounds-ncc.yang. Osa sellest väljundist on esitatud mujal dokumendis.
Legend
YANGi mudelipuu struktuur
Juniper Networks, Juniper Networksi logo, Juniper ja Junos on Juniper Networks, Inc. registreeritud kaubamärgid Ameerika Ühendriikides ja teistes riikides. Kõik muud kaubamärgid, teenindusmärgid, registreeritud kaubamärgid või registreeritud teenindusmärgid on nende vastavate omanike omand. Juniper Networks ei vastuta selles dokumendis esinevate ebatäpsuste eest. Juniper Networks jätab endale õiguse seda väljaannet ette teatamata muuta, muuta, üle anda või muul viisil muuta. Autoriõigus © 2023 Juniper Networks, Inc. Kõik õigused kaitstud.
Dokumendid / Ressursid
 |
Juniper NETWORKS NETCONF & YANG API tarkvara [pdfKasutusjuhend NETCONF YANG API tarkvara, YANG API tarkvara, API tarkvara, tarkvara |