NETCONF & YANG API -orkesteri
Opas
Julkaistu
2023-07-07
TIEDOTE 4.2
Johdanto
Tämän asiakirjan tarkoitus
Tässä dokumentaatiossa kuvataan, kuinka Paragon Active Assurance integroidaan verkkopalveluorganisaattoriin Control Center NETCONF & YANG -sovellusliittymän kautta. Käytännöllinen exampSiinä kerrotaan tärkeimmistä tehtävistä, mukaan lukien: virtuaalisten testiagenttien luominen ja käyttöönotto, testien ja monitorien suorittaminen sekä näiden toimien tulosten hakeminen.
Tässä dokumentissa vapaasti saatavilla olevaa Python NETCONF client ncclient -ohjelmaa käytetään orkesterin roolissa.
yleissopimukset
Tässä asiakirjassa käytetään seuraavia lyhenteitä:
| Lyhenne | Merkitys |
| CLI | Komentorivikäyttöliittymä |
| EM | Elementin johtaja |
| ES | Virhe Toiseksi |
| MEP | MEG (Maintenance Entity Group) -päätepiste (ITU-T Y.1731 -määritelmä) tai ylläpitopäätepiste (Ciscon määritelmä) |
| NFV | Verkkofunktion virtualisointi |
| NFVO | Verkkotoimintojen virtualisointiorganisaattori |
| NSD | Verkkopalvelun kuvaaja |
| RPC | Etämenettelypuhelu |
| SIEMAILLA | Istunnon aloitusprotokolla |
| SLA | Palvelutasosopimus |
| S-VNFM | Erityinen VNF Manager |
| VNF | Virtuaaliverkkotoiminto |
| vTA | Virtuaalinen testiagentti |
Huomautuksia taaksepäin yhteensopivuudesta
NETCONF & YANG API:n versioissa 2.35.4/2.36.0 tiettyjen pyyntöjen validointia on tiukennettu NETCONF-standardin noudattamiseksi. Tämä tarkoittaa, että tämän oppaan vanhempiin versioihin perustuva asiakaskoodi saatetaan nyt hylätä.
esimample, edellisessä Pythonissa example koodia, nimiavaruuden määritettä ei annettu. Nimiavaruus on nyt annettava pyyntö-XML:ssä aina, kun haluat muokata ConfD-resurssia.
Esitiedot ja valmistelut
ConfD-asennus
ConfD:tä (Tail-f:n tuote) käytetään välittäjänä Paragon Active Assurance -järjestelmän ja NETCONF:n välillä. ConfD yhdistää Paragon Active Assurance -kokoonpanon ja toimintatiedot NETCONF & YANG -sovellusliittymään.
ConfD olisi pitänyt asentaa yhdessä Control Center -ohjelmiston kanssa asennusoppaassa kuvatulla tavalla.
Varmistetaan, että ConfD on käynnissä
Varmista, että ConfD on toiminnassa, suorittamalla komento
ssh -s @localhost -p 830 netconf
tarkistaaksesi, että ConfD vastaa portissa 830. on netconf-käyttäjän luomisohjelman määrittelemä
-komento Asennusoppaan kohdassa ConfD:n asennus. Anna samalla komennolla määritetty salasana.
Tarkista tulosteessa, että Control Center -moduuli on mukana. Tulosteen tulee sisältää seuraavanlainen rivi:
http://ncc.netrounds.com?module=netrounds-ncc&versio=2017-06-15
Asetustietokannan synkronointi Control Centerin kanssa
Lopuksi meidän on päivitettävä kokoonpanotietokanta NETCONF:n kautta. Teemme sen tässä Python-kirjaston avulla nimeltä ncclient (NETCONF Client). Tehtävä voidaan kuitenkin suorittaa myös toisella ohjelmointikielellä, kunhan se käyttää NETCONF/YANG-protokollaa.
Ncclientin tehtävänä on toimia asiakkaana ConfD-palvelimelle, joka isännöi NETCONF/YANG API:ta.
On syytä huomauttaa, että ncclient ei liity millään tavalla Control Centeriin (aiemmin "Netrounds Control Center"), vaikka nimi alkaakin "ncc".
Näin asennat ncclient:
- Lataa ohjelmisto osoitteesta https://github.com/ncclient/ncclient.
- Suorita tämä komento: pip install ncclient
Voimme nyt suorittaa synkronoinnin seuraavasti. Huomaa huolellisesti, että tämä on tehtävä erillisellä tietokoneella, ei itse Control Center -palvelimella:
#
# HUOMAUTUS:
# Tämä komentosarja toimii asiakkaana NCC-palvelimella toimivaa ConfD:tä kohtaan.
# Se käyttää NETCONF/YANG-sovellusliittymää viestintään.
HUOM: Tätä menettelyä tarvitaan myös aina, kun testiagentit on asennettu ja rekisteröity NETCONF:sta riippumatta. Katso huomautus kohdassa "Overview Test Agent Orchestration” sivulla 17 saadaksesi lisätietoja.
Useiden NETCONF-ohjattujen Paragon Active Assurance -tilien määrittäminen
Alla olevat vaiheet ovat pakollisia vain, jos haluat määrittää lisää Paragon Active Assurance -tilejä NETCONF:n ohjaamaan Asennusoppaan kohdassa "ConfD:n asennus" tällä tavalla määritetyn tilin lisäksi.
Toimi jokaiselle tällaiselle tilille seuraavasti:
- Kirjaudu ohjauskeskuksessa tilille ja siirry kohtaan Tili > Käyttöoikeudet.
- Lisää käyttäjä "confd@netrounds.comja myönnä tälle ConfD-käyttäjälle järjestelmänvalvojan oikeudet graafisessa käyttöliittymässä napsauttamalla Kutsu-painiketta.
- Synkronoi määritystietokanta Control Centerin kanssa kohdassa ”Konfigurointitietokannan synkronointi Control Centerin kanssa” sivulla 4 kuvatulla tavalla.
Sinun pitäisi nyt pystyä hallitsemaan useita Paragon Active Assurance -tilejä samalla ConfD-käyttäjällä.
HUOM: Kun aloitat Paragon Active Assurance -tilin hallinnan ConfD:n kautta, et saa tehdä muutoksia tähän tiliin web GUI koskien kaikkia Paragon Active Assurance -ominaisuuksia, jotka ovat "config" (katso luku "Paragon Active Assurancen tuetut ominaisuudet" sivulla 9). Jos teet niin, synkronointi katkeaa.
Johdatus NETCONF Orchestration API:han
Yliview
Kolmannen osapuolen NFVO tai palvelun järjestäjä on tyypillisesti komponentti, joka aloittaa testi- ja valvontaistunnot Control Center API:n avulla. Tämä orkestraattori myös noutaa kootut mittaustulokset testiagentin toiminnoista. Kolmannen osapuolen suorituskyvyn hallintajärjestelmät voivat noutaa suorituskyvyn KPI:t, kun taas tapahtumat – kun ohjauskeskuksessa asetettujen kynnysarvojen rikkomukset laukaisevat ne – voidaan lähettää kolmannen osapuolen vianhallintajärjestelmiin.
Yhteenvetona voidaan todeta, että alla oleva kuva näyttää, kuinka Paragon Active Assurance on vuorovaikutuksessa muiden kolmannen osapuolen järjestelmien kanssa OSS-ympäristössä.
- NFVO/Service Orchestrator: kehottaa VNF Manageria ottamaan vTA:t käyttöön ja määrittämään Paragon Active Assurancen palveluketjuun. Kun palvelu on aktivoitu, järjestäjä käyttää sovellusliittymää Control Centeriin palvelun aktivointitestien käynnistämiseen ja hyväksyttyjen/hylättyjen tulosten hakemiseen. Jos testit läpäisevät, järjestäjä käyttää API:ta Control Centeriin palvelun aktiivisen seurannan käynnistämiseksi. Seurannan KPI:t noudetaan jatkuvasti joko orkesterin tai erillisen suorituskyvyn hallintaalustan avulla.
- Ohjauskeskus: Ottaa käyttöön, skaalata ja lopettaa vTA:n NFVO:n tai palvelun järjestäjän ohjeiden mukaisesti.
- Suorituskyvyn hallintajärjestelmä tai palvelun laadunhallintajärjestelmä: Lukee KPI:t aktiivisesta seurannasta Control Center API:n kautta.
- Vianhallintajärjestelmä: Vastaanottaa NETCONF-, SNMP- tai sähköposti-ilmoitukset ohjauskeskuksesta, jos SLA-sopimuksia rikotaan.
Paragon Active Assurancen käsitteiden määritelmät
- Testausaineet: Komponentit, jotka suorittavat mittauksia (sekä testejä että monitoreja varten) Paragon Active Assurance -järjestelmässä. Testiagentit koostuvat ohjelmistoista, jotka pystyvät luomaan, vastaanottamaan ja analysoimaan todellista verkkoliikennettä.
- Tässä asiakirjassa käsitelty testiagentti on Virtual Test Agent (vTA), virtuaalinen verkkotoiminto (VNF), joka on otettu käyttöön hypervisorissa. Myös muun tyyppisiä testiagentteja on olemassa.
- Paragon Active Assurancessa on kaksi perusmittaustyyppiä, testit ja monitorit.
- Testi: Testi koostuu yhdestä tai useammasta vaiheesta, joista jokaisella on määrätty, rajallinen kesto. Vaiheet suoritetaan peräkkäin. Jokainen vaihe voi edellyttää useiden tehtävien suorittamista samanaikaisesti.
- Monitori: Näytöllä ei ole määritettyä kestoa, mutta se toimii toistaiseksi. Kuten testin vaihe, monitori voi suorittaa useita samanaikaisesti tehtäviä.
- Malli: Kun Paragon Active Assurancea ohjaa orkestraattori, testit ja monitorit suoritetaan aina mallien avulla, joissa testi tai monitori on määritelty. Parametriasetukset voidaan välittää tuloina malliin ajon aikana.
Automatisoinnin työnkulku
Suunnittelun aika
Suunnittelun aikana valmistelet mittaukset luomalla malleja testeille ja monitoreille Paragon Active Assurancessa. Kuinka se tehdään, kerrotaan luvussa "Testaa ja tarkkaile mallit" sivulla 15.
Suoritusaika
Ajon aikana määrität laitteesi ja suoritat varsinaiset mittaukset.
- Yliview kaikista exampannettuja tietoja löytyy luvusta "EsimampParagon Active Assurancen hallinta NETCONF & YANG API:n kautta” sivulla 15.
- Testiagenttien käyttöönotto ja määrittäminen käy läpi luvussa "Esiamples: Testiaineet” sivulla 16.
- Kuinka tuoda varastotuotteita, kuten TWAMP heijastimet ja IPTV-kanavat käydään läpi luvussa “Esimamples: Varastotuotteet” sivulla 29.
- Hälytysten konfigurointi selitetään luvussa "Esiamples: Hälytykset” sivulla 35.
- Testien ja monitorien suorittaminen suorittamalla Paragon Active Assurance -malleja NETCONF:n kautta on kuvattu luvuissa "Esim.amples: Testit” sivulla 43 ja ”Esimamples: Näytöt” sivulla 54.
Paragon Active Assurancen tuetut ominaisuudet
Kaikki Paragon Active Assurancen testi- ja valvontatyypit voidaan luoda ja suorittaa mallien avulla. Kuinka tämä tehdään, kerrotaan sovelluksen sisäisestä ohjeesta kohdasta "Testit ja monitorit" > "Mallien luominen".
Paragon Active Assurance -tilien luomista ei tällä hetkellä tueta. käyttäjälle on kuitenkin määritetty yksi tai useampi ennalta määritetty tili.
Alla olevissa taulukoissa kerrotaan, mitkä Paragon Active Assurancen ominaisuudet ovat saatavilla tässä julkaisussa ja miten nämä ominaisuudet esitetään YANGissa.
YANG-rakenteiden selitys
Mukavuuden vuoksi tässä annetaan määritelmät ominaisuustaulukossa mainituista YANG-rakenteista.
- Config (config=true): Asetustiedot, joita tarvitaan järjestelmän muuttamiseksi tilasta toiseen.
- Tila (config=false): Tilatiedot: järjestelmän lisätiedot, jotka eivät ole konfiguraatiotietoja, kuten vain luku -tilatiedot ja kerätyt tilastot.
- RPC: Remote Procedure Call, jota käytetään NETCONF-protokollassa.
- Ilmoitus: Tapahtumailmoitukset lähetetään NETCONF-palvelimelta NETCONF-asiakkaalle.
Paragon Active Assurance -ominaisuuksien taulukot saatavilla orkestrointiin
Resurssi: Valvonta
YANG-polku:/accounts/account/monitors
| Ominaisuus | Alaominaisuus | YANG-rakennelma |
| Luo/muokkaa/poista näyttö | Perustuu näyttömalliin | Konfig |
| Käynnistys/pysäytysmonitori | – | Konfig |
| Seuraa malleja | Listaa olemassa olevat näyttömallit tuloineen | Osavaltio |
| NETCONF-ilmoitukset | Hälytystila muuttunut | Ilmoitus |
| Seuraa tuloksia | SLA/ES-laskuri huipputasolle (%) SLA/ES-laskuri tehtävätasolle (%) |
Osavaltio |
Toisin kuin testeissä (vertaa alla olevaa Resurssi: Testit), monitoreja ei käynnistetä RPC:llä, vaan pikemminkin suorittamalla näytön kokoonpano.
Resurssi: Testit
YANG-polku: /accounts/account/tests
| Ominaisuus | Alaominaisuus | YANG-rakennelma |
| Aloita testi | Perustuu testimalliin | RPC |
| Hallitse testejä | Listaa testit tilalla | Osavaltio |
| Testimallit | Listaa olemassa olevat testimallit syötteineen | Osavaltio |
| NETCONF-ilmoitukset | Testin tila muutettu | Ilmoitus |
| Testitulokset | Hanki testivaiheen tila (hyväksytty, epäonnistunut, virhe,…) | Osavaltio |
Resurssi: Test Agents
YANG-polut:
- /accounts/account/test-agents (Config)
- /accounts/account/registered-test-agents (osavaltio)
/accounts/account/test-agents -kohdassa olevat testiagentit ovat niitä, jotka määritetään tilissä. Orkesteri voi määrittää vain nämä testiagentit ja käyttää niitä testeissä ja monitoreissa NETCONF:n kautta.
Kun olet määrittänyt testiagentin ja se on rekisteröitynyt tilille, testiagentti ilmestyy kohtaan /accounts/account/registered-test-agents. Löydät kaikki rekisteröidyt testiagentit käyttämällä get-komentoa NETCONFissa (vertaa lukua Esimamples: Testiaineet).
Kohdassa /accounts/account/registered-test-agents voit myös löytää testiagentteja, joita ei ole vielä määritetty. Kaikki tällaiset testiagentit on määritettävä ennen kuin niitä voidaan käyttää.
Orkesteriskenaariossa on yleensä suositeltavaa, että teet kaikki Paragon Active Assurance -tilisi asetukset NETCONF:n kautta. Tämä varmistaa, että testiagentit ja rekisteröidyt testiagentit eivät eroa toisistaan.
| Ominaisuus | Alaominaisuus | YANG-rakennelma |
| Esiluo testiagentti palvelimelle | – | Konfig |
| Määritä offline-testausagentti | (Ohjauskeskus työntää konfiguroinnin testiagentille kun se tulee verkkoon) |
Konfig |
| Käytä olemassa olevia/ulkoisesti määritettyjä testiagentteja | Käytä testissä/monitorissa | Konfig |
| Määritä käyttöliittymät | Konfig | |
| Hanki tila | Osavaltio | |
| Määritä testiagentti (vain testilaite) | Määritä NTP | Konfig |
| Määritä sillat | Konfig | |
| Määritä VLAN-liitännät | Konfig | |
| Määritä SSH-avaimet | Konfig | |
| IPv6 | Konfig | |
| Utils | Käynnistä uudelleen | RPC |
| Päivittää | RPC | |
| NETCONF-ilmoitukset | Online-tila muuttunut | Ilmoitus |
| Status | Hae järjestelmän tila (käyttöaika, muistin käyttö, kuormituksen keskiarvo, versio) |
Osavaltio |
Resurssi: Inventory
YANG-polku: /accounts/account/twamp-heijastimet
Tuetut NETCONF-ominaisuudet
Alla oleva taulukko viittaa IETF:n RFC:hin, jotka kuvaavat Paragon Active Assurance -organisaatioon käytetyt NETCONF-ominaisuudet.
- ietf-netconf.yang
- IETF RFC 6241, Network Configuration Protocol (NETCONF), https://tools.ietf.org/html/rfc6241
- Ainoa tuettu virheenkäsittelytapa on palautus virheen yhteydessä.
- Ainoa tuettu tietovarasto on kirjoitettava.
- ietf-netconf-notifications.yang
- IETF RFC 5277, NETCONF-tapahtumailmoitukset, https://tools.ietf.org/html/rfc5277
Testaa ja tarkkaile malleja
Testi- ja monitorityyppien mallit on määritettävä manuaalisesti Paragon Active Assurance -käyttöliittymän kautta. Kuinka tämä tehdään, kerrotaan sovelluksen sisäisestä ohjeesta kohdasta "Testit ja monitorit" > "Mallien luominen".
ExampOhjaus Paragon Active Assurancesta NETCONF & YANG API:n kautta
Seuraavissa luvuissa oletetaan, että sopivat testi- ja monitorimallit on määritelty luvussa "Testi- ja valvontamallit" sivulla 15 annettujen ohjeiden mukaisesti.
Käytetyt työkalut esimamples
Kaikki exampseuraavissa luvuissa olevat luvut on rakennettu seuraavilla vapaasti saatavilla olevilla työkaluilla:
- Pang: Käytetään YANG-mallien visualisointiin ja selaamiseen.
- Saatavilla osoitteessa https://github.com/mbj4668/pyang (kloonaa gitistä ja suorita python setup.py install).
- Python NETCONF -asiakas "ncclient": Käytetään kommunikoimaan ohjauskeskuksen kanssa NETCONF:n avulla.
- Saatavilla osoitteessa https://github.com/ncclient/ncclient (suorita pip install ncclient).
Netrounds-ncc.yang-tietomalli löytyy hakemistosta /opt/netrounds-confd, kun ConfD on asennettu asennusoppaan mukaisesti).
Yliview suoritetuista keskeisistä tehtävistä
(Joitakin muita tehtäviä on myös esimerkkejä seuraavassa.)
- "Uuden testiagentin luominen ja käyttöönotto" sivulla 16
- "Varastotuotteiden (esim. heijastimien) luominen" sivulla 29
- "Hälytysmallien määrittäminen ja hälytysten lähettäminen" sivulla 35
- "Testin luominen ja suorittaminen" sivulla 45
- "Testitulosten hakeminen" sivulla 50
- "Näytön käynnistäminen (sisältää hälytysten asettamisen)" sivulla 60
- "Näytön SLA-tilan hakeminen" sivulla 67
- "Työskentely kanssa tags”Sivulla 71
Examples: Testiaineet
Yliview Test Agent Orchestration
Paragon Active Assurancen testausagentteja pidetään "kokoonpanona" orkestroinnin yhteydessä. Tämä tarkoittaa, että testiagenttien luominen, hallinta ja poistaminen tulisi tehdä orkesterin ja NETCONF:n kautta Paragon Active Assurance -käyttöliittymän sijaan.
TÄRKEÄÄ: Jos teknikko asentaa testiagentin ja rekisteröi sen Control Centeriin ilman, että se on ensin luotu NETCONF & YANG API:n kautta, testiagenttia ei ole määritystietokannassa ja järjestelmä ei synkronoidu. Jotta ConfD saa tiedon testiagentista tässä tapauksessa, on suoritettava uusi synkronointi Control Centerin kanssa, kuten kohdassa "Konfigurointitietokannan synkronointi ohjauskeskuksen kanssa" sivulla 4 on kuvattu.
Virtual Test Agents (vTA:t) järjestäminen tulisi siksi mieluummin tehdä seuraavissa vaiheissa:
- Luo virtuaalinen testiagentti, mukaan lukien sen käyttöliittymän kokoonpano, käyttämällä NETCONF & YANG -liitäntää Ohjauskeskukseen. Testiagentin nimi on sen ainutlaatuinen avain.
- Ota vTA käyttöön virtualisointialustalla. Noudata online-ohjeen ohjeita kohdassa Testausagentit > Asennus. Peruskäyttöliittymän kokoonpano, jonka avulla vTA voi muodostaa yhteyden Control Centeriin, sekä valtuustiedot todennusta varten, toimitetaan vTA:lle pilvi-init-käyttäjätietojen avulla.
Kun vTA on käynnistynyt, se muodostaa automaattisesti yhteyden ohjauskeskukseen käyttämällä salattua OpenVPN-yhteyttä. NETCONF-ilmoitus lähetetään, koska vTA:n test-agent-statuschange-parametrin arvo on nyt muuttunut "online".
HUOM: Koska vTA:n nimi on sen tunniste Ohjauskeskuksessa, tämän nimen on oltava sama kuin se, joka on määritetty Ohjauskeskuksessa kohdassa ”vaihe 1” sivulla 17. - Kun vTA on liitetty ja todennettu ohjauskeskukseen, liittymän kokoonpano siirretään vTA:lle. Tämä on kohdassa ”vaihe 1” sivulla 17 annettu liitäntäkokoonpano, kun vTA luotiin Ohjauskeskuksessa.
- Kun vTA on täyttänyt tarkoituksensa, poista vTA.
Uuden testiagentin luominen ja käyttöönotto
Meidän on ensin luotava testiagentti käyttämällä NETCONF & YANG -liitäntää ohjauskeskukseen. Kun testiagentti luodaan tällä tavalla, synkronointia Control Centerin kanssa ei tarvita.
Testiagentin YANG-malli on kuvattu alla. Se saadaan komennon ulostulona
pyang -f puu netrounds-ncc.yang
Täydellinen YANG-malli on esitetty kohdassa "Liite: Täyden YANG-mallin puurakenne" sivulla 81, joka sisältää myös selitteen, joka selittää tässä ja muissa tämän asiakirjan YANG-mallikuvissa käytetyt käytännöt.
Jatkamme seuraavia vaiheita, jotka on kuvattu seuraavassa:
- Alussa Paragon Active Assurance -tilin "demo" -luettelossa ei ole testausagentteja.
- Testiagentti nimeltä "vta1" luodaan käyttämällä ncclient-ohjelmaa. Tällä stage, varsinaista testiagenttia ei ole vielä olemassa (eli sitä ei ole vielä aloitettu).
- Testiagentti on otettu käyttöön OpenStackissa. (Käyttöönotto kyseisellä alustalla on valittu tässä yhdeksi mahdollisuudeksi muiden joukossa.)
- Testiagentti muodostaa yhteyden Control Center -tilin demoon ja on nyt valmis käytettäväksi.
Vaihe 1: Alussa tilillä "demo" ei ole testausagentteja. Katso alla oleva kuvakaappaus ohjauskeskuksen käyttöliittymästä.
Vaihe 2: Testiagentti luodaan Ohjauskeskuksessa Python NETCONF -asiakasohjelman "ncclient" avulla. Alla on ncclient-koodi testiagentin luomiseksi, jolla on yksi fyysinen liitäntä DHCP-osoitteella:
tuo argparse
ncclient tuontihallinnasta
parser = argparse.ArgumentParser(description='Testaa testiagentin luontia')
parser.add_argument('–host', help='Isäntänimi, josta ConfD löytyy', required=True)
parser.add_argument('–port', help='ConfD:hen yhdistävä portti', required=True)
parser.add_argument('–username', help='Käyttäjänimi ConfD:hen yhdistettäväksi', required=True)
parser.add_argument('–password', help='ConfD-tilin salasana', required=True)
parser.add_argument('–netrounds-account', help='NCC-tilin lyhyt nimi', required=True)
parser.add_argument('–test-agent-name', help='Testiagentin nimi', required=True)
args = parser.parse_args()
with manager.connect(host=args.host, port=args.port, username=args.username,
password=args.password, hostkey_verify=False) muodossa m:
# Luo testiagentti ohjauskeskuksessa
xml = """
)print m.edit_config(target='running', config=xml)
HUOM: Manager.connect(…) -koodia edeltävä koodi on jätetty pois myöhemmästä esimample koodinpätkiä.
NTP-palvelin on määritetty eth0:ssa, ja eth0 on myös hallintaliittymä (eli käyttöliittymä, joka muodostaa yhteyden ohjauskeskukseen).
Testiagenttisovellus ei tällä hetkellä salli rajapintojen määrittämistä. Tästä syystä versiosta 2.34.0 eteenpäin on mahdollista jättää liitäntäkonfiguraatio pois YANG-skeemasta. Vastaava XML on siksi radikaalisti yksinkertaistettu tässä tapauksessa:
Kun testiagentti on luotu, se on määritystietokannassa ja ohjauskeskuksessa. Katso alla oleva kuvakaappaus testiagentin luettelosta, jossa näkyy testiagentti "vta1":
Vaihe 3: Nyt on aika ottaa testiagentti "vta1" käyttöön OpenStackissa.
Testiagentti käyttää pilvi-init-käyttäjätietoja hakeakseen tietoja yhteyden muodostamisesta Control Centeriin. Erityisesti käyttäjätietojen teksti file sisältää seuraavan sisällön (Huomaa, että #cloud-config- ja netrounds_test_agent-rivien on oltava läsnä ja että loput rivit on sisennettävä):
Lisätietoja on asiakirjassa Virtual Test Agents in OpenStack.
Kun testiagentti on otettu käyttöön ja muodostanut yhteyden ohjauskeskukseen, kokoonpano siirretään ohjauskeskuksesta testiagentille.
Vaihe 4: Testiagentti on nyt online-tilassa Control Centerissä ja on saanut määrityksensä. Testausaine on valmis käytettäväksi testeissä ja seurannassa. Katso nämä osiot:
- "Testauksen aloittaminen" sivulla 45
- "Näytön käynnistäminen" sivulla 60
Testaajien luettelo Paragon Active Assurance -tililläsi
Alla on example ncclient Python-koodi testiagenttien luetteloimiseksi Paragon Active Assurance -tilillä:
Tämän koodin suorittaminen antaa seuraavanlaisen tulosteen:
Testiagentin poistaminen
Kun testi on suoritettu loppuun, joissakin käyttötapauksissa saattaa olla tarpeellista poistaa testiagentti.
Alla on koodinpätkä, joka näyttää kuinka tämä tehdään ncclientillä:
NETCONF-ilmoitukset
Alla esittelemme yksinkertaisen example script kaikkien saapuvien NETCONF-ilmoitusten kuuntelemiseen Control Centeristä. Nämä ilmoitukset lähetetään aina, kun tiettyjä tapahtumia tapahtuu, kuten testiagentin siirtyminen offline-tilaan tai käyttäjän käynnistämä testi valmistuu. Ilmoituksissa olevien tietojen perusteella käyttäjät voivat määrittää orkesteriin automaattisia seurantatoimenpiteitä.
Kun yllä oleva komentosarja suoritetaan, NC-asiakas esittää vastaanotetun ilmoituksen strukturoidussa XML-muodossa. Katso exampalla oleva tulos, joka näyttää testiagentin siirtyvän odottamatta offline-tilaan.
2017-02-03T15:09:55.939156+00:00</eventTime>
<test-agent-status-change xmlns=’http://ncc.netrounds.com'>
demo
HW1
offline-tilassa
Examples: Varastotuotteet
Varastotuotteiden, kuten TW, luominen (tuonti) ja hallintaAMP heijastimet ja Y.1731 MEP:t tehdään samalla tavalla kuin testiaineille. Alla on XML- ja NETCONF-koodi tällaisten entiteettien määrittämiseen Paragon Active Assurancessa NETCONF & YANG API:n kautta ja määritettyjen kohteiden luetteloiden hakemiseen.
TW:n luominenAMP Heijastin
Y.1731 MEP:n luominen
IPTV-kanavan luominen
Ping-isännän luominen
SIP-tilin luominen
Varastotuotteiden haku
Alla on Python-koodi kaikkien tilille määritettyjen varastonimikkeiden noutamiseen. (Kaiken tyyppiset varastonimikkeet haetaan tästä kerralla, jotta vältytään toistolta dokumentissa. Luonnollisesti mikä tahansa varastonimikkeiden osajoukko voidaan noutaa jättämällä pois joitakin alla olevia rivejä.)
Tämän koodin suorittaminen antaa seuraavanlaisen tulosteen:
Examples: Hälytykset
Hälytysmallit ja niihin liittyvät kohteet (SNMP-hallintaohjelmat, hälytyssähköpostilistat) luodaan ja niitä hallitaan samalla tavalla kuin varastonimikkeet. Tämä luku sisältää XML- ja NETCONF-koodit tällaisten entiteettien määrittämiseen Paragon Active Assurancessa NETCONF & YANG API:n kautta ja määritettyjen kohteiden luetteloiden hakemiseen.
Hälytyssähköpostilistat
Hälytyssähköpostiluettelon luominen
Haetaan kaikkia hälytyssähköpostiluetteloita
SNMP Managerit
SNMP Managerin luominen
Haetaan kaikkia SNMP-hallintaohjelmia
Hälytysmallit
Hälytysmallin luominen
Haetaan kaikkia hälytysmalleja
Examples: SSH-avaimet
Voit lisätä julkisia SSH-avaimia testiagentille NETCONF & YANG -sovellusliittymän kautta. Vastaavan yksityisen avaimen avulla voit sitten kirjautua sisään testiagenttiin SSH:n kautta.
Täydellinen luettelo käytettävissä olevista toiminnoista SSH-avaimilla on seuraava:
- Lisää SSH-avain
- Muokkaa SSH-avainta
- Tarkista SSH-avain
- Listaa SSH-avaimet
- Poista SSH-avain.
Alla on esimerkkejä lisäys- ja poistotoiminnoista.
SSH-avaimen poistaminen
Jos haluat poistaa SSH-avaimen, käytä seuraavaa komentoa:
Examples: Testit
Tässä oletetaan, että testiagentit (niin monta kuin testeihin tarvitaan) on luotu osion "Uuden testiagentin luominen ja käyttöönotto" sivulla 17 mukaisesti.
YANG-mallipolut testeihin
| Tuote | YANG-mallin polku: /accounts/account/tests… |
| testit | /. |
| testi[id] | /testata |
| id | /test/id |
| nimi | /testi/nimi |
| status | /testi/tila |
| aloitusaika | /testi/aloitusaika |
| lopun aika | /testi/lopetusaika |
| raportoi-url | /testiraportti-url |
| askeleita | /testi/vaiheet |
| step[id] | /test/vaiheet/vaihe |
| nimi | /test/steps/step/name |
| id | /test/steps/step/id |
| aloitusaika | /test/steps/step/aloitusaika |
| lopun aika | /test/steps/step/end-time |
| status | /test/steps/step/status |
| status viesti | /test/steps/step/status-message |
| malleja | /malleja |
| malli[nimi] | /templates/template |
| nimi | /templates/template/name |
| kuvaus | /templates/template/description |
| parametrit | /templates/template/parameters |
| parametri[avain] | /templates/template/parameters/parameter |
| avain | /templates/template/parameters/parameter/key |
| tyyppi | /templates/template/parameters/parameter/type |
Testiorkestroinnin edellytykset
- Testin aloittamiseksi NETCONF:n kautta NC-asiakasohjelmalla on ensin rakennettava testimalli ohjauskeskuksen käyttöliittymällä, kuten on kuvattu sovelluksen sisäisessä ohjeessa kohdassa "Testit ja monitorit" > "Mallien luominen". Kaikki kyseisessä mallissa "Mallin syötteeksi" määritetyt kentät vaaditaan parametreina XML:ssä, kun testimallin aloitusta ohjataan.
- Testien suorittamista Paragon Active Assurancessa pidetään "tilana" orkestroinnin yhteydessä. Tilatieto on ei-kirjoitettavaa dataa, jota ei ole tallennettu konfigurointitietokantaan, toisin kuin kohdassa "Over" mainitut konfiguraatiotiedot.view kohdasta Test Agent Orchestration” sivulla 17. Tämä tarkoittaa periaatteessa, että muutokset testeihin tai malleihin Control Centerin käyttöliittymässä eivät aiheuta synkronointiin liittyviä ongelmia Control Centerin ja määritystietokannan välillä.
- Saadaksesi raportin -URL heti testiraporteissa, sinun on varmistettava, että ohjauskeskus URL on määritetty oikein. Tämä tehdään file /opt/netrounds-confd/settings.py. Ohjauskeskuksen isäntänimi haetaan oletusarvoisesti käyttämällä socket.gethostname():tä: katso alla. Jos tämä ei tuota oikeaa tulosta, sinun on asetettava isäntänimi (tai koko URL) manuaalisesti tässä file.
# URL Ohjauskeskuksesta ilman kauttaviivaa.
# Tämä on esimamptestiraportissa käytettyurl.
HOSTNAME = socket.gethostname()
NETROUNDS_URL = 'https://%s' % HOSTNAME
Testin aloittaminen
Kuten kohdassa ”Uuden testiagentin luominen ja käyttöönotto” sivulla 17 on kuvattu, suorita komento pang -f tree netrounds-ncc.yang
hakemistosta /opt/netrounds-confd/ YANG-mallin tulostamiseksi. Tässä mallissa RPC testin aloittamiseksi NC-asiakasohjelmalla näyttää seuraavalta:
Katso selitykset kohdasta "Legenda" sivulla 81 liitteessä.
Seuraavat vaiheet näkyvät alla:
- Testausagentit on rekisteröity Paragon Active Assurance -tilille, mutta testejä ei ole vielä aloitettu.
- Vaaditut syöttöparametrit tunnistetaan suoritettavassa testimallissa.
- 60 sekunnin HTTP-testi käynnistetään ncclientillä.
Vaihe 1: Paragon Active Assurance -tilillä ei ole aloitettu testejä. Katso alla oleva kuvakaappaus ohjauskeskuksen käyttöliittymästä.
Vaihe 2: Malli, jota käytämme testin aloittamiseen tässä esimample on HTTP-testimalli. Siinä on kaksi pakollista syöttökenttää ( Asiakkaat ja URL), jonka olemme määrittäneet sellaisiksi rakentaessamme mallia ohjauskeskuksen käyttöliittymässä.
Määritämme nämä parametrit (muun muassa) XML-konfiguraatiossa, jonka NETCONF-hallinta (ncclient) välittää konfigurointitietokantaan.
Vaihe 3: HTTP-testi käynnistetään ncclientillä.
Alla on example-koodi, jossa vaaditut konfigurointitiedot ja parametrit määritetään HTTP-testimallille. Sen mukaan, miten malli on rakennettu, yksityiskohdat voivat vaihdella.
Jokaisen parametrin kohdalla attribuutti on annettava. Avain on identtinen parametrin kanssa
Muuttujan nimi Ohjauskeskuksessa. Voit tarkistaa muuttujien nimet seuraavasti:
- Napsauta sivupalkissa Testit ja valitse Uusi testisekvenssi.
- Napsauta Omat mallit.
- Napsauta Muokkaa-linkkiä kiinnostavan mallin alla.
- Napsauta oikeassa yläkulmassa olevaa Muokkaa syötettä -painiketta.
Meidän example, ja oletusarvoisesti muuttujien nimet ovat yksinkertaisesti pieniä versioita ohjauskeskuksessa näkyvistä näyttönimistä (“url" vs. "URL", jne.). Ohjauskeskuksen käyttöliittymässä voit kuitenkin nimetä muuttujat haluamaksesi.
Avaimen lisäksi jokaiselle parametrille on määritettävä sen tyyppi: esimample, varten URL.
Huomaa, että sinun on tehtävä uudelleenview täydellinen YANG-malli saadaksesi täydelliset tiedot tyypeistä. Testiagentin rajapinnoissa tyypillä on monimutkaisempi rakenne, kuten alla on osoitettu alla olevassa koodissa.
Voimme nyt ajaa skriptin ncclientillä. Jos kaikki on oikein, testi käynnistetään ja sen suoritus näytetään Ohjauskeskuksessa:
Jos testi on aloitettu onnistuneesti, ohjauskeskus vastaa testitunnuksella. Tässä example, testitunnus on 3:
Testitunnus löytyy myös URL testiä varten ohjauskeskuksen käyttöliittymässä. Tässä example, tuo URL on https://host/demo/testing/3/.
Testitulosten haku
Yksinkertaisin tapa saada testitulokset on osoittamalla testitunnus.
Alla on Python-koodi yllä olevan HTTP-testin tulosten saamiseksi ID = 3:lla:
johtajan kanssa. Connect(host=args.host, port=args.port, username=args.username,salasana=args.salasana, hostkey_verify=False) muodossa m:
Tulos näyttää suunnilleen tältä:
Testimallien vienti ja tuonti
Testimallit voidaan viedä JSON-muodossa ja tuoda uudelleen tässä muodossa Ohjauskeskukseen. Tästä on hyötyä, jos haluat käyttää testimalleja toisessa Ohjauskeskuksen asennuksessa. (Mallien alkuperäinen luominen onnistuu parhaiten ohjauskeskuksen käyttöliittymän kautta.)
Alla on koodi viennin ja tuonnin suorittamista varten.
Testimallien vienti
# Hae json-konfiguraatio vastauksesta
juuri = ET.fromstring(response._raw)
json_config = root[0].text
tulosta json_config
Malli sisältyy json_config-objektiin.
Testimallien tuominen
Testimalleja sisältävä JSON-määritysobjekti voidaan tuoda uudelleen ohjauskeskukseen seuraavasti.
Examples: Näytöt
Tässä osiossa oletetaan, että testiagentit (niin monta kuin monitorit vaativat) on luotu osion ”Uuden testiagentin luominen ja käyttöönotto” sivulla 17 mukaisesti.
YANG-mallipolut monitoreille
| Tuote | YANG-mallin polku: /accounts/account/monitors… |
| monitorit | /. |
| monitori[nimi] | /monitori |
| nimi | /monitori/nimi |
| kuvaus | /monitor/kuvaus |
| alkoi | /monitor/käynnistetty |
| malli | /monitor/template |
| hälytysasetukset | /monitor/alarm-configs |
| Tuote | YANG-mallin polku: /accounts/account/monitors/monitor/alarm-configs… |
| alarm-config[tunniste] | /alarm-config |
| tunniste | /alarm-config/identifier |
| malli | /alarm-config/template |
| sähköposti | /alarm-config/email |
| snmp | /alarm-config/snmp |
| thr-es-kriittinen | /alarm-config/thr-es-critical |
| thr-es-critical-clear | /alarm-config/thr-es-critical-clear |
| th-es-duuri | /alarm-config/thr-es-major |
| thr-es-major-clear | /alarm-config/thr-es-major-clear |
| th-es-moll | /alarm-config/thr-es-minor |
| thr-es-minor-clear | /alarm-config/thr-es-minor-clear |
| thr-es-varoitus | /alarm-config/thr-es-warning |
| thr-es-warning-clear | /alarm-config/thr-es-warning-clear |
| ei-data-vakavuus | /alarm-config/no-data-severity |
| no-data-aikakatkaisu | /alarm-config/no-data-timeout |
| toimintaa | /alarm-config/action |
| ikkunan kokoinen | /alarm-config/window-size |
| intervalli | /alarm-config/interval |
| lähetä vain kerran | /alarm-config/send-only-once |
| snmp-trap-per-stream | /alarm-config/snmp-trap-per-stream |
| Tuote | YANG-mallin polku: /accounts/account/monitors… |
| parametrit | /monitor/parameters |
| Tuote | YANG-mallin polku: /accounts/account/monitors/monitor/parameters… |
| parametri[avain] | /parametri |
| avain | /parametri/avain |
| (arvon tyyppi) | /parametri |
| :(kokonaisluku) | /parametri |
| kokonaisluku | /parametri/kokonaisluku |
| :(kellua) | /parametri |
| kellua | /parametri/float |
| :(merkkijono) | /parametri |
| Tuote | YANG-mallin polku: /accounts/account/monitors/monitor/parameters… |
| merkkijono | /parametri/merkkijono |
| :(testausagentin käyttöliittymät) | /parametri |
| testi-agentin käyttöliittymät | /parameter/test-agent-interfaces |
| test-agent-interface ["1" sivulla 58 | /parameter/test-agent-interfaces/ |
| tili | /parameter/test-agent-interfaces/test-agent-interface/account |
| testi-agentti | /parameter/test-agent-interfaces/test-agent-interface/test-agent |
| käyttöliittymä | /parameter/test-agent-interfaces/test-agent-interface/interface |
| ip-versio | /parameter/test-agent-interfaces/test-agent-interface/ip-version |
| :(twamp-heijastimet) | /parametri |
| twamp-heijastimet | /parameter/twamp-heijastimet |
| twamp-heijastin[nimi] | /parameter/twamp-heijastimet/twamp-heijastin |
| nimi | /parameter/twamp-heijastimet/twamp- heijastin/nimi |
| :(y1731-meps) | /parametri |
| y1731-meps | /parameter/y1731-meps |
| y1731-mep[nimi] | /parameter/y1731-meps/y1731-mep |
| nimi | /parameter/y1731-meps/y1731-mep/name |
| :(sip-tilit) | /parametri |
| sip-tilejä | /parameter/sip-accounts |
| sip-account["2" sivulla 58] | /parameter/sip-accounts/sip-account |
| tili | /parameter/sip-accounts/sip-account/account |
| testi-agentti | /parameter/sip-accounts/sip-account/test-agent |
| käyttöliittymä | /parameter/sip-accounts/sip-account/interface |
| sip-osoite | /parameter/sip-accounts/sip-account/sip-address |
| :(iptv-kanavat) | /parametri |
| iptv-kanavat | /parameter/iptv-kanavat |
| iptv-kanava[nimi] | /parameter/iptv-channels/iptv-channel |
| nimi | /parameter/iptv-channels/iptv-channel/name |
- tilin testi-agentin käyttöliittymä
- tilin testi-agentin käyttöliittymän sip-osoite
| Tuote | YANG-mallin polku: /accounts/account/monitors… |
| status | /monitor/status |
| viimeiset 15 minuuttia | /monitor/tila/viimeiset 15 minuuttia |
| status | /monitor/tila/viimeiset 15 minuuttia/tila |
| status-arvo | /monitor/status/viime-15-minutes/status-value |
| viime tunti | /monitor/status/last-hour |
| status | /monitor/status/last-hour/status |
| status-arvo | /monitor/status/last-hour/status-value |
| viimeiset 24 tuntia | /monitor/status/viimeiset 24 tuntia |
| status | /monitor/status/viimeiset 24 tuntia/tila |
| status-arvo | /monitor/status/viime-24-hours/status-value |
| malleja | /malleja |
| malli[nimi] | /templates/template |
| nimi | /templates/template/name |
| kuvaus | /templates/template/description |
| parametrit | /templates/template/parameters |
| parametri[avain] | /templates/template/parameters/parameter |
| avain | /templates/template/parameters/parameter/key |
| tyyppi | /templates/template/parameters/parameter/type |
Monitorin orkestroinnin edellytykset
Ennen kuin voit käynnistää näytön NETCONF:n kautta ncclientin avulla, sinun on rakennettava näyttömalli Control Center -käyttöliittymään sovelluksen sisäisen ohjeen kohdassa "Testit ja näytöt" > "Mallien luominen" kuvatulla tavalla. Kaikki kyseisessä mallissa "Mallin syötteeksi" määritetyt kentät vaaditaan parametreina XML:ssä, kun mallin aloitusta ohjataan.
Syöteparametrien saaminen näyttömalleista
Alla on kaksi mallia. Ensimmäinen on UDP-valvontaan kahden Test Agent -rajapinnan välillä, ja toinen on HTTP:tä varten, joka käyttää yhtä Test Agent -liitäntää.
Saat mallin syöttöparametrit selville napsauttamalla mallia edustavaa ruutua. HTTP-mallin parametrit voivat näyttää tältä:
Meidän on määritettävä nämä parametrit seuraavassa vaiheessa monitoria käynnistettäessä.
Näytön käynnistäminen
Käyttämällä kohdassa ”Uuden testiagentin luominen ja käyttöönotto” sivulla 17 määrittämiämme ja käyttöönottamiamme testiagentteja voimme käynnistää monitorin mallista "HTTP" alla olevan kuvan mukaisesti.
Jokaisen parametrin kohdalla attribuutti on annettava. Avain on identtinen Ohjauskeskuksen parametrin Muuttujan nimen kanssa. Voit tarkistaa muuttujien nimet seuraavasti:
- Napsauta sivupalkissa Monitoring ja valitse Uusi näyttö.
- Napsauta Omat mallit.
- Napsauta Muokkaa-linkkiä kiinnostavan mallin alla.
- Napsauta oikeassa yläkulmassa olevaa Muokkaa syötettä -painiketta.
Meidän example, ja oletusarvoisesti muuttujien nimet ovat yksinkertaisesti pieniä versioita ohjauskeskuksessa näkyvistä näyttönimistä (“url" vs. "URL", jne.). Ohjauskeskuksen käyttöliittymässä voit kuitenkin nimetä muuttujat haluamaksesi.
Avaimen lisäksi jokaiselle parametrille on määritettävä sen tyyppi: esimample, varten URL. Huomaa, että täydelliset tiedot parametrityypistä löytyvät YANG-mallista. Testiagenttiliitäntöjen tyypin rakenne on monimutkaisempi, kuten alla olevasta koodista käy ilmi.
ExampTämän jälkeen näyttöön ei liity hälytystä. esimampJos sinulla on hälytyksiä, siirry osioon "Näytön käynnistäminen hälytyksellä" sivulla 62.
Näytön käynnistäminen hälytyksellä
Jos haluat liittää hälytyksen näyttöön, voit joko osoittaa hälytysmalliin, joka on määritetty, tai voit toimittaa koko hälytyksen kokoonpanon monitoria luodessasi. Annamme yhden exampjokaisesta alla olevasta lähestymistavasta.
Näytön hälytyksen asettaminen osoittamalla hälytysmallia
Jotta voit käyttää hälytysmallia, sinun on tiedettävä sen tunnus. Tätä varten hae ensin kaikki hälytysmallit osiossa "Kaikkien hälytysmallien noutaminen" sivulla 39 kuvatulla tavalla ja merkitse muistiin kyseisen mallin nimi. Voit sitten viitata tähän malliin seuraavasti:
Näytön hälytyksen määrittäminen määrittämällä se suoraany
Vaihtoehtoisesti voit asettaa hälytyksen näytölle antamalla sen koko kokoonpanon näyttöä luotaessa ilman hälytysmallia. Tämä tehdään seuraavassa esimerkissä esitetyllä tavallaample.
Käynnissä olevien monitorien haku
Jos haluat noutaa kaikki käynnissä olevat näytöt, suorita tämä komentosarja:
johtajan kanssa. connect(host=args.host, port=args.port, username=args. user name, password=args.password, hostkey_verify=False) muodossa m:
Tulos on luettelo kaikista käynnissä olevista monitoreista alla olevan kuvan mukaisesti:
Haetaan SLA-tilaa näytölle
Näin voit noutaa näytön SLA-tilan. Tässä example, haemme SLA-tilan monitorille "Verkon laatu" kolmen ajanjakson aikana: viimeiset 15 minuuttia, viimeinen tunti ja viimeiset 24 tuntia.
Tulos näyttää suunnilleen tältä:
NETCONF-ilmoitukset
SLA-rikkomukset laukaisevat monitorien NETCONF-ilmoitukset. Näitä esiintyy, kun näytön SLA laskee SLA-kynnyksen ("Hyvä" tai "Hyväksyttävä") alapuolelle tietyn aikaikkunan sisällä, oletusarvoisesti viimeisen 15 minuutin aikana. On huomattava, että SLA-rikkomusilmoitukset tulevat nopeasti näkyviin, kun palveluun on vaikuttanut ongelma, kun taas SLA-tila palautuu "Hyväksi" vasta 15 minuutin kuluttua ja vain, jos muita rikkomuksia ei tapahdu.
Aikaikkunaa voidaan muuttaa muokkaamalla asetusta SLA_STATUS_WINDOW (arvo sekunteina) /etc/netrounds/netrounds.conf.
Monitorimallien vienti ja tuonti
Tämä tehdään täsmälleen samalla tavalla kuin testimalleille; vertaa kohtaa "Testimallien vieminen ja tuonti" sivulla 52. Alla olevat koodinpätkät havainnollistavat, kuinka monitorien malleja viedään ja tuodaan.
Näyttömallien vienti
Monitorimallien tuominen
Tags Paragon Active Assurancessa määriteltyjä voidaan soveltaa:
- monitorit
- seurata malleja
- Testiaineet
- TWAMP heijastimet
- Ping isännät.
esimample, voit tag näyttö, jossa on sama tag osana testiagentteja, jotka aikovat käyttää näyttöä. Tämä ominaisuus on erityisen hyödyllinen, jos sinulla on määritetty suuri määrä näyttöjä ja malleja.
Jos olet asettanut hälytyksen SNMP-trapeilla näytölle, SNMP-trapeille määritetään samat tags kuten näyttö, jos sellainen on.
Luodaan Tags
Alla näytämme kuinka luodaan a tag XML:n määrittelemällä nimellä ja värillätag> alarakenne.
Määrääminen a Tag
Määrittääksesi a tag resurssiin, lisäät sen uutenatag> elementin allatags> elementti tälle resurssille.
Näin määrität a tag testiagentille:
Määrittääksesi a tag TW:henAMP heijastin, toimi seuraavasti:
Määrääminen a tag näytölle käsitellään samalla tavalla:
Vaihtoehtoisesti voit määrittää olemassa olevan tag johonkin näistä resurssityypeistä resurssia luotaessa sisällyttämällätags> elementtiä, joka sisältää tag kyseessä.
Päivittäminen a Tag
Päivitetään olemassa olevaa tag uusilla määritteillä on analoginen luomiseen a tag:
Määrityksen poistaminen a Tag
Määrityksen poistaminen a tag lisää resurssista attribuutti nc:operation=”delete”.tag> resurssiin kuuluva elementti. Alla poistamme a tag näytöltä.
Poistaminen a Tag
Poistaaksesi a tag kokonaan Ohjauskeskuksesta attribuuttia nc:operation=”delete” käytetään jälleen, mutta tällä kertaa tag itse, määritelty alla .
Vianetsintä
Ongelma: Orchestrator ja Paragon Active Assurance ei synkronoidu
Orchestrator ja Paragon Active Assurance voivat päätyä epäsynkronointiin esimample, jos ohjauskeskuksen käyttöliittymässä on tehty kokoonpanomuutoksia tai jos määrityksen käyttöönotto ei onnistunut ja palautus edelliseen tilaan epäonnistui.
Jos palautus epäonnistuu, NETCONF-palvelin ei enää hyväksy kokoonpanomuutoksia; se vastaa virheilmoituksella, jonka mukaan kokoonpano on lukittu, kunnes se on synkronoitu. Synkronoinnin palauttamiseksi ja kokoonpanomuutosten avaamiseksi sinun on suoritettava komento rpc sync-from-ncc, joka synkronoi kaikki asetukset ohjauskeskuksesta määritystietokantaan.
HUOMAA: The confd@netrounds.com käyttäjällä (tai millä tahansa muulla, joka on määritetty) on oltava pääkäyttäjän oikeudet, jotta kaikki synkronoidaan onnistuneesti. Tämä voidaan saavuttaa komennolla ncc user-update confd@netrounds.com –is-superuser Jos käyttäjä ei ole pääkäyttäjä, näyttöön tulee varoitus, että kaikkea ei ole voitu synkronoida, mutta kaikki mitä on voitu käsitellä, on ollut.
HUOMAA: Jos myös orkesterisi tallentaa kokoonpanon, sinun on myös synkronoitava se uudelleen, koska pyydettyä kokoonpanoa (kokoonpano, jonka orkestraattori odottaa olevan ohjauskeskuksessa) ei ole käytetty.
Ongelma: Alkuperäinen synkronointi (synkronointi ncc:stä) epäonnistui tukemattomien resurssien vuoksi
Jos yrität suorittaa rpc sync-from-ncc tilillä, jonka kokoonpano on luotu ohjauskeskuksen käyttöliittymässä, saatat kohdata ongelmia, jos tili sisältää ei-tuettuja resursseja. On suositeltavaa aloittaa tyhjällä tilillä ja tehdä kaikki sen asetukset NETCONF:n kautta. Muussa tapauksessa, jos kohtaat ongelmia resurssiristiriitojen kanssa, sinun on poistettava ristiriitaiset resurssit tililtä.
Ongelma: NETCONF-komennot epäonnistuvat komennolla ncclient.operations.rpc.RPCError: Sovelluksen tiedonsiirtovirhe
NETCONF-palvelin ei palauta yhteyttä Control Center -palvelimeen automaattisesti, jos Control Center käynnistetään uudelleen. Palauta yhteys Control Centeriin käynnistämällä NETCONF-prosessi uudelleen: sudo systemctl restart netrounds-confd
Testausagenttisovelluksia ja -testausagenttilaitteita koskevia huomautuksia
Testiagenttisovellukset ConfD:ssä
Testiagenttien joukossa (uudempi) testiagenttisovellus toimii hieman eri tavalla kuin (vanhempi) Test Agent Appliance.
Testiagenttisovellukset eivät tällä hetkellä tue käyttöliittymän konfigurointia. Siksi YANG-skeema sallii tyhjän liitäntäkonfiguraation määrittämisen tällaisille testiagenteille. Katso ”tämä kohta” sivulla 23 esimample.
Kun synkronoit ConfD-tietokannan Ohjauskeskuksen kanssa sync-from-ncc-komennolla, haluat, että käyttöliittymän kokoonpano pysyy tyhjänä eikä sitä korvata Control Centerin kanssa. Siksi sinun on käytettävä erityistä lippua –ilman_liittymän_konfiguraatiota tämän komennon kanssa, kun työskentelet testausagenttisovellusten kanssa.
Tyhjä rajapintamääritys testiagenttilaitteistolle
Kuten edellä todettiin, Test Agent Application ei tue rajapintojen konfigurointia, ja siksi on mahdollista jättää rajapintoja pois YANG-skeemasta.
Mutta on myös käyttötapauksia, joissa saatat haluta jättää testausagenttilaitteiston käyttöliittymämääritykset pois. ExampTämä voi olla orkestrointiskenaario, jossa kehität testiagenttia pilvi-initillä ja haluat, että siellä olevia käyttöliittymämäärityksiä käytetään sen sijaan, että ConfD ylikirjoittaisi sen, kun testiagentti tulee verkkoon.
YANG-skeeman muutokset määrittelemättömiin liitäntöihin
Koska tyhjä käyttöliittymäkokoonpano on nyt sallittu (versiosta 2.34.0 eteenpäin), on mahdollista määrittää mikä tahansa liitännän nimi syötteeksi tehtävälle, joka suoritetaan osana testiä tai valvontaa.
Tämä vaaditaan testausagenttisovelluksen käyttämiseen, koska näille ei ole määritetty liitäntänimiä ConfD:ssä. Huomaa kuitenkin, että tämä tarkoittaa myös sitä, että voit kohdata ongelmia, jos vahingossa määrität testin tai monitorin käyttämään olematonta käyttöliittymää. Joten ota tämä huomioon.
ConfD:ssä luodun testiagentin rekisteröinnin rajoitukset
Kun luot testiagentin REST- tai NETCONF/YANG-sovellusliittymän kautta, emme voi tietää etukäteen, mikä tyyppi se on: Test Agent Appliance vai Test Agent Application. Tämä selviää vasta, kun testiagentti on rekisteröitynyt.
Kun testiagentti on rekisteröity ja muuttunut joksikin näistä betonityypeistä, et voi rekisteröidä sitä uudelleen erityyppiseksi testiagentiksi. Tämä tarkoittaa, että et voi rekisteröidä sitä ensin testiagentin laitteistoksi, sitten rekisteröidä sitä uudelleen testiagenttisovellukseksi tai päinvastoin. Jos tarvitset erityyppistä testiagenttia, sinun on luotava uusi testiagentti.
Liite: Koko YANG-mallin puurakenne
Tämän liitteen osiossa Selite sivulla 81 selitetään komennolla pyang -f puu luodun YANG-mallipuurakenteen syntaksi.
Kohdassa "YANG-mallipuurakenne" sivulla 82 on tulos tästä komennosta, jota käytetään netrounds-ncc.yang. Osa tästä tulosteesta on toistettu muualla asiakirjassa.
Legenda
YANG-mallin puurakenne
Juniper Networks, Juniper Networksin logo, Juniper ja Junos ovat Juniper Networks, Inc:n rekisteröityjä tavaramerkkejä Yhdysvalloissa ja muissa maissa. Kaikki muut tavaramerkit, palvelumerkit, rekisteröidyt merkit tai rekisteröidyt palvelumerkit ovat vastaavien omistajiensa omaisuutta. Juniper Networks ei ota vastuuta tämän asiakirjan epätarkkuuksista. Juniper Networks pidättää oikeuden muuttaa, muokata, siirtää tai muutoin tarkistaa tätä julkaisua ilman erillistä ilmoitusta. Copyright © 2023 Juniper Networks, Inc. Kaikki oikeudet pidätetään.
Asiakirjat / Resurssit
 |
Juniper NETWORKS NETCONF & YANG API -ohjelmisto [pdfKäyttöopas NETCONF YANG API -ohjelmisto, YANG API -ohjelmisto, API-ohjelmisto, ohjelmisto |