JUNIPER NETWORKS Logo 1NETCONF & YANG API orkestracija
VodičJuniper NETWORKS NETCONF & YANG API softverObjavljeno
2023-07-07
IZJAVA 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čni exampsu dati glavni zadaci koji su uključeni, uključujući: kreiranje i implementaciju virtuelnih test agenata, pokretanje testova i monitora, i dohvaćanje rezultata iz ovih aktivnosti.
U ovom dokumentu, besplatno dostupan Python NETCONF klijent ncclient se koristi u ulozi orkestratora.

konvencije
U ovom dokumentu se koriste sljedeće skraćenice:

Skraćenica Značenje
CLI Interfejs komandne linije
EM Element Manager
ES Greška Second
MEP MEG (Grupa entiteta održavanja) Krajnja tačka (ITU-T Y.1731 definicija) ili Krajnja tačka održavanja (Cisco definicija)
NFV Virtualizacija mrežnih funkcija
NFVO Mrežna funkcija Virtualization Orchestrator
NSD Deskriptor mrežne usluge
RPC Poziv na daljinu
SIP Protokol pokretanja sesije
SLA Ugovor o nivou usluge
S-VNFM Specijalni VNF menadžer
VNF Funkcija virtuelne mreže
vTA Virtualni test agent

Napomene o kompatibilnosti unatrag

U verzijama 2.35.4/2.36.0 NETCONF & YANG API-ja, provjera valjanosti određenih zahtjeva je pooštrena kako bi se pridržavali NETCONF standarda. To znači da klijentski kod zasnovan na starijim verzijama ovog vodiča sada može biti odbijen.
Za nprample, u prethodnom Python example kod, nije naveden atribut imenskog prostora. Imenski prostor sada mora biti isporučen u XML-u zahtjeva kad god želite izmijeniti ConfD resurs.

Preduvjeti i pripreme

ConfD Installation
ConfD (proizvod iz Tail-f-a) se koristi kao posrednik između Paragon Active Assurance sistema i NETCONF-a. ConfD povezuje Paragon Active Assurance konfiguraciju i operativne podatke sa NETCONF & YANG API-jem.
ConfD je trebao biti instaliran zajedno sa softverom Kontrolnog centra, kao što je opisano u Vodiču za instalaciju.

Provjera da je ConfD pokrenut
Da biste potvrdili da je ConfD pokrenut i radi, pokrenite naredbu
ssh -s @localhost -p 830 netconf
da provjerite da ConfD odgovara na portu 830. U naredbi, je kako je definirao kreirani korisnik netconf
naredbu u Vodiču za instalaciju, odjeljak Instaliranje ConfD. Dajte lozinku definiranu istom naredbom.
U izlazu provjerite da li je modul Kontrolnog centra uključen. Izlaz bi trebao sadržavati liniju poput sljedećeg:
http://ncc.netrounds.com?module=netrounds-ncc&revision=2017-06-15

Sinkroniziranje baze podataka konfiguracije sa Kontrolnim centrom

Konačno, 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 bi se također mogao izvršiti u drugom programskom jeziku sve dok se koristi NETCONF/YANG protokol.
Uloga ncclient-a je da djeluje kao klijent prema ConfD serveru koji hostuje NETCONF/YANG API.

Juniper NETWORKS NETCONF & YANG API softver -Control Center

Vrijedi naglasiti da ncclient nije ni na koji način povezan sa Kontrolnim centrom (ranije “Netrounds Control Center”), iako ime slučajno počinje sa “ncc”.
Evo kako instalirati ncclient:

Sada možemo izvršiti sinhronizaciju na sljedeći način. Obratite pažnju da ovo treba da se uradi na posebnom računaru, a ne na samom serveru Kontrolnog centra:

#
# BILJEŠKA:
# Ova skripta djeluje kao klijent prema ConfD-u koji se izvodi na NCC serveru.
# Koristit će NETCONF/YANG API za komunikaciju.

Juniper NETWORKS NETCONF & YANG API softver - Kontrolni centar 1

NAPOMENA: Ova procedura je također potrebna kad god su Test Agenti instalirani i registrirani neovisno o NETCONF-u. Pogledajte napomenu u odeljku „Prekoview orkestracije testnog agenta” na stranici 17 za više informacija.

Podešavanje više Paragon Active Assurance naloga koje kontrolira NETCONF

Koraci u nastavku su potrebni samo ako želite podesiti dodatne Paragon Active Assurance račune koje će kontrolirati NETCONF, pored računa konfiguriranog 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 nalog i idite na Račun > Dozvole.Juniper NETWORKS NETCONF & YANG API softver - račun
  • Dodajte korisnika “confd@netrounds.com“, i odobrite ovom korisniku ConfD administratorsku dozvolu u GUI klikom na dugme Pozovi.Juniper NETWORKS NETCONF & YANG API softver - račun 1
  • Sinhronizirajte konfiguracijsku bazu podataka s Kontrolnim centrom kao što je opisano u odjeljku “Sinhroniziranje baze podataka konfiguracije s Kontrolnim centrom” na stranici 4.
    Sada biste trebali moći kontrolirati više Paragon Active Assurance naloga s istim ConfD korisnikom.

NAPOMENA: Kada počnete kontrolirati Paragon Active Assurance račun putem ConfD-a, NE smijete vršiti promjene na ovom računu putem web GUI u odnosu na sve Paragon Active Assurance funkcije koje su „konfiguracije“ (pogledajte poglavlje „Podržane funkcije u Paragon Active Assuranceu“ na stranici 9). Ako to učinite, doći će do gubitka sinhronizacije.

Uvod u NETCONF Orchestration API

Gotovoview

NFVO ili orkestrator usluga treće strane je obično komponenta koja inicira sesije testiranja i nadgledanja pomoću API-ja Kontrolnog centra. Ovaj orkestrator također dohvaća agregirane rezultate mjerenja iz aktivnosti Test Agenta. KPI performansi mogu se preuzeti pomoću sistema upravljanja performansama treće strane, dok se događaji – jednom pokrenuti kršenjem praga postavljenim u Kontrolnom centru – mogu poslati u sisteme upravljanja greškama treće strane.
Da rezimiramo, slika ispod pokazuje kako Paragon Active Assurance komunicira sa drugim sistemima trećih strana u okruženju OSS-a.

Juniper NETWORKS NETCONF & YANG API softver -Gotovoview

  • NFVO/Service Orchestrator: Naređuje VNF Manageru da implementira vTA-ove i konfiguriše Paragon Active Assurance u lancu usluga. Jednom kada je usluga aktivirana, orkestrator koristi API prema Kontrolnom centru da pokrene testove aktivacije usluge i dohvati rezultate koji prolaze/nije prolaze. Ako su testovi položeni, orkestrator će koristiti API prema Kontrolnom centru da započne aktivno praćenje usluge. KPI-je iz praćenja kontinuirano preuzima orkestrator ili posebna platforma za upravljanje učinkom.
  • Kontrolni centar: Raspoređuje, skalira i ukida vTA prema uputama NFVO ili servisnog orkestratora.
  • Sistem upravljanja učinkom ili sistem upravljanja kvalitetom usluge: Čita KPI-je iz aktivnog nadzora preko API-ja Kontrolnog centra.
  • Sistem upravljanja greškama: Prima NETCONF, SNMP ili e-mail obavijesti od Kontrolnog centra ako su SLA prekršeni.

