Eines d'automatització modular unificades basades en YumaWorks YANG
Pròleg
Declaracions legals
Copyright 2017-2022, YumaWorks, Inc., Tots els drets reservats.
Recursos addicionals
Altres documents inclouen:
- Guia d'instal·lació de YumaPro
- Guia d'inici ràpid de YumaPro
- Guia d'inici ràpid de l'API YumaPro
- Manual d'usuari de YumaPro
- Manual de YumaPro netconfd-pro
- Manual YumaPro yangcli-pro
- Manual YumaPro yangdiff-pro
- Manual de YumaPro yangdump-pro
- Manual del desenvolupador de YumaPro
- Manual de YumaPro ypclient-pro
- Guia de l'API del sistema yp de YumaPro
- Guia de l'API YumaPro yp-show
- Manual de YumaPro yp-snmp
Per obtenir suport addicional, podeu contactar amb el departament d'assistència tècnica de YumaWorks: support@yumaworks.com
WEB Llocs
- YumaWorks
- https://www.yumaworks.com
- Ofereix suport, formació i consultoria per a YumaPro.
- Netconf Central
- http://www.netconfcentral.org/
- Informació gratuïta sobre NETCONF i YANG, tutorials, validació de mòduls YANG en línia i base de dades de documentació
- Yang Central
- http://www.yang-central.org
- Informació i tutorials gratuïts sobre YANG, eines gratuïtes de YANG per descarregar
- Pàgina Wiki del grup de treball NETCONF
- http://trac.tools.ietf.org/wg/netconf/trac/wiki
- Informació gratuïta sobre activitats d'estandardització de NETCONF i implementacions de NETCONF
- Pàgina d'estat NETCONF WG
- http://tools.ietf.org/wg/netconf/
- Estat d'esborrany d'Internet de l'IETF per als documents NETCONF
- Pàgina d'inici de libsmi
- http://www.ibr.cs.tu-bs.de/projects/libsmi/
- Eines gratuïtes com smidump, per convertir SMIv2 a YANG
Llistes de correu
- Grup de treball NETCONF
- https://mailarchive.ietf.org/arch/browse/netconf/
- Els problemes tècnics relacionats amb el protocol NETCONF es discuteixen a la llista de correu NETCONF WG. Consulteu les instruccions a https://www.ietf.org/mailman/listinfo/netconf per unir-se a la llista de correu.
- Grup de treball NETMOD
- https://datatracker.ietf.org/wg/netmod/documents/
- Els problemes tècnics relacionats amb l'idioma YANG i els tipus de dades YANG es tracten a la llista de correu NETMOD WG. Consulteu les instruccions del WEB pàgina per unir-se a la llista de correu.
Convencions utilitzades en aquest document
Al llarg d'aquest document s'utilitzen les convencions de format següents:
Convencions de documentació
| Convenció | Descripció |
| –fou | Paràmetre CLI foo |
| Paràmetre XML foo | |
| algun text | Exampl'ordre o PDU |
| algun text | Text pla |
Públic destinat
Aquest document està destinat als desenvolupadors de programari que utilitzen l'SDK YumaPro i el servidor multiprotocol en plataformes Linux incrustades personalitzades mitjançant el projecte Yocto i les seves receptes BitBake. Cobreix la configuració i els passos bàsics necessaris per crear el programari. El lector ha d'estar familiaritzat amb el Projecte Yocto.
Introducció
- El sistema de desenvolupament Yocto Linux permet crear variants de Linux personalitzades d'una manera automatitzada i controlada. Pàgina d'inici de Yocto: https://www.yoctoproject.org/
- La informació de temps de creació i d'execució necessària per construir una plataforma Linux sencera per a un sistema incrustat es gestiona com a metadades dins de Yocto.
- Pàgina d'inici OpenEmbedded: https://www.openembedded.org/wiki/Main_Page
- Funcions de Yocto suportades pel servidor YumaPro:
- Ferfiles s'han actualitzat per donar suport totalment a les variables d'entorn bitbake per a l'ús de compiladors creuats
- integració del servidor SSH dropbear
- Integració del servidor SSH openSSH
- integració del sistema deamon
- lighttpd WEB integració del servidor
- integració net-snmp per al suport del protocol SNMP
- base-files integració per a la integració yp-shell i la gestió d'usuaris
Aquesta versió preliminar del paquet YumaPro for Yocto Linux admet la versió 2.3 (Pyro) del sistema de desenvolupament Yocto Linux. La recepta "core-image-minimal" s'utilitza com a base per a la integració del servidor YumaPro.
El servidor YumaPro complet es pot construir per Yocto Linux per proporcionar interfícies de gestió NETCONF, RESTCONF, SNMP i CLI basades en YANG.
La funcionalitat de YumaPro s'especifica en una capa anomenada "meta-yumapro". Hi ha dues variants (anomenades receptes) del servidor compatibles en aquest moment:
- netconfd-pro-iot: servidor per a plataformes IoT, basat en el fitxer tarball d'origen yumapro-core
- netconfd-pro-sdn: servidor per a plataformes SDN, basat en tarball d'origen del servidor yumapro
Aquestes receptes es poden personalitzar segons sigui necessari. S'espera que els paquets específics de suport de la junta (BSP) siguin seleccionats per un proveïdor segons els requisits del projecte. El paquet meta-yumapro conté les receptes i altres dades files per permetre que es creï una imatge de compilació creuada de Yocto. Tots fanfiles s'han actualitzat perquè les variables utilitzades per bitbake siguin compatibles per al correcte desenvolupament de la compilació creuada.
Diferències de receptes IoT vs. SDN
Hi ha dos examples receptes del servidor proporcionades. Aquests es poden utilitzar directament o adaptar-los per utilitzar-los en un entorn de construcció yocto. La taula següent resumeix les diferències entre aquestes receptes.
| Característica | netconfd-pro-iot | netconfd-pro-sdn |
| Servidor SSH per a NETCONF i ypshell | dropbear | obressh |
| WEB Servidor per a RESTCONF | lighttpd | lighttpd |
| Protocol YControl | No s'admet | Admet |
| Protocol DB-API | No s'admet | Admet |
| Protocol SIL-SA | No s'admet | Admet |
| Protocol YP-HA | No s'admet | Admet |
| Construcció estàtica | Admet | No s'admet |
Yocto Build Host Software
- Les eines d'amfitrió de compilació s'han de configurar abans que es pugui construir el servidor.
- La capa yumapro està dissenyada per funcionar amb la versió Yocto 2.3 (Pyro) o posterior.
- Les branques "pyro" i "master" del projecte Poky s'han provat amb la capa meta-yumapro.
- El diagrama següent mostra els directoris que s'espera que l'usuari configure (en blau) i els directoris que afegirà el programari subministrat.
Directori Descripció picant Instal·lació Yocto del sistema de construcció poky construir Arrel de tots els directoris de compilació conf Construeix el directori de configuració. Edita local.conf i bblayers.conf tmp Arrel de tota la compilació generada per bitbake files meta-* Diversos directoris de capa de codi obert meta-yumapro Arrel de la capa yumapro bitbake files servidor de receptes Directori arrel per a totes les receptes del servidor yumapro netconfd-pro Directori arrel de totes les receptes netconfd-pro (IoT i SDN)
Les receptes netconfd-pro-iot i netconfd-pro-sdn estan dissenyades per integrar-se amb certes receptes de codi obert, per tal de produir automàticament una imatge del sistema amb un sistema en execució, al primer arrencada. Les receptes del servidor yumapro utilitzen les següents receptes:
- base-files: S'utilitza per afegir yp-shell a /etc/shells
- dropbear: s'utilitza per integrar el suport netconfd-pro-iot a dropbear i configurar els paràmetres de temps d'arrencada
- openssh: s'utilitza per configurar els paràmetres d'inici de netconfd-pro-sdn a OpenSSH
- lighttpd: s'utilitza per configurar els paràmetres d'inici del servidor RESTCONF per a lighttpd WEB servidor
- net-snmp: s'utilitza per integrar el suport del protocol SNMP i configurar els paràmetres SNMP d'arrencada
Configura Yocto Linux
Aquestes instruccions no anul·len la documentació de Yocto.
Aquest document no és un tutorial de yocto. Consulteu la documentació de Yocto per obtenir més informació sobre com utilitzar el programari Yocto i bitbake.
- Guia d'inici ràpid del projecte Yocto:
https://docs.yoctoproject.org/brief-yoctoprojectqs/index.html - Mega Manual del projecte Yocto:
https://docs.yoctoproject.org/singleindex.html - Manual del desenvolupador de projectes Yocto:
https://docs.yoctoproject.org/dev-manual/index.html - Crea la teva pròpia recepta:
https://wiki.yoctoproject.org/wiki/Building_your_own_recipes_from_first_principles - Manual d'usuari de Bitbake:
https://docs.yoctoproject.org/bitbake/bitbake-user-manual/bitbake-user-manual-intro.html#the-bitbake-command
Instal·leu Yocto
Seguiu les instruccions de la guia d'inici ràpid de Yocto. Exampinstal·lar Ubuntu.
Configura la configuració de la compilació
Començant al directori 'poky', obteniu l'entorn file per habilitar el bitbake. A continuació, aneu al directori "conf" i editeu la configuració files.
Edita local.conf:
- Habilita una plataforma objectiu. El valor predeterminat és l'arquitectura i586 a l'objectiu virtual qemu86. Consulteu la guia d'inici ràpid de Yocto per habilitar diferents objectius i paquets de suport de la placa (BSP).
- Afegiu la recepta del servidor netconfd-pro a la imatge. Trieu netconfd-pro-iot o netconfd-pro-sdn, però no tots dos. Exampfitxer per a netconfd-pro-sdn:
Edita bblayers.conf:
Habiliteu les capes necessàries per crear les variants del sistema Yocto Linux desitjades. El següent example mostra les capes necessàries per a totes les variants del servidor netconfd-pro. El file les ubicacions seran diferents segons la ubicació d'instal·lació de Yocto.
capa meta-yumapro
El tarball meta-yumapro conté la capa "yumapro". filees requereix per construir, instal·lar i integrar un servidor multiprotocol per a Yocto Linux.
Instal·lació
Convencions de nomenclatura Tarball
El fileestructura de noms de la tarball file és el següent:
Extreu al directori poky
El files'han d'extreure al directori poky perquè els subarbres es puguin integrar a l'entorn de construcció del servidor.
Extracció ExampLI:
Configuració
Les úniques receptes admeses en aquest moment són "netconfd-pro-iot" i "netconfd-pro-sdn". La configuració files d'aquestes receptes es troben al directori poky/meta-yumapro/recipes-server/netconfd-pro. Hi ha diverses funcions que es poden activar o desactivar deixant de comentar o comentar un conjunt de directives. El conjunt de receptes files:
- netconfd-pro.inc: recepta comuna file
- netconfd-pro-iot.inc: recepta de configuració d'IoT file
- netconfd-pro-sdn.inc: recepta de configuració de SDN file
- netconfd-pro-iot_17.10.bb: recepta principal de configuració d'IoT file per al tren d'alliberament del 17.10
- netconfd-pro-sdn_17.10.bb: recepta principal de configuració de SDN file per al tren d'alliberament del 17.10
Documents/Recursos
 |
Eines d'automatització modular unificades basades en YumaWorks YANG [pdfGuia de l'usuari Eines d'automatització modulars unificades, basades en YANG, eines d'automatització modulars unificades |
