Používateľská príručka softvéru Juniper NETWORKS NETCONF & YANG API

Účel tohto dokumentu
Táto dokumentácia popisuje, ako integrovať Paragon Active Assurance s orchestrátorom sieťových služieb cez Control Center NETCONF & YANG API. Praktický exampsú uvedené hlavné úlohy vrátane: vytvárania a nasadzovania virtuálnych testovacích agentov, spúšťania testov a monitorov a získavania výsledkov z týchto činností.
V tomto dokumente je v úlohe orchestrátora použitý voľne dostupný klient ncclient Python NETCONF.

dohovorov
V tomto dokumente sa používajú nasledujúce skratky:

Skratka	Význam
CLI	Rozhranie príkazového riadku
EM	Správca prvkov
ES	Chyba druhá
europoslanec	Koncový bod MEG (Maintenance Entity Group) (definícia ITU-T Y.1731) alebo Koncový bod údržby (definícia Cisco)
NFV	Virtualizácia sieťových funkcií
NFVO	Orchestrator virtualizácie sieťových funkcií
NSD	Deskriptor sieťovej služby
RPC	Diaľkové volanie procedúry
SIP	Protokol o začatí relácie
SLA	Dohoda o úrovni služieb
S-VNFM	Špeciálny manažér VNF
VNF	Funkcia virtuálnej siete
vTA	Virtuálny testovací agent

Poznámky k spätnej kompatibilite

Vo verziách 2.35.4/2.36.0 rozhrania NETCONF & YANG API bolo overovanie určitých požiadaviek prísnejšie, aby sa dodržiaval štandard NETCONF. To znamená, že klientsky kód založený na starších verziách tejto príručky môže byť teraz odmietnutý.
Napríkladample, v predchádzajúcom Pythone naprample, nebol poskytnutý žiadny atribút menného priestoru. Priestor názvov je teraz potrebné zadať v požiadavke XML vždy, keď chcete upraviť zdroj ConfD.

Predpoklady a prípravy

Inštalácia ConfD
ConfD (produkt od Tail-f) sa používa ako sprostredkovateľ medzi systémom Paragon Active Assurance a NETCONF. ConfD spája konfiguráciu a prevádzkové údaje Paragon Active Assurance s NETCONF & YANG API.
ConfD by mal byť nainštalovaný spolu so softvérom Control Center, ako je popísané v Inštalačnej príručke.

Overenie spustenia ConfD
Ak chcete overiť, či je ConfD v prevádzke, spustite príkaz
ssh -s @localhost -p 830 netconf
aby ste skontrolovali, či ConfD odpovedá na porte 830. V príkaze je definovaná pri vytvorení užívateľa netconf
v Inštalačnej príručke, časť Inštalácia ConfD. Zadajte heslo definované rovnakým príkazom.
Vo výstupe skontrolujte, či je zahrnutý modul Control Center. Výstup by mal obsahovať nasledujúci riadok:
http://ncc.netrounds.com?module=netrounds-ncc&revízia=2017-06-15

Synchronizácia konfiguračnej databázy s Control Center

Nakoniec musíme aktualizovať konfiguračnú databázu cez NETCONF. Urobíme to tu pomocou knižnice Pythonu s názvom ncclient (NETCONF Client). Úlohu však možno vykonať aj v inom programovacom jazyku, pokiaľ používa protokol NETCONF/YANG.
Úlohou ncclient je pôsobiť ako klient voči serveru ConfD, ktorý je hostiteľom NETCONF/YANG API.

Stojí za zmienku, že ncclient nijako nesúvisí s Control Center (predtým „Netrounds Control Center“), hoci názov náhodou začína na „ncc“.
Tu je návod, ako nainštalovať ncclient:

Stiahnite si softvér z https://github.com/ncclient/ncclient.
Spustite tento príkaz: pip install ncclient

Teraz môžeme vykonať synchronizáciu nasledovne. Pozorne si uvedomte, že to je potrebné vykonať na samostatnom počítači a nie na samotnom serveri Control Center:

#
# POZNÁMKA:
# Tento skript funguje ako klient pre ConfD bežiaci na serveri NCC.
# Na komunikáciu bude používať NETCONF/YANG API.

POZNÁMKA: Tento postup sa tiež vyžaduje vždy, keď boli testovaní agenti nainštalovaní a zaregistrovaní nezávisle od NETCONF. Pozri poznámku v časti „Presview of Test Agent Orchestration“ na strane 17, kde nájdete ďalšie informácie.

Nastavenie viacerých účtov Paragon Active Assurance riadených NETCONF

Kroky nižšie sú potrebné len v prípade, že chcete nastaviť ďalšie účty Paragon Active Assurance, ktoré budú kontrolované pomocou NETCONF, okrem účtu nakonfigurovaného týmto spôsobom v Inštalačnej príručke, časť „Inštalácia ConfD“.
Pre každý takýto účet postupujte takto:

V ovládacom centre sa prihláste do účtu a prejdite na Účet > Povolenia.

Pridať používateľa “confd@netrounds.com“ a udeľte tomuto používateľovi ConfD administrátorské oprávnenie v GUI kliknutím na tlačidlo Pozvať.
Synchronizujte konfiguračnú databázu s Control Center podľa popisu v časti “Synchronizácia konfiguračnej databázy s Control Center” na strane 4.
Teraz by ste mali byť schopní ovládať viacero účtov Paragon Active Assurance s rovnakým používateľom ConfD.

POZNÁMKA: Keď začnete ovládať účet Paragon Active Assurance cez ConfD, NESMIETE v tomto účte vykonávať zmeny prostredníctvom web GUI s ohľadom na všetky funkcie Paragon Active Assurance, ktoré sú „configure“ (pozrite si kapitolu „Podporované funkcie v Paragon Active Assurance“ na strane 9). Ak tak urobíte, dôjde k strate synchronizácie.

Úvod do NETCONF Orchestration API

Koniecview

NFVO alebo servisný orchestrátor tretej strany je zvyčajne komponent, ktorý spúšťa testovacie a monitorovacie relácie pomocou rozhrania API Control Center. Tento orchestrátor tiež získava agregované výsledky meraní z aktivít testovacieho agenta. Výkonnostné KPI môžu získavať systémy riadenia výkonu tretích strán, zatiaľ čo udalosti – po spustení porušením prahových hodnôt nastavených v riadiacom centre – možno odosielať do systémov správy porúch tretích strán.
Aby sme to zhrnuli, nižšie uvedený obrázok ukazuje, ako Paragon Active Assurance interaguje s inými systémami tretích strán v prostredí OSS.