Definicije koncepata u Paragon Active Assurance

  • Test agenti: Komponente koje vrše mjerenja (za testove kao i za monitore) u sistemu Paragon Active Assurance. Test Agenti se sastoje od softvera sa mogućnošću generiranja, primanja i analize stvarnog mrežnog prometa.
  • Vrsta Test Agenta o kojoj se govori u ovom dokumentu je Virtualni Test Agent (vTA), virtualna mrežna funkcija (VNF) postavljena na hipervizor. Postoje i druge vrste Test Agenta.
  • Postoje dva osnovna tipa mjerenja u Paragon Active Assurance-u, testovi i monitori.
  • Test: Test se sastoji od jednog ili više koraka, od kojih svaki ima određeno, konačno trajanje. Koraci se izvršavaju uzastopno. Svaki korak može povlačiti izvođenje više zadataka istovremeno.
  • Monitor: Monitor nema određeno trajanje, ali se izvršava neograničeno. Kao korak u testu, monitor može izvršiti više istovremenih zadataka.
  • Predložak: Kada Paragon Active Assurance kontroliše orkestrator, testovi i monitori se uvijek izvode pomoću šablona u kojima je definiran test ili monitor. Postavke parametara se mogu proslijediti kao inputi u predložak u vrijeme izvođenja.

Tok rada za automatizaciju
Vrijeme dizajna

U vrijeme dizajna, pripremate mjerenja kreiranjem predložaka za testove i monitore u Paragon Active Assuranceu. Kako to učiniti opisano je u poglavlju “Testiranje i predlošci za praćenje” na stranici 15.

Runtime
Za vrijeme rada postavljate svoje uređaje i izvodite stvarna mjerenja.

  • Gotovoview od svih exampdata je u poglavlju „Prampleće kontrole Paragon Active Assurance putem NETCONF & YANG API-ja” na stranici 15.
  • Kako implementirati i konfigurirati agente za testiranje opisano je u poglavlju “Pramples: Test Agenti” na stranici 16.
  • Kako uvesti stavke inventara kao što je TWAMP reflektore i IPTV kanale obrađeno je u poglavlju „Pramples: Inventarne stavke” na stranici 29.
  • Kako konfigurirati alarme objašnjeno je u poglavlju “Pramples: Alarmi” na stranici 35.
  • Kako pokrenuti testove i monitore izvršavanjem Paragon Active Assurance predložaka kroz NETCONF opisano je u poglavljima “Pr.amples: Testovi” na strani 43 i “Pramples: Monitori” na stranici 54.

Podržane funkcije u programu Paragon Active Assurance

Svi tipovi testova i monitora u Paragon Active Assuranceu mogu se kreirati i izvršiti korištenjem predložaka. Kako to učiniti opisano je u pomoći unutar aplikacije pod “Testovi i monitori” > “Kreiranje predložaka”.

Kreiranje Paragon Active Assurance naloga trenutno nije podržano; međutim, jedan ili više unaprijed definiranih naloga će biti postavljeno za korisnika.
Tabele u nastavku detaljno prikazuju koje su funkcije Paragon Active Assurance dostupne u ovom izdanju i kako su ove funkcije predstavljene u YANG-u.

Objašnjenje YANG konstrukcija

Radi praktičnosti, ovdje su date definicije YANG konstrukcija koje se pominju u tabeli karakteristika.

  • Config (config=true): Podaci o konfiguraciji, potrebni za transformaciju sistema iz jednog stanja u drugo.
  • Stanje (config=false): Podaci o stanju: dodatni podaci o sistemu koji nisu konfiguracijski podaci, kao što su informacije o statusu samo za čitanje i prikupljena statistika.
  • RPC: Poziv udaljene procedure, kako se koristi unutar NETCONF protokola.
  • Obavijest: Obavijesti o događajima poslane sa NETCONF servera NETCONF klijentu.

Tabele Paragon Active Assurance funkcija koje su dostupne za orkestraciju
Resurs: Monitoring
YANG put:/accounts/account/monitors

Feature Subfeature YANG konstrukcija
Kreirajte/izmijenite/brišite monitor Na osnovu predloška monitora Config
Start/stop monitor Config
Monitor templates Navedite postojeće šablone monitora sa ulazima Država
NETCONF obavještenja Stanje alarma je promijenjeno Obavijest
Pratite rezultate SLA/ES brojač za najviši nivo (%)
SLA/ES brojač za nivo zadatka (%)
Država

Za razliku od testova (uporedite Resurs: Testovi ispod), monitori se ne pokreću pomoću RPC-a, već urezivanje konfiguracije monitora.
Resurs: Testovi
YANG putanja: /accounts/account/tests

Feature Subfeature YANG konstrukcija
Pokreni test Na osnovu test šablona RPC
Upravljajte testovima Navedite testove sa statusom Država
Test šabloni Navedite postojeće testne šablone sa ulazima Država
NETCONF obavještenja Status testa je promijenjen Obavijest
Rezultati testa Dobijte status testnog koraka (prošao, nije uspio, greška,…) Država

Resurs: Test Agenti
YANG staze:

  • /accounts/account/test-agents (Config)
  • /accounts/account/registered-test-agents (Država)

Test agenti pod /accounts/account/test-agents su oni koji su konfigurisani na nalogu. Orkestrator može konfigurirati i koristiti samo ove Test Agente u testovima i monitorima putem NETCONF-a.
Nakon što ste konfigurisali Test Agenta i on se registrovao na nalog, Test Agent će se pojaviti pod /accounts/account/registered-test-agents. Sve registrovane agente za testiranje možete pronaći pomoću komande “get” u NETCONF-u (uporedite poglavlje pr.amples: Test Agenti).
Pod /accounts/account/registered-test-agents možete pronaći i agente za testiranje koji još nisu konfigurisani. Svi takvi Test Agenti moraju biti konfigurirani prije nego što se mogu koristiti.
U scenariju orkestracije, općenito se preporučuje da izvršite svu konfiguraciju vašeg Paragon Active Assurance naloga putem NETCONF-a. Ovo osigurava da se agenti za testiranje i registrirani agenti za testiranje ne razlikuju.

Feature Subfeature YANG konstrukcija
Prethodno kreirajte Test Agent na serveru Config
Konfigurirajte offline Test Agent (Kontrolni centar gura konfiguraciju Test Agentu
kada dođe na internet)
Config
Koristite postojeće/spoljno konfigurisane agente za testiranje Koristi se u testu/monitoru Config
Konfigurišite interfejse Config
Dobiti status Država
Konfiguriraj agenta za testiranje (samo testni uređaj) Konfigurišite NTP Config
Konfigurišite mostove Config
Konfigurišite VLAN interfejse Config
Konfigurišite SSH ključeve Config
IPv6 Config
Utils Ponovo pokreni RPC
Ažuriraj RPC
NETCONF obavještenja Online status je promijenjen Obavijest
Status Dobijte status sistema (vreme rada, upotreba memorije,
prosjek opterećenja, verzija)
Država

Resurs: Inventar
YANG putanja: /accounts/account/twamp-reflektori

Juniper NETWORKS NETCONF & YANG API softver -Gotovoview 1Juniper NETWORKS NETCONF & YANG API softver -Gotovoview 2Juniper NETWORKS NETCONF & YANG API softver -Gotovoview 3

