Netopper2 安装

环境 centos

1. 基础软件安装

$ sudo yum -y update
$ sudo yum -y upgrade
$ sudo yum -y groupinstall 'Development Tools'
$ sudo yum -y install pcre-devel
$ sudo yum -y install cmake
$ sudo yum -y install doxygen
$ sudo yum -y install valgrind
$ sudo yum -y install zlib-devel
$ sudo yum -y install openssl-devel
$ sudo yum -y install dnssec-trigger
$ sudo yum -y install autoconf libtool
$ sudo yum -y install libev-devel

2. Netopeer2 Requirements

libyang
libnetconf2
sysrepo

2.1 安装 libyang

$ git clone https://github.com/CESNET/libyang.git
$ cd libyang; mkdir build; cd build
$ cmake ..
$ make
$ make test
# make install

Documentation：

可以使用 Doxygen 工具直接从源代码生成库文档:

1 2	$ make doc $ google-chrome ../doc/html/index.html

更改扩展插件目录：

至于 YANG 扩展，libyang 允许加载扩展插件。默认情况下，存储插件的目录是 LIBDIR/libyang。要更改它，使用下面的 cmake 选项，该选项的值指定所需的目录:

1	$ cmake -DPLUGINS_DIR:PATH=`pwd`"/src/extensions/" ..

目录路径也可以通过环境变量文件改变运行时，例如:

1	$ LIBYANG_EXTENSIONS_PLUGINS_DIR=`pwd`/my/relative/path yanglint

yanglint：

Libyang 项目包括一个名为 yanglint (1)的功能丰富的工具，用于验证和转换模式和 YANG 模型数据。源代码位于/tools/lint，可用于探索应用程序如何使用 libyang 库。Yanglint (1)二进制文件及其手册页与库本身一起安装。

There is also README describing some examples of using yanglint.

还有自述文件，描述了使用阳光棉的一些例子。

Libyang 通过插件机制支持 YANG 扩展。一些插件(针对 NACM 或 Metadata)可以开箱即用，并与 libyang 一起安装。但是，如果没有安装 libyang，而是从构建目录中使用 yanglint (1) ，那么这些插件就不可用。有两种选择:

安装 libyang

1	# make install

设置环境变量 LIBYANG_EXTENSIONS_PLUGINS_DIR 包含路径到构建的扩展插件(从构建目录 ./src/extensions )

1	$ LIBYANG_EXTENSIONS_PLUGINS_DIR="`pwd`/src/extensions" ./yanglint

2.2 安装 libnetconf2

依赖：

libyang
libssh

$ git clone http://git.libssh.org/projects/libssh.git
$ cd libssh; mkdir build; cd build
$ cmake ..
$ make
# make install
# or
$ wget https://git.libssh.org/projects/libssh.git/snapshot/libssh-0.7.5.tar.gz
$ tar -xzf libssh-0.7.5.tar.gz
$ mkdir libssh-0.7.5/build && cd libssh-0.7.5/build
$ cmake -DCMAKE_INSTALL_PREFIX:PATH=/usr/local .. && make && sudo make install
$ cd ../..

$ git clone git://git.cryptomilk.org/projects/cmocka.git
$ cd cmocka
$ git checkout tags/cmocka-1.0.1
$ mkdir build; cd build
$ cmake ..
$ make
# make install

$ git clone https://github.com/CESNET/libnetconf2.git
$ mkdir build; cd build
$ cmake ..
$ make
# install
$ make doc

2.3 安装 sysrepo

$ git clone https://github.com/sysrepo/sysrepo.git
$ mkdir build; cd build
$ cmake -DCMAKE_BUILD_TYPE=Debug ..
$ make
# make install
$ make doc
$ google-chrome ../doc/html/index.html

3. netopper2 安装

$ git clone https://github.com/CESNET/Netopeer2.git
$ cd Netopeer2
$ export LD_LIBRARY_PATH=/usr/local/lib64:/usr/local/lib
$ mkdir build && cd build
$ cmake ..
$ make
$ sudo make install

libyang 简介

libyang doc

1. About

libyang is a library implementing processing of the YANG schemas and data modeled by the YANG language. The library is implemented in C for GNU/Linux and provides C API.

Libyang 是一个用 YANG 语言实现 YANG 模式和数据处理的库。该库是用 c 语言为 GNU/Linux 实现的，并提供了 c API。

2. Main Features

YANG 格式模式的解析(和验证)。
YIN 格式模式的解析(和验证)。
解析、验证和打印 XML 格式的实例数据。
解析、验证和打印 JSON 格式的实例数据 (RFC 7951)。
操作实例数据。
支持实例数据中的默认值 (RFC 6243)。
支持 YANG 扩展和用户类型。
支持 YANG 元数据 (RFC 7952)。
yanglint - 特征丰富的 YANG 工具

当前的实现包括 YANG 1.0 (RFC 6020) 和 YANG 1.1 (RFC 7950)。

3. Extra (side-effect) Features

XML 解析器。
优化字符串存储 (字典)。

libnetconf2 简介

1. About

libnetconf2 is a NETCONF library in C handling NETCONF authentication and all NETCONF RPC communication both server and client-side. Note that NETCONF datastore implementation is not a part of this library. The library supports both NETCONF 1.0 (RFC 4741) as well as NETCONF 1.1 (RFC 6241).

libnetconf2 是一个 C 语言的 NETCONF 库，处理 NETCONF 认证和所有 NETCONF RPC 通信服务器和客户端。注意，NETCONF 数据存储实现不是这个库的一部分。这个库同时支持 NETCONF 1.0 (RFC 4741) 和 NETCONF 1.1 (RFC 6241)。

2. Main Features

使用 libssh 创建 SSH (RFC 4742、RFC 6242)，或使用 OpenSSL、经过身份验证的 NETCONF 会话创建 TLS (RFC 7589)。
使用预先建立的传输协议创建 NETCONF 会话(例如，使用这种机制可以通过 sshd(8) 进行隧道通信)。
创建 NETCONF 呼叫家庭会话(RFC 8071)。
创建、发送、接收和回复 RPC (RFC 4741，RFC 6241)。
创建、发送和接收 NETCONF 事件通知(RFC 5277)

libyang 学习总结

YANG 模型

