Sjednocené modulární automatizační nástroje YumaWorks založené na YANG
Předmluva
Právní prohlášení
Copyright 2017-2022, YumaWorks, Inc., Všechna práva vyhrazena.
Další zdroje
Další dokumentace obsahuje:
- Průvodce instalací YumaPro
- Rychlý průvodce YumaPro
- Rychlý průvodce rozhraním YumaPro API
- YumaPro uživatelská příručka
- Příručka YumaPro netconfd-pro
- Manuál YumaPro yangcli-pro
- YumaPro yangdiff-pro manuál
- YumaPro yangdump-pro manuál
- YumaPro Developer manuál
- YumaPro ypclient-pro manuál
- Průvodce API systému YumaPro yp
- Průvodce API YumaPro yp-show
- YumaPro yp-snmp manuál
Chcete-li získat další podporu, můžete kontaktovat oddělení technické podpory YumaWorks: podpora@yumaworks.com
WEB Weby
- YumaWorks
- https://www.yumaworks.com
- Nabízí podporu, školení a poradenství pro YumaPro.
- Netconf Central
- http://www.netconfcentral.org/
- Bezplatné informace o NETCONF a YANG, tutoriály, on-line validace modulu YANG a databáze dokumentace
- Yang Central
- http://www.yang-central.org
- Bezplatné informace a návody na YANG, bezplatné nástroje YANG ke stažení
- Wiki stránka pracovní skupiny NETCONF
- http://trac.tools.ietf.org/wg/netconf/trac/wiki
- Bezplatné informace o aktivitách standardizace NETCONF a implementacích NETCONF
- Stavová stránka NETCONF WG
- http://tools.ietf.org/wg/netconf/
- Stav IETF internetového konceptu pro dokumenty NETCONF
- Domovská stránka libsmi
- http://www.ibr.cs.tu-bs.de/projects/libsmi/
- Bezplatné nástroje, jako je smidump, pro převod SMIv2 na YANG
Seznamy adresátů
- Pracovní skupina NETCONF
- https://mailarchive.ietf.org/arch/browse/netconf/
- Technické problémy související s protokolem NETCONF jsou diskutovány na konferenci NETCONF WG. Viz pokyny na https://www.ietf.org/mailman/listinfo/netconf pro připojení do seznamu adresátů.
- Pracovní skupina NETMOD
- https://datatracker.ietf.org/wg/netmod/documents/
- Technické problémy související s jazykem YANG a datovými typy YANG jsou diskutovány na konferenci NETMOD WG. Viz pokyny na WEB stránku pro připojení k seznamu adresátů.
Konvence použité v tomto dokumentu
V tomto dokumentu se používají následující konvence formátování:
Konvence dokumentace
| Konvence | Popis |
| – foo | Parametr CLI foo |
| XML parametr foo | |
| nějaký text | Example příkaz nebo PDU |
| nějaký text | Prostý text |
Zamýšlené publikum
Tento dokument je určen pro vývojáře softwaru, kteří používají YumaPro SDK a multiprotokolový server na vlastních vestavěných platformách Linux pomocí projektu Yocto a jeho receptů BitBake. Zahrnuje nastavení a základní kroky potřebné k vytvoření softwaru. Čtenář by měl být obeznámen s projektem Yocto.
Zavedení
- Vývojový systém Yocto Linux umožňuje vytvářet vlastní varianty Linuxu automatizovaným a kontrolovaným způsobem. Domovská stránka Yocto: https://www.yoctoproject.org/
- Informace o době sestavení a běhu potřebné k sestavení celé platformy Linux pro vestavěný systém jsou spravovány jako metadata v rámci Yocto.
- Domovská stránka OpenEmbedded: https://www.openembedded.org/wiki/Main_Page
- Funkce Yocto podporované serverem YumaPro:
- Makefiles byly aktualizovány, aby plně podporovaly proměnné prostředí bitbake pro použití napříč kompilátory
- integrace se serverem dropbear SSH
- integrace openSSH SSH serveru
- integrace systémového démona
- lighttpd WEB integrace serveru
- integrace net-snmp pro podporu protokolu SNMP
- základna-files integrace pro integraci yp-shell a správu uživatelů
Tato předběžná verze balíčku YumaPro for Yocto Linux podporuje verzi 2.3 (Pyro) vývojového systému Yocto Linux. Recept „core-image-minimal“ se používá jako základ pro integraci serveru YumaPro.
Kompletní server YumaPro lze sestavit pro Yocto Linux tak, aby poskytoval rozhraní pro správu NETCONF, RESTCONF, SNMP a CLI založená na YANG.
Funkce YumaPro je specifikována ve vrstvě s názvem „meta-yumapro“. V současné době jsou podporovány dvě varianty (nazývané recepty):
- netconfd-pro-iot: Server pro platformy IoT, založený na zdrojovém tarballu jádra yumapro
- netconfd-pro-sdn: Server pro platformy SDN, založený na zdrojovém tarballu yumapro-server
Tyto recepty lze upravit podle potřeby. Očekává se, že konkrétní balíčky podpory desek (BSP) budou vybrány dodavatelem podle požadavků projektu. Balíček meta-yumapro obsahuje recepty a další data files, aby bylo možné vytvořit obraz pro křížovou kompilaci Yocto. Všechny vyrobitfiles byly aktualizovány tak, aby proměnné používané bitbake byly podporovány pro správný vývoj křížové kompilace.
Rozdíly v receptech IoT vs. SDN
Jsou tam dva example receptury serveru poskytnuty. Ty mohou být použity přímo nebo přizpůsobeny pro použití v prostředí sestavení yocto. Následující tabulka shrnuje rozdíly mezi těmito recepty.
| Funkce | netconfd-pro-iot | netconfd-pro-sdn |
| SSH Server pro NETCONF a yp-Shel | dropbear | openssh |
| WEB Server pro RESTCONF | lighttpd | lighttpd |
| YControl Protocol | Není podporováno | Podporováno |
| Protokol DB-API | Není podporováno | Podporováno |
| Protokol SIL-SA | Není podporováno | Podporováno |
| Protokol YP-HA | Není podporováno | Podporováno |
| Statické sestavení | Podporováno | Není podporováno |
Yocto Build Host Software
- Nástroje hostitele sestavení musí být nastaveny před vytvořením serveru.
- Vrstva yumapro je navržena tak, aby fungovala s vydáním Yocto 2.3 (Pyro) nebo novějším.
- Větve „pyro“ a „master“ projektu Poky byly testovány s vrstvou meta-yumapro.
- Následující diagram ukazuje adresáře, které má uživatel nastavit (modře) a adresáře, které dodaný software přidá.
Adresář Popis těsný Instalace systému poky build systému Yocto vytvořit Kořen všech adresářů sestavení conf Sestavení konfiguračního adresáře. Upravte local.conf a bblayers.conf tmp Kořen všech sestav generovaných bitbake files meta-* Několik adresářů vrstvy opensource meta-yumapro Kořen bitbake vrstvy yumapro files recepty-server Kořenový adresář pro všechny receptury serveru yumapro netconfd-pro Kořenový adresář všech receptů netconfd-pro (IoT a SDN)
Recepty netconfd-pro-iot a netconfd-pro-sdn jsou navrženy tak, aby se integrovaly s určitými recepturami s otevřeným zdrojovým kódem, aby se automaticky vytvořil obraz systému s běžícím systémem při prvním spuštění. Recepty serveru yumapro používají následující recepty:
- základna-files: Používá se k přidání yp-shell do /etc/shells
- dropbear: Používá se k integraci podpory netconfd-pro-iot do dropbear a konfiguraci parametrů doby spouštění
- openssh: Používá se ke konfiguraci parametrů doby spouštění netconfd-pro-sdn do OpenSSH
- lighttpd: Používá se ke konfiguraci parametrů doby spouštění serveru RESTCONF pro lighttpd WEB server
- net-snmp: Používá se k integraci podpory protokolu SNMP a konfiguraci parametrů SNMP při spuštění
Nastavit Yocto Linux
Tyto pokyny nemají přednost před dokumentací Yocto.
Tento dokument není yocto tutoriál. Podrobnosti o používání softwaru Yocto a bitbake najdete v dokumentaci Yocto.
- Stručný průvodce projektu Yocto:
https://docs.yoctoproject.org/brief-yoctoprojectqs/index.html - Yocto Project Mega manuál:
https://docs.yoctoproject.org/singleindex.html - Yocto Project Developer Manuál:
https://docs.yoctoproject.org/dev-manual/index.html - Sestavení vlastního receptu:
https://wiki.yoctoproject.org/wiki/Building_your_own_recipes_from_first_principles - Bitbake uživatelská příručka:
https://docs.yoctoproject.org/bitbake/bitbake-user-manual/bitbake-user-manual-intro.html#the-bitbake-command
Nainstalujte Yocto
Postupujte podle pokynů v příručce Yocto Quick Start. Přampnainstalujte Ubuntu.
Nastavení konfigurace sestavení
Začněte v adresáři 'poky' a vytvořte zdroj prostředí file pro aktivaci bitbake. Poté cd do adresáře „conf“ a upravte konfiguraci files.
Upravit local.conf:
- Povolit cílovou platformu. Výchozí je architektura i586 na virtuálním cíli qemu86. Informace o aktivaci různých cílů a balíčků podpory desek (BSP) najdete v příručce pro rychlý start Yocto.
- Přidejte do obrazu recept serveru netconfd-pro. Vyberte buď netconfd-pro-iot nebo netconfd-pro-sdn, ale ne obojí. Přample pro netconfd-pro-sdn:
Upravit bblayers.conf:
Povolte vrstvy potřebné k sestavení požadovaných variant systému Yocto Linux. Následující exampsoubor ukazuje vrstvy potřebné pro všechny varianty serveru netconfd-pro. The file umístění se bude lišit v závislosti na místě instalace Yocto.
meta-yumapro vrstva
Tarball meta-yumapro obsahuje vrstvu „yumapro“. fileje zapotřebí k sestavení, instalaci a integraci víceprotokolového serveru pro Yocto Linux.
Instalace
Tarball jmenovací konvence
The filestruktura názvu tarballu file je následující:
Extrahujte do adresáře poky
The files je třeba extrahovat do adresáře poky, aby bylo možné podstromy integrovat do prostředí sestavení serveru.
Extrakce Přampten:
Konfigurace
V současnosti jsou podporovány pouze recepty „netconfd-pro-iot“ a „netconfd-pro-sdn“. Konfigurace files pro tyto recepty se nacházejí v adresáři poky/meta-yumapro/recipes-server/netconfd-pro. Existuje několik funkcí, které lze povolit nebo zakázat zrušením komentáře nebo okomentováním sady direktiv. Sada receptů files:
- netconfd-pro.inc: společný recept file
- netconfd-pro-iot.inc: Recept na konfiguraci IoT file
- netconfd-pro-sdn.inc: Recept na konfiguraci SDN file
- netconfd-pro-iot_17.10.bb: hlavní recept na konfiguraci IoT file pro 17.10 uvolnění vlaku
- netconfd-pro-sdn_17.10.bb: Hlavní recept na konfiguraci SDN file pro 17.10 uvolnění vlaku
Dokumenty / zdroje
 |
Sjednocené modulární automatizační nástroje YumaWorks založené na YANG [pdfUživatelská příručka Jednotné modulární automatizační nástroje založené na YANG, sjednocené modulární automatizační nástroje |