Podržane NETCONF mogućnosti

Tabela ispod ukazuje na IETF RFC-ove koji opisuju NETCONF mogućnosti koje se koriste u svrhu Paragon Active Assurance orkestracije.

  • ietf-netconf.yang
  • IETF RFC 6241, Protokol za mrežnu konfiguraciju (NETCONF), https://tools.ietf.org/html/rfc6241
  • Jedina podržana metoda rukovanja greškama je vraćanje na grešku.
  • Jedina podržana pohrana podataka je upisljiva.
  • ietf-netconf-notifications.yang
  • IETF RFC 5277, NETCONF obavještenja o događajima, https://tools.ietf.org/html/rfc5277

Testirajte i nadgledajte šablone
Predlošci za tipove testova i monitora moraju se postaviti ručno preko prednjeg korisničkog interfejsa Paragon Active Assurance. Kako to učiniti opisano je u pomoći unutar aplikacije pod “Testovi i monitori” > “Kreiranje predložaka”.

ExampLes Controlling Paragon Active Assurance putem NETCONF & YANG API-ja

U poglavljima koja slijede, pretpostavlja se da su prikladni predlošci za testiranje i nadzor definirani prema uputama datim u poglavlju “Testiranje i predlošci monitora” na stranici 15.

Alati koji se koriste u pramples
Svi bivšiamplekcije u narednim poglavljima su napravljene korišćenjem sledećih besplatno dostupnih alata:

  • Pang: Koristi se za vizualizaciju i pregledavanje YANG modela.
  • Dostupno na adresi https://github.com/mbj4668/pyang (klonirajte iz git-a i pokrenite python setup.py install).
  • Python NETCONF klijent “ncclient”: Koristi se za komunikaciju sa Kontrolnim centrom koristeći NETCONF.
  • Dostupno na https://github.com/ncclient/ncclient (pokreni pip install ncclient).
    Model podataka netrounds-ncc.yang nalazi se u /opt/netrounds-confd nakon što je ConfD instaliran prema Vodiču za instalaciju).

Gotovoview ključnih izvršenih zadataka

(Neki daljnji zadaci su također prikazani u nastavku.)

  • “Kreiranje i postavljanje novog agenta za testiranje” na stranici 16
  • “Kreiranje inventara (npr. reflektora)” na stranici 29
  • “Postavljanje predložaka alarma i mjesta slanja alarma” na stranici 35
  • “Kreiranje i pokretanje testa” na stranici 45
  • “Preuzimanje rezultata testa” na stranici 50
  • “Pokretanje monitora (uključuje postavljanje alarma)” na stranici 60
  • “Dohvaćanje SLA statusa za monitor” na stranici 67
  • “Rad sa tags”Na stranici 71

Examples: Test Agenti

Gotovoview orkestracije testnih agenata
Test agenti u Paragon Active Assuranceu se smatraju „konfiguracijom“ u kontekstu orkestracije. To znači da kreiranje, kontrolu i brisanje Test Agenta treba obaviti preko orkestratora i NETCONF-a, a ne preko Paragon Active Assurance GUI.
Juniper NETWORKS NETCONF & YANG API softver - IkonaVAŽNO: Ako je test agent instaliran od strane tehničara i registrovan u Kontrolnom centru, a da nije prethodno kreiran putem NETCONF & YANG API-ja, agent za testiranje neće postojati u konfiguracionoj bazi podataka i sistem će se povući iz sinhronizacije. Da bi ConfD postao svjestan Test Agenta u ovom slučaju, bit će potrebno izvršiti novu sinhronizaciju sa Kontrolnim centrom, kao što je detaljno opisano u odjeljku „Sinhroniziranje baze podataka konfiguracije sa Kontrolnim centrom“ na stranici 4.

Orkestracija virtuelnih testnih agenata (vTA) bi se stoga radije trebala izvršiti u sljedećim koracima:

  1. Kreirajte virtuelnog agenta za testiranje, uključujući konfiguraciju njegovog interfejsa, koristeći NETCONF & YANG interfejs za Kontrolni centar. Ime test agenta će biti njegov jedinstveni ključ.
  2. Postavite vTA na platformu za virtuelizaciju. Slijedite upute u online pomoći pod Test Agenti > Instalacija. Osnovna konfiguracija interfejsa koja omogućava vTA-u da se poveže sa Kontrolnim centrom, kao i akreditivi za autentifikaciju, obezbeđena je u vTA-u pomoću korisničkih podataka iz oblaka.
    Nakon što se vTA pokrene, automatski će se povezati na Kontrolni centar koristeći šifrovanu OpenVPN vezu. NETCONF obavijest se šalje pošto je vrijednost parametra test-agent-statuschange vTA sada promijenjena u “online”.
    NAPOMENA: Budući da je ime vTA njegov identifikator u Kontrolnom centru, ovo ime mora biti isto kao ono definirano u Kontrolnom centru u “korak 1” na stranici 17.
  3. Jednom kada se vTA poveže i autentifikuje na Kontrolni centar, konfiguracija interfejsa se prenosi na vTA. Ovo je konfiguracija interfejsa data u “korak 1” na stranici 17 kada je vTA kreiran u Kontrolnom centru.
  4. Nakon što vTA ispuni svoju svrhu, izbrišite vTA.

Kreiranje i implementacija novog agenta za testiranje

Prvo treba da kreiramo Test Agenta koristeći NETCONF & YANG interfejs za Kontrolni centar. Kada se agent za testiranje kreira na ovaj način, nije potrebna sinhronizacija sa Kontrolnim centrom.
YANG model za test agenta je prikazan ispod. Dobiva se kao izlaz iz naredbe
pyang -f stablo netrounds-ncc.yang
Puni YANG model je dat 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.

Juniper NETWORKS NETCONF & YANG API Softverski agentiJuniper NETWORKS NETCONF & YANG API softver -agenti 1Juniper NETWORKS NETCONF & YANG API softver -agenti 2

Nastavljamo sa sljedećim koracima, koji su detaljno opisani u nastavku:

  1. Na početku, Paragon Active Assurance nalog „demo“ nema Test Agente u svom inventaru.
  2.  Test agent pod nazivom “vta1” kreiran je pomoću ncclient. Kod ovog stage, još uvijek ne postoji pravi Test Agent (to jest, još nije pokrenut).
  3. Test Agent je raspoređen u OpenStack. (Primjena na toj platformi je ovdje odabrana kao jedna mogućnost između ostalih.)
  4. Test Agent se povezuje na račun Kontrolnog centra “demo” i sada je spreman za upotrebu.
    Korak 1: Na početku, nema Test Agenta u „demo“ nalogu. Pogledajte snimak ekrana ispod iz GUI Kontrolnog centra.Juniper NETWORKS NETCONF & YANG API softver -agenti 3Korak 2: Agent za testiranje se kreira u Kontrolnom centru koristeći Python NETCONF klijent “ncclient”. Ispod je ncclient kod za kreiranje Test Agenta koji ima jedno fizičko sučelje s DHCP adresom:

import argparse
od ncclient menadžera uvoza
parser = argparse.ArgumentParser(description='Test kreiranje test agenta')
parser.add_argument('–host', help='Naziv hosta na kojem se nalazi ConfD', obavezno=Tačno)
parser.add_argument('–port', help='Port za povezivanje na ConfD', obavezno=Tačno)
parser.add_argument('–username', help='Korisničko ime za povezivanje na ConfD', obavezno=Tačno)
parser.add_argument('–password', help='Lozinka za ConfD račun', obavezno=Tačno)
parser.add_argument('–netrounds-account', help='Kratki naziv NCC naloga', obavezno=Tačno)
parser.add_argument('–test-agent-name', help='Ime testnog agenta', obavezno=Tačno)
args = parser.parse_args()
sa manager.connect(host=args.host, port=args.port, korisničko ime=args.username,
password=args.password, hostkey_verify=False) kao m:
# Kreirajte test agenta u Kontrolnom centru
xml = “””

Juniper NETWORKS NETCONF & YANG API softver -agenti 4)print m.edit_config(target='running', config=xml)

NAPOMENA: Kod koji prethodi sa manager.connect(…) je izostavljen iz narednih example isječci koda.
NTP server je konfigurisan na eth0, a eth0 je takođe interfejs za upravljanje (tj. interfejs koji se povezuje sa Kontrolnim centrom).
Aplikacija Test Agent trenutno ne dozvoljava konfigurisanje interfejsa. Iz tog razloga, od verzije 2.34.0 nadalje, moguće je izostaviti konfiguraciju interfejsa u YANG šemi. Odgovarajući XML je stoga radikalno pojednostavljen u ovom slučaju:Juniper NETWORKS NETCONF & YANG API softver -agenti 5Nakon što je agent za testiranje kreiran, on postoji u konfiguracijskoj bazi podataka i u Kontrolnom centru. Pogledajte snimak ekrana ispod inventara Test Agenta, koji prikazuje Test Agenta “vta1”:

Juniper NETWORKS NETCONF & YANG API softver -agenti 6Korak 3: Sada je vrijeme za implementaciju Test Agenta “vta1” u OpenStack.
Agent za testiranje će koristiti korisničke podatke pokretanja oblaka da bi dohvatio informacije o tome kako se povezati s Kontrolnim centrom. Konkretno, 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 preostali redovi moraju biti uvučeni):

Juniper NETWORKS NETCONF & YANG API softver - hladnoZa dodatne informacije pogledajte dokument Kako implementirati virtuelne test agente u OpenStack.
Jednom kada se agent za testiranje implementira i poveže sa kontrolnim centrom, konfiguracija će biti gurnuta iz kontrolnog centra u agent za testiranje.

Juniper NETWORKS NETCONF & YANG API softver - Cold 1

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

Navođenje test agenata na vašem računu Paragon Active Assurance
Ispod je example ncclient Python kod za navođenje testnih agenata u Paragon Active Assurance računu:

Juniper NETWORKS NETCONF & YANG API softver - Cold 2Juniper NETWORKS NETCONF & YANG API softver - Cold 3Izvođenje ovog koda daje izlaz kao što je dolje:

Juniper NETWORKS NETCONF & YANG API softver - Cold 4Juniper NETWORKS NETCONF & YANG API softver - Cold 5

Brisanje test agenta
Nakon što je test završen, može biti relevantno u nekim slučajevima upotrebe izbrisati agenta za testiranje.
Ispod je isječak koda koji pokazuje kako to učiniti s ncclientom:

Juniper NETWORKS NETCONF & YANG API softver - agent

NETCONF obavještenja
U nastavku predstavljamo jednostavan example skripta za slušanje svih dolaznih NETCONF obavijesti iz Kontrolnog centra. Ova obavještenja se šalju kad god se dogode određeni događaji, kao što je odlazak agenta za testiranje van mreže ili završetak testiranja koji je pokrenuo korisnik. Na osnovu informacija koje se nalaze u obavještenjima, korisnici mogu dodijeliti automatske naknadne radnje u orkestratoru.

Juniper NETWORKS NETCONF & YANG API softver - NETCONFKada se gornja skripta izvrši, NC klijent će prikazati primljenu obavijest u strukturiranom XML-u. Vidi bivample izlaz ispod, koji pokazuje da agent za testiranje neočekivano odlazi van mreže.



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

Examples: Stavke inventara

Kreiranje (uvoz) i upravljanje stavkama zaliha kao što je TWAMP reflektori i Y.1731 MEP 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 Assuranceu preko NETCONF & YANG API-ja i za dohvaćanje lista definiranih stavki.

Kreiranje TWAMP Reflektor

Juniper NETWORKS NETCONF & YANG API softver - TWAMPJuniper NETWORKS NETCONF & YANG API softver - TWAMP 1

Kreiranje Y.1731 MEP

Juniper NETWORKS NETCONF & YANG API softver - SlikaKreiranje IPTV kanala

Juniper NETWORKS NETCONF & YANG API softver -TWAMP 3

Kreiranje ping hosta

Juniper NETWORKS NETCONF & YANG API softver -HostJuniper NETWORKS NETCONF & YANG API softver -Host 1

Kreiranje SIP naloga

Juniper NETWORKS NETCONF & YANG API softver -Accoun Juniper NETWORKS NETCONF & YANG API softver - račun 1

Preuzimanje inventara
Ispod je Python kod za preuzimanje svih stavki inventara definiranih na računu. (Ovdje se sve vrste inventara preuzimaju u jednom potezu kako bi se izbjeglo ponavljanje u dokumentu. Naravno, bilo koji podskup stavki inventara može se preuzeti izostavljanjem nekih redova ispod računa.)

Juniper NETWORKS NETCONF & YANG API softver - Stavke

Izvođenje ovog koda daje izlaz kao što je dolje:Juniper NETWORKS NETCONF & YANG API softver - Stavke 1Juniper NETWORKS NETCONF & YANG API softver - Stavke 2

Examples: Alarmi

Predlošci alarma i pridružene stavke (SNMP menadžeri, liste e-pošte alarma) kreiraju se i njima se upravlja na sličan način kao stavkama inventara. Ovo poglavlje sadrži XML i NETCONF kod za definiranje takvih entiteta u Paragon Active Assuranceu preko NETCONF & YANG API-ja i za dohvaćanje popisa definiranih stavki.
Liste e-pošte alarma
Kreiranje liste e-pošte alarmaJuniper NETWORKS NETCONF & YANG API softver - Stavke 3Juniper NETWORKS NETCONF & YANG API softver - Stavke 4

Preuzimanje svih lista e-pošte alarmaJuniper NETWORKS NETCONF & YANG API softver - Stavke 5

SNMP menadžeri
Kreiranje SNMP menadžeraJuniper NETWORKS NETCONF & YANG API softver - Stavke 6Juniper NETWORKS NETCONF & YANG API softver - Stavke 7

Preuzimanje svih SNMP menadžeraJuniper NETWORKS NETCONF & YANG API softver - SNMPJuniper NETWORKS NETCONF & YANG API softver - SNMP 1

Alarm Templates
Kreiranje predloška alarmaJuniper NETWORKS NETCONF & YANG API softver - predlošciJuniper NETWORKS NETCONF & YANG API softver - predlošci 1

Preuzimanje svih predložaka alarmaJuniper NETWORKS NETCONF & YANG API softver - predlošci 2Juniper NETWORKS NETCONF & YANG API softver - predlošci 3

Examples: SSH ključevi

