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 transport layer of the NETCONF protocol implementation has been completely refactored. This effort has all but unified the ‘normal’ and ‘call-home’ mode of operation. This results in a more maintaintanable codebase with much easier feature parity between the two modes.

RESTCONF implementation has been been refactored to a large extent, taking advantage of JAX-RS asynchronous requests, so that operations on the datastore and NETCONF devices no longer pin the HTTP thread.

The OpenAPI component has been completely modernized. It is now based on Swagger UI vesion 5.13.0 and is memory usage has been brought under control.

New Features

No new features.

Deprecated and Removed Features

The odl-yanglib experimental feature has been removed.

Resolved Issues

The following table lists the issues resolved in this release.

Issues resolved in versions 7.0.0 through 7.0.4 (JIRA)

Type

Key

Summary

Resolution

Fix Version(s)

Bug

NETCONF-1281

OpenAPI: invalid explorer redirection URL

Done

5.0.10, 6.0.8, 7.0.4

Bug

NETCONF-1280

org.opendaylight.netconf.topology-singleton fails to resolve

Done

6.0.8, 7.0.4

Bug

NETCONF-1277

ietf-yang-library:modules-state not available

Done

7.0.3

Bug

NETCONF-1269

OpenAPI: Missing action input and output

Done

7.0.4

Bug

NETCONF-1266

Cannot instantiate on RpcEffectiveStatementImpl…

Done

7.0.1

Bug

NETCONF-1265

Cannot deserialize key value

Done

7.0.4

Bug

NETCONF-1264

Cannot create new list resource with instance identifier key

Done

7.0.4

Bug

NETCONF-1259

OpenAPI: Wrong path reference for netopeer2 models

Done

7.0.2

Bug

NETCONF-1254

OpenAPI: netopeer2 duplicated mapping key

Done

7.0.2

Bug

NETCONF-1252

Device’s reconnecting does not work

Done

7.0.0

Bug

NETCONF-1251

The number of connection attemps is ignored

Done

7.0.0

Bug

NETCONF-1250

Missing device’s connection status

Done

7.0.2

Bug

NETCONF-1249

Callhome Device Remains ‘DISCONNECTED’ After Adding to Allowed Devices

Done

7.0.2

Bug

NETCONF-1245

Full list delete fails when called on remote device via restconf

Done

7.0.4

Bug

NETCONF-1242

OpenAPI: Iterate over models in SchemasStream

Done

7.0.0

Bug

NETCONF-1241

OpenAPI: Iterate over models in PathsStream

Done

7.0.0

Bug

NETCONF-1236

No implementation of subscribe-device-notification available

Done

7.0.2

Bug

NETCONF-1233

Blocking call during NetconfDeviceSchemas acquisition

Done

7.0.0

Bug

NETCONF-1230

OpenAPI: ignoring restconf settings

Done

5.0.10, 6.0.7, 7.0.2

Bug

NETCONF-1224

NetconfDeviceNotificationService.registerNotificationListeners() is not implemented

Done

5.0.10, 6.0.6, 7.0.0

Bug

NETCONF-1222

Improve error path for list items

Done

7.0.0

Bug

NETCONF-1217

Given final block not properly padded. Such issues can arise if a bad key is used during decryption

Won’t Do

7.0.0

Bug

NETCONF-1216

Input length must be multiple of 16 when decrypting with padded cipher

Won’t Do

7.0.0

Bug

NETCONF-1204

NPE on topology create-device without credentials

Done

5.0.10, 6.0.6, 7.0.0

Bug

NETCONF-1203

Update user-guide for for login-password removal

Done

7.0.0

Bug

NETCONF-1200

Netconf device stays connected even when unavailable

Done

7.0.0

Bug

NETCONF-1198

Adapt netconf testtool for login-password removal

Done

7.0.0

Bug

NETCONF-1194

Invalid NETCONF message triggers unnecessary parsing of partial message

Done

4.0.9, 5.0.10, 6.0.5, 7.0.0

Bug

NETCONF-1192

Duplicate ‘ignore-missing-schema-sources’ in the NETCONF node

Done

5.0.10, 6.0.6, 7.0.0

Bug

NETCONF-1180

PUT request with insert=after cannot add last item into list

Done

5.0.10, 6.0.7, 7.0.2

Bug

NETCONF-1179

OpenApi Remove processModule method from DefinitionGenerator

Done

4.0.9, 5.0.10, 6.0.5, 7.0.0

Bug

NETCONF-1178

POST request with insert parameter fails if target URI points the list

Done

5.0.10, 6.0.8, 7.0.4

Bug

NETCONF-1173

NetconfDeviceMount “Already initialized” error

Done

4.0.9, 5.0.10, 6.0.5, 7.0.0

Bug

NETCONF-1172

OpenApi ignore min-elements conditions for list

Done

7.0.0

Bug

NETCONF-1171

OpenAPI Generates Incorrect ‘min-elements’ for XML Leaf-List

Done

4.0.9, 5.0.10, 6.0.5, 7.0.0

