Unimgr: Beryllium: Release Notes

Owned by Manish Kumar Barnwal
Aug 26, 2021
2 min read

Contents

Major Features

UNI Manager plug-in is an experimental/proof-of-concept project introduced to OpenDaylight with the Beryllium release.

  • User-facing feature: odl-unimgr-ui

  • Northbound REST interface to receive requests for Ethernet Private Line service with UNI locations and Class of Service ID

  • Obtains Class of Service parameters from northbound Class of Service Manager API implementation (see OPNFV Connectivity Services LSO project)

  • Configures two specified OVS instances with two bridged ports through the OpenDaylight OVSDB southbound API, emulating User Network Interface (UNI) functionality in the OVS instances

  • Creates GRE tunnel between two specified OVS instances through the OVSDB southbound API, emulating an Ethernet Virtual Connection (EVC)

  • Integrated with ODL Topology Manager: updates ODL Topology with UNI and EVC attributes:

    • When a UNI is created it is added to the ODL Network Topology with UNI Manager schema

    • When an EVC is created it is added to the ODL Network Topology with EVC schema

Target Environment

For Execution

  • Usual JRE requirements of OpenDaylight.

  • UNI Manager plug-in is called by OPNFV Connectivity Services LSO API implementations

For Development

  • Usual JDK and maven requirements of OpenDaylight.

    • UNI Manager plug-in code is fully integrated in the Jenkins CI environment

Known Issues and Limitations

  • Occasionally does not complete the GRE tunnel in the second OVS instance.

  • Occasionally upon UPDATE command changes the OVS interface speed to the incorrect value

  • Testing methodology

    • Approximately 50% unit test coverage complete

    • Jacoco plug-in used for unit tests works with the Mockito test framework but does not work well with Power Mockito framework so reporting is not necessarily accurate.

    • Some integration tests have been completed

    • Reference: https://github.com/opendaylight/unimgr/blob/master/it/src/test/java/org/opendaylight/unimgr/it/UnimgrIT.java

    • System tests completed

    • System tests are defined in the Integration/Test Project

    • UNI Manager System Test patch is here: https://git.opendaylight.org/gerrit/#/c/34362/

    • Distribution Test: UNI Manager feature has been added to the distribution test

    • End-to-end testing has been done with development and verification platform comprised of web UI, OPNFV Connectivity Services LSO project API implementations, and ODL UNI Manager plug-in all running on an Ubuntu laptop; two instances of OVS running in Raspberry Pis; and a client laptop connected to each of the OVS instances. When the GRE tunnel is created by UNI Manager traffic is exchanged between the client laptops through the Raspberry Pis/OVS.