Možete dodati SSH javne ključeve Test agentu preko NETCONF & YANG API-ja. Koristeći odgovarajući privatni ključ, možete se prijaviti na Test Agent preko SSH-a.
Potpuna lista dostupnih operacija na SSH ključevima je kako slijedi:

  • Dodajte SSH ključ
  • Izmijenite SSH ključ
  • Pregledajte SSH ključ
  • Navedite SSH ključeve
  • Izbrišite SSH ključ.
    U nastavku su prikazane operacije dodavanja i brisanja.
Dodavanje SSH ključa
Evo kako da kreirate novi SSH ključ.Juniper NETWORKS NETCONF & YANG API softver - ključ

Brisanje SSH ključa
Ako želite da izbrišete SSH ključ, koristite sljedeću naredbu:Juniper NETWORKS NETCONF & YANG API softver - ključ 1

Examples: Testovi

Ovdje se pretpostavlja da su agenti za testiranje (koliko je potrebno za testove) kreirani prema odjeljku “Kreiranje i implementacija novog agenta za testiranje” na stranici 17.
YANG model staze za testove

Stavka Putanja YANG modela: /accounts/account/tests…
testovi /.
test[id] /test
id /test/id
ime /test/name
status /test/status
vrijeme početka /test/start-time
krajnje vrijeme /test/end-time
izvještaj-url /Izvještaj o ispitivanju-url
stepenice /test/steps
korak[id] /test/steps/step
ime /test/steps/step/name
id /test/steps/step/id
vrijeme početka /test/steps/step/start-time
krajnje vrijeme /test/steps/step/end-time
status /test/steps/step/status
statusna poruka /test/steps/step/status-message
šabloni /templates
šablon[ime] /templates/template
ime /templates/template/name
opis /templates/template/description
parametri /templates/template/parameters
parametar[ključ] /templates/template/parameters/parameter
ključ /templates/template/parameters/parameter/key
tip /templates/template/parameters/parameter/type

Preduvjeti za probnu orkestraciju

  •  Da biste započeli testiranje kroz NETCONF koristeći NC klijent, potrebno je prvo izgraditi testni predložak koristeći GUI Control Center kao što je detaljno opisano u pomoći unutar aplikacije pod “Testovi i monitori” > “Kreiranje predložaka”. Sva polja navedena u tom predlošku kao “Unos predloška” će biti potrebna kao parametri u XML-u prilikom orkestriranja pokretanja testnog predloška.
  • Izvođenje testova u Paragon Active Assurance-u se smatra „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 podataka o konfiguraciji spomenutih u odjeljku „Prekoview orkestracije testnog agenta” na stranici 17. Ovo u osnovi znači da promjene testova ili predložaka u GUI Kontrolnog centra neće uzrokovati nikakve probleme vezane za sinhronizaciju između Kontrolnog centra i baze podataka konfiguracije.
  • Da dobijem izvještaj-URL pravo u izvještajima o testiranju, morate provjeriti Kontrolni centar URL je ispravno konfigurisan. Ovo se radi u file /opt/netrounds-confd/settings.py. Podrazumevano, ime hosta Kontrolnog centra se preuzima pomoću socket.gethostname(): vidi dole. Ako ovo ne daje ispravan rezultat, morate postaviti ime hosta (ili cijelo URL) ručno u ovom file.

# URL Kontrolnog centra bez kose crte.
# Ovo je nprampkorišteno u izvještaju o ispitivanju-url.
HOSTNAME = socket.gethostname()
NETROUNDS_URL = 'https://%s' % HOSTNAME
Pokretanje testa
Kao što je opisano u odjeljku “Kreiranje i implementacija novog agenta za testiranje” 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:Juniper NETWORKS NETCONF & YANG API softver - ključ 2Juniper NETWORKS NETCONF & YANG API softver - ključ 3

Za objašnjenja pogledajte odjeljak “Legenda” na strani 81 u Dodatku.

Sljedeći koraci su prikazani u nastavku:

  1. Test Agenti su registrovani na Paragon Active Assurance nalog, ali testovi još nisu započeti.
  2. Potrebni ulazni parametri identificirani su u predlošku za testiranje koji će se pokrenuti.
  3.  60-sekundni HTTP test se pokreće pomoću ncclienta.

Korak 1: Na samom početku, nisu pokrenuti testovi na Paragon Active Assurance računu. Pogledajte snimak ekrana ispod iz GUI Kontrolnog centra.Juniper NETWORKS NETCONF & YANG API softver - ključ 4
Korak 2: Šablon koji ćemo koristiti za pokretanje testa u ovom primjeruample je HTTP test šablon. Ima dva obavezna polja za unos (klijenti i URL) koje smo kao takve naveli prilikom izrade predloška u GUI Kontrolnog centra.Juniper NETWORKS NETCONF & YANG API softver - ključ 5

Definisaćemo ove parametre (između ostalih) u XML konfiguraciji koju konfiguracionoj bazi podataka prenosi naš NETCONF menadžer (ncclient).
Korak 3: HTTP test se pokreće pomoću ncclienta.
Ispod je example kod gdje su potrebne informacije o konfiguraciji i parametri specificirani za HTTP predložak testa. Ovisno o tome kako je šablon napravljen, detalji ovdje mogu varirati.
Za svaki parametar, atribut treba dostaviti. Ključ je identičan parametru
Ime varijable u Kontrolnom centru. Nazive varijabli možete provjeriti na sljedeći način:

  • Kliknite na Testovi na bočnoj traci i odaberite New Test Sequence.
  • Kliknite na Moji predlošci.
  • Kliknite na vezu Uredi ispod predloška koji vas zanima.
  • Kliknite na dugme Uredi unos u gornjem desnom uglu.

U našem bivšemample, a prema zadanim postavkama, imena varijabli su jednostavno male verzije prikaza imena koja se vide u Kontrolnom centru (“url” vs.URL“, itd.). Međutim, u GUI Kontrolnog centra, možete preimenovati varijable kako god želite.
Osim ključa, svaki parametar mora imati specificiran svoj tip: nprample, za URL.
Imajte na umu da morate ponovoview kompletan YANG model kako bi se dobile pune informacije o tipovima. Za interfejse Test Agenta tip ima složeniju strukturu, kao što je vidljivo pod u kodu ispod.Juniper NETWORKS NETCONF & YANG API softver - Ključ za

Sada možemo pokrenuti skriptu koristeći ncclient. Pod pretpostavkom da je sve ispravno, test će biti pokrenut i njegovo izvršenje će biti prikazano u Kontrolnom centru:Juniper NETWORKS NETCONF & YANG API softver - kontrolaAko je test uspješno pokrenut, Kontrolni centar će odgovoriti sa ID testa. U ovom example, ID testa je 3:Juniper NETWORKS NETCONF & YANG API softver - kontrola 1ID testa se također može pronaći u URL za test u GUI Kontrolnog centra. U ovom example, to URL je https://host/demo/testing/3/.
Preuzimanje rezultata testa
Najjednostavniji način da dobijete rezultate testa je pokazivanje na ID testa.
Ispod je Python kod za dobijanje rezultata iz gornjeg HTTP testa sa ID = 3:
sa menadžerom. Poveži (host=args.host, port=args.port, korisničko ime=args.username,password=args.password, hostkey_verify=False) kao m:Juniper NETWORKS NETCONF & YANG API softver - kontrola 2

Izlaz će izgledati otprilike ovako:Juniper NETWORKS NETCONF & YANG API softver - kontrola 3 Juniper NETWORKS NETCONF & YANG API softver - kontrola 4

