Orkestrasi NETCONF & YANG API
Memandu
Diterbitkan
Telepon: 2023-07-07
LEPASKAN 4.2
Perkenalan
Tujuan Dokumen Ini
Dokumentasi ini menjelaskan cara mengintegrasikan Paragon Active Assurance dengan orkestrator layanan jaringan melalui Control Center NETCONF & YANG API. Mantan langsungampFile diberikan tugas utama yang terlibat, termasuk: membuat dan menyebarkan Agen Uji Virtual, menjalankan pengujian dan monitor, dan mengambil hasil dari aktivitas ini.
Dalam dokumen ini, klien Python NETCONF yang tersedia secara gratis digunakan sebagai orkestrator.
Konvensi
Singkatan berikut digunakan dalam dokumen ini:
| Singkatan | Arti |
| KLIK | Antarmuka Baris Perintah |
| EM | Manajer Elemen |
| ES | Kesalahan Kedua |
| Anggota Parlemen Eropa | Titik Akhir MEG (Maintenance Entity Group) (definisi ITU-T Y.1731) atau Titik Akhir Pemeliharaan (definisi Cisco) |
| Kendaraan Bermotor Listrik (NFV) | Virtualisasi Fungsi Jaringan |
| NFVO | Orchestrator Virtualisasi Fungsi Jaringan |
| Bahasa Indonesia: NSD | Deskriptor Layanan Jaringan |
| RPC | Panggilan Prosedur Jarak Jauh |
| MENYESAP | Protokol Inisiasi Sesi |
| Persyaratan Layanan | Perjanjian Tingkat Layanan |
| S-VNFM | Manajer VNF Khusus |
| Bahasa Indonesia: VNF | Fungsi Jaringan Virtual |
| vTA | Agen Tes Virtual |
Catatan tentang Kompatibilitas Mundur
Dalam NETCONF & YANG API versi 2.35.4/2.36.0, validasi permintaan tertentu dibuat lebih ketat untuk mematuhi standar NETCONF. Artinya, kode klien yang didasarkan pada versi lama panduan ini mungkin sekarang ditolak.
Misalnyaample, di Python sebelumnya, misalnyaampkode le, tidak ada atribut namespace yang disediakan. Namespace sekarang perlu disediakan dalam XML permintaan kapan pun Anda ingin mengubah sumber daya ConfD.
Prasyarat dan Persiapan
Instalasi ConfD
ConfD (produk dari Tail-f) digunakan sebagai perantara antara sistem Paragon Active Assurance dan NETCONF. ConfD menghubungkan konfigurasi Paragon Active Assurance dan data operasional ke NETCONF & YANG API.
ConfD seharusnya sudah diinstal bersama dengan perangkat lunak Pusat Kontrol, seperti yang dijelaskan dalam Panduan Instalasi.
Memverifikasi ConfD Sedang Berjalan
Untuk memverifikasi bahwa ConfD sudah aktif dan berjalan, jalankan perintah
ssh -s @localhost -p 830 netconf
untuk memeriksa apakah ConfD merespons pada port 830. Pada perintah, adalah seperti yang didefinisikan oleh pengguna netconf yang dibuat
perintah di Panduan Instalasi, bagian Menginstal ConfD. Berikan kata sandi yang ditentukan oleh perintah yang sama.
Pada output, verifikasi bahwa modul Pusat Kontrol disertakan. Outputnya harus berisi baris seperti berikut:
http://ncc.netrounds.com?module=netrounds-ncc&revisi=2017-06-15
Menyinkronkan Database Konfigurasi dengan Pusat Kontrol
Terakhir, kita perlu memperbarui database konfigurasi melalui NETCONF. Kami akan melakukannya di sini melalui perpustakaan Python yang disebut ncclient (NETCONF Client). Namun, tugas tersebut juga dapat diselesaikan dalam bahasa pemrograman lain asalkan menggunakan protokol NETCONF/YANG.
Peran ncclient adalah bertindak sebagai klien terhadap server ConfD yang menghosting NETCONF/YANG API.
Perlu diperhatikan bahwa ncclient sama sekali tidak terkait dengan Pusat Kontrol (sebelumnya “Pusat Kontrol Netrounds”), meskipun namanya diawali dengan “ncc”.
Berikut cara menginstal ncclient:
- Unduh perangkat lunak dari https://github.com/ncclient/ncclient.
- Jalankan perintah ini: pip install ncclient
Sekarang kita dapat melakukan sinkronisasi sebagai berikut. Perhatikan baik-baik bahwa ini perlu dilakukan di komputer terpisah, dan bukan di server Pusat Kontrol itu sendiri:
#
# CATATAN:
# Script ini bertindak sebagai klien terhadap ConfD yang berjalan di server NCC.
# Ini akan menggunakan NETCONF/YANG API untuk komunikasi.
CATATAN: Prosedur ini juga diperlukan setiap kali Agen Uji telah diinstal dan didaftarkan secara independen dari NETCONF. Lihat catatan di bagian “Selesaiview Orkestrasi Agen Tes” di halaman 17 untuk informasi lebih lanjut.
Menyiapkan Beberapa Akun Jaminan Aktif Paragon yang dikendalikan NETCONF
Langkah-langkah di bawah ini diperlukan hanya jika Anda ingin menyiapkan akun Paragon Active Assurance lebih lanjut untuk dikontrol oleh NETCONF, selain akun yang dikonfigurasi dengan cara ini di Panduan Instalasi, bagian “Menginstal ConfD”.
Untuk setiap akun tersebut, lakukan sebagai berikut:
- Di Pusat Kontrol, masuk ke akun dan navigasikan ke Akun > Izin.
- Tambahkan pengguna “confd@netrounds.com“, dan berikan izin admin pengguna ConfD ini di GUI dengan mengklik tombol Undang.
- Sinkronkan database konfigurasi dengan Pusat Kontrol seperti yang dijelaskan di bagian “Menyinkronkan Database Konfigurasi dengan Pusat Kontrol” di halaman 4.
Anda sekarang seharusnya dapat mengontrol beberapa akun Paragon Active Assurance dengan pengguna ConfD yang sama.
CATATAN: Setelah Anda mulai mengontrol akun Paragon Active Assurance melalui ConfD, Anda TIDAK boleh melakukan perubahan pada akun ini melalui web GUI sehubungan dengan fitur Paragon Active Assurance yang “config” (lihat bab “Fitur yang Didukung di Paragon Active Assurance” di halaman 9). Jika Anda melakukannya, sinkronisasi akan hilang.
Pengantar API Orkestrasi NETCONF
Lebihview
NFVO pihak ketiga atau orkestrator layanan biasanya merupakan komponen yang memulai sesi pengujian dan pemantauan menggunakan API Pusat Kontrol. Orkestra ini juga mengambil hasil pengukuran gabungan dari aktivitas Agen Penguji. KPI Kinerja dapat diambil oleh Sistem Manajemen Kinerja pihak ketiga, sementara peristiwa – yang dipicu oleh pelanggaran ambang batas yang ditetapkan di Pusat Kontrol – dapat dikirim ke sistem Manajemen Kesalahan pihak ketiga.
Ringkasnya, gambar di bawah ini menunjukkan bagaimana Paragon Active Assurance berinteraksi dengan sistem pihak ketiga lainnya di lanskap OSS.
- NFVO/Service Orchestrator: Memerintahkan Manajer VNF untuk menyebarkan vTA dan mengonfigurasi Paragon Active Assurance ke dalam rantai layanan. Setelah layanan diaktifkan, orkestrator menggunakan API menuju Pusat Kontrol untuk memicu tes aktivasi layanan dan mengambil hasil lulus/gagal. Jika pengujian berhasil, orkestrator akan menggunakan API menuju Pusat Kontrol untuk memulai pemantauan aktif terhadap layanan. KPI dari pemantauan diambil secara terus-menerus baik oleh orkestrator atau oleh platform Manajemen Kinerja terpisah.
- Pusat Kontrol: Menyebarkan, menskalakan, dan mengakhiri vTA seperti yang diinstruksikan oleh NFVO atau orkestra layanan.
- Sistem Manajemen Kinerja atau sistem Manajemen Kualitas Layanan: Membaca KPI dari pemantauan aktif melalui API Pusat Kontrol.
- Sistem Manajemen Kesalahan: Menerima pemberitahuan NETCONF, SNMP, atau email dari Pusat Kontrol jika SLA dilanggar.
Definisi Konsep dalam Paragon Active Assurance
- Agen Uji: Komponen yang melakukan pengukuran (untuk pengujian dan monitor) dalam sistem Paragon Active Assurance. Agen Uji terdiri dari perangkat lunak dengan kemampuan untuk menghasilkan, menerima, dan menganalisis lalu lintas jaringan nyata.
- Jenis Agen Uji yang dibahas dalam dokumen ini adalah Agen Uji Virtual (vTA), sebuah fungsi jaringan virtual (VNF) yang diterapkan pada hypervisor. Jenis Agen Uji lainnya juga ada.
- Ada dua tipe dasar pengukuran di Paragon Active Assurance, pengujian dan monitor.
- Tes: Sebuah tes terdiri dari satu atau beberapa langkah, yang masing-masing memiliki durasi tertentu dan terbatas. Langkah-langkah dijalankan secara berurutan. Setiap langkah mungkin memerlukan menjalankan banyak tugas secara bersamaan.
- Monitor: Monitor tidak memiliki durasi tertentu tetapi dijalankan tanpa batas waktu. Seperti langkah dalam pengujian, monitor dapat menjalankan beberapa tugas secara bersamaan.
- Templat: Ketika Paragon Active Assurance dikendalikan oleh orkestrator, pengujian dan monitor selalu dijalankan melalui templat tempat pengujian atau monitor ditentukan. Pengaturan parameter dapat diteruskan sebagai masukan ke templat saat runtime.
Alur Kerja untuk Otomatisasi
Waktu Desain
Pada waktu desain, Anda mempersiapkan pengukuran dengan membuat templat untuk pengujian dan monitor di Paragon Active Assurance. Cara melakukannya dibahas dalam bab “Menguji dan Memantau Template” di halaman 15.
Waktu berjalan
Saat runtime, Anda menyiapkan perangkat dan melakukan pengukuran sebenarnya.
- Sebuah selesaiview dari semua mantanamppelajaran yang diberikan ditemukan dalam bab “Kelampfile Controlling Paragon Active Assurance melalui NETCONF & YANG API” di halaman 15.
- Cara menerapkan dan mengonfigurasi Agen Uji dijelaskan dalam bab “Misamples: Agen Uji” di halaman 16.
- Cara import barang inventaris seperti TWAMP reflektor dan saluran IPTV dibahas dalam bab “Kelamples: Item Inventaris” pada halaman 29.
- Cara mengkonfigurasi alarm dijelaskan di bab “Misamples: Alarm” di halaman 35.
- Cara menjalankan pengujian dan monitor dengan menjalankan template Paragon Active Assurance melalui NETCONF dijelaskan dalam bab “Examples: Tes” pada halaman 43 dan “Kelamples: Monitor” pada halaman 54.
Fitur yang Didukung di Paragon Active Assurance
Semua jenis pengujian dan monitor di Paragon Active Assurance dapat dibuat dan dijalankan melalui penggunaan templat. Cara melakukan ini tercakup dalam bantuan dalam aplikasi di bawah “Tes dan monitor” > “Membuat template”.
Pembuatan akun Paragon Active Assurance saat ini tidak didukung; namun, satu atau beberapa akun yang telah ditentukan sebelumnya telah disiapkan untuk pengguna.
Tabel di bawah merinci fitur apa saja di Paragon Active Assurance yang tersedia dalam rilis ini, dan bagaimana fitur tersebut direpresentasikan dalam YANG.
Penjelasan Konstruksi YANG
Untuk memudahkan, di sini diberikan definisi tentang konstruksi YANG yang dirujuk dalam tabel fitur.
- Config (config=true): Data konfigurasi, diperlukan untuk mengubah sistem dari satu keadaan ke keadaan lainnya.
- Status (config=false): Data status: data tambahan pada sistem yang bukan data konfigurasi, seperti informasi status hanya-baca dan statistik yang dikumpulkan.
- RPC: Panggilan Prosedur Jarak Jauh, seperti yang digunakan dalam protokol NETCONF.
- Notifikasi: Notifikasi acara dikirim dari server NETCONF ke klien NETCONF.
Tabel Fitur Jaminan Aktif Paragon yang Tersedia untuk Orkestrasi
Sumber: Pemantauan
Jalur YANG:/akun/akun/monitor
| Fitur | Subfitur | konstruksi YANG |
| Membuat/memodifikasi/menghapus monitor | Berdasarkan template monitor | Konfigurasi |
| Mulai/hentikan monitor | – | Konfigurasi |
| Pantau templat | Buat daftar templat monitor yang ada beserta masukannya | Negara |
| Pemberitahuan NETCONF | Status alarm berubah | Pemberitahuan |
| Pantau hasil | Penghitung SLA/ES untuk tingkat atas (%) Penghitung SLA/ES untuk tingkat tugas (%) |
Negara |
Tidak seperti pengujian (bandingkan Sumber Daya: Pengujian di bawah), monitor tidak dimulai dengan RPC melainkan dengan melakukan konfigurasi monitor.
Sumber: Tes
Jalur YANG: /accounts/account/tests
| Fitur | Subfitur | konstruksi YANG |
| Mulai pengujian | Berdasarkan templat pengujian | RPC |
| Kelola tes | Daftar tes dengan status | Negara |
| Templat uji | Buat daftar templat pengujian yang ada dengan masukan | Negara |
| Pemberitahuan NETCONF | Status tes berubah | Pemberitahuan |
| Hasil pengujian | Dapatkan status langkah pengujian (lulus, gagal, error,…) | Negara |
Sumber: Agen Uji
Jalur YANG:
- /accounts/account/test-agents (Konfigurasi)
- /accounts/account/registered-test-agents (Negara Bagian)
Agen Uji di bawah /accounts/account/test-agents adalah agen yang dikonfigurasi di akun. Hanya Agen Pengujian ini yang dapat dikonfigurasi dan digunakan dalam pengujian dan monitor melalui NETCONF oleh orkestrator.
Setelah Anda mengonfigurasi Agen Uji dan mendaftarkannya ke akun, Agen Uji akan muncul di /accounts/account/registered-test-agents. Anda dapat menemukan semua Agen Uji yang terdaftar menggunakan perintah “get” di NETCONF (bandingkan bab Examples: Agen Uji).
Di bawah /accounts/account/registered-test-agents Anda mungkin juga menemukan Agen Uji yang belum dikonfigurasi. Agen Uji apa pun harus dikonfigurasi sebelum dapat digunakan.
Dalam skenario orkestrasi, umumnya disarankan agar Anda melakukan semua konfigurasi akun Paragon Active Assurance Anda melalui NETCONF. Hal ini memastikan bahwa agen pengujian dan agen pengujian terdaftar tidak berbeda.
| Fitur | Subfitur | konstruksi YANG |
| Pra-buat Agen Uji di server | – | Konfigurasi |
| Konfigurasikan Agen Uji offline | (Pusat Kontrol mendorong konfigurasi ke Agen Uji ketika sudah online) |
Konfigurasi |
| Gunakan Agen Uji yang sudah ada/dikonfigurasi secara eksternal | Gunakan dalam pengujian/monitor | Konfigurasi |
| Konfigurasikan antarmuka | Konfigurasi | |
| Dapatkan status | Negara | |
| Konfigurasikan Agen Uji (khusus Alat Uji) | Konfigurasikan NTP | Konfigurasi |
| Konfigurasikan jembatan | Konfigurasi | |
| Konfigurasikan antarmuka VLAN | Konfigurasi | |
| Konfigurasikan kunci SSH | Konfigurasi | |
| Bahasa Indonesia: IPv6 | Konfigurasi | |
| Utilitas | Menyalakan ulang | RPC |
| Memperbarui | RPC | |
| Pemberitahuan NETCONF | Status daring berubah | Pemberitahuan |
| Status | Dapatkan status sistem (waktu aktif, penggunaan memori, memuat rata-rata, versi) |
Negara |
Sumber daya: Inventaris
Jalur YANG: /akun/akun/twamp-reflektor
Kemampuan NETCONF yang Didukung
Tabel di bawah ini menunjukkan RFC IETF yang menjelaskan kemampuan NETCONF yang digunakan untuk tujuan orkestrasi Paragon Active Assurance.
- ietf-netconf.yang
- IETF RFC 6241, Protokol Konfigurasi Jaringan (NETCONF), https://tools.ietf.org/html/rfc6241
- Satu-satunya metode penanganan kesalahan yang didukung adalah rollback-on-error.
- Satu-satunya penyimpanan data yang didukung dapat dijalankan dan dapat ditulisi.
- ietf-netconf-notifications.yang
- IETF RFC 5277, Pemberitahuan Acara NETCONF, https://tools.ietf.org/html/rfc5277
Uji dan Pantau Templat
Templat untuk jenis pengujian dan monitor perlu diatur secara manual melalui antarmuka pengguna front-end Paragon Active Assurance. Cara melakukan ini tercakup dalam bantuan dalam aplikasi di bawah “Tes dan monitor” > “Membuat template”.
Exampfile Pengendalian Jaminan Aktif Paragon melalui NETCONF & YANG API
Pada bab-bab berikutnya, diasumsikan bahwa template pengujian dan monitor yang sesuai telah ditentukan sesuai dengan instruksi yang diberikan dalam bab “Templat Pengujian dan Monitor” di halaman 15.
Alat yang Digunakan dalam Kelampsedikit
Semua mantanampFile-file di bab-bab berikutnya telah dibuat menggunakan alat-alat yang tersedia secara gratis berikut ini:
- Pang: Digunakan untuk memvisualisasikan dan menelusuri model YANG.
- Tersedia di https://github.com/mbj4668/pyang (klon dari git dan jalankan python setup.py install).
- Klien Python NETCONF “ncclient”: Digunakan untuk berkomunikasi dengan Pusat Kontrol menggunakan NETCONF.
- Tersedia di https://github.com/ncclient/ncclient (jalankan pip install ncclient).
Model data netrounds-ncc.yang ditemukan di /opt/netrounds-confd setelah ConfD diinstal sesuai dengan Panduan Instalasi).
Lebihview Tugas Utama yang Dilakukan
(Beberapa tugas lebih lanjut juga dicontohkan sebagai berikut.)
- “Membuat dan menerapkan Agen Uji baru” di halaman 16
- “Membuat item inventaris (misalnya reflektor)” pada halaman 29
- “Menyiapkan template alarm dan ke mana mengirim alarm” pada halaman 35
- “Membuat dan menjalankan pengujian” pada halaman 45
- “Mengambil hasil tes” pada halaman 50
- “Menghidupkan monitor (termasuk pengaturan alarm)” pada halaman 60
- “Mengambil status SLA untuk monitor” pada halaman 67
- “Bekerja dengan tags” di halaman 71
Examples: Agen Uji
Lebihview Orkestrasi Agen Uji
Agen Uji di Paragon Active Assurance dianggap sebagai “konfigurasi” dalam konteks orkestrasi. Artinya, pembuatan, kontrol, dan penghapusan Agen Uji harus dilakukan melalui orkestrator dan NETCONF, bukan melalui Paragon Active Assurance GUI.
PENTING: Jika Agen Penguji diinstal oleh teknisi dan didaftarkan ke Pusat Kontrol tanpa terlebih dahulu dibuat melalui NETCONF & YANG API, Agen Penguji tidak akan ada dalam database konfigurasi, dan sistem akan tidak sinkron. Agar ConfD mengetahui Agen Uji dalam kasus ini, perlu dilakukan sinkronisasi baru dengan Pusat Kontrol, sebagaimana dijelaskan secara rinci di bagian “Menyinkronkan Database Konfigurasi dengan Pusat Kontrol” di halaman 4.
Oleh karena itu, orkestrasi Agen Uji Virtual (vTA) sebaiknya dilakukan dengan langkah-langkah berikut:
- Buat Virtual Test Agent, termasuk konfigurasi antarmukanya, menggunakan antarmuka NETCONF & YANG ke Pusat Kontrol. Nama Agen Penguji akan menjadi kunci uniknya.
- Terapkan vTA pada platform virtualisasi. Ikuti petunjuk dalam bantuan online di bawah Agen Uji > Instalasi. Konfigurasi antarmuka dasar yang memungkinkan vTA terhubung ke Pusat Kontrol, serta kredensial untuk autentikasi, diberikan ke vTA menggunakan data pengguna cloud-init.
Setelah vTA di-boot, vTA akan secara otomatis terhubung ke Pusat Kontrol menggunakan koneksi OpenVPN terenkripsi. Pemberitahuan NETCONF dikirim karena nilai parameter perubahan status-agen-pengujian vTA kini berubah menjadi "online".
CATATAN: Karena nama vTA adalah pengidentifikasinya di Pusat Kontrol, nama ini harus sama dengan yang ditentukan di Pusat Kontrol pada “langkah 1” di halaman 17. - Setelah vTA terhubung dan diautentikasi ke Pusat Kontrol, konfigurasi antarmuka dikirim ke vTA. Ini adalah konfigurasi antarmuka yang disediakan pada “langkah 1” di halaman 17 saat vTA dibuat di Pusat Kontrol.
- Setelah vTA memenuhi tujuannya, hapus vTA tersebut.
Membuat dan Menyebarkan Agen Uji Baru
Pertama-tama kita perlu membuat Agen Uji menggunakan antarmuka NETCONF & YANG ke Pusat Kontrol. Ketika Agen Uji dibuat dengan cara ini, sinkronisasi dengan Pusat Kontrol tidak diperlukan.
Model YANG untuk Agen Uji seperti yang digambarkan di bawah ini. Itu diperoleh sebagai output dari perintah
pyang -f pohon netrounds-ncc.yang
Model YANG lengkap diberikan dalam “Lampiran: Struktur Pohon Model YANG Penuh” di halaman 81, yang juga berisi legenda yang menjelaskan konvensi yang digunakan dalam ilustrasi model YANG ini dan lainnya dalam dokumen ini.
Kami melanjutkan langkah-langkah berikut, yang dirinci sebagai berikut:
- Pada awalnya, akun “demo” Paragon Active Assurance tidak memiliki Agen Uji dalam inventarisnya.
- Agen Uji yang disebut “vta1” dibuat menggunakan ncclient. Pada hal initage, belum ada Agen Penguji yang sebenarnya (artinya, belum dimulai).
- Agen Uji dikerahkan di OpenStack. (Penerapan pada platform tersebut dipilih di sini sebagai salah satu kemungkinan di antara kemungkinan lainnya.)
- Agen Penguji terhubung ke "demo" akun Pusat Kontrol dan sekarang siap digunakan.
Langkah 1: Pada awalnya, tidak ada Agen Tes di akun “demo”. Lihat tangkapan layar di bawah dari GUI Pusat Kontrol.
Langkah 2: Agen Uji dibuat di Pusat Kontrol menggunakan klien Python NETCONF “ncclient”. Di bawah ini adalah kode klien untuk membuat Agen Uji yang memiliki satu antarmuka fisik dengan alamat DHCP:
impor argparse
dari manajer impor klien
parser = argparse.ArgumentParser(deskripsi='Pengujian pembuatan Agen Penguji')
parser.add_argument('–host', help='Nama host tempat ConfD ditemukan', wajib=Benar)
parser.add_argument('–port', help='Port yang akan dihubungkan ke ConfD', diperlukan=True)
parser.add_argument('–nama pengguna', help='Nama pengguna untuk terhubung ke ConfD', diperlukan=Benar)
parser.add_argument('–password', help='Kata sandi ke akun ConfD', wajib=Benar)
parser.add_argument('–netrounds-account', help='Nama pendek akun NCC', wajib=Benar)
parser.add_argument('–nama-agen-penguji', help='Nama Agen Penguji', wajib=Benar)
args = parser.parse_args()
dengan manager.connect(host=args.host, port=args.port, nama pengguna=args.nama pengguna,
kata sandi=args.password, hostkey_verify=False) sebagai m:
# Buat Agen Uji di Pusat Kontrol
xml = “””
)cetak m.edit_config(target='berjalan', config=xml)
CATATAN: Kode sebelum manager.connect(…) dihilangkan dari contoh berikutnyaampcuplikan kode le.
Server NTP dikonfigurasi pada eth0, dan eth0 juga merupakan antarmuka manajemen (yaitu antarmuka yang terhubung ke Pusat Kontrol).
Aplikasi Agen Uji saat ini tidak mengizinkan konfigurasi antarmuka. Karena alasan ini, mulai versi 2.34.0 dan seterusnya, konfigurasi antarmuka dalam skema YANG dapat dihilangkan. Oleh karena itu, XML yang sesuai disederhanakan secara radikal dalam kasus ini:
Setelah Agen Uji dibuat, Agen Uji tersebut ada di database konfigurasi dan di Pusat Kontrol. Lihat tangkapan layar di bawah inventaris Agen Penguji, yang menunjukkan Agen Penguji “vta1”:
Langkah 3: Sekarang saatnya untuk menyebarkan Agen Uji “vta1” di OpenStack.
Agen Uji akan menggunakan data pengguna cloud-init untuk mengambil informasi tentang cara terhubung ke Pusat Kontrol. Khususnya, teks data pengguna file memiliki konten berikut (Perhatikan bahwa baris #cloud-config dan netrounds_test_agent harus ada, dan baris lainnya harus menjorok ke dalam):
Untuk informasi lebih lanjut, silakan merujuk ke dokumen Cara Menyebarkan Agen Tes Virtual di OpenStack.
Setelah Agen Penguji diterapkan dan terhubung ke Pusat Kontrol, konfigurasi akan dikirim dari Pusat Kontrol ke Agen Penguji.
Langkah 4: Agen Penguji sekarang online di Pusat Kontrol dan telah memperoleh konfigurasinya. Agen Penguji siap digunakan dalam pengujian dan pemantauan. Lihat bagian ini:
- “Memulai Tes” pada halaman 45
- “Menghidupkan Monitor” pada halaman 60
Mencantumkan Agen Uji di Akun Jaminan Aktif Paragon Anda
Di bawah ini adalah example ncclient kode Python untuk mencantumkan Agen Uji di akun Paragon Active Assurance:
Menjalankan kode ini memberikan output seperti di bawah ini:
Menghapus Agen Uji
Setelah pengujian selesai, dalam beberapa kasus penggunaan mungkin relevan untuk menghapus Agen Pengujian.
Di bawah ini cuplikan kode yang menunjukkan cara melakukan ini dengan ncclient:
Pemberitahuan NETCONF
Di bawah ini kami sajikan contoh sederhanaample skrip untuk mendengarkan semua notifikasi NETCONF yang masuk dari Pusat Kontrol. Pemberitahuan ini dikirim setiap kali peristiwa tertentu terjadi, seperti Agen Pengujian sedang offline atau pengujian yang dimulai oleh pengguna sedang diselesaikan. Berdasarkan informasi yang dibawa dalam notifikasi, pengguna dapat menetapkan tindakan tindak lanjut otomatis di orkestrator.
Ketika skrip di atas dijalankan, klien NC akan menampilkan notifikasi yang diterima dalam XML terstruktur. Lihat mantanample output di bawah ini, yang menunjukkan Agen Uji offline secara tidak terduga.
2017-02-03T15:09:55.939156+00:00</eventTime>
<test-agent-status-change xmlns=’http://ncc.netrounds.com'>
demo
HW1
luring
Examples: Item Inventaris
Membuat (mengimpor) dan mengelola barang inventaris seperti TWAMP reflektor dan Parlemen Eropa Y.1731 dilakukan dengan cara yang sama seperti untuk Agen Penguji. Di bawah ini adalah kode XML dan NETCONF untuk mendefinisikan entitas tersebut di Paragon Active Assurance melalui NETCONF & YANG API dan untuk mengambil daftar item yang ditentukan.
Membuat TWAMP Reflektor
Pembentukan MEP Y.1731
Membuat Saluran IPTV
Membuat Host Ping
Membuat Akun SIP
Mengambil Item Inventaris
Di bawah ini adalah kode Python untuk mengambil semua item inventaris yang ditentukan dalam sebuah akun. (Semua jenis item inventaris diambil sekaligus di sini untuk menghindari pengulangan dalam dokumen. Biasanya, subkumpulan item inventaris apa pun dapat diambil dengan mengabaikan beberapa baris pada akun di bawah.)
Menjalankan kode ini memberikan output seperti di bawah ini:
Examples: Alarm
Templat alarm dan item terkait (manajer SNMP, daftar email alarm) dibuat dan dikelola dengan cara yang sama seperti item inventaris. Bab ini berisi kode XML dan NETCONF untuk mendefinisikan entitas tersebut di Paragon Active Assurance melalui NETCONF & YANG API dan untuk mengambil daftar item yang ditentukan.
Daftar Email Alarm
Membuat Daftar Email Alarm
Mengambil Semua Daftar Email Alarm
Manajer SNMP
Membuat Manajer SNMP
Mengambil Semua Manajer SNMP
Templat Alarm
Membuat Templat Alarm
Mengambil Semua Template Alarm
Exampfile: Kunci SSH
Anda dapat menambahkan kunci publik SSH ke Agen Uji melalui NETCONF & YANG API. Dengan menggunakan kunci pribadi yang sesuai, Anda kemudian dapat masuk ke Agen Tes melalui SSH.
Daftar lengkap operasi yang tersedia pada kunci SSH adalah sebagai berikut:
- Tambahkan kunci SSH
- Ubah kunci SSH
- Periksa kunci SSH
- Daftar kunci SSH
- Hapus kunci SSH.
Di bawah ini, operasi tambah dan hapus dicontohkan.
Menghapus Kunci SSH
Jika Anda ingin menghapus kunci SSH, gunakan perintah berikut:
Examples: Tes
Di sini diasumsikan bahwa Agen Penguji (sebanyak yang diperlukan untuk pengujian) telah dibuat sesuai dengan bagian “Membuat dan Menerapkan Agen Penguji Baru” di halaman 17.
Jalur Model YANG untuk Pengujian
| Barang | Jalur model YANG: /akun/akun/tes … |
| tes | /. |
| tes[id] | /tes |
| id | /tes/id |
| nama | /tes/nama |
| status | /tes/status |
| waktu mulai | /test/waktu mulai |
| akhir zaman | /test/akhir waktu |
| laporan-url | /laporan pengujian-url |
| tangga | /tes/langkah |
| langkah[id] | /tes/langkah/langkah |
| nama | /test/langkah/langkah/nama |
| id | /test/langkah/langkah/id |
| waktu mulai | /test/steps/step/start-time |
| akhir zaman | /test/steps/step/akhir waktu |
| status | /test/langkah/langkah/status |
| pesan status | /test/steps/step/status-message |
| templat | /templat |
| templat[nama] | /templat/templat |
| nama | /template/template/nama |
| keterangan | /templates/template/deskripsi |
| Parameter | /template/template/parameters |
| parameter[kunci] | /templates/template/parameters/parameter |
| kunci | /templates/template/parameters/parameter/key |
| jenis | /templates/template/parameters/parameter/type |
Prasyarat untuk Orkestrasi Tes
- Untuk memulai pengujian melalui NETCONF menggunakan klien NC, pertama-tama Anda harus membuat templat pengujian menggunakan GUI Pusat Kontrol sebagaimana dirinci dalam bantuan dalam aplikasi pada “Tes dan monitor” > “Membuat templat”. Semua bidang yang ditentukan dalam template tersebut sebagai "Input template" akan diperlukan sebagai parameter dalam XML saat mengatur inisiasi template pengujian.
- Menjalankan pengujian di Paragon Active Assurance dianggap sebagai “status” dalam konteks orkestrasi. Data status adalah data yang tidak dapat ditulis dan tidak disimpan dalam database konfigurasi, berbeda dengan data konfigurasi yang disebutkan di bagian “Overview dari Test Agent Orchestration” di halaman 17. Ini pada dasarnya berarti bahwa perubahan pada pengujian atau templat di GUI Pusat Kontrol tidak akan menyebabkan masalah apa pun terkait sinkronisasi antara Pusat Kontrol dan database konfigurasi.
- Untuk mendapatkan laporan-URL tepat di laporan pengujian, Anda perlu memastikan Pusat Kontrol URL dikonfigurasi dengan benar. Hal ini dilakukan di file /opt/netrounds-confd/settings.py. Secara default, nama host Pusat Kontrol diambil menggunakan socket.gethostname(): lihat di bawah. Jika ini tidak memberikan hasil yang benar, Anda perlu mengatur nama host (atau keseluruhan URL) secara manual dalam hal ini file.
# URL Pusat Kontrol tanpa garis miring.
# Ini misalnyaample digunakan dalam laporan pengujian-url.
HOSTNAME = soket.gethostname()
JARINGAN_URL = 'https://%s' % NAMA HOST
Memulai Ujian
Seperti yang dijelaskan di bagian “Membuat dan Menerapkan Agen Uji Baru” di halaman 17, jalankan perintah pang -f tree netrounds-ncc.yang
dari direktori /opt/netrounds-confd/ untuk menampilkan model YANG. Dalam model ini, RPC untuk memulai pengujian menggunakan klien NC terlihat sebagai berikut:
Untuk penjelasannya, lihat bagian tersebut “Legenda” di halaman 81 dalam Lampiran.
Langkah-langkah berikut ditunjukkan di bawah ini:
- Agen Uji telah terdaftar pada akun Paragon Active Assurance, namun belum ada pengujian yang dimulai.
- Parameter input yang diperlukan diidentifikasi dalam template pengujian yang akan dijalankan.
- Tes HTTP 60 detik dimulai menggunakan ncclient.
Melangkah 1: Pada awalnya, tidak ada pengujian yang dimulai di akun Paragon Active Assurance. Lihat tangkapan layar di bawah dari GUI Pusat Kontrol.
Melangkah 2: Templat yang akan kita gunakan untuk memulai pengujian pada contoh iniample adalah templat pengujian HTTP. Ini memiliki dua bidang input wajib (Klien dan URL) yang telah kami tentukan saat membuat templat di GUI Pusat Kontrol.
Kami akan menentukan parameter ini (antara lain) dalam konfigurasi XML yang dikomunikasikan ke database konfigurasi oleh manajer NETCONF kami (ncclient).
Langkah 3: Tes HTTP dimulai menggunakan ncclient.
Di bawah ini adalah example kode di mana informasi konfigurasi dan parameter yang diperlukan ditentukan untuk templat pengujian HTTP. Bergantung pada cara templat dibuat, detail di sini mungkin berbeda.
Untuk setiap parameter, atribut perlu disediakan. Kuncinya identik dengan parameter
Nama variabel di Pusat Kontrol. Anda dapat memeriksa nama variabel sebagai berikut:
- Klik Tes di bilah samping dan pilih Urutan Tes Baru.
- Klik Templat Saya.
- Klik tautan Edit di bawah templat yang diinginkan.
- Klik tombol Edit masukan di sudut kanan atas.
Di mantan kitaampfile, dan secara default, nama variabel hanyalah versi huruf kecil dari nama tampilan yang terlihat di Pusat Kontrol (“url"Vs."URL", dll.). Namun, di GUI Pusat Kontrol, Anda dapat mengganti nama variabel menjadi apa pun yang Anda suka.
Selain kunci, setiap parameter harus memiliki tipe yang ditentukan: misalnyaample, Untuk URL.
Harap dicatat bahwa Anda perlu melakukannya kembaliview model YANG lengkap untuk mendapatkan informasi lengkap tentang jenisnya. Untuk antarmuka Agen Uji, tipenya memiliki struktur yang lebih kompleks, sebagaimana dibuktikan di bawah dalam kode di bawah ini.
Sekarang kita dapat menjalankan skrip menggunakan ncclient. Dengan asumsi semuanya benar, pengujian akan dimulai dan pelaksanaannya ditampilkan di Pusat Kontrol:
Jika pengujian berhasil dimulai, Pusat Kontrol akan merespons dengan ID pengujian. Dalam mantan iniample, ID tesnya adalah 3:
ID tes juga dapat ditemukan di URL untuk pengujian di GUI Pusat Kontrol. Dalam mantan iniampbaiklah, itu URL adalah https://host/demo/testing/3/.
Mengambil Hasil Tes
Cara paling mudah untuk mengambil hasil tes adalah dengan menunjuk ke ID tes.
Di bawah ini adalah kode Python untuk mendapatkan hasil dari pengujian HTTP di atas dengan ID = 3:
dengan manajer. Hubungkan(host=args.host, port=args.port, nama pengguna=args.nama pengguna, kata sandi=args.password, hostkey_verify=False) sebagai m:
Outputnya akan terlihat seperti ini:
Mengekspor dan Mengimpor Templat Uji
Templat pengujian dapat diekspor dalam format JSON dan diimpor ulang dalam format tersebut ke Pusat Kontrol. Ini berguna jika Anda ingin menggunakan templat pengujian di instalasi Pusat Kontrol yang berbeda. (Pembuatan awal templat paling baik ditangani melalui GUI Pusat Kontrol.)
Di bawah ini adalah kode untuk melakukan ekspor dan impor.
Mengekspor Template Tes
# Dapatkan konfigurasi json dari respons
root = ET.fromstring(respons._raw)
json_config = root[0].teks
cetak json_config
Templat terdapat dalam objek json_config.
Mengimpor Templat Uji
Templat pengujian penyimpanan objek konfigurasi JSON dapat diimpor ulang ke Pusat Kontrol sebagai berikut.
Exampfile: Monitor
Bagian ini mengasumsikan bahwa Agen Penguji (sebanyak yang diperlukan oleh monitor) telah dibuat sesuai dengan bagian “Membuat dan Menerapkan Agen Penguji Baru” di halaman 17.
Jalur Model YANG untuk Monitor
| Barang | Jalur model YANG: /akun/akun/monitor … |
| memantau | /. |
| monitor[nama] | /memantau |
| nama | /monitor/nama |
| keterangan | /monitor/deskripsi |
| dimulai | /monitor/mulai |
| templat | /monitor/templat |
| konfigurasi alarm | /monitor/alarm-configs |
| Barang | Jalur model YANG: /accounts/account/monitors/monitor/alarm-configs … |
| konfigurasi alarm[pengidentifikasi] | /alarm-config |
| pengenal | /alarm-config/identifier |
| templat | /alarm-config/template |
| /alarm-config/email | |
| snmp | /alarm-config/snmp |
| sangat penting | /alarm-config/thr-es-critical |
| tiga-es-kritis-jelas | /alarm-config/thr-es-critical-clear |
| thr-es-mayor | /alarm-config/thr-es-major |
| thr-es-mayor-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 |
| tiga-es-peringatan | /alarm-config/thr-es-warning |
| thr-es-peringatan-jelas | /alarm-config/thr-es-warning-clear |
| tidak ada tingkat keparahan data | /alarm-config/no-data-severity |
| tidak ada batas waktu data | /alarm-config/tidak ada-data-batas waktu |
| tindakan | /alarm-config/action |
| ukuran jendela | /alarm-config/window-size |
| selang | /alarm-config/interval |
| kirim-hanya-sekali | /alarm-config/kirim-hanya-sekali |
| snmp-perangkap-per-aliran | /alarm-config/snmp-trap-per-stream |
| Barang | Jalur model YANG: /akun/akun/monitor … |
| Parameter | /monitor/parameter |
| Barang | Jalur model YANG: /akun/akun/monitor/monitor/parameter … |
| parameter[kunci] | /parameter |
| kunci | /parameter/kunci |
| (tipe nilai) | /parameter |
| :(bilangan bulat) | /parameter |
| bilangan bulat | /parameter/bilangan bulat |
| :(mengambang) | /parameter |
| mengambang | /parameter/mengapung |
| :(rangkaian) | /parameter |
| Barang | Jalur model YANG: /akun/akun/monitor/monitor/parameter … |
| rangkaian | /parameter/string |
| :(antarmuka-agen-uji) | /parameter |
| antarmuka agen uji | /parameter/test-agent-interfaces |
| antarmuka agen uji[“1” pada halaman 58 | /parameter/antarmuka-agen-uji/ |
| akun | /parameter/test-agent-interfaces/test-agent-interface/account |
| agen tes | /parameter/test-agent-interfaces/test-agent-interface/test-agent |
| antarmuka | /parameter/test-agent-interfaces/test-agent-interface/interface |
| versi ip | /parameter/test-agent-interfaces/test-agent-interface/ip-version |
| :(twamp-reflektor) | /parameter |
| twamp-reflektor | /parameter/twamp-reflektor |
| twamp-reflektor[nama] | /parameter/twamp-reflektor/twamp-reflektor |
| nama | /parameter/twamp-reflektor/twamp-reflektor/nama |
| :(y1731-meps) | /parameter |
| y1731-meps | /parameter/y1731-meps |
| y1731-mep[nama] | /parameter/y1731-meps/y1731-mep |
| nama | /parameter/y1731-meps/y1731-mep/name |
| :(akun sip) | /parameter |
| akun sip | /parameter/sip-accounts |
| akun sip[“2” di halaman 58] | /parameter/sip-accounts/sip-account |
| akun | /parameter/sip-accounts/sip-account/account |
| agen tes | /parameter/sip-accounts/sip-account/test-agent |
| antarmuka | /parameter/sip-accounts/sip-account/interface |
| alamat sip | /parameter/sip-accounts/sip-account/sip-address |
| :(saluran IPTV) | /parameter |
| saluran IPTV | /parameter/iptv-channels |
| saluran IPTV[nama] | /parameter/iptv-channels/iptv-channel |
| nama | /parameter/iptv-channels/iptv-channel/name |
- antarmuka agen penguji akun
- alamat sip antarmuka agen penguji akun
| Barang | Jalur model YANG: /akun/akun/monitor … |
| status | /monitor/status |
| 15 menit terakhir | /monitor/status/15 menit terakhir |
| status | /monitor/status/15 menit terakhir/status |
| nilai status | /monitor/status/15 menit terakhir/status-value |
| jam terakhir | /monitor/status/jam terakhir |
| status | /monitor/status/jam terakhir/status |
| nilai status | /monitor/status/jam terakhir/status-value |
| 24 jam terakhir | /monitor/status/24 jam terakhir |
| status | /monitor/status/24 jam terakhir/status |
| nilai status | /monitor/status/24 jam terakhir/status-value |
| templat | /templat |
| templat[nama] | /templat/templat |
| nama | /template/template/nama |
| keterangan | /templates/template/deskripsi |
| Parameter | /template/template/parameters |
| parameter[kunci] | /templates/template/parameters/parameter |
| kunci | /templates/template/parameters/parameter/key |
| jenis | /templates/template/parameters/parameter/type |
Prasyarat untuk Orkestrasi Monitor
Sebelum Anda dapat memulai monitor melalui NETCONF menggunakan ncclient, Anda perlu membuat template monitor di GUI Pusat Kontrol seperti yang dijelaskan dalam bantuan dalam aplikasi pada “Tes dan monitor” > “Membuat template”. Semua bidang yang ditentukan sebagai “Input template” dalam template tersebut akan diperlukan sebagai parameter dalam XML saat mengatur inisiasi template.
Mendapatkan Parameter Input dari Template Monitor
Di bawah ini, dua templat ditampilkan. Yang pertama adalah untuk pemantauan UDP antara dua antarmuka Agen Uji, dan yang kedua adalah untuk HTTP menggunakan antarmuka Agen Uji tunggal.
Untuk mengetahui parameter masukan suatu templat, klik kotak yang mewakili templat tersebut. Untuk template HTTP, parameternya mungkin terlihat seperti ini:
Kita perlu menentukan parameter ini pada langkah berikutnya saat memulai monitor.
Memulai Monitor
Dengan menggunakan Agen Penguji yang telah kita tentukan dan terapkan di bagian “Membuat dan Menerapkan Agen Penguji Baru” di halaman 17, kita dapat memulai monitor dari templat “HTTP” seperti yang ditunjukkan di bawah ini.
Untuk setiap parameter, atribut perlu disediakan. Kuncinya identik dengan nama Variabel parameter di Pusat Kontrol. Anda dapat memeriksa nama variabel sebagai berikut:
- Klik Pemantauan di bilah samping dan pilih Monitor Baru.
- Klik Templat Saya.
- Klik tautan Edit di bawah templat yang diinginkan.
- Klik tombol Edit masukan di sudut kanan atas.
Di mantan kitaampfile, dan secara default, nama variabel hanyalah versi huruf kecil dari nama tampilan yang terlihat di Pusat Kontrol (“url"Vs."URL", dll.). Namun, di GUI Pusat Kontrol, Anda dapat mengganti nama variabel menjadi apa pun yang Anda suka.
Selain kunci, setiap parameter harus memiliki tipe yang ditentukan: misalnyaample, Untuk URL. Harap dicatat bahwa informasi lengkap tentang jenis parameter dapat ditemukan di model YANG. Untuk antarmuka Agen Uji, tipenya memiliki struktur yang lebih kompleks, sebagaimana dibuktikan dalam kode di bawah.
Di mantanample berikutnya, tidak ada alarm yang dikaitkan dengan monitor. Misalnyaampfile yang melibatkan alarm, buka bagian “Menghidupkan Monitor dengan Alarm” pada halaman 62.
Memulai Monitor dengan Alarm
Untuk mengaitkan alarm dengan monitor, Anda dapat menunjuk ke templat alarm yang telah ditentukan, atau Anda dapat menyediakan seluruh konfigurasi alarm saat membuat monitor. Kami akan memberikan satu contohample dari setiap pendekatan di bawah ini.
Menyiapkan Alarm Monitor dengan Menunjuk ke Templat Alarm
Untuk menggunakan templat alarm, Anda harus mengetahui ID-nya. Untuk melakukan hal ini, pertama-tama ambil semua templat alarm Anda seperti dijelaskan di bagian “Mengambil Semua Templat Alarm” di halaman 39 dan catat nama templat yang relevan. Anda kemudian dapat merujuk ke templat itu sebagai berikut:
Menyiapkan Alarm Monitor dengan Mengonfigurasinya Secara Langsungy
Alternatifnya, Anda dapat mengatur alarm untuk monitor dengan menyediakan seluruh konfigurasinya saat membuat monitor, tanpa mengacu pada templat alarm. Ini dilakukan seperti yang ditunjukkan pada contoh berikutampsaya.
Mengambil Monitor yang Berjalan
Untuk mengambil semua monitor yang sedang dijalankan, jalankan skrip ini:
dengan manajer. connect(host=args.host, port=args.port, nama pengguna=args. nama pengguna, kata sandi=args.password, hostkey_verify=False) sebagai m:
Outputnya adalah daftar semua monitor yang berjalan seperti yang ditunjukkan di bawah ini:
Mengambil Status SLA untuk Monitor
Berikut cara mengambil status SLA untuk monitor. Dalam mantan iniampmisalnya, kami mengambil status SLA untuk monitor "Kualitas Jaringan" selama tiga interval waktu: 15 menit terakhir, satu jam terakhir, dan 24 jam terakhir.
Outputnya akan terlihat seperti ini:
Pemberitahuan NETCONF
Pemberitahuan NETCONF untuk monitor dipicu oleh pelanggaran SLA. Hal ini terjadi ketika SLA untuk monitor turun di bawah ambang batas SLA (“Baik” atau “Dapat Diterima”) dalam jangka waktu tertentu, secara default adalah 15 menit terakhir. Perlu dicatat bahwa pemberitahuan pelanggaran SLA akan segera muncul setelah layanan terkena dampak suatu masalah, sedangkan status SLA akan kembali ke “Baik” hanya setelah 15 menit, dan hanya jika tidak terjadi pelanggaran lebih lanjut.
Jendela waktu dapat diubah dengan mengedit pengaturan SLA_STATUS_WINDOW (nilai dalam detik) di /etc/netrounds/netrounds.conf.
Mengekspor dan Mengimpor Template Monitor
Hal ini dilakukan dengan cara yang persis sama seperti pada templat pengujian; bandingkan bagian “Mengekspor dan Mengimpor Templat Uji” di halaman 52. Cuplikan kode di bawah mengilustrasikan cara mengekspor dan mengimpor templat untuk monitor.
Mengekspor Template Monitor
Mengimpor Template Monitor
Tags didefinisikan dalam Paragon Active Assurance dapat diterapkan pada:
- memantau
- templat monitor
- Agen Uji
- TWAMP reflektor
- Ping tuan rumah.
Misalnyaample, kamu bisa tag monitor dengan hal yang sama tag sebagai bagian dari Agen Uji yang akan menjalankan monitor. Fitur ini sangat membantu jika Anda memiliki banyak monitor dan templat.
Jika Anda telah mengatur alarm dengan perangkap SNMP untuk monitor, maka perangkap SNMP akan ditetapkan sama tags sebagai monitor, jika ada.
Menciptakan Tags
Di bawah ini kami menunjukkan cara membuat tag dengan nama dan warna seperti yang ditentukan oleh XMLtag> substruktur.
Menetapkan Tag
Untuk menetapkan tag ke sumber daya, Anda menambahkannya sebagai sumber daya barutag> elemen di bawahtags> elemen untuk sumber daya itu.
Berikut cara menugaskan a tag ke Agen Uji:
Untuk menetapkan tag ke TWAMP reflektor, lakukan hal berikut:
Menetapkan tag ke monitor ditangani dengan cara yang sama:
Alternatifnya, Anda dapat menetapkan yang sudah ada tag ke salah satu jenis sumber daya ini saat membuat sumber daya, dengan menyertakantags> elemen yang mengandung tag yang dimaksud.
Memperbarui Tag
Memperbarui yang sudah ada tag dengan atribut baru dianalogikan dengan membuat a tag:
Membatalkan penetapan Tag
Untuk membatalkan penetapan a tag dari sumber daya, tambahkan atribut nc:operation=”delete” ketag> elemen milik sumber daya. Di bawah, kami membatalkan penetapan a tag dari monitor.
Menghapus Tag
Untuk menghapus tag semuanya dari Pusat Kontrol, atribut nc:operation=”delete” digunakan lagi, namun kali ini diterapkan ke tag itu sendiri, didefinisikan di bawah .
Penyelesaian Masalah
Masalah: Orchestrator dan Paragon Active Assurance Tidak Sinkron
Misalnya, orkestrator dan Paragon Active Assurance bisa menjadi tidak sinkronampfile jika perubahan konfigurasi telah dilakukan di GUI Pusat Kontrol, atau jika penerapan konfigurasi tidak berhasil dan pengembalian ke keadaan sebelumnya gagal.
Jika rollback gagal, server NETCONF tidak akan lagi menerima perubahan konfigurasi; itu akan membalas dengan pesan kesalahan yang menyatakan bahwa konfigurasi dikunci hingga kembali sinkron. Untuk kembali menyinkronkan dan membuka kunci perubahan konfigurasi, Anda perlu menjalankan perintah rpc sync-from-ncc yang menyinkronkan semua konfigurasi dari Pusat Kontrol ke database konfigurasi.
CATATAN: Itu confd@netrounds.com pengguna (atau apa pun yang telah dikonfigurasi) harus memiliki hak pengguna super agar semuanya berhasil disinkronkan. Ini dapat dicapai dengan perintah pembaruan pengguna ncc confd@netrounds.com –is-superuser Jika pengguna bukan pengguna super, akan muncul peringatan yang menyatakan bahwa tidak semuanya dapat disinkronkan, tetapi semua yang dapat ditangani telah dilakukan.
CATATAN: Jika orkestrator Anda juga menyimpan konfigurasi tersebut, Anda juga perlu menyinkronkan ulang konfigurasi tersebut karena konfigurasi yang diminta (konfigurasi yang diharapkan dimiliki Pusat Kontrol oleh orkestrator) tidak akan diterapkan.
Masalah: Sinkronisasi Awal (sinkronisasi dari-ncc) Gagal Karena Sumber Daya Tidak Didukung
Jika Anda mencoba menjalankan rpc sync-from-ncc pada akun yang konfigurasinya dibuat di GUI Pusat Kontrol, Anda mungkin mengalami masalah jika akun tersebut berisi sumber daya yang tidak didukung. Disarankan agar Anda memulai dengan akun kosong dan melakukan semua konfigurasi melalui NETCONF. Jika tidak, jika Anda mengalami masalah konflik sumber daya, Anda harus menghapus sumber daya yang konflik tersebut dari akun.
Masalah: Perintah NETCONF gagal dengan ncclient.operations.rpc.RPCError: kegagalan komunikasi aplikasi
Server NETCONF tidak memulihkan konektivitas ke server Pusat Kontrol secara otomatis jika Pusat Kontrol di-restart. Untuk memulihkan koneksi ke Pusat Kontrol, mulai ulang proses NETCONF: sudo systemctl restart netrounds-confd
Catatan tentang Aplikasi Agen Uji dan Peralatan Agen Uji
Aplikasi Agen Uji di ConfD
Di antara Agen Penguji, Aplikasi Agen Penguji (yang lebih baru) bekerja sedikit berbeda dari Peralatan Agen Penguji (yang lebih lama).
Aplikasi Agen Uji saat ini tidak mendukung konfigurasi antarmuka. Oleh karena itu, skema YANG memungkinkan penentuan konfigurasi antarmuka kosong untuk Agen Uji tersebut. Lihat “bagian ini” di halaman 23 untuk contohnyaampsaya.
Saat menyinkronkan database ConfD dengan Pusat Kontrol menggunakan perintah sync-from-ncc, Anda ingin konfigurasi antarmuka tetap kosong dan tidak ditimpa dengan apa yang ditemukan di Pusat Kontrol. Oleh karena itu Anda perlu menggunakan flag khusus –without_interface_config dengan perintah tersebut ketika bekerja dengan Aplikasi Agen Uji.
Konfigurasi Antarmuka Kosong untuk Peralatan Agen Uji
Seperti disebutkan di atas, Aplikasi Agen Uji tidak mendukung konfigurasi antarmuka, dan oleh karena itu antarmuka dalam skema YANG dapat dihilangkan.
Namun ada juga kasus penggunaan di mana Anda mungkin ingin menghilangkan konfigurasi antarmuka dari Peralatan Agen Uji. Seorang mantanampHal ini dapat berupa skenario orkestrasi di mana Anda menjalankan Agen Uji menggunakan cloud-init, dan Anda ingin konfigurasi antarmuka dari sana digunakan, alih-alih membiarkan ConfD menimpanya saat Agen Uji online.
Perubahan Skema YANG Mengenai Antarmuka Tidak Terdefinisi
Karena konfigurasi antarmuka kosong kini diperbolehkan (mulai dari versi 2.34.0 dan seterusnya), maka dimungkinkan untuk menentukan nama antarmuka apa pun sebagai masukan untuk tugas yang dijalankan sebagai bagian dari pengujian atau monitor.
Ini diperlukan agar dapat menggunakan Aplikasi Agen Uji, karena untuk ini tidak ada nama antarmuka yang ditentukan di ConfD. Namun perlu diperhatikan bahwa ini juga berarti Anda dapat mengalami masalah jika secara tidak sengaja Anda mengonfigurasi pengujian atau monitor untuk menggunakan antarmuka yang tidak ada. Jadi harap perhatikan hal ini.
Batasan Saat Mendaftarkan Agen Tes yang Dibuat di ConfD
Saat membuat Test Agent melalui REST atau NETCONF/YANG API, kita tidak dapat mengetahui sebelumnya jenisnya: Test Agent Appliance atau Test Agent Application. Hal ini menjadi jelas hanya setelah Agen Tes mendaftar.
Setelah Agen Penguji telah didaftarkan dan telah berubah menjadi salah satu jenis Agen Penguji tersebut, Anda tidak diperbolehkan untuk mendaftarkannya kembali sebagai Agen Penguji jenis lain. Artinya Anda tidak diperkenankan untuk terlebih dahulu mendaftarkannya sebagai Alat Agen Penguji, kemudian mendaftar kembali sebagai Aplikasi Agen Penguji, atau sebaliknya. Jika Anda memerlukan Agen Penguji dengan jenis berbeda, Anda perlu membuat Agen Penguji baru.
Lampiran: Struktur Pohon Model YANG Penuh
Dalam lampiran ini, bagian “Legenda” di halaman 81 menjelaskan sintaksis struktur pohon model YANG dihasilkan dengan perintah pyang -f tree.
Bagian “Struktur Pohon Model YANG” di halaman 82 memberikan output dari perintah yang diterapkan ke netrounds-ncc.yang. Sebagian dari keluaran ini direproduksi di tempat lain dalam dokumen.
Legenda
Struktur Pohon Model YANG
Juniper Networks, logo Juniper Networks, Juniper, dan Junos adalah merek dagang terdaftar milik Juniper Networks, Inc. di Amerika Serikat dan negara-negara lain. Semua merek dagang, merek layanan, merek terdaftar, atau merek layanan terdaftar lainnya adalah milik pemiliknya masing-masing. Juniper Networks tidak bertanggung jawab atas ketidakakuratan apa pun dalam dokumen ini. Juniper Networks berhak mengubah, memodifikasi, mentransfer, atau merevisi publikasi ini tanpa pemberitahuan. Hak cipta © 2023 Juniper Networks, Inc. Semua hak dilindungi undang-undang.
Dokumen / Sumber Daya
 |
Perangkat Lunak Juniper NETWORKS NETCONF & YANG API [Bahasa Indonesia:] Panduan Pengguna Perangkat Lunak NETCONF YANG API, Perangkat Lunak YANG API, Perangkat Lunak API, Perangkat Lunak |