NFVO/Service Orchestrator: Inštruuje manažéra VNF, aby nasadil vTA a nakonfiguroval Paragon Active Assurance do servisného reťazca. Keď je služba aktivovaná, orchestrátor používa API smerom k Riadiacemu centru na spustenie testov aktivácie služby a načítanie výsledkov vyhovujúcich/neúspešných. Ak testy prebehnú úspešne, orchestrátor použije API smerom k Control Center na spustenie aktívneho monitorovania služby. KPI z monitorovania priebežne získava buď orchestrátor alebo samostatná platforma Performance Management.
Riadiace centrum: Nasadzuje, škáluje a ukončuje vTA podľa pokynov NFVO alebo servisného orchestrátora.

Systém riadenia výkonu alebo systém riadenia kvality služieb: Načíta KPI z aktívneho monitorovania cez API Control Center.
Systém správy porúch: Prijíma NETCONF, SNMP alebo e-mailové upozornenia z Control Center, ak sú porušené SLA.

Definície pojmov v Paragon Active Assurance

Testovací agenti: Komponenty, ktoré vykonávajú merania (pre testy aj monitory) v systéme Paragon Active Assurance. Testovací agenti pozostávajú zo softvéru so schopnosťou generovať, prijímať a analyzovať skutočnú sieťovú prevádzku.
Druh testovacieho agenta, o ktorom sa hovorí v tomto dokumente, je virtuálny testovací agent (vTA), funkcia virtuálnej siete (VNF) nasadená na hypervízore. Existujú aj iné typy testovacích agentov.

V Paragon Active Assurance existujú dva základné typy meraní, testy a monitory.
Test: Test pozostáva z jedného alebo niekoľkých krokov, z ktorých každý má špecifikované, konečné trvanie. Kroky sa vykonávajú postupne. Každý krok môže znamenať spustenie viacerých úloh súčasne.

Monitor: Monitor nemá špecifikovanú dobu trvania, ale vykonáva sa na neurčito. Podobne ako krok v teste môže monitor vykonávať viacero súbežných úloh.
Šablóna: Keď je Paragon Active Assurance riadený orchestrátorom, testy a monitory sa vždy vykonávajú pomocou šablón, v ktorých je definovaný test alebo monitor. Nastavenia parametrov možno odovzdať ako vstupy do šablóny za behu.

Pracovný postup pre automatizáciu
Čas návrhu

V čase návrhu pripravíte merania vytvorením šablón pre testy a monitory v programe Paragon Active Assurance. Ako to urobiť, je uvedené v kapitole „Testovacie a monitorovacie šablóny“ na strane 15.

Runtime
Počas behu nastavujete svoje zariadenia a vykonávate skutočné merania.

Koniecview zo všetkých exampuvedené údaje sa nachádzajú v kapitole „Prampčasti Controlling Paragon Active Assurance cez NETCONF & YANG API” na strane 15.
Ako nasadiť a nakonfigurovať testovacích agentov je vysvetlené v kapitole „Pramples: Testovací agenti“ na strane 16.

Ako importovať položky inventára, ako je TWAMP reflektorov a IPTV kanálov je popísaná v kapitole „Pramples: Položky zásob“ na strane 29.
Ako nakonfigurovať alarmy je vysvetlené v kapitole „Pramples: Alarmy“ na strane 35.

Ako spustiť testy a monitory spustením šablón Paragon Active Assurance cez NETCONF je popísané v kapitolách „Pr.amples: Tests“ na strane 43 a „Pramples: Monitory“ na strane 54.

Podporované funkcie v Paragon Active Assurance

Všetky typy testov a monitorov v Paragon Active Assurance je možné vytvoriť a spustiť pomocou šablón. Ako to urobiť, je uvedené v pomocníkovi v aplikácii v časti „Testy a monitory“ > „Vytváranie šablón“.

Vytváranie účtov Paragon Active Assurance momentálne nie je podporované; pre používateľa však bude nastavený jeden alebo niekoľko preddefinovaných účtov.
Nižšie uvedené tabuľky podrobne uvádzajú, aké funkcie v Paragon Active Assurance sú dostupné v tomto vydaní a ako sú tieto funkcie zastúpené v YANG.

Vysvetlenie konštruktov YANG

Pre pohodlie sú tu uvedené definície konštruktov YANG, na ktoré sa odkazuje v tabuľke vlastností.

Config (config=true): Konfiguračné údaje potrebné na transformáciu systému z jedného stavu do druhého.
Stav (config=false): Stavové údaje: dodatočné údaje o systéme, ktoré nie sú konfiguračnými údajmi, ako sú stavové informácie len na čítanie a zhromaždené štatistiky.
RPC: Vzdialené volanie procedúry, ako sa používa v rámci protokolu NETCONF.
Oznámenie: Oznámenia o udalostiach odoslané zo servera NETCONF klientovi NETCONF.

Tabuľky funkcií Paragon Active Assurance dostupných pre organizáciu
Zdroj: Monitorovanie
YANG cesta:/accounts/account/monitors

Funkcia	Podvlastnosť	Konštrukcia YANG
Vytvoriť/upraviť/vymazať monitor	Na základe šablóny monitora	Konfig
Monitor štart/stop	–	Konfig
Šablóny monitora	Zoznam existujúcich šablón monitorov so vstupmi	štátu
upozornenia NETCONF	Stav alarmu sa zmenil	Oznámenie
Sledujte výsledky	Počítadlo SLA/ES pre najvyššiu úroveň (%) Počítadlo SLA/ES pre úroveň úlohy (%)	štátu

Na rozdiel od testov (porovnaj Zdroj: Testy nižšie) sa monitory nespúšťajú pomocou RPC, ale skôr potvrdením konfigurácie monitora.
Zdroj: Testy
YANG cesta: /accounts/account/tests

Funkcia	Podvlastnosť	Konštrukcia YANG
Spustiť test	Na základe testovacej šablóny	RPC
Spravujte testy	Vypísať testy so stavom	štátu
Testovacie šablóny	Zoznam existujúcich testovacích šablón so vstupmi	štátu
upozornenia NETCONF	Stav testu sa zmenil	Oznámenie
Výsledky testov	Získajte stav testovacieho kroku (úspešný, neúspešný, chyba, ...)	štátu

Zdroj: Testovací agenti
YANG cesty:

/accounts/account/test-agents (Config)
/accounts/account/registered-test-agents (štát)

Testovací agenti pod /accounts/account/test-agents sú tí, ktorí sú nakonfigurovaní v účte. Iba týchto testovacích agentov môže orchestrátor nakonfigurovať a použiť v testoch a monitoroch cez NETCONF.
Po nakonfigurovaní testovacieho agenta a jeho registrácii do účtu sa testovací agent objaví v /accounts/account/registered-test-agents. Všetkých registrovaných testovacích agentov môžete nájsť pomocou príkazu „get“ v NETCONF (porovnaj kapitolu Príkladamples: Testovacie činidlá).
V časti /accounts/account/registered-test-agents môžete nájsť aj testovacích agentov, ktorí ešte nie sú nakonfigurovaní. Každý takýto testovací agent musí byť pred použitím nakonfigurovaný.
V scenári orchestrácie sa vo všeobecnosti odporúča, aby ste celú konfiguráciu svojho účtu Paragon Active Assurance vykonali prostredníctvom NETCONF. To zaisťuje, že testovacie a registrované testovacie agenty sa nebudú líšiť.