YANG是最初设计用于为NETCONF协议建模的语言。 YANG模块定义了可用于基于NETCONF的操作（包括配置，状态数据，RPC和通知）的数据层次结构。这允许在NETCONF客户端和服务器之间发送的所有数据的完整描述。虽然不在本规范的范围之内，但是也可以使用除NETCONF以外的协议。

YANG将数据的分层组织模型化为一个树，其中每个节点都有一个名称，或者一个值或一组子节点。YANG提供了对节点的清晰简洁的描述，以及这些节点之间的交互。

YANG将数据模型组织成模块和子模块。模块可以从其他外部模块导入定义，并可以包含子模块的定义。可以增加层次结构，允许一个模块将数据节点添加到另一个模块中定义的层次结构中。这种增加可以是有条件的，只有在满足某些条件的情况下才会出现新的节点。

一个模块包含三种类型的语句：

模块头(module header)语句，
“修订”(revision)语句
定义(definition)语句。

模块头部语句描述模块并提供关于模块本身的信息，“修订”语句提供关于模块历史的信息，定义语句是定义数据模型的模块的主体。

数据模型(data model)：

数据模型描述如何表示和访问数据。

数据节点(data node)：

模式树中可以在数据树中实例化的节点。container，leaf，leaf-list，list，anydata和anyxml之一。

数据树(data tree)：

用YANG建模的任何数据的实例化树，例如配置数据，状态数据，组合配置和状态数据，RPC或操作输入，RPC或操作输出或通知。

叶节点(leaf)：

数据树中至多存在一个实例的数据节点。叶子有一个值，但没有子节点。

叶列表(leaf-list)：

与叶节点类似，但定义了一组唯一可识别的节点，而不是单个节点。每个节点都有一个值，但没有子节点。

RPC操作(RPC operation)：

特定的远程过程调用。

模式节点(schema node)：

模式树中的节点。 action，container，leaf，leaf-list，list，choice，case，rpc，input，output，notification，anydata和anyxml中的一个。

模式树(schema tree)：

模块中指定的定义层次结构。

Data Model

叶节点（Leaf Nodes）

“leaf”语句用于在模式树中定义叶节点。它需要一个参数，它是一个标识符，后面是一个包含详细叶子信息的子状态块。一个leaf node包含且只包含一个value，可以是数字或是字符串，具体是什么，看关键字”type”后面跟什么。leaf node下面不能挂子节点。如：

YANG Example:
    leaf host-name {
    	type string;
    	description "Hostname for this system";
    }
-----------------------
NETCONF XML Example:
	<host-name>my.example.com</host-name>

叶列表节点（Leaf-List Nodes）

可以认为Leaf-List Nodes表示的是一个“数组”，“数组”中的元素的值的type必须保持一致，可以有一系列同类型的值，而且不能重复。

YANG Example:
	leaf-list domain-search {
		type string;
		description "List of domain names to search";
	}
-----------------------
NETCONF XML Example:
    <domain-search>high.example.com</domain-search>
    <domain-search>low.example.com</domain-search>
    <domain-search>everywhere.example.com</domain-search>

容器节点（Container Nodes）

一个容器用于分组子树中的相关节点。一个容器只有子节点，没有值。容器可以包含任何类型的任何数量的子节点（叶子，列表，容器，叶子列表，动作和通知）。只能装东西，本身不具有意义。

YANG Example:
    container system {
        container login {
            leaf message {
            	type string;
            	description
            		"Message given at start of login session";
            }
        }
    }
-----------------------
NETCONF XML Example:
    <system>
        <login>
        	<message>Good morning</message>
        </login>
    </system>

列表节点（List Nodes)

列表定义了一系列列表条目。每个条目就像一个容器，如果它定义了任何关键的叶子（指明一个叶子为 key），它就被其关键叶子的值唯一标识。列表可以定义多个关键叶子，并且可以包含任何类型的任何数量的子节点（包括树叶，列表，容器等）。实例化的时候，key的值(也就是”name”的值)是必须不同的，其它的值(full-name/class)没有这个要求。

YANG Example:
    list user {
        key "name";
        leaf name {
        	type string;
        }
        leaf full-name {
        	type string;
        }
        leaf class {
        	type string;
        }
    }
-----------------------
NETCONF XML Example:
    <user>
        <name>glocks</name>
        <full-name>Goldie Locks</full-name>
        <class>intruder</class>
    </user>
    <user>
        <name>snowey</name>
        <full-name>Snow White</full-name>
        <class>free-loader</class>
    </user>
    <user>
        <name>rzell</name>
        <full-name>Rapun Zell</full-name>
        <class>tower</class>
    </user>

Libyang

libyang是一个实现YANG模式处理的library和由YANG语言建模的数据

主要特点：

以 YANG 格式解析（和验证） schema
以 YIN 格式解析（和验证） schema
以 XML 格式解析，验证和打印实例数据
以 JSON 格式解析，验证和打印实例数据
使用实例数据进行操作
支持示例数据中的默认值
支持 YANG 扩展和实例类型
支持 YANG 元数据
XML 解析器
优化的字符串存储（字典）

过程：先创建一个context，解析yang文件生成schema tree（schema tree 相当于类型定义，指定生成的数据类型），然后根据文件读入，生成对应的data tree（相当于实例化的数据）

概念

context（上下文）

上下文概念允许调用者在具有不同 YANG 模式集的环境中工作，具体工作流程（代码过程）见下：

ly_ctx_new()                                    //创建新的上下文
    
/**************设置搜索路径****************/
ly_ctx_set_searchdir()                          //设置搜索路径
ly_ctx_unset_searchdirs()                       //不设置搜索路径
ly_ctx_set_disable_searchdir_cwd()              //设置不在当前工作路径搜索
ly_ctx_set_disable_searchdir()                  //避免在所有上下文的搜索目录搜索
ly_ctx_set_module_imp_clb()                     //设置自定义模块搜索回调
/**************设置搜索路径****************/
    
/**************解析器函数******************/
//使用解析器函数 lys_parse_*（） 将 schema / tree 加入到 context 中
//schema的函数都有lys_的前缀，实例数据的函数有lyd_的前缀。发生于在数据解析时，schema在context中并未找到或者schema只是被导入但并未实现
    