Bug

NETCONF-1170

netconf-client-mdsal emits useless namespace in filter

Done

5.0.8, 6.0.5, 7.0.0

Bug

NETCONF-1168

OpenApi List show only string type for path parameters

Done

4.0.9, 5.0.10, 6.0.5, 7.0.0

Bug

NETCONF-1165

OpenAPI generate multiple resources/subresources in POST request

Done

4.0.9, 5.0.10, 6.0.5, 7.0.0

Bug

NETCONF-1164

OpenAPI POST request generates incorrect XML example payload

Done

4.0.9, 5.0.10, 6.0.5, 7.0.0

Bug

NETCONF-1163

Create tests for POST “insert” query parameter

Done

7.0.0

Bug

NETCONF-1159

RestconfSchemaService return 500 if model was not found

Done

4.0.9, 5.0.9, 6.0.5, 7.0.0

Bug

NETCONF-1153

Unnecessary data change events for child-nodes-only

Done

6.0.4, 7.0.0

Bug

NETCONF-1152

RESTCONF DataTreeChange notifications use incorrect format

Done

7.0.0

Bug

NETCONF-1151

Incorrect subscription request URL

Done

6.0.3, 7.0.0

Bug

NETCONF-1139

OpenApi: XML payload for RPC is missing namespace

Done

4.0.9, 5.0.8, 6.0.5, 7.0.0

Bug

NETCONF-1133

Incorrect schema reference in root post link

Done

4.0.9, 5.0.8, 6.0.5, 7.0.0

Bug

NETCONF-1130

(devices) POST returns 500 on data already exists

Done

5.0.10, 6.0.6, 7.0.0

Bug

NETCONF-1127

netconf-testtool not building when GID too big

Done

7.0.0

Bug

NETCONF-1103

Incorrect response for failed PATCH request

Done

4.0.9, 5.0.10, 6.0.5, 7.0.0

Bug

NETCONF-1101

OpenApi: Remove incorrect list POST requests

Done

4.0.9, 5.0.10, 6.0.5, 7.0.0

Known Issues

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

Issues affecting versions 7.0.0 through 7.0.4 (JIRA)

Type

Key

Summary

Status

Affected Version(s)

Fix Version(s)

Bug

NETCONF-1354

Missing default restconf NB config file

Resolved

5.0.10, 6.0.6, 7.0.0

6.0.9, 7.0.8, 8.0.0

Bug

NETCONF-1348

Random failures of transport-ssh tests

Resolved

4.0.3, 4.0.9, 5.0.0, 5.0.10, 6.0.0, 6.0.8, 7.0.0, 7.0.7, 8.0.0

6.0.9, 7.0.8, 8.0.0

Bug

NETCONF-1338

OpenApi: missing parameters for ROOT data GET

In Review

7.0.0, 7.0.1, 7.0.2, 7.0.3, 7.0.4, 7.0.5, 7.0.6, 7.0.7

7.0.10, 8.0.2, 9.0.0

Bug

NETCONF-1337

OpenApi: Use PathsEntity again

In Progress

7.0.0, 7.0.1, 7.0.2, 7.0.3, 7.0.4, 7.0.5, 7.0.6, 7.0.7

7.0.10, 8.0.2, 9.0.0

Bug

NETCONF-1314

The tapi-topology’s RPCs outputs are missing

Resolved

7.0.4

7.0.5

Bug

NETCONF-1309

Openapi: Missing schema for node processed by another parent

Resolved

7.0.0, 7.0.1, 7.0.2, 7.0.3, 7.0.4, 7.0.5, 7.0.6, 7.0.7

7.0.8, 8.0.0

Bug

NETCONF-1303

OpenAPI: Generate document for module without revision

Resolved

7.0.1, 7.0.2, 7.0.3, 7.0.4

7.0.5

Bug

NETCONF-1299

Test Tool Fails Intermittently to Send Required Netconf Replies

Resolved

7.0.0

7.0.5

Bug

NETCONF-1295

sal-remote create-notification-stream is not working

Resolved

7.0.0, 7.0.4, 8.0.0, 8.0.1

7.0.10, 8.0.2

Bug

NETCONF-1285

NPE on GET rests/operations

Resolved

7.0.3, 7.0.4

7.0.5

Bug

NETCONF-1279

openapi / swagger does not work for TransportPCE with controller resources

Resolved

7.0.3

7.0.5

Bug

NETCONF-1273

Error 500 on Notification Stream Access for Netconf Device Subscriptions

Resolved

7.0.0, 7.0.1, 7.0.2, 7.0.3, 7.0.4

7.0.5

Bug

NETCONF-1270

OpenAPI: not used “duplicated” schema

Resolved

7.0.3

7.0.5

Bug

NETCONF-1263

Capabilities created for yang models without revision are unavailable

Resolved

7.0.0, 7.0.1, 7.0.2, 7.0.3, 7.0.4

7.0.5

Bug

NETCONF-1261

Initial device connection fails due to unstable network conditions on device

Resolved

7.0.0

7.0.5