PYANG工具使用说明

PYANG工具使用说明

内容

? ? ? ? ?

概览

PYANG安装 PYANG工具使用 结束语

1. 概览

YANG语言用于定义数据模型，通过文本编辑工具编写YANG模型。YANG模型编写完成后，通过PYang工具能够验证YANG模型文件的正确性，以及YANG模型数据结构的可视性。

Pyang工具有以下功能： 1、验证YANG文件的正确性。 2、将YANG模型转换成UML图模型。 3、将YANG模型转换成tree表现形式。

2.

PYANG安装

2.1. 安装Git Bash

Git Bash是版本控制命令行工具，用于上传和下载项目代码。官网下载安装包，默认安装即可。

2.2. 安装Python

官网下载python任意版本。安装步骤：

1、下载最新安装包。这里以python-3.3.4 版本为例。 2、双击‘python-3.3.4.msi ’文件进行安装。

3、安装完成后，在系统环境变量PATH中添加‘C:\\Python33’；

4、最后打开Git Bash命令行，运行python -V确认安装是否成功，安装成功界面如下所示：

2.3. 安装Pyang

官网下载pyang安装包，以及setuptools工具包，其中setuptools为安装过程中需要使用，安装步骤如下：

1、解压setuptools-36.0.1.zip到指定目录。

2、打开Git Bash命令行，运行到setuptools安装的路径下。

3、Git Bash命令行中输入：python setup.py install，即可完成setuptools的安装。 4、解压pyang-pyang-1.7.zip,假设解压到C盘根目录下，如：C:\\pyang-pyang-1.7。 5、打开Git Bash命令行，运行到pyang安装的路径下。 6、Git Bash命令行中输入：source ./env.sh

7、Git Bash命令行中输入：python setup.py install，即可完成pyang的安装。 8、安装完成后，在系统环境变量PATH中添加‘C:\\pyang-pyang-1.7\\bin’。

9、打开另一个Git Bash命令行，运行pyang -v确认安装是否成功，安装成功界面如下所示：

3. PYANG工具使用

3.1. 编译YANG to tree

由于YANG文件中定义容器类型中会引用或者嵌套其他的容器、grouping类型，通过YANG文件不能完整的看到某个容器类型下是所有数据，然而Tree类型的文件正好解决了这个问题。

通过PYANG工具，能够将YANG文件转换为tree文件，语法如下：

Pyang -f tree -o 示例：

Tree文件中有很多符号，如：？、[]、*、rw、ro等。每个符号的含义都与YANG模型的定义是一一对应的，这里简单介绍下：

1、*符号表示此属性是list或者leaf-list类型。 2、[]符号中描述的字段，表示是list的key值。 3、rw符号表示此字段是可读可配置的。

4、ro符号表示此字段是可读的，一般为状态属性。 5、？符号表示此字段是可选的。

3.2. 编译YANG to uml

PYANG能够将YANG模型转换为UML文件，并通过plantuml工具将UML文件生成为PNG图。

通过PYANG工具，能够将YANG文件转换为tree文件，语法如下：

Pyang -f uml -o

生成UML文件后，如果需要将UML转换为PNG图，则需要完成以下的操作：

1、官网下载plantuml.jar，并将其放在UML文件所在目录。

2、官网下载下载Graphviz。安装Graphviz，安装完成后在PATH环境变量中添加：‘C:\\Program Files (x86)\\Graphviz2.38\\bin’；

3、通过plantuml工具，能够将tree文件转换为PNG图，语法如下：

java -jar plantuml.jar

4、结合PYANG工具，能够将YANG文件转换为png图：。 下面的例子是将ietf-netconf-monitoring.yang转换为PNG图。

$ pyang -f uml ietf-netconf-monitoring.yang -o ietf-netconf-monitoring.uml $ java -jar plantuml.jar ietf-netconf-monitoring.uml

会在命令的目录下生成img文件夹，里面存放的就是UML生成的PNG文件。

5、如下脚本可以输出指定目录下所有yang的png。指定目录下必须放置完整YANG

文件和plantuml.jar。

y2uml.sh

然后在git bash命令行中输入： ./y2uml.sh [yang文件所在目录] 例如：

4. 结束语

本文对于刚接触SDN的朋友会有所帮助，能够快速了解PYANG工具使用方法。通过tree文件和UML图能够快速理解YANG模型，对开发、测试工作有很大的帮助。

本文来源：https://www.bwwdw.com/article/4ec3.html