cisco IOS XE 17.16.x — How to Configure the NETCONF Protocol

• If the netconf-yang feature candidate-datastore command is removed, the command disables the candidate datastore, enables the running datastore and prints the following warning: netconf-yang and/or restconf is transitioning from candidate to running netconf-yang and/or restconf will now be restarted, and any sessions in progress will be terminated”. • When NETCONF-YANG or RESTCONF are restarted, sessions in progress will be lost. Side-Effect Synchronization of the Configuration Database During configuration changes in the data model interface (DMI), a partial synchronization of the changes that are triggered when a command or RPC is configured happens.

This is called the side-effect synchronization, and it reduces the synchronization time and NETCONF downtime. Prior to the side-effect synchronization, any configuration change used to trigger a time-consuming full synchronization of the configuration database. The side-effect synchronization is enabled by the netconf-yang feature side-effect-sync command. Some commands, when they are configured, triggers changes in some already configured commands. For example, the following is the configuration on a device before the NETCONF edit-config RPC is configured: hostname device123 The NETCONF edit-config RPC:

xmlns="http://cisco.com/ns/yang/Cisco-IOS-XE-native"> xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0" nc:operation="delete"/> The following is the configuration on the device after the NETCONF edit-config RPC is configured: hostname Switch Here, the side-effect of the NETCONF edit-config RPC is a change to the running configuration that is not directly intended by the RPC. The edit-config request is supposed to delete the host name, but instead the hostname is changed back to Switch. The side-effect synchronization does a synchronization of this configuration change to the NETCONF database without synchronizing the entire configuration, thereby improving performance.

The side-effect synchronization is based on the CLI-mode tree concept, where the commands are maintained with modes and submodes structure. This CLI-mode tree data structure consists of three main nodes: • Same-Level Node: This node points to the list of CLI nodes that belongs to the same parent and on the same level. • Parent Node: This node points to the CLI nodes parent, its mode, and submode node. • Child Node: This node points to the child CLI; the CLI under the current mode or submode. If the node has multiple child nodes then those child nodes are linked as part of the same-level node pointers. How to Configure the NETCONF Protocol NETCONF-YANG uses the primary trustpoint of a device.

If a trustpoint does not exist, when NETCONF-YANG is configured, it creates a self-signed trustpoint. For more information, see the Public Key Infrastructure Configuration Guide, Cisco IOS XE Gibraltar 16.10.x . Model-Driven Programmability Side-Effect Synchronization of the Configuration Database Programmability Configuration Guide, Cisco IOS XE 17.16.x 180