NETCONF & YANG API Orkestrasi
PanuntunDiterbitake
2023-07-07
RELEASE 4.2
Pambuka
Tujuan Dokumen Iki
Dokumentasi iki nerangake carane nggabungake Paragon Active Assurance karo orkestra layanan jaringan liwat Control Center NETCONF & YANG API. Ex tanganamples diwenehi saka tugas utama melu, kalebu: nggawe lan deploying Virtual Test Agents, mbukak tes lan monitor, lan njupuk asil saka aktivitas iki.
Ing dokumen iki, ncclient klien Python NETCONF sing kasedhiya gratis digunakake ing peran orkestra.
Konvensi
Singkatan ing ngisor iki digunakake ing dokumen iki:
Singkatan | Tegese |
CLI | Antarmuka Command Line |
EM | Manajer Unsur |
ES | Salah Kapindho |
MEP | MEG (Maintenance Entity Group) End Point (ITU-T Y.1731 definition) or Maintenance End Point (Definisi Cisco) |
NFV | Virtualisasi Fungsi Jaringan |
NFVO | Network Function Virtualization Orchestrator |
NSD | Deskriptor Layanan Jaringan |
RPC | Telpon Prosedur Remote |
SIP | Protokol Inisiasi Sesi |
SLA | Perjanjian Tingkat Layanan |
S-VNFM | Manajer VNF khusus |
VNF | Fungsi Jaringan Virtual |
vTA | Agen Tes Virtual |
Cathetan babagan Kompatibilitas Mundur
Ing versi 2.35.4/2.36.0 saka NETCONF & YANG API, validasi panjalukan tartamtu digawe luwih kenceng kanggo netepi standar NETCONF. Iki tegese kode klien adhedhasar versi lawas saka pandhuan iki saiki bisa ditolak.
Kanggo example, ing Python ex sadurungéampkode, ora ana atribut namespace diwenehake. Ruang jeneng saiki kudu diwenehake ing XML panyuwunan kapan wae sampeyan pengin ngowahi sumber daya ConfD.
Prasyarat lan Persiapan
Instalasi ConfD
ConfD (produk saka Tail-f) digunakake minangka perantara antarane sistem Paragon Active Assurance lan NETCONF. ConfD nyambungake konfigurasi Paragon Active Assurance lan data operasional menyang NETCONF & YANG API.
ConfD kudu diinstal bebarengan karo piranti lunak Pusat Kontrol, kaya sing diterangake ing Pandhuan Instalasi.
Priksa manawa ConfD lagi mlaku
Kanggo verifikasi manawa ConfD wis aktif, jalanake printah kasebut
ssh -s @localhost -p 830 netconf
kanggo mriksa manawa ConfD nanggapi ing port 830. Ing printah kasebut, minangka ditetepake dening pangguna netconf nggawe
printah ing Guide Instalasi, bagean Nginstal ConfD. Menehi sandi ditetepake dening printah padha.
Ing output, verifikasi manawa modul Pusat Kontrol kalebu. Output kudu ngemot baris kaya ing ngisor iki:
http://ncc.netrounds.com?module=netrounds-ncc&revisi=2017-06-15
Sinkronisasi Database Konfigurasi karo Pusat Kontrol
Pungkasan, kita kudu nganyari database konfigurasi liwat NETCONF. Kita bakal nindakake ing kene kanthi nggunakake perpustakaan Python sing diarani ncclient (Klien NETCONF). Nanging, tugas kasebut uga bisa ditindakake ing basa pamrograman sing beda anggere nggunakake protokol NETCONF/YANG.
Peran ncclient yaiku tumindak minangka klien menyang server ConfD sing dadi host NETCONF/YANG API.
Perlu dicathet yen ncclient ora ana hubungane karo Pusat Kontrol (sadurunge "Pusat Kontrol Jaringan"), sanajan jeneng kasebut diwiwiti kanthi "ncc".
Mangkene carane nginstal ncclient:
- Download piranti lunak saka https://github.com/ncclient/ncclient.
- Jalanake printah iki: pip install ncclient
Saiki kita bisa nindakake sinkronisasi kaya ing ngisor iki. Elinga kanthi ati-ati manawa iki kudu ditindakake ing komputer sing kapisah, lan ora ing server Pusat Kontrol dhewe:
#
# CATATAN:
# Skrip iki tumindak minangka klien menyang ConfD mlaku ing server NCC.
# Bakal nggunakake NETCONF/YANG API kanggo komunikasi.
CATETAN: Prosedur iki uga dibutuhake nalika Agen Tes wis diinstal lan didaftar kanthi mandiri saka NETCONF. Deleng cathetan ing bagean "Swaraview saka Test Agent Orchestration" ing kaca 17 kanggo informasi luwih lengkap.
Nyetel Multiple NETCONF-kontrol Paragon Active Assurance Accounts
Langkah-langkah ing ngisor iki mung dibutuhake yen sampeyan pengin nyiyapake akun Paragon Active Assurance sing bakal dikontrol dening NETCONF, saliyane akun sing dikonfigurasi kanthi cara iki ing Pandhuan Instalasi, bagean "Nginstal ConfD".
Kanggo saben akun kasebut, tindakake ing ngisor iki:
- Ing Pusat Kontrol, mlebu menyang akun banjur navigasi menyang Akun > Idin.
- Tambah pangguna "confd@netrounds.com", lan wenehi idin admin pangguna ConfD iki ing GUI kanthi ngeklik tombol Undangan.
- Sinkronake database konfigurasi karo Pusat Kontrol kaya sing diterangake ing bagean "Sinkronake Database Konfigurasi karo Pusat Kontrol" ing kaca 4.
Sampeyan saiki kudu bisa ngontrol sawetara akun Paragon Active Assurance karo pangguna ConfD sing padha.
CATETAN: Sawise sampeyan miwiti ngontrol akun Paragon Active Assurance liwat ConfD, sampeyan ora kudu ngganti akun iki liwat web GUI babagan fitur Paragon Active Assurance sing "config" (ndeleng bab "Fitur sing Didhukung ing Paragon Active Assurance" ing kaca 9). Yen sampeyan nindakake, bakal ilang sinkronisasi.
Pambuka kanggo NETCONF Orchestration API
Swaraview
NFVO pihak katelu utawa orkestra layanan biasane minangka komponen sing miwiti sesi tes lan ngawasi nggunakake API Pusat Kontrol. Orkestra iki uga njupuk asil pangukuran sing dikumpulake saka aktivitas Agen Tes. KPI Kinerja bisa dijupuk dening Sistem Manajemen Kinerja pihak katelu, dene acara - yen wis dipicu dening pelanggaran ambang sing disetel ing Pusat Kontrol - bisa dikirim menyang sistem Manajemen Fault pihak katelu.
Kanggo ringkesan, tokoh ing ngisor iki nuduhake carane Paragon Active Assurance sesambungan karo sistem pihak katelu liyane ing lanskap OSS.
- NFVO / Service Orchestrator: Ngarahake Manager VNF kanggo masang vTA lan ngatur Paragon Active Assurance menyang chain layanan. Sawise layanan wis diaktifake, orkestra nggunakake API menyang Pusat Kontrol kanggo micu tes aktivasi layanan lan njupuk asil pass/gagal. Yen tes kasebut dilewati, orkestra bakal nggunakake API menyang Pusat Kontrol kanggo miwiti ngawasi layanan kasebut. KPI saka pemantauan dijupuk terus-terusan dening orkestra utawa dening platform Manajemen Kinerja sing kapisah.
- Pusat Kontrol: Nyebar, timbangan, lan mungkasi vTA kaya sing diprentahake dening NFVO utawa orkestra layanan.
- Sistem Manajemen Kinerja utawa Sistem Manajemen Kualitas Layanan: Maca KPI saka pemantauan aktif liwat API Pusat Kontrol.
- Sistem Manajemen Fault: Nampa kabar NETCONF, SNMP, utawa email saka Pusat Kontrol yen SLA dilanggar.
Definisi Konsep ing Paragon Active Assurance
- Agen Tes: Komponen sing nindakake pangukuran (kanggo tes uga monitor) ing sistem Jaminan Aktif Paragon. Agen Tes kalebu piranti lunak kanthi kemampuan ngasilake, nampa, lan nganalisa lalu lintas jaringan nyata.
- Jenis Test Agent sing dibahas ing dokumen iki yaiku Virtual Test Agent (vTA), fungsi jaringan virtual (VNF) sing dipasang ing hypervisor. Jinis Agen Tes liyane uga ana.
- Ana rong jinis pangukuran dhasar ing Paragon Active Assurance, tes lan monitor.
- Tes: Tes kasusun saka siji utawa sawetara langkah, sing saben-saben nduweni durasi tartamtu. Langkah-langkah ditindakake kanthi urutan. Saben langkah bisa mbutuhake sawetara tugas bebarengan.
- Monitor: Monitor ora nduweni durasi sing ditemtokake nanging dieksekusi tanpa wates. Kaya langkah ing tes, monitor bisa nindakake macem-macem tugas bebarengan.
- Cithakan: Nalika Paragon Active Assurance dikontrol dening orkestra, tes lan monitor tansah dileksanakake kanthi cithakan ing ngendi tes utawa monitor ditetepake. Setelan parameter bisa diterusake minangka input menyang cithakan nalika runtime.
Alur kerja kanggo Otomatisasi
Wektu Desain
Ing wektu desain, sampeyan nyiyapake pangukuran kanthi nggawe template kanggo tes lan monitor ing Paragon Active Assurance. Cara nindakake iku wis dibahas ing bab "Test and Monitor Templates" ing kaca 15.
Runtime
Nalika runtime, sampeyan nyiyapake piranti lan nindakake pangukuran sing nyata.
- Lan liwatview kabeh mantanamples diwenehi ditemokaké ing bab “Examples Controlling Paragon Active Assurance liwat NETCONF & YANG API" ing kaca 15.
- Cara masang lan ngatur Agen Tes wis ditindakake ing bab "Examples: Agen Tes" ing kaca 16.
- Carane ngimpor item persediaan kayata TWAMP reflektor lan saluran IPTV wis rampung ing bab "Examples: Inventory Items” ing kaca 29.
- Cara ngatur weker diterangake ing bab "Examples: Weker” ing kaca 35.
- Cara nglakokake tes lan monitor kanthi nglakokake template Paragon Active Assurance liwat NETCONF diterangake ing bab "Examples: Tes" ing kaca 43 lan "Examples: Monitor” ing kaca 54.
Fitur sing Didhukung ing Paragon Active Assurance
Kabeh jinis test lan monitor ing Paragon Active Assurance bisa digawe lan dileksanakake liwat nggunakake cithakan. Cara nindakake iki dijamin ing bantuan ing-app ing "Tes lan monitor"> "Nggawe cithakan".
Nggawe akun Paragon Active Assurance saiki ora didhukung; nanging, siji utawa sawetara akun sing wis ditemtokake bakal disiyapake kanggo pangguna.
Tabel ing ngisor iki rinci apa fitur ing Paragon Active Assurance kasedhiya ing release iki, lan carane fitur iki dituduhake ing YANG.
Panjelasan saka YANG Constructs
Kanggo penak, definisi diwenehake ing kene babagan konstruksi YANG kasebut ing tabel fitur.
- Config (config = true): Data konfigurasi, dibutuhake kanggo ngowahi sistem saka siji negara menyang liyane.
- Negara (config=false): Data negara: data tambahan ing sistem sing dudu data konfigurasi, kayata informasi status mung diwaca lan statistik sing diklumpukake.
- RPC: Telpon Prosedur Remote, kaya sing digunakake ing protokol NETCONF.
- Notifikasi: Kabar acara dikirim saka server NETCONF menyang klien NETCONF.
Tabel Paragon Active Assurance Fitur kasedhiya kanggo Orkestrasi
Sumber: Monitoring
YANG path:/accounts/account/monitors
Fitur | Subfitur | sing mbangun |
Nggawe / ngowahi / mbusak monitor | Adhedhasar cithakan monitor | Konfigurasi |
Monitor wiwitan / mandeg | – | Konfigurasi |
Cithakan monitor | Dhaptar template monitor sing ana karo input | negara |
kabar NETCONF | Status weker diganti | Notifikasi |
Ngawasi asil | SLA/ES counter kanggo tingkat paling dhuwur (%) SLA/ES counter kanggo tingkat tugas (%) |
negara |
Ora kaya tes (bandhingake Sumber: Tes ing ngisor iki), monitor ora diwiwiti nganggo RPC nanging kanthi nindakake konfigurasi monitor.
Sumber: Tes
path YANG: /accounts/account/tests
Fitur | Subfitur | sing mbangun |
Miwiti tes | Adhedhasar template test | RPC |
Ngatur tes | Dhaptar tes kanthi status | negara |
Cithakan tes | Dhaptar template tes sing ana karo input | negara |
kabar NETCONF | Status tes diganti | Notifikasi |
Asil tes | Entuk status langkah tes (lulus, gagal, kesalahan, ...) | negara |
Sumber: Test Agents
Jalur YANG:
- /accounts/account/test-agent (Config)
- /accounts/account/registered-test-agent (Negara)
Agen Test ing /accounts/account/test-agent yaiku sing dikonfigurasi ing akun. Mung Agen Tes iki sing bisa dikonfigurasi lan digunakake ing tes lan monitor liwat NETCONF dening orkestra.
Sawise sampeyan ngatur Agen Tes lan wis ndhaptar akun kasebut, Agen Tes bakal katon ing /accounts/account/registered-test-agent. Sampeyan bisa nemokake kabeh Agen Tes sing kadhaptar nggunakake printah "entuk" ing NETCONF (bandhingake bab Examples: Agen Tes).
Ing /accounts/account/registered-test-agent sampeyan uga bisa nemokake Test Agents sing durung dikonfigurasi. Sembarang Agen Tes kasebut kudu dikonfigurasi sadurunge bisa digunakake.
Ing skenario orkestrasi, umume dianjurake supaya sampeyan nindakake kabeh konfigurasi akun Paragon Active Assurance liwat NETCONF. Iki mesthekake yen agen tes lan agen tes sing kadhaptar ora beda-beda.
Fitur | Subfitur | sing mbangun |
Pra-gawe Test Agent ing server | – | Konfigurasi |
Konfigurasi Agen Tes offline | (Pusat Kontrol push config kanggo Test Agent nalika online) |
Konfigurasi |
Gunakake Agen Test sing wis ana / dikonfigurasi sacara eksternal | Gunakake ing test / monitor | Konfigurasi |
Ngatur antarmuka | Konfigurasi | |
Entuk status | negara | |
Konfigurasi Agen Tes (Mung Piranti Tes) | Konfigurasi NTP | Konfigurasi |
Konfigurasi kreteg | Konfigurasi | |
Konfigurasi antarmuka VLAN | Konfigurasi | |
Konfigurasi tombol SSH | Konfigurasi | |
IPv6 | Konfigurasi | |
Util | Urip maneh | RPC |
Nganyari | RPC | |
kabar NETCONF | Status online diganti | Notifikasi |
Status | Entuk status sistem (uptime, panggunaan memori, rata-rata beban, versi) |
negara |
Sumber: Inventory
path YANG: /accounts/account/twamp-reflektor
Didhukung Kapabilitas NETCONF
Tabel ing ngisor iki nuduhake IETF RFCs njlentrehke kapabilitas NETCONF digunakake kanggo tujuan Paragon Active Assurance orkestrasi.
- ietf-netconf.yang
- IETF RFC 6241, Network Configuration Protocol (NETCONF), https://tools.ietf.org/html/rfc6241
- Siji-sijine cara penanganan kesalahan sing didhukung yaiku rollback-on-error.
- Simpenan data sing didhukung mung bisa ditulis.
- ietf-netconf-notifications.yang
- IETF RFC 5277, Kabar Acara NETCONF, https://tools.ietf.org/html/rfc5277
Tes lan Monitor Cithakan
Cithakan kanggo jinis tes lan monitor kudu disiyapake kanthi manual liwat antarmuka pangguna ngarep mburi Paragon Active Assurance. Cara nindakake iki dijamin ing bantuan ing-app ing "Tes lan monitor"> "Nggawe cithakan".
Examples Ngontrol Paragon Active Assurance liwat NETCONF & YANG API
Ing bab sabanjure, dianggep cithakan tes lan monitor sing cocog wis ditetepake miturut pandhuan sing diwenehake ing bab "Cithakan Tes lan Monitor" ing kaca 15.
Piranti sing digunakake ing Examples
Mantan kabehamples ing bab sakteruse wis dibangun nggunakake piranti free kasedhiya ing ngisor iki:
- Pang: Digunakake kanggo nggambarake lan nelusur model YANG.
- Kasedhiya ing https://github.com/mbj4668/pyang (klon saka git lan mbukak python setup.py install).
- Python NETCONF klien "ncclient": Digunakake kanggo komunikasi karo Control Center nggunakake NETCONF.
- Kasedhiya ing https://github.com/ncclient/ncclient (run pip install ncclient).
Model data netrounds-ncc.yang ditemokake ing /opt/netrounds-confd yen ConfD wis diinstal miturut Pandhuan Instalasi).
Swaraview saka Tugas Kunci Dilaksanakake
(Sawetara tugas liyane uga dituduhake ing ngisor iki.)
- "Nggawe lan nyebarake Agen Tes anyar" ing kaca 16
- "Nggawe item inventaris (contone, reflektor)" ing kaca 29
- "Nyetel cithakan weker lan ngendi ngirim weker" ing kaca 35
- "Nggawe lan nindakake tes" ing kaca 45
- "Njupuk asil tes" ing kaca 50
- "Miwiti monitor (kalebu persiyapan weker)" ing kaca 60
- "Njupuk status SLA kanggo monitor" ing kaca 67
- “Nggawe karo tags”Ing kaca 71
Examples: Test Agents
Swaraview saka Test Agen Orkestrasi
Agen Test ing Paragon Active Assurance dianggep minangka "konfigurasi" ing konteks orkestrasi. Iki tegese nggawe, ngontrol, lan mbusak Agen Tes kudu ditindakake liwat orkestra lan NETCONF tinimbang liwat GUI Jaminan Aktif Paragon.
PENTING: Yen Agen Tes dipasang dening teknisi lan didaftar ing Pusat Kontrol tanpa digawe luwih dhisik liwat NETCONF & YANG API, Agen Tes ora bakal ana ing basis data konfigurasi, lan sistem bakal ora sinkron. Kanggo ConfD ngerti Agen Tes ing kasus iki, perlu kanggo nindakake sinkronisasi anyar karo Pusat Kontrol, kaya sing rinci ing bagean "Sinkronisasi Database Konfigurasi karo Pusat Kontrol" ing kaca 4.
Orkestrasi Agen Tes Virtual (vTA) kudu ditindakake kanthi langkah-langkah ing ngisor iki:
- Gawe Agen Tes Virtual, kalebu konfigurasi antarmuka, nggunakake antarmuka NETCONF & YANG menyang Pusat Kontrol. Jeneng Agen Test bakal dadi kunci unik.
- Pasang vTA ing platform virtualisasi. Tindakake pandhuan ing bantuan online ing Agen Tes > Instalasi. Konfigurasi antarmuka dhasar sing ngidini vTA nyambung menyang Pusat Kontrol, uga kapercayan kanggo otentikasi, diwenehake menyang vTA nggunakake data pangguna awan-init.
Sawise vTA wis boot, iku bakal otomatis nyambung menyang Control Center nggunakake sambungan OpenVPN ndhelik. Kabar NETCONF dikirim amarga nilai parameter test-agent-statuschange vTA saiki wis diganti dadi "online".
CATETAN: Amarga jeneng vTA minangka pengenal ing Pusat Kontrol, jeneng iki kudu padha karo sing ditetepake ing Pusat Kontrol ing "langkah 1" ing kaca 17. - Sawise vTA wis disambungake lan keasliane kanggo Control Center, konfigurasi antarmuka di-push menyang vTA. Iki minangka konfigurasi antarmuka sing diwenehake ing "langkah 1" ing kaca 17 nalika vTA digawe ing Pusat Kontrol.
- Sawise vTA wis dadi tujuane, mbusak vTA.
Nggawe lan Nggawe Agen Tes Anyar
Kita kudu nggawe Agen Tes nggunakake antarmuka NETCONF & YANG menyang Pusat Kontrol. Nalika Agen Test digawe kanthi cara iki, ora perlu sinkronisasi karo Pusat Kontrol.
Model YANG kanggo Agen Tes kaya sing digambarake ing ngisor iki. Iki dijupuk minangka output saka printah
pyang -f wit netrounds-ncc.yang
Model YANG lengkap diwenehi ing "Lampiran: Struktur Wit Model Lengkap YANG" ing kaca 81, sing uga ngemot legenda sing nerangake konvensi sing digunakake ing ilustrasi model YANG iki lan liyane ing dokumen saiki.
Kita nerusake langkah-langkah ing ngisor iki, sing rinci ing ngisor iki:
- Ing wiwitan, akun Paragon Active Assurance "demo" ora duwe Agen Tes ing inventaris.
- Agen Test sing diarani "vta1" digawe nggunakake ncclient. Ing stage, durung ana Agen Test nyata (yaiku, durung diwiwiti).
- Agen Test disebarake ing OpenStack. (Panyebaran ing platform kasebut dipilih ing kene minangka salah sawijining kemungkinan.)
- Agen Test nyambung menyang akun Pusat Kontrol "demo" lan saiki wis siyap digunakake.
Langkah 1: Ing wiwitan, ora ana Agen Tes ing akun "demo". Deleng gambar ing ngisor iki saka GUI Pusat Kontrol.Langkah 2: A Agen Test digawe ing Pusat Kontrol nggunakake klien Python NETCONF "ncclient". Ing ngisor iki kode ncclient kanggo nggawe Agen Test sing duwe antarmuka fisik karo alamat DHCP:
ngimpor argparse
saka ncclient import manager
parser = argparse.ArgumentParser(description='Test nggawe Test Agent')
parser.add_argument('–host', help='Jeneng host ing ngendi ConfD ditemokake', dibutuhake=Bener)
parser.add_argument('–port', help='Port kanggo nyambung menyang ConfD', required=True)
parser.add_argument('–username', help='Jeneng panganggo kanggo nyambung menyang ConfD', dibutuhake=Bener)
parser.add_argument('–password', help='Sandi menyang akun ConfD', required=True)
parser.add_argument('–netrounds-account', help='Jeneng singkatan akun NCC', dibutuhake=Bener)
parser.add_argument('–test-agent-name', help='Jeneng Agen Tes', dibutuhake=Bener)
args = parser.parse_args()
karo manager.connect(host=args.host, port=args.port, username=args.username,
sandi=args.password, hostkey_verify=False) minangka m:
# Gawe Agen Tes ing Pusat Kontrol
xml = """
)print m.edit_config(target='mlaku', config=xml)
CATETAN: Kode sadurunge manager.connect(…) diilangi saka conto sabanjureamppotongan kode.
Server NTP dikonfigurasi ing eth0, lan eth0 uga minangka antarmuka manajemen (yaiku antarmuka sing nyambung menyang Pusat Kontrol).
Aplikasi Agen Test saiki ora ngidini konfigurasi antarmuka. Mulane, saka versi 2.34.0 lan sabanjure, sampeyan bisa ngilangi konfigurasi antarmuka ing skema YANG. XML sing cocog mula disederhanakake kanthi radikal ing kasus iki:Sawise Agen Tes wis digawe, ana ing database konfigurasi lan ing Pusat Kontrol. Deleng gambar ing ngisor iki saka inventaris Agen Tes, nuduhake Agen Tes "vta1":
Langkah 3: Saiki wektune kanggo masang Agen Tes "vta1" ing OpenStack.
Agen Tes bakal nggunakake data pangguna awan-init kanggo njupuk informasi babagan cara nyambung menyang Pusat Kontrol. Khusus, teks data pangguna file nduweni isi ing ngisor iki (Elinga yen garis #cloud-config lan netrounds_test_agent kudu ana, lan garis sing isih ana kudu indent):
Kanggo informasi luwih lengkap, waca dokumen Cara Nyebarake Agen Tes Virtual ing OpenStack.
Sawise Agen Tes wis disebarake lan wis nyambung menyang Pusat Kontrol, konfigurasi kasebut bakal di-push saka Pusat Kontrol menyang Agen Tes.
Langkah 4: Agen Tes saiki online ing Pusat Kontrol lan wis entuk konfigurasi. Agen Test siap digunakake ing tes lan ngawasi. Deleng bagean iki:
- “Miwiti Tes” ing kaca 45
- "Miwiti Monitor" ing kaca 60
Ndhaptar Agen Tes ing Akun Asuransi Aktif Paragon
Ing ngisor iki exampkode Python ncclient kanggo dhaptar Agen Test ing akun Paragon Active Assurance:
Mlaku kode iki menehi output kaya ing ngisor iki:
Mbusak Agen Test
Sawise tes wis rampung, bisa uga relevan ing sawetara kasus panggunaan kanggo mbusak Agen Tes.
Ing ngisor iki minangka potongan kode sing nuduhake carane nindakake iki karo ncclient:
Kabar NETCONF
Ing ngisor iki, kita nampilake mantan sing prasajaampscript le kanggo ngrungokake kabeh kabar NETCONF mlebu saka Control Center. Kabar kasebut dikirim nalika ana acara tartamtu, kayata Agen Tes offline utawa tes sing diwiwiti pangguna wis rampung. Adhedhasar informasi sing ditindakake ing kabar kasebut, pangguna bisa nemtokake tumindak tindakake otomatis ing orkestra.
Nalika skrip ing ndhuwur dieksekusi, klien NC bakal nampilake kabar sing ditampa ing XML terstruktur. Ndeleng mantanample output ngisor, kang nuduhake Test Agent arep offline ndadak.
2017-02-03T15:09:55.939156+00:00</eventTime>
<test-agent-status-change xmlns=’http://ncc.netrounds.com'>
demo
HW1
offline
Examples: Inventory Items
Nggawe (ngimpor) lan ngatur item persediaan kayata TWAMP reflektor lan Y.1731 MEP wis rampung ing cara sing padha kanggo Agen Test. Ing ngisor iki ana kode XML lan NETCONF kanggo nemtokake entitas kasebut ing Paragon Active Assurance liwat NETCONF & YANG API lan kanggo njupuk dhaptar item sing ditetepake.
Nggawe TWAMP Reflektor
Nggawe Y.1731 MEP
Nggawe Saluran IPTV
Nggawe Host Ping
Nggawe Akun SIP
Njupuk Inventory Items
Ing ngisor iki kode Python kanggo njupuk kabeh item persediaan ditetepake ing akun. (Kabeh jinis barang inventaris dijupuk bebarengan ing kene kanggo ngindhari sawetara pengulangan ing dokumen kasebut. Mesthi wae, subset saka barang inventaris bisa dijupuk kanthi ninggalake sawetara baris ing akun ing ngisor iki.)
Mlaku kode iki menehi output kaya ing ngisor iki:
Examples: weker
Cithakan weker lan item sing gegandhengan (manajer SNMP, dhaptar email weker) digawe lan dikelola kanthi cara sing padha karo item inventaris. Bab iki ngemot kode XML lan NETCONF kanggo nemtokake entitas kasebut ing Paragon Active Assurance liwat NETCONF & YANG API lan kanggo njupuk dhaptar item sing ditetepake.
Dhaptar Email Weker
Nggawe Dhaptar Email Weker
Njupuk Kabeh Dhaptar Email Weker
Manajer SNMP
Nggawe Manager SNMP
Njupuk Kabeh Managers SNMP
Cithakan weker
Nggawe Cithakan Weker
Njupuk Kabeh Cithakan Weker
Examples: Tombol SSH
Sampeyan bisa nambah kunci umum SSH menyang Agen Test liwat NETCONF & YANG API. Nggunakake kunci pribadi sing cocog, sampeyan bisa mlebu menyang Agen Tes liwat SSH.
Dhaptar lengkap operasi sing kasedhiya ing tombol SSH kaya ing ngisor iki:
- Tambah kunci SSH
- Ngowahi kunci SSH
- Priksa kunci SSH
- Dhaptar tombol SSH
- Mbusak tombol SSH.
Ing ngisor iki, operasi nambah lan mbusak contone.

Mbusak Kunci SSH
Yen sampeyan pengin mbusak kunci SSH, gunakake printah ing ngisor iki:
Examples: Tes
Dianggep ing kene yen Agen Tes (sing dibutuhake kanggo tes) wis digawe miturut bagean "Nggawe lan Nggawe Agen Tes Anyar" ing kaca 17.
YANG Model Paths kanggo Tes
Item | path model YANG: /accounts/account/tests … |
tes | /. |
tes [id] | / tes |
id | /test/id |
jeneng | /test/jeneng |
status | /test/status |
wektu wiwitan | /test/wiwit-wektu |
wektu pungkasan | /test/wektu pungkasan |
laporan-url | /test/laporan-url |
langkah | /test/langkah |
langkah [id] | /test/langkah/langkah |
jeneng | /test/langkah/langkah/jeneng |
id | /test/step/step/id |
wektu wiwitan | / test / langkah / langkah / wiwitan-wektu |
wektu pungkasan | /test/langkah/langkah/akhir-wektu |
status | /test/langkah/langkah/status |
status-pesen | /test/langkah/langkah/status-pesen |
cithakan | / Cithakan |
Cithakan [jeneng] | /templates/template |
jeneng | /templates/template/name |
katrangan | / Cithakan / Cithakan / katrangan |
paramèter | /templates/template/parameter |
parameter [kunci] | /templates/template/parameter/parameter |
kuncine | /templates/template/parameters/parameter/key |
jinis | /templates/template/parameter/parameter/type |
Prasyarat kanggo Test Orkestrasi
- Kanggo miwiti tes liwat NETCONF nggunakake klien NC, sampeyan kudu nggawe template uji coba kanthi nggunakake GUI Pusat Kontrol kaya sing rinci ing bantuan ing aplikasi ing "Tes lan monitor"> "Nggawe template". Kabeh kolom sing ditemtokake ing cithakan kasebut minangka "Input Templat" bakal dibutuhake minangka paramèter ing XML nalika ngatur wiwitan cithakan tes.
- Tes mlaku ing Paragon Active Assurance dianggep minangka "negara" ing konteks orkestrasi. Data negara minangka data sing ora bisa ditulis sing ora disimpen ing basis data konfigurasi, beda karo data konfigurasi sing kasebut ing bagean "Swara.view saka Test Agent Orchestration" ing kaca 17. Iki tegese owah-owahan ing tes utawa cithakan ing Control Center GUI ora bakal nimbulaké masalah sing gegandhengan karo sink antarane Control Center lan database konfigurasi.
- Kanggo njaluk laporan-URL tengen ing laporan test, sampeyan kudu nggawe manawa Control Center URL wis diatur kanthi bener. Iki ditindakake ing file /opt/netrounds-confd/settings.py. Kanthi gawan jeneng host Control Center dijupuk nggunakake socket.gethostname(): ndeleng ngisor. Yen iki ora ngasilake asil sing bener, sampeyan kudu nyetel jeneng host (utawa kabeh URL) kanthi manual ing iki file.
# URL saka Pusat Kontrol tanpa garis miring.
# Iki kanggo mantanampdigunakake ing laporan tes-url.
HOSTNAME = socket.gethostname()
NETROUNDS_URL = 'https://%s' % HOSTNAME
Miwiti Test
Kaya sing diterangake ing bagean "Nggawe lan Nggawe Agen Tes Anyar" ing kaca 17, jalanake printah pang -f tree netrounds-ncc.yang
saka direktori /opt/netrounds-confd/ kanggo ngasilake model YANG. Ing model iki, RPC kanggo miwiti tes nggunakake klien NC katon kaya ing ngisor iki:
Kanggo panjelasan, deleng bagean "Legenda" ing kaca 81 ing Lampiran.
Langkah-langkah ing ngisor iki ditampilake ing ngisor iki:
- Agen Tes wis didaftar ing akun Paragon Active Assurance, nanging durung ana tes sing diwiwiti.
- Parameter input sing dibutuhake diidentifikasi ing cithakan tes sing bakal ditindakake.
- Tes HTTP 60 detik diwiwiti nggunakake ncclient.
Langkah 1: Ing wiwitan, ora ana tes sing diwiwiti ing akun Paragon Active Assurance. Deleng gambar ing ngisor iki saka GUI Pusat Kontrol.
Langkah 2: Cithakan sing bakal kita gunakake kanggo miwiti tes ing mantan ikiample minangka cithakan tes HTTP. Nduwe rong kolom input wajib (Klien lan URL) sing wis ditemtokake nalika mbangun cithakan ing GUI Pusat Kontrol.
Kita bakal nemtokake paramèter kasebut (antara liya) ing konfigurasi XML sing disampekake menyang database konfigurasi dening manajer NETCONF (ncclient).
Langkah 3: Tes HTTP diwiwiti nggunakake ncclient.
Ing ngisor iki exampkode ing ngendi informasi konfigurasi sing dibutuhake lan paramèter ditemtokake kanggo cithakan test HTTP. Gumantung carane cithakan wis dibangun, rincian kene bisa beda-beda.
Kanggo saben parameter, ing atribut kudu diwenehake. Tombol iku identik karo parameter
Jeneng variabel ing Pusat Kontrol. Sampeyan bisa mriksa jeneng variabel kaya ing ngisor iki:
- Klik Tes ing garis sisih banjur pilih Urutan Tes Anyar.
- Klik My Templates.
- Klik link Sunting ing ngisor template sing disenengi.
- Klik tombol Sunting input ing pojok tengen ndhuwur.
Ing mantan kitaample, lan minangka standar, jeneng variabel mung versi cilik saka jeneng tampilan sing katon ing Pusat Kontrol ("url"vs."URL”, lsp). Nanging, ing GUI Pusat Kontrol, sampeyan bisa ngganti jeneng variabel dadi apa wae sing disenengi.
Kejabi tombol, saben parameter kudu nemtokake jinis: contoneample, kanggo URL.
Elinga yen sampeyan kudu review model YANG lengkap kanggo entuk informasi lengkap babagan jinis. Kanggo antarmuka Test Agent jinis duwe struktur luwih Komplek, minangka bukti ing ing kode ing ngisor iki.
Saiki kita bisa mbukak skrip nggunakake ncclient. Yen kabeh wis bener, tes bakal diwiwiti lan eksekusi ditampilake ing Pusat Kontrol:Yen tes kasil diwiwiti, Pusat Kontrol bakal nanggapi karo ID tes. Ing mantan ikiampl, ID tes yaiku 3:
ID test uga bisa ditemokake ing URL kanggo test ing Control Center GUI. Ing mantan ikiample, iku URL yaiku https://host/demo/testing/3/.
Njupuk Asil Test
Cara sing paling gampang kanggo njupuk asil tes yaiku kanthi nuding ID tes.
Ing ngisor iki kode Python kanggo entuk asil saka tes HTTP ing ndhuwur kanthi ID = 3:
karo manager. Sambungake(host=args.host, port=args.port, username=args.username,password=args.password, hostkey_verify=False) minangka m:
Output bakal katon kaya iki:
Ngekspor lan Ngimpor Tes Cithakan
Cithakan tes bisa diekspor ing format JSON lan diimpor maneh ing format kasebut menyang Pusat Kontrol. Iki migunani yen sampeyan pengin nggunakake template tes ing instalasi Pusat Kontrol sing beda. (Penciptaan awal cithakan paling apik ditangani liwat GUI Pusat Kontrol.)
Ing ngisor iki kode kanggo nindakake ekspor lan impor.
Ngekspor Tes Cithakan
# Entuk konfigurasi json saka respon
root = ET.fromstring(response._raw)
json_config = root [0].teks
print json_config
Cithakan kasebut ana ing obyek json_config.
Ngimpor Tes Cithakan
Obyek konfigurasi JSON sing nyekel template tes bisa diimpor maneh menyang Pusat Kontrol kaya ing ngisor iki.
Examples: Monitor
Bagean iki nganggep yen Agen Tes (sing dibutuhake dening monitor) wis digawe miturut bagean "Nggawe lan Nggawe Agen Tes Anyar" ing kaca 17.
YANG Model Paths kanggo Monitor
Item | YANG model path: /accounts/account/monitors … |
monitor | /. |
monitor [jeneng] | /monitor |
jeneng | /monitor/jeneng |
katrangan | / monitor / katrangan |
diwiwiti | / ngawasi / diwiwiti |
cithakan | /monitor/template |
weker-configs | /monitor/alarm-configs |
Item | YANG model path: /accounts/account/monitors/monitor/alarm-configs … |
weker-config[identifikasi] | /weker-config |
pengenal | / alarm-config / pengenal |
cithakan | /alarm-config/template |
/alarm-config/email | |
snmp | /alarm-config/snmp |
thr-es-kritis | / alarm-config / thr-es-kritis |
thr-es-critical-clear | /alarm-config/thr-es-critical-clear |
thr-es-utama | /alarm-config/thr-es-mayor |
thr-es-utama-jelas | /alarm-config/thr-es-major-clear |
thr-es-minor | /alarm-config/thr-es-minor |
thr-es-minor-clear | /alarm-config/thr-es-minor-clear |
thr-es-warning | /alarm-config/thr-es-warning |
thr-es-warning-jelas | /alarm-config/thr-es-warning-clear |
ora keruwetan data | /alarm-config/no-data-severity |
ora-data-wektu entek | /alarm-config/no-data-timeout |
tumindak | / alarm-config / tumindak |
ukuran jendhela | /alarm-config/window-size |
interval | /alarm-config/interval |
ngirim-mung-sapisan | / alarm-config / ngirim-mung-sapisan |
snmp-trap-per-stream | /alarm-config/snmp-trap-per-stream |
Item | YANG model path: /accounts/account/monitors … |
paramèter | /monitor/parameter |
Item | YANG model path: /accounts/account/monitors/monitor/parameters … |
parameter [kunci] | /parameter |
kuncine | /parameter/key |
(tipe nilai) | /parameter |
:(ongko) | /parameter |
integer | /parameter/integer |
:( ngambang) | /parameter |
ngambang | /parameter/ngambang |
(string) | /parameter |
Item | YANG model path: /accounts/account/monitors/monitor/parameters … |
senar | /parameter/string |
:( test-agen-antarmuka) | /parameter |
test-agen-antarmuka | /parameter/test-agen-antarmuka |
test-agent-interface["1" ing kaca 58 | /parameter/test-agent-interfaces/ |
akun | /parameter/test-agent-interfaces/test-agent-interface/akun |
tes-agen | /parameter/test-agen-antarmuka/test-agen-antarmuka/test-agen |
antarmuka | /parameter/test-agen-antarmuka/test-agen-antarmuka/antarmuka |
ip-versi | /parameter/test-agent-interfaces/test-agent-interface/ip-version |
:( twamp-reflektor) | /parameter |
twamp-reflektor | /parameter/twamp-reflektor |
twamp-reflektor [jeneng] | /parameter/twamp-reflektor/twamp-reflektor |
jeneng | /parameter/twamp-reflektor/twamp-reflektor/jeneng |
(y1731-meps) | /parameter |
y1731-meps | /parameter/y1731-meps |
y1731-mep[jeneng] | /parameter/y1731-meps/y1731-mep |
jeneng | /parameter/y1731-meps/y1731-mep/name |
:( sip-akun) | /parameter |
sip-akun | /parameter/sip-akun |
akun sip["2" ing kaca 58] | /parameter/sip-akun/sip-akun |
akun | /parameter/sip-akun/sip-akun/akun |
tes-agen | /parameter/sip-akun/sip-akun/test-agen |
antarmuka | /parameter/sip-accounts/sip-account/interface |
sip-alamat | /parameter/sip-akun/sip-akun/sip-alamat |
(saluran-iptv) | /parameter |
iptv-saluran | /parameter/iptv-saluran |
iptv-channel [jeneng] | /parameter/iptv-channels/iptv-channel |
jeneng | /parameter/iptv-channels/iptv-channel/name |
- antarmuka test-agen akun
- akun test-agen antarmuka sip-alamat
Item | YANG model path: /accounts/account/monitors … |
status | /monitor/status |
pungkasan-15-menit | /monitor/status/15-menit pungkasan |
status | /monitor/status/15-menit pungkasan/status |
status-nilai | /monitor/status/last-15-minutes/status-value |
jam pungkasan | /monitor/status/jam pungkasan |
status | /monitor/status/jam pungkasan/status |
status-nilai | /monitor/status/last-hour/status-value |
pungkasan-24-jam | /monitor/status/24-jam pungkasan |
status | /monitor/status/24-jam pungkasan/status |
status-nilai | /monitor/status/24-jam pungkasan/status-value |
cithakan | / Cithakan |
Cithakan [jeneng] | /templates/template |
jeneng | /templates/template/name |
katrangan | / Cithakan / Cithakan / katrangan |
paramèter | /templates/template/parameter |
parameter [kunci] | /templates/template/parameter/parameter |
kuncine | /templates/template/parameters/parameter/key |
jinis | /templates/template/parameter/parameter/type |
Prasyarat kanggo Orkestrasi Monitor
Sadurunge sampeyan bisa miwiti monitor liwat NETCONF nggunakake ncclient, sampeyan kudu nggawe template monitor ing GUI Pusat Kontrol kaya sing diterangake ing bantuan ing-app ing "Tes lan monitor"> "Nggawe template". Kabeh kolom sing ditemtokake minangka "input Template" ing cithakan kasebut bakal dibutuhake minangka paramèter ing XML nalika ngatur wiwitan cithakan.
Njupuk Parameter Input saka Cithakan Monitor
Ing ngisor iki, rong template ditampilake. Kapisan kanggo ngawasi UDP antarane rong antarmuka Test Agent, lan sing kapindho kanggo HTTP nggunakake antarmuka Test Agent siji.
Kanggo ngerteni paramèter input saka cithakan, klik kothak sing makili cithakan. Kanggo cithakan HTTP, paramèter bisa katon kaya iki:
Kita kudu nemtokake paramèter kasebut ing langkah sabanjure nalika miwiti monitor.
Miwiti Monitor
Nggunakake Agen Tes sing ditetepake lan disebarake ing bagean "Nggawe lan Nggawe Agen Tes Anyar" ing kaca 17, kita bisa miwiti monitor saka cithakan "HTTP" kaya ing ngisor iki.
Kanggo saben parameter, ing atribut kudu diwenehake. Tombol kasebut identik karo jeneng Variabel parameter ing Pusat Kontrol. Sampeyan bisa mriksa jeneng variabel kaya ing ngisor iki:
- Klik Monitoring ing sidebar banjur pilih New Monitor.
- Klik My Templates.
- Klik link Sunting ing ngisor template sing disenengi.
- Klik tombol Sunting input ing pojok tengen ndhuwur.
Ing mantan kitaample, lan minangka standar, jeneng variabel mung versi cilik saka jeneng tampilan sing katon ing Pusat Kontrol ("url"vs."URL”, lsp). Nanging, ing GUI Pusat Kontrol, sampeyan bisa ngganti jeneng variabel dadi apa wae sing disenengi.
Kejabi tombol, saben parameter kudu nemtokake jinis: contoneample, kanggo URL. Elinga yen informasi lengkap babagan jinis parameter ditemokake ing model YANG. Kanggo antarmuka Test Agent jinis wis struktur luwih Komplek, minangka bukti ing kode ing ngisor iki.
Ing mantanample sing nderek, ora weker digandhengake karo monitor. Kanggo exampYen sampeyan duwe weker, pindhah menyang bagean "Miwiti Monitor nganggo Weker" ing kaca 62.
Miwiti Monitor nganggo Weker
Kanggo nggandhengake weker karo monitor, sampeyan bisa nuding cithakan weker sing wis ditemtokake, utawa sampeyan bisa nyedhiyakake kabeh konfigurasi weker nalika nggawe monitor. Kita bakal menehi siji mantanample saka saben pendekatan ing ngisor iki.
Nyetel Weker Monitor kanthi Nuding menyang Cithakan Weker
Supaya nggunakake cithakan weker, sampeyan kudu ngerti ID sawijining. Kanggo tujuan iki, mulihake kabeh cithakan weker kaya sing dijlentrehake ing bagean "Njupuk Kabeh Cithakan Weker" ing kaca 39 lan catet jeneng cithakan sing cocog. Sampeyan banjur bisa ngrujuk marang cithakan kaya ing ngisor iki:
Nyetel Weker Monitor kanthi Konfigurasi Langsungy
Utawa, sampeyan bisa nyetel weker kanggo monitor kanthi nyedhiyakake kabeh konfigurasi nalika nggawe monitor, tanpa ngrujuk menyang cithakan weker. Iki ditindakake kaya sing ditampilake ing ex ing ngisor ikiample.
Njupuk Monitor Mlaku
Kanggo njupuk kabeh monitor sing lagi dieksekusi, jalanake skrip iki:
karo manager. connect(host=args.host, port=args.port, username=args.username, password=args.password, hostkey_verify=False) minangka m:
Output minangka dhaptar kabeh monitor sing mlaku kaya ing ngisor iki:
Njupuk Status SLA kanggo Monitor
Mangkene carane njupuk status SLA kanggo monitor. Ing mantan ikiample, kita njupuk status SLA kanggo monitor "Kualitas Jaringan" kanggo telung interval wektu: pungkasan 15 menit, jam pungkasan, lan pungkasan 24 jam.
Output bakal katon kaya iki:
Kabar NETCONF
Kabar NETCONF kanggo monitor dipicu dening pelanggaran SLA. Iki kedadeyan nalika SLA kanggo monitor mudhun ing ambang SLA ("Apik" utawa "Ditrima") ing wektu tartamtu, kanthi standar 15 menit pungkasan. Perlu dicathet menawa kabar nglanggar SLA katon cepet sawise layanan kena pengaruh, dene status SLA bakal bali menyang "Apik" mung sawise 15 menit, lan mung yen ora ana pelanggaran maneh.
Jendhela wektu bisa diganti kanthi ngowahi setelan SLA_STATUS_WINDOW (nilai ing detik) ing /etc/netrounds/netrounds.conf.
Ngekspor lan Ngimpor Cithakan Monitor
Iki ditindakake kanthi cara sing padha karo template tes; mbandhingake bagean "Ngekspor lan Ngimpor Cithakan Tes" ing kaca 52. Cuplikan kode ing ngisor iki nggambarake carane ngekspor lan ngimpor cithakan kanggo monitor.
Ngekspor Cithakan Monitor
Ngimpor Cithakan Monitor
Tags ditetepake ing Paragon Active Assurance bisa ditrapake kanggo:
- monitor
- ngawasi Cithakan
- Agen Tes
- TWAMP reflektor
- Ping host.
Kanggo example, sampeyan bisa tag monitor karo padha tag minangka subset Agen Tes sing bakal mbukak monitor. Fitur iki utamané mbiyantu yen sampeyan duwe nomer akeh monitor lan cithakan ditetepake.
Yen sampeyan wis nyiyapake weker nganggo traps SNMP kanggo monitor, traps SNMP bakal diwenehi tags minangka monitor, yen ana.
Nggawe Tags
Ing ngisor iki kita nuduhake carane nggawe a tag kanthi jeneng lan werna minangka ditetepake dening XMLtag> substruktur.
Nugasi a Tag
Kanggo nemtokake a tag menyang sumber, sampeyan nambah minangka anyartag> unsur ing ngisortags> unsur kanggo sumber daya kasebut.
Punika carane nemtokake a tag menyang Agen Test:
Kanggo nemtokake a tag menyang TWAMP reflektor, tindakake ing ngisor iki:
Nugasi a tag menyang monitor ditangani kanthi cara sing padha:
Utawa, sampeyan bisa nemtokake sing wis ana tag kanggo samubarang jinis sumber iki nalika nggawe sumber daya, kanthi kalebu ingtags> unsur sing ngemot tag ing pitakonan.
Nganyari a Tag
Nganyari sing wis ana tag karo atribut anyar iku analog kanggo nggawe a tag:
Unassigning a Tag
Kanggo mbatalake a tag saka sumber daya, nambah atribut nc: operasi = "mbusak" menyangtag> unsur gadhahanipun sumber. Ing ngisor iki, kita unassign a tag saka monitor.
Mbusak a Tag
Kanggo mbusak a tag kabeh saka Pusat Kontrol, atribut nc: operasi = "delete" digunakake maneh, nanging wektu iki ditrapake kanggo tag dhewe, ditetepake ing .
Ngatasi masalah
Masalah: Orchestrator lan Paragon Active Assurance Out of Sync
The orkestra lan Paragon Active Assurance bisa mungkasi munggah metu saka sink kanggo Example yen owah-owahan konfigurasi wis digawe ing Control Center GUI, utawa yen nglamar konfigurasi ora sukses lan muter bali menyang negara sadurungé gagal.
Ing kasus rollback gagal, server NETCONF ora bakal nampa owah-owahan konfigurasi maneh; bakal mbales pesen kesalahan sing nyatakake konfigurasi dikunci nganti sinkron maneh. Kanggo bali ing sinkronisasi lan mbukak kunci owah-owahan konfigurasi, sampeyan kudu mbukak printah rpc sync-saka-ncc sing nyinkronake kabeh konfigurasi saka Control Center kanggo database konfigurasi.
CATETAN: Ing confd@netrounds.com pangguna (utawa apa wae sing wis dikonfigurasi) kudu duwe hak istimewa superuser supaya kabeh bisa disinkronake kanthi sukses. Iki bisa digayuh kanthi printah ncc user-update confd@netrounds.com -is-superuser Yen pangguna dudu superuser, bakal ana peringatan yen ora kabeh bisa diselarasake, nanging kabeh sing bisa ditangani wis rampung.
CATETAN: Yen orkestra sampeyan uga nyimpen konfigurasi, sampeyan uga kudu nyinkronake maneh wiwit konfigurasi sing dijaluk (konfigurasi sing dikarepake dening Pusat Kontrol) ora bakal ditrapake.
Masalah: Sinkronisasi Awal (sync-from-ncc) Gagal Amarga Sumber Daya Ora Didhukung
Yen sampeyan nyoba mbukak rpc sync-from-ncc ing akun sing wis konfigurasi digawe ing Control Center GUI, sampeyan bisa nemu masalah yen akun ngandhut sumber daya sing ora didhukung. Disaranake sampeyan miwiti karo akun kosong lan nindakake kabeh konfigurasi liwat NETCONF. Yen ora, yen sampeyan nemoni masalah karo konflik sumber daya, sampeyan kudu mbusak sumber konflik saka akun kasebut.
Masalah: printah NETCONF gagal karo ncclient.operations.rpc.RPCError: kegagalan komunikasi aplikasi
Server NETCONF ora mulihake konektivitas menyang server Pusat Kontrol kanthi otomatis yen Pusat Kontrol diwiwiti maneh. Kanggo mulihake sambungan menyang Pusat Kontrol, miwiti maneh proses NETCONF: sudo systemctl restart netrounds-confd
Cathetan babagan Aplikasi Agen Tes lan Peralatan Agen Tes
Aplikasi Agen Test ing ConfD
Ing antarane Agen Tes, Aplikasi Agen Tes (anyar) tumindak rada beda karo Alat Agen Tes (lawas).
Aplikasi Agen Test saiki ora ndhukung konfigurasi antarmuka. Mulane, skema YANG ngidini nemtokake konfigurasi antarmuka kosong kanggo Agen Tes kasebut. Waca "wacana iki" ing kaca 23 kanggo mantanample.
Nalika nyinkronake database ConfD karo Pusat Kontrol nggunakake printah sync-saka-ncc, sampeyan pengin konfigurasi antarmuka tetep kosong lan ora bakal ditindhes karo apa sing ditemokake ing Pusat Kontrol. Mulane sampeyan kudu nggunakake gendéra khusus -without_interface_config karo printah kasebut nalika nggarap Aplikasi Agen Test.
Konfigurasi Antarmuka Kosong kanggo Alat Tes Agen
Kaya kasebut ing ndhuwur, Test Agent Application ora ndhukung konfigurasi antarmuka, lan mulane bisa ngilangi antarmuka ing skema YANG.
Nanging ana uga kasus panggunaan sing sampeyan pengin ngilangi konfigurasi antarmuka saka Alat Test Agent. Mantanample iki bisa dadi skenario orkestrasi ngendi sampeyan muter Agen Test nggunakake maya-init, lan sampeyan pengin konfigurasi antarmuka saka ing kono digunakake, tinimbang supaya ConfD nimpa minangka Agen Test teka online.
Owah-owahan Skema YANG Babagan Antarmuka sing Ora Ditemtokake
Wiwit konfigurasi antarmuka kosong saiki diijini (saka versi 2.34.0 terus), sampeyan bisa nemtokake jeneng antarmuka minangka input kanggo tugas sing mlaku minangka bagéan saka tes utawa monitor.
Iki dibutuhake supaya bisa nggunakake Aplikasi Agen Test, amarga ora ana jeneng antarmuka sing ditetepake ing ConfD. Elinga, Nanging, iki uga ateges sampeyan bisa ngalami masalah yen ora sengaja sampeyan ngatur tes utawa monitor kanggo nggunakake antarmuka sing ora ana. Dadi elinga iki.
Watesan Nalika Ndhaptar Agen Test Digawe ing ConfD
Nalika nggawe Agen Tes liwat API REST utawa NETCONF/YANG, kita ora bisa ngerti sadurunge jinis kasebut: Alat Uji utawa Aplikasi Agen Tes. Iki dadi cetha mung sawise Agen Test wis ndhaptar.
Sawise Agen Test wis kadhaptar lan wis dadi salah siji saka jinis konkrit iki, sampeyan ora diijini kanggo ndhaftar maneh minangka jinis Test Agent beda. Iki tegese sampeyan ora diijini ndhaptar dhisik minangka Alat Agen Tes, banjur ndhaptar maneh minangka Aplikasi Agen Tes, utawa kosok balene. Yen sampeyan butuh Agen Tes saka jinis sing beda, sampeyan kudu nggawe Agen Tes anyar.
Lampiran: Struktur Wit Model Lengkap YANG
Ing lampiran iki, bagean "Legenda" ing kaca 81 nerangake sintaks struktur wit model YANG sing digawe karo printah pyang -f tree.
Bagean "YANG Model Tree Structure" ing kaca 82 menehi output saka printah sing ditrapake ing netrounds-ncc.yang. Bagean saka output iki diprodhuksi ing papan liya ing dokumen kasebut.
Legenda
Struktur Wit Model YANG
Juniper Networks, logo Juniper Networks, Juniper, lan Junos minangka merek dagang kadhaptar saka Juniper Networks, Inc. ing Amerika Serikat lan negara liyane. Kabeh merek dagang liyane, merek layanan, merek kadhaptar, utawa merek layanan sing kadhaptar minangka properti sing nduweni. Juniper Networks ora tanggung jawab kanggo akurasi ing dokumen iki. Juniper Networks nduweni hak kanggo ngganti, ngowahi, nransfer, utawa ngowahi publikasi iki tanpa kabar. Hak cipta © 2023 Juniper Networks, Inc. Kabeh hak dilindhungi undhang-undhang.
Dokumen / Sumber Daya
![]() |
Juniper NETWORKS NETCONF & YANG API Software [pdf] Pandhuan pangguna NETCONF YANG API Software, YANG API Software, API Software, Software |