Page Comparison

the architecture team’s call to discuss the approach CCSDK and SDNC are planning to handle the retirement of the deprecated Biermann version of our RESTCONF interface.

Briefly, the issue is that there are differences between the version of the RESTCONF interface that was originally defined in the Internet Draft written by Biermann et al, and the version that was officially defined in RFC 8040.  These differences, unfortunately, are not backwards compatible.  For a while, OpenDaylight supported both versions, but at this point OpenDaylight no longer supports the Biermann variant. 

We mitigated that issue within ONAP by taking a copy of the OpenDaylight code for the Biermann version and maintaining it ourselves.  The agreement was that this was a temporary solution only, which would be phased out. 

Our  plan in CCSDK/SDN is as follows:

1. New Delhi will be the last release in which both versions of the RESTCONF interface (Biermann and RFC 8040) are supported.  We plan to treat New Delhi as a Long Term Support (LTS) release, and will provide security patches as needed so that users that are unable to migrate to RFC 8040 are not left without a supported release.
2. Starting with Oslo, only the RFC 8040 version of RESTCONF will be included in our CCSDK and SDNC packages.

Since the removal of the Biermann interface is a fairly significant, breaking change, I am proposing that – consistent with semantic versioning – both CCSDK and SDNC will change major versions in Oslo.  CCSDK artifacts for Oslo will be numbered 2.0.x, and SDNC artifacts will be numbered 3.0.x.