YumaPro User Manual

YumaPro User Manual

3.1.7 YANG Files

YANG modules and submodules are text files encoded in UTF-8. . There is also an alternate XML encoding called

YIN. Sometimes the term YANG module is used to refer to the conceptual module, whether it is encoded in YANG format or YIN format.

All YumaPro Tools programs will accept either encoding format, however line and column numbers are not correct in log messages for YIN encoded modules. Instead, each XML node is given a monotonically increasing value, and the

XML document order is used instead of line numbers in error/warning messages for YIN files. The column number is always '1' for YIN files.

A module can be validated and checked for possible programming mistakes, by using the yangdump-pro program.

Many 'reports' can also be generated:

•

• exported symbols (--exports) imported modules (--dependencies)

• object identifiers (--identifiers)

The yangdump-pro program is also used to generate other files, derived from the YANG content:

•

•

•

•

•

•

XML Schema Document (XSD): extends the NETCONF XSD with the YANG content layer definitions (-format=xsd)

HTML <div> or full file output: hyper-linked, color-coded formatting of YANG modules to support netconfcentral or other WEB-based documentation system. There are several options for configuring the output, and all formatting is done with Cascading style-sheets (CSS) (--format=html)

netconf-central documentation SQL database input file: supports the automated online documentation of

YANG content (--format=sqldb). Refer to the netconfcentral.sql file for details on this output, in the Developer

Manual.

server instrumentation code-stubs: the instrumentation callback functions, used in netconfd-pro for activating specific YANG content, can be generated. This procedure is described in more detail in the

Developer Manual.

canonical YANG: a YANG file can be reformatted so all statements are indented uniformly, and always appear in the same order. Objects maked as hidden (see the 'hidden' extension in yuma-ncx.yang) will not be generated. (--format=yang)

copy-YANG-and-set-name: A YANG module can be validated and then copied (if no errors) to another location, adding the revision-date to the file name. (--format=copy)

3.1.8 NETCONF Managers

The NETCONF client is an application that initiates and utilizes NETCONF sessions to control and monitor a

NETCONF server.

YumaPro includes the yangcli-pro application for this purpose. It can be used as a stand-alone tool with any

NETCONF server.

3.1.9 NETCONF Servers

The NETCONF server is a server application that is always running on the managed device. It listens for NETCONF session requests from a NETCONF client, and allows specific users to access specific subsets of the available content (operations, database access, and notifications). It processes all incoming protocol operation requests from the client, and insulates all the instrumentation code from these protocol operations.

YumaPro includes the netconfd-pro application for this purpose. It can be run on several different platforms, or easily adapted to embedded platforms.

Version 15.10-16 Page 23