Quick memo and cheat sheet for Yang Tools for who are looking for screenshots, installation steps, etc.

1. YANG Explorer© Lumina Networks, Inc. 2019. All rights reserved.
Kentaro Ebisawa ｜ Lumina Networks, Inc. Principal Engineer
Memo: YANG Explorer

2. YANG Explorer
Tools: YANG Explorer
© Lumina Networks, Inc. 2019. All rights reserved.

3. YANG Explorer
YANG Explorer
https://github.com/CiscoDevNet/yang-explorer
© Lumina Networks, Inc. 2019. All rights reserved.
Features
• Upload / Compile yang models from User Interface Or Command Line
• Build NetConf RPC
• Generate Python example code [new]
• Search yang xpaths [new]
• Execute RPC against real netconf server
• Save created RPCs to collections for later use
• Build dependency graph for models
• Browse data model tree and inspect yang properties

4. YANG Explorer
YANG Explorer
© Lumina Networks, Inc. 2019. All rights reserved.

5. YANG Explorer
YANG Explorer ... create RPC and Run
© Lumina Networks, Inc. 2019. All rights reserved.
1. Add Value
2. Generate RPC
3. GET (send RPC)

6. YANG Explorer
YANG Explorer ... Generate Python
© Lumina Networks, Inc. 2019. All rights reserved.
if __name__ == '__main__':
parser = ArgumentParser(description='Usage:')
# script arguments
parser.add_argument('-a', '--host', type=str, required=True,
help="Device IP address or Hostname")
parser.add_argument('-u', '--username', type=str, required=True,
help="Device Username (netconf agent username)")
parser.add_argument('-p', '--password', type=str, required=True,
help="Device Password (netconf agent password)")
parser.add_argument('--port', type=int, default=830,
help="Netconf agent port")
args = parser.parse_args()
# connect to netconf agent
with manager.connect(host=args.host,
port=args.port,
username=args.username,
password=args.password,
timeout=90,
hostkey_verify=False,
device_params={'name': 'csr'}) as m:
# execute netconf operation
try:
response = m.get(payload).xml
data = ET.fromstring(response)
except RPCError as e:
data = e._raw
# beautify output
print(ET.tostring(data, pretty_print=True))
"""
Netconf python example by yang-explorer (https://github.com/CiscoDevNet/yang-explorer)
Installing python dependencies:
> pip install lxml ncclient
Running script: (save as example.py)
> python example.py -a 13.113.206.187 -u ebiken -p ebiken --port 830
"""
import lxml.etree as ET
from argparse import ArgumentParser
from ncclient import manager
from ncclient.operations import RPCError
payload = """
<filter xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
<interfaces-state xmlns="urn:ietf:params:xml:ns:yang:ietf-interfaces">
<interface>
<name>GigabitEthernet1</name>
</interface>
</interfaces-state>
</filter>
"""

7. YANG Explorer
YANG Explorer ... Generate YDK
© Lumina Networks, Inc. 2019. All rights reserved.
def netconf_replace(netconf_service, provider, datastore, ydk_obj,
default_operation="replace",
error_option=None, test_option=None):
print('==============¥nNETCONF REPLACE SERVICE¥n==============')
netconf_service.edit_config(provider, datastore, ydk_obj,
default_operation,
error_option, test_option)
def netconf_delete(netconf_service, provider, datastore):
print('==============¥nNETCONF DELETE SERVICE¥n==============')
netconf_service.delete_config(provider, datastore)
def netconf_get(netconf_service, provider, ydk_obj,
with_defaults_option=None):
print('==============¥nNETCONF GET SERVICE¥n==============')
netconf_service.read(provider, ydk_obj, only_config)
def netconf_get_config(netconf_service, provider, datastore, ydk_obj,
with_defaults_option=None):
print('==============¥nNETCONF GET CONFIG SERVICE¥n==============')
netconf_service.get_config(provider, datastore, ydk_obj, with_defaults_option)
if __name__ == "__main__":
_init_logging()
provider = NetconfServiceProvider(address='13.113.206.187',
username='ebiken',
password='ebiken',
protocol='ssh',
port=830)
netconf_service = NetconfService()
ydk_obj = _create_interfaces_state_ydk_object()
netconf_get(netconf_service, provider, ydk_obj)
exit()
#!/usr/bin/env python
# ----------------------------------------------------------------
# Copyright 2016 Cisco Systems
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
# ------------------------------------------------------------------
from __future__ import print_function
from ydk.providers import NetconfServiceProvider
from ydk.services import CRUDService, NetconfService, Datastore
def _create_interfaces_state_ydk_object():
from ydk.models.ietf import ietf_interfaces
from ydk.types import Empty
interfaces_state = ietf_interfaces.InterfacesState()
interface = ietf_interfaces.InterfacesState.Interface()
interface.name = 'GigabitEthernet1'
interfaces_state.interface.append(interface)
return interfaces_state
def _init_logging():
import logging
log = logging.getLogger('ydk')
log.setLevel(logging.DEBUG)
ch = logging.StreamHandler()
log.addHandler(ch)
def netconf_create(netconf_service, provider, datastore, ydk_obj,
default_operation=None,
error_option=None, test_option=None):
print('==============¥NETCONF CREATE SERVICE¥n==============')
netconf_service.edit_config(provider, datastore, ydk_obj,
default_operation,
error_option, test_option)

8. YANG Explorer
YANG Explorer ... create device profile
© Lumina Networks, Inc. 2019. All rights reserved.
Create device profile

9. YANG Explorer
YANG Explorer ... Installation & Setup
© Lumina Networks, Inc. 2019. All rights reserved.
Installation
> Follow https://github.com/CiscoDevNet/yang-explorer/blob/master/README.md
pip install --upgrade pip
sudo apt-get install python-virtualenv
sudo apt-get install graphviz
sudo apt-get install libxml2-dev libxslt1-dev python-dev zlib1g-dev
git clone https://github.com/CiscoDevNet/yang-explorer.git
cd yang-explorer
bash setup.sh
Setup
> Change “start.sh” if accessing from different host
#!/usr/bin/env bash
#HOST='localhost'
HOST='10.0.2.15'
PORT='8088’
Start YANG Explorer
$ ./start.sh
Access UI:
http://localhost:8088/