Izvoz i uvoz test šablona
Test predlošci se mogu izvesti u JSON formatu i ponovo uvesti u tom formatu u Kontrolni centar. Ovo je korisno ako želite koristiti testne predloške u drugoj instalaciji Kontrolnog centra. (Početno kreiranje predložaka najbolje se obavlja preko GUI Kontrolnog centra.)
Ispod je kod za obavljanje izvoza i uvoza.
Izvoz predložaka za testiranje

Juniper NETWORKS NETCONF & YANG API softver - kontrola 5

# Uzmite json konfiguraciju iz odgovora
root = ET.fromstring(response._raw)
json_config = root[0].text
print json_config
Predložak je sadržan u objektu json_config.
Uvoz predložaka za testiranje
JSON konfiguracijski objekat koji sadrži testne predloške može se ponovo uvesti u Kontrolni centar na sljedeći način.Juniper NETWORKS NETCONF & YANG API softver - ŠabloniJuniper NETWORKS NETCONF & YANG API softver - Šabloni 1

Examples: Monitori

Ovaj odjeljak pretpostavlja da su agenti za testiranje (koliko ih zahtijevaju monitori) kreirani prema odjeljku “Kreiranje i implementacija novog agenta za testiranje” na stranici 17.
YANG putanje modela za monitore

