Django-based YANG Extractor and Validator

A web application that allows you to fetch, extract and validate YANG modules by RFC number, by IETF draft name, or by uploading YANG files. It is built on top of the django python web framework using a combination of xym to fetch and extract YANG modules from IETF specifications, and pyang, confdc and yanglint YANG compilers to validate the extracted modules.

Prerequisites

The following requirements will be installed by the pip installation script:

• The django web framework
• The pyang tool
• The xym tool

The following tools will need to be manually preinstalled:

• The yanglint tool needs to be preinstalled
• The confdc compiler needs to be preinstalled, use the --confd-install-path option to point to the ConfD install directory (i.e. $CONFD_DIR)
• The default port is 8080 to avoid requiring root privileges. Use the --port=80 option with root privileges to listen to the default HTTP port.

Building and Deploying Docker Image

The NSO configuration is setup to listen to port 8080 to avoid requiring root to run it, so remember to use portmapping when you start the container:

docker run -p 0.0.0.0:80:8080

Running the Validator in AWS

The current yangvalidator.org instance is running on docker on an AWS EC2 t2.micro instance. The docker image is pushed to a repository in Amazon ECS and then pulled from the EC2 instance.

Remember to set up the appropriate Security Group definition for the EC2 instance if you expect to reach the web server from the outside.