Funkcia	Podvlastnosť	Konštrukcia YANG
Vopred vytvorte testovacieho agenta na serveri	–	Konfig
Konfigurácia testovacieho agenta offline	(Ovládacie centrum odošle konfiguráciu do testovacieho agenta keď to príde online)	Konfig
Použite existujúcich/externe nakonfigurovaných testovacích agentov	Použitie v teste/monitorovaní	Konfig
	Nakonfigurujte rozhrania	Konfig
	Získajte stav	štátu
Konfigurácia testovacieho agenta (iba testovacie zariadenie)	Nakonfigurujte NTP	Konfig
	Konfigurácia mostov	Konfig
	Nakonfigurujte rozhrania VLAN	Konfig
	Nakonfigurujte kľúče SSH	Konfig
	IPv6	Konfig
Utils	Reštartujte	RPC
	Aktualizovať	RPC
upozornenia NETCONF	Stav online sa zmenil	Oznámenie
Stav	Získajte stav systému (čas prevádzky, využitie pamäte, priemerná záťaž, verzia)	štátu

Zdroj: Inventár
Cesta YANG: /accounts/account/twamp- reflektory

Podporované schopnosti NETCONF

Nižšie uvedená tabuľka poukazuje na IETF RFC popisujúce možnosti NETCONF používané na účely orchestrácie Paragon Active Assurance.

ietf-netconf.yang
IETF RFC 6241, Network Configuration Protocol (NETCONF), https://tools.ietf.org/html/rfc6241
Jedinou podporovanou metódou spracovania chýb je rollback-on-error.
Jediný podporovaný dátový sklad je zapisovateľný.
ietf-netconf-notifications.yang
IETF RFC 5277, upozornenia na udalosti NETCONF, https://tools.ietf.org/html/rfc5277

Testovacie a monitorovacie šablóny
Šablóny pre typy testov a monitorov je potrebné nastaviť manuálne prostredníctvom používateľského rozhrania Paragon Active Assurance. Ako to urobiť, je uvedené v pomocníkovi v aplikácii v časti „Testy a monitory“ > „Vytváranie šablón“.

Exampčasti Controlling Paragon Active Assurance cez NETCONF & YANG API

V nasledujúcich kapitolách sa predpokladá, že vhodné testovacie a monitorovacie šablóny boli definované podľa pokynov uvedených v kapitole „Testovacie a monitorovacie šablóny“ na strane 15.

Nástroje používané v pramples
Všetky exampsúbory v nasledujúcich kapitolách boli vytvorené pomocou nasledujúcich voľne dostupných nástrojov:

Pang: Používa sa na vizualizáciu a prehliadanie modelov YANG.
Dostupné na https://github.com/mbj4668/pyang (klonujte z git a spustite python setup.py install).
Klient Python NETCONF „ncclient“: Používa sa na komunikáciu s Control Center pomocou NETCONF.

Dostupné na https://github.com/ncclient/ncclient (spustite pip install ncclient).
Dátový model netrounds-ncc.yang nájdete v /opt/netrounds-confd po inštalácii ConfD podľa inštalačnej príručky).

Koniecview kľúčových úloh vykonaných

(Niektoré ďalšie úlohy sú tiež uvedené ako príklad nižšie.)

“Vytvorenie a nasadenie nového testovacieho agenta” na strane 16
“Vytvorenie inventárnych položiek (napr. reflektorov)” na strane 29
“Nastavenie šablón alarmov a kam posielať alarmy” na strane 35

“Vytvorenie a spustenie testu” na strane 45
“Načítanie výsledkov testu” na strane 50
„Spustenie monitora (zahŕňa nastavenie alarmov)“ na stránke 60
“Získanie stavu SLA pre monitor” na strane 67
„Pracovať s tags“Na strane 71

Examples: Testovacie prostriedky

Koniecview organizácie Test Agent Orchestra
Testovací agenti v Paragon Active Assurance sa v kontexte orchestrácie považujú za „konfiguráciu“. To znamená, že vytváranie, riadenie a odstraňovanie testovacích agentov by sa malo vykonávať prostredníctvom orchestrátora a NETCONF, a nie cez rozhranie Paragon Active Assurance GUI.
DÔLEŽITÉ: Ak testovacieho agenta nainštaluje technik a zaregistruje ho do Control Center bez toho, aby bol najprv vytvorený cez NETCONF & YANG API, testovací agent nebude existovať v konfiguračnej databáze a systém sa prestane synchronizovať. Aby sa ConfD v tomto prípade dozvedel o testovacom agentovi, bude potrebné vykonať novú synchronizáciu s Control Center, ako je podrobne uvedené v časti „Synchronizácia konfiguračnej databázy s Control Center“ na strane 4.

Organizácia virtuálnych testovacích agentov (vTA) by sa preto mala radšej vykonať v nasledujúcich krokoch:

Vytvorte virtuálneho testovacieho agenta vrátane konfigurácie jeho rozhrania pomocou rozhrania NETCONF & YANG do Control Center. Meno testovacieho agenta bude jeho jedinečným kľúčom.
Nasaďte vTA na virtualizačnú platformu. Postupujte podľa pokynov v online pomocníkovi v časti Testovací agenti > Inštalácia. Základná konfigurácia rozhrania, ktorá umožňuje vTA pripojiť sa k Riadiacemu centru, ako aj poverenia na autentifikáciu, sa poskytuje do vTA pomocou používateľských údajov cloud-init.
Po zavedení vTA sa automaticky pripojí k Control Center pomocou šifrovaného pripojenia OpenVPN. Odošle sa upozornenie NETCONF, pretože hodnota parametra test-agent-statuschange vTA sa teraz zmenila na „online“.
POZNÁMKA: Keďže názov vTA je jeho identifikátorom v Control Center, tento názov musí byť rovnaký ako ten, ktorý je definovaný v Control Center v “kroku 1” na strane 17.
Keď sa vTA pripojí a overí v Control Center, konfigurácia rozhrania sa odošle do vTA. Toto je konfigurácia rozhrania poskytnutá v “kroku 1” na strane 17, keď bola vTA vytvorená v Control Center.

Keď vTA splní svoj účel, odstráňte vTA.

Vytvorenie a nasadenie nového testovacieho agenta

Najprv musíme vytvoriť testovacieho agenta pomocou rozhrania NETCONF & YANG do Control Center. Keď je testovací agent vytvorený týmto spôsobom, nie je potrebná žiadna synchronizácia s Control Center.
Model YANG pre testovaciu látku je znázornený nižšie. Získava sa ako výstup z príkazu
pyang -f strom netrounds-ncc.yang
Úplný model YANG je uvedený v časti “Príloha: Stromová štruktúra úplného modelu YANG” na strane 81, ktorá obsahuje aj legendu vysvetľujúcu konvencie použité v tomto a ďalších ilustráciách modelu YANG v tomto dokumente.

