Genius (Generic Network Interface, Utilities & Services)¶

Genius project provides Generic Network Interfaces, Utilities & Services. Any ODL application can use these to achieve interference-free co-existence with other applications using Genius. OpendayLight Carbon Genius provides following modules –

Interface (logical port) Manager allows bindings/registration of multiple services to logical ports/interfaces
Overlay Tunnel Manager creates and maintains overlay tunnels between configured tunnel endpoints
Aliveness Monitor provides tunnel/nexthop aliveness monitoring services
ID Manager generates cluster-wide persistent unique integer IDs
MD-SAL Utils provides common generic APIs for interaction with MD-SAL
Resource Manager provides a resource sharing framework for applications sharing common resources e.g. table-ids, group-ids etc.
FCAPS Application generates various alarms and counters for the different genius modules
FCAPS Framework module collectively fetches all data generated by fcaps application. Any underlying infrastructure can subscribe for its events to have a generic overview of the various alarms and counters

Major Features¶

Features URL: https://git.opendaylight.org/gerrit/gitweb?p=genius.git;a=blob;f=features/genius-features/src/main/features/features.xml

odl-genius-rest¶

Feature Description: Provides all functionalities provided by genius modules, including interface manager, tunnel manager, resource manager and ID manager and MDSAL Utils.
Top Level: Yes
User Facing: Yes
Experimental: No
CSIT Tests:
- https://jenkins.opendaylight.org/releng/view/genius/job/genius-csit-1node-genius-all-carbon/
- https://jenkins.opendaylight.org/releng/view/genius/job/genius-csit-3node-genius-all-carbon/

odl-genius-fcaps-application¶

Feature Description: includes genius FCAPS application.
Top Level: Yes
User Facing: Yes
Experimental: Yes
CSIT Tests: None

odl-genius-fcaps-framework¶

Feature Description: includes genius FCAPS Framework.
Top Level: Yes
User Facing: Yes
Experimental: Yes
CSIT Tests: None

New capabilities and enhancements added in Carbon¶

Planned new capabilities added¶

/submodules/genius/docs/specs/of-tunnels
/submodules/genius/docs/specs/itm-tunnel-auto-config
/submodules/genius/docs/specs/service-binding-on-tunnels

Unplanned new capabilities added (needed by Netvirt Project)¶

/submodules/genius/docs/specs/multiple-vxlan-tunnels

Enhancements added to existing features/services¶

Interface manager : Increase max services bind on an interface to 16
ITM to support same TEP in multiple Transport Zones
Various performance and scale improvements

Enhancements added to project¶

Migration to Blueprint
Checkstyle enforcement
IT framework enhancements
Junits and CSIT enhancements

Documentation¶

Installation Guide(s):
- N/A
User Guide(s):
- User Guide
Developer Guide(s):
- Developer Guide

Security Considerations¶

Do you have any external interfaces other than RESTCONF?
- No
Other security issues?
- N/A

Quality Assurance¶

Sonar Report (40.7%)
CSIT Jobs
Netvirt CSIT for Genius patches
Netvirt Cluster CSIT for Genius patches

Note

Genius is used extensively in NetVirt, so NetVirt’s CSIT also provides confidence in genius.
Other manual testing and QA information
- N/A
Testing methodology. How extensive was it? What should be expected to work? What hasn’t been tested as much?
- fcaps_framework and fcaps_application features hasn’t been tested much.

Migration¶

Is is possible migrate from the previous release? If so, how?
- No. OpenDaylight doesn’t support migration natively for applications that use datastore.

Compatibility¶

Is this release compatible with the previous release?
- Functionality is fully backwards compatible.
Any API changes?
- No
Any configuration changes?
- No

Bugs Fixed¶

List of bugs fixed since the previous release
- Fixed BUGS

Known Issues¶

List key known issues with workarounds
- None
Open Bugs

End-of-life¶

List of features/APIs which are EOLed, deprecated, and/or removed in this release
- MDSalUtil Async*ListenerBase classes deprecated

Standards¶

List of standards implemented and to what extent
- N/A

Release Mechanics¶

Release plan
Describe any major shifts in release schedule from the release plan
- N/A