NETCONF & YANG API Orkestracija
Vodič
Objavljeno
2023-07-07
OBJAVA 4.2
Uvod
Svrha ovog dokumenta
Ova dokumentacija opisuje kako integrirati Paragon Active Assurance s orkestratorom mrežnih usluga putem Control Center NETCONF & YANG API. Praktična prampDate su datoteke o glavnim uključenim zadacima, uključujući: kreiranje i postavljanje virtualnih testnih agenata, izvođenje testova i nadzora te dohvaćanje rezultata iz ovih aktivnosti.
U ovom dokumentu, besplatno dostupan Python NETCONF klijent ncclient koristi se u ulozi orkestratora.
konvencije
U ovom dokumentu koriste se sljedeće kratice:
| Kratica | Značenje |
| CLI | Sučelje naredbenog retka |
| EM | Upravitelj elemenata |
| ES | Druga pogreška |
| europarlamentarka | MEG (Maintenance Entity Group) krajnja točka (ITU-T Y.1731 definicija) ili krajnja točka održavanja (Cisco definicija) |
| NFV | Virtualizacija mrežnih funkcija |
| NFVO | Orkestrator virtualizacije mrežnih funkcija |
| NSD | Deskriptor mrežne usluge |
| RPC | Poziv udaljene procedure |
| GUTLJAJ | Protokol pokretanja sesije |
| SLA | Ugovor o razini usluge |
| S-VNFM | Posebni VNF upravitelj |
| VNF | Funkcija virtualne mreže |
| vTA | Virtualni test agent |
Napomene o povratnoj kompatibilnosti
U verzijama 2.35.4/2.36.0 NETCONF & YANG API-ja, provjera valjanosti određenih zahtjeva postala je stroža kako bi se pridržavala NETCONF standarda. To znači da klijentski kod temeljen na starijim verzijama ovog vodiča sada može biti odbijen.
Na primjerample, u prethodnom Python exampkoda datoteke, atribut prostora imena nije naveden. Prostor imena sada treba biti naveden u XML-u zahtjeva kad god želite modificirati ConfD resurs.
Preduvjeti i pripreme
ConfD instalacija
ConfD (proizvod tvrtke Tail-f) koristi se kao posrednik između Paragon Active Assurance sustava i NETCONF-a. ConfD povezuje Paragon Active Assurance konfiguraciju i operativne podatke s NETCONF & YANG API-jem.
ConfD je trebao biti instaliran zajedno sa softverom Control Center, kao što je opisano u Vodiču za instalaciju.
Provjera radi li ConfD
Da biste provjerili radi li ConfD, pokrenite naredbu
ssh -s @localhost -p 830 netconf
kako biste provjerili odgovara li ConfD na priključku 830. U naredbi, kako je definirano netconf user createom
naredba u Vodiču za instalaciju, odjeljak Instaliranje ConfD. Dajte lozinku definiranu istom naredbom.
U izlazu provjerite je li uključen modul Control Center. Izlaz bi trebao sadržavati redak poput sljedećeg:
http://ncc.netrounds.com?module=netrounds-ncc&revizija=2017-06-15
Sinkronizacija konfiguracijske baze podataka s kontrolnim centrom
Na kraju, moramo ažurirati konfiguracijsku bazu podataka putem NETCONF-a. Ovdje ćemo to učiniti pomoću Python biblioteke koja se zove ncclient (NETCONF klijent). Međutim, zadatak se također može izvršiti u drugom programskom jeziku sve dok koristi NETCONF/YANG protokol.
Uloga nclienta je da djeluje kao klijent prema ConfD poslužitelju koji hostira NETCONF/YANG API.
Vrijedno je istaknuti da ncclient nije ni na koji način povezan s Control Centerom (prethodno "Netrounds Control Center"), iako ime počinje s "ncc".
Evo kako instalirati ncclient:
- Preuzmite softver sa https://github.com/ncclient/ncclient.
- Pokrenite ovu naredbu: pip install ncclient
Sada možemo izvršiti sinkronizaciju na sljedeći način. Imajte na umu da to treba učiniti na zasebnom računalu, a ne na samom poslužitelju kontrolnog centra:
#
# BILJEŠKA:
# Ova skripta djeluje kao klijent prema ConfD-u koji se izvodi na NCC poslužitelju.
# Za komunikaciju će koristiti NETCONF/YANG API.
BILJEŠKA: Ovaj postupak je također potreban kad god su testni agenti instalirani i registrirani neovisno o NETCONF-u. Pogledajte napomenu u odjeljku “Prekoview orkestracije testnog agenta” na stranici 17 za više informacija.
Postavljanje više Paragon Active Assurance računa pod kontrolom NETCONF-a
Koraci u nastavku su potrebni samo ako želite postaviti dodatne Paragon Active Assurance račune koje će kontrolirati NETCONF, uz račun konfiguriran na ovaj način u Vodiču za instalaciju, odjeljak "Instaliranje ConfD-a".
Za svaki takav račun postupite na sljedeći način:
- U Kontrolnom centru prijavite se na račun i idite na Račun > Dozvole.
- Dodajte korisnika "confd@netrounds.com“, i dodijelite administratorsku dozvolu ovom korisniku ConfD-a u GUI klikom na gumb Pozovi.
- Sinkronizirajte konfiguracijsku bazu podataka s kontrolnim centrom kao što je opisano u odjeljku “Sinkroniziranje konfiguracijske baze podataka s kontrolnim centrom” na stranici 4.
Sada biste trebali moći kontrolirati više Paragon Active Assurance računa s istim ConfD korisnikom.
BILJEŠKA: Nakon što počnete kontrolirati Paragon Active Assurance račun putem ConfD-a, NE smijete unositi promjene na ovaj račun putem web GUI u odnosu na sve značajke Paragon Active Assurancea koje su “config” (pogledajte poglavlje “Podržane značajke u Paragon Active Assurance” na stranici 9). Ako to učinite, doći će do gubitka sinkronizacije.
Uvod u NETCONF Orchestration API
Nadview
NFVO ili orkestrator usluge treće strane obično je komponenta koja pokreće sesije testiranja i nadzora pomoću API-ja kontrolnog centra. Ovaj orkestrator također dohvaća agregirane rezultate mjerenja iz aktivnosti test agenta. KPI-jeve performansi mogu dohvatiti sustavi upravljanja performansama trećih strana, dok se događaji – nakon što ih pokreću kršenja pragova postavljenih u kontrolnom centru – mogu poslati sustavima upravljanja greškama trećih strana.
Ukratko, slika ispod pokazuje kako Paragon Active Assurance komunicira sa sustavima drugih proizvođača u OSS okruženju.
- NFVO/Service Orchestrator: daje upute upravitelju VNF-a da implementira vTA i konfigurira Paragon Active Assurance u lancu usluga. Nakon što je usluga aktivirana, orkestrator koristi API prema kontrolnom centru kako bi pokrenuo testove aktivacije usluge i dohvatio rezultate prošao/nije prošao. Ako su testovi prošli, orkestrator će koristiti API prema Kontrolnom centru za početak aktivnog praćenja usluge. KPI-ove iz praćenja kontinuirano dohvaća ili orkestrator ili zasebna platforma za upravljanje učinkom.
- Kontrolni centar: postavlja, skalira i prekida vTA prema uputama NFVO-a ili uslužnog orkestratora.
- Sustav upravljanja učinkom ili sustav upravljanja kvalitetom usluge: čita KPI-jeve iz aktivnog nadzora putem API-ja kontrolnog centra.
- Sustav za upravljanje greškama: prima NETCONF, SNMP ili obavijesti e-poštom od Kontrolnog centra ako su prekršeni SLA-ovi.
Definicije pojmova u Paragon Active Assurance
- Test agenti: Komponente koje izvode mjerenja (za testove kao i za monitore) u Paragon Active Assurance sustavu. Test agenti sastoje se od softvera sa sposobnošću generiranja, primanja i analize stvarnog mrežnog prometa.
- Vrsta agenta za testiranje o kojoj se govori u ovom dokumentu je virtualni agent za testiranje (vTA), virtualna mrežna funkcija (VNF) postavljena na hipervizoru. Postoje i druge vrste testnih agenata.
- Postoje dvije osnovne vrste mjerenja u Paragon Active Assuranceu, testovi i monitori.
- Test: Test se sastoji od jednog ili nekoliko koraka, od kojih svaki ima određeno, konačno trajanje. Koraci se izvode sekvencijalno. Svaki korak može uključivati pokretanje više zadataka istovremeno.
- Monitor: Monitor nema određeno trajanje već se izvršava neograničeno. Poput koraka u testu, monitor može izvršavati više istovremenih zadataka.
- Predložak: Kada Paragon Active Assurance kontrolira orkestrator, testovi i nadzori uvijek se izvršavaju pomoću predložaka u kojima je definiran test ili monitor. Postavke parametara mogu se proslijediti kao ulazi u predložak tijekom izvođenja.
Tijek rada za automatizaciju
Vrijeme dizajna
Tijekom projektiranja pripremate mjerenja stvaranjem predložaka za testove i monitore u Paragon Active Assurance. Kako to učiniti objašnjeno je u poglavlju “Predlošci za testiranje i praćenje” na stranici 15.
Runtime
Tijekom rada postavljate svoje uređaje i izvodite stvarna mjerenja.
- Overview od svih bivšihamples se nalazi u poglavlju “Prampo upravljanju Paragon Active Assurance putem NETCONF & YANG API-ja” na stranici 15.
- Kako implementirati i konfigurirati test agente opisano je u poglavlju “Npramples: Test agenti” na stranici 16.
- Kako uvesti stavke inventara kao što je TWAMP reflektori i IPTV kanali obrađeni su u poglavlju “Pramples: Stavke inventara” na stranici 29.
- Kako konfigurirati alarme objašnjeno je u poglavlju “Npramples: Alarmi” na stranici 35.
- Kako pokrenuti testove i nadgledati izvršavanjem predložaka Paragon Active Assurance putem NETCONF-a opisano je u poglavljima “Pr.amples: Testovi” na stranici 43 i “Pramples: Monitori” na stranici 54.
Podržane značajke u Paragon Active Assurance
Sve vrste testova i nadzora u Paragon Active Assuranceu mogu se stvoriti i izvršiti korištenjem predložaka. Kako to učiniti objašnjeno je u pomoći unutar aplikacije pod “Testovi i monitori” > “Stvaranje predložaka”.
Izrada Paragon Active Assurance računa trenutno nije podržana; međutim, za korisnika će biti postavljen jedan ili više unaprijed definiranih računa.
Tablice u nastavku detaljno opisuju koje su značajke Paragon Active Assurance dostupne u ovom izdanju i kako su te značajke predstavljene u YANG-u.
Objašnjenje YANG konstrukata
Radi praktičnosti, ovdje su dane definicije YANG konstrukata koji se spominju u tablici značajki.
- Konfiguracija (config=true): podaci o konfiguraciji potrebni za transformaciju sustava iz jednog stanja u drugo.
- Stanje (config=false): Podaci o stanju: dodatni podaci o sustavu koji nisu konfiguracijski podaci, kao što su statusne informacije samo za čitanje i prikupljene statistike.
- RPC: Poziv udaljene procedure, kako se koristi unutar NETCONF protokola.
- Obavijest: Obavijesti o događajima poslane s NETCONF poslužitelja NETCONF klijentu.
Tablice Paragon Active Assurance značajki dostupnih za orkestraciju
Resurs: Praćenje
YANG put:/računi/račun/monitori
| Značajka | Podznačajka | YANG konstrukcija |
| Stvaranje/izmjena/brisanje monitora | Na temelju predloška monitora | Konfiguracija |
| Start/stop monitor | – | Konfiguracija |
| Predlošci monitora | Navedite postojeće predloške monitora s unosima | Stanje |
| NETCONF obavijesti | Stanje alarma promijenjeno | Obavijest |
| Pratite rezultate | SLA/ES brojač za najvišu razinu (%) SLA/ES brojač za razinu zadatka (%) |
Stanje |
Za razliku od testova (usporedite Resurs: Testovi u nastavku), monitori se ne pokreću s RPC-om, već predajom konfiguracije monitora.
Izvor: Testovi
YANG put: /accounts/account/tests
| Značajka | Podznačajka | YANG konstrukcija |
| Započni test | Na temelju testnog predloška | RPC |
| Upravljanje testovima | Navedite testove sa statusom | Stanje |
| Testni predlošci | Navedite postojeće testne predloške s unosima | Stanje |
| NETCONF obavijesti | Status testa promijenjen | Obavijest |
| Rezultati ispitivanja | Dohvaćanje statusa koraka testa (prošlo, neuspješno, pogreška, …) | Stanje |
Resurs: Testna sredstva
YANG staze:
- /accounts/account/test-agents (Konfiguracija)
- /accounts/account/registered-test-agents (država)
Testni agenti pod /accounts/account/test-agenti su oni koji su konfigurirani na računu. Samo ove testne agente orkestrator može konfigurirati i koristiti u testovima i monitorima putem NETCONF-a.
Nakon što ste konfigurirali test agenta i on se registrirao na račun, test agent će se pojaviti pod /accounts/account/registered-test-agents. Sve registrirane test agente možete pronaći pomoću naredbe “get” u NETCONF-u (usporedite poglavlje Npr.amples: Testna sredstva).
Pod /accounts/account/registered-test-agents također možete pronaći testne agente koji još nisu konfigurirani. Svaki takav test agent mora biti konfiguriran prije nego što se može koristiti.
U scenariju orkestracije općenito se preporučuje da sve konfiguracije svog Paragon Active Assurance računa izvršite putem NETCONF-a. Ovo osigurava da se agenti za testiranje i registrirani agenti za testiranje ne razlikuju.
| Značajka | Podznačajka | YANG konstrukcija |
| Unaprijed izradite test agenta na poslužitelju | – | Konfiguracija |
| Konfigurirajte offline test agenta | (Kontrolni centar gura konfiguraciju u Test Agent kada dođe na mrežu) |
Konfiguracija |
| Koristite postojeće/vanjski konfigurirane test agente | Upotreba u testu/monitoru | Konfiguracija |
| Konfigurirajte sučelja | Konfiguracija | |
| Dobiti status | Stanje | |
| Konfiguracija testnog agenta (samo testni uređaj) | Konfigurirajte NTP | Konfiguracija |
| Konfigurirajte mostove | Konfiguracija | |
| Konfigurirajte VLAN sučelja | Konfiguracija | |
| Konfigurirajte SSH tipke | Konfiguracija | |
| IPv6 | Konfiguracija | |
| Utils | Ponovno pokretanje | RPC |
| Ažurirati | RPC | |
| NETCONF obavijesti | Online status promijenjen | Obavijest |
| Status | Dobijte status sustava (vrijeme neprekidnog rada, korištenje memorije, prosječno opterećenje, verzija) |
Stanje |
Izvor: Inventar
YANG put: /accounts/account/twamp- reflektori
Podržane NETCONF mogućnosti
Donja tablica ukazuje na IETF RFC-ove koji opisuju mogućnosti NETCONF-a koje se koriste u svrhu orkestracije Paragon Active Assurance.
- ietf-netconf.yang
- IETF RFC 6241, Protokol mrežne konfiguracije (NETCONF), https://tools.ietf.org/html/rfc6241
- Jedina podržana metoda rukovanja pogreškama je vraćanje na pogrešku.
- Jedina podržana pohrana podataka je radna za pisanje.
- ietf-netconf-obavijesti.yang
- IETF RFC 5277, NETCONF obavijesti o događajima, https://tools.ietf.org/html/rfc5277
Predlošci za testiranje i praćenje
Predloške za vrste testova i monitora potrebno je postaviti ručno putem Paragon Active Assurance prednjeg korisničkog sučelja. Kako to učiniti objašnjeno je u pomoći unutar aplikacije pod “Testovi i monitori” > “Stvaranje predložaka”.
Exampo upravljanju Paragon Active Assurance putem NETCONF & YANG API-ja
U poglavljima koja slijede pretpostavlja se da su prikladni predlošci za testiranje i nadgledanje definirani prema uputama danim u poglavlju “Predlošci za testiranje i nadgledanje” na stranici 15.
Alati korišteni u pramples
Svi bivšiampdatoteke u narednim poglavljima konstruirane su pomoću sljedećih besplatno dostupnih alata:
- Pang: Koristi se za vizualizaciju i pregledavanje YANG modela.
- Dostupno na https://github.com/mbj4668/pyang (klonirajte iz git i pokrenite python setup.py install).
- Python NETCONF klijent “ncclient”: Koristi se za komunikaciju s Kontrolnim centrom pomoću NETCONF-a.
- Dostupno na https://github.com/ncclient/ncclient (pokrenite pip install ncclient).
Model podataka netrounds-ncc.yang nalazi se u /opt/netrounds-confd nakon što je ConfD instaliran u skladu s Vodičem za instalaciju).
Nadview obavljenih ključnih zadataka
(Neki daljnji zadaci također su prikazani u nastavku.)
- “Stvaranje i postavljanje novog testnog agenta” na stranici 16
- “Stvaranje stavki inventara (npr. reflektori)” na stranici 29
- “Postavljanje predložaka alarma i gdje poslati alarme” na stranici 35
- “Kreiranje i izvođenje testa” na stranici 45
- “Dohvaćanje rezultata testa” na stranici 50
- “Pokretanje monitora (uključuje postavljanje alarma)” na stranici 60
- “Dohvaćanje SLA statusa za monitor” na stranici 67
- “Rad s tags” na stranici 71
Examples: Test agenti
Nadview orkestracije test agenta
Testni agenti u Paragon Active Assuranceu smatraju se "konfiguracijom" u kontekstu orkestracije. To znači da se stvaranje, kontrola i brisanje testnih agenata trebaju vršiti putem orkestratora i NETCONF-a, a ne putem Paragon Active Assurance GUI.
VAŽNO: Ako je testni agent instalirao tehničar i registrirao ga u Kontrolnom centru, a da prethodno nije kreiran putem NETCONF & YANG API-ja, testni agent neće postojati u konfiguracijskoj bazi podataka i sustav će izaći iz sinkronizacije. Da bi ConfD postao svjestan testnog agenta u ovom slučaju, bit će potrebno izvršiti novu sinkronizaciju s kontrolnim centrom, kao što je detaljno opisano u odjeljku "Sinkronizacija konfiguracijske baze podataka s kontrolnim centrom" na stranici 4.
Orkestracija virtualnih testnih agenata (vTA) stoga bi se radije trebala provesti u sljedećim koracima:
- Kreirajte Virtual Test Agent, uključujući njegovu konfiguraciju sučelja, koristeći NETCONF & YANG sučelje za Control Center. Ime testnog agenta bit će njegov jedinstveni ključ.
- Postavite vTA na virtualizacijsku platformu. Slijedite upute u online pomoći pod Test Agenti > Instalacija. Osnovna konfiguracija sučelja koja omogućuje vTA-u povezivanje s Control Centerom, kao i vjerodajnice za autentifikaciju, pružaju se u vTA-u pomoću korisničkih podataka pokretanja oblaka.
Nakon što se vTA pokrene, automatski će se spojiti na Kontrolni centar pomoću šifrirane OpenVPN veze. Šalje se NETCONF obavijest budući da je vrijednost parametra test-agent-statuschange vTA sada promijenjena u "online".
BILJEŠKA: Budući da je naziv vTA njegov identifikator u Kontrolnom centru, ovo ime mora biti isto kao ono definirano u Kontrolnom centru u “korak 1” na stranici 17. - Nakon što se vTA povezao i provjerio autentičnost na Kontrolnom centru, konfiguracija sučelja se šalje na vTA. Ovo je konfiguracija sučelja dana u “korak 1” na stranici 17 kada je vTA kreiran u Kontrolnom centru.
- Nakon što je vTA poslužio svojoj svrsi, izbrišite vTA.
Stvaranje i postavljanje novog testnog agenta
Prvo trebamo kreirati test agenta koristeći NETCONF & YANG sučelje za Control Center. Kada se testni agent kreira na ovaj način, nije potrebna sinkronizacija s kontrolnim centrom.
YANG model za testnog agenta prikazan je u nastavku. Dobiva se kao izlaz iz naredbe
pyang -f stablo netrounds-ncc.yang
Puni YANG model dan je u “Dodatku: Struktura stabla punog YANG modela” na stranici 81, koji također sadrži legendu koja objašnjava konvencije korištene u ovom i drugim ilustracijama YANG modela u ovom dokumentu.
Nastavljamo prema sljedećim koracima koji su detaljno opisani u nastavku:
- Na početku, Paragon Active Assurance račun "demo" nema testne agente u svom inventaru.
- Testni agent pod nazivom "vta1" kreiran je pomoću ncclient-a. Na ovom stage, još ne postoji pravi Test Agent (odnosno, još nije pokrenut).
- Testni agent je implementiran u OpenStack. (Primjena na toj platformi ovdje je odabrana kao jedna od mogućnosti.)
- Test Agent povezuje se s "demo" računom kontrolnog centra i sada je spreman za upotrebu.
Korak 1: Na početku nema testnih agenata u "demo" računu. Pogledajte donju sliku zaslona iz GUI-ja Control Center-a.
Korak 2: Testni agent se kreira u Control Center-u pomoću Python NETCONF klijenta “ncclient”. Ispod je ncclient kod za kreiranje testnog agenta koji ima jedno fizičko sučelje s DHCP adresom:
import argparse
iz upravitelja uvoza ncclient
parser = argparse.ArgumentParser(description='Test kreiranje test agenta')
parser.add_argument('–host', help='Naziv hosta na kojem je pronađen ConfD', required=True)
parser.add_argument('–port', help='Priključak za spajanje na ConfD', required=True)
parser.add_argument('–username', help='Korisničko ime za spajanje na ConfD', required=True)
parser.add_argument('–password', help='Lozinka za ConfD račun', required=True)
parser.add_argument('–netrounds-account', help='Skraćeni naziv NCC računa', obavezno=Istina)
parser.add_argument('–test-agent-name', help='Ime test agenta', required=True)
args = parser.parse_args()
s manager.connect(host=args.host, port=args.port, username=args.username,
lozinka=args.lozinka, hostkey_verify=False) kao m:
# Stvorite test agenta u kontrolnom centru
xml = “””
)ispis m.edit_config(target='running', config=xml)
BILJEŠKA: Kod koji prethodi s manager.connect(…) je izostavljen iz sljedećih example isječke koda.
NTP poslužitelj je konfiguriran na eth0, a eth0 je također sučelje za upravljanje (tj. sučelje koje se povezuje s Control Centerom).
Aplikacija test agenta trenutno ne dopušta konfiguriranje sučelja. Iz tog razloga, od verzije 2.34.0 nadalje, moguće je izostaviti konfiguraciju sučelja u YANG shemi. Odgovarajući XML je stoga radikalno pojednostavljen u ovom slučaju:
Nakon što je Test Agent kreiran, on postoji u konfiguracijskoj bazi podataka iu Kontrolnom centru. Pogledajte donju snimku zaslona inventara testnog agenta, koja prikazuje testnog agenta "vta1":
Korak 3: Sada je vrijeme za implementaciju testnog agenta "vta1" u OpenStack.
Agent za testiranje koristit će korisničke podatke pokretanja oblaka za dohvaćanje informacija o tome kako se spojiti na Control Center. Točnije, tekst korisničkih podataka file ima sljedeći sadržaj (imajte na umu da #cloud-config i netrounds_test_agent linije moraju biti prisutne, a da preostale linije moraju biti uvučene):
Za dodatne informacije pogledajte dokument Kako implementirati virtualne testne agente u OpenStack.
Nakon što je Test Agent implementiran i povezan s Control Centerom, konfiguracija će se prenijeti iz Control Centera u Test Agent.
Korak 4: Test Agent je sada online u Kontrolnom centru i dobio je svoju konfiguraciju. Test Agent je spreman za upotrebu u testovima i praćenju. Pogledajte ove odjeljke:
- “Pokretanje testa” na stranici 45
- “Pokretanje monitora” na stranici 60
Popis agenata za testiranje na vašem Paragon Active Assurance računu
Ispod je example ncclient Python kod za ispisivanje testnih agenata u Paragon Active Assurance računu:
Pokretanje ovog koda daje izlaz kao što je dolje:
Brisanje testnog agenta
Nakon dovršetka testa, u nekim slučajevima upotrebe moglo bi biti relevantno izbrisati agenta za testiranje.
Ispod je isječak koda koji pokazuje kako to učiniti s ncclientom:
NETCONF obavijesti
U nastavku predstavljamo jednostavan example skripta za slušanje svih dolaznih NETCONF obavijesti iz Kontrolnog centra. Ove se obavijesti šalju kad god se dogode određeni događaji, kao što je isključivanje testnog agenta ili dovršetak testa koji je pokrenuo korisnik. Na temelju informacija koje se nalaze u obavijestima, korisnici mogu dodijeliti automatske naknadne radnje u orkestratoru.
Kada se gornja skripta izvrši, NC klijent će prikazati primljenu obavijest u strukturiranom XML-u. Vidi bivšegample izlaz u nastavku, koji prikazuje testnog agenta koji se neočekivano isključuje.
2017-02-03T15:09:55.939156+00:00</eventTime>
<test-agent-status-change xmlns=’http://ncc.netrounds.com'>
demo
HW1
izvan mreže
Examples: Stavke inventara
Stvaranje (uvoz) i upravljanje stavkama inventara kao što je TWAMP reflektori i Y.1731 MEPs se radi na sličan način kao i za test agente. Ispod je XML i NETCONF kod za definiranje takvih entiteta u Paragon Active Assurance putem NETCONF & YANG API-ja i za dohvaćanje popisa definiranih stavki.
Stvaranje TW-aAMP Reflektor
Stvaranje Y.1731 MEP
Stvaranje IPTV kanala
Stvaranje Ping hosta
Stvaranje SIP računa
Dohvaćanje inventara
Ispod je Python kod za dohvaćanje svih stavki inventara definiranih na računu. (Ovdje se odjednom dohvaćaju sve vrste stavki inventara kako bi se izbjeglo ponavljanje u dokumentu. Naravno, bilo koji podskup stavki inventara može se dohvatiti izostavljanjem nekih redaka ispod računa.)
Pokretanje ovog koda daje izlaz kao što je dolje:
Examples: Alarmi
Predlošci alarma i pridružene stavke (SNMP upravitelji, popisi e-pošte alarma) stvaraju se i upravljaju njima na sličan način kao stavke inventara. Ovo poglavlje sadrži XML i NETCONF kod za definiranje takvih entiteta u Paragon Active Assurance putem NETCONF & YANG API-ja i za dohvaćanje popisa definiranih stavki.
Popisi e-pošte alarma
Stvaranje popisa e-pošte za alarme
Dohvaćanje svih popisa e-pošte za alarme
SNMP upravitelji
Stvaranje SNMP upravitelja
Dohvaćanje svih SNMP upravitelja
Predlošci alarma
Stvaranje predloška alarma
Dohvaćanje svih predložaka alarma
Exampdatoteke: SSH ključevi
SSH javne ključeve možete dodati testnom agentu putem NETCONF & YANG API-ja. Korištenjem odgovarajućeg privatnog ključa možete se zatim prijaviti na testnog agenta putem SSH-a.
Potpuni popis dostupnih operacija na SSH ključevima je sljedeći:
- Dodajte SSH ključ
- Izmijenite SSH ključ
- Provjerite SSH ključ
- Navedite SSH ključeve
- Izbrišite SSH ključ.
U nastavku su prikazani primjeri operacija dodavanja i brisanja.
Brisanje SSH ključa
Ako želite izbrisati SSH ključ, koristite sljedeću naredbu:
Examples: Ispitivanja
Ovdje se pretpostavlja da su testni agenti (onoliko koliko je potrebno za testove) kreirani prema odjeljku “Stvaranje i postavljanje novog testnog agenta” na stranici 17.
YANG model staza za testove
| Artikal | Putanja modela YANG: /računi/račun/testovi … |
| testovi | /. |
| test[id] | /test |
| id | /test/id |
| ime | /test/ime |
| status | /test/status |
| vrijeme početka | /test/vrijeme početka |
| posljednje vrijeme | /test/vrijeme završetka |
| izvješće-url | /test/izvješće-url |
| korake | /test/koraci |
| korak[id] | /test/koraci/korak |
| ime | /test/koraci/korak/ime |
| id | /test/koraci/korak/id |
| vrijeme početka | /test/koraci/korak/vrijeme početka |
| posljednje vrijeme | /test/koraci/korak/vrijeme završetka |
| status | /test/koraci/korak/status |
| statusna poruka | /test/steps/step/status-message |
| šablone | /predlošci |
| predložak[ime] | /predlošci/predložak |
| ime | /templates/template/ime |
| opis | /templates/template/description |
| parametri | /predlošci/predložak/parametri |
| parametar [ključ] | /predlošci/predložak/parametri/parametar |
| ključ | /predlošci/predložak/parametri/parametar/ključ |
| tip | /templates/template/parameters/parameter/type |
Preduvjeti za orkestraciju ispita
- Kako biste pokrenuli test putem NETCONF-a pomoću NC klijenta, potrebno je prvo izraditi testni predložak pomoću GUI-ja Control Center-a kao što je detaljno opisano u pomoći unutar aplikacije pod “Testovi i monitori” > “Stvaranje predložaka”. Sva polja navedena u tom predlošku kao "Unos predloška" bit će potrebna kao parametri u XML-u prilikom orkestriranja pokretanja testnog predloška.
- Izvođenje testova u Paragon Active Assuranceu smatra se "stanjem" u kontekstu orkestracije. Podaci o stanju su podaci koji se ne mogu pisati i koji se ne pohranjuju u konfiguracijsku bazu podataka, za razliku od konfiguracijskih podataka spomenutih u odjeljku "Prekoview orkestracije agenta za testiranje” na stranici 17. To u osnovi znači da promjene testova ili predložaka u GUI-u Kontrolnog centra neće uzrokovati probleme povezane sa sinkronizacijom između Kontrolnog centra i konfiguracijske baze podataka.
- Za dobivanje izvješća-URL točno u izvješćima o ispitivanju, morate provjeriti kontrolni centar URL je ispravno konfiguriran. To se radi u file /opt/netrounds-confd/settings.py. Prema zadanim postavkama naziv glavnog računala Control Centera dohvaća se pomoću socket.gethostname(): pogledajte dolje. Ako ovo ne da točan rezultat, trebate postaviti naziv glavnog računala (ili cijeli URL) ručno u ovom file.
# URL kontrolnog centra bez kose crte na kraju.
# Ovo je nprampdatoteka koja se koristi u izvješću o ispitivanju-url.
HOSTNAME = socket.gethostname()
NETROUNDS_URL = 'https://%s' % HOSTNAME
Pokretanje testa
Kao što je opisano u odjeljku “Stvaranje i postavljanje novog testnog agenta” na stranici 17, pokrenite naredbu pang -f tree netrounds-ncc.yang
iz direktorija /opt/netrounds-confd/ kako bi se ispisao YANG model. U ovom modelu, RPC za pokretanje testa pomoću NC klijenta izgleda ovako:
Za objašnjenja pogledajte odjeljak “Legenda” na stranici 81 u Dodatku.
Sljedeći koraci prikazani su u nastavku:
- Test agenti su registrirani na račun Paragon Active Assurance, ali nijedan test još nije pokrenut.
- Potrebni ulazni parametri navedeni su u testnom predlošku koji će se pokrenuti.
- HTTP test od 60 sekundi pokreće se pomoću ncclient-a.
Korak 1: Na početku nisu pokrenuti nikakvi testovi na Paragon Active Assurance računu. Pogledajte donju sliku zaslona iz GUI-ja Control Center-a.
Korak 2: Predložak koji ćemo koristiti za pokretanje testa u ovom primjeruample je HTTP predložak za testiranje. Ima dva obavezna polja za unos ( Klijenti i URL) koje smo naveli kao takve prilikom izrade predloška u GUI-u Control Center-a.
Definirat ćemo ove parametre (između ostalih) u XML konfiguraciji koju je u bazu podataka konfiguracije priopćio naš NETCONF upravitelj (ncclient).
Korak 3: HTTP test se pokreće pomoću ncclient-a.
Ispod je exampdatotečni kod gdje su navedene potrebne informacije o konfiguraciji i parametri za predložak HTTP testa. Ovisno o tome kako je predložak izgrađen, detalji ovdje mogu varirati.
Za svaki parametar, potrebno je navesti atribut. Ključ je identičan parametru
Naziv varijable u Kontrolnom centru. Imena varijabli možete provjeriti na sljedeći način:
- Pritisnite Testovi na bočnoj traci i odaberite Novi niz testova.
- Pritisnite Moji predlošci.
- Kliknite vezu Uredi ispod predloška koji vas zanima.
- Kliknite gumb Uredi unos u gornjem desnom kutu.
U našem bivšemample, a prema zadanim postavkama nazivi varijabli jednostavno su verzije malih slova prikazanih imena u Kontrolnom centru (“url” protiv ”URL”, itd.). Međutim, u GUI-u Control Center-a možete preimenovati varijable kako god želite.
Osim ključa, svaki parametar mora imati specificiran tip: nprample, za URL.
Imajte na umu da morate ponovnoview kompletan YANG model kako bi se dobile potpune informacije o tipovima. Za sučelja agenta za testiranje tip ima složeniju strukturu, kao što je prikazano ispod u donjem kodu.
Sada možemo pokrenuti skriptu koristeći ncclient. Pod pretpostavkom da je sve ispravno, test će se pokrenuti, a njegovo izvršenje prikazano u Kontrolnom centru:
Ako je test uspješno pokrenut, Control Center će odgovoriti s ID-om testa. U ovom prample, ID testa je 3:
ID testa također se može pronaći u URL za test u Control Center GUI. U ovom prample, to URL je https://host/demo/testing/3/.
Dohvaćanje rezultata testa
Najjednostavniji način dohvaćanja rezultata testa je ukazivanje na ID testa.
Ispod je Python kod za dobivanje rezultata iz gornjeg HTTP testa s ID = 3:
s upraviteljem. Connect(host=args.host, port=args.port, username=args.username,password=args.password, hostkey_verify=False) kao m:
Ispis će izgledati otprilike ovako:
Izvoz i uvoz testnih predložaka
Testni predlošci mogu se izvesti u JSON formatu i ponovno uvesti u tom formatu u Control Center. Ovo je korisno ako želite koristiti testne predloške u drugoj instalaciji Kontrolnog centra. (Početnom izradom predložaka najbolje se upravlja kroz GUI Control Center.)
Ispod je kôd za izvođenje izvoza i uvoza.
Izvoz testnih predložaka
# Dobijte json konfiguraciju iz odgovora
root = ET.fromstring(response._raw)
json_config = korijen[0].tekst
ispis json_config
Predložak se nalazi u objektu json_config.
Uvoz testnih predložaka
JSON konfiguracijski objekt koji sadrži testne predloške može se ponovno uvesti u Control Center na sljedeći način.
Examples: Monitori
Ovaj odjeljak pretpostavlja da su testni agenti (onoliko koliko ih zahtijevaju monitori) kreirani prema odjeljku “Stvaranje i postavljanje novog testnog agenta” na stranici 17.
YANG model staza za monitore
| Artikal | Put YANG modela: /accounts/account/monitors … |
| monitori | /. |
| monitor [ime] | /monitor |
| ime | /monitor/ime |
| opis | /monitor/opis |
| započeo | /monitor/počeo |
| predložak | /monitor/predložak |
| alarm-configs | /monitor/alarm-configs |
| Artikal | Putanja YANG modela: /accounts/account/monitors/monitor/alarm-configs … |
| alarm-config[identifikator] | /alarm-config |
| identifikator | /alarm-config/identifier |
| predložak | /alarm-config/template |
| elektronička pošta | /alarm-config/e-pošta |
| snmp | /alarm-config/snmp |
| thr-es-kritičan | /alarm-config/thr-es-critical |
| thr-es-critical-clear | /alarm-config/thr-es-critical-clear |
| tr-es-dur | /alarm-config/thr-es-major |
| thr-es-dur-clear | /alarm-config/thr-es-major-clear |
| thr-es-mol | /alarm-config/thr-es-minor |
| thr-es-mol-jasno | /alarm-config/thr-es-minor-clear |
| thr-es-upozorenje | /alarm-config/thr-es-warning |
| thr-es-warning-clear | /alarm-config/thr-es-warning-clear |
| ozbiljnost bez podataka | /alarm-config/no-data-severity |
| vrijeme čekanja bez podataka | /alarm-config/no-data-timeout |
| akcijski | /alarm-config/akcija |
| veličina prozora | /alarm-config/window-size |
| interval | /alarm-config/interval |
| poslati-samo-jednom | /alarm-config/send-only-once |
| snmp-trap-per-stream | /alarm-config/snmp-trap-per-stream |
| Artikal | Put YANG modela: /accounts/account/monitors … |
| parametri | /monitor/parametri |
| Artikal | Putanja YANG modela: /accounts/account/monitors/monitor/parameters … |
| parametar [ključ] | /parametar |
| ključ | /parametar/ključ |
| (vrsta vrijednosti) | /parametar |
| :(cijeli broj) | /parametar |
| cijeli broj | /parametar/cijeli broj |
| :(plutati) | /parametar |
| lebdjeti | /parametar/float |
| :(niz) | /parametar |
| Artikal | Putanja YANG modela: /accounts/account/monitors/monitor/parameters … |
| niz | /parametar/niz |
| :(test-agent-sučelja) | /parametar |
| test-agent-sučelja | /parameter/test-agent-interfaces |
| test-agent-interface[“1” na stranici 58 | /parameter/test-agent-interfaces/ |
| račun | /parameter/test-agent-interfaces/test-agent-interface/account |
| test-agent | /parameter/test-agent-interfaces/test-agent-interface/test-agent |
| sučelje | /parameter/test-agent-interfaces/test-agent-interface/interface |
| ip-verzija | /parameter/test-agent-interfaces/test-agent-interface/ip-verzija |
| :(twamp- reflektori) | /parametar |
| twamp- reflektori | /parametar/twamp- reflektori |
| twamp-reflektor[ime] | /parametar/twamp-reflektori/twamp-reflektor |
| ime | /parametar/twamp-reflektori/twamp-reflektor/naziv |
| :(y1731-meps) | /parametar |
| y1731-meps | /parametar/y1731-meps |
| y1731-mep[ime] | /parametar/y1731-meps/y1731-mep |
| ime | /parametar/y1731-meps/y1731-mep/naziv |
| :(sip-računi) | /parametar |
| sip-računi | /parametar/sip-računi |
| sip-račun[“2” na stranici 58] | /parameter/sip-accounts/sip-account |
| račun | /parameter/sip-accounts/sip-account/account |
| test-agent | /parameter/sip-accounts/sip-account/test-agent |
| sučelje | /parameter/sip-accounts/sip-account/interface |
| sip-adresa | /parameter/sip-accounts/sip-account/sip-address |
| :(iptv-kanali) | /parametar |
| iptv-kanala | /parametar/iptv-kanali |
| iptv-kanal[ime] | /parametar/iptv-kanali/iptv-kanal |
| ime | /parameter/iptv-channels/iptv-channel/name |
- sučelje agenta za testiranje računa
- račun test-agent sučelje sip-adresa
| Artikal | Put YANG modela: /accounts/account/monitors … |
| status | /monitor/status |
| zadnjih 15 minuta | /monitor/status/posljednjih-15 minuta |
| status | /monitor/status/last-15-minutes/status |
| status-vrijednost | /monitor/status/last-15-minutes/status-value |
| posljednji sat | /monitor/status/posljednji sat |
| status | /monitor/status/posljednji sat/status |
| status-vrijednost | /monitor/status/posljednji sat/vrijednost-statusa |
| posljednja 24 sata | /monitor/status/posljednja-24-sata |
| status | /monitor/status/posljednja-24-sata/status |
| status-vrijednost | /monitor/status/posljednja-24-sata/vrijednost-statusa |
| šablone | /predlošci |
| predložak[ime] | /predlošci/predložak |
| ime | /templates/template/ime |
| opis | /templates/template/description |
| parametri | /predlošci/predložak/parametri |
| parametar [ključ] | /predlošci/predložak/parametri/parametar |
| ključ | /predlošci/predložak/parametri/parametar/ključ |
| tip | /templates/template/parameters/parameter/type |
Preduvjeti za orkestraciju monitora
Prije nego što možete pokrenuti monitor kroz NETCONF koristeći ncclient, trebate izgraditi predložak monitora u GUI Control Center-a kao što je objašnjeno u pomoći unutar aplikacije pod “Testovi i monitori” > “Stvaranje predložaka”. Sva polja navedena kao "Unos predloška" u tom predlošku bit će potrebna kao parametri u XML-u prilikom orkestriranja pokretanja predloška.
Dohvaćanje ulaznih parametara iz predložaka monitora
U nastavku su prikazana dva predloška. Prvi je za nadgledanje UDP-a između dva sučelja testnog agenta, a drugi je za HTTP korištenjem jednog sučelja testnog agenta.
Kako biste saznali ulazne parametre predloška, kliknite okvir koji predstavlja predložak. Za HTTP predložak, parametri mogu izgledati ovako:
Te parametre trebamo definirati u sljedećem koraku prilikom pokretanja monitora.
Pokretanje monitora
Upotrebom testnih agenata koje smo definirali i postavili u odjeljku “Stvaranje i implementacija novog testnog agenta” na stranici 17, možemo pokrenuti monitor iz predloška “HTTP” kao što je prikazano u nastavku.
Za svaki parametar, potrebno je navesti atribut. Ključ je identičan nazivu varijable parametra u Kontrolnom centru. Imena varijabli možete provjeriti na sljedeći način:
- Kliknite Praćenje na bočnoj traci i odaberite Novi monitor.
- Pritisnite Moji predlošci.
- Kliknite vezu Uredi ispod predloška koji vas zanima.
- Kliknite gumb Uredi unos u gornjem desnom kutu.
U našem bivšemample, a prema zadanim postavkama nazivi varijabli jednostavno su verzije malih slova prikazanih imena u Kontrolnom centru (“url” protiv ”URL”, itd.). Međutim, u GUI-u Control Center-a možete preimenovati varijable kako god želite.
Osim ključa, svaki parametar mora imati specificiran tip: nprample, za URL. Imajte na umu da se potpune informacije o vrsti parametra nalaze u YANG modelu. Za sučelja agenta za testiranje tip ima složeniju strukturu, kao što je vidljivo u donjem kodu.
U exampU nastavku, nijedan alarm nije povezan s monitorom. Na primjerampdatoteke koje uključuju alarme, idite na odjeljak “Pokretanje monitora s alarmom” na stranici 62.
Pokretanje monitora s alarmom
Za pridruživanje alarma monitoru, možete usmjeriti na predložak alarma koji je definiran ili možete unijeti cijelu konfiguraciju alarma prilikom kreiranja monitora. Dat ćemo jednu eksample svakog pristupa u nastavku.
Postavljanje alarma monitora usmjeravanjem na predložak alarma
Kako biste mogli koristiti predložak alarma, morate znati njegov ID. U tu svrhu prvo dohvatite sve svoje predloške alarma kao što je opisano u odjeljku “Dohvaćanje svih predložaka alarma” na stranici 39 i zabilježite naziv relevantnog predloška. Zatim se možete pozvati na taj predložak na sljedeći način:
Postavljanje alarma monitora izravnim konfiguriranjemy
Alternativno, možete postaviti alarm za monitor tako da navedete njegovu cjelokupnu konfiguraciju prilikom izrade monitora, bez pozivanja na predložak alarma. To se radi kako je prikazano u sljedećem primjeruample.
Dohvaćanje pokrenutih monitora
Za dohvaćanje svih monitora koji se trenutno izvode, pokrenite ovu skriptu:
s upraviteljem. connect(host=args.host, port=args.port, username=args. user name, password=args.password, hostkey_verify=False) kao m:
Izlaz je popis svih pokrenutih monitora kao što je prikazano u nastavku:
Dohvaćanje SLA statusa za monitor
Evo kako dohvatiti status SLA za monitor. U ovom prample, dohvaćamo status SLA za monitor “Kvaliteta mreže” za tri vremenska intervala: zadnjih 15 minuta, zadnji sat i zadnja 24 sata.
Ispis će izgledati otprilike ovako:
NETCONF obavijesti
NETCONF obavijesti za monitore pokreću kršenja SLA. To se događa kada SLA za monitor padne ispod SLA praga ("Dobar" ili "Prihvatljiv") unutar određenog vremenskog okvira, prema zadanim postavkama zadnjih 15 minuta. Treba napomenuti da se obavijesti o kršenju SLA-a brzo pojavljuju nakon što je usluga zahvaćena problemom, dok će se status SLA-a vratiti na "Dobro" tek nakon 15 minuta i samo ako se više ne krše.
Vremenski prozor se može promijeniti uređivanjem postavke SLA_STATUS_WINDOW (vrijednost u sekundama) u /etc/netrounds/netrounds.conf.
Izvoz i uvoz predložaka monitora
To se radi na potpuno isti način kao i za testne predloške; usporedite odjeljak “Izvoz i uvoz testnih predložaka” na stranici 52. Isječci koda u nastavku ilustriraju kako izvoziti i uvoziti predloške za monitore.
Izvoz predložaka monitora
Uvoz predložaka monitora
Tags definirano u Paragon Active Assuranceu može se primijeniti na:
- monitori
- predlošci monitora
- Testni agenti
- TWAMP reflektori
- Ping hostovi.
Na primjerample, možeš tag monitor s istim tag kao podskup testnih agenata koji će pokrenuti monitor. Ova je značajka osobito korisna ako imate velik broj definiranih monitora i predložaka.
Ako ste postavili alarm sa SNMP zamkama za monitor, tada će se SNMP zamkama dodijeliti isto tags kao monitor, ako postoji.
Stvaranje Tags
U nastavku ćemo pokazati kako stvoriti a tag s imenom i bojom definiranom u XML-utag> podkonstrukcija.
Dodjeljivanje a Tag
Dodijeliti a tag resursu, dodajete ga kao novogtag> element ispodtags> element za taj resurs.
Evo kako dodijeliti a tag testnom agentu:
Dodijeliti a tag na TWAMP reflektor, učinite sljedeće:
Dodjeljivanje a tag na monitor se postupa na sličan način:
Alternativno, možete dodijeliti postojeći tag bilo kojoj od ovih vrsta resursa prilikom stvaranja resursa, uključivanjemtags> element koji sadrži tag u pitanju.
Ažuriranje a Tag
Ažuriranje postojećeg tag s novim atributima analogno je stvaranju a tag:
Poništavanje dodjele a Tag
Za poništavanje dodjele a tag iz resursa dodajte atribut nc:operation=”delete” utag> element koji pripada resursu. U nastavku poništavamo dodjelu a tag s monitora.
Brisanje a Tag
Kako biste izbrisali a tag ukupno iz Kontrolnog centra, ponovno se koristi atribut nc:operation=”delete”, ali ovaj put primijenjen na tag sama, definirana pod .
Rješavanje problema
Problem: Orchestrator i Paragon Active Assurance nisu usklađeni
Orkestrator i Paragon Active Assurance mogu biti neusklađeni, nprample ako su promjene konfiguracije napravljene u GUI-u Kontrolnog centra ili ako primjena konfiguracije nije bila uspješna i vraćanje na prethodno stanje nije uspjelo.
U slučaju neuspjelog vraćanja, NETCONF poslužitelj više neće prihvaćati promjene konfiguracije; odgovorit će porukom o pogrešci koja navodi da je konfiguracija zaključana dok se ponovno ne sinkronizira. Da biste se vratili u sinkronizaciju i otključali promjene konfiguracije, morate pokrenuti naredbu rpc sync-from-ncc koja sinkronizira svu konfiguraciju iz Kontrolnog centra u konfiguracijsku bazu podataka.
BILJEŠKA: The confd@netrounds.com korisnik (ili što god je konfigurirano) mora imati privilegije superkorisnika da bi se sve uspješno sinkroniziralo. To se može postići naredbom ncc user-update confd@netrounds.com –is-superuser Ako korisnik nije superkorisnik, pojavit će se upozorenje da se ne može sve sinkronizirati, ali da je sve što se moglo sinkronizirati.
BILJEŠKA: Ako vaš orkestrator također pohranjuje konfiguraciju, morat ćete ponovno sinkronizirati i to budući da tražena konfiguracija (konfiguracija koju orkestrator očekuje da ima Kontrolni centar) neće biti primijenjena.
Problem: početna sinkronizacija (sync-from-ncc) nije uspjela zbog nepodržanih resursa
Ako pokušate pokrenuti rpc sync-from-ncc na računu čija je konfiguracija stvorena u GUI-u kontrolnog centra, mogli biste naići na probleme ako račun sadrži nepodržane resurse. Preporuča se da počnete s praznim računom i izvršite njegovu konfiguraciju kroz NETCONF. U suprotnom, ako naiđete na probleme sa sukobima resursa, morat ćete ukloniti sukobljene resurse s računa.
Problem: NETCONF naredbe ne uspijevaju s ncclient.operations.rpc.RPCError: greška komunikacije aplikacije
Poslužitelj NETCONF ne vraća vezu s poslužiteljem Control Center-a automatski ako se Control Center ponovno pokrene. Za vraćanje veze s Control Centerom ponovno pokrenite NETCONF proces: sudo systemctl restart netrounds-confd
Napomene o aplikacijama testnog agenta i uređajima testnog agenta
Aplikacije testnog agenta u ConfD-u
Među testnim agentima, (novija) aplikacija testnog agenta radi malo drugačije od (starijeg) testnog agentskog uređaja.
Aplikacije agenta za testiranje trenutno ne podržavaju konfiguraciju sučelja. Stoga YANG shema dopušta određivanje prazne konfiguracije sučelja za takve test agente. Vidi “ovaj odlomak” na stranici 23 za primjerample.
Kada sinkronizirate ConfD bazu podataka s Kontrolnim centrom pomoću naredbe sync-from-ncc, želite da konfiguracija sučelja ostane prazna i da se ne prebriše onim što se nalazi u Kontrolnom centru. Stoga trebate koristiti posebnu oznaku –without_interface_config s tom naredbom kada radite s aplikacijama testnog agenta.
Prazna konfiguracija sučelja za Test Agent Appliance
Kao što je gore navedeno, Test Agent Application ne podržava konfiguraciju sučelja, te je stoga moguće izostaviti sučelja u YANG shemi.
Ali postoje i slučajevi upotrebe u kojima biste mogli izostaviti konfiguraciju sučelja iz uređaja testnog agenta. bivšiampOvo bi mogao biti scenarij orkestracije u kojem vrtite testnog agenta pomoću cloud-init-a i želite da se koristi konfiguracija sučelja iz njega, umjesto da dopustite ConfD-u da ga prebriše kada testni agent dođe na mrežu.
Promjene YANG sheme u vezi s nedefiniranim sučeljima
Budući da je prazna konfiguracija sučelja sada dopuštena (od verzije 2.34.0 nadalje), moguće je navesti bilo koji naziv sučelja kao ulaz za zadatak koji se izvodi kao dio testa ili nadzora.
Ovo je potrebno kako biste mogli koristiti aplikaciju testnog agenta, budući da za njih u ConfD-u nisu definirana imena sučelja. Međutim, imajte na umu da to također znači da možete naići na probleme ako slučajno konfigurirate test ili monitor za korištenje nepostojećeg sučelja. Zato vas molim da ovo imate na umu.
Ograničenja pri registraciji testnog agenta kreiranog u ConfD-u
Prilikom kreiranja testnog agenta putem REST ili NETCONF/YANG API-ja, ne možemo unaprijed znati koja je to vrsta: Test Agent Appliance ili Test Agent Application. Ovo postaje jasno tek nakon što se Test Agent registrira.
Nakon što je Test Agent registriran i pretvorio se u jednu od ovih konkretnih vrsta, nije vam dopušteno ponovno ga registrirati kao drugu vrstu Test Agenta. To znači da vam nije dopušteno da ga prvo registrirate kao Test Agent Appliance, zatim ga ponovno registrirate kao Test Agent Application ili obrnuto. Ako vam je potreban testni agent druge vrste, morat ćete izraditi novi testni agent.
Dodatak: Struktura stabla potpunog YANG modela
U ovom dodatku, odjeljak “Legenda” na stranici 81 objašnjava sintaksu YANG strukture stabla modela generirane naredbom pyang -f stablo.
Odjeljak “YANG model stabla strukture” na stranici 82 daje izlaz iz te naredbe primijenjene na netrounds-ncc.yang. Dijelovi ovog rezultata reproducirani su na drugim mjestima u dokumentu.
Legenda
YANG model strukture stabla
Juniper Networks, logotip Juniper Networks, Juniper i Junos registrirani su zaštitni znakovi Juniper Networks, Inc. u Sjedinjenim Državama i drugim zemljama. Svi ostali zaštitni znakovi, uslužni znakovi, registrirani ili registrirani uslužni znakovi vlasništvo su svojih vlasnika. Juniper Networks ne preuzima odgovornost za bilo kakve netočnosti u ovom dokumentu. Juniper Networks zadržava pravo izmjene, modificiranja, prijenosa ili druge revizije ove publikacije bez prethodne obavijesti. Autorska prava © 2023 Juniper Networks, Inc. Sva prava pridržana.
Dokumenti / Resursi
 |
Juniper NETWORKS NETCONF & YANG API softver [pdf] Korisnički priručnik NETCONF YANG API softver, YANG API softver, API softver, softver |