Stavka Putanja YANG modela: /accounts/account/monitors…
monitori /.
monitor[ime] /monitor
ime /monitor/ime
opis /monitor/opis
počeo /monitor/pokrenut
šablon /monitor/template
alarm-configs /monitor/alarm-configs
Stavka Putanja YANG modela: /accounts/account/monitors/monitor/alarm-configs…
alarm-config[identifikator] /alarm-config
identifikator /alarm-config/identifier
šablon /alarm-config/template
email /alarm-config/email
snmp /alarm-config/snmp
thr-es-critical /alarm-config/thr-es-critical
thr-es-critical-clear /alarm-config/thr-es-critical-clear
th-es-dur /alarm-config/thr-es-major
thr-es-major-clear /alarm-config/thr-es-major-clear
thr-es-minor /alarm-config/thr-es-minor
thr-es-minor-clear /alarm-config/thr-es-minor-clear
thr-es-warning /alarm-config/thr-es-warning
thr-es-warning-clear /alarm-config/thr-es-warning-clear
bez-data-ozbiljnost /alarm-config/no-data-severity
no-data-timeout /alarm-config/no-data-timeout
akcija /alarm-config/action
veličine 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
Stavka Putanja YANG modela: /accounts/account/monitors…
parametri /monitor/parametri
Stavka Putanja YANG modela: /accounts/account/monitors/monitor/parameters…
parametar[ključ] /parametar
ključ /parametar/ključ
(tip vrijednosti) /parametar
:(cijeli broj) /parametar
cijeli broj /parametar/cijeli broj
:(float) /parametar
float /parametar/float
:(string) /parametar
Stavka Putanja YANG modela: /accounts/account/monitors/monitor/parameters…
string /parametar/string
:(test-agent-interfaces) /parametar
test-agent-interface /parametar/test-agent-interfaces
test-agent-interface[“1” na stranici 58 /parametar/test-agent-interfaces/
račun /parametar/test-agent-interfaces/test-agent-interface/account
test-agent /parametar/test-agent-interfaces/test-agent-interface/test-agent
interfejs /parametar/test-agent-interfaces/test-agent-interface/interface
ip verzija /parametar/test-agent-interfaces/test-agent-interface/ip-version
:(dvamp-reflektori) /parametar
twamp-reflektori /parametar/twamp-reflektori
twamp-reflektor[ime] /parametar/twamp-reflektori/twamp-reflektor
ime /parametar/twamp-reflektori/twamp-reflektor/ime
:(y1731-meps) /parametar
y1731-meps /parametar/y1731-meps
y1731-mep[ime] /parametar/y1731-meps/y1731-mep
ime /parametar/y1731-meps/y1731-mep/name
:(sip-računi) /parametar
sip-računi /parametar/sip-nalozi
sip-account[“2” na stranici 58] /parametar/sip-accounts/sip-account
račun /parametar/sip-accounts/sip-account/account
test-agent /parametar/sip-accounts/sip-account/test-agent
interfejs /parametar/sip-accounts/sip-account/interface
sip-adresa /parametar/sip-accounts/sip-account/sip-address
:(iptv-kanali) /parametar
iptv kanali /parametar/iptv-kanali
iptv-kanal[ime] /parametar/iptv-channels/iptv-channel
ime /parametar/iptv-channels/iptv-channel/name
  1. korisnički interfejs test-agent
  2. sip-adresa interfejsa test-agenta naloga
Stavka Putanja YANG modela: /accounts/account/monitors…
status /monitor/status
poslednjih 15 minuta /monitor/status/last-15-minutes
status /monitor/status/last-15-minutes/status
status-vrijednost /monitor/status/last-15-minutes/status-value
zadnji sat /monitor/status/zadnji sat
status /monitor/status/last-hour/status
status-vrijednost /monitor/status/last-hour/status-value
zadnja 24 sata /monitor/status/last-24-hours
status /monitor/status/last-24-hours/status
status-vrijednost /monitor/status/last-24-hours/status-value
šabloni /templates
šablon[ime] /templates/template
ime /templates/template/name
opis /templates/template/description
parametri /templates/template/parameters
parametar[ključ] /templates/template/parameters/parameter
ključ /templates/template/parameters/parameter/key
tip /templates/template/parameters/parameter/type

Preduvjeti za orkestraciju monitora
Prije nego što možete pokrenuti monitor putem NETCONF-a pomoću ncclienta, trebate napraviti predložak monitora u GUI Kontrolnog centra kao što je objašnjeno u pomoći unutar aplikacije pod “Testovi i monitori” > “Kreiranje 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.
Dobivanje ulaznih parametara iz predložaka monitora
Ispod su prikazana dva šablona. Prvi je za UDP praćenje između dva interfejsa Test Agenta, a drugi je za HTTP koristeći jedan interfejs Test Agenta.
Da biste saznali ulazne parametre predloška, ​​kliknite na okvir koji predstavlja predložak. Za HTTP predložak, parametri mogu izgledati ovako:

Juniper NETWORKS NETCONF & YANG API softver - Šabloni 2

Ove parametre moramo definirati u sljedećem koraku kada pokrećemo monitor.
Pokretanje monitora
Koristeći agente za testiranje koje smo definirali i implementirali u odjeljku “Kreiranje i postavljanje novog agenta za testiranje” na stranici 17, možemo pokrenuti monitor iz predloška “HTTP” kao što je prikazano ispod.
Za svaki parametar, atribut treba dostaviti. Ključ je identičan imenu varijable parametra u Kontrolnom centru. Nazive varijabli možete provjeriti na sljedeći način:

  • Kliknite Monitoring na bočnoj traci i odaberite Novi monitor.
  • Kliknite na Moji predlošci.
  • Kliknite na vezu Uredi ispod predloška koji vas zanima.
  • Kliknite na dugme Uredi unos u gornjem desnom uglu.

U našem bivšemample, a prema zadanim postavkama, imena varijabli su jednostavno male verzije prikaza imena koja se vide u Kontrolnom centru (“url” vs.URL“, itd.). Međutim, u GUI Kontrolnog centra, možete preimenovati varijable kako god želite.
Osim ključa, svaki parametar mora imati specificiran svoj tip: nprample, za URL. Imajte na umu da se pune informacije o tipu parametra nalaze u YANG modelu. Za interfejse Test Agenta tip ima složeniju strukturu, kao što je vidljivo u kodu ispod.
U exampU nastavku, nijedan alarm nije povezan sa monitorom. Za nprampako uključuje alarme, idite na odjeljak “Pokretanje monitora s alarmom” na stranici 62.

Juniper NETWORKS NETCONF & YANG API softver - Šabloni 3

Juniper NETWORKS NETCONF & YANG API softver - Šabloni 4

Pokretanje monitora sa alarmom
Da povežete alarm sa monitorom, možete ili pokazati na predložak alarma koji je definiran, ili možete dostaviti cijelu konfiguraciju alarma prilikom kreiranja monitora. Daćemo jednog bivšegample svakog pristupa u nastavku.
Postavljanje alarma monitora pokazivanjem na predložak alarma
Da biste koristili šablon alarma, morate znati njegov ID. U tu svrhu prvo dohvatite sve svoje šablone alarma kao što je opisano u odjeljku “Preuzimanje svih predložaka alarma” na stranici 39 i zabilježite naziv relevantnog predloška. Zatim se možete pozvati na taj šablon na sljedeći način:

Juniper NETWORKS NETCONF & YANG API softver - Šabloni 5

Juniper NETWORKS NETCONF & YANG API softver - Šabloni 6

Podešavanje alarma monitora konfiguracijom direktnoly
Alternativno, možete postaviti alarm za monitor tako što ćete dostaviti njegovu cjelokupnu konfiguraciju prilikom kreiranja monitora, bez pozivanja na šablon alarma. Ovo se radi kao što je prikazano u sljedećem primjeruample.

Juniper NETWORKS NETCONF & YANG API softver - Šabloni 7

Juniper NETWORKS NETCONF & YANG API softver - Šabloni 8

Juniper NETWORKS NETCONF & YANG API softver - Šabloni 9

Preuzimanje monitora koji rade
Da preuzmete sve monitore koji se trenutno izvode, pokrenite ovu skriptu:
sa menadžerom. connect(host=args.host, port=args.port, korisničko ime=args. korisničko ime, lozinka=args.password, hostkey_verify=False) kao m:

Juniper NETWORKS NETCONF & YANG API softver - Šabloni u

Izlaz je lista svih pokrenutih monitora kao što je prikazano u nastavku:

Juniper NETWORKS NETCONF & YANG API softver - Šabloni u 1

Juniper NETWORKS NETCONF & YANG API softver - Šabloni u 2

Dohvaćanje SLA statusa za monitor
Evo kako da preuzmete SLA status za monitor. U ovom exampdohvaćamo SLA status za monitor “Kvalitet mreže” za tri vremenska intervala: posljednjih 15 minuta, posljednji sat i posljednja 24 sata.

Juniper NETWORKS NETCONF & YANG API softver - Monitor

Juniper NETWORKS NETCONF & YANG API softver - Monitor 1

Izlaz će izgledati otprilike ovako:

Juniper NETWORKS NETCONF & YANG API softver - Monitor 2



NETCONF obavještenja
NETCONF obavijesti za monitore pokreću kršenja SLA. Oni se dešavaju kada SLA za monitor padne ispod SLA praga („Dobar“ ili „Prihvatljiv“) unutar datog vremenskog okvira, prema zadanim postavkama zadnjih 15 minuta. Treba napomenuti da se obavještenja o kršenju SLA brzo pojavljuju nakon što problem utiče na uslugu, dok će se SLA status vratiti na "Dobar" tek nakon 15 minuta i samo ako ne dođe do daljnjih kršenja.
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
Ovo se radi na potpuno isti način kao i za test šablone; uporedite odjeljak “Izvoz i uvoz predložaka za testiranje” na stranici 52. Isječci koda ispod ilustruju kako izvoziti i uvoziti predloške za monitore.
Izvoz predložaka monitora

Juniper NETWORKS NETCONF & YANG API softver -Monitor Templates

Juniper NETWORKS NETCONF & YANG API softver – predlošci za praćenje 1

Uvoz predložaka monitora

Juniper NETWORKS NETCONF & YANG API softver – predlošci za praćenje 3

Juniper NETWORKS NETCONF & YANG API softver – predlošci za praćenje 4

Koristeći Tags

Tags definirano u Paragon Active Assurance može se primijeniti na:

  • monitori
  • predlošci monitora
  • Test Agents
  • TWAMP reflektori
  • Ping domaćini.
    Za nprample, možeš tag monitor sa istim tag kao podskup test agenata koji će pokrenuti monitor. Ova funkcija je posebno korisna ako imate definiran veliki broj monitora i šablona.

Ako ste postavili alarm sa SNMP zamkama za monitor, tada će SNMP zamke biti dodijeljene iste tags kao monitor, ako ga ima.
Kreiranje Tags
U nastavku pokazujemo kako kreirati a tag s imenom i bojom kako je definirano u XML-utag> podkonstrukcija.

Juniper NETWORKS NETCONF & YANG API softver -Tags

Dodjela a Tag
Za dodjelu a tag resursu, dodajete ga kao novitag> element ispodtags> element za taj resurs.
Evo kako dodijeliti a tag test agentu:

Juniper NETWORKS NETCONF & YANG API softver -Tags 1

Za dodjelu a tag na TWAMP reflektora, uradite sljedeće:

Juniper NETWORKS NETCONF & YANG API softver -Tags 2

Juniper NETWORKS NETCONF & YANG API softver -Tags 3

Dodjela a tag na monitor se postupa na sličan način:

Juniper NETWORKS NETCONF & YANG API softver -Tags 4

Juniper NETWORKS NETCONF & YANG API softver -Tags 5

Alternativno, možete dodijeliti postojeće tag na bilo koji od ovih tipova resursa prilikom kreiranja resursa, uključivanjemtags> element koji sadrži tag u pitanju.
Ažuriranje a Tag
Ažuriranje postojećeg tag sa novim atributima je analogno kreiranju a tag:

Juniper NETWORKS NETCONF & YANG API softver -Tags upravljati

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 sa monitora.

Juniper NETWORKS NETCONF & YANG API softver -Tags upravljati 1

Brisanje a Tag
Da biste izbrisali a tag potpuno iz Kontrolnog centra, ponovo se koristi atribut nc:operation=”delete”, ali ovaj put primijenjen na tag sama, definisana pod .

Juniper NETWORKS NETCONF & YANG API softver -Tags upravljati 2

Rješavanje problema

Problem: Orchestrator i Paragon Active Assurance su neusklađeni
Orkestrator i Paragon Active Assurance mogu završiti nesinhronizirani nprample ako su promjene konfiguracije napravljene u GUI 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 server više neće prihvatiti promjene konfiguracije; odgovorit će porukom o grešci u kojoj se navodi da je konfiguracija zaključana dok se ponovo ne sinhronizira. Da biste se vratili u sinkronizaciju i otključali promjene konfiguracije, trebate pokrenuti naredbu rpc sync-from-ncc koja sinkronizira svu konfiguraciju iz Kontrolnog centra sa konfiguracijskom bazom podataka.
NAPOMENA: The confd@netrounds.com korisnik (ili bilo šta što je konfigurirano) mora imati privilegije superkorisnika da bi se sve uspješno sinhroniziralo. Ovo 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 je moglo biti obrađeno.
NAPOMENA: Ako vaš orkestrator također pohranjuje konfiguraciju, morat ćete i nju ponovo sinkronizirati jer tražena konfiguracija (konfiguracija koju orkestrator očekuje da će imati kontrolni centar) neće biti primijenjena.
Problem: početna sinhronizacija (sinhronizacija iz-ncc) nije uspjela zbog nepodržanih resursa
Ako pokušate da pokrenete rpc sync-from-ncc na nalogu čiji je konfiguracija kreirana u GUI Kontrolnog centra, mogli biste naići na probleme ako nalog sadrži nepodržane resurse. Preporučuje se da počnete sa praznim nalogom i da sve konfigurišete preko NETCONF-a. U suprotnom, ako naiđete na probleme s sukobima resursa, morat ćete ukloniti konfliktne resurse s računa.
Problem: NETCONF naredbe ne uspijevaju s ncclient.operations.rpc.RPCError: greška u komunikaciji aplikacije
NETCONF server ne obnavlja vezu sa serverom Kontrolnog centra automatski ako se Kontrolni centar ponovo pokrene. Da biste vratili vezu sa Kontrolnim centrom, ponovo pokrenite NETCONF proces: sudo systemctl restart netrounds-confd

Napomene o aplikacijama test agenta i uređajima testnih agenata

Testirajte aplikacije agenta u ConfD-u
Među test agentima, (novija) aplikacija test agenta radi malo drugačije od (starije) uređaja test agenta.
Aplikacije Test agenta trenutno ne podržavaju konfiguraciju interfejsa. Stoga, YANG shema dozvoljava specificiranje prazne konfiguracije sučelja za takve Test Agente. Vidi “ovaj pasus” na strani 23 za primjerample.
Kada sinhronizujete ConfD bazu podataka sa Kontrolnim centrom pomoću naredbe sync-from-ncc, želite da konfiguracija interfejsa ostane prazna i da ne bude prepisana onim što se nalazi u Kontrolnom centru. Zbog toga morate koristiti posebnu zastavicu –without_interface_config sa tom komandom kada radite sa Test Agent aplikacijama.
Prazna konfiguracija sučelja za uređaj testnog agenta
Kao što je gore navedeno, aplikacija Test Agent ne podržava konfiguraciju interfejsa, pa je stoga moguće izostaviti interfejse u YANG šemi.
Ali postoje i slučajevi upotrebe u kojima biste mogli izostaviti konfiguraciju interfejsa iz uređaja Test Agent. BivšiampOvo bi mogao biti scenario orkestracije u kojem pokrećete Test Agent koristeći cloud-init, i želite da se koristi konfiguracija interfejsa odatle, umjesto da dozvolite ConfD-u da ga prepiše dok se Test Agent pojavi na mreži.
Promjene YANG sheme u vezi sa nedefiniranim sučeljima
Pošto je sada dozvoljena prazna konfiguracija interfejsa (od verzije 2.34.0 nadalje), moguće je navesti bilo koje ime interfejsa kao ulaz za zadatak koji se izvodi kao deo testa ili monitora.
Ovo je potrebno da bi se mogla koristiti Test Agent Application, jer za njih nisu definirana imena interfejsa u ConfD-u. 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 da koristi nepostojeći interfejs. Zato vas molim da imate na umu ovo.
Ograničenja prilikom registracije test agenta kreiranog u ConfD-u
Prilikom kreiranja agenta za testiranje preko REST ili NETCONF/YANG API-ja, ne možemo unaprijed znati koji je to tip: Test Agent Appliance ili Test Agent Application. Ovo postaje jasno tek nakon što se agent za testiranje registruje.
Nakon što je agent za testiranje registrovan i postao jedan od ovih konkretnih tipova, nije vam dozvoljeno da ga ponovo registrujete kao drugu vrstu agenta za testiranje. To znači da vam nije dozvoljeno da ga prvo registrujete kao Test Agent Appliance, a zatim da ga ponovo registrujete kao Test Agent Application, ili obrnuto. Ako vam je potreban Test Agent drugog tipa, morat ćete kreirati novog Test Agenta.

Dodatak: Struktura stabla punog YANG modela

U ovom dodatku, odeljak “Legenda” na stranici 81 objašnjava sintaksu strukture stabla modela YANG generisane naredbom pyang -f stablo.
Odjeljak “Struktura stabla modela YANG” na stranici 82 daje izlaz iz te naredbe primijenjene na netrounds-ncc.yang. Dijelovi ovog izlaza se reproduciraju na drugom mjestu u dokumentu.
Legenda

Juniper NETWORKS NETCONF & YANG API softver -Legenda

Juniper NETWORKS NETCONF & YANG API softver -Legenda 1

Struktura stabla modela YANG

Juniper NETWORKS NETCONF & YANG API softver - Stablo modela

Juniper NETWORKS NETCONF & YANG API softver - Stablo modela 1

Juniper NETWORKS NETCONF & YANG API softver - Stablo modela 2

Juniper NETWORKS NETCONF & YANG API softver - Stablo modela 3

Juniper NETWORKS NETCONF & YANG API softver - Model Tree 3 NETWORKS NETCONF & YANG API softver - Model Tree 4

Juniper NETWORKS NETCONF & YANG API softver - Stablo modela 5

Juniper NETWORKS NETCONF & YANG API softver - Stablo modela 6

Juniper NETWORKS NETCONF & YANG API softver - Stablo modela 7

Juniper NETWORKS NETCONF & YANG API softver - Stablo modela 8Juniper NETWORKS NETCONF & YANG API softver - Model Tree Full

Juniper NETWORKS NETCONF & YANG API softver - Model Tree Full 1Juniper NETWORKS NETCONF & YANG API softver - Model Tree Full 2

Juniper NETWORKS NETCONF & YANG API softver - Model Tree Full 3

Juniper NETWORKS NETCONF & YANG API softver - Model Tree Full 4

Juniper NETWORKS NETCONF & YANG API softver - Model Tree Full 5

Juniper NETWORKS NETCONF & YANG API softver - Model Tree Full 6

Juniper NETWORKS NETCONF & YANG API softver - Model Tree Full 7

Juniper Networks, Juniper Networks logo, Juniper i Junos su registrovani zaštitni znakovi Juniper Networks, Inc. u Sjedinjenim Državama i drugim zemljama. Svi ostali zaštitni znaci, uslužni znaci, registrovani znaci ili registrovani uslužni znaci vlasništvo su njihovih odgovarajućih vlasnika. Juniper Networks ne preuzima nikakvu odgovornost za bilo kakve netačnosti u ovom dokumentu. Juniper Networks zadržava pravo da promijeni, modificira, prenese ili na drugi način revidira ovu publikaciju bez prethodne najave. Autorska prava © 2023 Juniper Networks, Inc. Sva prava zadržana.JUNIPER NETWORKS Logo

Dokumenti / Resursi

Juniper NETWORKS NETCONF & YANG API softver [pdf] Korisnički priručnik
NETCONF YANG API softver, YANG API softver, API softver, softver

Reference

Ostavite komentar

Vaša email adresa neće biti objavljena. Obavezna polja su označena *