YumaWorks YumaPro yp-snmp YANG Based Unified Modular Automation Tools Manual
Selelekela
Litlaleho tsa Molao
- Copyright 2009 - 2012, Andy Bierman, Litokelo tsohle li sirelelitsoe.
- Copyright 2012 - 2022, YumaWorks, Inc., Litokelo Tsohle Li Sirelelitsoe.
Lisebelisoa tse Eketsehileng
Tokomane ena e nka hore u atlehile ho theha software joalo ka ha ho hlalositsoe tokomaneng e hatisitsoeng: Tataiso ea ho Kenya ea YumaPro
Litokomane tse ling li kenyelletsa:
- YumaPro Quickstart Guide
- Buka ea mosebelisi ea YumaPro
- Buka ea YumaPro netconfd-pro
- YumaPro yangcli-pro Manual
- YumaPro yangdiff-pro Manual
- YumaPro yangdump-pro Manual
- Buka ea YumaPro Developer
- YumaPro API Quickstart Guide
- Tataiso ea YumaPro ypgnmi
- Buka ea YumaPro ypclient-pro
- YumaPro yp-system API Guide
- YumaPro yp-show API Guide
- YumaPro Yocto Linux Quickstart Guide
Ho fumana tšehetso e eketsehileng u ka ikopanya le lefapha la tšehetso ea tekheniki ea YumaWorks: support@yumaworks.com
WEB Libaka
- YumaWorks
- https://www.yumaworks.com
- E fana ka tšehetso, koetliso le boeletsi bakeng sa YumaPro.
- Netconf Central
- http://www.netconfcentral.org/
- Lintlha tsa mahala mabapi le NETCONF le YANG, lithupelo, netefatso ea mojule oa YANG inthaneteng le database ea litokomane
- Yang Central
- http://www.yang-central.org
- Lintlha tsa mahala le lithupelo ho YANG, lisebelisoa tsa mahala tsa YANG bakeng sa ho khoasolla
- NETCONF Sehlopha sa Ts'ebetso sa Wiki Leqephe
- http://trac.tools.ietf.org/wg/netconf/trac/wiki
- Lintlha tsa mahala mabapi le mesebetsi ea maemo a NETCONF le ts'ebetsong ea NETCONF
- Leqephe la Boemo ba NETCONF WG
- http://tools.ietf.org/wg/netconf/
- Boemo ba marang-rang ba IETF bakeng sa litokomane tsa NETCONF
- libsmi Leqephe la Lehae
- http://www.ibr.cs.tu-bs.de/projects/libsmi/
- Lisebelisoa tsa mahala tse kang smidump, ho fetolela SMIv2 ho YANG
Manane a Mengolo
- Sehlopha se sebetsang sa NETCONF
- https://mailarchive.ietf.org/arch/browse/netconf/
- Litaba tsa tekheniki tse amanang le protocol ea NETCONF li tšohloa lethathamong la mangolo la NETCONF WG. Sheba litaelo ho https://www.ietf.org/mailman/listinfo/netconf bakeng sa ho kenela lenane la mangolo.
- Sehlopha sa Ts'ebetso sa NETMOD
- https://datatracker.ietf.org/wg/netmod/documents/
- Litaba tsa tekheniki tse amanang le puo ea YANG le mefuta ea data ea YANG li tšohloa lethathamong la mangolo a NETMOD WG. Sheba litaelo tse ho WEB leqepheng la ho kena lenaneng la mangolo.
Likopano Tse Sebelisitsoeng Tokomaneng ena
Litumellano tse latelang tsa ho fometa li sebelisoa ho pholletsa le tokomane ena:
Likopano tsa Litokomane
Kopano |
Tlhaloso |
–foo | CLI parameter foo |
XML parameter foo | |
foo | taelo ea yangcli-pro kapa parameter |
$FOO | Tikoloho e fapaneng FOO |
$$foo | yangcli-pro global variable foo |
mongolo o itseng | Example taelo kapa PDU |
mongolo o itseng | Mongolo o hlakileng |
|
Litaba tse molemo kapa tse atolositsoeng |
|
Lintlha tsa tlhokomeliso tse bontšang litla-morao tse sa lebelloang |
yp-snmp Tataiso ea mosebelisi
Mehaho ea Mehaho
Selelekela
yp-snmp e nolofaletsa Simple Network Management Protocol (SNMP) ho kenela likhokahano tse ling tsa netconfd-pro Northbound. E etsa sena ka ho hokahanya le laeborari ea Open Source Net-SNMP. Bukana ena ea mosebedisi e hlalosa kamoo mosebetsi oa SNMP o sebelisoang kateng, mokhoa oa ho fetolela li-module tsa MIB ho ea YANG modules, ho li sebelisa, ho li kenya ho seva sa netconfd-pro, ebe u li fihlella ka lisebelisoa tsa bareki ba SNMP (li-agents).
Likaroloana
The yp-snmp moreki o na le likarolo tse latelang:
- Ts'ebetso ea pakete ea SNMP ka har'a seva sa netconfd-pro ka ho kopanya ts'ebetso ea lipakete tsa libnetsnmp ka har'a seva sa netconfd-pro (laeborari ea moemeli).
- Ts'ebetso ea kopo ea SNMP GET
- Ts'ebetso ea kopo ea SNMP GETNEXT
- Ts'ebetso ea kopo ea SNMP GETBULK
- Litsebiso tsa Asynchronous - maraba le litaba
- Tšehetso bakeng sa SNMPv3
- Seva ea netconfd-pro SNMP e tšehetsa feela li-module tsa YANG tse fetotsoeng ho tloha MIB ho sebelisoa sesebelisoa sa smidump.
SNMP SET ha e sebetse.
Ho aha tšehetso ea SNMP
Bakeng sa ho hokahanya Net-SNMP ho netconfd-pro sehlooho sa Net-SNMP files e tlameha ho kenngoa ho sistimi eo u e hahang seva. Hape, ho tsamaisa seva ea netconfd-pro ka tšehetso ea SNMP ka bobeli snmpd le snmptrapd li tlameha ho ba teng. Ho leka ts'ehetso ea SNMP ho ba le lisebelisoa tsa moreki (moemeli) tse fanoeng ke Net-SNMP, joalo ka snmpget, snmpwalk, snmpbulkget, joalo-joalo ho ka ba molemo ho kenya.
Litaelo tse latelang li tla kenya Net-SNMP le lisebelisoa tsa eona tsa bareki. HLOKOMELA: ho na le liparamente tse ngata tsa ho aha NetSNMP, ena ke e 'ngoe ea tsona. Bakeng sa likhetho tse ling ka kopo sheba ho http://www.net-snmp.org/
Qala ka ho khoasolla mofuta oa Net-SNMP oo u lakatsang ho o sebelisa. Litaelo tse latelang li sebelisa net-snmp-5.7.3 joalo ka mohlalaample. Sena se tla kenya li-binary le sehlooho sa .h fileho hlokahala:
Ha u kentse Net-SNMP, u ka haha seva. Sebelisa WITH_SNMP=1 folakha ho haha netconfd-pro ka tšehetso ea SNMP ho tsoa ho khoutu ea mohloli:
Ho leka likarolo tsa bareki ba SNMP, GET, WALK, joalo-joalo, IF-MIB e kenyelelitsoe mme e hahiloe e le Laebrari ea Lisebelisoa tsa Seva (SIL) 'me u tla hloka ho haha le ho kenya IF-MIB SIL. Ho tsoa bukeng ea netconf:
Ho tsamaisa seva ea netconfd-pro u lokela ho e qala ka li-parameter tse ka tlase ho u lumella ho bona melaetsa ea debug joalo ka ex.ampLes li ntse li sebetsa hape li qoba mathata leha e le afe ka litlhophiso tse teng. Taelo ea mojule oa mojaro o jara IF-MIB SIL e hlalositsoeng pejana:
HLOKOMELA: Seva e hloka ho tsamaisoa boemong ba metso kaha e sebelisa likou tse thibetsoeng e le karolo ea maemo a SNMP.
snmpget mohlalaample
Ho matha snmpget khahlano le IF-MIB SIL e kentsoeng:
snmwalk example
Ho matha snmwalk khahlano le IF-MIB SIL e kentsoeng:
snmpbulkget mohlalaample
Ho matha snmpbulkget khahlano le IF-MIB SIL e kentsoeng:
Maraba le Tsebiso
HLOKOMELA: hajoale ke SNMP Traps Version 2 feela e tšehetsoang ke seva.
Ho bonts'a maraba a SNMP etsa bonnete ba hore mohala o latelang o teng ho snmpd.conf file:
Bakeng sa ho bokella le ho bonts'a maraba ts'ebeliso e latelang e ka sebelisoa. Snmptrapd ke sesebelisoa sa SNMP se amohelang le ho boloka melaetsa ea SNMP TRAP le INFORM.
Ho lekola hore na setaele se nepahetse le hore ho fumana litsebiso hoa sebetsa, etsisa ho romela leraba la SNMP ho tsoa sebokeng sa bobeli sa terminal u sebelisa taelo e latelang, e romellang tsebiso ea linkDown:
Ka fensetere ea li-terminal tsa trap u lokela ho bona:
Haeba sena se sebetsa, o ka leka ka netconfd-pro.
Ts'ireletso ea SNMP le SNMP v3
Karolo ena e hlalosa ka bokhutšoanyane likarolo tsa ts'ireletso bakeng sa likopo tsa SNMP ka ho khetheha mabapi le netefatso le tumello. Mochini oa netefatso o hahiloe ho Net-SNMP
- Netefatso ho SNMP Liphetolelo tsa 1 le 2c e fanoa ka password (mohala oa sechaba) e rometsoeng ka mongolo o hlakileng pakeng tsa mookameli le moemeli.
- SNMP v3 e hlalosa bokhoni bo bongata bo amanang le ts'ireletso. Litlhaloso tsa pele li ne li hlalosa USM le VACM, tseo hamorao li ileng tsa lateloa ke mohlala oa tšireletso ea lipalangoang o faneng ka tšehetso bakeng sa SNMPv3 holim'a SSH le SNMPv3 holim'a TLS le DTLS.
Netconfd-pro e sebelisa NACM (NETCONF Access Control Model) ho laola le ho laola phihlello ea lintho tsa YANG tse tšehetsoeng ke sesebelisoa. Kaha NACM e se e ntse e fana ka tumello, VACM e tlameha ho koaloa ha e sebetsana le likopo tsa SNMP v3. Lintlha tse ling mabapi le tlhophiso le taolo ea netefatso ea Net-SNMP li fumaneha marang-rang e le karolo ea litokomane tsa Net-SNMP.
Tlhophiso ea ts'ireletso files
Net-SNMP e sebelisa tlhophiso ea 2 files ho laola ts'ebetso ea eona le tlhaiso-leseling ea taolo e fanoeng.
- /var/net-snmp/snmpd.conf – Sena file e na le tlhophiso e ikhethileng ea SNMP v3 e amanang le mabitso le li-password tse lumelletsoeng.
- /usr/local/share/snmp/snmpd.conf – Sena file e na le tlhaiso-leseling e akaretsang ho kenyeletsoa SNMP v1 le likhoele tse amanang le v2c tsa sechaba tse fanang ka netefatso ea mantlha. Haeba e sa fumanehe tseleng e boletsoeng pele, tlhophiso file e ka fumaneha ho /etc/yumapro/snmpd.conf.
E kenyelletsa mosebelisi oa SNMP v3
Ho kenyelletsa mosebelisi e mocha oa SNMP v3 ho ka etsoa ka ho sebelisa mangolo a fumanehang e le karolo ea Net-SNMP joalo ka tlase. Taelo e ka tlase e eketsa mosebelisi "admin" ka netefatso le lekunutu. Netefatso e sebelisa SHA mme password bakeng sa netefatso ke "password1". Ka mokhoa o ts'oanang bakeng sa boinotši, DES e sebelisoa mme password e amanang le lekunutu ke "password2".
Hlokomela: Seva ea netconfd-pro e tlameha ho emisoa pele o sebelisa taelo e kaholimo. Hang ha taelo e ka holimo e tsamaisoa, netconfd-pro e ka tsamaisoa hape e tla sebelisa tlhophiso ena e ntlafalitsoeng. file.
E kenyelletsa mosebelisi oa SNMP v1/v2c
Joalokaha ho boletsoe pejana, SNMP v1 le v2c li sebelisa likhoele tsa sechaba bakeng sa netefatso. Likhoele tse lumelletsoeng tsa sechaba hammoho le litumello tsa phihlello li hlophisitsoe ho snmpd.conf file. Li-tokens tse laolang liparamente tsena ke "rocommunity" bakeng sa phihlello ya ho bala feela le "rwcommunity" bakeng sa phihlello ya ho bala-ho ngola.
Netconfd-pro Hooks ho Net-SNMP
Seva ea netconfd-pro e lula e mametse ho port 161 le 162 bakeng sa likopo tsa moemeli oa SNMP ha seva se qalisoa ka - with-snmp=nete. Nakong ea nako ea ho qala netconfd-pro e theha lisinki tsa Trap mme e nolofalletsa seva ea netconfd-pro SNMP. Sena se kenyeletsa:
- Sebopeho sa SNMP file parsing
- Ho ngolisa motho ea sebetsang bakeng sa lipakete tsa SNMP tse kenang. Ena ke mohala o ngolisitsoeng bakeng sa lipakete tse kenang
- Ho ngodisa Sebaka sa Aterese ya Tshebeletso ya Netweke (NSAP) le laeborari ya net snmp le ho theha seshene ya boemedi tseleng ya dipalangwang tse fanoeng. Mothating ona netconfd-pro e hokahanya laeborari ea net-snmp mme e ngolisa li-callback tsohle tse hlokahalang tse tla sebelisoa bakeng sa ho tšoara lipakete, popo ea PDU, le tlhahiso ea likarabo.
Ebe seva se qala ho hlahloba hore na ho na le melaetsa ea SNMP e lokelang ho sebetsa. E hlahloba lipakete leha e le life tse tsoang marang-rang. Haeba ho na le lipakete tsa ho sebetsana le seva e bitsa net-snmp API ho e sebetsana.
Bakeng sa likopo tsa SNMP, mohlala, snmpget ho node ea get2, seva e tla etsa tse latelang:
- Hlalosa pakete e kenang (OID; mofuta oa kopo, fumana, getnext, joalo-joalo)
- Rarolla mofuta oa kopo ea ka hare ea SNMP, kopo ho node ea indexed, ho ea pele
- scalar e se nang li-index, joalo-joalo, ho latela mofuta oa kopo, seva e tla fetola qeto ea ntho e lebisitsoeng
- Ebe seva e tla leka ho fumana OID e latelang e ntle ka ho fetisisa ebe e pheta mehato e ts'oanang kapa e tsoele pele ho fumana boleng ba sebele.
- E le hore u fumane bohlokoa ba get2, seva se letsetsa li-callback tsa get2 ho tloha tafoleng ea node e lebisitsoeng - node ea sepheo e tla lula e le lekhasi.
Ho ipapisitsoe le liphetho tsa callback, seva e theha PDU e ncha eo e tla khutla, e beha boleng ba (li)tlalo bakeng sa lenane le kopiloeng la Varbind ho PDU eo, ebe e khutlisetsa pakete eo ho moemeli.
Bakeng sa li-node tsa 'nete le tse hlakileng mehato eohle e ts'oana ntle le hore seva e sa bitse li-callback tsa get2, e fumana Letlapa le batloang sebakeng sa polokelo ea litaba pele, nakong ea ts'ebetso ea tsela ea RESTCONF,' me ka mor'a moo boleng bo molemo ka ho fetisisa bo fumanoa Tafoleng eo.
Yp-snmp - NETCONF le SNMP Litsela tsa Molaetsa
Setšoantšo sa Litsela tsa Melaetsa
Ha li-module tsa MIB tse fetoletsoeng li kenngoa ho seva sa netconfd-pro li-protocol tsa Northbound, tse kang NETCONF, fihlella polokelong ea data ea YANG ka tsela e tloaelehileng, ke hore, ka tsela ea molaetsa e mebala e khubelu setšoantšong se ka holimo. Litsebiso leha e le life li tšoaroa ka tsela e tloaelehileng.
Melaetsa ea SNMP e sebetsoa ke ts'ebetso ea Net-SNMP le seva sa pro netconfd e nang le SIL e fanang ka lisebelisoa, ke hore, tsela ea molaetsa e 'mala o mosehla setšoantšong se kaholimo. Seva e hlahisa SNMP Traps efe kapa efe e hlokahalang.
Ho theha MIB Instrumentation
Ho fetolela mojule oa MIB ho mojule oa YANG le ho eketsa khoutu ea Server Instrumentation Library (SIL) mehato e latelang e lokela ho lateloa. Example ka tlase e sebelisa IF-MIB. Exampmofuta oa IF-MIB SIL o fanoe ka YumaPro SDK.
- Fetolela mojule oa MIB o khethiloeng ho YANG o sebelisa sesebelisoa sa smidump ho tloha: https://www.ibr.cs.tu-bs.de/projects/libsmi/download.html?lang=de
- U lokela ho netefatsa phetoho u sebelisa yangdump-pro. Haeba u batla ho fana ka likarolo tse ling ho yangdump-pro bakeng sa tikoloho ea hau, sheba bukana ea mosebelisi yumapro yangdump-manual.pdf kapa maqephe a motho.
- Kopitsa eang files ho foldara ea hau ea mosebetsi.
- Matha make_sil_dir_pro ho hlahisa khoutu ea mohloli oa lisebelisoa.
- Fetola khoutu ea lisebelisoa ha ho hlokahala. O tla bona tag e reng "kenya xxx khoutu". Mokhoa oa ho fetolela MIB ho YANG o theha smi:oid "xyz" tags mojuleng oa YANG bakeng sa lisebelisoa tsa makhasi. Ke makhasi a nang le smi:oid feela tag e tla bonoa ho tsoa ho moreki oa SNMP. Sheba karolo e latelang ea "SNMP to YANG 'mapa"
- Hang ha u qetile ka khoutu ea lisebelisoa bokella khoutu u sebelisa.
- kenya khoutu u sebelisa.
HLOKOMELA: "DEBUG=1" ke boikhethelo 'me e sebelisoa ho nolofalletsa ho rema lifate.
Sena se tla kenya laeborari e hlahisitsoeng tseleng ea sistimi hore netconfd-pro e jarolloe.
SNMP ho ea YANG 'mapa
Ke lintho tsa YANG feela tse nang le smi:oid "xyz" tags e tla bonahala bakeng sa enjine ea netconfd-pro SNMP. Lintho tse ling kaofela li tla hlokomolohuoa, 'me seva se tla tlaleha hore ha ho na ntho e joalo kapa e tla tlolela nthong e latelang haeba ho ka etsahala snmpgetnext.
YaNG data model e ke ke ea sebelisoa ka botlalo haeba e hloka ho emela mojule oa MIB. Kamora phetoho ea MIB ho YANG, mojule oa YANG o tla ba le mefokolo e mengata mme tse ling tsa likarolo tse tloaelehileng tsa YANG le thepa li tla hlokomolohuoa ke netconfd-pro server kapa esita le ho se sebetse. Lenane le latelang le bontša mefokolo:
- Lenane kapa setshelo se kanna sa se be le nomoro ea OID (smi:oid "xyz" tags), kaha ba kanna ba se be le papiso ho li-module tsa MIB;
- Mehaho e tloaelehileng ea mojule oa YANG e tlameha ho lula e le /setshelo/lethathamo/lekhasi kapa /setshelo/lekhasi haeba ho na le lintho tse hlabang. Ha hoa lokela ho ba le meaho ea sehlaha, meaho ea sehlaha. Leha ho le joalo, seva sa netcond-pro se khona ho sebetsana le meaho e rarahaneng ea sehlaha, e ntse e sa khothaletsoe;
- Khetho, lipolelo tsa linyeoe le li-node tsa makhasi li hlokomolohuoa 'me li ke ke tsa bonahala ho netconfd-pro SNMP seva;
- Haeba ntho e na le polelo ea "theolelo" kapa "boemo" e se hona joale, mohlala: "feela", ntho eo e tla hlokomolohuoa;
- Leafref, augment, uses, joalo-joalo kaofela li lumelloa ho ba teng mojulung o fetotsoeng oa YANG empa li tlameha ho sebetsoa ka hloko.
HLOKOMELA:
Seva ea netconfd-pro SNMP e tšehetsa feela li-module tsa YANG tse fetotsoeng ho tloha MIB ho sebelisoa sesebelisoa sa smidump. Leha ho le joalo, hoa khoneha ho etsa hore module e teng hore e lumellane le seva sa SNMP empa ho ka 'na ha nka boiteko bo bongata' me ho ka 'na ha se ke ha khoneha kaha mohlala oa data o tla tlameha ho fetoloa. Ha e khothalletsoe ho fetolela YANGmodule hore e tsamaisane le SNMP mme mathata a seva ea netconfd-pro a amanang le mojule ona a ke ke a tšehetsoa.
Litokomane / Lisebelisoa
![]() |
YumaWorks YumaPro yp-snmp YANG Based Unified Modular Automation Tools [pdf] Bukana ea Mosebelisi YumaPro yp-snmp, YANG Based Unified Modular Automation Tools, YumaPro yp-snmp YANG Based Unified Modular Automation Tools, Unified Modular Automation Tools, Modular Automation Tools. |