Juniper NETWORKS NETCONF & YANG API Программасынын Колдонуучусу

Бул документтин максаты
Бул документация Paragon Active Assurance программасын NETCONF & YANG API Башкаруу борбору аркылуу тармак кызматынын оркестри менен кантип интеграциялоону сүрөттөйт. Колдонмо эксampнегизги милдеттерди камтыйт, анын ичинде: Виртуалдык тест агенттерин түзүү жана жайылтуу, тесттерди жана мониторлорду жүргүзүү жана бул иш-аракеттерден натыйжаларды алуу.
Бул документте, эркин жеткиликтүү Python NETCONF кардар ncclient оркестрдин ролунда колдонулат.

Конвенциялар
Бул документте төмөнкү аббревиатуралар колдонулат:

Аббревиатура	Мааниси
CLI	Command Line Interface
EM	Элемент менеджери
ES	Экинчи ката
Европарламенттин депутаты	MEG (Maintenance Entity Group) Акыркы чекит (ITU-T Y.1731 аныктамасы) же Тейлөөнүн акыркы чекити (Cisco аныктамасы)
NFV	Тармак функциясын виртуалдаштыруу
NFVO	Network Function Virtualization Orchestrator
NSD	Тармак кызматынын дескриптору
RPC	Алыскы процедураны чакыруу
SIP	Сессияны баштоо протоколу
SLA	Кызмат деңгээлинин келишими
S-VNFM	Атайын VNF менеджери
VNF	Виртуалдык тармак функциясы
vTA	Virtual Test Agent

Артка шайкештик боюнча эскертүүлөр

NETCONF & YANG API 2.35.4/2.36.0 версияларында NETCONF стандартын сактоо үчүн айрым суроо-талаптарды текшерүү катуураак кылынды. Бул бул колдонмонун эски версияларына негизделген кардар коду азыр четке кагылышы мүмкүн дегенди билдирет.
Мисалы үчүнample, мурунку Python эксample коду, ат мейкиндиги атрибуту берилген эмес. ConfD ресурсун өзгөрткүңүз келген сайын аттар мейкиндиги суроо-талаптын XML форматында берилиши керек.

Алдын ала шарттар жана даярдыктар

ConfD орнотуу
ConfD (Tail-f продуктусу) Paragon Active Assurance системасы менен NETCONF ортосунда ортомчу катары колдонулат. ConfD Paragon Active Assurance конфигурациясын жана оперативдүү маалыматтарды NETCONF & YANG API менен байланыштырат.
ConfD Орнотуу колдонмосунда сүрөттөлгөндөй Башкаруу борборунун программасы менен бирге орнотулушу керек.

ConfD иштеп жатканын текшерүү
ConfD иштеп жатканын текшерүү үчүн, буйрукту иштетиңиз
ssh -s @localhost -p 830 netconf
ConfD 830 портунда жооп берерин текшерүү үчүн. Буйрукта, netconf колдонуучу түзүү тарабынан аныкталат
Орнотуу колдонмосунун ConfD орнотуу бөлүмүндөгү буйрукту. Ошол эле буйрук менен аныкталган сырсөздү бер.
Чыгармада Башкаруу борборунун модулу камтылганын текшериңиз. Чыгуу төмөнкүдөй сапты камтышы керек:
http://ncc.netrounds.com?module=netrounds-ncc&revision=2017-06-15

Конфигурация маалымат базасын Башкаруу борбору менен синхрондоштуруу

Акыр-аягы, NETCONF аркылуу конфигурациялар базасын жаңыртышыбыз керек. Биз муну ncclient (NETCONF Client) деп аталган Python китепканасынын жардамы менен жасайбыз. Бирок, тапшырма NETCONF/YANG протоколун колдонгондо башка программалоо тилинде да аткарылышы мүмкүн.
Ncclientтин ролу NETCONF/YANG API жайгаштырган ConfD серверине кардар катары иш алып баруу.

Белгилей кетчү нерсе, ncclient Башкаруу борборуна эч кандай тиешеси жок (мурда "Netrounds Control Center"), бирок аты "ncc" менен башталат.
Бул жерде ncclient кантип орнотуу керек:

Бул жерден программалык камсыздоону жүктөп алыңыз https://github.com/ncclient/ncclient.
Бул буйрукту иштетиңиз: pip install ncclient

Эми биз синхрондоштурууну төмөнкүдөй аткара алабыз. Бул Башкаруу борборунун серверинде эмес, өзүнчө компьютерде жасалышы керек экенин кылдаттык менен белгилеңиз:

#
# ЭСКЕРТҮҮ:
# Бул скрипт NCC серверинде иштеген ConfDге кардар катары иштейт.
# Бул байланыш үчүн NETCONF/YANG API колдонот.

ЭСКЕРТҮҮ: Бул процедура ошондой эле Сыноо Агенттери NETCONFге көз карандысыз орнотулган жана катталган учурда да талап кылынат. «Бүттүview Көбүрөөк маалымат алуу үчүн 17-беттеги Test Agent Orchestration.

Бир нече NETCONF көзөмөлдөгөн Paragon Active Assurance Accounts орнотуу

Төмөнкү кадамдар, Орнотуу колдонмосунун “ConfD орнотуу” бөлүмүндө ушундай жол менен конфигурацияланган эсепке кошумча, NETCONF тарабынан башкарылуучу Paragon Active Assurance эсептерин орнотууну кааласаңыз гана талап кылынат.
Ар бир ушундай эсеп үчүн, төмөнкүнү аткарыңыз:

Башкаруу борборунда каттоо эсебине кирип, Каттоо эсеби > Уруксаттарга өтүңүз.

Колдонуучуну кошуу "confd@netrounds.com", жана Чакыруу баскычын чыкылдатуу менен GUIде бул ConfD колдонуучу администраторуна уруксат бериңиз.
4-беттеги “Конфигурация маалымат базасын Башкаруу борбору менен синхрондоштуруу” бөлүмүндө сүрөттөлгөндөй конфигурация маалымат базасын Башкаруу борбору менен синхрондоңуз.
Эми сиз бир эле ConfD колдонуучусу менен бир нече Paragon Active Assurance эсептерин көзөмөлдөй аласыз.

ЭСКЕРТҮҮ: ConfD аркылуу Paragon Active Assurance эсебин көзөмөлдөй баштагандан кийин, сиз бул эсепке өзгөртүү киргизбешиңиз керек. web "конфигурациялоо" болгон бардык Paragon Active Assurance функцияларына карата GUI (9-беттеги "Paragon Active Assurance'деги колдоого алынган функциялар" бөлүмүн караңыз). Эгер кылсаңыз, синхрондоштуруу жоголот.

NETCONF Orchestration API'ге киришүү

Бүттүview

Үчүнчү тараптын NFVO же тейлөө оркестри, адатта, Control Center API аркылуу сыноо жана мониторинг сессияларын баштоочу компонент болуп саналат. Бул оркестр ошондой эле Сыноо Агентинин аракеттеринен топтолгон өлчөө натыйжаларын чыгарат. Performance KPIлер үчүнчү тараптын Performance Management Systems тарабынан алынышы мүмкүн, ал эми окуялар – бир жолу Башкаруу борборунда белгиленген чекти бузуулардан улам келип чыккан – үчүнчү тараптын Мүчүлүштүктөрдү башкаруу тутумдарына жөнөтүлүшү мүмкүн.
Жыйынтыктап айтканда, төмөндөгү сүрөттө Paragon Active Assurance OSS пейзажындагы башка үчүнчү тараптын системалары менен кандайча өз ара аракеттенишээри көрсөтүлгөн.

