[ { "title":"Networking", "url":"/site/networking" }, { "title":"YANG Suite" } ] Docs https://developer.cisco.com/docs/yangsuite/ _blank GitHub https://github.com/CiscoDevNet/yangsuite/ _blank
YANG Suite In Your Network Network automation and programmability capabilities include browsing YANG modules in a graphical interface, creating RPC payload messages to interact with devices, and a gRPC Dial-Out model driven telemetry collector for streaming telemetry. The user-interface is updated with HTML5 and provides flexible deployment options with Docker containers.
Learn and Browse The core component of YANG Suite is an extensible plugin infrastructure used for testing and validating YANG RPCs and payloads. Interact with devices The YANG Suite File Manager works with SCP, Git, NETCONF, or local YANG files. Migration to YANG YANG Suite helps with migration from legacy interfaces to YANG. YANG Suite Core YANG Suite Core's basic features include browse and explore, file management, and device management. NETCONF, gNMI and gRPC Telemetry Interact using NETCONF protocol to network devices using YANG data models and payloads. Receive gRPC Dial-Out Model Driven Telemetry. NETCONF, RESTCONF and gNMI Programmability Interact using the various protocols to network devices using YANG data models and payloads. Datasets and Diffs The YANG Suite Analytics plugin provides easy translation of the various metadata in YANG modules.
https://www.youtube.com/embed/3zmNDfn8b38?rel=0 Get started with YANG Suite Episode 9 of the DevNet Snack Minute video series introduces YANG Suite as long-awaited tooling for YANG API Testing and Validation. YANG Suite is used to construct and test YANG based APIs over NETCONF, RESTCONF, gRPC and gNMI on Cisco IOS XE, IOS XR, and NX-OS platforms. The initial release of YANG Suite includes the base plugins for NETCONF, gRPC Telemetry, and Datasets and Diffs for comparison of YANG between releases and versions.
Download
Documentation
https://www.youtube.com/embed/soyWPr0fJ0s?rel=0 In Episode 58 of the DevNet Snack Minute we review the two additional plugins that were released and are now available: RESTCONF and gNMI. The commonly used "SwaggerUI" is now part of YANG Suite's RESTCONF plugin which enables easy GUI point and click operations for the GET/PUT/POST/etc REST API calls based of the YANG data model and payload. The gNMI plugin has complete GET/SET/Subscribe operations support and is very similar in operations to the well understood "NETCONF" plugin that has been available since the initial release.
https://www.youtube.com/embed/zVsOO9_6rAU?rel=0 In Episode 84 of the DevNet Snack Minute we review the integrations for Ansible into the NETCONF, RESTCONF, and gNMI plugins that enable XML/REST/JSON playbook generation directly from YANG Suite which enables smoother integrations with this popular tool. The 2nd major innovation is within the Coverage plugin regarding the SNMP OID to YANG XPATH transition and migration. This plugins takes both OID's and XPATH's and compares them and displays the actual output from both requests for validation. As always additional resources are shared for finding additional information.
Questions? We are here to help. images/hp-advisory.png https://community.cisco.com/t5/tools/bd-p/j-disc-dev-net-tools _blank YANG Suite Forum Ask, collaborate, and share in the developer forum. images/hp-contactus.png mailto:yangsuite-support-ext@cisco.com YANG Suite Support Mailer Email the YANG Suite team with additional questions. images/hp-wxteamsrooms.png https://eurl.io/#MaW78CelS _blank Cisco Webex Log in to get help right away in the Webex App. images/hp-submit.png https://github.com/CiscoDevNet/yangsuite/issues _blank Submit a Github Issue Share and discuss enhancements in GitHub. How do I reset my YANG Suite password? Start YANG Suite using the interactive configuration mode --create-admin-user How do I change installation setting? Use the interactive configuration mode I just installed a new yangsuite plugin and are having issues so how do I go back to the previous version? irst, refresh your browser because the cache may be hanging on to the previous version, but if that does not fix it, "pip uninstall ", then "pip install == ". Why does NETCONF fail "Check selected device reachability" or "Check Connectivity"? Device variant may be set to wrong device or your device is rejecting the SSH handshake Accessing YANG Suite from my browser, why do I get error: "Invalid HTTP_HOST header: ...You may need to add...to ALLOWED_HOSTS."? Server installation requires "Allow remote access: yes", so reconfigure the YANG Suite server and add host IP address or FQDN Why do I get an error when trying to retrieve Schema list from device even though connection check says NETCONF is OK? Try to retrieve the list directly from the NETCONF page After updating YANG Suite or its plugins, why do pages not display properly, dialogs fail to open, etc.? Refresh your web page or clear your browser history Why do I get SSH certificate or authentication errors trying first connection with new device image? Your certificate is no longer valid. Why are some of the nodes in the NETCONF model tree greyed out? You chose a NETCONF operation that the node supports. What do I do if I forgot my username? Check the contents of your data directory (i.e. yangsuite/data/users/). What do I do if I forgot my password? Run Django command on server to reset it, yangsuite --create-admin-user For my Docker container install, why are my core apps and plugins out of date? Go to Admin→Manage plugins and update everything from there. Every time I restart my docker container, why I have to update the plugins again? You could use docker-compose and build your own container rather than using the one at docker.cisco.com For my docker container install, how can I change install parameters such as port number or allowed hosts? You can use all the available docker or docker-compose commands to enter the container and execute commands just as if you had YANG Suite installed locally. How do I test notifications using YANG Suite? In the NETCONF page, click on the in the upper right-hand corner of the page and click on the "Working with NETCONF notifications". Does YANG Suite work with an SSH jumphost? Yes. On the box YANG Suite is installed on, setup an SSH link to the jumphost, and a device profile to localhost using the linked port. Device connectivity errors out on NETCONF connection with access-denied? Check if you have "privilege 15" configured for the username on the device." Working with certificates is confusing and why do different Cisco OS have different setup? Really boils down to 3 different openssl keys linked together through the creation of a root certificate and client certificate. Does YANG Suit support Python or Ansible playbook integrations ? Yes, each plugin NETCONF, RESTCONF, and gNMI can save RPC payloads to either a Python file or Ansible YAML playbook How can I install YANG Suite? You can install YANG Suite using either the docker container or PIP install. See the GitHub README.md for further installation details