ly_ctx_load_module()                            //在ctx搜索路径中找到model并将其加载到其中 
ly_ctx_set_module_data_clb()                    //设置回调函数
/**************解析器函数******************/
    
//imported的函数可以变成implemented，但是implemented的函数不能变回imported
lys_set_implemented()                           //将imported函数变为implemented
lys_set_allimplemented()                        //将所有imported函数变为implemented

/**************module********************/
ly_ctx_get_module()                             //获得确切的model
ly_ctx_get_submodule()                          //获得确切的submodel
ly_ctx_get_module_iter()                        //对context中所有model进行某操作的迭代
ly_ctx_info()                                   //获取有关context中模式的复杂信息
ly_ctx_find_path()                              //获取上下文中模块中定义的特定节点
ly_ctx_get_node()                               //获取上下文中模块中定义的特定节点
ly_ctx_remove_module()                          //删除context保存的模块
ly_ctx_disable()                                //禁用某模块
ly_ctx_clean()                                  //清除所有已加载model的context
ly_ctx_destroy()                                //删除上下文
/**************module********************/

/*********context dictionary*************/
lydict_insert()                                 //将字符串插入字典
lydict_remove()                                 //将字符串从字典中删除
/*********context dictionary*************/

对于context，第一次请求module的最新版本时，将正确搜索并加载该module。但是，当第二次请求此module（没有修订）时，将返回先前找到的module。这样做的好处是不会反复搜索module，但缺点是如果稍后可以使用module的后续版本，则此context不会使用它。

context 在内部保存所有model及其 submodel

context 包括更有效地存储字符串的字典。大多数字符串在 schema 和 data tree 经常重复。因此，libyang 不会在每次出现时分配这些字符串，而是将它们存储为字典中的记录。

schema（架构）

schema是 YANG 数据模型在 libyang 中的内部表示，每个 schema 都与其 context 连接，并使用解析器函数加载，因此无法以编程方式创建（更改） schema 。在 libyang 中，schema 仅用于访问数据模型定义模式树节点能够保存调用者应用程序使用的私有对象（通过指向结构，函数，变量等的指针）

1	lys_set_private() //将私有对象分配给特定节点

schema 解析器允许从特定格式读取 schema。libyang 支持以下架构格式：YANG，YIN

//以lys_features_为前缀的函数组用于访问和操作模式的功能。
lys_features_list()              //提供特定schema及其子schema中定义的所有功能的列表，或者提供有关所有功能状态的信息
lys_features_state()             //获取一个特定特征的状态
lys_features_(dis)enable()       //启用/禁用特定功能

plugins（插件）

plugins 形式支持扩展和用户类型。无论何时创建上下文，都会从 plugins 目录 LIBDIR/libyang/ 加载它们。扩展 plugins 目录路径（默认 LIBDIR/libyang/extensions/）可以通过LIBYANG_EXTENSIONS_PLUGINS_DIR 环境变量更改，类似地通过用户类型目录（默认LIBDIR/libyang/user_types/）更改 LIBYANG_USER_TYPES_PLUGINS_DIR。请注意，不会删除不可用的plugins，只会加载任何新 plugins。另请注意，新 plugins 的可用性不会影响上下文中的当前 schema，它们仅应用于新解析的 schema。

# 扩展 plugins 目录路径
$ LIBYANG_EXTENSIONS_PLUGINS_DIR=LIBDIR/libyang/extensions/
# 用户类型目录
$ LIBYANG_USER_TYPES_PLUGINS_DIR=LIBDIR/libyang/user_types/

1 2	ly_load_plugins() //手动刷新plugins列表 ly_clean_plugins() //清空plugins列表

Printing Schemas（打印模式）

schema printing 允许以特定格式序列化模式 schema 的内部表示，包括：YING，YANG，Tree

每个节点的模块的简单树结构被打印为：

<status> <flags> <name> <opts> <type> <if-features>
<status>
	+ 对于当前
	x 不推荐使用
	o 过时的
<flags>
	rw 用于配置数据
    ro 用于状态数据
    -x 对于RPC
    -n 通知
<name>
    (<name>) 表示该节点是一个选择节点
    :(<name>) 表示节点是案例节点
    如果节点从另一个模块扩充到树中，则使用模块名称打印<module-name>:<name>
<opts>
    ? 对于可选的叶子或选择
    ! 对于存在容器
    * 对于叶子列表或列表
    [<keys>] 对于列表的键