NFVO/Service Orchestrator: VNF менеджерине vTAларды жайгаштырууну жана Paragon Active Assurance кызматын чынжырчага конфигурациялоону тапшырат. Кызмат активдештирилгенден кийин, оркестр кызматты активдештирүү сыноолорун баштоо жана өтпөй калган/кеткен натыйжаларды алуу үчүн Башкаруу борборуна карай API колдонот. Эгер сыноолор өтүп кетсе, оркестр кызматтын активдүү мониторингин баштоо үчүн API'ни Башкаруу борборуна карай колдонот. Мониторингден алынган KPIлер оркестр тарабынан же өзүнчө Performance Management платформасы тарабынан үзгүлтүксүз чыгарылып турат.
Башкаруу борбору: NFVO же кызмат оркестринин көрсөтмөсү боюнча vTAны жайылтат, масштабдайт жана токтотот.

Performance Management системасы же Кызматтын сапатын башкаруу системасы: Control Center API аркылуу активдүү мониторингден KPI окуйт.
Мүчүлүштүктөрдү башкаруу системасы: Эгерде SLAлар бузулса, Башкаруу борборунан NETCONF, SNMP же электрондук почта эскертмелерин алат.

Paragon Active Assurance концепцияларынын аныктамалары

Сыноо агенттери: Paragon Active Assurance тутумунда өлчөөлөрдү (тесттер жана мониторлор үчүн) аткарган компоненттер. Сыноочу агенттер реалдуу тармак трафигин түзүү, кабыл алуу жана талдоо мүмкүнчүлүгү бар программалык камсыздоодон турат.
Бул документте талкууланган Сыноо Агентинин түрү гипервизордо орнотулган виртуалдык тармак функциясы (VNF) болгон Virtual Test Agent (vTA) болуп саналат. Test Agent башка түрлөрү да бар.

Paragon Active Assurance, тесттер жана мониторлордо өлчөөнүн эки негизги түрү бар.
Сыноо: Тест бир же бир нече кадамдардан турат, алардын ар биринин белгиленген, чектүү узактыгы бар. Кадамдар ырааттуу түрдө аткарылат. Ар бир кадам бир эле учурда бир нече тапшырмаларды аткарууну талап кылышы мүмкүн.

Монитор: Монитордун белгиленген узактыгы жок, бирок чексиз иштейт. Сыноодогу кадам сыяктуу эле, монитор бир эле учурда бир нече тапшырмаларды аткарышы мүмкүн.
Үлгү: Paragon Active Assurance оркестр тарабынан башкарылганда, тесттер жана мониторлор ар дайым тест же монитор аныкталган шаблондор аркылуу аткарылат. Параметрлердин жөндөөлөрү иштөө убагында калыпка киргизүү катары берилиши мүмкүн.

Автоматташтыруу үчүн иш процесси
Дизайн убактысы

Дизайн убагында Paragon Active Assurance программасында тесттер жана мониторлор үчүн шаблондорду түзүү менен өлчөөлөрдү даярдайсыз. Муну кантип жасоо керектиги 15-беттеги “Сыноо жана мониторинг үлгүлөрү” бөлүмүндө каралат.

Runtime
Иштөө учурунда сиз түзмөктөрүңүздү орнотуп, чыныгы өлчөөлөрдү жасайсыз.

An overview бардык эксamples берилген бөлүмдө табылган "ExampNETCONF & YANG API аркылуу Paragon Active Assurance Controlling les” 15-бетте.
Сыноо агенттерин кантип жайгаштыруу жана конфигурациялоо керектиги "Мисamples: Test Agents” 16-бетте.

TW сыяктуу инвентардык заттарды кантип импорттоо керекAMP рефлекторлор жана IPTV каналдары “Эксamples: Инвентаризациялык буюмдар” 29-бетте.
Ойготкучтарды кантип конфигурациялоо керектиги “Мисamples: Ойготкучтар” 35-бетте.

NETCONF аркылуу Paragon Active Assurance шаблондорун аткаруу менен тесттерди жана мониторлорду кантип иштетүү керек "Экс" бөлүмдөрүндө сүрөттөлгөн.amples: Tests” 43-беттеги жана “Мисamples: Мониторлор” 54-бетте.

Paragon Active Assurance программасында колдоого алынган функциялар

Paragon Active Assurance программасындагы бардык тест жана монитор түрлөрү калыптарды колдонуу аркылуу түзүлүп, аткарылышы мүмкүн. Муну кантип жасоо керектиги "Тесттер жана мониторлор" > "Шаблондорду түзүү" бөлүмүндөгү колдонмодогу жардамда камтылган.

Paragon Active Assurance эсептерин түзүү учурда колдоого алынбайт; бирок, колдонуучу үчүн бир же бир нече алдын ала аныкталган каттоо эсептери орнотулган болот.
Төмөнкү таблицаларда Paragon Active Assurance программасынын кандай функциялары бул чыгарылышта бар жана бул функциялар YANGде кандайча чагылдырылган.

YANG курулуштарын түшүндүрүү

Ыңгайлуулук үчүн, бул жерде өзгөчөлүк таблицасында айтылган YANG конструкцияларынын аныктамалары берилген.

Config (config=true): Конфигурация маалыматтары, системаны бир абалдан экинчи абалга которуу үчүн талап кылынат.
State (config=false): Мамлекеттик маалыматтар: конфигурация маалыматтары болбогон система боюнча кошумча маалыматтар, мисалы, окуу үчүн гана статус маалыматы жана чогултулган статистика.
RPC: NETCONF протоколунун ичинде колдонулган Remote Procedure Call.
Эскертме: NETCONF серверинен NETCONF кардарына жөнөтүлгөн окуя эскертмелери.

Оркестрация үчүн жеткиликтүү Paragon Active Assurance Функцияларынын таблицалары
Ресурс: Мониторинг
YANG жолу:/эсептер/эсептер/мониторлор

Өзгөчөлүк	Subfeature	YANG куруу
Мониторду түзүү/өзгөртүү/жок кылуу	Монитор үлгүсүнө негизделген	Конфигурация
Мониторду баштоо/токтот	–	Конфигурация
Монитор үлгүлөрү	Киргизүүлөрү менен учурдагы монитор шаблондорун тизмектеңиз	Мамлекет
NETCONF эскертмелери	Ойготкучтун абалы өзгөрдү	Эскертме
Натыйжаларды көзөмөлдөө	Жогорку деңгээл үчүн SLA/ES эсептегич (%) тапшырма деңгээли үчүн SLA/ES эсептегич (%)	Мамлекет

Тесттерден айырмаланып (салыштырыңыз: Төмөндөгү Тесттер), мониторлор RPC менен башталбайт, тескерисинче, монитордун конфигурациясын аткаруу менен башталат.
Ресурс: Тесттер
YANG жолу: /эсептер/эсептер/тесттер

Өзгөчөлүк	Subfeature	YANG куруу
Сыноону баштоо	Сыноо үлгүсүнө негизделген	RPC
Тесттерди башкаруу	Статусу менен тесттердин тизмеси	Мамлекет
Сыноо үлгүлөрү	Киргизүүлөр менен учурдагы сыноо шаблондорун тизмектеңиз	Мамлекет
NETCONF эскертмелери	Сынактын абалы өзгөрдү	Эскертме
Тесттин жыйынтыгы	Сыноо кадамынын статусун алуу (өттү, өтпөй калды, ката,…)	Мамлекет

Ресурс: Test Agents
YANG жолдору:

/accounts/account/test-agents (Config)
/accounts/account/registered-test-agents (штат)

/accounts/account/test-agents астындагы Сыноо Агенттери бул каттоо эсебинде конфигурацияланган агенттер. Оркестр тарабынан NETCONF аркылуу сыноолордо жана мониторлордо ушул Сыноо Агенттерин гана конфигурациялоого жана колдонууга болот.
Сиз Сыноо Агентин конфигурациялап, ал каттоо эсебине катталгандан кийин, Сыноо Агенти /accounts/account/registered-test-agents астында пайда болот. Сиз NETCONF ичиндеги “ал” буйругун колдонуп, бардык катталган тест агенттерин таба аласыз (Экс бөлүмүн салыштырыңызamples: Test Agents).
/accounts/account/registered-test-agents астында сиз дагы конфигурациялана элек Сыноо Агенттерин таба аласыз. Мындай Сыноо Агенттерин колдонуудан мурун конфигурациялоо керек.
Оркестрация сценарийинде, жалпысынан Paragon Active Assurance эсебиңиздин бардык конфигурациясын NETCONF аркылуу жасоо сунушталат. Бул тест-агенттер менен катталган тест-агенттердин айырмаланбашын камсыздайт.