Pokračujeme v nasledujúcich krokoch, ktoré sú podrobne uvedené nižšie:

Na začiatku „demo“ účtu Paragon Active Assurance nemá vo svojom inventári žiadnych testovacích agentov.
Testovací agent s názvom „vta1“ sa vytvorí pomocou ncclient. Pri tejto stage, žiadny skutočný testovací agent ešte neexistuje (to znamená, že ešte nebol spustený).
Testovací agent je nasadený v OpenStack. (Nasadenie na tejto platforme je tu vybrané ako jedna z možností.)

Testovací agent sa pripojí k „ukážke“ účtu Control Center a teraz je pripravený na použitie.
Krok 1: Na začiatku nie sú v účte „demo“ žiadni testovací agenti. Pozrite si snímku obrazovky nižšie z grafického používateľského rozhrania Control Center.Krok 2: Testovací agent sa vytvorí v riadiacom centre pomocou klienta Python NETCONF „ncclient“. Nižšie je uvedený kód ncclient na vytvorenie testovacieho agenta s jedným fyzickým rozhraním s adresou DHCP:

importovať argparse
od manažéra importu ncclient
parser = argparse.ArgumentParser(description='Test vytváranie testovacieho agenta')
parser.add_argument('–host', help='Názov hostiteľa, kde sa nachádza ConfD', povinné=True)
parser.add_argument('–port', help='Port na pripojenie k ConfD', povinné=True)
parser.add_argument('–username', help='Používateľské meno na pripojenie k ConfD', povinné=True)
parser.add_argument('–password', help='Heslo k účtu ConfD', povinné=True)
parser.add_argument('–netrounds-account', help='Krátky názov účtu NCC', povinné=True)
parser.add_argument('–názov-testovacieho-agenta', help='Názov testovacieho agenta', povinné=True)
args = parser.parse_args()
s manager.connect(host=args.host, port=args.port, username=args.username,
password=args.password, hostkey_verify=False) ako m:
# Vytvorte testovacieho agenta v Control Center
xml = """

)print m.edit_config(target='running', config=xml)

POZNÁMKA: Kód predchádzajúci s manager.connect(…) je vynechaný z nasledujúceho príkladuample útržky kódu.
Server NTP je nakonfigurovaný na eth0 a eth0 je tiež rozhranie pre správu (to znamená rozhranie, ktoré sa pripája k Control Center).
Aplikácia testovacieho agenta momentálne neumožňuje konfiguráciu rozhraní. Z tohto dôvodu je od verzie 2.34.0 možné vynechať konfiguráciu rozhrania v schéme YANG. Príslušný XML je preto v tomto prípade radikálne zjednodušený:Po vytvorení testovacieho agenta existuje v konfiguračnej databáze a v riadiacom centre. Pozrite si snímku obrazovky nižšie s inventárom testovacieho agenta, ktorý zobrazuje testovacieho agenta „vta1“:

Krok 3: Teraz je čas nasadiť testovacieho agenta „vta1“ v OpenStack.
Testovací agent použije používateľské údaje cloud-init na získanie informácií o tom, ako sa pripojiť k Control Center. Konkrétne ide o text používateľských údajov file má nasledujúci obsah (Všimnite si, že musia byť prítomné riadky #cloud-config a netrounds_test_agent a že zostávajúce riadky musia byť odsadené):

Ďalšie informácie nájdete v dokumente How to Deploy Virtual Test Agents in OpenStack.
Po nasadení testovacieho agenta a pripojení k riadiacemu centru sa konfigurácia presunie z riadiaceho centra do testovacieho agenta.

Krok 4: Testovací agent je teraz online v Control Center a získal svoju konfiguráciu. Testovací agent je pripravený na použitie pri testoch a monitorovaní. Pozrite si tieto sekcie:

“Spustenie testu” na strane 45
„Spustenie monitora“ na stránke 60

Uvedenie testovacích agentov na vašom účte Paragon Active Assurance
Nižšie je example ncclient Python kód na uvedenie testovacích agentov v účte Paragon Active Assurance:

Spustenie tohto kódu poskytuje výstup podobný tomu nižšie:

Odstránenie testovacieho agenta
Po dokončení testu môže byť v niektorých prípadoch relevantné odstrániť testovacieho agenta.
Nižšie je uvedený útržok kódu, ktorý ukazuje, ako to urobiť pomocou ncclient:

Upozornenia NETCONF
Nižšie uvádzame jednoduchý exampskript na počúvanie všetkých prichádzajúcich upozornení NETCONF z Control Center. Tieto upozornenia sa odosielajú vždy, keď dôjde k určitým udalostiam, ako je napríklad prechod testovacieho agenta do režimu offline alebo ukončenie testu iniciovaného používateľom. Na základe informácií uvedených v upozorneniach môžu používatelia priradiť automatické následné akcie v orchestrátore.

Po vykonaní vyššie uvedeného skriptu NC klient zobrazí prijaté oznámenie v štruktúrovanom XML. Pozri exampvýstup nižšie, ktorý ukazuje, že testovací agent sa neočakávane prepne do režimu offline.

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

Examples: Položky zásob

Vytváranie (importovanie) a správa položiek zásob, ako je TWAMP reflektory a Y.1731 MEP sa vykonáva podobným spôsobom ako v prípade testovacích agentov. Nižšie je uvedený kód XML a NETCONF na definovanie takýchto entít v Paragon Active Assurance prostredníctvom NETCONF & YANG API a na získanie zoznamov definovaných položiek.

Vytvorenie TWAMP Reflektor

Vytvorenie poslanca Y.1731

Vytvorenie kanála IPTV

Vytvorenie hostiteľa Ping

Vytvorenie SIP účtu

Získavanie položiek zásob
Nižšie je uvedený Python kód na získanie všetkých položiek zásob definovaných v účte. (Všetky typy inventárnych položiek sú tu načítané naraz, aby sa predišlo opakovaniu v dokumente. Prirodzene, akúkoľvek podmnožinu inventárnych položiek možno načítať vynechaním niektorých riadkov v účte nižšie.)

Spustenie tohto kódu poskytuje výstup podobný tomu nižšie:

Examples: Alarmy

Šablóny alarmov a súvisiace položky (SNMP manažéri, zoznamy e-mailov alarmov) sa vytvárajú a spravujú podobným spôsobom ako položky inventára. Táto kapitola obsahuje kód XML a NETCONF na definovanie takýchto entít v Paragon Active Assurance prostredníctvom NETCONF & YANG API a na získanie zoznamov definovaných položiek.
Zoznamy alarmových e-mailov
Vytvorenie zoznamu poplachových e-mailov

Obnovenie všetkých zoznamov e-mailov s alarmom

Správcovia SNMP
Vytvorenie správcu SNMP

Obnovenie všetkých správcov SNMP

Šablóny alarmov
Vytvorenie šablóny alarmu

Obnovenie všetkých šablón alarmov

Examples: kľúče SSH

Verejné kľúče SSH môžete pridať do testovacieho agenta prostredníctvom rozhrania NETCONF & YANG API. Pomocou zodpovedajúceho súkromného kľúča sa potom môžete prihlásiť do testovacieho agenta cez SSH.
Úplný zoznam dostupných operácií s kľúčmi SSH je nasledujúci:

Pridajte kľúč SSH
Upravte kľúč SSH
Skontrolujte kľúč SSH
Zoznam kľúčov SSH
Odstráňte kľúč SSH.
Nižšie sú uvedené príklady operácií pridávania a odstraňovania.

Pridanie kľúča SSH

Tu je návod, ako vytvoriť nový kľúč SSH.

Softvér Juniper NETWORKS NETCONF & YANG API – kľúč

Odstránenie kľúča SSH
Ak chcete odstrániť kľúč SSH, použite nasledujúci príkaz:

Examples: Testy

Tu sa predpokladá, že testovacích agentov (toľko, koľko je potrebných pre testy) bolo vytvorených podľa časti „Vytvorenie a nasadenie nového testovacieho agenta“ na strane 17.
Modelové cesty YANG pre testy

Položka	Cesta modelu YANG: /accounts/account/tests …
testy	/.
test[id]	/test
id	/test/id
meno	/test/name
stav	/test/status
Doba spustenia	/test/start-time
čas ukončenia	/test/end-time
správa-url	/Protokol o skúške-url
kroky	/test/kroky
krok[id]	/test/steps/step
meno	/test/steps/step/name
id	/test/steps/step/id
Doba spustenia	/test/steps/step/start-time
čas ukončenia	/test/steps/step/end-time
stav	/test/steps/step/status
stavová správa	/test/steps/step/status-message
šablóny	/šablóny
šablóna [meno]	/template/template
meno	/templates/template/name
popis	/template/template/description
parametre	/template/template/parameters
parameter [kľúč]	/templates/template/parameters/parameter
kľúč	/templates/template/parameters/parameter/key
typu	/templates/template/parameters/parameter/type

Predpoklady pre skúšobnú organizáciu

Ak chcete spustiť test cez NETCONF pomocou NC klienta, je potrebné najprv vytvoriť testovaciu šablónu pomocou grafického používateľského rozhrania Control Center, ako je podrobne uvedené v pomocníkovi v aplikácii v časti „Testy a monitory“ > „Vytváranie šablón“. Všetky polia špecifikované v tejto šablóne ako „Vstup šablóny“ sa budú vyžadovať ako parametre v XML pri organizovaní spustenia testovacej šablóny.

Spustenie testov v Paragon Active Assurance sa v kontexte orchestrácie považuje za „stav“. Stavové údaje sú nezapisovateľné údaje, ktoré nie sú uložené v konfiguračnej databáze, na rozdiel od konfiguračných údajov uvedených v časti „Overview of Test Agent Orchestration“ na strane 17. V podstate to znamená, že zmeny testov alebo šablón v GUI Control Center nespôsobia žiadne problémy súvisiace so synchronizáciou medzi Control Center a konfiguračnou databázou.
Ak chcete získať správu -URL priamo v testovacích správach, musíte sa uistiť, že Control Center URL je správne nakonfigurovaný. Toto sa robí v file /opt/netrounds-confd/settings.py. Štandardne sa názov hostiteľa Control Center získava pomocou socket.gethostname(): pozri nižšie. Ak to neprinesie správny výsledok, musíte nastaviť názov hostiteľa (alebo celý URL) ručne v tomto file.

# URL ovládacieho centra bez koncovej lomky.
# Toto je naprample použité v testovacej správe-url.
HOSTNAME = socket.gethostname()
NETROUNDS_URL = 'https://%s' % NÁZOV HOSTITEĽA
Spustenie testu
Ako je popísané v časti „Vytvorenie a nasadenie nového testovacieho agenta“ na strane 17, spustite príkaz pang -f tree netrounds-ncc.yang
z adresára /opt/netrounds-confd/ na výstup modelu YANG. V tomto modeli RPC na spustenie testu pomocou NC klienta vyzerá takto:

Vysvetlenia nájdete v časti „Legenda“ na strane 81 v prílohe.

Nasledujúce kroky sú zobrazené nižšie:

Testovací agenti boli zaregistrovaní do účtu Paragon Active Assurance, ale ešte neboli spustené žiadne testy.
Požadované vstupné parametre sú identifikované v testovacej šablóne, ktorá sa spustí.

Spustí sa 60-sekundový test HTTP pomocou ncclient.

Krok 1: Na začiatku neboli v účte Paragon Active Assurance spustené žiadne testy. Pozrite si snímku obrazovky nižšie z grafického používateľského rozhrania Control Center.
Krok 2: Šablóna, ktorú použijeme na spustenie testu v tomto príkladeample je testovacia šablóna HTTP. Má dve povinné vstupné polia ( Klienti a URL), ktoré sme ako také špecifikovali pri vytváraní šablóny v GUI Control Center.

Tieto parametre (okrem iného) zadefinujeme v XML konfigurácii, ktorú do konfiguračnej databázy komunikuje náš NETCONF manažér (ncklient).
Krok 3: Test HTTP sa spustí pomocou ncclient.
Nižšie je exampkód súboru, kde sú špecifikované požadované konfiguračné informácie a parametre pre šablónu testu HTTP. Podrobnosti sa môžu líšiť v závislosti od toho, ako bola šablóna vytvorená.
Pre každý parameter, atribút je potrebné dodať. Kľúč je identický s parametrom
Názov premennej v Control Center. Názvy premenných môžete skontrolovať takto:

Kliknite na Testy na bočnom paneli a vyberte Nová testovacia sekvencia.

Kliknite na položku Moje šablóny.
Kliknite na odkaz Upraviť pod šablónou, ktorá vás zaujíma.
Kliknite na tlačidlo Upraviť vstup v pravom hornom rohu.

V našom bývalomample a predvolene sú názvy premenných jednoducho malými verziami zobrazovaných názvov zobrazených v Control Center („url“vs.”URL", atď.). V grafickom rozhraní ovládacieho centra však môžete premenné premenovať na čokoľvek.
Každý parameter musí mať okrem kľúča špecifikovaný aj svoj typ: naprample, pre URL.
Upozorňujeme, že musíte znovaview kompletný model YANG, aby ste získali úplné informácie o typoch. Pre rozhrania testovacieho agenta má typ zložitejšiu štruktúru, ako je uvedené nižšie v kóde nižšie.

Teraz môžeme spustiť skript pomocou ncclient. Za predpokladu, že je všetko správne, test sa spustí a jeho vykonanie sa zobrazí v Control Center:Ak sa test úspešne spustí, Control Center odpovie ID testu. V tomto example, ID testu je 3:ID testu nájdete aj v URL na test v grafickom rozhraní Control Center. V tomto example, to URL je https://host/demo/testing/3/.
Načítanie výsledkov testov
Najjednoduchší spôsob, ako získať výsledky testu, je ukázať na ID testu.
Nižšie je uvedený kód Pythonu na získanie výsledkov z vyššie uvedeného testu HTTP s ID = 3:
s manažérom. Pripojiť(host=args.host, port=args.port, username=args.username,password=args.password, hostkey_verify=False) ako m:

Výstup bude vyzerať asi takto:

Export a import testovacích šablón
Testovacie šablóny je možné exportovať vo formáte JSON a opätovne ich importovať v tomto formáte do Control Center. Je to užitočné, ak chcete použiť testovacie šablóny v inej inštalácii Control Center. (Počiatočné vytvorenie šablón je najlepšie zvládnuť cez grafické používateľské rozhranie Control Center.)
Nižšie je uvedený kód na vykonanie exportu a importu.
Exportovanie testovacích šablón

# Získajte konfiguráciu json z odpovede
root = ET.fromstring(response._raw)
json_config = root[0].text
vytlačiť súbor json_config
Šablóna je obsiahnutá v objekte json_config.
Importovanie testovacích šablón
Objekt konfigurácie JSON, ktorý obsahuje testovacie šablóny, je možné znova importovať do ovládacieho centra nasledovne.

Examples: Monitory

Táto časť predpokladá, že testovacích agentov (toľko, koľko ich vyžadujú monitory) bolo vytvorených podľa časti “Vytvorenie a nasadenie nového testovacieho agenta” na strane 17.
Modelové cesty YANG pre monitory

Položka	Cesta modelu YANG: /accounts/account/monitors …
monitory	/.
monitor[meno]	/monitor
meno	/monitor/meno
popis	/monitor/popis
začala	/monitorovať/spustené
šablóna	/monitor/šablóna
alarm-configs	/monitor/alarm-configs
Položka	Cesta modelu YANG: /accounts/account/monitors/monitor/alarm-configs …
alarm-config[identifikátor]	/alarm-config
identifikátor	/alarm-config/identifier
šablóna	/alarm-config/template
email	/alarm-config/email
snmp	/alarm-config/snmp
thr-es-kritické	/alarm-config/thr-es-critical
thr-es-critical-clear	/alarm-config/thr-es-critical-clear
thr-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-varovanie	/alarm-config/thr-es-warning
thr-es-warning-clear	/alarm-config/thr-es-warning-clear
no-data-severity	/alarm-config/no-data-severity
no-data-timeout	/alarm-config/no-data-timeout
akcie	/alarm-config/action
veľkosť okna	/alarm-config/window-size
interval	/alarm-config/interval
odoslať iba raz	/alarm-config/send-only-once
snmp-trap-per-stream	/alarm-config/snmp-trap-per-stream
Položka	Cesta modelu YANG: /accounts/account/monitors …
parametre	/monitor/parametre
Položka	Cesta modelu YANG: /accounts/account/monitors/monitor/parameters …
parameter [kľúč]	/parameter
kľúč	/parameter/kľúč
(typ hodnoty)	/parameter
(celé číslo)	/parameter
celé číslo	/parameter/celé číslo
:(plavák)	/parameter
plávať	/parameter/float
:(reťazec)	/parameter
Položka	Cesta modelu YANG: /accounts/account/monitors/monitor/parameters …
reťazec	/parameter/reťazec
(rozhrania testovacieho agenta)	/parameter
rozhrania testovacieho agenta	/parameter/test-agent-interfaces
test-agent-interface[“1” na strane 58	/parameter/test-agent-interfaces/
účtu	/parameter/test-agent-interfaces/test-agent-interface/account
testovací agent	/parameter/test-agent-interfaces/test-agent-interface/test-agent
rozhranie	/parameter/rozhrania-testovacieho-agenta/rozhranie-testovacieho-agenta/rozhranie
ip-verzia	/parameter/test-agent-interfaces/test-agent-interface/ip-version
:( twamp- reflektory)	/parameter
twamp- reflektory	/parameter/twamp- reflektory
twamp-reflektor[meno]	/parameter/twamp-reflektory/twamp- reflektor
meno	/parameter/twamp-reflektory/twamp-reflektor/meno
:(y1731-meps)	/parameter
y1731-meps	/parameter/y1731-meps
y1731-mep[meno]	/parameter/y1731-meps/y1731-mep
meno	/parameter/y1731-meps/y1731-mep/name
(sip-accounts)	/parameter
sip-účty	/parameter/sip-accounts
sip-account[“2” na strane 58]	/parameter/sip-accounts/sip-account
účtu	/parameter/sip-accounts/sip-account/account
testovací agent	/parameter/sip-accounts/sip-account/test-agent
rozhranie	/parameter/sip-accounts/sip-account/interface
sip-adresa	/parameter/sip-accounts/sip-account/sip-address
:(iptv-kanály)	/parameter
iptv-kanály	/parameter/iptv-channels
iptv-channel[meno]	/parameter/iptv-channels/iptv-channel
meno	/parameter/iptv-channels/iptv-channel/name

rozhranie testovacieho agenta účtu
účet test-agent rozhranie sip-address

Položka	Cesta modelu YANG: /accounts/account/monitors …
stav	/monitor/stav
posledných - 15 minút	/monitor/stav/poslednych-15-minut
stav	/monitor/stav/poslednych-15-minut/stav
stav-hodnota	/monitor/stav/poslednych-15-minut/stav-hodnota
posledná hodina	/monitor/stav/posledná hodina
stav	/monitor/status/last-hour/status
stav-hodnota	/monitor/status/last-hour/status-value
posledných 24 hodín	/monitor/stav/poslednych-24-hod
stav	/monitor/status/last-24-hours/status
stav-hodnota	/monitor/status/last-24-hours/status-value
šablóny	/šablóny
šablóna [meno]	/template/template
meno	/templates/template/name
popis	/template/template/description
parametre	/template/template/parameters
parameter [kľúč]	/templates/template/parameters/parameter
kľúč	/templates/template/parameters/parameter/key
typu	/templates/template/parameters/parameter/type

Predpoklady pre Monitor Orchestration
Pred spustením monitora cez NETCONF pomocou ncclient si musíte vytvoriť šablónu monitora v grafickom rozhraní Control Center, ako je vysvetlené v pomocníkovi v aplikácii v časti „Testy a monitory“ > „Vytváranie šablón“. Všetky polia špecifikované ako „Vstup šablóny“ v tejto šablóne sa budú vyžadovať ako parametre v XML pri organizovaní inicializácie šablóny.
Získanie vstupných parametrov zo šablón monitora
Nižšie sú zobrazené dve šablóny. Prvý je na monitorovanie UDP medzi dvoma rozhraniami testovacieho agenta a druhý je pre HTTP pomocou jediného rozhrania testovacieho agenta.
Ak chcete zistiť vstupné parametre šablóny, kliknite na políčko predstavujúce šablónu. Pre šablónu HTTP môžu parametre vyzerať takto:

Tieto parametre musíme definovať v ďalšom kroku pri spustení monitora.
Spustenie monitora
Pomocou testovacích agentov, ktoré sme definovali a nasadili v časti „Vytvorenie a nasadenie nového testovacieho agenta“ na strane 17, môžeme spustiť monitor zo šablóny „HTTP“, ako je uvedené nižšie.
Pre každý parameter, atribút je potrebné dodať. Kľúč je identický s názvom premennej parametra v Control Center. Názvy premenných môžete skontrolovať takto:

Kliknite na položku Monitorovanie na bočnom paneli a vyberte položku Nový monitor.

Kliknite na položku Moje šablóny.
Kliknite na odkaz Upraviť pod šablónou, ktorá vás zaujíma.
Kliknite na tlačidlo Upraviť vstup v pravom hornom rohu.

V našom bývalomample a predvolene sú názvy premenných jednoducho malými verziami zobrazovaných názvov zobrazených v Control Center („url“vs.”URL", atď.). V grafickom rozhraní ovládacieho centra však môžete premenné premenovať na čokoľvek.
Každý parameter musí mať okrem kľúča špecifikovaný aj svoj typ: naprample, pre URL. Upozorňujeme, že úplné informácie o type parametra nájdete v modeli YANG. Pre rozhrania testovacieho agenta má typ zložitejšiu štruktúru, ako je uvedené v kóde nižšie.
V exampV nasledujúcom texte nie je k monitoru priradený žiadny alarm. Naprampak ide o alarmy, prejdite na časť „Spustenie monitora s alarmom“ na strane 62.

Spustenie monitora s alarmom
Ak chcete priradiť alarm k monitoru, môžete buď ukázať na šablónu alarmu, ktorá bola definovaná, alebo môžete pri vytváraní monitora zadať celú konfiguráciu alarmu. Dáme jednu example každého prístupu nižšie.
Nastavenie alarmu monitora nasmerovaním na šablónu alarmu
Aby ste mohli použiť šablónu alarmu, musíte poznať jej ID. Na tento účel najskôr získajte všetky šablóny alarmov, ako je popísané v časti „Získanie všetkých šablón alarmov“ na strane 39, a poznačte si názov príslušnej šablóny. Potom môžete použiť túto šablónu takto:

Nastavenie alarmu monitora jeho priamou konfiguráciouy
Prípadne môžete nastaviť alarm pre monitor zadaním celej jeho konfigurácie pri vytváraní monitora bez odkazu na šablónu alarmu. Toto sa vykonáva tak, ako je uvedené v nasledujúcom príkladeample.

Načítavanie bežiacich monitorov
Ak chcete získať všetky aktuálne spustené monitory, spustite tento skript:
s manažérom. connect(host=args.host, port=args.port, username=args. user name, password=args.password, hostkey_verify=False) as m:

Výstupom je zoznam všetkých spustených monitorov, ako je uvedené nižšie:

Získanie stavu SLA pre monitor
Tu je návod, ako získať stav SLA pre monitor. V tomto example, získavame stav SLA pre monitor „Kvalita siete“ pre tri časové intervaly: posledných 15 minút, poslednú hodinu a posledných 24 hodín.

Výstup bude vyzerať asi takto:

Upozornenia NETCONF
Oznámenia NETCONF pre monitory sú spúšťané porušením SLA. K tomu dochádza, keď SLA pre monitor klesne pod prah SLA („Dobré“ alebo „Prijateľné“) v rámci daného časového okna, štandardne posledných 15 minút. Treba poznamenať, že upozornenia na porušenie SLA sa objavia rýchlo, keď je služba ovplyvnená problémom, zatiaľ čo stav SLA sa vráti na „Dobrý“ až po 15 minútach, a to iba vtedy, ak nedôjde k ďalšiemu porušeniu.
Časové okno je možné zmeniť úpravou nastavenia SLA_STATUS_WINDOW (hodnota v sekundách) v /etc/netrounds/netrounds.conf.
Export a import šablón monitora
Robí sa to presne rovnakým spôsobom ako v prípade testovacích šablón; porovnajte časť “Export a import testovacích šablón” na strane 52. Útržky kódu uvedené nižšie ilustrujú, ako exportovať a importovať šablóny pre monitory.
Exportovanie šablón monitora

Importovanie šablón monitora

Používanie Tags

Tags definované v Paragon Active Assurance možno použiť na:

monitory
šablóny monitorov
Testovací agenti
TWAMP reflektory
Ping hostitelia.
Napríkladample, môžeš tag monitor s tým istým tag ako podmnožinu testovacích agentov, ktorí budú spúšťať monitor. Táto funkcia je obzvlášť užitočná, ak máte definovaný veľký počet monitorov a šablón.

Ak ste nastavili alarm s SNMP trap pre monitor, potom budú SNMP trapy priradené rovnako tags ako monitor, ak existuje.
Vytváranie Tags
Nižšie ukážeme, ako vytvoriť a tag s názvom a farbou podľa definície XMLtag> spodná stavba.

Priradenie a Tag
Ak chcete priradiť a tag k zdroju, pridáte ho ako novýtag> prvok podtags> prvok pre daný zdroj.
Tu je návod, ako priradiť a tag pre testovacieho agenta:

Ak chcete priradiť a tag do TWAMP reflektor, postupujte takto:

Priradenie a tag k monitoru sa postupuje podobne:

Prípadne môžete priradiť existujúcu tag na ktorýkoľvek z týchto typov zdrojov pri vytváraní zdroja zahrnutímtags> prvok obsahujúci tag v otázke.
Aktualizácia a Tag
Aktualizácia existujúceho tag s novými atribútmi je analogický s vytvorením a tag:

Zrušenie priradenia a Tag
Ak chcete zrušiť priradenie a tag zo zdroja, pridajte atribút nc:operation=”delete” dotag> prvok patriaci k zdroju. Nižšie zrušíme priradenie a tag z monitora.

Odstránenie a Tag
Ak chcete odstrániť a tag celkovo z Control Center sa opäť používa atribút nc:operation=”delete”, ale tentoraz aplikovaný na tag sám, definovaný pod .

Riešenie problémov

Problém: Orchestrator a Paragon Active Assurance nie sú synchronizované
Orchestrátor a Paragon Active Assurance môžu skončiť napríklad nesynchronizovaneample, ak boli vykonané zmeny v konfigurácii v grafickom používateľskom rozhraní Control Center, alebo ak aplikácia konfigurácie nebola úspešná a návrat späť do predchádzajúceho stavu zlyhal.
V prípade neúspešného návratu nebude server NETCONF akceptovať zmeny konfigurácie; odpovie chybovým hlásením, že konfigurácia je uzamknutá, kým sa znova nesynchronizuje. Ak chcete obnoviť synchronizáciu a odomknúť zmeny konfigurácie, musíte spustiť príkaz rpc sync-from-ncc, ktorý synchronizuje všetky konfigurácie z Control Center do konfiguračnej databázy.
POZNÁMKA: The confd@netrounds.com používateľ (alebo čokoľvek, čo bolo nakonfigurované) musí mať oprávnenia superužívateľa, aby sa všetko úspešne synchronizovalo. To sa dá dosiahnuť príkazom ncc user-update confd@netrounds.com –is-superuser Ak používateľ nie je superuser, zobrazí sa varovanie, že nie všetko je možné synchronizovať, ale všetko, čo sa dalo zvládnuť, bolo.
POZNÁMKA: Ak váš orchestrátor ukladá aj konfiguráciu, budete ju musieť znova zosynchronizovať, pretože požadovaná konfigurácia (konfigurácia, ktorú orchestrátor očakáva, že má Control Center) nebude použitá.
Problém: Počiatočná synchronizácia (synchronizácia z-ncc) zlyhala z dôvodu nepodporovaných zdrojov
Ak sa pokúsite spustiť rpc sync-from-ncc na účte, ktorý má svoju konfiguráciu vytvorenú v GUI Control Center, môžete naraziť na problémy, ak účet obsahuje nepodporované prostriedky. Odporúča sa začať s prázdnym účtom a vykonať všetky jeho konfigurácie cez NETCONF. V opačnom prípade, ak narazíte na problémy s konfliktmi zdrojov, budete musieť konfliktné zdroje z účtu odstrániť.
Problém: Príkazy NETCONF zlyhajú s ncclient.operations.rpc.RPCError: zlyhanie komunikácie aplikácie
Server NETCONF neobnoví pripojenie k serveru Control Center automaticky, ak sa Control Center reštartuje. Ak chcete obnoviť pripojenie k Control Center, reštartujte proces NETCONF: sudo systemctl restart netrounds-confd

Poznámky o aplikáciách testovacích agentov a testovacích zariadeniach

Aplikácie testovacieho agenta v ConfD
Medzi testovacími agentmi funguje (novšia) aplikácia testovacieho agenta trochu inak ako (staršie) zariadenie testovacieho agenta.
Aplikácie testovacieho agenta momentálne nepodporujú konfiguráciu rozhrania. Preto schéma YANG umožňuje špecifikovať prázdnu konfiguráciu rozhrania pre takýchto testovacích agentov. Príklad nájdete v „tejto pasáži“ na strane 23ample.
Pri synchronizácii databázy ConfD s Control Center pomocou príkazu sync-from-ncc chcete, aby konfigurácia rozhrania zostala prázdna a nebola prepísaná tým, čo sa nachádza v Control Center. Preto pri práci s aplikáciami testovacieho agenta musíte s týmto príkazom použiť špeciálny príznak –without_interface_config.
Prázdna konfigurácia rozhrania pre zariadenie testovacieho agenta
Ako je uvedené vyššie, aplikácia Test Agent nepodporuje konfiguráciu rozhrania, a preto je možné rozhrania v schéme YANG vynechať.
Existujú však aj prípady použitia, keď možno budete chcieť vynechať konfiguráciu rozhrania zo zariadenia testovacieho agenta. BývalýampMôže ísť o scenár orchestrácie, kde spúšťate testovacieho agenta pomocou cloud-init a chcete, aby sa odtiaľ použila konfigurácia rozhrania, namiesto toho, aby ste ho nechali ConfD prepísať, keď sa testovací agent pripojí online.
Zmeny schémy YANG týkajúce sa nedefinovaných rozhraní
Keďže je teraz povolená prázdna konfigurácia rozhrania (od verzie 2.34.0 vyššie), je možné zadať ľubovoľný názov rozhrania ako vstup pre úlohu spustenú ako súčasť testu alebo monitora.
Vyžaduje sa to, aby ste mohli používať aplikáciu testovacieho agenta, pretože pre nich nie sú v ConfD definované žiadne názvy rozhraní. Upozorňujeme však, že to tiež znamená, že sa môžete stretnúť s problémami, ak náhodou nakonfigurujete test alebo monitor na používanie neexistujúceho rozhrania. Takže si to prosím uvedomte.
Obmedzenia pri registrácii testovacieho agenta vytvoreného v ConfD
Pri vytváraní testovacieho agenta cez REST alebo NETCONF/YANG API nemôžeme vopred vedieť, o aký typ ide: Test Agent Appliance alebo Test Agent Application. Toto sa ukáže až po registrácii testovacieho agenta.
Keď už bol testovací agent zaregistrovaný a zmenil sa na jeden z týchto konkrétnych typov, nemôžete ho znova zaregistrovať ako iný typ testovacieho agenta. To znamená, že ho nemôžete najskôr zaregistrovať ako zariadenie testovacieho agenta, potom ho znova zaregistrovať ako aplikáciu testovacieho agenta alebo naopak. Ak potrebujete testovacieho agenta iného typu, budete musieť vytvoriť nového testovacieho agenta.

Príloha: Stromová štruktúra úplného modelu YANG

V tejto prílohe časť “Legenda” na strane 81 vysvetľuje syntax stromovej štruktúry modelu YANG vygenerovanej pomocou príkazu pyang -f tree.
Časť “Stromová štruktúra modelu YANG” na strane 82 poskytuje výstup z tohto príkazu aplikovaného na netrounds-ncc.yang. Časti tohto výstupu sú reprodukované inde v dokumente.
Legenda

Stromová štruktúra modelu YANG

Juniper Networks, logo Juniper Networks, Juniper a Junos sú registrované ochranné známky spoločnosti Juniper Networks, Inc. v Spojených štátoch a iných krajinách. Všetky ostatné ochranné známky, servisné známky, registrované známky alebo registrované servisné známky sú majetkom ich príslušných vlastníkov. Juniper Networks nepreberá žiadnu zodpovednosť za akékoľvek nepresnosti v tomto dokumente. Juniper Networks si vyhradzuje právo zmeniť, upraviť, preniesť alebo inak revidovať túto publikáciu bez upozornenia. Copyright © 2023 Juniper Networks, Inc. Všetky práva vyhradené.

Dokumenty / zdroje

Softvér Juniper NETWORKS NETCONF & YANG API [pdf] Používateľská príručka
NETCONF YANG API softvér, YANG API softvér, API softvér, softvér

Referencie

Používateľská príručka

Úvod