YumaWorks YANG-Based Unified Modular Automation Tools

Paunang Salita

Mga Pahayag na Ligal
Copyright 2017-2022, YumaWorks, Inc., All Rights Reserved.

Karagdagang Mga Mapagkukunan

Kasama sa iba pang dokumentasyon ang:

• Gabay sa Pag-install ng YumaPro
• Gabay sa Mabilis na Pagsisimula ng YumaPro
• Gabay sa Mabilis na Pagsisimula ng YumaPro API
• YumaPro User Manual
• YumaPro netconfd-pro Manual
• YumaPro yangcli-pro Manual
• YumaPro yangdiff-pro Manual
• YumaPro yangdump-pro Manual
• Manwal ng Developer ng YumaPro
• YumaPro ypcclient-pro Manual
• Gabay sa API ng YumaPro yp-system
• YumaPro yp-show API Guide
• YumaPro yp-snmp Manual
  Upang makakuha ng karagdagang suporta maaari kang makipag-ugnayan sa departamento ng teknikal na suporta ng YumaWorks: support@yumaworks.com

WEB Mga site

• Yumaworks
  • https://www.yumaworks.com
  • Nag-aalok ng suporta, pagsasanay, at pagkonsulta para sa YumaPro.
• Netconf Central
  • http://www.netconfcentral.org/
  • Libreng impormasyon sa NETCONF at YANG, mga tutorial, on-line YANG module validation at database ng dokumentasyon
• Yang Central
  • http://www.yang-central.org
  • Libreng impormasyon at mga tutorial sa YANG, libreng YANG tool para sa pag-download
• Pahina ng Wiki ng NETCONF Working Group
  • http://trac.tools.ietf.org/wg/netconf/trac/wiki
  • Libreng impormasyon sa mga aktibidad sa standardisasyon ng NETCONF at mga pagpapatupad ng NETCONF
• Page ng Katayuan ng NETCONF WG
  • http://tools.ietf.org/wg/netconf/
  • IETF Internet draft status para sa mga dokumento ng NETCONF
• Libsmi Home Page
  • http://www.ibr.cs.tu-bs.de/projects/libsmi/
  • Mga libreng tool tulad ng smidump, para i-convert ang SMIv2 sa YANG

Mga Mailing List

• NETCONF Working Group
  • https://mailarchive.ietf.org/arch/browse/netconf/
  • Ang mga teknikal na isyu na may kaugnayan sa NETCONF protocol ay tinalakay sa NETCONF WG mailing list. Sumangguni sa mga tagubilin sa https://www.ietf.org/mailman/listinfo/netconf para sa pagsali sa mailing list.
• NETMOD Working Group
  •  https://datatracker.ietf.org/wg/netmod/documents/
  • Ang mga teknikal na isyu na nauugnay sa wikang YANG at mga uri ng data ng YANG ay tinatalakay sa listahan ng mailing ng NETMOD WG. Sumangguni sa mga tagubilin sa WEB pahina para sa pagsali sa mailing list.

Mga Kombensiyon na Ginamit sa Dokumentong ito
Ang mga sumusunod na formatting convention ay ginagamit sa buong dokumentong ito:

Mga Kumbensyon sa Dokumentasyon

Convention	Paglalarawan
–foo	Parameter ng CLI foo
	Parameter ng XML foo
ilang text	Example command o PDU
ilang text	Plain text

Sinasadyang Madla
Ang dokumentong ito ay inilaan para sa mga developer ng software na gumagamit ng YumaPro SDK at multi-protocol server sa mga custom na naka-embed na Linux platform sa pamamagitan ng paggamit ng Yocto Project at ang mga BitBake recipe nito. Sinasaklaw nito ang pag-setup at mga pangunahing hakbang na kinakailangan upang mabuo ang software. Dapat na pamilyar ang mambabasa sa Yocto Project.

Panimula

• Ang sistema ng pag-develop ng Yocto Linux ay nagbibigay-daan sa mga custom na variant ng Linux na malikha sa isang awtomatiko, kontroladong paraan. Home Page ng Yocto: https://www.yoctoproject.org/
• Ang build-time at run-time na impormasyon na kailangan para bumuo ng isang buong platform ng Linux para sa isang naka-embed na system ay pinamamahalaan bilang metadata sa loob ng Yocto.
• OpenEmbedded na Home Page: https://www.openembedded.org/wiki/Main_Page
• Mga Tampok ng Yocto na Sinusuportahan ng YumaPro Server:
  • Gawinfiles ay na-update upang ganap na suportahan ang mga variable ng kapaligiran ng bitbake para sa paggamit ng cross-compiler
  • pagsasama ng dropbear SSH server
  • pagsasama ng openSSH SSH server
  • system deamon integration
  • lighttpd WEB pagsasama ng server
  • net-snmp integration para sa SNMP protocol support
  • base-files integration para sa yp-shell integration at pamamahala ng user