Өзгөчөлүк	Subfeature	YANG куруу
Серверде Сыноо Агентин алдын ала түзүңүз	–	Конфигурация
Оффлайн Сыноо Агентин конфигурациялоо	(Башкаруу борбору конфигурацияны Сыноо Агентине түртөт Интернетке келгенде)	Конфигурация
Учурдагы/тышкы конфигурацияланган Сыноо Агенттерин колдонуңуз	Сыноодо/монитордо колдонуу	Конфигурация
	Интерфейстерди конфигурациялоо	Конфигурация
	Статус алуу	Мамлекет
Сыноо агентин конфигурациялоо (Тест аппараты гана)	NTP конфигурациялоо	Конфигурация
	Көпүрөлөрдү конфигурациялоо	Конфигурация
	VLAN интерфейстерин конфигурациялаңыз	Конфигурация
	SSH ачкычтарын конфигурациялоо	Конфигурация
	IPv6	Конфигурация
Utils	Кайра жүктөө	RPC
	Жаңыртуу	RPC
NETCONF эскертмелери	Онлайн статусу өзгөрдү	Эскертме
Статус	Системанын статусун алуу (иш убактысы, эстутумдун колдонулушу, орточо жүктөө, версия)	Мамлекет

Ресурс: Инвентаризация
YANG жолу: /accounts/count/twamp- рефлекторлор

Колдоого алынган NETCONF мүмкүнчүлүктөрү

Төмөнкү таблица Paragon Active Assurance оркестри үчүн колдонулган NETCONF мүмкүнчүлүктөрүн сүрөттөгөн IETF RFC'лерин көрсөтөт.

ietf-netconf.yang
IETF RFC 6241, Network Configuration Protocol (NETCONF), https://tools.ietf.org/html/rfc6241
Колдоого алынган каталарды иштетүүнүн бирден-бир ыкмасы - катага кайтаруу.
Колдоого алынган бирден-бир маалымат дүкөнү жазылышы мүмкүн.
ietf-netconf-notifications.yang
IETF RFC 5277, NETCONF Окуя билдирмелери, https://tools.ietf.org/html/rfc5277

Сыноо жана Монитор шаблондору
Сыноо жана монитор түрлөрү үчүн шаблондор Paragon Active Assurance алдыңкы колдонуучу интерфейси аркылуу кол менен орнотулушу керек. Муну кантип жасоо керектиги "Тесттер жана мониторлор" > "Шаблондорду түзүү" бөлүмүндөгү колдонмодогу жардамда камтылган.

ExampNETCONF & YANG API аркылуу Paragon Active Assurance Controlling les

Кийинки бөлүмдөрдө ылайыктуу тест жана мониторинг үлгүлөрү 15-беттеги “Сыноо жана Монитор шаблондору” бөлүмүндө берилген көрсөтмөлөргө ылайык аныкталган деп болжолдонууда.

Колдонулган куралдар Examples
Бардык эксampкийинки бөлүмдөрдөгү les төмөнкү эркин жеткиликтүү куралдарды колдонуу менен курулган:

Pang: YANG моделдерин визуализациялоо жана карап чыгуу үчүн колдонулат.
дареги боюнча жеткиликтүү https://github.com/mbj4668/pyang (gitтен клондоо жана python setup.py орнотууну иштетиңиз).
Python NETCONF кардары "ncclient": NETCONF аркылуу Башкаруу борбору менен байланышуу үчүн колдонулат.

https://github.com/ncclient/ncclient дареги боюнча жеткиликтүү (pip install ncclient иштетиңиз).
netrounds-ncc.yang маалымат модели /opt/netrounds-confd ичинде ConfD Орнотуу колдонмосуна ылайык орнотулгандан кийин табылат).

Бүттүview Аткарылган негизги милдеттердин

(Кээ бир мындан аркы тапшырмалар да төмөндө келтирилген.)

“Жаңы Сыноо Агентин түзүү жана жайылтуу” 16-бетте
“Инвентаризациялык элементтерди түзүү (мисалы, рефлекторлор)” 29-бетте
“Ойготкуч шаблондорун орнотуу жана сигналдарды кайда жөнөтүү” 35-бетте

“Тестти түзүү жана жүргүзүү” 45-бетте
“Тесттин жыйынтыгын алуу” 50-бетте
“Мониторду ишке киргизүү (ойготкучтарды орнотууну камтыйт)” 60-бетте
“Монитор үчүн SLA статусун алуу” 67-бетте
менен иштөө tags” 71-бетте

Examples: Test Agents

Бүттүview Test Agent Orchestration
Paragon Active Assurance тестирлөө агенттери оркестрлөө контекстинде "конфигурация" катары каралат. Бул Сыноо Агенттерин түзүү, көзөмөлдөө жана жок кылуу Paragon Active Assurance GUI аркылуу эмес, оркестр жана NETCONF аркылуу жүргүзүлүшү керек дегенди билдирет.
МААНИЛҮҮ: Эгерде Сыноо Агенти NETCONF & YANG API аркылуу түзүлбөстөн эле техник тарабынан орнотулуп, Башкаруу борборуна катталса, Сыноо Агенти конфигурациялар базасында жок болуп, система шайкештештирилбей калат. ConfD бул учурда Сыноо Агенти жөнүндө кабардар болушу үчүн, 4-беттеги “Конфигурациялар базасын башкаруу борбору менен синхрондоштуруу” бөлүмүндө кеңири айтылгандай, Башкаруу борбору менен жаңы синхрондоштурууну аткаруу керек болот.

Виртуалдык тест агенттерин (vTAs) уюштуруу, тескерисинче, төмөнкү кадамдар менен аткарылышы керек:

Башкаруу борборуна NETCONF & YANG интерфейсин колдонуп, анын интерфейс конфигурациясын кошкондо Virtual Test Agent түзүңүз. Сыноочу агенттин аты анын уникалдуу ачкычы болот.
VTAны виртуалдаштыруу платформасында жайгаштырыңыз. Сыноо агенттери > Орнотуу астындагы онлайн жардамдагы нускамаларды аткарыңыз. vTAга Башкаруу борборуна туташуу мүмкүнчүлүгүн берген негизги интерфейс конфигурациясы, ошондой эле аутентификация үчүн эсептик маалыматтар булут-init колдонуучу маалыматтарын колдонуу менен vTAга берилет.
vTA жүктөлгөндөн кийин, ал шифрленген OpenVPN туташуу аркылуу Башкаруу борборуна автоматтык түрдө туташат. vTAнын тест-агент-статус өзгөртүү параметринин мааниси эми “онлайн” болуп өзгөргөндүктөн, NETCONF эскертмеси жөнөтүлдү.
ЭСКЕРТҮҮ: vTA аталышы анын Башкаруу борборундагы идентификатору болгондуктан, бул ат 1-беттеги “17-кадамдагы” Башкаруу борборунда аныкталгандай болушу керек.
vTA Башкаруу борборуна туташып, аутентификациялангандан кийин, интерфейстин конфигурациясы vTAга түртүлөт. Бул vTA Башкаруу борборунда түзүлгөндө 1-беттеги “17-кадамда” берилген интерфейс конфигурациясы.

vTA өз максатына жеткенден кийин, vTAны жок кылыңыз.

Жаңы сыноо агентин түзүү жана жайылтуу