<type>
    如果定义了默认值，则将其打印在尖括号内 <default-value>
    如果类型是leafref，则类型打印为 - > TARGET`
<if-features>
	是此节点所依赖的功能列表，打印在大括号和问号内 {...}?

数据实例

data tree 中的所有 data 节点都和他们的 schema 节点相连

与 schema 解析器相反，如果根据 libyang 上下文中的 schema，这样的空数据树是有效的，则 data 解析器也接受空输入数据。

在创建/插入节点时，该操作中的所有对象必须属于同一个上下文

创建数据：

根据节点名称或其父节点逐个添加节点
1
2
lyd_new()
lyd_new_leaf()
使用简单的 XPath 寻址
1
lyd_new_path()

sysrepo 简介

1. sysrepo 引言

Sysrepo 是一个基于 yang 的 Unix/Linux 系统数据存储。使用 YANG 建模配置的应用程序可以使用 Sysrepo 进行管理。

申请使用 Sysrepo 的方法主要有两种。直接方法包括在需要配置数据时从应用程序本身调用 Sysrepo 函数，或者执行特定的回调以对配置更改做出反应。还可以实现一个独立的守护进程，将 Sysrepo 调用转换为应用程序特定的操作。对于现有的应用程序，这种间接方法通常比较容易使用，因为这样就不需要修改它们自己来利用 Sysrepo 数据存储，而代价是需要一个额外的中间进程(守护进程)。如果有几个这样的守护进程，它们可以作为插件编写，然后由一个进程管理。

Sysrepo application approaches

Sysrepo 是用于 Unix/Linux 应用程序的基于 yang 的配置和操作状态数据存储。

Sysrepo是一个基于YANG模型的配置和操作数据库，为应用程序提供一致的操作数据的接口，解决了配置读写困难的问题。应用程序使用YANG模型来建模，这样就可以利用YANG模型完成数据合法性的检查，保证的风格的一致，不需要应用程序直接操作配置文件了。

目前，应用程序可以使用 sysrepo Client Library 的 c 语言 API 访问数据存储中的配置，但是对其他编程语言的支持也计划在以后使用(因为 sysrepo 使用 Google 协议缓冲作为数据存储和客户端库之间的接口，为任何支持 GPB 的编程语言编写本地客户端库是可能的)。

Sysrepo 可以很容易地与管理代理(如 NETCONF 或 RESTCONF 服务器)集成，使用应用程序用于访问其配置的相同的客户端库 API。到目前为止，sysrepo 已经与 Netopeer 2 NETCONF 服务器集成。这意味着使用 sysrepo 存储其配置的应用程序可以自动受益于通过 NETCONF 进行控制的能力。

SYSREPO数据库它提供了以下特性:

模型配置文件和状态数据的集中存储
应用程序可以通过XPATH访问配置
支持启动、运行和临时数据存储
支持事务，符合ACID
根据YANG模型，进行数据一致性和约束的检查
没有单一故障点，应用程序不需要运行任何其他进程来访问其配置

sysrepo 实际只是保存配置，并调用回调函数这两件事。

2. 命令行工具

有一些二进制文件是严格可选的，因为它们只使用Sysrepo API。但是，它们对于一些常见任务可能很有用，通过包含它们，每个用户不必从头开始编写它们。

2.1 sysrepo-plugind

这个应用程序是一个简单的守护进程，它将所有可用的 Sysrepo 插件分组到一个单独的进程中。这个守护进程从插件路径目录加载插件，并支持一些选项， --verbosity 和 --debug，以避免进入守护进程模式，并保持将所有消息打印到 stderr。

Plugin 是一个共享对象，它必须公开两个函数: sr_plugin_init_cb() 和 sr_plugin_cleanup_cb()，这两个函数分别在 sysrepo-plugind 的开始和结束时被调用。初始化函数必须执行所有运行时任务，因为守护进程不会调用其他函数。它通常包括创建各种订阅，然后自己处理事件。清理通常会停止这些订阅。

插件路径，这是存储插件的唯一途径。默认路径可以在编译过程中修改(PLUGINS_PATH 选项) ，但是如果设置了 $SRPD_PLUGINS_PATH 环境变量，则总是会覆盖这个默认路径。

2.2 sysrepoctl

它是一个实用工具，可以更改模式(模块)。具体来说，它可以列出、安装、卸载或更新它们。此外，还可以更改模块的特性、重播支持和权限。重要的是要记住哪些操作是立即执行的，哪些操作是延期的(模式中的详细信息)。

-l，–list

所有当前安装的模块都列在一个简明的表格中，其中包含有关它们的基本信息。还有关于任何准备好的更改的信息。

1	$ sysrepoctl --list

-i，–install <path>

YANG 模块的安装只需要指定它们的路径(YANG 或者 YIN 格式)。

1	$ sysrepoctl --install ~/Documents/modules/ietf-interfaces.yang

-u，–uninstall <module>

要删除 YANG 模块，必须指定它的名称(而不是文件名)。所有可以移除的已安装模块都是通过 --list 打印的。

1	$ sysrepoctl --uninstall ietf-interfaces

-c，–change <module>

已安装的模块可以通过多种方式进行更改，可以选择性地组合成一个命令。

1	$ sysrepoctl --change ietf-interfaces --(disable\|enable)-feature

然后，它们的重播支持(存储接收到的通知)可以被打开或关闭。

1	$ sysrepoctl --change ietf-interfaces --replay on

最后，可以调整文件系统权限。

1	$ sysrepoctl --change ietf-interfaces --owner netconf --group netconf --permissions 660

-U，–update <path>

已安装的 YANG 模块可以更新为更新的版本。

1	$ sysrepoctl --update ~/Documents/modules/ietf-netconf@2013-09-29.yang

-C，–connection-count

获取当前连接的客户端的数量。可用于检查是否可以立即应用某些架构更改(如果没有连接)。

1	$ sysrepoctl --connection-count

2.3 sysrepocfg

这个二进制文件允许以多种方式处理配置，比如导入、导出、编辑和替换(从文件或数据存储中复制)。还可以发送 rpc/action 或通知。

所有操作都在 --datastore (默认运行、启动或操作)上执行，或者只在特定的 --module 上执行，并以支持的 --format (默认 xml、 json 或 lyb)处理数据。

-I， –import[=<file-path>]

为了导入配置，通常会提供一个文件。它的格式将根据扩展自动检测。如果不适用(或者从 STDIN 读取数据) ，可以手动确定。

1	$ sysrepocfg --import=~/Documents/data/running.xml

还可以导入模块的启动配置。

1	$ sysrepocfg --import=~/Documents/data/ietf-interfaces_startup.json --datastore startup --module ietf-interfaces

-X，–export[=<file-path>]

可以将导出的配置打印到文件中，也可以直接打印到 STDOUT。

1	$ sysrepocfg --export --datastore operational

此外，只能检索配置的特定部分

1	$ sysrepocfg --export=ietf-interfaces_running.lyb --format lyb --module ietf-interfaces

或者 XPath 选择。

1	$ sysrepocfg --export --xpath /ietf-interfaces:interfaces/interface[name='eth0']

-E，–edit[=<file-path>/<editor>]

可以在文件中或使用任意文本编辑器提供要合并的数据(作为编辑应用)。另外，在更改运行的数据时，可以锁定数据存储。

1 2	$ sysrepocfg --edit=candidate.xml --datastore candidate $ sysrepocfg --edit=vim --lock

-R，–rpc[=<file-path>/<editor>]

也可以从文件或使用编辑器发送 RPC 或操作。任何输出都打印到 STDOUT。

1	$ sysrepocfg --rpc=vim

-N，–notification[=<file-path>/<editor>]

以类似的方式执行发送通知。

1	$ sysrepocfg --notification=notif.xml

-C，–copy-from <file-path>/<source-datastore>

此操作可以用文件或其他数据存储的内容替换模块或数据存储数据。

1 2	$ sysrepocfg --copy-from=ietf-interfaces_startup.xml --module ietf-interfaces --datastore startup $ sysrepocfg --copy-from=candidate

第二个命令实际上是 NETCONF <commit> ，因为它将候选数据存储复制到默认运行的数据存储中。

3. 插件示例

这部分教你如何编写一个简单的 YANG 模块，然后让 Sysrepo 以插件或独立守护程序的形式处理数据。在继续之前，最好至少对 Sysrepo 有一个基本的了解。

3.1 简单的 YANG 模块

对于任何你想用 Sysrepo 管理的设备，你都需要一个设备的 YANG 模块。该语言非常丰富，几乎可以对任何系统进行描述。例如，一个烤箱将完全由 Sysrepo 管理。将介绍 YANG 的所有基本部分，即配置数据、状态数据、 rpc 和通知。

为了简化事情，我们的烤箱是一个便宜的型号，只有一个开关和滑块来设置温度。但是，它可以提供内部实际温度的信息，并且当内部温度达到设定温度时通知厨师。此外，生的食物可以预先准备好，如果有提示，烤箱可以自动将食物放入或取出。这样我们就得到了 YANG 模型:

module oven {
    namespace "urn:sysrepo:oven";
    prefix ov;
    revision 2018-01-19 {
        description "Initial revision.";
    }
    typedef oven-temperature {
        description "Temperature range that is accepted by the oven.";
        type uint8 {
            range "0..250";
        }
    }
    container oven {
        description "Configuration container of the oven.";
        leaf turned-on {
            description "Main switch determining whether the oven is on or off.";
            type boolean;
            default false;
        }
        leaf temperature {
            description "Slider for configuring the desired temperature.";
            type oven-temperature;
            default 0;
        }
    }
    container oven-state {
        description "State data container of the oven.";
        config false;
        leaf temperature {
            description "Actual temperature inside the oven.";
            type oven-temperature;
        }
        leaf food-inside {
            description "Informs whether the food is inside the oven or not.";
            type boolean;
        }
    }
    rpc insert-food {
        description "Operation to order the oven to put the prepared food inside.";
        input {
            leaf time {
                description "Parameter determining when to perform the operation.";
                type enumeration {
                    enum now {
                        description "Put the food in the oven immediately.";
                    }
                    enum on-oven-ready {
                        description
                            "Put the food in once the temperature inside
                             the oven is at least the configured one. If it
                             is already, the behaviour is similar to 'now'.";
                    }
                }
            }
        }
    }
    rpc remove-food {
        description "Operation to order the oven to take the food out.";
    }
    notification oven-ready {
        description
            "Event of the configured temperature matching the actual
             temperature inside the oven. If the configured temperature
             is lower than the actual one, no notification is generated
             when the oven cools down to the configured temperature.";
    }
}

3.2 烤箱插件

这里将一步一步地解释如何写一个合适的插件，将管理烤箱。所有代码片段都取自实际的实现。插件 API

初始化

在初始化函数中，通常必须初始化设备并创建对任何相关 YANG 节点的订阅。

1
2
3

food_inside = 0;
insert_food_on_ready = 0;
oven_temperature = 25;

首先，肯定要通知烤箱其配置参数的任何变化，这样最容易订阅整个模块。设置标志 SR_SUBSCR_ENABLED，以便在 sysrepo-plugind 启动时，独立于烤箱(设备)的状态，将当前存储的配置应用于设备并保持一致性。另一个标志 SR_SUBSCR_DONE_ONLY 被使用，因此不会调用回调来验证任何挂起的更改。对于我们的示例，只要基于 YANG 限制的值有效，它就总是正确的。

还可以订阅任意的配置数据子树，但这个示例不需要这样做。

1 2	rc = sr_module_change_subscribe(session, "oven", oven_config_change_cb, NULL, 0, SR_SUBSCR_ENABLED \| SR_SUBSCR_DONE_ONLY, &subscription);

然后，由于在 oven 模型中还有状态数据，将执行标记该插件为它们的(独占)提供者的订阅。当 Sysrepo 需要状态数据子树时，通常在客户机请求它们时调用它。

值得注意的是，使用了相同的订阅对象，因此必须指定标志 SR_SUBSCR_CTX_REUSE。

1	rc = sr_dp_get_items_subscribe(session, "/oven:oven-state", oven_state_cb, NULL, SR_SUBSCR_CTX_REUSE, &subscription);

最后，该插件还可以处理任何 RPC 调用，这些调用也需要副本。

1
2
3

rc = sr_rpc_subscribe(session, "/oven:insert-food", oven_insert_food_cb, NULL, SR_SUBSCR_CTX_REUSE, &subscription);

rc = sr_rpc_subscribe(session, "/oven:remove-food", oven_remove_food_cb, NULL, SR_SUBSCR_CTX_REUSE, &subscription);

Sysrepo 为插件提供了能够以统一方式打印消息的宏，因此建议使用它们。

1	SRP_LOG_DBGMSG("OVEN: Oven plugin initialized successfully.");

一般格式为 SRP_LOG_(level)(MSG) 。消息的严重性是由 DBG、 VRB、 WRN 或 ERR 之一编写的，而不是(级别)。在示例中，由于没有指定其他变量参数，因此使用了后缀 MSG。如果有，则省略此后缀。参数与 printf ()函数使用的参数相同。

3.3 清除

至于清理，所执行的任务差别很大，并且取决于设备。但是，总是需要适当地终止 init 函数中的订阅，这是本示例中所需的惟一工作。

1	sr_unsubscribe(subscription);

为了简化代码，subscription 被定义为一个全局变量，但是也可以使用 private_data，例如，也可以使用应用程序需要的任何附加数据来存储它。之前分配的所有其他回调都可以在需要时使用相同的机制传递附加数据。

3.4 配置数据

在示例中，它用 oven_config_change_cb() 订阅模块更改。这里看到的代码是实际代码的简化，但是更好地理解回调应该做什么。

static int
oven_config_change_cb(sr_session_ctx_t *session, const char *module_name, sr_notif_event_t event, void *private_ctx)
{
    int rc;
    sr_val_t *val;
    rc = sr_get_item(session, "/oven:oven/temperature", &val);
    if (rc != SR_ERR_OK) {
        goto sr_error;
    }
    //apply the temperature to the device
    sr_free_val(val);
    rc = sr_get_item(session, "/oven:oven/turned-on", &val);
    if (rc != SR_ERR_OK) {
        goto sr_error;
    }
    //apply the switch state to the device
    sr_free_val(val);
    return SR_ERR_OK;
sr_error:
    SRP_LOG_ERR("OVEN: Oven config change callback failed: %s.", sr_strerror(rc));
    return rc;
}

首先，可以观察到，事件变量被忽略。在我们的示例中，无论处理哪个事件，我们都执行相同的操作，由于订阅标志，它将不会是除 SR_EV_DONE 之外的任何事件。

然后，读取并应用所有相关的数据节点。这种方法是最简单的方法，不能总是使用，但在这种情况下可以使用，因为可以重新应用更改而不会产生任何效果。更详细的机制(返回更改)是使用 sr_get_changes_iter() 和提供的会话，从而只获得特定的更改值。

3.5 状态数据

static int
oven_state_cb(sr_session_ctx_t *session, const char *module_name, const char *path, struct lyd_node **parent, void *private_data)
{
    char str[32];
    sprintf(str, "%u", oven_temperature);
    lyd_new_path(*parent, NULL, "/oven:oven-state/temperature", str, 0, 0);
    lyd_new_path(*parent, NULL, "/oven:oven-state/food-inside", food_inside ? "true" : "false", 0, 0);
    return SR_ERR_OK;
}

状态数据回调是自我解释的。由于订阅只针对一个有两片叶子的容器，因此路径只能有一个值。创建相应的子元素。

3.6 RPC 订阅

static int
oven_insert_food_cb(const char *path, const sr_val_t *input, const size_t input_cnt, sr_val_t **output, size_t *output_cnt, void *private_data)
{
    if (food_inside) {
        SRP_LOG_ERRMSG("OVEN: Food already in the oven.");
        return SR_ERR_OPERATION_FAILED;
    }
    if (strcmp(input[0].data.enum_val, "on-oven-ready") == 0) {
        if (insert_food_on_ready) {
            SRP_LOG_ERRMSG("OVEN: Food already waiting for the oven to be ready.");
            return SR_ERR_OPERATION_FAILED;
        }
        insert_food_on_ready = 1;
        return SR_ERR_OK;
    }
    insert_food_on_ready = 0;
    food_inside = 1;
    SRP_LOG_DBGMSG("OVEN: Food put into the oven.");
    return SR_ERR_OK;
}
static int
oven_remove_food_cb(const char *path, const sr_val_t *input, const size_t input_cnt, sr_val_t **output, size_t *output_cnt, void *private_ctx)
{
    if (!food_inside) {
        SRP_LOG_ERRMSG("OVEN: Food not in the oven.");
        return SR_ERR_OPERATION_FAILED;
    }
    food_inside = 0;
    SRP_LOG_DBGMSG("OVEN: Food taken out of the oven.");
    return SR_ERR_OK;
}

RPC 回调应该执行相应的 RPC。移除食物只能做到这一点。但是插入食物有一些定义的输入参数，所以它们需要被处理。同样，如果存在某些输出参数，则需要创建并返回这些参数，但这不是我们的情况。

3.7 Notifications

通知的提供者不需要订阅任何东西，只需在发生通知时生成任何通知即可。

1	rc = sr_event_notif_send(sess, "/oven:oven-ready", NULL, 0);

从这个例子中可以看出，这是相当简单的。此外，如果有通知的任何子节点，则需要创建它们，然后将其传递给函数。

3.8 尝试一下

模型和完整的插件源可以在 sysrepo/examples/plugin 中找到。生成 Sysrepo 后，烤箱共享库存储在示例中，但不会自动安装。在安装和实际运行插件之前，最好仔细阅读源代码。它只是一个很小的文档化的文件，所以它不应该花费很长时间，而且人们应该了解实现的烤箱功能。此外，上面章节中所涉及的大多数信息只是对所有这些机制的基本和详细描述。

在考虑这个特定的插件之前，必须正确构建和安装 Sysrepo。完成之后，您必须首先安装模型，然后安装插件。为了安装模型，可以使用 sysrepoctl。然后，您必须将共享库放入 liboven。进入插件路径。

之后，您应该准备启动 sysrepo-plugind，它将加载插件。如果您启用了调试消息，您应该会看到烤箱插件已成功初始化。

现在您可以自由地使用烤箱配置、rpc和通知了。它应该像YANG模型中描述的那样工作，以及人们期望烤箱如何工作。下面是一个用例：

作为第一步，使用 notif 订阅示例订阅烤箱通知
1
notif_subscribe_example oven
准备好待烤箱温度达到一定温度后放入的食物，稍后再进行配置。烤箱默认是关闭的。在NETCONF术语中，执行插入-食物 RPC。您可以使用 sysrepocfg 实现这一点
1
$ sysrepocfg --rpc=vim
和输入：
1
2
3
<insert-food xmlns="urn:sysrepo:oven">
<time>on-oven-ready</time>
</insert-food>
作为 RPC 内容。您应该会看到一些信息 sysrepo-plugind 输出。

现在你要打开烤箱，期待当它达到设定的温度时得到通知。同时，食物应该在那个时候插入。所以,你执行

1	$ sysrepocfg --edit=vim --datastore running

与内容

<oven xmlns="urn:sysrepo:oven">
    <turned-on>true</turned-on>
    <temperature>200</temperature>
</oven>

在~4秒后，你应该收到通知。您还可以验证是否一切正常
1
$ sysrepocfg --export --xpath /oven:*
食物应该放在烤箱里。
一旦你认为食物烤得恰到好处，就用另一个RPC移走它
1
$ sysrepocfg --rpc=vim
和
1
<remove-food xmlns="urn:sysrepo:oven"/>

3.9 Oven Daemon

如果您希望您的设备有一个独立的守护进程，它将作为独立的进程运行，而不使用 sysrepo-plugind，那么您不需要开发插件。拥有一个独立的守护进程实际上只有上一句中提到的几个区别。

至于代码本身，不需要特定的函数，因为代码将编译为可执行二进制文件而不是共享库。但是，如果要将插件转换为应用程序，没有什么可以阻止重用整个代码。

所需要的只是一个 main() 函数，该函数将在开始处调用 sr_plugin_init_cb() 并在终止之前调用sr_plugin_cleanup_cb()。此外，这些功能需要 Sysrepo 会话。要创建一个，我们首先需要一个连接。因此，使用 sr_connect() 创建连接，如果成功，则使用 sr_session_start() 创建会话。现在，可以通过调用清除函数并释放会话和连接来调用 init 函数并在守护程序终止时正确地进行清理。此外，在编译此类应用程序之前，必须更改打印宏，因为将不再有处理打印消息的主守护程序。完成这些更改后，烤箱守护程序应已准备就绪。

B4860 环境编译 libyang

下载：libyang release

$ tar -zxvf libyang-1.0.184.tar.gz
$ cd libyang-1.0.184
$ mkdir build; cd build
$ cmake -DCMAKE_INSTALL_PREFIX:PATH=`pwd`/4860lib -DCMAKE_BUILD_TYPE:String="Release" ..
$

更改扩展插件目录

对于 YANG 扩展，libyang 允许加载扩展插件。默认情况下，存储插件的目录是 libdir/libyang。要更改它，使用env环境更改

1 2	$ LIBYANG_EXTENSIONS_PLUGINS_DIR=`pwd`/my/relative/path yanglint $ LIBYANG_USER_TYPES_PLUGINS_DIR=`pwd`/my/relative/path yanglint

netopeer2 + sysrepo研究总结

netopeer2 + sysrepo研究总结

sysrepo是干什么的

sysrepo是一个数据库。可以用来保存可读可写的配置，例如 IP,netmask。你可以坐在家里，给远端的设备的sysrepo下修改配置命令。另外远端设备还有一些只读的状态，也可以读回来，例如温度。

sysrepo的订阅功能

订阅实际上就是回调函数。

例如我们的程序告诉sysrepo，我们要订阅 /net/eth0/ip 这个 xml 地址，当有人发消息给 sysrepo，写这个路径时，sysrepo就会告诉我们这个 xml 发生变化了，我们就执行实际的操作。

sysrepo的修改配置

修改配置用写xml路径的方法, 例如写xml路径/net/eth0/ip，那么sysrepo就会把修改的信息写到此路径中，保存到sysrepo的数据库中。

但是sysrepo并没有去做修改ip的实际工作，这个实际工作是怎么完成的呢？sysrepo提供了一个回调函数，我们只要把这个回调函数写好就行。当写xml路径时，sysrepo就会调用回调函数，完成实际的工作。sysrepo实际只是保存配置，并调用回调函数这两件事。

完成一个修改配置的操作，共需要3个程序，一个是发命令的程序，一个收命令的sysrepo，另外我们自己还要写个程序，接收sysrepo发过来的修改配置的路径，我们自己的程序发现是要修改ip的路径，那么就改ip了。

sysrepo返回状态

和 2 类似，我们的程序收到读某个路径的消息，就把数据写到指定路径中就可以

如何下载安装

1	$ git clone https://github.com/sysrepo/sysrepo.git

Sysrepo/Netopeer2 tools and programs:

sysrepoctl
sysrepocfg
sysrepod
sysrepo-plugind
netopeer2-cli
netopeer2-server

基于YANG模型的数据库sysrepo介绍

多数linux的应用程序需要有配置，配置文件的保存和读写通常的实现方式是通过操作文件来完成的。各应用程序都自定配置文件的格式，格式风格存在诸多差异。

SYSREPO数据库它提供了以下特性:

模型配置文件和状态数据的集中存储
应用程序可以通过XPATH访问配置
支持启动、运行和临时数据存储
支持事务，符合ACID
根据YANG模型，进行数据一致性和约束的检查
没有单一故障点，应用程序不需要运行任何其他进程来访问其配置

Sysrepo 常用操作

sysrepo 提供两个独立的，非常实用的程序。方便开发者便捷地使用 sysrepo 来开发与调试自己的应用。

sysrepoctl

sysrepoctl，它用于列出，安装，卸载或更新 sysrepo 模块，也能用于修改一个 sysrepo 模块的特性，权限等。开发过程中经常使用的命令如下

列出全部已经安装在 sysrepo 中的 Yang 模块，并包含模块的基本信息

1	$ sysrepoctl -l, --list

安装指定Yang模型

$ sysrepoctl -i， --install
# 例如
$ sysrepoctl --install /root/ietf-interfaces.yang  # 以默认权限安装ietf-interfaces模型
$ sysrepoctl --install /root/ietf-interfaces.yang --owner=admin:admin --permissions=644   # 为特定admin用户安装可访问权限为644的ietf-interfaces.yang模型

卸载已安装的 Yang 模型

1
2
3

$ sysrepoctl -u, --uninstall 
# 例如
$ sysrepoctl --uninstall ietf-interfaces

修改 Yang 模型，常用的是设置模型支持的特性

1
2
3

$ sysrepoctl -c, --chang
# 例如
$ sysrepoctl --change ietf-interfaces --(disable|enable)-feature if-mib

更新 Yang 模型，如果已安装的 Yang 模型有更新，可以执行该命令

1
2
3

$ sysrepoctl -U, --update
# 例如
$ sysrepoctl --update /root/ietf-netconf@2013-09-29.yang

sysrepocfg

sysrepocfg 是用于 importing，exporting，exporting，replacing 配置到指定的数据库中。命令默认是操作running 库，也支持多种数据格式：json, xml, lyb，除非通过 –format 特定指出，默认的采用 xml 格式。常用的命令如下:

导入一个配置

$ sysrepocfg -I, --import[=]
# 例如
$ sysrepocfg --import=/root/ietf-interfaces.xml   # 将ietf-interfaces配置导入默认running下的ietf-interfaces模块
$ sysrepocfg --import=/root/ietf-interfaces_startup.json --datastore startup --module ietf-interfaces  # 将json格式的ietf-interfaces配置导入startup的ietf-interfaces模块

导出一个配置

1
2
3

$ sysrepocfg -X, --export[=] 
# 例如
$ sysrepocfg --export=ietf-interfaces_running.xml --format xml --module ietf-interfaces 	# 将running库ietf-interfaces 的配置xml的格式导出，并以ietf-interfaces_running.xml名字命令配置文件

编辑或修改配置文件，应用到指定的数据库

$ sysrepocfg -E, --edit[=/]
# 例如
$ sysrepocfg --edit=candidate.xml --datastore candidate   # 如果是修改running库，需要加相应的锁
$ sysrepocfg --edit=vim --lock

发一个RPC请求，RPC返回的结果直接输出于终端

1
2
3

$ sysrepocfg -R, --rpc[=/]
# 例如
$ sysrepocfg --rpc=vim

更多sysrepocfg的使用，请参考sysrepocfg -h。

o-hub netconf 相关开发

$ cp /tmp/o-ran-software-management.so /usr/lib/sysrepo/plugins/

$ sysrepo-plugind -d -v 4

$ netopeer2-server -d -v 3

o-hub software download xml fotmat:

/* sftp://<username>@<host>[:<port>]/path */ 
<software-download xmlns="urn:o-ran:software-management:1.0">
	<remote-file-path>sftp://sftp-admin@192.168.2.76:sysupgrade-BaiHub_1.0.4.bin</remote-file-path> 
	<password>123456</password>
</software-download>

o-hub software install xml fotmat：

<software-install xmlns="urn:o-ran:software-management:1.0">
	<slot-name>system_slot</slot-name>
	<file-names>test_file</file-names>
</software-install>

o-hub software activate xml fotmat：

1
2
3

<software-activate xmlns="urn:o-ran:software-management:1.0">
	<slot-name>system_slot</slot-name>
</software-activate>

B4860 4G HUB 级连口 T14 测量问题查看方式

1) 首先查看级联口是否存在链路闪断或者异常

$ mpi_read 0x2 0x1000 0x20  # 读2次
# 主要看 1002的 bit7~4，如果是4 ，表示是稳定的

$ mpi_read 0x2 0x1070 0x20  # 读2次
# 主要看1078 107a 107c 107e  4个寄存器是否有变化，没变化表示cpri状态ok的

2) 若 1) 状态ok，则开始读取 T14 的值

1 2	$ mpi_read 0x2 0x1040 0x20 # 读2次 # 查看 1040 和 1042 ，这两个值就是 T14 测量的值

3) 若 1) 状态不 ok，则开始读取上联口的 CPRI 状态

$ mpi_read 0x2 0x0000 0x20   # 读2次
# 主要看 1002的 bit7~4，如果是4 ，表示是稳定的

$ mpi_read 0x2 0x0070 0x20   # 读2次
# 主要看1078 107a 107c 107e  4个寄存器是否有变化，没变化表示cpri状态ok的

4) 若3) 读取看到状态不正常，则需要去查看上联口的光纤连接情况。若 3) 看到正常，则需要检测级联端口的连接情况以及下一级 rhub 的情况

B4860 BU TO RU 时延计算

参数说明：

HUB上联口 Toffset = 2 * Cycle ，HUB 级联口 Toffset = 3 * Cycle， HUB下联口 Toffset = 53 * Cycle
RU Toffset = 6 * Cycle
Cycle = 8.013ns

一级HUB BU 到 RU 时延值：

环境：BU –> HUB –> RU

1） BU –> HUB T12

$T12=\left ( T14 - Toffset * Cycle \right ) / 2$

T14 BBU侧测量值，单位ns
Toffset = 2* Cycle （hub上联口 Toffset）

2） TBdelayDL –> HUB上联口到对应 RU接HUB下联口的时延值，单位Cycle

3）HUB –> RU T12_1

${T12}'= \left ( {T14}' - Toffset \right ) / 2 * Cycle$

T14_1 RU 接 HUB 下联口的 T14 测量值，HUB侧测量值，单位Cycle
Toffset = 6 * Cycle （RU Toffset）

4） T2a RU 上报，单位Cycle

下行 BU 到 RU 时延值：

$BBU->RU DL_{Delay} = T12 + TBdelayDL + {T12}' + T2a$

二级HUB BU 到 RU 时延值：

环境：BU –> HUB –> HUB –> RU

1） BU –> HUB T12

$T12=\left ( T14 - Toffset * Cycle \right ) / 2$

T14 BBU侧测量值，单位ns
Toffset = 2 * Cycle （HUB上联口 Toffset）

2） TBdelayDL –> 一级HUB 上联口到一级HUB 级联口时延值，单位Cycle

3） HUB –> HUB T12_1

${T12}'= \left ( {T14}' - Toffset \right ) / 2 * Cycle$

T14_1 一级HUB 级联口到二级 HUB 上联口 T14，单位Cycle
Toffset = 2 * Cycle （二级HUB上联口 Toffset）

4）TBdelayDL_1 –> 二级HUB上联口到对应 RU接二级HUB下联口的时延值，单位Cycle

5）HUB –> RU T12_2

${T12}'' = \left ( {T14}'' - Toffset \right ) / 2 * Cycle$

T14_2 RU 接二级HUB 下联口的 T14 测量值，二级HUB侧测量值，单位Cycle
Toffset = 6 * Cycle （RU Toffset）

6） T2a RU 上报，单位Cycle

下行 BU 到 RU时延值：

$BBU -> RU DL_{Delay} = T12 + TBdelayDL + {T12}' + {TBdelayDL}' + {T12}'' + T2a$

$ snmptrap -v1 -c public 192.168.2.124 .1.3.6.1.4.1.1 192.168.2.125 6 10 100 1.3.6.1.9.9.44.1.2.1 i 12
# 命令 版本 -c 共同体 TrapServerIP Enterprise-OID AgentIP 陷阱类型 oid 时间 被发送参数的OID  数据类型 值

# i  整形 u  无符号型    c  COUNTER32    s  字符串   x  16进制字符串   d  10进制字符串  n  空对象 o  对象ID  t  计时器  a  IP地址 b  比特
# Generic Type包括7种, 分别是:
# 0  coldStart  1  warmStart  2  linkDown  3  linkUp 4  authenticationFailure          5  egpNeighborLoss        6  enterpriseSpecific

Reference

libyang – GitHub

netopeer2 – GitHub

sysrepo – GitHub

libyang – Doc

libnetconf2 – Doc

sysrepo – Doc

XPath 教程 – RUNOOB.COM

XPath教程 – 易百教程

netopeer2 + sysrepo研究总结

sysrepo简单使用

第三章 sysrepo-plugind源码分析