Ang paunang bersyon na ito ng YumaPro para sa Yocto Linux package ay sumusuporta sa bersyon 2.3 (Pyro) ng Yocto Linux development system. Ang recipe na "core-image-minimal" ay ginagamit bilang base para sa YumaPro server integration.
Maaaring buuin ang kumpletong server ng YumaPro para sa Yocto Linux upang magbigay ng mga interface ng pamamahala na nakabatay sa YANG NETCONF, RESTCONF, SNMP, at CLI.

Ang YumaPro functionality ay tinukoy sa isang layer na pinangalanang "meta-yumapro". Mayroong dalawang variant (tinatawag na mga recipe) ng server na sinusuportahan sa oras na ito:

• netconfd-pro-iot: Server para sa mga IoT platform, batay sa yumapro-core source tarball
• netconfd-pro-sdn: Server para sa mga platform ng SDN, batay sa yumapro-server source tarball

Ang mga recipe na ito ay maaaring ipasadya kung kinakailangan. Inaasahan na ang mga partikular na board support packages (BSP) ay pipiliin ng isang vendor ayon sa mga kinakailangan ng proyekto. Ang meta-yumapro package ay naglalaman ng mga recipe at iba pang data files upang payagan ang isang Yocto cross-compile na imahe na malikha. Lahat gumawafiles ay na-update upang ang mga variable na ginagamit ng bitbake ay suportado para sa tamang cross-compile development.

Mga Pagkakaiba ng Recipe ng IoT kumpara sa SDN

May dalawang exampAng mga recipe ng server ay ibinigay. Ang mga ito ay maaaring gamitin nang direkta o iniangkop para sa paggamit sa isang yocto build environment. Ang sumusunod na talahanayan ay nagbubuod sa mga pagkakaiba sa pagitan ng mga recipe na ito.

Tampok	netconfd-pro-iot	netconfd-pro-sdn
SSH Server para sa NETCONF at yp- shell	dropbear	openssh
WEB Server para sa RESTCONF	lighttpd	lighttpd
YControl Protocol	Hindi Sinusuportahan	Sinusuportahan
DB-API Protocol	Hindi Sinusuportahan	Sinusuportahan
Protokol ng SIL-SA	Hindi Sinusuportahan	Sinusuportahan
Protokol ng YP-HA	Hindi Sinusuportahan	Sinusuportahan
Static na Pagbuo	Sinusuportahan	Hindi Sinusuportahan

Yocto Build Host Software

• Kailangang i-setup ang build host tool bago mabuo ang server.
• Ang yumapro layer ay idinisenyo upang gumana sa Yocto 2.3 release (Pyro) o mas bago.
• Ang "pyro" at "master" na sangay ng Poky project ay nasubok gamit ang meta-yumapro layer.
• Ipinapakita ng sumusunod na diagram ang mga direktoryo na inaasahang i-setup ng user (sa asul) at ang mga direktoryo na idaragdag ng ibinigay na software.
  

  Direktoryo	Paglalarawan
  masungit	Yocto na pag-install ng poky build system
  magtayo	Root ng lahat ng build directories
  conf	Bumuo ng direktoryo ng pagsasaayos. I-edit ang local.conf at bblayers.conf
  tmp	Root ng lahat ng bitbake na nabuong build files
  meta-*	Maraming opensource layer na direktoryo
  meta-yumapro	Root ng yumapro layer bitbake files
  recipe-server	Root directory para sa lahat ng yumapro server recipe
  netconfd-pro	Root directory ng lahat ng netconfd-pro recipe (IoT at SDN)

   

Ang mga recipe ng netconfd-pro-iot at netconfd-pro-sdn ay idinisenyo upang isama sa ilang mga open source na recipe, upang awtomatikong makagawa ng system image na may tumatakbong system, sa unang boot. Ang mga sumusunod na recipe ay ginagamit ng yumapro server recipes:

• base-files: Ginagamit upang magdagdag ng yp-shell sa /etc/shells
• dropbear: Ginagamit upang isama ang suporta sa netconfd-pro-iot sa dropbear at i-configure ang mga parameter ng oras ng pag-boot
• openssh: Ginagamit upang i-configure ang netconfd-pro-sdn boot-time na mga parameter sa OpenSSH
• lighttpd: Ginagamit upang i-configure ang mga parameter ng boot-time ng server ng RESTCONF para sa lighttpd WEB server
•  net-snmp: Ginagamit upang isama ang suporta sa SNMP protocol at i-configure ang mga parameter ng SNMP ng boot-time

I-setup ang Yocto Linux

Ang mga tagubiling ito ay hindi nag-o-override sa dokumentasyon ng Yocto.
Ang dokumentong ito ay hindi isang yocto tutorial. Sumangguni sa dokumentasyon ng Yocto para sa mga detalye sa paggamit ng software ng Yocto at bitbake.

• Gabay sa Mabilis na Pagsisimula ng Yocto Project:
  https://docs.yoctoproject.org/brief-yoctoprojectqs/index.html
• Yocto Project Mega Manual:
  https://docs.yoctoproject.org/singleindex.html
• Manwal ng Developer ng Yocto Project:
  https://docs.yoctoproject.org/dev-manual/index.html
• Pagbuo ng iyong sariling recipe:
  https://wiki.yoctoproject.org/wiki/Building_your_own_recipes_from_first_principles
• Manwal ng Gumagamit ng Bitbake:
  https://docs.yoctoproject.org/bitbake/bitbake-user-manual/bitbake-user-manual-intro.html#the-bitbake-command

I-install ang Yocto

Sundin ang mga tagubilin sa gabay ng Yocto Quick Start. Halampsa Pag-install ng Ubuntu.

Setup Build Configuration
Simula sa 'poky' na direktoryo, pinagmulan ang kapaligiran file upang paganahin ang bitbake. Pagkatapos ay cd sa "conf" na direktoryo at i-edit ang configuration files.

I-edit ang local.conf:

1. Paganahin ang isang target na platform. Ang default ay ang i586 architecture sa qemu86 virtual na target. Sumangguni sa Yocto Quick start guide para paganahin ang iba't ibang target at board support packages (BSPs).
2. Idagdag ang recipe ng netconfd-pro server sa larawan. Piliin ang alinman sa netconfd-pro-iot o netconfd-pro-sdn, ngunit hindi pareho. Halample para sa netconfd-pro-sdn:

I-edit ang bblayers.conf:

I-enable ang mga layer na kailangan para buuin ang gustong mga variant ng system ng Yocto Linux. Ang sumusunod na exampIpinapakita ng le ang mga layer na kailangan para sa lahat ng variant ng netconfd-pro server. Ang file ang mga lokasyon ay magkakaiba depende sa iyong lokasyon ng pag-install ng Yocto.

meta-yumapro Layer
Ang meta-yumapro tarball ay naglalaman ng "yumapro" na layer fileKinakailangang bumuo, mag-install, at magsama ng multi-protocol server para sa Yocto Linux.

Pag-install

Mga Kumbensyon sa Pagpapangalan ng Tarball
Ang fileistraktura ng pangalan ng tarball file ay ang mga sumusunod:

I-extract sa poky Directory
Ang fileKailangang i-extract ang mga ito sa poky directory para maisama ang mga subtree sa build environment para sa server.
Pagbunot Halample:

Configuration
Ang tanging mga recipe na sinusuportahan sa oras na ito ay "netconfd-pro-iot" at "netconfd-pro-sdn". Ang pagsasaayos files para sa mga recipe na ito ay matatagpuan sa direktoryo na poky/meta-yumapro/recipes-server/netconfd-pro. Mayroong ilang mga tampok na maaaring paganahin o hindi paganahin sa pamamagitan ng pag-uncomment o pagkomento sa isang hanay ng mga direktiba. Ang set ng recipe files:

• netconfd-pro.inc: karaniwang recipe file
• netconfd-pro-iot.inc: recipe ng pagsasaayos ng IoT file
• netconfd-pro-sdn.inc: recipe ng configuration ng SDN file
•  netconfd-pro-iot_17.10.bb: pangunahing recipe ng configuration ng IoT file para sa 17.10 release ng tren
• netconfd-pro-sdn_17.10.bb: Pangunahing recipe ng configuration ng SDN file para sa 17.10 release ng tren

Mga Dokumento / Mga Mapagkukunan

YumaWorks YANG-Based Unified Modular Automation Tools [pdf] Gabay sa Gumagamit YANG-Based, Pinag-isang Modular Automation Tools, Unified Modular, Automation Tools

Mga sanggunian

• User Manual