Адегенде NETCONF & YANG интерфейсин колдонуп Башкаруу борборуна Сыноо Агентин түзүшүбүз керек. Сыноочу агент ушундай жол менен түзүлгөндө, Башкаруу борбору менен синхрондоштуруунун кереги жок.
Сыноочу агент үчүн YANG модели төмөндөгүдөй. Ал буйруктун жыйынтыгы катары алынат
pyang -f дарак торлору-ncc.yang
Толук YANG модели "Тиркеме: Толук YANG моделинин дарак структурасы" 81-бетте берилген, ал ошондой эле ушул документте ушул жана башка YANG моделинин иллюстрацияларында колдонулган конвенцияларды түшүндүргөн легенданы камтыйт.

Төмөнкү кадамдар менен улантабыз, алар төмөнкүлөрдө кеңири чагылдырылган:

Башында, Paragon Active Assurance эсебинин "демо" инвентаризациясында Сыноо Агенттери жок.
"vta1" деп аталган Сыноо Агенти ncclient аркылуу түзүлгөн. Бул жерде сtage, чыныгы Test Agent азырынча жок (башкача айтканда, ал али баштала элек).
Test Agent OpenStackте жайгаштырылган. (Ошол платформада жайгаштыруу бул жерде башка мүмкүнчүлүктөрдүн бири катары тандалат.)

Test Agent Башкаруу борборунун "демо" эсебине туташып, азыр колдонууга даяр.
1-кадам: Башында "демо" эсебинде Сыноо Агенттери жок. Башкаруу борборунун GUIден төмөндөгү скриншотту караңыз.2-кадам: Башкаруу борборунда Python NETCONF кардары “ncclient” аркылуу Сыноо Агенти түзүлөт. Төмөндө DHCP дареги менен бир физикалык интерфейске ээ Сыноо Агентин түзүү үчүн ncclient коду:

argparse импорттоо
ncclient импорт менеджеринен
талдоочу = argparse.ArgumentParser(description='Сыноо агентин түзүү')
parser.add_argument('–host', help='ConfD табылган хосттун аталышы', талап кылынат=Чын)
parser.add_argument('–port', help='ConfD менен туташуу үчүн порт', талап кылынат=Чын)
parser.add_argument('–username', help='ConfD менен туташуу үчүн колдонуучунун аты', талап кылынат=Чын)
parser.add_argument('–password', help='ConfD каттоо эсебинин сырсөзү', талап кылынат=Чын)
parser.add_argument('–netrounds-account', help='NCC каттоо эсебинин кыскача аталышы', талап кылынат=Чын)
parser.add_argument('–test-agent-name', help='Тест агентинин аты', талап кылынат=Чын)
args = parser.parse_args()
manager.connect менен(host=args.host, port=args.port, username=args.username,
password=args.password, hostkey_verify=False) катары м:
# Башкаруу борборунда Test Agent түзүү
xml = """

)басып чыгаруу m.edit_config(target='иштеп жатат', config=xml)

ЭСКЕРТҮҮ: manager.connect(…) менен мурунку код кийинки эксample код үзүндүлөрү.
NTP сервери eth0де конфигурацияланган жана eth0 да башкаруу интерфейси (башкача айтканда, Башкаруу борборуна туташкан интерфейс).
Сыноочу агент колдонмосу учурда интерфейстерди конфигурациялоого уруксат бербейт. Ушул себептен улам, 2.34.0 версиясынан баштап YANG схемасында интерфейстин конфигурациясын өткөрүп жиберүүгө болот. Демек, тиешелүү XML бул учурда түп-тамырынан жөнөкөйлөтүлгөн:Сыноо Агенти түзүлгөндөн кийин, ал конфигурациялар базасында жана Башкаруу борборунда болот. Test Agent инвентаризациясынын төмөнкү скриншотун караңыз, анда Test Agent "vta1" көрсөтүлөт:

3-кадам: Азыр OpenStack'те Test Agent "vta1" жайгаштырууга убакыт келди.
Сыноо Агенти Башкаруу борборуна кантип туташуу керектиги жөнүндө маалыматты алуу үчүн булут-init колдонуучу дайындарын колдонот. Тактап айтканда, колдонуучу маалыматтарынын тексти file төмөнкү мазмунга ээ (#cloud-config жана netrounds_test_агент саптары болушу керек, ал эми калган саптар чегинүү болушу керек экенин эске алыңыз):

Кошумча маалымат алуу үчүн, OpenStack'те Виртуалдык Сыноо Агенттерин Кантип Орнотуу керек деген документти караңыз.
Сыноо агенти жайгаштырылып, Башкаруу борборуна туташкандан кийин, конфигурация Башкаруу борборунан Сыноо Агентине түртүлөт.

4-кадам: Сыноочу агент азыр Башкаруу борборунда онлайн жана анын конфигурациясын алды. Test Agent тесттерде жана мониторингде колдонууга даяр. Бул бөлүмдөрдү караңыз:

«Тестти баштоо» 45-бетте
“Мониторду ишке киргизүү” 60-бетте

Paragon Active Assurance эсебиңизде Сыноо Агенттерин тизмелөө
Төмөндө эксampParagon Active Assurance эсебинде Сыноо Агенттерин тизмелөө үчүн Python коду:

Бул кодду иштетүү төмөнкүдөй натыйжа берет:

Сыноочу агентти жок кылуу
Сыноо аяктагандан кийин, кээ бир учурларда Сыноо Агентин жок кылуу актуалдуу болушу мүмкүн.
Төмөндө ncclient менен муну кантип жасоону көрсөткөн код үзүндүсү:

NETCONF эскертмелери
Төмөндө биз жөнөкөй экс сунуштайбызampБашкаруу борборунан келген бардык NETCONF эскертмелерин угуу үчүн скрипт. Бул эскертмелер Сыноо Агенти оффлайн режимине өтүү же колдонуучу тарабынан башталган сыноо сыяктуу белгилүү бир окуялар орун алган сайын жөнөтүлөт. Билдирмелердеги маалыматтын негизинде, колдонуучулар оркестрде автоматташтырылган кийинки аракеттерди дайындай алышат.

Жогорудагы скрипт аткарылганда, NC кардары кабыл алынган билдирмени структураланган XMLде көрсөтөт. Мурун көрampТөмөндө Сыноо Агенти күтүлбөгөн жерден оффлайн режимине өтүп жатканын көрсөтөт.

2017-02-03T15:09:55.939156+00:00</eventTime>
<test-agent-status-change xmlns=’http://ncc.netrounds.com'>
демо
HW1
оффлайн

Examples: Инвентаризациялык заттар

TW сыяктуу инвентарларды түзүү (импорттоо) жана башкарууAMP рефлекторлор жана Y.1731 MEPs Сыноо Агенттери сыяктуу эле жасалат. Төмөндө NETCONF & YANG API аркылуу Paragon Active Assurance ичинде мындай объекттерди аныктоо жана аныкталган элементтердин тизмесин алуу үчүн XML жана NETCONF коду бар.

TW түзүүAMP Рефлектор

Y.1731 MEP түзүү

IPTV каналын түзүү

Ping хостун түзүү

SIP каттоо эсебин түзүү

Инвентаризациялык буюмдарды алуу
Төмөндө каттоо эсебинде аныкталган бардык инвентаризациялык элементтерди алуу үчүн Python коду бар. (Документте бир аз кайталанбашы үчүн инвентаризациялык объекттердин бардык түрлөрү бул жерде бир жолу менен алынып келинет. Албетте, төмөндөгү эсептин кээ бир саптарын калтыруу менен инвентарлык элементтердин каалаган бөлүгүн алып келүүгө болот.)

Бул кодду иштетүү төмөнкүдөй натыйжа берет:

Examples: Ойготкучтар

Ойготкуч шаблондору жана ага байланыштуу элементтер (SNMP менеджерлери, ойготкуч электрондук почта тизмелери) инвентаризациялык элементтер сыяктуу түзүлүп, башкарылат. Бул бөлүмдө NETCONF & YANG API аркылуу Paragon Active Assurance программасында мындай объекттерди аныктоо жана аныкталган элементтердин тизмесин алуу үчүн XML жана NETCONF коду камтылган.
Сигнал электрондук почта тизмелери
Ойготкучтун электрондук тизмесин түзүү

Бардык ойготкуч электрондук почта тизмелерин алуу

SNMP менеджерлери
SNMP менеджерин түзүү

Бардык SNMP менеджерлерин алуу

Ойготкуч шаблондору
Ойготкуч шаблон түзүү

Бардык ойготкуч шаблондор алынууда

Examples: SSH ачкычтары

NETCONF & YANG API аркылуу Сыноо Агентине SSH коомдук ачкычтарын кошо аласыз. Тиешелүү купуя ачкычты колдонуу менен сиз SSH аркылуу Test Agentке кире аласыз.
SSH ачкычтарындагы жеткиликтүү операциялардын толук тизмеси төмөнкүдөй:

SSH ачкычын кошуңуз
SSH ачкычын өзгөртүү
SSH ачкычын текшериңиз
SSH ачкычтарынын тизмеси
SSH ачкычын жок кылуу.
Төмөндө кошуу жана жок кылуу операциялары мисал келтирилген.

SSH ачкычын кошуу

Бул жерде жаңы SSH ачкычын кантип түзүү керек.

Juniper NETWORKS NETCONF & YANG API Программасы - Ачкыч

SSH ачкычын жок кылуу
Эгер сиз SSH ачкычын жок кылгыңыз келсе, төмөнкү буйрукту колдонуңуз:

Examples: Тесттер

Бул жерде 17-беттеги “Жаңы Сыноо Агентин түзүү жана жайылтуу” бөлүмүнө ылайык Сыноо Агенттери (тесттер үчүн талап кылынган санда) түзүлдү деп болжолдонууда.
Тесттер үчүн YANG моделдик жолдору

пункт	YANG моделинин жолу: /эсептер/эсептер/тесттер…
тесттер	/.
тест[id]	/тест
id	/test/id
аты	/тест/аты
статусу	/test/status
баштоо убактысы	/test/start-time
акыр заман	/test/end-time
отчет-url	/сыноо/отчет-url
кадамдар	/тест/кадамдар
кадам[id]	/test/steps/step
аты	/тест/кадамдар/кадам/аты
id	/test/steps/step/id
баштоо убактысы	/test/steps/step/start-time
акыр заман	/test/steps/step/end-time
статусу	/тест/кадамдар/кадам/статус
статус-билдирүү	/test/steps/step/status-message
шаблондор	/шаблондор
шаблон[аты]	/ Templates/template
аты	/ Templates/template/name
сүрөттөмө	/templates/template/description
параметрлери	/ Templates/template/parameters
параметр[ачкыч]	/templates/template/parameters/parameter
ачкыч	/templates/template/parameters/parameter/key
түрү	/templates/template/parameters/parameter/type

Сыноочу оркестрдин шарты

NC кардарын колдонуу менен NETCONF аркылуу тестти баштоо үчүн, адегенде "Тесттер жана мониторлор" > "Шаблондорду түзүү" бөлүмүндөгү колдонмодогу жардамда чоо-жайы айтылгандай, Башкаруу борборунун GUI аркылуу сыноо үлгүсүн түзүү керек. Бул калыпта "Шаблон киргизүү" катары көрсөтүлгөн бардык талаалар сыноо үлгүсүн баштоону уюштурууда XMLде параметр катары талап кылынат.

Paragon Active Assurance программасында иштеп жаткан тесттер оркестрдин контекстинде "мамлекет" катары каралат. Мамлекеттик маалыматтар - бул "Ашыкча" бөлүмүндө айтылган конфигурация маалыматтарынан айырмаланып, конфигурация маалымат базасында сакталбаган жазылышы мүмкүн эмес маалымат.view Test Agent Orchestration of Test Agent Orchestration” бетте 17. Бул, негизинен, Башкаруу борборунун GUIиндеги тесттерге же шаблондорго өзгөртүүлөр Башкаруу борбору менен конфигурациялар базасынын ортосунда синхрондоштурууга байланыштуу көйгөйлөрдү жаратпайт дегенди билдирет.
отчет алуу үчүн -URL туура сыноо отчетторунда, сиз Control Center ынануу керек URL туура конфигурацияланган. Бул жасалат file /opt/netrounds-confd/settings.py. Демейки боюнча Башкаруу борборунун хост аты socket.gethostname() аркылуу чыгарылат: төмөндө караңыз. Эгер бул туура натыйжа бербесе, сиз хосттун атын (же бүтүндөй URL) бул жерде кол менен file.

# URL сызыксыз башкаруу борборунун.
# Бул мурунку үчүнampсыноо отчетунда колдонулган -url.
HOSTNAME = socket.gethostname()
NETROUNDS_URL = 'https://%s' % HOSTNAME
Сынакты баштоо
17-беттеги “Жаңы сыноо агентин түзүү жана жайылтуу” бөлүмүндө сүрөттөлгөндөй, pang -f tree netrounds-ncc.yang буйругун аткарыңыз.
YANG моделин чыгаруу үчүн /opt/netrounds-confd/ каталогунан. Бул моделде NC кардарын колдонуу менен тестти баштоо үчүн RPC төмөнкүдөй көрүнөт:

Түшүндүрүү үчүн бөлүмдү караңыз «Легенда» 81-бетте Тиркемеде.

Төмөнкү кадамдар төмөндө көрсөтүлгөн:

Test Agents Paragon Active Assurance эсебине катталды, бирок азырынча эч кандай сыноолор баштала элек.
Керектүү киргизүү параметрлери иштетиле турган сыноо үлгүсүндө аныкталган.

60 секунддук HTTP тести ncclient аркылуу башталат.

Кадам 1: Башында Paragon Active Assurance эсебинде эч кандай сыноолор башталган эмес. Башкаруу борборунун GUIден төмөндөгү скриншотту караңыз.
Кадам 2: Бул мурунку тестти баштоо үчүн колдоно турган шаблонample HTTP сыноо үлгүсү. Анын эки милдеттүү киргизүү талаалары бар (Кардарлар жана URL) Башкаруу борборунун GUIде шаблонду курууда биз көрсөткөн.

Бул параметрлерди (башкалардын арасында) NETCONF менеджерибиз (ncclient) конфигурация маалымат базасына байланыштырылган XML конфигурациясында аныктайбыз.
3-кадам: HTTP тести ncclient аркылуу башталат.
Төмөндө эксampталап кылынган конфигурация маалыматы жана параметрлери HTTP сыноо үлгүсү үчүн көрсөтүлгөн код. Үлгү кандайча курулганына жараша, бул жердеги деталдар ар кандай болушу мүмкүн.
Ар бир параметр үчүн атрибут менен камсыз кылуу керек. Ачкыч параметрдикине окшош
Башкаруу борборунда өзгөрмө аты. Сиз өзгөрмө аталыштарын төмөнкүдөй текшере аласыз:

Капталдагы тилкедеги Тесттер баскычын чыкылдатып, Жаңы Сыноо ырааттуулугун тандаңыз.

Менин калыптарым чыкылдатыңыз.
Кызыккан шаблондун астындагы Түзөтүү шилтемесин басыңыз.
Жогорку оң бурчтагы киргизүүнү түзөтүү баскычын чыкылдатыңыз.

Биздин мурункуample, жана демейки боюнча, өзгөрмө аттары Башкаруу борборунда көрүлгөн дисплей аталыштарынын жөн гана кичине тамгалары болуп саналат ("url" vs. "URL", жана башкалар.). Бирок, Башкаруу борборунун GUIде сиз өзгөрмөлөрдүн атын каалагандай өзгөртө аласыз.
Ачкычтан тышкары, ар бир параметр анын түрүн көрсөтүшү керек: мисалыampле, үчүн URL.
Сураныч, кайра керек экенин эске алыңызview түрлөрү боюнча толук маалымат алуу үчүн толук YANG модели. Test Agent интерфейстери үчүн түрү төмөндө далилденгендей татаалыраак түзүлүшкө ээ төмөнкү коддо.

Эми ncclient аркылуу скриптти иштете алабыз. Баары туура деп ойлосок, сыноо башталат жана анын аткарылышы Башкаруу борборунда көрсөтүлөт:Эгер тест ийгиликтүү башталса, Башкаруу борбору тест ID менен жооп берет. Бул эксample, тест ID 3:Сынактын ID'син да тапса болот URL Башкаруу борборунун GUIдеги сыноо үчүн. Бул эксampле, ошол URL бул https://host/demo/testing/3/.
Сынактын натыйжалары алынууда
Тесттин жыйынтыгын алуунун эң жөнөкөй жолу - тесттин идентификаторун көрсөтүү.
Төмөндө ID = 3 менен жогорудагы HTTP тестинин натыйжаларын алуу үчүн Python коду:
менеджер менен. Туташуу(host=args.host, port=args.port, username=args.username,password=args.password, hostkey_verify=False) м катары:

Чыгуу төмөнкүдөй болот:

Сыноо үлгүлөрүн экспорттоо жана импорттоо
Сыноо үлгүлөрүн JSON форматында экспорттоого жана ошол форматта Башкаруу борборуна кайра импорттоого болот. Башкаруу борборунун башка орнотуусунда сыноо үлгүлөрүн колдонгуңуз келсе, бул пайдалуу. (Шаблондорду баштапкы түзүү башкаруу борборунун GUI аркылуу эң жакшы аткарылат.)
Төмөндө экспорттоо жана импорттоо үчүн код бар.
Сыноо үлгүлөрү экспорттолууда

# Жооптон json конфигурациясын алыңыз
root = ET.fromstring(response._raw)
json_config = root[0].text
json_config басып чыгаруу
Үлгү json_config объектинде камтылган.
Сыноо шаблондорун импорттоо
Сыноо үлгүлөрүн камтыган JSON конфигурациялоо объектисин Башкаруу борборуна төмөндөгүдөй кайра импорттоого болот.

Examples: Мониторлор

Бул бөлүм Сыноо Агенттери (мониторлор талап кылгандай көп) 17-беттеги “Жаңы Сыноо Агентин түзүү жана жайылтуу” бөлүмүнө ылайык түзүлгөн деп болжолдойт.
Мониторлор үчүн YANG моделдик жолдору

пункт	YANG моделинин жолу: /эсептер/эсептер/мониторлор…
мониторлор	/.
монитор[аты]	/монитор
аты	/monitor/name
сүрөттөмө	/monitor/description
башталды	/монитор/башталды
шаблон	/monitor/template
ойготкуч конфигурациялары	/monitor/signal-configs
пункт	YANG моделинин жолу: /эсептер/эсептер/мониторлор/монитор/ойготкуч-конфигурациялар…
alarm-config[идентификатору]	/ alarm-config
идентификатор	/ alarm-config/identifier
шаблон	/ alarm-config/template
электрондук почта	/ 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-major	/ 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-эскертүү	/ alarm-config/thr-es-warning
Thr-es-эскертүү-айкын	/ alarm-config/thr-es-warning-clear
маалымат катуулугу жок	/signal-config/no-data-severity
маалымат жок	/ alarm-config/no-data-timeout
иш-аракет	/signal-config/action
терезе өлчөмү	/ alarm-config/window-size
интервал	/signal-config/interval
бир гана жолу жөнөтүү	/сигнал-конфигурация/жөнөтүү-бир гана
snmp-trap-per-stream	/alarm-config/snmp-trap-per-stream
пункт	YANG моделинин жолу: /эсептер/эсептер/мониторлор…
параметрлери	/monitor/parameters
пункт	YANG моделинин жолу: /эсептер/эсептер/мониторлор/монитор/параметрлер…
параметр[ачкыч]	/параметр
ачкыч	/параметр/ачкыч
(нарк түрү)	/параметр
:(бүтүн)	/параметр
бүтүн сан	/parameter/integer
:(сүзүү)	/параметр
сүзүү	/parameter/float
:(сап)	/параметр
пункт	YANG моделинин жолу: /эсептер/эсептер/мониторлор/монитор/параметрлер…
сап	/параметр/сап
:(тест-агент-интерфейстер)	/параметр
тест-агент-интерфейстер	/parameter/test-agent-interfaces
тест-агент-интерфейси[“1” 58-бетте	/parameter/test-agent-interfaces/
эсеп	/параметр/test-agent-interfaces/test-agent-interface/аккаунт
тест-агент	/parameter/test-agent-interfaces/test-agent-interface/test-agent
интерфейс	/parameter/test-agent-interfaces/test-agent-interface/interface
ip-версия	/parameter/test-agent-interfaces/test-agent-interface/ip-version
:(twamp- рефлекторлор)	/параметр
twamp- рефлекторлор	/parameter/twamp- рефлекторлор
twamp-рефлектор[аты-жөнү]	/parameter/twamp-рефлекторлор/twamp- рефлектор
аты	/parameter/twamp-рефлекторлор/twamp-рефлектор/аты
:(y1731-meps)	/параметр
y1731-meps	/parameter/y1731-meps
y1731-mep[аты-жөнү]	/параметр/y1731-meps/y1731-mep
аты	/parameter/y1731-meps/y1731-mep/name
:(сип-эсептер)	/параметр
сип-эсептер	/parameter/sip-counts
sip-аккаунт[2-беттеги “58”]	/параметр/sip-accounts/sip-account
эсеп	/параметр/sip-аккаунттары/sip-эсеп/эсеп
тест-агент	/параметр/sip-аккаунттары/sip-аккаунт/test-агент
интерфейс	/параметр/sip-аккаунттары/sip-аккаунт/интерфейс
sip-дареги	/параметр/sip-accounts/sip-account/sip-дареги
:(iptv-каналдар)	/параметр
iptv-каналдар	/параметр/iptv-каналдар
iptv-канал[аты]	/parameter/iptv-channels/iptv-channel
аты	/parameter/iptv-channels/iptv-channel/name

эсеп тест-агент интерфейси
эсеп тест-агент интерфейси sip-дареги

пункт	YANG моделинин жолу: /эсептер/эсептер/мониторлор…
статусу	/monitor/status
акыркы - 15 мүнөт	/монитор/статус/акыркы 15 мүнөт
статусу	/монитор/статус/акыркы 15 мүнөт/статус
статус-маани	/монитор/статус/акыркы 15 мүнөт/статус-маани
акыркы саат	/monitor/status/акыркы саат
статусу	/монитор/статус/акыркы саат/статус
статус-маани	/монитор/статус/акыркы саат/статус-маани
акыркы 24 саат	/монитор/статус/акыркы 24 саат
статусу	/монитор/статус/акыркы 24 саат/статус
статус-маани	/монитор/статус/акыркы 24 саат/статус-маани
шаблондор	/шаблондор
шаблон[аты]	/ Templates/template
аты	/ Templates/template/name
сүрөттөмө	/templates/template/description
параметрлери	/ Templates/template/parameters
параметр[ачкыч]	/templates/template/parameters/parameter
ачкыч	/templates/template/parameters/parameter/key
түрү	/templates/template/parameters/parameter/type

Мониторлорду уюштуруу үчүн зарыл шарттар
NCclient аркылуу NETCONF аркылуу мониторду баштоодон мурун, "Тесттер жана мониторлор" > "Шаблондорду түзүү" бөлүмүндөгү колдонмодогу жардамда түшүндүрүлгөндөй, Башкаруу борборунун GUIде монитор үлгүсүн түзүшүңүз керек. Ал калыпта "Шаблон киргизүү" катары көрсөтүлгөн бардык талаалар шаблонду баштоону уюштурууда XMLде параметр катары талап кылынат.
Монитор калыптарынан киргизүү параметрлерин алуу
Төмөндө эки шаблон көрсөтүлгөн. Биринчиси, эки Test Agent интерфейсинин ортосундагы UDP мониторинги үчүн, ал эми экинчиси бир Test Agent интерфейсин колдонуу менен HTTP үчүн.
Калыптын киргизүү параметрлерин билүү үчүн, шаблонду көрсөткөн кутучаны басыңыз. HTTP шаблоны үчүн параметрлер төмөнкүдөй болушу мүмкүн:

Мониторду баштаганда кийинки кадамда бул параметрлерди аныкташыбыз керек.
Мониторду баштоо
17-беттеги “Жаңы сыноо агентин түзүү жана жайылтуу” бөлүмүндө биз аныктаган жана орноткон Сыноо Агенттерин колдонуу менен, биз төмөндө көрсөтүлгөндөй “HTTP” үлгүсүнөн мониторду баштасак болот.
Ар бир параметр үчүн атрибут менен камсыз кылуу керек. Ачкыч Башкаруу борборундагы параметрдин Өзгөрмө аты менен бирдей. Сиз өзгөрмө аталыштарын төмөнкүдөй текшере аласыз:

Капталдагы тилкедеги Мониторингди чыкылдатып, Жаңы мониторду тандаңыз.

Менин калыптарым чыкылдатыңыз.
Кызыккан шаблондун астындагы Түзөтүү шилтемесин басыңыз.
Жогорку оң бурчтагы киргизүүнү түзөтүү баскычын чыкылдатыңыз.

Биздин мурункуample, жана демейки боюнча, өзгөрмө аттары Башкаруу борборунда көрүлгөн дисплей аталыштарынын жөн гана кичине тамгалары болуп саналат ("url" vs. "URL", жана башкалар.). Бирок, Башкаруу борборунун GUIде сиз өзгөрмөлөрдүн атын каалагандай өзгөртө аласыз.
Ачкычтан тышкары, ар бир параметр анын түрүн көрсөтүшү керек: мисалыampле, үчүн URL. Параметрдин түрү боюнча толук маалымат YANG моделинде табылганын эске алыңыз. Test Agent интерфейстери үчүн түрү төмөндөгү коддо далилденгендей татаалыраак түзүлүшкө ээ.
мурдагыampАндан кийин, эч кандай сигнал монитор менен байланышпайт. Мисалы үчүнampОйготкучтар үчүн 62-беттеги “Мониторду сигнализация менен баштоо” бөлүмүнө өтүңүз.

Мониторду сигнализация менен баштоо
Ойготкучту монитор менен байланыштыруу үчүн, сиз аныкталган ойготкуч шаблонду көрсөтсөңүз болот, же мониторду түзүп жатканда бүт ойготкуч конфигурациясын бере аласыз. Бир экси беребизampтөмөнкү ар бир ыкманын le.
Ойготкуч шаблонду көрсөтүү менен монитордун ойготкучту орнотуу
Ойготкуч шаблонду колдонуу үчүн анын идентификаторун билишиңиз керек. Бул үчүн, адегенде 39-беттеги “Бардык Ойготкуч шаблондорун алуу” бөлүмүндө сүрөттөлгөн бардык ойготкуч шаблондоруңузду чыгарып алыңыз жана тиешелүү шаблондун атын белгилеңиз. Андан кийин сиз бул шаблонго төмөнкүдөй кайрыла аласыз:

Түздөн-түз конфигурациялоо менен монитордун ойготкучту орнотууy
Же болбосо, монитордун шаблонуна кайрылбастан, мониторду түзүүдө анын бүт конфигурациясын берүү менен, сигнализацияны орното аласыз. Бул төмөнкү мисалда көрсөтүлгөндөй жасалатample.

Иштеп жаткан мониторлорду алуу
Учурда аткарылып жаткан бардык мониторлорду алуу үчүн бул сценарийди иштетиңиз:
менеджер менен. туташтыруу(host=args.host, port=args.port, username=args. username, password=args.password, hostkey_verify=False) м катары:

Чыгуу төмөндө көрсөтүлгөндөй бардык иштеп жаткан мониторлордун тизмеси:

Монитор үчүн SLA статусу алынууда
Бул жерде монитор үчүн SLA статусун кантип алуу керек. Бул эксample, биз үч убакыт аралыгы үчүн “Тармактын сапаты” мониторунун SLA статусун алып жатабыз: акыркы 15 мүнөт, акыркы саат жана акыркы 24 саат.

Чыгуу төмөнкүдөй болот:

NETCONF эскертмелери
Мониторлор үчүн NETCONF эскертмелери SLA бузуулардан улам пайда болот. Булар монитор үчүн SLA белгиленген убакыт терезесинде, демейки боюнча акыркы 15 мүнөт ичинде SLA босогосунан ("Жакшы" же "Кабыл алынуучу") төмөн түшкөндө пайда болот. Белгилей кетчү нерсе, SLA бузуу билдирмелери кызматка маселе таасир эткенден кийин тез пайда болот, ал эми SLA статусу 15 мүнөттөн кийин гана "Жакшы" абалына кайтып келет жана мындан ары бузуулар болбосо гана.
Убакыт терезесин SLA_STATUS_WINDOW жөндөөсүн (секунддагы маани) түзөтүү аркылуу өзгөртүүгө болот /etc/netrounds/netrounds.conf.
Монитор үлгүлөрүн экспорттоо жана импорттоо
Бул тест шаблондоруна окшоп жасалат; 52-беттеги “Сыноо үлгүлөрүн экспорттоо жана импорттоо” бөлүмүн салыштырыңыз. Төмөндөгү код үзүндүлөрү мониторлор үчүн калыптарды экспорттоо жана импорттоо жолдорун көрсөтөт.
Монитордун калыптары экспорттолууда

Монитор шаблондорун импорттоо

Колдонуу Tags

Tags Paragon Active Assurance менен аныкталган:

мониторлор
мониторинг үлгүлөрү
Test Agents
TWAMP рефлекторлор
Пинг хосттору.
Мисалы үчүнampле, мүмкүн tag ошол эле монитор tag мониторду иштете турган Сыноо Агенттеринин бир бөлүгү катары. Эгер сизде көп сандагы мониторлор жана калыптар аныкталган болсо, бул өзгөчөлүк өзгөчө пайдалуу.

Эгер сиз монитор үчүн SNMP капкандары менен ойготкуч орноткон болсоңуз, анда SNMP тузактары бирдей дайындалат. tags монитор катары, эгерде бар болсо.
Түзүү Tags
Төмөндө биз кантип түзүүнү көрсөтөбүз tag XML тарабынан аныкталган аты жана түсү мененtag> подструктура.

дайындоо а Tag
дайындоо үчүн а tag ресурска, сиз аны жаңы катары кошосузtag> астындагы элементtags> бул ресурс үчүн элемент.
Бул жерде а кантип дайындоо керек tag Сыноочу агентке:

дайындоо үчүн а tag бир TWAMP рефлектор, төмөнкүнү аткарыңыз:

дайындоо а tag монитор менен иштөө дал ушундай жол менен жүргүзүлөт:

Же болбосо, сиз бар дайындай аласыз tag ресурсту түзүүдө бул ресурс түрлөрүнүн бирине, анын ичиндеtags> камтыган элемент tag суроодо.
Жаңыртуу а Tag
Учурдагы жаңыртуу tag жаңы атрибуттары менен а түзүүгө окшош tag:

Дайындоону алып салуу а Tag
А tag булактан nc:operation=”delete” атрибутун кошуңузtag> ресурска таандык элемент. Төмөндө биз а tag монитордон.

Жок кылуу а Tag
Жок кылуу үчүн а tag Башкаруу борборунан толугу менен nc:operation="delete" атрибуту кайрадан колдонулат, бирок бул жолу tag астында аныкталат .

Проблемаларды чечүү

Маселе: Оркестр жана Парагондун Active Assurance синхрондоштуруудан тышкары
Оркестр жана Paragon Active Assurance мурунку үчүн синхрондобой калышы мүмкүнampЭгерде конфигурацияга өзгөртүүлөр Башкаруу борборунун GUIинде жасалган болсо, же конфигурацияны колдонуу ийгиликтүү болбой, мурунку абалга кайтуу ишке ашпай калса.
Артка кайтаруу ишке ашпай калган учурда, NETCONF сервери конфигурациянын өзгөртүүлөрүн мындан ары кабыл албайт; ал конфигурация кайра синхрондогонго чейин кулпуланган деген ката билдирүүсү менен жооп берет. Кайра синхрондоштуруу жана конфигурация өзгөртүүлөрүнүн кулпусун ачуу үчүн сиз Башкаруу борборунан конфигурация базасына бардык конфигурацияларды синхрондоштуруучу rpc sync-from-ncc буйругун аткарышыңыз керек.
ЭСКЕРТҮҮ: The confd@netrounds.com баары ийгиликтүү шайкештештирилиши үчүн колдонуучу (же конфигурацияланган нерсе) супер колдонуучу артыкчылыктарына ээ болушу керек. Буга ncc user-update буйругу менен жетүүгө болот confd@netrounds.com –is-superuser Эгерде колдонуучу супер колдонуучу болбосо, баары синхрондоштурууга мүмкүн эмес, бирок иштетиле турган нерселердин баары аткарылды деген эскертүү пайда болот.
ЭСКЕРТҮҮ: Эгерде сиздин оркестриңиз конфигурацияны да сактаса, сиз аны да кайра синхрондоштурууңуз керек болот, анткени суралган конфигурация (оркестр Башкаруу борбору күткөн конфигурация) колдонулбайт.
Көйгөй: Колдоого алынбаган булактардан улам баштапкы синхрондоштуруу (ncc-ден синхрондоштуруу) ишке ашкан жок
Эгер сиз rpc sync-from-ncc файлын башкаруу борборунун GUIде түзүлгөн каттоо эсебинде иштетүүгө аракет кылсаңыз, каттоо эсеби колдоого алынбаган ресурстарды камтыса, көйгөйлөргө туш болушуңуз мүмкүн. Бош эсеп менен баштоо жана анын бардык конфигурациясын NETCONF аркылуу жасоо сунушталат. Болбосо, ресурстук кагылышуулар менен көйгөйлөргө туш болсоңуз, карама-каршы келген ресурстарды каттоо эсебинен алып салышыңыз керек болот.
Көйгөй: NETCONF буйруктары ncclient.operations.rpc.RPCE менен ишке ашпай калды Ката: колдонмо байланышы катасы
NETCONF сервери Башкаруу борбору кайра иштетилсе, Башкаруу борборунун серверине туташууну автоматтык түрдө калыбына келтирбейт. Башкаруу борборуна байланышты калыбына келтирүү үчүн NETCONF процессин кайра баштаңыз: sudo systemctl restart netrounds-confd

Сыноо Агенти Тиркемелери жана Сыноо Агенти Приборлору боюнча эскертүүлөр

ConfD ичиндеги сыноо агенти тиркемелери
Сыноо агенттеринин арасында (жаңы) Test Agent Колдонмосу (эски) Test Agent Applianceдан бир аз башкача иштейт.
Test Agent Тиркемелери учурда интерфейс конфигурациясын колдобойт. Ошондуктан, YANG схемасы мындай Сыноо Агенттери үчүн бош интерфейс конфигурациясын көрсөтүүгө мүмкүндүк берет. 23-беттеги “бул үзүндүнү” караңызample.
ConfD маалыматтар базасын Башкаруу борбору менен синхрондоштуруудан NCC буйругун колдонуп синхрондоштурууда, интерфейс конфигурациясынын бош бойдон калышын жана Башкаруу борборунда табылган нерсенин үстүнөн жазылбашын каалайсыз. Ошондуктан, Test Agent Тиркемелери менен иштөөдө атайын желекти –without_interface_config колдонуу керек.
Test Agent Appliance үчүн бош интерфейс конфигурациясы
Жогоруда белгиленгендей, Test Agent Колдонмосу интерфейс конфигурациясын колдобойт, ошондуктан YANG схемасында интерфейстерди өткөрүп жиберүүгө болот.
Бирок сиз Сыноо Агентинен интерфейс конфигурациясын өткөрүп жиберүүнү каалаган учурлар да бар. МурункуampБул сиз булут-init аркылуу Сыноо Агентин айландырып жаткан оркестрдин сценарийи болушу мүмкүн жана сиз Сыноо Агент онлайнга келгенде ConfD аны кайра жазууга уруксат бербестен, интерфейс конфигурациясын колдонууну каалайсыз.
YANG схемасы аныкталбаган интерфейстерге байланыштуу өзгөрүүлөр
Эми бош интерфейс конфигурациясына уруксат берилгендиктен (2.34.0 версиясынан баштап), тесттин же монитордун бир бөлүгү катары иштеп жаткан тапшырмага киргизүү катары каалаган интерфейстин атын көрсөтүүгө болот.
Бул Test Agent Тиркемесин колдонуу үчүн талап кылынат, анткени алар үчүн ConfDде интерфейстин аталыштары аныкталган эмес. Бирок, бул кокустан сиз тестти же мониторду жок интерфейсти колдонууга конфигурациялап алсаңыз, көйгөйлөргө туш болушуңуз мүмкүн экенине көңүл буруңуз. Андыктан муну эске алыңыз.
ConfDде түзүлгөн тесттик агентти каттоодо чектөөлөр
REST же NETCONF/YANG API аркылуу Сыноо Агентин түзүп жатканда, анын кайсы түрү экенин алдын ала биле албайбыз: Сыноо Агенти Колдонмо же Сыноо Агент Тиркеме. Бул Сыноо Агенти катталгандан кийин айкын болот.
Сыноо Агенти катталгандан кийин жана ушул конкреттүү түрлөрдүн бирине айлангандан кийин, сиз аны Сыноо Агентинин башка түрү катары кайра каттай албайсыз. Бул сизге адегенде аны Сыноо Агенти Колдонмосу катары каттоого, андан кийин Сыноо Агенти Тиркеме катары кайра каттоого же тескерисинче уруксат берилбейт дегенди билдирет. Эгер сизге башка түрдөгү Сыноо Агенти керек болсо, жаңы Сыноо Агентин түзүшүңүз керек болот.

Тиркеме: Толук YANG моделинин дарак структурасы

Бул тиркемеде 81-беттеги “Легенда” бөлүмү pyang -f дарак буйругу менен түзүлгөн YANG моделинин дарак структурасынын синтаксисин түшүндүрөт.
82-беттеги “YANG моделинин дарак структурасы” бөлүмү netrounds-ncc.yang үчүн колдонулган буйруктун натыйжасын берет. Бул чыгаруунун бөлүктөрү документтин башка жеринде кайра чыгарылат.
Легенда

YANG модели дарак структурасы

Juniper Networks, Juniper Networks логотиби, Juniper жана Junos Кошмо Штаттардагы жана башка өлкөлөрдө Juniper Networks, Inc. компаниясынын катталган соода белгилери болуп саналат. Бардык башка соода белгилери, тейлөө белгилери, катталган белгилер же катталган тейлөө белгилери тиешелүү ээлеринин менчиги болуп саналат. Juniper Networks бул документтеги так эместиктер үчүн эч кандай жоопкерчиликти албайт. Juniper Networks бул басылманы эскертүүсүз өзгөртүү, өзгөртүү, өткөрүп берүү же башка жол менен кайра карап чыгуу укугун өзүнө калтырат. Copyright © 2023 Juniper Networks, Inc. Бардык укуктар корголгон.

Документтер / Ресурстар

Juniper NETWORKS NETCONF & YANG API Программасы [pdf] Колдонуучунун колдонмосу
NETCONF YANG API Программасы, YANG API Программасы, API Программасы, Программалык камсыздоо

Шилтемелер

User Manual

Introduction