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 netcon-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.

Issues resolved in versions 3.0.0 through 3.0.2 (JIRA)

Type

Key

Summary

Resolution

Fix Version(s)

Bug

NETCONF-713

Stackoverflow in sal-rest-docgen

Done

2.0.15, 3.0.0

Bug

NETCONF-707

Netconf TestTool: Validation for invalid file in “schemas-dir” argument

Done

2.0.15, 3.0.0

Bug

NETCONF-870

Use Decimal64 instead of BigDecimal for DecimalType value

Done

3.0.1

Bug

NETCONF-869

TransactionUtil.ensureParentsByMerge fails on keyed lists

Done

3.0.1

Bug

NETCONF-868

Missing anydata support in ParameterAwareNormalizedNodeWriter.java

Done

2.0.15, 3.0.0

Bug

NETCONF-848

Netconf notifications processing failing for odl-leaf-nodes-only

Done

2.0.15, 3.0.0

Bug

NETCONF-872

Missing stack enter in sal-rest-docgen Actions

Done

3.0.2, 4.0.0

Improvement

NETCONF-864

Convert WadlTemplate.xtend to Java

Done

3.0.0

Improvement

NETCONF-871

Do not use IllegalArgumentCodec in RestCodec

Done

3.0.1

Improvement

NETCONF-866

Do not tolerate malformed RPC/action references in requests URL

Done

3.0.0

Sub-task

NETCONF-819

Eliminate use of SchemaNode.getPath() in sal-rest-docgen

Done

3.0.0

Sub-task

NETCONF-818

Eliminate use of SchemaNode.getPath() in RESTCONF northbound

Done

3.0.0

Sub-task

NETCONF-817

Eliminate use of SchemaNode.getPath() in sal-netconf-connector

Done

3.0.0

Task

NETCONF-867

Reject consecutive slashes in RFC8040 URLs

Done

3.0.0

Task

NETCONF-865

Remove deprecated NodeContainerProxy

Done

3.0.0

Task

NETCONF-846

Set call-home SSH port to 4334

Done

3.0.0

Task

NETCONF-839

Do not install odl-restconf-nb-bierman02 by default

Done

3.0.0

Task

NETCONF-815

Eliminate use of SchemaNode.getPath()

Done

3.0.0

Known Issues

The following table lists the known issues that exist in this release.

Issues affecting versions 3.0.0 through 3.0.2 (JIRA)

Type

Key

Summary

Status

Affected Version(s)

Fix Version(s)

Bug

NETCONF-877

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

Resolved Issues in SR1

The following table lists the issues resolved in Service Release 1.

Issues resolved in versions 3.0.3 through 3.0.3 (JIRA)

Type

Key

Summary

Resolution

Fix Version(s)

Bug

NETCONF-877

Fail to process PATCH to data root with a top-level container as target

Done

3.0.3, 4.0.0

Known Issues in SR1

The following table lists the known issues that exist in Service Release 1.