Uživatelská příručka YumaWorks YumaPro Yocto Linux

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.

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.
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

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)

Receptury 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
drop bear: 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.

1a) nainstalovat závislosti
> sudo apt-get install gawk wget git-core diffstat rozbalte texinfo gcc-multilib \ build-essential chrpath socat cpio python python3 python3-pip python3-pexpect \ xz-utils debianutils iputils-ping-libsdl1.2.
1b) Nainstalujte poky
> git klon git://git.yoctoproject.org/poky
> cd poky [Mělo by být na větvi 'master']
1c) přidat meta-webserver
> git klon git://git.openembedded.org/meta-openembedded

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.

> zdroj oe-init-build-env
build> cd conf
build/conf> .

Upravit local.conf:

Povolit cílovou platformu. Výchozí je architektura i586 na virtuálním cíli qemu86. Viz Yocto
Rychlý průvodce pro aktivaci různých cílů a balíčků podpory desek (BSP).
Přidejte do obrazu recept serveru netconfd-pro. Vyberte buď netconfd-pro-iot nebo netconfd-pro-sdn, ale ne
oba. Přample pro netconfd-pro-sdn:

IMAGE_INSTALL_append = ”netconfd-pro-sdn”
POZNÁMKA: Počínaje vydáním Hardknott(3.3) OpenEmbedded používá bitbake nový
syntaxe přepisu proměnné. Pro Hardknott a novější verze, server netconfd-pro
recept by měl být přidán takto: IMAGE_INSTALL:append = ”netconfd-pro-sdn”

Upravit bblayers.conf:

Povolte vrstvy potřebné k sestavení požadovaných variant systému Yocto Linux. Následující example ukazuje vrstvy
potřebné pro všechny varianty serveru netconfd-pro. The file umístění se bude lišit v závislosti na vašem Yocto
místo instalace.

BBLAYERS ?= ” \

/home/andy/swdev/poky/meta \
/home/andy/swdev/poky/meta-poky \
/home/andy/swdev/poky/meta-yocto-bsp \
/home/andy/swdev/poky/meta-openembedded/meta-oe \
/home/andy/swdev/poky/meta-openembedded/meta-python \
/home/andy/swdev/poky/meta-openembedded/meta-networking \
/home/andy/swdev/poky/meta-openembedded/meta-webserver \
/home/andy/swdev/poky/meta-yumapro \

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í:

meta-yumapro-version.gz
Example Filejméno:
meta-yumapro-20.10-11.tar.gz

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:

> cd poky
> tar xvf meta-yumapro-20.10-11.tar.gz
Vytvoří adresář s názvem meta-yumapro v aktuálním adresáři.

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

YumaWorks YumaPro Yocto Linux [pdfUživatelská příručka
Yuma Pro Yocto Linux, Yocto Linux, Linux, Yuma Yocto Linux

Reference

Uživatelská příručka

YumaWorks YumaPro Yocto Linux

Předmluva