Genius Nitrogen Release Note
[docs.git] / docs / getting-started-guide / project-release-notes / genius.rst
index a6edbb33848aadfc830730c6cd6c04b47db0298f..8fbc3da6e802aa18e9b2bcc71c87844665ce35d6 100644 (file)
@@ -2,35 +2,70 @@
 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
+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
+* **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
+* **Features URL:** https://git.opendaylight.org/gerrit/gitweb?p=genius.git;a=blob_plain;f=features/genius-features/pom.xml
+
+odl-genius
+----------
+
+* **Feature Description:**  This feature provides all functionalities provided by
+  genius modules, including interface manager, tunnel manager, resource manager
+  and ID manager and MDSAL Utils. It includes Genius APIs and implementation.
+
+* **Top Level:** Yes
+* **User Facing:** Yes
+* **Experimental:** No
+* **CSIT Tests:**
+  * https://jenkins.opendaylight.org/releng/view/genius/job/genius-csit-1node-upstream-all-nitrogen/
+  * https://jenkins.opendaylight.org/releng/view/genius/job/genius-csit-3node-upstream-all-nitrogen/
 
 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.
+* **Feature Description:**  This feature includes RESTCONF with 'odl-genius'
+  feature.
 
 * **Top Level:** Yes
 * **User Facing:** Yes
 * **Experimental:** No
 * **CSIT Tests:**
+  * https://jenkins.opendaylight.org/releng/view/genius/job/genius-csit-1node-upstream-all-nitrogen/
+  * https://jenkins.opendaylight.org/releng/view/genius/job/genius-csit-3node-upstream-all-nitrogen/
 
-  * 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-api
+---------------
 
+* **Feature Description:**  This feature includes API for all the functionalities
+  provided by Genius.
+
+* **Top Level:** No
+* **User Facing:** No
+* **Experimental:** No
+* **CSIT Tests:**
+  * https://jenkins.opendaylight.org/releng/view/genius/job/genius-csit-1node-upstream-all-nitrogen/
+  * https://jenkins.opendaylight.org/releng/view/genius/job/genius-csit-3node-upstream-all-nitrogen/
 
 odl-genius-fcaps-application
 ----------------------------
@@ -51,36 +86,21 @@ odl-genius-fcaps-framework
 * **CSIT Tests:** None
 
 
-New capabilities and enhancements added in Carbon
-=================================================
-
-Planned new capabilities added
-------------------------------
-
-* :doc:`/submodules/genius/docs/specs/of-tunnels`
-* :doc:`/submodules/genius/docs/specs/itm-tunnel-auto-config`
-* :doc:`/submodules/genius/docs/specs/service-binding-on-tunnels`
-
+New capabilities and enhancements added in Nitrogen
+===================================================
 
-Unplanned new capabilities added (needed by Netvirt Project)
-------------------------------------------------------------
-
-* :doc:`/submodules/genius/docs/specs/multiple-vxlan-tunnels`
+Planned new capability added
+----------------------------
 
-Enhancements added to existing features/services
-------------------------------------------------
+* :doc:`/submodules/genius/docs/specs/service-recovery`
 
-* 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
+#. Migration to Karaf4
+#. Bug fixes
+
 
 Documentation
 =============
@@ -111,13 +131,13 @@ Security Considerations
 Quality Assurance
 =================
 
-* `Sonar Report <https://sonar.opendaylight.org/overview?id=64114>`_ (40.7%)
+* `Sonar Report <https://sonar.opendaylight.org/overview?id=64114>`_
 
-* `CSIT Jobs <https://jenkins.opendaylight.org/releng/view/genius/job/genius-csit-1node-genius-all-carbon//>`_
+* `CSIT Jobs <https://jenkins.opendaylight.org/releng/view/genius/job/genius-csit-1node-upstream-all-nitrogen//>`_
 
-* `Netvirt CSIT for Genius patches <https://jenkins.opendaylight.org/releng/job/genius-patch-test-netvirt-carbon/>`_
+* `Netvirt CSIT for Genius patches <https://jenkins.opendaylight.org/releng/job/genius-patch-test-netvirt-nitrogen/>`_
 
-* `Netvirt Cluster CSIT for Genius patches <https://jenkins.opendaylight.org/releng/job/genius-patch-test-cluster-netvirt-carbon/>`_
+* `Netvirt Cluster CSIT for Genius patches <https://jenkins.opendaylight.org/releng/job/genius-patch-test-cluster-netvirt-nitrogen/>`_
 
   .. note:: Genius is used extensively in NetVirt, so NetVirt's CSIT also
             provides confidence in genius.
@@ -126,16 +146,18 @@ Quality Assurance
 
   * N/A
 
-* Testing methodology. How extensive was it? What should be expected to work? What hasn't been tested as much?
+* 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?
+* Is it possible to migrate from the previous release? If so, how?
 
-  * No. OpenDaylight doesn't support migration natively for applications that use datastore.
+  * No. OpenDaylight doesn't support migration natively for applications that
+    use datastore.
 
 Compatibility
 -------------
@@ -146,7 +168,7 @@ Compatibility
 
 * Any API changes?
 
-  * No
+  * New API added for `service-recovery </submodules/genius/docs/specs/service-recovery>` feature
 
 * Any configuration changes?
 
@@ -157,7 +179,7 @@ Bugs Fixed
 
 * List of bugs fixed since the previous release
 
-  * `Fixed BUGS <https://bugs.opendaylight.org/buglist.cgi?chfieldfrom=2016-08-9&chfieldto=2017-05-25&list_id=78466&product=genius&query_format=advanced&resolution=FIXED>`_
+  * `Fixed BUGS <https://bugs.opendaylight.org/buglist.cgi?chfieldfrom=2017-05-25&chfieldto=2017-08-09&list_id=78466&product=genius&query_format=advanced&resolution=FIXED>`_
 
 Known Issues
 ------------
@@ -171,9 +193,10 @@ Known Issues
 End-of-life
 ===========
 
-* List of features/APIs which are EOLed, deprecated, and/or removed in this release
+* List of features/APIs which are EOLed, deprecated, and/or removed in this
+  release
 
-  * `MDSalUtil Async*ListenerBase classes deprecated <https://git.opendaylight.org/gerrit/#/c/51913/>`_
+  * N/A
 
 Standards
 =========
@@ -185,7 +208,7 @@ Standards
 Release Mechanics
 =================
 
-* `Release plan <https://wiki.opendaylight.org/view/Genius:Carbon_Release_Plan>`_
+* `Release plan <https://wiki.opendaylight.org/view/Genius:Nitrogen_Release_Plan>`_
 
 * Describe any major shifts in release schedule from the release plan