PYANG工具使用说明

------------------------------------------作者xxxx------------------------------------------日期xxxxPYANG工具使用【精品文档】【精品文档】【精品文档】【精品文档】【精品文档】【精品文档】PYANG工具使用说明内容概览PYANG安装PYANG工具使用结束语概览YANG语言用于定义数据模型，通过文本编辑工具编写YANG模型。YANG模型编写完成后，通过PYang工具能够验证YANG模型文件的正确性，以及YANG模型数据结构的可视性。Pyang工具有以下功能：验证YANG文件的正确性。将YANG模型转换成UML图模型。将YANG模型转换成tree表现形式。PYANG安装安装GitBashGitBash是版本控制命令行工具，用于上传和下载项目代码。官网下载安装包，默认安装即可。安装Python官网下载python任意版本。安装：下载最新安装包。这里以python-3.3.4版本为例。双击‘python-3.3.4.msi’文件进行安装。安装完成后，在系统环境变量PATH中添加‘C:\Python33’；最后打开GitBash命令行，运行python-V确认安装是否成功，安装成功界面如下所示：安装Pyang官网下载pyang安装包，以及setuptools工具包，其中setuptools为安装过程中需要使用，安装步骤如下：解压setuptools-36.0.1.zip到指定目录。打开GitBash命令行，运行到setuptools安装的路径下。GitBash命令行中输入：pythonsetup.pyinstall，即可完成setuptools的安装。解压pyang-pyang-1.7.zip,假设解压到C盘根目录下，如：C:\pyang-pyang-1.7。打开GitBash命令行，运行到pyang安装的路径下。GitBash命令行中输入：GitBash命令行中输入：pythonsetup.pyinstall，即可完成pyang的安装。安装完成后，在系统环境变量PATH中添加‘C:\\bin’。打开另一个GitBash命令行，运行pyang-v确认安装是否成功，安装成功界面如下所示：PYANG工具使用编译YANGtotree由于YANG文件中定义容器类型中会引用或者嵌套其他的容器、grouping类型，通过YANG文件不能完整的看到某个容器类型下是所有数据，然而Tree类型的文件正好解决了这个问。通过PYANG工具，能够将YANG文件转换为tree文件，语法如下：Pyang-ftree-o示例：Tree文件中有很多符号，如：？、[]、*、rw、ro等。每个符号的含义都与YANG模型的定义是一一对应的，这里简单介绍下：*符号表示此属性是list或者leaf-list类型。[]符号中描述的字段，表示是list的key值。rw符号表示此字段是可读可配置的。ro符号表示此字段是可读的，一般为状态属性。？符号表示此字段是可选的。编译YANGtoumlPYANG能够将YANG模型转换为UML文件，并通过plantuml工具将UML文件生成为PNG图。通过PYANG工具，能够将YANG文件转换为tree文件，语法如下：Pyang-fuml-o生成UML文件后，如果需要将UML转换为PNG图，则需要完成以下的操作：官网下载plantuml.jar，并将其放在UML文件所在目录。官网下载下载Graphviz。HYPERLINK"http://blog.csdn.net/tina_ttl/article/details/51778551"\l"%E5%AE%89%E8%A3%85graphviz"安装Graphviz，安装完成后在PATH环境变量中添加：‘C:\ProgramFiles(x86)\Graphviz2.38\bin’；通过plantuml工具，能够将tree文件转换为PNG图，语法如下：java-jarplantuml.jar结合PYANG工具，能够将YANG文件转换为png图：。下面的例子是将HYPERLINK"http://tools.ietf.org/html/rfc6022"ietf-netconf-monitoring.yang转换为PNG图。$$java-jarplantuml.jarietf-netconf-monitoring.uml 会在命令的目录下生成img文件夹，里面存放的就是UML生成的PNG文件。如下脚本可以输出指定目录下所有yang的png。指定目录下必须放置完整YANG文件和。 然后在gitbash命令行中输入：./y2uml.sh[yang文件所在目录]例如：结束语本文对于刚接触SDN的朋友会有所帮助，能够快速了解PYANG工具使用方法。通过tree文件和UML图能够快速理解YANG模型，对开发、测试工作有很大的帮助。