NetConf Quick Start
The NetConf protocol defines a simple mechanism through which a network device can be managed, configuration data information can be retrieved, and new configuration data can be uploaded.
NetConf uses a simple RPC-based mechanism to communicate between a client and a server. The client can be a script or application typically running as part of a network manager. The server is usually a network device.
A NetConf session is the logical connection between a network administrator or network configuration application and a network device. A device must support at least one NetConf session and can support multiple sessions. Global configuration attributes can be changed during any session and the effects are visible in all sessions. The candidate and running and startup configuration are shared across all the sessions.
Note: A detailed list of protocol modules supported through NetConf is in the NetConf command reference.
NetConf Clients
The OcNOS NetConf solution is tested using the
OpenYuma Yangcli and netopeer CLI applications. In this document, the OpenYuma Yangcli application is used to demonstrate NetConf operations.
Refer to the standard Yangcli operations at:
https://github.com/OpenClovis/OpenYuma/blob/master/netconf/doc/yuma_docs/openyuma-yangcli- manual.odt
Check the release notes for the version of OcNOS you are using for where to download the IP Infusion Inc. Yang modules for NetConf clients.
Note: The following points are to be considered while using NetConf get-config and get operations.
• To improve the readability of the output, the subtree filter based sget-config and sget operations are used in this document
• Yangcli's get and get-config operation time out while retrieving large amount of data, To handle this, either increase the timeout option of Yangcli, or use subtree filters used to limit the data.
• A Yangcli operation can end abruptly while fetching large amount of data. This is purely Yangcli's own system resource limitation check. To overcome this, use subtree filters or the simple SSH client.
• Yangcli is not parsing float value correctly when the value range is in between 0 to -1.
SSH client usage is explained in
Chapter 12, SSH Client.
Install Yangcli
2. Apply the patch.
3. Compile and install Open Yuma components. Refer to the
README for more details.
Download Yang files
Check the release notes for the version of OcNOS you are using for where to download the IP Infusion Inc. Yang modules for NetConf clients.
Copy the files to /usr/share/yuma/modules/netconfcentral on the host machine where the client application runs. This system path only works with OpenYuma's Yangcli client application. If you are running a different client application, follow the respective reference document to copy the Yang files to the appropriate location.