CCSDK/SDNC Users: This is to advise you of an upcoming change in the OpenDaylight platform which will introduce breaking changes for some users of our RESTCONF interface. This change will NOT impact our ONAP Kohn release. However, it will eventually impact ONAP and so we wanted to share that impact as early as possible in order to assist in planning.
Background: versions of RESTCONF interface definition The northbound API to the OpenDaylight platform – which the ONAP SDN-C platform shares – is defined by the RESTCONF protocol. The original definition of RESTCONF was defined by an internet draft, known as draft-bierman-netconf-restconf-02. This draft was later superceded by RFC-8040, which unfortunately is NOT backwards compatible. The simplest way to tell which version is being used is that all URLs used in the bierman-draft style begin with “/restconf/”, while all URLs used in RFC-8040 begin with “/rests/”. There are several other differences, which are summarized on the following wiki page : Switch from Biermann-RestConf to RFC8040 interface<https://wiki.onap.org/display/DW/Switch+from+Biermann-RestConf+to+RFC8040+interface> . OpenDaylight support for RESTCONF versions The last several OpenDaylight releases have supported both versions of RESTCONF. However, the OpenDaylight community has declared that support for the bierman-draft version of RESTCONF is deprecated in their Sulfur release and it will be removed in the following OpenDaylight release – Chlorine. The ONAP Kohn release will be based on OpenDaylight Sulfur. Therefore, both versions of RESTCONF will continue to be supported natively by OpenDaylight and, therefore, also by the ONAP SDN Controller. Thus, for ONAP Kohn, there is no immediate impact. Support for older RESTCONF version in ONAP London release Most recent ONAP use cases have been using the RFC-8040 version of the RESTCONF interface. Those projects will not be impacted by the removal of the bierman-draft interface in OpenDaylight. However, older use cases, as well as some downstream ONAP users, are still using the bierman-draft version. We recognize that migrating to RFC-8040 will require a non-trivial amount of work, and therefore we have been working with the OpenDaylight community to develop a strategy to extend support for the bierman-draft RESTCONF version within ONAP. Our current plan is to take over support of the current OpenDaylight implementation of the bierman-draft interface and install it as part of our ONAP SDNC installation starting with the ONAP London release. It is important to note that this is intended as a temporary, stop-gap solution to allow our clients time to migrate to the RFC-8040 standard compliant version of our RESTCONF interface. We strongly encourage any clients currently using the bierman-draft RESTCONF interface format to plan to migrate to the RFC-8040 version at their earliest convenience. Dan Timoney ONAP PTL – CCSDK and SDNC projects -- Dan Timoney [email protected] Lead Member of Tech Staff ONAP Project Technical Lead : CCSDK and SDNC projects -=-=-=-=-=-=-=-=-=-=-=- Links: You receive all messages sent to this group. View/Reply Online (#24075): https://lists.onap.org/g/onap-discuss/message/24075 Mute This Topic: https://lists.onap.org/mt/92310084/21656 Mute #ccsdk:https://lists.onap.org/g/onap-discuss/mutehashtag/ccsdk Mute #sdnc:https://lists.onap.org/g/onap-discuss/mutehashtag/sdnc Group Owner: [email protected] Unsubscribe: https://lists.onap.org/g/onap-discuss/unsub [[email protected]] -=-=-=-=-=-=-=-=-=-=-=-
