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
Northbound plugin for RESTCONF protocol, as described in an early draft
Northnound plugin for descring RESTCONF endpoint in terms of OpenAPI 3.0
Behavior/Feature Changes¶
The RFC8040 endpoint now correctly rejects consecutive slash characters in request URL. The previous
behavior of silently accepting such requests can be restored through setting the
org.opendaylight.restconf.url.consecutive-slashes system property to allow. Valid options are also
debug and warn, which cause offending requests to be accepted, but logged to the system log.
The netconf-node-topology YANG model has been updated to correctly mark the presence of OpenDaylight’s
yang-ext:mount extension. This does not affect the implementation, but improves interoperability with
external system.
The default port for call-home has been updated to 4334, bringing it to compliance with RFC8071.
New Features¶
There are no new features.
Deprecated and Removed Features¶
The old RESTCONF endpoint localhost:8181/restconf, as installed via odl-restconf-nb-bierman02 feature,
is now considered obsolete and is not installed by default. Users are advised to migrate to using the
RFC8040-compliant endpoint localhost:8181/rests, as installed via odl-restconf-nb-rfc8040. The support
for the old endpoint will be removed in the next major release.
Resolved Issues¶
The following table lists the issues resolved in this release.
Type |
Key |
Summary |
Resolution |
Fix Version(s) |
|---|---|---|---|---|
Stackoverflow in sal-rest-docgen |
Done |
2.0.15, 3.0.0 |
||
Netconf TestTool: Validation for invalid file in “schemas-dir” argument |
Done |
2.0.15, 3.0.0 |
||
Use Decimal64 instead of BigDecimal for DecimalType value |
Done |
3.0.1 |
||
TransactionUtil.ensureParentsByMerge fails on keyed lists |
Done |
3.0.1 |
||
Missing anydata support in ParameterAwareNormalizedNodeWriter.java |
Done |
2.0.15, 3.0.0 |
||
Netconf notifications processing failing for odl-leaf-nodes-only |
Done |
2.0.15, 3.0.0 |
||
Missing stack enter in sal-rest-docgen Actions |
Done |
3.0.2, 4.0.0 |
||
Convert WadlTemplate.xtend to Java |
Done |
3.0.0 |
||
Do not use IllegalArgumentCodec in RestCodec |
Done |
3.0.1 |
||
Do not tolerate malformed RPC/action references in requests URL |
Done |
3.0.0 |
||
Eliminate use of SchemaNode.getPath() in sal-rest-docgen |
Done |
3.0.0 |
||
Eliminate use of SchemaNode.getPath() in sal-netconf-connector |
Done |
3.0.0 |
||
Eliminate use of SchemaNode.getPath() in RESTCONF northbound |
Done |
3.0.0 |
||
Reject consecutive slashes in RFC8040 URLs |
Done |
3.0.0 |
||
Remove deprecated NodeContainerProxy |
Done |
3.0.0 |
||
Set call-home SSH port to 4334 |
Done |
3.0.0 |
||
Do not install odl-restconf-nb-bierman02 by default |
Done |
3.0.0 |
||
Eliminate use of SchemaNode.getPath() |
Done |
3.0.0 |
Known Issues¶
The following table lists the known issues that exist in this release.
Type |
Key |
Summary |
Status |
Affected Version(s) |
Fix Version(s) |
|---|---|---|---|---|---|
Fail to process PATCH to data root with a top-level container as target |
Resolved |
3.0.0, 3.0.1, 3.0.2 |
3.0.3, 4.0.0 |
||
Typo in content parameter error-message |
Resolved |
2.0.14, 2.0.16, 3.0.0, 3.0.5 |
3.0.6, 4.0.0 |
||
netconf-mdsal fails and affects both testtool and ODL as netconf server |
Resolved |
3.0.0, 3.0.3, 3.0.4 |
3.0.5, 4.0.0 |
||
Device with augmented NETCONF monitoring response cannot be connected without models inside cache/schema |
Resolved |
2.0.0, 2.0.16, 3.0.0, 3.0.5 |
3.0.6, 4.0.0 |
Resolved Issues in SR1¶
The following table lists the issues resolved in Service Release 1.
Type |
Key |
Summary |
Resolution |
Fix Version(s) |
|---|---|---|---|---|
Fail to process PATCH to data root with a top-level container as target |
Done |
3.0.3, 4.0.0 |
||
Netconf device mount with hostname in payload |
Done |
2.0.16, 3.0.4, 4.0.0 |
||
netconf-mdsal fails and affects both testtool and ODL as netconf server |
Done |
3.0.5, 4.0.0 |
Known Issues in SR1¶
The following table lists the known issues that exist in Service Release 1.
Type |
Key |
Summary |
Status |
Affected Version(s) |
Fix Version(s) |
|---|---|---|---|---|---|
Typo in content parameter error-message |
Resolved |
2.0.14, 2.0.16, 3.0.0, 3.0.5 |
3.0.6, 4.0.0 |
||
Device with augmented NETCONF monitoring response cannot be connected without models inside cache/schema |
Resolved |
2.0.0, 2.0.16, 3.0.0, 3.0.5 |
3.0.6, 4.0.0 |