NETCONF¶
Overview¶
The NETCONF projects hosts multiple components relating to IETF’s NETCONF Working Group:
Northbound and southbound plugins for NETCONF protocol, as described in RFC-6241
Northbound plugin for RESTCONF protocol, as described in RFC-8040
Northnound plugin for descring RESTCONF endpoint in terms of OpenAPI 3.0
Behavior/Feature Changes¶
The odl-restconf-nb-rfc8040 feature has been renamed to odl-restconf-nb.
New Features¶
Support for subscribing to mounted NETCONF devices has been added. See NETCONF-745 for details.
A new RESTCONF query extension has been added. This supports reporting only leaf values which have actually changed. See NETCONF-862 for details.
Deprecated and Removed Features¶
RPC definitions in netconf-node-topology.yang have been deprecated. Their functionality is completely covered
by manipulating the configuration datastore.
Resolved Issues¶
The following table lists the issues resolved in this release.
Type |
Key |
Summary |
Resolution |
Fix Version(s) |
|---|---|---|---|---|
Duplicate yang-ext:mount in error message |
Done |
3.0.9, 4.0.5, 5.0.0 |
||
Fail to generate <discard-changes> RPC |
Done |
3.0.9, 4.0.5, 5.0.0 |
||
‘commit’ sent to devices without ‘candidate’ capability |
Done |
3.0.9, 4.0.5, 5.0.0 |
||
Netconf testtool fails to find credentials node in SchemaTree |
Done |
5.0.0 |
||
Error writing values with XML YANG Patch |
Done |
5.0.1 |
||
Netconf callhome failed for devices with old KEX algorithms (SHA1) |
Done |
3.0.9, 4.0.6, 5.0.2 |
||
Callhome session is closed after allowing device to connect |
Done |
5.0.1 |
||
Fix odl-yanglib feature usage |
Done |
3.0.9, 4.0.6, 5.0.2 |
||
Unable to load org.eclipse.jetty.websocket.server.WebSocketServerFactory |
Done |
4.0.6, 5.0.3 |
||
Websocket timeout exception |
Done |
4.0.6, 5.0.3 |
||
yanglib does not support RFC6020 media types |
Done |
3.0.9, 4.0.6, 5.0.4 |
||
Unable execute YANG patch request when targeting augmented element |
Done |
3.0.9, 4.0.6, 5.0.3 |
||
OpenAPI: Schemas are not shown |
Done |
3.0.9, 4.0.6, 5.0.4 |
||
Do not touch configuration datastore during netconf-topology init |
Done |
5.0.0 |
||
Separate out LockChangeListener from NetconfDeviceSalFacade |
Done |
5.0.0 |
||
Move NetconfDeviceTopologyAdapter to netconf.topology.spi |
Done |
5.0.0 |
||
RemoteDeviceId should capture only MD-SAL preference |
Done |
5.0.0 |
||
Add descriptions to web contexts |
Done |
5.0.0 |
||
Netconf candidate capability non RFC compliant fallback |
Won’t Do |
4.0.6, 5.0.1 |
||
Add session-id to the operational datastore |
Done |
5.0.2 |
||
Convert mdsal-netconf-tcp to OSGi DS |
Done |
5.0.2 |
||
Separate out schemaless mountpoints |
Done |
5.0.0 |
||
Add changed-leaf-nodes-only subscription extension |
Done |
5.0.0 |
||
Device Notification |
Done |
5.0.0 |
||
SchemaResourceManager should not reference network-topogy |
Done |
5.0.0 |
||
Encapsulate RemoteDeviceHandler.onDeviceConnected() access services |
Done |
5.0.0 |
||
NetconfDeviceCapabilities should be imutable |
Done |
5.0.0 |
||
Specialize schemaless remote device RPC service |
Done |
5.0.0 |
||
Complete firstConnectionFuture without holding locks |
Done |
5.0.0 |
||
Remove generics from sal.connect.api |
Done |
5.0.0 |
||
Do not expose NetconfDeviceCapabilities from NetconfTopology |
Done |
5.0.0 |
||
Refactor restconf-nb blueprint wiring |
Done |
5.0.2 |
||
Create tests for different instances of MixinNodes |
Done |
5.0.1 |
||
Remove SchemaAware NormalizedNode builders usage |
Done |
5.0.0 |
||
Expose sal-netconf-connector configuration as a grouping |
Done |
5.0.0 |
||
Simplify OperationsContext with yangtools 7.0.9 + |
Done |
3.0.9, 4.0.5, 5.0.0 |
||
Move NetconfTopologyRPCProvider to netconf.topology.spi |
Done |
5.0.0 |
||
Rename netconf.api.ModifyAction to EffectiveOperation |
Done |
5.0.0 |
||
Deprecate netconf-node-topology.yang RPCs |
Done |
5.0.0 |
||
Eliminate Blueprint from mdsal-netconf-monitoring |
Done |
5.0.2 |
||
Convert mdsal-netconf-ssh to OSGi DS |
Done |
5.0.2 |
||
Eliminate Blueprint from mdsal-netconf-impl |
Done |
5.0.2 |
||
Convert netconf-config to OSGi DS |
Done |
5.0.2 |
||
Convert mdsal-netconf-connector to OSGi DS |
Done |
5.0.2 |
||
Convert restconf-nb to OSGi Declarative Services |
Done |
5.0.2 |
||
Convert netconf-topology to OSGi DS |
Done |
5.0.2 |
||
Convert sal-rest-docgen to OSGi DS |
Done |
5.0.2 |
||
Convert mdsal-netconf-notification to OSGi DS |
Done |
5.0.2 |
||
Remove BaseCallHomeTopology |
Done |
5.0.3 |
||
Update websocket-change-event-notification-subscription-tutorial |
Done |
5.0.4 |
Known Issues¶
The following table lists the known issues that exist in this release.
Type |
Key |
Summary |
Status |
Affected Version(s) |
Fix Version(s) |
|---|---|---|---|---|---|
Un-mounting a netconf device does not clean up MD-SAL DOM mountpoints |
In Progress |
5.0.2, Aluminium SR1, Sodium SR3 |
4.0.6, 5.0.5, 6.0.0 |