docs/NEWS.rst

   1 ========================
   2 ODL Parent release notes
   3 ========================
   4
   5 Version 9.0.8
   6 -------------
   7 This is a bug-fix upgrade from version 9.0.7.
   8
   9 Bug fixes
  10 ~~~~~~~~~
  11 * The fix for `ODLPARENT-220 <https://jira.opendaylight.org/browse/ODLPARENT-220>`__ ended up
  12   changing behavior and packaging ``INFO.yaml`` instead of ``PROJECT_YAML``. This has now been
  13   fixed.
  14
  15 Version 9.0.7
  16 -------------
  17 This is a bug-fix upgrade from version 9.0.6.
  18
  19 Bug fixes
  20 ~~~~~~~~~
  21 * The upgrade of ``maven-dependency-plugin`` to version 3.2.0 has caused a regression in accuracy
  22   of reports, with quite a few false positives being generated. The declaration has been rolled
  23   back to version 3.1.2 with a few tweaks to improve JDK compatibility. See
  24   `ODLPARENT-270 <https://jira.opendaylight.org/browse/ODLPARENT-270>`__ for more information.
  25
  26 Improvements
  27 ~~~~~~~~~~~~
  28 * The declaration and invocation of ``script-maven-plugin`` has been replaced with a dedicated
  29   plugin providing the same functionality in a much more performant way.  See
  30   `ODLPARENT-220 <https://jira.opendaylight.org/browse/ODLPARENT-220>`__ for more information.
  31
  32 * A new parent pom.xml, ``bnd-parent``, is now available as an alternative to the existing
  33   ``bundle-parent``.  It has a more streamlined integration with other plugins, for example
  34   maven-jar-plugin, and a much healthier community. See
  35   `ODLPARENT-258 <https://jira.opendaylight.org/browse/ODLPARENT-258>`__ for more information.
  36
  37 * The definition of ``odl-karaf-feat-jdbc`` feature has been reworked to not pull in the entire
  38   ``enterprise`` feature repository, leading to significant savings in terms of Karaf distribution
  39   size for most downstream projects. See
  40   `ODLPARENT-266 <https://jira.opendaylight.org/browse/ODLPARENT-266>`__ for more information.
  41
  42 * The declaration of ``maven-compiler-plugin`` is now available in ``odlparent-lite``. This is
  43   improves locality, as the JDK version enforcement is already part of odlparent-lite.
  44
  45 Third-party dependencies
  46 ~~~~~~~~~~~~~~~~~~~~~~~~
  47 * GSON 2.8.5 → 2.8.8, release notes:
  48   * `2.8.6 <https://github.com/google/gson/blob/master/CHANGELOG.md#version-286>`__
  49   * `2.8.7 <https://github.com/google/gson/blob/master/CHANGELOG.md#version-287>`__
  50   * `2.8.8 <https://github.com/google/gson/blob/master/CHANGELOG.md#version-288>`__
  51
  52 * Jolokia `1.7.0 → 1.7.1 <https://jolokia.org/changes-report.html#a1.7.1>`__
  53
  54 * Mockito 3.9.0 → 3.12.4, release notes:
  55   * `3.9.2 <https://github.com/mockito/mockito/releases/tag/v3.9.2>`__
  56   * `3.9.3 <https://github.com/mockito/mockito/releases/tag/v3.9.3>`__
  57   * `3.9.7 <https://github.com/mockito/mockito/releases/tag/v3.9.7>`__
  58   * `3.9.9 <https://github.com/mockito/mockito/releases/tag/v3.9.9>`__
  59   * `3.9.10 <https://github.com/mockito/mockito/releases/tag/v3.9.10>`__
  60   * `3.11.0 <https://github.com/mockito/mockito/releases/tag/v3.11.0>`__
  61   * `3.11.1 <https://github.com/mockito/mockito/releases/tag/v3.11.1>`__
  62   * `3.11.2 <https://github.com/mockito/mockito/releases/tag/v3.11.2>`__
  63   * `3.12.0 <https://github.com/mockito/mockito/releases/tag/v3.12.0>`__
  64   * `3.12.1 <https://github.com/mockito/mockito/releases/tag/v3.12.1>`__
  65   * `3.12.2 <https://github.com/mockito/mockito/releases/tag/v3.12.2>`__
  66   * `3.12.3 <https://github.com/mockito/mockito/releases/tag/v3.12.3>`__
  67
  68 * Netty 4.1.67 → 4.1.69, release notes:
  69   * `4.1.68 <https://netty.io/news/2021/09/09/4-1-68-Final.html>`__
  70   * `4.1.69 <https://netty.io/news/2021/10/11/4-1-69-Final.html>`__
  71
  72 Version 9.0.6
  73 -------------
  74 This is a bug-fix upgrade from version 9.0.5.
  75
  76 Third-party dependencies
  77 ~~~~~~~~~~~~~~~~~~~~~~~~
  78 * Jackson 2.11.4 → 2.12.5, release notes:
  79   * `2.12 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.12>`__
  80   * `2.12.1 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.12.1>`__
  81   * `2.12.2 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.12.2>`__
  82   * `2.12.3 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.12.3>`__
  83   * `2.12.4 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.12.4>`__
  84   * `2.12.5 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.12.5>`__
  85
  86 * Jetty 9.4.40 → 9.4.43.v20210629, release notes:
  87   * `9.4.41.v20210516 <https://github.com/eclipse/jetty.project/releases/tag/jetty-9.4.41.v20210516>`__
  88   * `9.4.42.v20210604 <https://github.com/eclipse/jetty.project/releases/tag/jetty-9.4.42.v20210604>`__
  89   * `9.4.43.v20210629 <https://github.com/eclipse/jetty.project/releases/tag/jetty-9.4.43.v20210629>`__
  90
  91 * Jolokia `1.6.2 → 1.7.0 <https://jolokia.org/changes-report.html#a1.7.0>`__
  92
  93 * Karaf `4.3.2 → 4.3.3 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12350142>`__
  94
  95 * Pax URL 2.5.4 → 2.6.7, release notes:
  96   * `2.6.0 <https://github.com/ops4j/org.ops4j.pax.url/milestone/67?closed=1>`__
  97   * `2.6.3 <https://github.com/ops4j/org.ops4j.pax.url/milestone/68?closed=1>`__
  98   * `2.6.4 <https://github.com/ops4j/org.ops4j.pax.url/milestone/69?closed=1>`__
  99   * `2.6.6 <https://github.com/ops4j/org.ops4j.pax.url/milestone/71?closed=1>`__
 100   * `2.6.7 <https://github.com/ops4j/org.ops4j.pax.url/milestone/72?closed=1>`__
 101
 102 Plugin upgrades
 103 ~~~~~~~~~~~~~~~
 104 * maven-enforcer-plugin `3.0.0-M3 → 3.0.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317520&version=12346527>`__
 105
 106 * asciidoctor-maven-plugin 2.1.0 → 2.2.1
 107
 108 Version 9.0.5
 109 -------------
 110 This is a minor upgrade from version 9.0.4.
 111
 112 Bug fixes
 113 ~~~~~~~~~
 114 * Previous patch to address Bouncy Castle missed a critical piece for populating boot class path. This has now
 115   been corrected.
 116
 117
 118 Version 9.0.4
 119 -------------
 120 This is a minor upgrade from version 9.0.3.
 121
 122 Bug fixes
 123 ~~~~~~~~~
 124 * The upgrade to Bouncy Castle 1.69 turned out to be broken due to some code movement and introduction of a new
 125   ``bcutil-jdk15on`` artifact. It has also highlighted duplicate packaging, where Karaf's features would install
 126   version 1.66, while we have been on a newer version for some time. Both these issues have now ween resolved.
 127   See `ODLPARENT-254 <https://jira.opendaylight.org/browse/ODLPARENT-254>`__ for more information.
 128
 129
 130 Version 9.0.3
 131 -------------
 132 This is a minor upgrade from version 9.0.2.
 133
 134 Third-party dependencies
 135 ~~~~~~~~~~~~~~~~~~~~~~~~
 136 * awaitility `4.0.3 → 4.1.0 <https://raw.githubusercontent.com/awaitility/awaitility/master/changelog.txt>`__
 137
 138 * Bouncy Castle `1.68 → 1.69 <https://www.bouncycastle.org/releasenotes.html>`__
 139
 140 * Checkstyle 8.42 → 8.45.1, release notes:
 141   * `8.43 <https://checkstyle.org/releasenotes.html#Release_8.43>`__
 142   * `8.44 <https://checkstyle.org/releasenotes.html#Release_8.44>`__
 143   * `8.45 <https://checkstyle.org/releasenotes.html#Release_8.45>`__
 144   * `8.45.1 <https://checkstyle.org/releasenotes.html#Release_8.45.1>`__
 145
 146 * commons-io 2.8.0 → 2.11.0, release notes:
 147   * `2.9.0 <https://commons.apache.org/proper/commons-io/changes-report.html#a2.9.0>`__
 148   * `2.10.0 <https://commons.apache.org/proper/commons-io/changes-report.html#a2.10.0>`__
 149   * `2.11.0 <https://commons.apache.org/proper/commons-io/changes-report.html#a2.11.0>`__
 150
 151 * Dropwizard Metrics 4.1.21 → 4.1.25, release notes:
 152   * `4.1.22 <https://github.com/dropwizard/metrics/releases/tag/v4.1.22>`__
 153   * `4.1.23 <https://github.com/dropwizard/metrics/releases/tag/v4.1.23>`__
 154   * `4.1.24 <https://github.com/dropwizard/metrics/releases/tag/v4.1.24>`__
 155   * `4.1.25 <https://github.com/dropwizard/metrics/releases/tag/v4.1.25>`__
 156
 157 * Google Truth `1.1.2 → 1.1.3 <https://github.com/google/truth/releases/tag/release_1_1_3>`__
 158
 159 * logback 1.2.3 → 1.2.5, release notes:
 160   * `1.2.4 <https://jira.qos.ch/issues/?jql=project+%3D+LOGBACK+AND+fixVersion+%3D+1.2.4>`__
 161   * `1.2.5 <https://jira.qos.ch/issues/?jql=project+%3D+LOGBACK+AND+fixVersion+%3D+1.2.5>`__
 162
 163 * Netty 4.1.65 → 4.1.67, release notes:
 164   * `4.1.66 <https://netty.io/news/2021/07/16/4-1-66-Final.html>`__
 165   * `4.1.67 <https://netty.io/news/2021/08/16/4-1-67-Final.html>`__
 166
 167 * Sevntu `1.39.0 → 1.40.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.40.0>`__
 168
 169 * ThreeTen `1.6.0 → 1.7.0 <https://www.threeten.org/threeten-extra/changes-report.html#a1.7.0>`__
 170
 171 Plugin upgrades
 172 ~~~~~~~~~~~~~~~
 173 * git-commit-id-plugin `4.0.4 → 4.0.5 <https://github.com/git-commit-id/git-commit-id-maven-plugin/releases/tag/v4.0.5>`__
 174
 175 * Jacoco Maven plugin `0.8.6 → 0.8.7 <https://github.com/jacoco/jacoco/releases/tag/v0.8.7>`__
 176
 177 * maven-dependency-plugin `3.1.2 → 3.2.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317227&version=12348705>`__
 178
 179 * maven-plugin-plugin `3.6.0 → 3.6.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317820&version=12344365>`__
 180
 181 * project-info-reports-plugin `3.1.1 → 3.1.2 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317821&version=12349521>`__
 182
 183 Version 9.0.2
 184 -------------
 185 This is a minor upgrade from version 9.0.1.
 186
 187 Bug fixes
 188 ~~~~~~~~~
 189 * The upgrade to Karaf 4.3.0 caused a slight misalignment of ``org.apache.felix.metatype``
 190   and ``org.osgi.service.event`` versions, leading to an unnecessary rewiring of the container
 191   most notably during Single Feature Test. This has now been corrected.
 192   See `ODLPARENT-253 <https://jira.opendaylight.org/browse/ODLPARENT-253>`__ for more information.
 193
 194 * ``stax-utils`` component has a default dependency on ``com.bea.xml:jsr174-ri``, which is not
 195   resolvable from Maven Central. This artifact is not needed with modern JRE versions, hence add
 196   an explicit exclusion.
 197
 198 Third-party dependencies
 199 ~~~~~~~~~~~~~~~~~~~~~~~~
 200 * Jetty 9.4.38.v20210224 → 9.4.40.v20210413, release notes:
 201   * `9.4.39.v20210325 <https://github.com/eclipse/jetty.project/releases/tag/jetty-9.4.39.v20210325>`__
 202   * `9.4.40.v20210413 <https://github.com/eclipse/jetty.project/releases/tag/jetty-9.4.40.v20210413>`__
 203
 204 * Karaf `4.3.1 → 4.3.2 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12349968>`__
 205
 206 * Netty `4.1.63 → 4.1.65 <https://netty.io/news/2021/05/19/4-1-65-Final.html>`__
 207
 208 Version 9.0.1
 209 -------------
 210 This is a minor upgrade from version 9.0.0.
 211
 212 Bug fixes
 213 ~~~~~~~~~
 214 The upgrade of ``duplicate-finder-maven-plugin`` ended up triggering build failures on ``.api_description``
 215 files packaged in artifacts. This regression has now been fixed.
 216
 217 Third-party dependencies
 218 ~~~~~~~~~~~~~~~~~~~~~~~~
 219 * Checkstyle `8.41 → 8.42 <https://checkstyle.org/releasenotes.html#Release_8.42>`__.
 220
 221 * Dropwizard Metrics 4.1.19 → 4.1.21, release notes:
 222   * `4.1.20 <https://github.com/dropwizard/metrics/releases/tag/v4.1.20>`__
 223   * `4.1.21 <https://github.com/dropwizard/metrics/releases/tag/v4.1.21>`__
 224
 225 * LMAX Disruptor 3.4.2 → 3.4.4, release notes:
 226   * `3.4.3 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.4.3>`__
 227   * `3.4.3 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.4.4>`__
 228
 229 * Woodstox `6.2.5 → 6.2.6 <https://github.com/FasterXML/woodstox/milestone/23?closed=1>`__
 230
 231 * XBean finder `4.18 → 4.19 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310312&version=12348824>`__
 232
 233 Plugin upgrades
 234 ~~~~~~~~~~~~~~~
 235 * maven-bundle-plugin 4.2.1 → 5.1.2, release notes:
 236   * `5.1.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310100&version=12346016>`__
 237   * `5.1.2 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310100&version=12350026>`__
 238
 239 Version 9.0.0
 240 -------------
 241 This is a major upgrade from version 8, with breaking changes; downstream projects may need to make changes to upgrade
 242 to this version.
 243
 244 Upstream version removals
 245 ~~~~~~~~~~~~~~~~~~~~~~~~~
 246 The following upstream dependencies have been removed from dependency management:
 247
 248 * ``javax.inject:javax.inject``. This dependency should be provided by target runtime. Furthermore we provide the same
 249   functionality via ``com.guicedee.services:javax.inject``, which is properly declared and is a JPMS module. See
 250   `ODLPARENT-246 <https://jira.opendaylight.org/browse/ODLPARENT-246>`__ for more information.
 251
 252 Improvements
 253 ~~~~~~~~~~~~
 254 * The configuration of ``maven-compiler-plugin`` has been updated to expand ``javac`` warning options to include almost
 255   all of them.
 256 * The default description in parent ``pom.xml`` has been updated to only include ``${project.artifactId}``, not a generic
 257   blurb. See `ODLPARENT-244 <https://jira.opendaylight.org/browse/ODLPARENT-244>`__ for more information.
 258 * The ``single-feature-test`` substrate has been updated to allow Java Flight Recorder to be enabled during testing runs.
 259   This feature has falled into disrepair as the JFR facility has been productized.
 260 * Configuration of various components has been updated to be deactivated when executing with JDK versions newer than 11,
 261   so that odlparent infrastructure works out of the box with JDK 16, albeit sacrificing some validation. Most notably
 262   ``SpotBugs`` and ``Single Feature Test`` are disabled, with corresponding notices displayed.
 263 * We now expose the ability to check dependency declaration consistency via ``maven-dependency-plugin``'s ``analyze-only``
 264   goal. This functionality is enabled by default, but does not cause the build to fail when inconsistencies are found. It
 265   can be disabled by on a per-artifact basis by definining ``odlparent.dependency.skip`` property to ``true``. It can also
 266   be configured to fail the build on a per-artifact basis by defining ``odlparent.dependency.enforce`` property to ``true``.
 267
 268 Third-party dependencies
 269 ~~~~~~~~~~~~~~~~~~~~~~~~
 270 * Antlr 4.8-1 → 4.9.2, release notes:
 271   * `4.9 <https://github.com/antlr/antlr4/releases/tag/4.9>`__
 272   * `4.9.1 <https://github.com/antlr/antlr4/releases/tag/4.9.1>`__
 273   * `4.9.2 <https://github.com/antlr/antlr4/releases/tag/4.9.2>`__
 274
 275 * Checkstyle 8.39.0 → 8.41.1, release notes:
 276   * `8.40.0 <https://checkstyle.org/releasenotes.html#Release_8.40.0>`__
 277   * `8.41.0 <https://checkstyle.org/releasenotes.html#Release_8.41.0>`__
 278   * `8.41.1 <https://checkstyle.org/releasenotes.html#Release_8.41.1>`__
 279
 280 * commons-lang3 `3.11 → 3.12 <https://commons.apache.org/proper/commons-lang/changes-report.html#a3.12>`__
 281
 282 * Dropwizard Metrics 4.1.12.1 → 4.1.19, release notes:
 283   * `4.1.13 <https://github.com/dropwizard/metrics/releases/tag/v4.1.13>`__
 284   * `4.1.14 <https://github.com/dropwizard/metrics/releases/tag/v4.1.14>`__
 285   * `4.1.15 <https://github.com/dropwizard/metrics/releases/tag/v4.1.15>`__
 286   * `4.1.16 <https://github.com/dropwizard/metrics/releases/tag/v4.1.16>`__
 287   * `4.1.17 <https://github.com/dropwizard/metrics/releases/tag/v4.1.17>`__
 288   * `4.1.18 <https://github.com/dropwizard/metrics/releases/tag/v4.1.18>`__
 289   * `4.1.19 <https://github.com/dropwizard/metrics/releases/tag/v4.1.19>`__
 290
 291 * Enunciate `2.13.2 → 2.13.3 <https://github.com/stoicflame/enunciate/releases/tag/v2.13.3>`__
 292
 293 * Google Truth 1.1 → 1.1.2, release notes:
 294   * `1.1.1 <https://github.com/google/truth/releases/tag/release_1_1_1>`__
 295   * `1.1.2 <https://github.com/google/truth/releases/tag/release_1_1_2>`__
 296
 297 * Guava 29.0 → 30.1.1, release notes:
 298   * `30.0 <https://github.com/google/guava/releases/tag/v30.0>`__
 299   * `30.1 <https://github.com/google/guava/releases/tag/v30.1>`__
 300   * `30.1.1 <https://github.com/google/guava/releases/tag/v30.1.1>`__
 301
 302 * JUnit `4.13.1 → 4.13.2 <https://github.com/junit-team/junit4/blob/HEAD/doc/ReleaseNotes4.13.2.md>`__
 303
 304 * Karaf `4.3.0 → 4.3.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12348818>`__
 305
 306 * Log4J 2.13.3 → 2.14.1, release notes:
 307   * `2.14.0 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.14.0>`__
 308   * `2.14.1 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.14.1>`__
 309
 310 * Netty 4.1.59 → 4.1.63, release notes:
 311   * `4.1.60 <https://netty.io/news/2021/03/09/4-1-60-Final.html>`__
 312   * `4.1.61 <https://netty.io/news/2021/03/30/4-1-61-Final.html>`__
 313   * `4.1.62 <https://netty.io/news/2021/03/31/4-1-62-Final.html>`__
 314   * `4.1.63 <https://netty.io/news/2021/04/01/4-1-63-Final.html>`__
 315
 316 * Sevntu `1.38.0 → 1.39.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.39.0>`__
 317
 318 * ThreeTen `1.5.0 → 1.6.0 <https://www.threeten.org/threeten-extra/changes-report.html#a1.6.0>`__
 319
 320 * Woodstox `6.2.4 → 6.2.5 <https://github.com/FasterXML/woodstox/milestone/22?closed=1>`__
 321
 322 * Xtend `2.24.0 → 2.25.0 <https://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2021/03/02/version-2-25-0>`__
 323
 324 Plugin upgrades
 325 ~~~~~~~~~~~~~~~
 326 * Asciidoctor 1.5.7.1 → 2.1.0 (with related AsciidoctorJ upgrades)
 327   * `2.0.0 <https://github.com/asciidoctor/asciidoctor-maven-plugin/releases/tag/asciidoctor-maven-plugin-2.0.0>`__
 328   * `2.1.0 <https://github.com/asciidoctor/asciidoctor-maven-plugin/releases/tag/asciidoctor-maven-plugin-2.1.0>`__
 329
 330 * git-commit-id-plugin 3.0.1 → 4.0.4, release notes:
 331   * `4.0.0 <https://github.com/git-commit-id/git-commit-id-maven-plugin/releases/tag/v4.0.0>`__
 332   * `4.0.1 <https://github.com/git-commit-id/git-commit-id-maven-plugin/releases/tag/v4.0.1>`__
 333   * `4.0.2 <https://github.com/git-commit-id/git-commit-id-maven-plugin/releases/tag/v4.0.2>`__
 334   * `4.0.3 <https://github.com/git-commit-id/git-commit-id-maven-plugin/releases/tag/v4.0.3>`__
 335   * `4.0.4 <https://github.com/git-commit-id/git-commit-id-maven-plugin/releases/tag/v4.0.4>`__
 336
 337 * modernizer-maven-plugin `2.1.0 → 2.2.0 <https://github.com/gaul/modernizer-maven-plugin/releases/tag/modernizer-maven-plugin-2.2.0>`__
 338
 339 Version 8.1.1
 340 -------------
 341 This is a minor upgrade from version 8.1.0.
 342
 343 Improvements
 344 ~~~~~~~~~~~~
 345 * Support for building a `static Karaf distribution <https://karaf.apache.org/manual/latest/#_instances_and_distributions_goals>`__
 346   has been added. It is driven by a new parent pom.xml, ``karaf-dist-static``. For more information
 347   see Karaf documentation and `ODLPARENT-251 <https://jira.opendaylight.org/browse/ODLPARENT-251>`__.
 348 * Support for `improved documentation tags <https://bugs.openjdk.java.net/browse/JDK-8068562>`__ has
 349   been added to default ``maven-javadoc-plugin`` configuration. See
 350   `ODLPARENT-252 <https://jira.opendaylight.org/browse/ODLPARENT-252>`__ for more information.
 351 * Version declaration for ``osgi.annotation`` has been added.
 352
 353 Third-party dependencies
 354 ~~~~~~~~~~~~~~~~~~~~~~~~
 355 * commons-net `3.7.2 → 3.8.0 <https://commons.apache.org/proper/commons-net/changes-report.html#a3.8.0>`__
 356
 357 * Netty `4.1.58 → 4.1.59 <https://netty.io/news/2021/02/08/4-1-59-Final.html>`__
 358
 359 * Woodstox `6.2.3 → 6.2.4 <https://github.com/FasterXML/woodstox/milestone/21?closed=1>`__
 360
 361 Plugin upgrades
 362 ~~~~~~~~~~~~~~~
 363 * maven-checkstyle-plugin `3.1.1 → 3.1.2 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317223&version=12347024>`__
 364
 365 * maven-invoker-plugin `3.2.1 → 3.2.2 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317525&version=12346157>`__
 366
 367 Version 8.1.0
 368 -------------
 369 This is a minor upgrade from version 8.0.1, with some potentially-breaking
 370 changes.
 371
 372 The most prominent is the upgrade to Karaf 4.3.0, which brings in a host of
 373 updates to related components -- including OSGi Release 7 and Jackson 2.11.x.
 374
 375 Feature updates
 376 ~~~~~~~~~~~~~~~
 377 * The ``odl-jackson-2.10`` feature and artifact were renamed to ``odl-jackson-2.11``
 378   to reflect the bump in Jackson version.
 379
 380 Third-party dependencies
 381 ~~~~~~~~~~~~~~~~~~~~~~~~
 382 * Bouncy Castle `1.66 → 1.68 <https://www.bouncycastle.org/releasenotes.html>`__
 383
 384 * Checkstyle 8.36.1 → 8.39.0, release notes:
 385   * `8.36.2 <https://checkstyle.org/releasenotes.html#Release_8.36.2>`__
 386   * `8.37.0 <https://checkstyle.org/releasenotes.html#Release_8.37.0>`__
 387   * `8.38.0 <https://checkstyle.org/releasenotes.html#Release_8.38.0>`__
 388   * `8.39.0 <https://checkstyle.org/releasenotes.html#Release_8.39.0>`__
 389
 390 * commons-net 3.7 → 3.7.2, release notes:
 391   * `3.7.1 <https://commons.apache.org/proper/commons-net/changes-report.html#a3.7.1>`__
 392   * `3.7.2 <https://commons.apache.org/proper/commons-net/changes-report.html#a3.7.2>`__
 393
 394 * enunciate `2.13.1 → 2.13.2 <https://github.com/stoicflame/enunciate/releases/tag/v2.13.2>`__
 395
 396 * Jackson 2.10.5 → 2.11.4, release notes:
 397   * `2.11.0 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.11>`__
 398   * `2.11.1 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.11.1>`__
 399   * `2.11.2 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.11.2>`__
 400   * `2.11.3 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.11.3>`__
 401   * `2.11.4 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.11.4>`__
 402
 403 * Karaf `4.2.10 → 4.3.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12343304>`__
 404
 405 * Netty 4.1.53 → 4.1.58, release notes:
 406   * `4.1.54 <https://netty.io/news/2020/11/11/4-1-54-Final.html>`__
 407   * `4.1.55 <https://netty.io/news/2020/12/08/4-1-55-Final.html>`__
 408   * `4.1.56 <https://netty.io/news/2020/12/17/4-1-56-Final.html>`__
 409   * `4.1.57 <https://netty.io/news/2021/01/12/4-1-57-Final.html>`__
 410   * `4.1.58 <https://netty.io/news/2021/01/13/4-1-58-Final.html>`__
 411
 412 * Google Truth `1.0.1 → 1.1 <https://github.com/google/truth/releases/tag/release_1_1>`__
 413
 414 * Powermock 2.0.7 → 2.0.9, release notes:
 415   * `2.0.8 <https://github.com/powermock/powermock/blob/release/2.x/docs/release-notes/official.md#208>`__
 416   * `2.0.9 <https://github.com/powermock/powermock/blob/release/2.x/docs/release-notes/official.md#209>`__
 417
 418 * Sevntu `1.37.1 → 1.38.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.38.0>`__
 419
 420 * XBean finder `4.17 → 4.18 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310312&version=12348171>`__
 421
 422 * xmlunit 2.7.0 → 2.8.2, release notes:
 423   * `2.8.0 <https://github.com/xmlunit/xmlunit/releases/tag/v2.8.0>`__
 424   * `2.8.1 <https://github.com/xmlunit/xmlunit/releases/tag/v2.8.1>`__
 425   * `2.8.2 <https://github.com/xmlunit/xmlunit/releases/tag/v2.8.2>`__
 426
 427 * Xtend `2.23.0 → 2.24.0 <https://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2020/12/01/version-2-24-0>`__
 428
 429 Plugin upgrades
 430 ~~~~~~~~~~~~~~~
 431 * build-helper-maven-plugin `3.1.0 → 3.2.0 <https://github.com/mojohaus/build-helper-maven-plugin/issues?q=is%3Aissue+milestone%3A3.1.0+is%3Aclosed>`__
 432
 433 * duplicate-finder-maven-plugin `1.4.0 → 1.5.0 <https://github.com/basepom/duplicate-finder-maven-plugin/releases/tag/duplicate-finder-maven-plugin-1.5.0>`__
 434
 435 * exec-maven-plugin `1.6.0 → 3.0.0 <https://github.com/mojohaus/exec-maven-plugin/releases/tag/exec-maven-plugin-3.0.0>`__
 436
 437 * maven-pmd-plugin `3.13.0 → 3.14.0 <https://www.mail-archive.com/announce@maven.apache.org/msg00978.html>`__
 438
 439 * maven-resource-plugin `3.9.0 → 3.9.1 <https://www.mail-archive.com/announce@maven.apache.org/msg00972.html>`__
 440
 441 * maven-site-plugin `3.9.0 → 3.9.1 <https://www.mail-archive.com/announce@maven.apache.org/msg00966.html>`__
 442
 443 * versions-maven-plugin `2.7 → 2.8.1 <https://github.com/mojohaus/versions-maven-plugin/releases/tag/versions-maven-plugin-2.8.1>`__
 444
 445
 446 Version 8.0.1
 447 -------------
 448 This is a minor big-fix/enhancement update from verision 8.0.0.
 449
 450 Improvements
 451 ~~~~~~~~~~~~
 452 * ``javax.inject`` is now provided by the artifact from `GuicedEE <https://guicedee.com/>`__.
 453   This improves things a lot, as it is a proper jar (not MANIFEST.MF warning), it also is
 454   a JPMS module, hence can be used for linkage. This dependency is properly ``scope=provided``,
 455   so it should not leak into runtimes where it should not be.
 456   See `ODLPARENT-247 <https://jira.opendaylight.org/browse/ODLPARENT-247>`__ for details.
 457
 458 * Transitive dependencies of Guava are now mostly filtered from runtime, so that we do not
 459   require ``wrap`` for them. We still retain checker-qual, as we are actively using those
 460   and it is a proper bundle.
 461   See `ODLPARENT-248 <https://jira.opendaylight.org/browse/ODLPARENT-248>`__ for details.
 462
 463 Third-party dependencies
 464 ~~~~~~~~~~~~~~~~~~~~~~~~
 465 * Jackson `2.10.4 → 2.10.5 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.10.5>`__
 466
 467 * JaCoCo `0.8.5 → 0.8.6 <https://github.com/jacoco/jacoco/releases/tag/v0.8.6>`__
 468
 469 * JUnit `4.13.0 → 4.13.1 <https://github.com/junit-team/junit4/blob/HEAD/doc/ReleaseNotes4.13.1.md>`__
 470
 471 * Karaf `4.2.9 → 4.2.10 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12348288>`__
 472
 473 * Netty `4.1.52 → 4.1.53 <https://netty.io/news/2020/10/13/4-1-53-Final.html>`__
 474
 475 * Pax-Exam `4.13.3 → 4.13.4 <https://ops4j1.jira.com/secure/ReleaseNote.jspa?projectId=10170&version=24393>`__
 476
 477 * Woodstox 6.2.1 → 6.2.3, fixed issues:
 478   * `6.2.2 <https://github.com/FasterXML/woodstox/issues/112>`__
 479   * `6.2.3 <https://github.com/FasterXML/woodstox/issues/117>`__
 480
 481
 482 Version 8.0.0
 483 -------------
 484 This is a major upgrade from version 7, with breaking changes; downstream projects may need to make changes to upgrade
 485 to this version.
 486
 487 Improvements
 488 ~~~~~~~~~~~~
 489 * ``modernizer-maven-plugin`` configuration has been updated to issue warnings for constructs
 490   improved in all Java versions up to and including Java 11.
 491
 492 * ``modernizer-maven-plugin`` is configured by default to fail the build when it issues any
 493   warnings. This behavior can be opted-out of on a per-artifact basis by defining
 494   ``odlparent.modernizer.enforce`` property to ``false``.
 495
 496 Upstream version removals
 497 ~~~~~~~~~~~~~~~~~~~~~~~~~
 498 The following upstream dependencies have been removed from dependency management:
 499
 500 * ``javax.json``. This dependency is used only in Neutron project, hence this version is best
 501   maintained there. See `ODLPARENT-238 <https://jira.opendaylight.org/browse/ODLPARENT-238>`__
 502   for details.
 503
 504 * All ``org.eclipse.persistence`` artifacts. These dependencies are only used in Neutron,
 505   which actually duplicates the declarations, hence they are best maintained there.
 506   See `ODLPARENT-237 <https://jira.opendaylight.org/browse/ODLPARENT-237>`__ for details.
 507
 508 * All ``org.apache.sshd`` and ``net.i2p.crypto`` artifacts. Overriding versions does not play
 509   nice with Karaf's versions during ``feature:install``, causing issues when the installing
 510   over an SSH connection. NETCONF project is providing a repackaged version in OpenDaylight
 511   namespace. See `ODLPARENT-233 <https://jira.opendaylight.org/browse/ODLPARENT-233>`__ for
 512   details.
 513
 514 * ``jettison``. This dependency is used only in LISP Flow Mapping project for integration
 515   tests, hence this version is best maintained there.
 516   See `ODLPARENT-239 <https://jira.opendaylight.org/browse/ODLPARENT-239>`__ for details.
 517
 518 * All ``com.typesafe``, ``io.aeron``, ``org.agrona``, ``org.scala-lang`` declarations. Akka is
 519   removing their support for OSGi, with no working releases in their current ``2.6.x.`` branch.
 520   Since dealing with these requires quite a bit of dance, which needs to sit outside of odlparent POM,
 521   the controller project will package Akka to the extent it needs.
 522   See `ODLPARENT-243 <https://jira.opendaylight.org/browse/ODLPARENT-243>`__ for details.
 523
 524 * ``org.apache.felix.dependencymanager`` and ``org.apache.felix.dependencymanager.shell``. These
 525   components are ancient, having been replaced by either Blueprint or Declarative Services. The only
 526   project using these is AAA, hence it is best to maintain these declarations there.
 527
 528 Feature removals
 529 ~~~~~~~~~~~~~~~~
 530 * ``odl-apache-sshd`` feature has been removed, mirroring the removal of related dependency
 531   declarations. See `ODLPARENT-233 <https://jira.opendaylight.org/browse/ODLPARENT-233>`__ for details.
 532
 533 * ``odl-akka-all``, ``odl-akka-scala-2.13``, ``odl-akka-system-2.5``, ``odl-akka-clustering-2.5``
 534   and ``odl-akka-persistence-2.5`` features. mirroring the removal of related dependency declarations.
 535   See `ODLPARENT-243 <https://jira.opendaylight.org/browse/ODLPARENT-243>`__ for details.
 536
 537 Third-party dependencies
 538 ~~~~~~~~~~~~~~~~~~~~~~~~
 539 * awaitility `3.0.0 → 4.0.3 <https://github.com/awaitility/awaitility/wiki/ReleaseNotes40>`__
 540
 541 * checkstyle 8.34 → 8.36.1, release notes:
 542   * `8.35 <https://checkstyle.org/releasenotes.html#Release_8.35>`__
 543   * `8.36 <https://checkstyle.org/releasenotes.html#Release_8.36>`__
 544   * `8.36.1 <https://checkstyle.org/releasenotes.html#Release_8.36.1>`__
 545
 546 * commons-codec `1.14 → 1.15 <https://commons.apache.org/proper/commons-codec/changes-report.html#a1.15>`__
 547
 548 * commons-io `2.7 → 2.8.0 <https://commons.apache.org/proper/commons-io/changes-report.html#a2.8.0>`__
 549
 550 * commons-net `3.6 → 3.7 <https://commons.apache.org/proper/commons-net/changes-report.html#a3.7>`__
 551
 552 * dropwizard-metrics 4.1.9 → 4.1.12.1, release notes:
 553   * `4.1.10 <https://github.com/dropwizard/metrics/releases/tag/v4.1.10>`__
 554   * `4.1.10.1 <https://github.com/dropwizard/metrics/releases/tag/v4.1.10.1>`__
 555   * `4.1.11 <https://github.com/dropwizard/metrics/releases/tag/v4.1.11>`__
 556   * `4.1.12 <https://github.com/dropwizard/metrics/releases/tag/v4.1.12>`__
 557   * `4.1.12.1 <https://github.com/dropwizard/metrics/releases/tag/v4.1.12.1>`__
 558
 559 * Guava `28.2 → 29.0 <https://github.com/google/guava/releases/tag/v29.0>`__
 560
 561 * immutables.org → 2.8.8, release notes:
 562   * `2.8.0 <https://github.com/immutables/immutables/releases/tag/2.8.0>`__
 563   * `2.8.1 <https://github.com/immutables/immutables/releases/tag/2.8.1>`__
 564   * `2.8.2 <https://github.com/immutables/immutables/releases/tag/2.8.2>`__
 565   * `2.8.3 <https://github.com/immutables/immutables/releases/tag/2.8.3>`__
 566   * `2.8.4 <https://github.com/immutables/immutables/releases/tag/2.8.4>`__
 567   * `2.8.8 <https://github.com/immutables/immutables/releases/tag/2.8.8>`__
 568
 569 * mockito `3.3.3 → 3.5.11 <https://github.com/mockito/mockito/blob/release/3.x/doc/release-notes/official.md>`__
 570
 571 * Netty `4.1.51 → 4.1.52 <https://netty.io/news/2020/09/08/4-1-52-Final.html>`__
 572
 573 * Xtend `2.22.0 → 2.23.0 <https://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2020/09/01/version-2-23-0>`__
 574
 575 Plugin upgrades
 576 ~~~~~~~~~~~~~~~
 577 * maven-archetype-plugin `3.1.2 → 3.2.0 <https://blogs.apache.org/maven/entry/apache-maven-archetype-plugin-version1>`__
 578
 579 * project-info-reports-plugin `3.1.0 → 3.1.1 <https://blogs.apache.org/maven/entry/apache-maven-project-info-reports1>`__
 580
 581 Version 7.0.5
 582 -------------
 583 This is a bug-fix upgrade from version 7.0.4.
 584
 585 Bug fixes
 586 ~~~~~~~~~
 587 * ``odl-netty-4`` feature definition specified both ``x86_64`` and ``aarch64`` artifacts
 588   for ``netty-native-epoll``. This actually results only in ``aarch64`` package being
 589   installed, rendering epoll unavailable on ``x86_64`` architecture. This has been corrected
 590   by removing the ``aarch64`` package.
 591   See `ODLPARENT-240 <https://jira.opendaylight.org/browse/ODLPARENT-240>`__ for details.
 592
 593 Version 7.0.4
 594 -------------
 595 This is a security/bug-fix upgrade from version 7.0.3.
 596
 597 Bug fixes
 598 ~~~~~~~~~
 599 * ``Single Feature Test`` setup of the JVM for Karaf container ended up using
 600   wrong versions of Karaf components, leading to a failure to initialize
 601   OSGiLocator and subsequent warnings with stack traces. This has now been
 602   corrected.
 603   See `ODLPARENT-228 <https://jira.opendaylight.org/browse/ODLPARENT-228>`__ for details.
 604 * Pax-Exam setup interacts badly with pipes used by maven-surefire plugin,
 605   leading to pauses lasting around 30 seconds after SFT test success.
 606   This has now been worked around by using maven-surefire-plugin version 3.0.0-M5,
 607   with TCP sockets used for communication.
 608   See `ODLPARENT-179 <https://jira.opendaylight.org/browse/ODLPARENT-179>`__ for details.
 609 * Our Jersey dependency was held back on version 2.25.1 during Neon upgrade cycle, mostly
 610   due to large-scale incompatibilities around JAX-RS version. We have upgraded to Karaf-4.2.8+,
 611   which pulls in JAX-RS 2.1, hence re-aligning to a more modern version, 2.27, is now
 612   feasible.
 613   See `ODLPARENT-208 <https://jira.opendaylight.org/browse/ODLPARENT-208>`__ for details.
 614
 615 Third-party dependencies
 616 ~~~~~~~~~~~~~~~~~~~~~~~~
 617 * Bouncy Castle `1.65 → 1.66 <https://www.bouncycastle.org/releasenotes.html>`__
 618
 619 * Checkstyle 8.32 → 8.34, release notes:
 620   * `8.33 <https://checkstyle.org/releasenotes.html#Release_8.33>`__
 621   * `8.34 <https://checkstyle.org/releasenotes.html#Release_8.34>`__
 622
 623 * commons-io `2.6 → 2.7 <https://commons.apache.org/proper/commons-io/changes-report.html#a2.7>`__
 624
 625 * Jersey 2.25.1 → 2.27, release notes:
 626   * `2.26 <https://eclipse-ee4j.github.io/jersey.github.io/release-notes/2.26.html>`__
 627   * `2.27 <https://eclipse-ee4j.github.io/jersey.github.io/release-notes/2.27.html>`__
 628
 629 * Karaf `4.2.8 → 4.2.9, with related upgrades <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12345539>`__
 630
 631 * Netty 4.1.49 → 4.1.51, release notes:
 632   * `4.1.50 <https://netty.io/news/2020/05/13/4-1-50-Final.html>`__
 633   * `4.1.51 <https://netty.io/news/2020/07/09/4-1-51-Final.html>`__
 634
 635 * Scala `2.13.2 → 2.13.3 <https://github.com/scala/scala/releases/tag/v2.13.3>`__
 636
 637 * TrieMap `1.1.0 → 1.2.0 <https://github.com/PANTHEONtech/triemap/releases/tag/triemap-1.2.0>`__
 638
 639 * XBean finder 4.14 → 4.17, release notes:
 640   * `4.15 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310312&version=12345583>`__
 641   * `4.16 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310312&version=12345584>`__
 642   * `4.17 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310312&version=12346905>`__
 643
 644 Plugin upgrades
 645 ~~~~~~~~~~~~~~~
 646 * maven-project-info-reports-plugin `3.0.0 → 3.1.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317821&version=12346620>`__.
 647
 648 * maven-shade-plugin `3.2.3 → 3.2.4 <https://blogs.apache.org/maven/entry/apache-maven-shade-plugin-version5>`__
 649
 650 Version 7.0.3
 651 -------------
 652 This is a security/bug-fix upgrade from version 7.0.2. Changes in this release
 653 pertain strictly to Karaf packaging and do not affect other runtimes.
 654
 655 Bug fixes
 656 ~~~~~~~~~
 657 * Felix SCR 2.1.16, as shipping before Karaf-4.2.9, contains a bug, which could
 658   lead to NullPointerException being thrown when components were examined. This
 659   has been rectified via upgrade to Felix SCR 2.1.20.
 660   See `ODLPARENT-236 <https://jira.opendaylight.org/browse/ODLPARENT-236>`__ for details.
 661 * Karaf-4.2.8 changed packaged log4j2 version, rendering the configuration supplied
 662   with ``ODLPARENT-231`` inconsistent. This has led to a warning being printed in the
 663   Karaf console on each startup. This has now been corrected.
 664 * Karaf-4.2.8 is packaging pax-logging-1.11.4, which embeds a a vulnerable version
 665   of log4j2 (2.3.0). This would render the upgrades delivered in version 7.0.2
 666   ineffective at runtime, potentially leading to exposure. This has been corrected
 667   with upgrade of pax-logging to 1.11.6, which is packaging log4j2-2.3.2.
 668
 669 Version 7.0.2
 670 -------------
 671 This is a security/bug-fix upgrade from version 7.0.1.
 672
 673 Improvements
 674 ~~~~~~~~~~~~
 675 * Infrastructure for identifying confidential log messages was added, along with
 676   Karaf configuration update to routing such messages into a separate log file.
 677   See `ODLPARENT-231 <https://jira.opendaylight.org/browse/ODLPARENT-231>`__ for details.
 678
 679 * Netty has been disconnected from Javassist way back in its 4.1.9 release, but
 680   we failed to notice. This has now been rectified by ``odl-netty-4`` not depending
 681   on ``odl-javassist-3``.
 682
 683 Third-party dependencies
 684 ~~~~~~~~~~~~~~~~~~~~~~~~
 685 * Checkstyle `8.31 → 8.32 <https://checkstyle.org/releasenotes.html#Release_8.32>`__
 686
 687 * Dropwizard Metrics 4.1.5 → 4.1.9, release notes:
 688   * `4.1.6 <https://github.com/dropwizard/metrics/releases/tag/v4.1.6>`__
 689   * `4.1.7 <https://github.com/dropwizard/metrics/releases/tag/v4.1.7>`__
 690   * `4.1.8 <https://github.com/dropwizard/metrics/releases/tag/v4.1.8>`__
 691   * `4.1.9 <https://github.com/dropwizard/metrics/releases/tag/v4.1.9>`__
 692
 693 * Enunciate 2.12.1 → 2.13.1, release notes:
 694   * `2.13.0 <https://github.com/stoicflame/enunciate/releases/tag/v2.13.0>`__
 695   * `2.13.1 <https://github.com/stoicflame/enunciate/releases/tag/v2.13.1>`__
 696
 697 * Jackson 2.10.2 → 2.10.4, release notes:
 698   * `2.10.3 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.10.3>`__
 699   * `2.10.4 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.10.4>`__
 700
 701 * log4j2 2.13.1 → 2.13.3, release notes:
 702   * `2.13.2 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.13.2>`__
 703   * `2.13.3 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.13.3>`__
 704
 705 * Netty `4.1.48 → 4.1.49 <https://netty.io/news/2020/02/28/4-1-46-Final.html>`__
 706
 707 * Powermock `2.0.6 → 2.0.7 <https://github.com/powermock/powermock/blob/release/2.x/docs/release-notes/official.md#207>`__
 708
 709 * Scala `2.13.1 → 2.13.2 <https://github.com/scala/scala/releases/tag/v2.13.2>`__
 710
 711 * Woodstox 6.1.1 → 6.2.1, release notes:
 712   * `6.2.0 <https://github.com/FasterXML/woodstox/wiki/Woodstox-Release-6.2#620-25-apr-2020>`__
 713   * `6.2.1 <https://github.com/FasterXML/woodstox/wiki/Woodstox-Release-6.2#621-13-may-2020>`__
 714
 715 * xmlunit 2.6.3 → 2.7.0, release notes:
 716   * `2.6.4 <https://github.com/xmlunit/xmlunit/releases/tag/v2.6.4>`__
 717   * `2.7.0 <https://github.com/xmlunit/xmlunit/releases/tag/v2.7.0>`__
 718
 719 Plugin upgrades
 720 ~~~~~~~~~~~~~~~
 721 * builder-helper-maven-plugin `3.0.0 → 3.1.0 <https://github.com/mojohaus/build-helper-maven-plugin/issues?q=is%3Aissue+milestone%3A3.1.0+is%3Aclosed>`__
 722
 723 * duplicate-finder-maven-plugin `1.3.0 → 1.4.0 <https://github.com/basepom/duplicate-finder-maven-plugin/releases/tag/duplicate-finder-maven-plugin-1.4.0>`__
 724
 725 * maven-antrun-plugin `1.8 → 3.0.0 <https://blogs.apache.org/maven/entry/apache-maven-antrun-plugin-version>`__
 726
 727 * maven-assembly-plugin `3.2.0 → 3.3.0 <https://blogs.apache.org/maven/entry/apache-maven-assembly-plugin-version1>`__
 728
 729 * maven-invoker-plugin `3.2.0 → 3.2.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317525&version=12344863>`__
 730
 731 * maven-remote-resources-plugin `1.6.0 → 1.7.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317825&version=12331232>`__
 732
 733 * maven-shade-plugin `3.2.2 → 3.2.3 <https://blogs.apache.org/maven/entry/apache-maven-shade-plugin-version4>`__
 734
 735 Version 7.0.1
 736 -------------
 737 This is a bug-fix upgrade from version 7.0.0.
 738
 739 Bug fixes
 740 ~~~~~~~~~
 741 * Upgrade of ``maven-javadoc-plugin`` is causing issues in downstream javadoc jobs and therefore it has been reverted.
 742   See `ODLPARENT-229 <https://jira.opendaylight.org/browse/ODLPARENT-229>`__ for details.
 743
 744 Third-party dependencies
 745 ~~~~~~~~~~~~~~~~~~~~~~~~
 746 * Akka `2.5.30 → 2.5.31 <https://akka.io/blog/news/2020/03/31/akka-2.5.31-released>`__
 747
 748 * Bouncy Castle `1.64 → 1.65 <https://www.bouncycastle.org/releasenotes.html>`__
 749
 750 * Checkstyle `8.30 → 8.31 <https://checkstyle.org/releasenotes.html#Release_8.31>`__
 751
 752 * commons-lang3 `3.9 → 3.10 <https://commons.apache.org/proper/commons-lang/changes-report.html#a3.10>`__
 753
 754 * Xtend 1.19.0 → 1.21.0, release notes:
 755   * `1.20.0 <https://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2019/12/03/version-2-20-0>`__
 756   * `1.21.0 <https://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2020/03/03/version-2-21-0>`__
 757
 758 Version 7.0.0
 759 -------------
 760 This is a major upgrade from version 6, with breaking changes; downstream projects may need to make changes to upgrade
 761 to this version.
 762
 763 Property removals
 764 ~~~~~~~~~~~~~~~~~
 765 * ``enforcer.version`` and ``projectinfo`` properties were removed. These properties do not serve any legal purpose as
 766   the plugins referenced by them are declared in ``pluginManagement`` section.
 767
 768 Upstream version removals
 769 ~~~~~~~~~~~~~~~~~~~~~~~~~
 770 The following upstream dependencies have been removed from dependency management:
 771
 772 * ``immutables.org/value`` without ``<classifier>annotations</classifier>``
 773
 774 * ``javax.xml.bind/jaxb-api``, replaced with ``jakarta.xml.bind/jakarta.xml.bind-api``
 775
 776 * ``com.google.inject/guice``
 777
 778 * ``com.mycila.guice.extensions/mycila-guice-jsr250``
 779
 780 * ``org.apache.shiro/shiro-core``
 781
 782 * ``org.apache.shiro/shiro-web``
 783
 784 Feature removals
 785 ~~~~~~~~~~~~~~~~
 786 * ``odl-akka-leveldb-0.10`` feature was removed. This feature provided leveldb-backed implementation of Akka
 787   Persistence, which is not supported for production environments by upstream. Furthermore this feature relied on a
 788   custom-built binary, which we do not have a means to reproduce -- limiting our portability. The controller project,
 789   which is the only downstream user of persistence provides an alternative implementation, hence we are removing this
 790   historical baggage. See `ODLPARENT-213 <https://jira.opendaylight.org/browse/ODLPARENT-213>`__ for details.
 791
 792 * ``odl-caffeine-2`` feature was removed. This feature provided a ``JSR-107 JCache`` implementation, an API deemed to
 793   be problematic where high-performance and correctness in required.
 794
 795 New features
 796 ~~~~~~~~~~~~
 797 * OSGi R6 Declarative Services enabled in Karaf. The ``scr`` feature is now part of startup features, hence Service
 798   Component Runtime can be used without incurring an additional refresh.
 799   See `ODLPARENT-227 <https://jira.opendaylight.org/browse/ODLPARENT-227>`__ for details.
 800
 801 Third-party dependencies
 802 ~~~~~~~~~~~~~~~~~~~~~~~~
 803 * Akka `2.5.29 → 2.5.30 <https://akka.io/blog/news/2020/03/12/akka-2.5.30-released>`__
 804
 805 * antl4r `4.7.2 → 4.8-1 <https://github.com/antlr/antlr4/releases/tag/4.8>`__
 806
 807 * Asciidoctor `1.5.7.1 → 1.5.8 <https://github.com/asciidoctor/asciidoctor/releases/tag/v1.5.8>`__
 808
 809 * Checkstyle 8.26 → 8.30, release notes:
 810   * `8.27 <https://checkstyle.org/releasenotes.html#Release_8.27>`__
 811   * `8.28 <https://checkstyle.org/releasenotes.html#Release_8.28>`__
 812   * `8.29 <https://checkstyle.org/releasenotes.html#Release_8.29>`__
 813   * `8.30 <https://checkstyle.org/releasenotes.html#Release_8.30>`__
 814
 815 * Dropwizard Metrics 4.0.5 → 4.1.5, release notes:
 816   * `4.1.0-rc0 <https://github.com/dropwizard/metrics/releases/tag/v4.1.0-rc0>`__
 817   * `4.1.0-rc2 <https://github.com/dropwizard/metrics/releases/tag/v4.1.0-rc2>`__
 818   * `4.1.0-rc3 <https://github.com/dropwizard/metrics/releases/tag/v4.1.0-rc3>`__
 819   * `4.1.1 <https://github.com/dropwizard/metrics/releases/tag/v4.1.1>`__
 820   * `4.1.2 <https://github.com/dropwizard/metrics/releases/tag/v4.1.2>`__
 821   * `4.1.3 <https://github.com/dropwizard/metrics/releases/tag/v4.1.3>`__
 822   * `4.1.4 <https://github.com/dropwizard/metrics/releases/tag/v4.1.4>`__
 823
 824 * Google Truth 0.43 → 1.0.1, release notes:
 825   * `0.44 <https://github.com/google/truth/releases/tag/release_0_44>`__
 826   * `0.45 <https://github.com/google/truth/releases/tag/release_0_45>`__
 827   * `0.46 <https://github.com/google/truth/releases/tag/release_0_46>`__
 828   * `1.0-rc1 <https://github.com/google/truth/releases/tag/release_1_0_rc1>`__
 829   * `1.0-rc2 <https://github.com/google/truth/releases/tag/release_1_0_rc2>`__
 830   * `1.0 <https://github.com/google/truth/releases/tag/release_1_0>`__
 831   * `1.0.1 <https://github.com/google/truth/releases/tag/release_1_0_1>`__
 832
 833 * Guava 27.1 → 28.2, release notes:
 834   * `28.0 <https://github.com/google/guava/releases/tag/v28.0>`__
 835   * `28.1 <https://github.com/google/guava/releases/tag/v28.1>`__
 836   * `28.2 <https://github.com/google/guava/releases/tag/v28.2>`__
 837
 838 * Javassist 3.26.0 → 3.27.0
 839
 840 * jdt-annotations 2.2.100 → 2.2.400
 841
 842 * Karaf 4.2.6 → 4.2.8, with related upgrades, release notes:
 843   * `4.2.7 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12345539>`__
 844   * `4.2.8 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12346100>`__
 845
 846 * log4j2 `2.13.0 → 2.13.1 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.13.1>`__
 847
 848 * Netty 4.1.45 → 4.1.48, release notes:
 849   * `4.1.46 <https://netty.io/news/2020/02/28/4-1-46-Final.html>`__
 850   * `4.1.47 <https://netty.io/news/2020/03/09/4-1-47-Final.html>`__
 851   * `4.1.48 <https://netty.io/news/2020/03/17/4-1-48-Final.html>`__
 852
 853 * Powermock 2.0.4 → 2.0.6, release notes:
 854   * `2.0.5 <https://github.com/powermock/powermock/blob/release/2.x/docs/release-notes/official.md#205>`__
 855   * `2.0.6 <https://github.com/powermock/powermock/blob/release/2.x/docs/release-notes/official.md#206>`__
 856
 857 * Scala 2.12.10 → 2.13.1, release notes:
 858   * `2.13.0 <https://github.com/scala/scala/releases/tag/v2.13.0>`__
 859   * `2.13.1 <https://github.com/scala/scala/releases/tag/v2.13.1>`__
 860
 861 * scala-java8-compat 0.8.0 → 0.9.1, release notes:
 862   * `0.9.0 <https://github.com/scala/scala-java8-compat/releases/tag/v0.9.0>`__
 863   * `0.9.1 <https://github.com/scala/scala-java8-compat/releases/tag/v0.9.1>`__
 864
 865 * Sevntu 1.36.0 → 1.37.1, release notes:
 866   * `1.37.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.37.0>`__
 867   * `1.37.1 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.37.1>`__
 868
 869 * woodstox-core 5.3.0 → 6.1.1
 870
 871 Plugin upgrades
 872 ~~~~~~~~~~~~~~~
 873
 874 * findbugs-slf4j `1.4.0 → 1.5.0 <https://github.com/KengoTODA/findbugs-slf4j/blob/master/CHANGELOG.md#150---2019-07-04>`__
 875
 876 * maven-checkstyle-plugin `3.1.0 → 3.1.1 <https://blogs.apache.org/maven/entry/apache-maven-checkstyle-plugin-version1>`__
 877
 878 * maven-dependency-plugin `3.1.1 → 3.1.2 <https://blogs.apache.org/maven/entry/apache-maven-dependency-plugin-version2>`__
 879
 880 * maven-enforcer-plugin `3.0.0-M2 → 3.0.0-M3 <https://blogs.apache.org/maven/entry/apache-maven-enforcer-version-3>`__
 881
 882 * maven-javadoc-plugin `3.1.1 → 3.2.0 <https://blogs.apache.org/maven/entry/apache-maven-javadoc-plugin-version1>`__
 883
 884 * maven-shade-plugin `3.2.1 → 3.2.2 <https://blogs.apache.org/maven/entry/apache-maven-shade-plugin-version3>`__
 885
 886 * modernizer-maven-plugin `2.0.0 → 2.1.0 <https://github.com/gaul/modernizer-maven-plugin/releases/tag/modernizer-maven-plugin-2.1.0>`__
 887
 888 * pmd-maven-plugin `3.12.0 → 3.13.0 <https://blogs.apache.org/maven/entry/apache-maven-pmd-plugin-version2>`__
 889
 890 Version 6.0.5
 891 -------------
 892 This is a bug-fix upgrade from version 6.0.4.
 893
 894 Third-party dependencies
 895 ~~~~~~~~~~~~~~~~~~~~~~~~
 896 * Akka 2.5.26 → 2.5.29, release notes:
 897   * `2.5.27 <https://akka.io/blog/news/2019/12/10/akka-2.5.27-released>`__
 898   * `2.5.29 <https://akka.io/blog/news/2020/01/28/akka-2.5.29-released>`__
 899
 900 * commons-codec `1.13 → 1.14 <https://commons.apache.org/proper/commons-codec/changes-report.html#a1.14>`__
 901
 902 * Jackson `2.9.10 → 2.9.10.20200103 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9#micro-patches>`__
 903
 904 Plugin upgrades
 905 ~~~~~~~~~~~~~~~
 906 * maven-source-plugin `3.2.0 → 3.2.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317924&version=12346480>`__
 907
 908 Version 6.0.4
 909 -------------
 910 This is a bug-fix upgrade from version 6.0.3.
 911
 912 Bug fixes
 913 ~~~~~~~~~
 914 * ``single-feature-test`` was using outdated repositories, including Maven Central,
 915   which `broke on Jan 15, 2020 <https://support.sonatype.com/hc/en-us/articles/360041287334-Central-501-HTTPS-Required>`__.
 916   This has been corrected.
 917
 918 Third-party dependencies
 919 ~~~~~~~~~~~~~~~~~~~~~~~~
 920
 921 * JUnit 4.11 → 4.13, release notes:
 922   * `4.12 <https://github.com/junit-team/junit4/blob/master/doc/ReleaseNotes4.12.md>`__
 923   * `4.13 <https://github.com/junit-team/junit4/blob/master/doc/ReleaseNotes4.13.md>`__
 924
 925 * log4j2 2.11.2 → 2.13.0, release notes:
 926   * `2.12.0 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.13.0>`__
 927   * `2.12.1 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.12.1>`__
 928   * `2.13.0 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.13.0>`__
 929
 930 * netty 4.1.42 → 4.1.45, release notes:
 931   * `4.1.43 <https://netty.io/news/2019/10/24/4-1-43-Final.html>`__
 932   * `4.1.44 <https://netty.io/news/2019/12/18/4-1-44-Final.html>`__
 933   * `4.1.45 <https://netty.io/news/2020/01/13/4-1-45-Final.html>`__
 934
 935 Plugin upgrades
 936 ~~~~~~~~~~~~~~~
 937 * maven-assembly-plugin 2.2-beta5 → 3.2.0
 938
 939 * maven-archetype-plugin `3.1.1 → 3.1.2 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317122&version=12345957>`__
 940
 941 Version 6.0.3
 942 -------------
 943 This is a bug-fix upgrade from version 6.0.2.
 944
 945 Bug fixes
 946 ~~~~~~~~~
 947 * The fix for `ODLPARENT-216 <https://jira.opendaylight.org/browse/ODLPARENT-216>`__ ended up
 948   breaking ``org.kohsuke.metainf-services`` integration. While this could be fixed in downstreams
 949   by adding proper </annotationProcessorPaths> entry, it is a regression from 6.0.1.
 950
 951 Version 6.0.2
 952 -------------
 953 This is a security/bug-fix upgrade from version 6.0.1.
 954
 955 Bug fixes
 956 ~~~~~~~~~
 957 * ``single-feature-parent`` was setting up Karaf repositories incorrectly, leading to
 958   the test using unpatched Karaf resources. This has now been fixed and the test run
 959   is using environment equivalent to the contents of the distribution. See
 960   `ODLPARENT-209 <https://jira.opendaylight.org/browse/ODLPARENT-209>`__ for details.
 961
 962 * ``immutables.org`` integration relied on pre-JDK9 way of integration, where the annotation processor
 963   was just dropped as a dependency. This does not work with JDK9+ artifacts which are also explicit
 964   JMPS modules. Note that users are advised to switch to depending on the ``annotations``-classified
 965   artifact. See `ODLPARENT-216 <https://jira.opendaylight.org/browse/ODLPARENT-216>`__ for details.
 966
 967 * Assembled Karaf distribution did not perform proper JDK checks and allowed launching with JDK8,
 968   leading to a failure to install OpenDaylight components with an error stack, which confuses users
 969   not familiar with OSGi. The distribution now refuses to start with anything other than JDK11. See
 970   `ODLPARENT-218 <https://jira.opendaylight.org/browse/ODLPARENT-218>`__ for details.
 971
 972 Third-party dependencies
 973 ~~~~~~~~~~~~~~~~~~~~~~~~
 974
 975 * Akka `2.5.25 → 2.5.26 <https://akka.io/blog/news/2019/10/17/akka-2.5.26-released>`__
 976
 977 * Checkstyle 8.20 → 8.26, release notes:
 978   * `8.21 <https://checkstyle.org/releasenotes.html#Release_8.21>`__
 979   * `8.22 <https://checkstyle.org/releasenotes.html#Release_8.22>`__
 980   * `8.23 <https://checkstyle.org/releasenotes.html#Release_8.23>`__
 981   * `8.24 <https://checkstyle.org/releasenotes.html#Release_8.24>`__
 982   * `8.25 <https://checkstyle.org/releasenotes.html#Release_8.25>`__
 983   * `8.26 <https://checkstyle.org/releasenotes.html#Release_8.26>`__
 984
 985 * H2 database `1.4.199 → 1.4.200 <http://www.h2database.com/html/changelog.html>`__
 986
 987 * Hamcrest `2.1 → 2.2 <https://github.com/hamcrest/JavaHamcrest/releases/tag/v2.2>`__
 988
 989 * JaCoCo `0.8.4 → 0.8.5 <https://github.com/jacoco/jacoco/releases/tag/v0.8.5>`__
 990
 991 * Karaf 4.2.2 → 4.2.6, release notes:
 992   * `4.2.3 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12344587>`__
 993   * `4.2.4 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12344856>`__
 994   * `4.2.5 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12345153>`__
 995   * `4.2.6 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12345365>`__
 996
 997 * Powermock `2.0.2 → 2.0.4 <https://github.com/powermock/powermock/blob/release/2.x/docs/release-notes/official.md#204>`__
 998
 999 * Sevntu `1.35.0 → 1.36.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.36.0>`__
1000
1001 Plugin upgrades
1002 ~~~~~~~~~~~~~~~
1003
1004 * maven-bundle-plugin `4.1.0 → 4.2.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310100&version=12345491>`__
1005
1006 * maven-jar-plugin `3.1.2 → 3.2.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317526&version=12345503>`__
1007
1008 * maven-source-plugin `3.1.0 → 3.2.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317924&version=12345522>`__
1009
1010 * modernizer-maven-plugin `1.9.0 → 2.0.0 <https://github.com/gaul/modernizer-maven-plugin/releases/tag/modernizer-maven-plugin-2.0.0>`__
1011
1012 Version 6.0.1
1013 -------------
1014 This is a security/bug-fix upgrade from version 6.0.0.
1015
1016 Bug fixes
1017 ~~~~~~~~~
1018 * ``karaf-plugin`` ignored exceptions coming from its failure to resolve ${karaf.etc} variable. This
1019   has now been fixed and the URL handling has been revised to fix build on Windows. See
1020   `ODLPARENT-214 <https://jira.opendaylight.org/browse/ODLPARENT-214>`__ for details.
1021
1022 * ``leveldb-jni`` jar, which has been seeded to nexus.opendaylight.org long time ago is not published
1023   in Maven Central. This has been resolved by repackaging this jar and publishing it from odlparent.
1024   See `ODLPARENT-210 <https://jira.opendaylight.org/browse/ODLPARENT-210>`__ for details.
1025
1026 Third-party dependencies
1027 ~~~~~~~~~~~~~~~~~~~~~~~~
1028
1029 * Bouncy Castle `1.63 → 1.64 <http://www.bouncycastle.org/releasenotes.html>`__
1030
1031 * Jackson `2.9.9 → 2.9.10 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.10>`__
1032
1033 * Javassist 3.24.1-GA → 3.26.0-GA
1034
1035 * Guice 4.1.0 → 4.2.2, release notes:
1036   * `4.2.0 <https://github.com/google/guice/wiki/Guice42>`__
1037   * `4.2.1 <https://github.com/google/guice/wiki/Guice421>`__
1038   * `4.2.2 <https://github.com/google/guice/wiki/Guice422>`__
1039
1040 * Mockito 2.25.1 → 2.28.2, release notes:
1041   * `2.25.2 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2252>`__
1042   * `2.25.3 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2253>`__
1043   * `2.25.4 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2254>`__
1044   * `2.25.5 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2255>`__
1045   * `2.25.6 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2256>`__
1046   * `2.25.7 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2257>`__
1047   * `2.26.1 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2261>`__
1048   * `2.26.2 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2262>`__
1049   * `2.27.1 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2271>`__
1050   * `2.27.2 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2272>`__
1051   * `2.27.3 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2273>`__
1052   * `2.27.4 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2274>`__
1053   * `2.27.5 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2275>`__
1054   * `2.28.0 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2280>`__
1055
1056 * Netty 4.1.39 → 4.1.42, release notes:
1057   * `4.1.41 <https://netty.io/news/2019/09/12/4-1-41-Final.html>`__
1058   * `4.1.42 <https://netty.io/news/2019/09/25/4-1-42-Final.html>`__
1059
1060 * pt-triemap `1.0.6 → 1.1.0 <https://github.com/PantheonTechnologies/triemap/releases/tag/triemap-1.1.0>`__
1061
1062 * reactive-streams `1.0.2 → 1.0.3 <http://www.reactive-streams.org/announce-1.0.3>`__
1063
1064 * stax2-api `3.1.4 → 4.2 <https://github.com/FasterXML/stax2-api/blob/master/release-notes/VERSION>`__
1065
1066 * woodstox-core 5.0.3 → 5.3.0, release notes:
1067   * `5.1.0 <https://github.com/FasterXML/woodstox/wiki/Woodstox-Release-5.1>`__
1068   * `5.2.0 <https://github.com/FasterXML/woodstox/wiki/Woodstox-Release-5.2>`__
1069   * `5.3.0 <https://github.com/FasterXML/woodstox/wiki/Woodstox-Release-5.3>`__
1070
1071 Version 6.0.0
1072 -------------
1073 This is a major upgrade from version 5, with breaking changes; projects will
1074 need to make changes to upgrade to this version.
1075
1076 Java 11 is required
1077 ~~~~~~~~~~~~~~~~~~~
1078 This release sets ``maven.compiler.release=11`` and enforces that the JDK used to build
1079 is Java 11+. As there may be issues with various maven plugins when faced with JDK9+
1080 constructs and JDK11+ classes, target release can be controlled on a per-artifact
1081 basis (i.e. target Java 10 with ``maven.compiler.release=10`` property).
1082
1083 This release has been validated with ``openjdk-11.0.4`` and is not supported on any lower
1084 version. As usual, we recommend using latest available JDK/JRE for Java 11 during development
1085 and deployment.
1086
1087 Checkstyle/SpotBugs/Modernizer run by default
1088 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1089 With this release code artifacts always run ``maven-checkstyle-plugin``, ``spotbugs-maven-plugin``
1090 and ``modernizer-maven-plugin``. Checkstyle and SpotBugs run in enforcing mode, i.e. will fail
1091 build if any violations are found. Modernizer is configured to report Java 8-compatible constructs
1092 and will not fail the build unless instructed to do so.
1093
1094 Behavior of each of these is controlled via a maven property on a per-artifact basis:
1095
1096 * ``odlparent.checkstyle.enforce`` controls checkstyle enforcement: defaults to ``true``, but can be set to ``false``
1097 * ``odlparent.checkstyle.skip`` controls checkstyle invocation: defaults to ``false``, but can be set to ``true``
1098 * ``odlparent.spotbugs.enforce`` controls SpotBugs enforcement: defaults to ``true``, but can be set to ``false``
1099 * ``odlparent.spotbugs.skip`` controls SpotBugs invocation: defaults to ``false``, but can be set to ``true``
1100 * ``odlparent.modernizer.enforce`` controls modernizer enforcement: defaults to ``false``, but can be set to ``true``
1101 * ``odlparent.modernizer.skip`` controls modernizer invocation: defaults to ``false``, but can be set to ``true``
1102 * ``odlparent.modernizer.target`` controls modernizer Java version: defaults to ``1.8``, but can be set to ``1.11`` or similar
1103
1104 Bug fixes
1105 ~~~~~~~~~
1106
1107 * ``blueprint container`` had ``org.apache.aries.blueprint.preemptiveShutdown`` set to false
1108   to enable it to work with Config Subsystem. As that component is long gone, this property has
1109   been removed as part of `ODLPARENT-34 <https://jira.opendaylight.org/browse/ODLPARENT-34>`__.
1110   Furthermore, system properties related to Config Subsystem/NETCONF integration have been removed
1111   as well.
1112
1113 Upstream version removals
1114 ~~~~~~~~~~~~~~~~~~~~~~~~~
1115
1116 The following upstream dependencies have been removed from dependency management:
1117
1118 * com.google.code.findbugs/jsr305
1119
1120 Third-party dependencies
1121 ~~~~~~~~~~~~~~~~~~~~~~~~
1122
1123 The dependency on `xmlunit-assertj` and `modernizer-maven-annotations` has been added and the following
1124 dependencies have been upgraded:
1125
1126 * Akka 2.5.23 → 2.5.25, release notes:
1127   * `2.5.24 <https://akka.io/blog/news/2019/08/09/akka-2.5.24-released>`__
1128   * `2.5.25 <https://akka.io/blog/news/2019/08/20/akka-2.5.25-released>`__
1129
1130 * apache-sshd `2.2.0 → 2.3.0 <https://github.com/apache/mina-sshd/blob/master/docs/changes/2.3.0.md>`__
1131
1132 * Bouncy Castle `1.62 → 1.63 <https://www.bouncycastle.org/releasenotes.html>`__
1133
1134 * commons-beanutils `1.9.3 → 1.9.4 <https://www.apache.org/dist/commons/beanutils/RELEASE-NOTES.txt>`__
1135
1136 * commons-codec `1.12 → 1.13 <http://www.apache.org/dist/commons/codec/RELEASE-NOTES.txt>`__
1137
1138 * commons-text 1.6 → 1.8, release notes:
1139   * `1.7 <https://commons.apache.org/proper/commons-text/changes-report.html#a1.7>`__
1140   * `1.8 <https://commons.apache.org/proper/commons-text/changes-report.html#a1.8>`__
1141
1142 * Checkstyle 8.18 → 8.20, release notes:
1143   * `8.19 <https://checkstyle.org/releasenotes.html#Release_8.19>`__
1144   * `8.20 <https://checkstyle.org/releasenotes.html#Release_8.20>`__
1145
1146 * jackson-databind `2.9.9 → 2.9.9.3 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9#micro-patches>`__
1147
1148 * jaxb-api 2.2.8 → 2.3.0, aligning it with Karaf-provided version
1149
1150 * Netty 4.1.36 → 4.1.39, release notes:
1151   * `4.1.37 <https://netty.io/news/2019/06/28/4-1-37-Final.html>`__
1152   * `4.1.38 <https://netty.io/news/2019/07/24/4-1-38-Final.html>`__
1153   * `4.1.39 <https://netty.io/news/2019/08/13/4-1-39-Final.html>`__
1154
1155 * Sevntu 1.32.0 → 1.35.0, release notes:
1156   * `1.33.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.33.0>`__
1157   * `1.34.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.34.0>`__
1158   * `1.34.1 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.34.1>`__
1159   * `1.35.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.35.0>`__
1160
1161 * Scala 2.12.8 → 2.12.9, release notes:
1162   * `2.12.9 <https://github.com/scala/scala/releases/tag/v2.12.9>`__
1163   * `2.12.10 <https://github.com/scala/scala/releases/tag/v2.12.10>`__
1164
1165 * slf4j `1.7.25 → 1.7.28 <https://www.slf4j.org/news.html>`__
1166
1167 * triemap `1.0.5 → 1.0.6 <https://github.com/PantheonTechnologies/triemap/releases/tag/triemap-1.0.6>`__
1168
1169 * typesafe/ssl-config `0.3.7 → 0.3.8 <https://github.com/lightbend/ssl-config/compare/v0.3.7...v0.3.8>`__
1170
1171 * Xtend 1.17.1 → 1.19.0, release notes:
1172   * `1.18.0 <https://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2019/06/04/version-2-18-0>`__
1173   * `1.19.0 <https://www.eclipse.org/Xtext/releasenotes.html#/releasenotes/2019/09/03/version-2-19-0>`__
1174
1175 Plugin upgrades
1176 ~~~~~~~~~~~~~~~
1177
1178 * git-commit-id-plugin 2.2.6 → 3.0.1, release notes:
1179   * `3.0.0 <https://github.com/git-commit-id/maven-git-commit-id-plugin/releases/tag/v3.0.0>`__
1180   * `3.0.1 <https://github.com/git-commit-id/maven-git-commit-id-plugin/releases/tag/v3.0.1>`__
1181
1182 * maven-javadoc-plugin `3.1.0 → 3.1.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317529&version=12345060>`__
1183
1184 * pmd-maven-plugin `3.11.0 → 3.12.0 <https://blogs.apache.org/maven/entry/apache-maven-pmd-plugin-version1>`__
1185
1186 * spotbugs-maven-plugin 3.1.11  → 3.1.12.2, release notes:
1187   * `3.1.12 <https://github.com/spotbugs/spotbugs-maven-plugin/compare/spotbugs-maven-plugin-3.1.11...spotbugs-maven-plugin-3.1.12>`__
1188   * `3.1.12.1 <https://github.com/spotbugs/spotbugs-maven-plugin/releases/tag/spotbugs-maven-plugin-3.1.12.1>`__
1189   * `3.1.12.2 <https://github.com/spotbugs/spotbugs-maven-plugin/releases/tag/spotbugs-maven-plugin-3.1.12.2>`__
1190
1191 Version 5.0.1
1192 -------------
1193
1194 This is a bug-fix upgrade from version 5.0.0.
1195
1196 Third-party dependencies
1197 ~~~~~~~~~~~~~~~~~~~~~~~~
1198
1199 The following dependencies have been upgraded:
1200
1201 * Akka 2.5.21 → 2.5.23, release notes:
1202   * `2.5.22 <https://akka.io/blog/news/2019/04/03/akka-2.5.22-released>`__
1203   * `2.5.23 <https://akka.io/blog/news/2019/05/21/akka-2.5.23-released>`__
1204
1205 * asciidoctorj-diagram 1.5.12 → 1.5.16
1206
1207 * Bouncy Castle `1.61 → 1.62 <http://www.bouncycastle.org/releasenotes.html>`__
1208
1209 * commons-lang3 `3.8.1 → 3.9 <http://www.apache.org/dist/commons/lang/RELEASE-NOTES.txt>`__
1210
1211 * JaCoCo `0.8.3 → 0.8.4 <https://github.com/jacoco/jacoco/releases/tag/v0.8.4>`__
1212
1213 * Jackson `2.9.8 → 2.9.9 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.9>`__
1214
1215 * Jolokia 1.6.0 → 1.6.2, release notes:
1216   * `1.6.1 <https://jolokia.org/changes-report.html#a1.6.1>`__
1217   * `1.6.2 <https://jolokia.org/changes-report.html#a1.6.2>`__
1218
1219 * Mockito `2.25.0 → 2.25.1 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2251>`__
1220
1221 * Netty 4.1.34 → 4.1.36, release notes:
1222   * `4.1.35 <https://netty.io/news/2019/04/17/4-1-35-Final.html>`__
1223   * `4.1.36 <https://netty.io/news/2019/04/30/4-1-36-Final.html>`__
1224
1225 * PowerMock 2.0.0 → 2.0.2, release notes:
1226   * `2.0.1 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.1>`__
1227   * `2.0.2 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.2>`__
1228
1229 * Reactive Streams `1.0.1 → 1.0.2 <https://www.lightbend.com/blog/update-reactive-streams-102-released>`__
1230
1231 * scala-parser-combinators `1.1.1 → 1.1.2 <https://github.com/scala/scala-parser-combinators/releases/tag/v1.1.2>`__
1232
1233 * Sevntu `1.32.0 → 1.33.0 <http://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.33.0>`__
1234
1235 * Typesafe Config `1.3.2 → 1.3.3 <https://github.com/lightbend/config/releases/tag/v1.3.3>`__
1236
1237 * triemap `1.0.4 → 1.0.5 <https://github.com/PantheonTechnologies/triemap/releases/tag/triemap-1.0.5>`__
1238
1239 * XBean finder 4.12 → 4.14, release notes:
1240   * `4.13 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?version=12344253&projectId=12310312>`__
1241   * `4.14 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310312&version=12345220>`__
1242
1243 * xmlunit `2.6.2 → 2.6.3 <https://github.com/xmlunit/xmlunit/releases/tag/v2.6.3>`__
1244
1245 * Xtend `2.17.0 → 2.17.1 <https://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2019/04/03/version-2-17-1>`__
1246
1247 Plugin upgrades
1248 ~~~~~~~~~~~~~~~
1249
1250 * maven-archetype-plugin 3.0.1 → 3.1.1, release notes:
1251   * `3.1.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317122&version=12340346>`__
1252   * `3.1.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317122&version=12345450>`__
1253
1254 * maven-bundle-plugin `4.1.0 → 4.2.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310100&version=12345047>`__
1255
1256 * maven-checkstyle-plugin `3.1.0 → 3.1.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317223&version=12342397>`__
1257
1258 * maven-compiler-plugin `3.8.0 → 3.8.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317225&version=12343484>`__
1259
1260 * maven-help-plugin `3.1.1 → 3.2.0 <https://blog.soebes.de/blog/2019/04/22/apache-maven-help-plugin-version-3-dot-2-0-released/>`__
1261
1262 * maven-jar-plugin `3.1.1 → 3.1.2 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317526&version=12344629>`__
1263
1264 * maven-plugin-plugin `3.5.2 → 3.6.0 <https://blogs.apache.org/maven/entry/apache-maven-plugin-tools-version1>`__
1265
1266 * maven-source-plugin `3.0.1 → 3.1.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317924&version=12336941>`__
1267
1268 * maven-surefire-plugin 2.22.1 → 2.22.2
1269
1270 New plugins
1271 ~~~~~~~~~~~
1272
1273 * ``modernizer-maven-plugin`` declared, allowing downstreams to more easily activate it,
1274   and so detect code which should be updated to more modern equivalent.
1275
1276 New features
1277 ~~~~~~~~~~~~
1278
1279 * ``odl-caffeine-2`` provides a pre-packaged feature for the Caffeine caching framework,
1280   along with the Guava compabitility layer.
1281
1282 Version 5.0.0
1283 -------------
1284
1285 This is a major upgrade from version 4, with breaking changes; projects will
1286 need to make changes to upgrade to this version.
1287
1288 The most significant change is `ODLPARENT-198 <https://jira.opendaylight.org/browse/ODLPARENT-198>`__,
1289 which removes JSR305 from default dependencies and does not present it at class path by default.
1290
1291 Deleted artifacts
1292 ~~~~~~~~~~~~~~~~~
1293
1294 ``findbugs`` has been removed, as its only purpose was to provide FindBugs
1295 rule definitions. Equivalent definitions are available in ``spotbugs``.
1296
1297 Bug fixes
1298 ~~~~~~~~~
1299
1300 * ``blueprint-maven-plugin`` used to scan the entire classpath, resulting in potential conflicts
1301   across projects. Scanning is now limited to ``${project.groupId}``, limiting conflict domain
1302   to single project. See `ODLPARENT-109 <https://jira.opendaylight.org/browse/ODLPARENT-109>`__.
1303
1304 * ``bundle-maven-plugin`` configuration ignored generated ServiceLoader service entries,
1305   which has now been fixed. See `ODLPARENT-197 <https://jira.opendaylight.org/browse/ODLPARENT-197>`__.
1306
1307 * Bundle tests are now enabled by default. See `ODLPARENT-158 <https://jira.opendaylight.org/browse/ODLPARENT-158>`__
1308   and `ODLPARENT-80 <https://jira.opendaylight.org/browse/ODLPARENT-80>`__ for details.
1309
1310 * Karaf log file rollover was not explictly set up, leading to inability to easily override
1311   the defaults. See `ODLPARENT-153 <https://jira.opendaylight.org/browse/ODLPARENT-153>`__ for details.
1312
1313 * Karaf log file used to use default maximum 16MiB file size, this has now been increased to 64MiB.
1314   See `ODLPARENT-154 <https://jira.opendaylight.org/browse/ODLPARENT-154>`__.
1315
1316 * ``features-test`` excluded opendaylight-karaf-empty's transitive dependencies, leading
1317   to the need to re-declare them in single-feature-parent. This re-declaration was forgotten
1318   in for ``bcpkix-framework-ext`` and ``bcprov-framework-ext`` bundles, which lead to them
1319   not being present in the local repository. See `ODLPARENT-130 <https://jira.opendaylight.org/browse/ODLPARENT-130>`__.
1320
1321 Upstream version removals
1322 ~~~~~~~~~~~~~~~~~~~~~~~~~
1323
1324 The following upstream dependencies have been removed from dependency management:
1325
1326 * cassandra-driver-core
1327
1328 * org.codehaus.enunciate/enunciate-core-annotations
1329
1330 * org.jboss.resteasy/jaxrs-api
1331
1332 * org.json/json
1333
1334 * org.osgi/org.osgi.compendium
1335
1336 Removed features
1337 ~~~~~~~~~~~~~~~~
1338
1339 * odl-jersey-1
1340
1341 * ``features-akka`` feature repository has been integrated into ``features-odlparent``
1342
1343 Third-party dependencies
1344 ~~~~~~~~~~~~~~~~~~~~~~~~
1345
1346 The following dependencies have been upgraded:
1347
1348 * apache-sshd `2.0.0 → 2.2.0 <https://github.com/apache/mina-sshd/compare/sshd-2.0.0...sshd-2.2.0>`__
1349
1350 * Aeron 1.12.0 → 1.15.3, release notes:
1351   * `1.13.0 <https://github.com/real-logic/aeron/releases/tag/1.13.0>`__
1352   * `1.14.0 <https://github.com/real-logic/aeron/releases/tag/1.14.0>`__
1353   * `1.15.0 <https://github.com/real-logic/aeron/releases/tag/1.15.0>`__
1354   * `1.15.1 <https://github.com/real-logic/aeron/releases/tag/1.15.1>`__
1355   * `1.15.2 <https://github.com/real-logic/aeron/releases/tag/1.15.2>`__
1356   * `1.15.3 <https://github.com/real-logic/aeron/releases/tag/1.15.3>`__
1357
1358 * Agrona 0.9.27 → 0.9.33, release notes:
1359   * `0.9.28 <https://github.com/real-logic/agrona/releases/tag/0.9.28>`__
1360   * `0.9.29 <https://github.com/real-logic/agrona/releases/tag/0.9.29>`__
1361   * `0.9.30 <https://github.com/real-logic/agrona/releases/tag/0.9.30>`__
1362   * `0.9.31 <https://github.com/real-logic/agrona/releases/tag/0.9.31>`__
1363   * `0.9.32 <https://github.com/real-logic/agrona/releases/tag/0.9.32>`__
1364   * `0.9.33 <https://github.com/real-logic/agrona/releases/tag/0.9.33>`__
1365
1366 * Akka 2.5.19 → 2.5.21, release notes:
1367   * `2.5.20 <https://akka.io/blog/news/2019/01/29/akka-2.5.20-released>`__
1368   * `2.5.21 <https://akka.io/blog/news/2019/02/13/akka-2.5.21-released>`__
1369
1370 * antl4r `4.7.1 → 4.7.2 <https://github.com/antlr/antlr4/releases/tag/4.7.2>`__
1371
1372 * asciidoctorj-diagram 1.5.11 → 1.5.12
1373
1374 * Bouncy Castle `1.60 → 1.61 <http://www.bouncycastle.org/releasenotes.html>`__
1375
1376 * checkstyle 8.16 → 8.18, release notes:
1377   * `8.17 <http://checkstyle.sourceforge.net/releasenotes.html#Release_8.17>`__
1378   * `8.18 <http://checkstyle.sourceforge.net/releasenotes.html#Release_8.18>`__
1379
1380 * commons-codec `1.11 → 1.12 <http://www.apache.org/dist/commons/codec/RELEASE-NOTES.txt>`__
1381
1382 * Google Error Prone 2.3.2 → 2.3.3
1383
1384 * Google Guava 25.1 → 27.1, release notes:
1385   * `26.0 <https://github.com/google/guava/releases/tag/v26.0>`__
1386   * `27.0 <https://github.com/google/guava/releases/tag/v27.0>`__
1387   * `27.0.1 <https://github.com/google/guava/releases/tag/v27.0.1>`__
1388   * `27.1 <https://github.com/google/guava/releases/tag/v27.1>`__
1389
1390 * Google Truth `0.42 → 0.43 <https://github.com/google/truth/releases/tag/release_0_43>`__
1391
1392 * h2 database `1.4.196 → 1.4.199 <http://www.h2database.com/html/changelog.html>`__
1393
1394 * Immutables `2.7.3 → 2.7.5 <https://github.com/immutables/immutables/#changelog>`__
1395
1396 * Javassist `3.24.0-GA → 3.24.1-GA <https://github.com/jboss-javassist/javassist/releases/tag/rel_3_24_1_ga>`__
1397
1398 * log4j2 `2.11.1 → 2.11.2 <https://github.com/apache/logging-log4j2/blob/log4j-2.11.2/RELEASE-NOTES.md>`__
1399
1400 * Mockito 2.23.4 → 2.25.0, release notes:
1401   * `2.24.0 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2240>`__
1402   * `2.25.0 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2250>`__
1403
1404 * Netty 4.1.32 → 4.1.34, release notes:
1405   * `4.1.32 <https://netty.io/news/2018/11/29/4-1-32-Final.html>`__
1406   * `4.1.33 <https://netty.io/news/2019/01/21/4-1-33-Final.html>`__
1407   * `4.1.34 <https://netty.io/news/2019/03/08/4-1-34-Final.html>`__
1408
1409 * OSGi 5.0.0 → 6.0.0
1410
1411 * Powermockito 1.7.4 → 2.0.0, release notes:
1412   * `2.0.0-beta.5 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.0-beta.5>`__
1413   * `2.0.0-RC.1 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.0-RC.1>`__
1414   * `2.0.0 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.0>`__
1415
1416 * SpotBugs `3.1.9 → 3.1.12 <https://github.com/spotbugs/spotbugs/blob/3.1.12/CHANGELOG.md>`__
1417
1418 * ThreeTen `1.4.0 → 1.5.0 <https://www.threeten.org/threeten-extra/changes-report.html#a1.5.0>`__
1419
1420 * Xtend `2.16.0 → 2.17.0 <http://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2019/03/05/version-2-17-0>`__
1421
1422 Plugin removals
1423 ~~~~~~~~~~~~~~~
1424
1425 * gmaven-plugin
1426
1427 * maven-findbugs-plugin
1428
1429 Plugin upgrades
1430 ~~~~~~~~~~~~~~~
1431
1432 * jacoco-maven-plugin `0.8.2 → 0.8.3 <https://github.com/jacoco/jacoco/releases/tag/v0.8.3>`__
1433
1434 * maven-invoker-plugin `3.1.0 → 3.2.0 <https://mail-archives.apache.org/mod_mbox/maven-announce/201901.mbox/%3Cop.zvzdg9tbkdkhrr@desktop-2khsk44%3E>`__
1435
1436 * maven-javadoc-plugin `3.0.1 → 3.1.0 <https://mail-archives.apache.org/mod_mbox/maven-announce/201903.mbox/%3C6064d830-474c-4b43-afef-99502c3a305a%40getmailbird.com%3E>`__
1437
1438 * spotbugs-maven-plugin 3.1.8 → 3.1.11
1439
1440 Version 4.0.9
1441 -------------
1442
1443 This is a bug-fix upgrade from version 4.0.8.
1444
1445 Bug fixes
1446 ~~~~~~~~~
1447
1448 * ``karaf-plugin`` invocation in ``karaf4-parent`` caused previously
1449   patched features to be overwritten with their stock versions, referencing
1450   bundles which were not populated in the local repository. (See
1451   `ODLPARENT-194 <https://jira.opendaylight.org/browse/ODLPARENT-194>`__.)
1452
1453 * ``karaf-plugin`` version in ``karaf4-parent`` is now provided through
1454   plugin management so downstreams can override it without needing
1455   to repeat its configuration.
1456
1457 * ``karaf-plugin`` no longer reads features twice when running discovery,
1458   speeding up the process a bit.
1459
1460 * Recent versions of the SpotBugs Maven plugin use SLF4J 1.8 beta 2, which
1461   can’t use the 1.7.25 implementation we provide; we therefore provide an
1462   implementation of 1.8 beta 2 when SpotBugs is used. (See
1463   `ODLPARENT-184 <https://jira.opendaylight.org/browse/ODLPARENT-184>`__.)
1464
1465 New features
1466 ~~~~~~~~~~~~
1467
1468 * ``odl-woodstox`` wraps the Woodstox StAX implementation which is imposed on
1469   us by Karaf.
1470
1471 Version 4.0.8
1472 -------------
1473
1474 This is a bug-fix and minor upstream bump upgrade from version 4.0.7.
1475
1476 Bug fixes
1477 ~~~~~~~~~
1478
1479 * ``bcprov-ext-jdk15on`` is a superset of ``bcprov-jdk15on``, so there’s no
1480   need to ship both; we now only ship the former. In addition, we install the
1481   Bouncy Castle JARs in ``lib/boot`` so that they continue to be available on
1482   the boot classpath (JDK 9 removes the extension mechanism which was used
1483   previously), and provide the corresponding bundles from the boot classpath
1484   instead of using separate JARs in the system repository. (See
1485   `ODLPARENT-183 <https://jira.opendaylight.org/browse/ODLPARENT-183>`__ and
1486   `ODLPARENT-185 <https://jira.opendaylight.org/browse/ODLPARENT-185>`__.)
1487
1488 * A dependency check has been added to ensure that we don’t run into the
1489   TrieMap dependency bug in 4.0.6 again.
1490
1491 * Dependencies pulled in by features are now checked for convergence, and
1492   ``karaf-plugin`` warns when it finds diverging dependencies (the same
1493   artifact with two different versions). Upstream-provided features are
1494   patched to avoid the following divergences (and upgrade some dependencies in
1495   the process):
1496
1497   * Aries utilities 1.1.0/1.1.3 (upgraded to 1.1.3).
1498   * Commons Beanutils 1.8.3/1.9.3 (upgraded to 1.9.3).
1499   * Commons Codec 1.8/1.10 (upgraded to 1.11).
1500   * ``javax.mail`` 1.4.4/1.4.7 (upgraded to 1.4.7).
1501
1502   (See `ODLPARENT-189 <https://jira.opendaylight.org/browse/ODLPARENT-189>`__.)
1503
1504 New features
1505 ~~~~~~~~~~~~
1506
1507 * ``odl-dropwizard-metrics`` provides Dropwizard Metrics (which are also
1508   available in dependency management).
1509
1510 * ``enunciate-maven-plugin`` is added as the replacement for
1511   ``maven-enunciate-plugin``.
1512
1513 Third-party dependencies
1514 ~~~~~~~~~~~~~~~~~~~~~~~~
1515
1516 The following dependencies are no longer provided by the JVM, starting with
1517 version 11, but we make them available via dependency management for projects
1518 which need them:
1519
1520 * ``javax.annotation-api``.
1521
1522 * JAXB (``jaxb-core``, ``jaxb-impl``).
1523
1524 The following dependencies have been upgraded:
1525
1526 * Checkstyle `8.15 → 8.16 <https://checkstyle.org/releasenotes.html#Release_8.16>`__.
1527
1528 * Dependency Check `4.0.0 → 4.0.2 <https://github.com/jeremylong/DependencyCheck/blob/master/RELEASE_NOTES.md>`__.
1529
1530 * ``git-commit-id`` `2.2.5 → 2.2.6 <https://github.com/ktoso/maven-git-commit-id-plugin/releases>`__.
1531
1532 * Immutables 2.7.1 → 2.7.3:
1533
1534   * `2.7.2 <https://github.com/immutables/immutables#272-2018-11-05>`__.
1535   * `2.7.3 <https://github.com/immutables/immutables#273-2018-11-10>`__.
1536
1537   (2.7.4 breaks our Javadocs.)
1538
1539 * Jackson `2.9.7 → 2.9.8 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.8>`__.
1540
1541 Version 4.0.7
1542 -------------
1543
1544 This is a bug-fix release, correcting the ``triemap`` import declaration.
1545
1546 Version 4.0.6
1547 -------------
1548
1549 This is a bug-fix and minor upstream packaging upgrade from version 4.0.5.
1550
1551 Bug fixes
1552 ~~~~~~~~~
1553
1554 Single-feature-test was broken with JDK 9 and later and Karaf 4.2.2; this
1555 release adds the additional JVM configuration needed.
1556
1557 Third-party dependencies
1558 ~~~~~~~~~~~~~~~~~~~~~~~~
1559
1560 This release adds the ``triemap`` BOM to dependency management.
1561
1562 Version 4.0.5
1563 -------------
1564
1565 This is a bug-fix release: the Karaf Maven plugin, in version 4.2.2, is
1566 `broken <https://issues.apache.org/jira/browse/KARAF-6057>`__ in some cases we
1567 need in OpenDaylight; we revert to 4.2.1 in ``karaf4-parent`` to avoid this.
1568
1569 Version 4.0.4
1570 -------------
1571
1572 This is a bug-fix release, reverting the change made in 4.0.3 to handle
1573 building with either ``zip`` or ``tar.gz`` Karaf archives (which breaks
1574 builds in our infrastructure, without the empty Karaf archive).
1575
1576 Version 4.0.3
1577 -------------
1578
1579 This is a bug-fix and minor upstream bump upgrade from version 4.0.2.
1580
1581 Bug fixes
1582 ~~~~~~~~~
1583
1584 * Our FindBugs configuration for JDK 9 and later caused the plugin to run
1585   everywhere; instead, this version defines the ``findbugs.skip`` property to
1586   disable the plugin in modules where it would be used otherwise.
1587
1588 * The PowerMock declarations in dependency management missed
1589   ``powermock-api-mockito2``, which is necessary for modules using PowerMock
1590   with Mockito 2.
1591
1592 * The “quick” profile (``-Pq``) now skips SpotBugs.
1593
1594 * JSR-305 annotations are now optional, which fixes a number of issues when
1595   building with newer JDKs.
1596
1597 * We provide JAXB with JDK 11 and later (where it is no longer provided by the
1598   base platform).
1599
1600 * ``odlparent-artifacts`` has been updated to accurately represent the
1601   artifacts provided.
1602
1603 * ``javax.activation`` is now excluded from generated features (it’s provided
1604   on Karaf’s boot classpath).
1605
1606 * When the build is configured to build Karaf distributions in ``tar.gz``
1607   archives, but not ``zip`` archives, ``features-test`` used to fail; it will
1608   now used whichever is available
1609   (`ODLPARENT-174 <https://jira.opendaylight.org/browse/ODLPARENT-174>`__).
1610
1611 * Explicit GCs are disabled by default, so that calls to ``System.gc()`` are
1612   ignored
1613   (`ODLPARENT-175 <https://jira.opendaylight.org/browse/ODLPARENT-175>`__).
1614
1615 * Null checks are disabled in SpotBugs because of bad interactions with newer
1616   annotations and the bytecode produces by JDK 11 and later for
1617   ``try``-with-resources.
1618
1619 * Akka Persistence expects LevelDB 0.10, so we now pull in that version
1620   instead of 0.7.
1621
1622 Dependency convergence
1623 ~~~~~~~~~~~~~~~~~~~~~~
1624
1625 A number of dependencies have been added or constrained so that projects using
1626 this parent can enforce dependency convergence:
1627
1628 * Karaf’s ``framework`` feature is used as an import POM, so that we converge
1629   by default on the versions used in Karaf.
1630
1631 * The following dependencies have been added to dependency management:
1632
1633   * ``commons-beanutils``
1634   * the Checker Framework
1635   * Error Prone annotations
1636   * ``javax.activation``
1637   * ``xml-apis``
1638
1639 New features
1640 ~~~~~~~~~~~~
1641
1642 The following Karaf features have been added:
1643
1644 * ``odl-antlr4`` (providing ``antlr4-runtime``);
1645
1646 * ``odl-gson`` (providing ``gson``);
1647
1648 * ``odl-jersey-2`` (providing Jersey client, server, and container servlet,
1649   along with the necessary feature dependencies);
1650
1651 * ``odl-servlet-api`` (providing ``javax.servlet-api``);
1652
1653 * ``odl-stax2-api`` (providing ``stax2-api``);
1654
1655 * ``odl-ws-rs-api`` (providing ``javax.ws.rs-api``);
1656
1657 A new ``sonar-jacoco-aggregate`` profile can be used to produce Sonar reports
1658 with aggregated JaCoCo reports. Additionally, Sonar builds (run with
1659 ``-Dsonar``) are detected and run with a number of irrelevant plugins disabled.
1660
1661 Upstream version upgrades
1662 ~~~~~~~~~~~~~~~~~~~~~~~~~
1663
1664 * Akka 2.5.14 → 2.5.19 (and related ``ssl-config``, Aeron and Agrona upgrades):
1665
1666   * `2.5.15 <https://akka.io/blog/news/2018/08/24/akka-2.5.15-released>`__.
1667   * `2.5.16 <https://akka.io/blog/news/2018/08/29/akka-2.5.16-security-fix-released>`__.
1668   * `2.5.17 <https://akka.io/blog/news/2018/09/27/akka-2.5.17-released>`__.
1669   * `2.5.18 <https://akka.io/blog/news/2018/10/07/akka-2.5.18-released>`__.
1670   * `2.5.19 <https://akka.io/blog/news/2018/12/07/akka-2.5.19-released>`__.
1671
1672 * Commons Text `1.4 → 1.6 <http://www.apache.org/dist/commons/text/RELEASE-NOTES.txt>`__.
1673
1674 * Eclipse JDT annotations 2.2.0 → 2.2.100.
1675
1676 * Javassist 3.23.1 → 3.24.0.
1677
1678 * Karaf 4.2.1 → 4.2.2, with related upgrades.
1679
1680 * LMAX Disruptor `3.4.1 → 3.4.2 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.4.2>`__.
1681
1682 * Mockito `2.20.1 → 2.23.4 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md>`__.
1683
1684 * Netty 4.1.29 → 4.1.31:
1685
1686   * `4.1.30 <https://netty.io/news/2018/09/28/4-1-30-Final.html>`__.
1687   * `4.1.31 <https://netty.io/news/2018/10/30/4-1-31-Final.html>`__.
1688
1689 * Pax Exam 4.12.0 → 4.13.1.
1690
1691 * Scala 2.12.6 → 2.12.8:
1692
1693   * `2.12.7 <https://github.com/scala/scala/releases/tag/v2.12.7>`__.
1694   * `2.12.8 <https://github.com/scala/scala/releases/tag/v2.12.8>`__.
1695
1696 * Wagon HTTP 3.1.0 → 3.2.0.
1697
1698 * Xtend `2.14.0 → 2.16.0 <https://www.eclipse.org/xtend/releasenotes.html>`__.
1699
1700 Plugin version upgrades
1701 ~~~~~~~~~~~~~~~~~~~~~~~
1702
1703 * Asciidoctor `1.5.6 → 1.5.7.1 <https://github.com/asciidoctor/asciidoctor-maven-plugin/releases>`__
1704   (with related AsciidoctorJ upgrades).
1705
1706 * Bundle 4.0.0 → 4.1.0.
1707
1708 * Checkstyle `8.12 → 8.15 <https://checkstyle.org/releasenotes.html#Release_8.13>`__.
1709
1710 * DependencyCheck `3.3.2 → 4.0.0 <https://github.com/jeremylong/DependencyCheck/blob/master/RELEASE_NOTES.md>`__.
1711
1712 * Failsafe / Surefire `2.22.0 → 2.22.1 <https://blogs.apache.org/maven/entry/apache-maven-surefire-plugin-version1>`__.
1713
1714 * Help 3.1.0 → 3.1.1.
1715
1716 * JAR 3.1.0 → 3.1.1.
1717
1718 * PMD `3.10.0 → 3.11.0 <https://blogs.apache.org/maven/entry/apache-maven-pmd-plugin-3>`__.
1719
1720 * Remote Resources `1.5 → 1.6.0 <https://blogs.apache.org/maven/entry/apache-maven-remote-resources-plugin>`__.
1721
1722 * Shade
1723   `3.2.0 → 3.2.1 <https://blog.soebes.de/blog/2018/11/12/apache-maven-shade-plugin-version-3-dot-2-1-released/>`__.
1724
1725 * SpotBugs `3.1.6 → 3.1.9 <https://github.com/spotbugs/spotbugs/blob/release-3.1/CHANGELOG.md>`__.
1726
1727 * XBean finder 4.9 → 4.12.
1728
1729 * XTend 2.14.0 → 2.16.0.
1730
1731 Version 4.0.2
1732 -------------
1733
1734 This is a bug-fix and minor upstream bump upgrade from version 4.0.1.
1735
1736 Bug fixes
1737 ~~~~~~~~~
1738
1739 Previous releases overrode Karaf’s ``jre.properties``; this is no longer
1740 necessary, and was causing failures with Java 9 and later (our version of
1741 ``jre.properties`` didn’t have the appropriate settings for anything after
1742 Java 8). This release drops that override. See
1743 `ODLPARENT-168 <https://jira.opendaylight.org/browse/ODLPARENT-168>`__ for
1744 details.
1745
1746 Upstream version upgrades
1747 ~~~~~~~~~~~~~~~~~~~~~~~~~
1748
1749 * Commons Lang `3.8 → 3.8.1 <http://www.apache.org/dist/commons/lang/RELEASE-NOTES.txt>`__.
1750
1751 * Jackson `2.9.6 → 2.9.7 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.7>`__.
1752
1753 * Netty `4.1.28 → 4.1.29 <http://netty.io/news/2018/08/24/4-1-29-Final.html>`__.
1754
1755 Plugin version upgrades
1756 ~~~~~~~~~~~~~~~~~~~~~~~
1757
1758 * JAR `3.0.2 → 3.1.0 <https://blog.soebes.de/blog/2018/04/10/apache-maven-jar-plugin-version-3-dot-1-dot-0-released>`__.
1759
1760 * Javadoc `3.0.0 → 3.0.1 <https://blogs.apache.org/maven/entry/apache-maven-javadoc-plugin-version>`__.
1761
1762 * Jersey `2.22.2 → 2.25.1 <https://jersey.github.io/release-notes/2.25.html>`__,
1763   along with Glassfish JSON 1.0.4 → 1.1.2.
1764
1765 * Plugin 3.5 → 3.5.2:
1766
1767   * `3.5.1 <https://blog.soebes.de/blog/2018/01/22/apache-maven-plugin-tools-version-3-dot-5-1-released/>`__.
1768   * `3.5.2 <https://blog.soebes.de/blog/2018/05/26/apache-mave-plugin-tools-version-3-dot-5-2-released/>`__.
1769
1770 * Resources `3.0.1 → 3.1.0 <https://blogs.apache.org/maven/entry/apache-maven-resources-plugin-version>`__.
1771
1772 Version 4.0.1
1773 -------------
1774
1775 This is a bug-fix and minor upstream bump upgrade from version 4.0.0.
1776
1777 Bug fixes
1778 ~~~~~~~~~
1779
1780 The JaCoCo execution profile was incorrect, breaking Sonar; the report is now
1781 written correctly, so that Sonar can find it.
1782
1783 The Blueprint Maven plugin fails when it encounters Java 9 classes; this is
1784 fixed by forcefully upgrading its dependency on xbean-finder. See
1785 `ODLPARENT-167 <https://jira.opendaylight.org/browse/ODLPARENT-167>`__ for
1786 details.
1787
1788 Upstream version upgrades
1789 ~~~~~~~~~~~~~~~~~~~~~~~~~
1790
1791 * SpotBugs `3.1.6 → 3.1.7 <https://github.com/spotbugs/spotbugs/blob/release-3.1/CHANGELOG.md>`__.
1792
1793 Upstream version additions
1794 ~~~~~~~~~~~~~~~~~~~~~~~~~~
1795
1796 * Mockito Inline is added alongside Mockito Core, to ensure that the versions
1797   are kept in sync.
1798
1799 Plugin version upgrades
1800 ~~~~~~~~~~~~~~~~~~~~~~~
1801
1802 * Clean `3.0.0 → 3.1.0 <https://blog.soebes.de/blog/2018/04/14/apache-maven-clean-plugin-version-3-dot-1-0-released/>`__.
1803
1804 * Compiler `3.7.0 → 3.8.0 <https://blog.soebes.de/blog/2018/07/30/apache-maven-compiler-plugin-version-3-dot-8-0-released/>`__.
1805
1806 * Dependency 3.0.2 → 3.1.1:
1807
1808   * `3.1.0 <https://blog.soebes.de/blog/2018/04/06/apache-maven-dependency-plugin-version-3-dot-1-0-released/>`__.
1809   * `3.1.1 <https://blog.soebes.de/blog/2018/05/24/apache-maven-dependency-plugin-version-3-dot-1-1-released/>`__.
1810
1811 * Dependency Check `3.3.1 → 3.3.2 <https://github.com/jeremylong/DependencyCheck/blob/master/RELEASE_NOTES.md>`__.
1812
1813 * Enforcer `3.0.0-M1 → 3.0.0-M2 <https://mail-archives.apache.org/mod_mbox/maven-announce/201806.mbox/%3Cop.zko9b2vhkdkhrr%40desktop-2khsk44.dynamic.ziggo.nl%3E>`__.
1814
1815 * Failsafe 2.20.1 → 2.22:
1816
1817   * `2.21 <https://blog.soebes.de/blog/2018/03/06/apache-maven-surefire-plugin-version-2-dot-21-released/>`__.
1818   * `2.22 <https://blog.soebes.de/blog/2018/06/16/apache-maven-surefire-plugin-version-2-dot-22-released/>`__.
1819
1820 * Help 2.2 → 3.1.0:
1821
1822   * `3.0.0 <https://blog.soebes.de/blog/2018/03/18/apache-maven-help-plugin-version-3-dot-0-0-released/>`__.
1823   * `3.0.1 <https://blog.soebes.de/blog/2018/03/28/apache-maven-help-plugin-version-3-dot-0-1-released/>`__.
1824   * `3.1.0 <https://blog.soebes.de/blog/2018/06/09/apache-maven-help-plugin-version-3-dot-1-0-released/>`__.
1825
1826 * Invoker 2.0.0 → 3.1.0:
1827
1828   * `3.0.0 <https://blog.soebes.de/blog/2017/05/24/apache-maven-invoker-plugin-version-3-dot-0-0-released/>`__.
1829   * `3.1.0 <https://blog.soebes.de/blog/2018/05/31/apache-maven-invoker-plugin-version-3-dot-1-0-released/>`__.
1830
1831 * JAR `3.0.2 → 3.1.0 <https://blog.soebes.de/blog/2018/04/10/apache-maven-jar-plugin-version-3-dot-1-dot-0-released/>`__.
1832
1833 * Project Info Reports `2.9 → 3.0.0 <https://blog.soebes.de/blog/2018/06/27/apache-maven-project-info-reports-plugin-3-dot-0-0-released/>`__.
1834
1835 * Resources `3.0.1 → 3.1.0 <https://blog.soebes.de/blog/2018/05/01/apache-maven-resources-plugin-version-3-dot-1-0-released/>`__.
1836
1837 * Shade `3.1.0 → 3.2.0 <https://blog.soebes.de/blog/2018/09/13/apache-maven-shade-plugin-version-3-dot-2-0-released/>`__.
1838
1839 * Site `3.7 → 3.7.1 <https://blog.soebes.de/blog/2018/04/29/apache-maven-site-plugin-version-3-dot-7-1-released/>`__.
1840
1841 * Surefire 2.18.1 → 2.22.0:
1842
1843   * `2.19 <https://blog.soebes.de/blog/2015/10/19/apache-maven-surefire-plugin-version-2-dot-19-released/>`__.
1844   * `2.19.1 <https://blog.soebes.de/blog/2016/01/03/apache-maven-surefire-plugin-version-2-dot-19-dot-1-released/>`__.
1845   * `2.20 <https://blog.soebes.de/blog/2017/04/12/apache-maven-surefire-plugin-version-2-dot-20-released/>`__.
1846   * `2.21 <https://blog.soebes.de/blog/2018/03/06/apache-maven-surefire-plugin-version-2-dot-21-released/>`__.
1847   * `2.22 <https://blog.soebes.de/blog/2018/06/16/apache-maven-surefire-plugin-version-2-dot-22-released/>`__.
1848
1849
1850 Version 4.0.0
1851 -------------
1852
1853 This is a major upgrade from version 3, with breaking changes; projects will
1854 need to make changes to upgrade to this version.
1855
1856 `This Wiki page <https://wiki.opendaylight.org/view/Neon_platform_upgrade>`__
1857 has detailed step-by-step migration instructions.
1858
1859 ODL Parent 4 requires Maven 3.5.3 or later; this is needed in particular to
1860 enable SpotBugs support with current versions of the SpotBugs plugin.
1861
1862 Known issues
1863 ~~~~~~~~~~~~
1864
1865 This release’s SpotBugs support doesn’t handle Guava 25.1 correctly, resulting
1866 in false-positives regarding null handling; see
1867 `ODLPARENT-161 <https://jira.opendaylight.org/browse/ODLPARENT-161>`__ for
1868 details. Until this is fixed, the corresponding warnings are disabled, which
1869 matches our existing FindBugs configuration (which suffers from the a variant
1870 of this, with the same consequences).
1871
1872 We are planning on upgrading Akka during the 4.x cycle, even if it results in
1873 a technically breaking upgrade. This is currently blocked on an OSGi bug in
1874 Akka; see `Akka issue 25579 <https://github.com/akka/akka/issues/25579>`__ for
1875 details.
1876
1877 Blueprint and OSGi service handling
1878 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1879
1880 Previous releases used an OpenDaylight-specific directory for Blueprint XML
1881 files, ``org/opendaylight/blueprint``. It turned out this wasn’t useful, so
1882 version 4 uses the default directory, ``OSGI-INF/blueprint``.
1883
1884 The Maven bundle plugin is now configured to omit the ``Import-Service`` and
1885 ``Export-Service`` headers, since they are deprecated, unnecessary in
1886 OpenDaylight, and liable to cause issues.
1887
1888 With previous releases of OpenDaylight, projects were encouraged to use Pax
1889 CDI API annotations to describe their Blueprint beans, services and injections;
1890 with version 4, Blueprint annotations should be used instead:
1891
1892 * modules should depend on
1893   ``org.apache.aries.blueprint:blueprint-maven-plugin-annotation``, with the
1894   ``<optional>true</optional>`` flag, instead of
1895   ``org.ops4j.pax.cdi:pax-cdi-api``;
1896
1897 * ``@OsgiServiceProvider`` on bean definitions is replaced by ``@Service``;
1898
1899 * ``@OsgiService`` at injection points is replaced by ``@Reference``;
1900
1901 * ``@OsgiService`` on bean definitions, while technically wrong, can be seen in
1902   the OpenDaylight codebase; this is replaced by ``@Service``;
1903
1904 * service lists can be injected using ``@ReferenceList``.
1905
1906 See `this Gerrit patch <https://git.opendaylight.org/gerrit/75699>`__ for an
1907 example.
1908
1909 Compiler settings
1910 ~~~~~~~~~~~~~~~~~
1911
1912 Builds now warn about unchecked type uses (such as raw types where generics
1913 are available).
1914
1915 JUnit and Mockito are always available as test dependencies and no longer need
1916 to be declared in POMs.
1917
1918 New build profiles
1919 ~~~~~~~~~~~~~~~~~~
1920
1921 An OWASP profile is now available to run OWASP’s dependency checker; this will
1922 check all third-party dependencies against the NVD vulnerability database. To
1923 enable this, run Maven with ``-Powasp``.
1924
1925 Build profile changes
1926 ~~~~~~~~~~~~~~~~~~~~~
1927
1928 ``-Pq`` now skips Modernizer.
1929
1930 New features
1931 ~~~~~~~~~~~~
1932
1933 ``odl-akka-leveldb-0.10`` wraps LevelDB 0.10 for Akka.
1934
1935 ``odl-apache-commons-codec`` wraps Apache Commons Codec.
1936
1937 ``odl-apache-commons-lang3`` wraps Apache Commons Lang 3.
1938
1939 ``odl-apache-commons-net`` wraps Apache Commons Net.
1940
1941 ``odl-apache-commons-text`` wraps Apache Commons Text.
1942
1943 ``odl-apache-sshd`` wraps Apache SSHD.
1944
1945 ``odl-guava`` provides the default ODL version of Guava; it should be used
1946 instead of ``odl-guava-23`` or the new ``odl-guava-25``.
1947
1948 ``odl-jackson-2.9`` wraps Jackson 2.9.
1949
1950 New FindBugs and SpotBugs settings
1951 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1952
1953 FindBugs and SpotBugs are configured with
1954 `the SLF4J extension <http://kengotoda.github.io/findbugs-slf4j/>`__ (version
1955 1.4.0 for FindBugs, 1.4.1 for SpotBugs). This will flag misused SLF4J calls, in
1956 particular message templates which don’t match the arguments, and invalid
1957 placeholders (*e.g.* ``%s`` instead of ``{}``).
1958
1959 Deleted artifacts
1960 ~~~~~~~~~~~~~~~~~
1961
1962 ``aggregator-parent`` was unusable outside ``odlparent`` and has been removed.
1963 Instead, the ``maven.deploy.skip`` and ``maven.install.skip`` properties are
1964 available to disable deploying and installing artifacts.
1965
1966 Upstream version upgrades
1967 ~~~~~~~~~~~~~~~~~~~~~~~~~
1968
1969 This version upgrades the following third-party dependencies:
1970
1971 * Aeron 1.7.0 → 1.9.3:
1972
1973   * `1.8.0 <https://github.com/real-logic/aeron/releases/tag/1.8.0>`__.
1974   * `1.8.1 <https://github.com/real-logic/aeron/releases/tag/1.8.1>`__.
1975   * `1.8.2 <https://github.com/real-logic/aeron/releases/tag/1.8.2>`__.
1976   * `1.9.0 <https://github.com/real-logic/aeron/releases/tag/1.9.0>`__.
1977   * `1.9.1 <https://github.com/real-logic/aeron/releases/tag/1.9.1>`__.
1978   * `1.9.2 <https://github.com/real-logic/aeron/releases/tag/1.9.2>`__.
1979   * `1.9.3 <https://github.com/real-logic/aeron/releases/tag/1.9.3>`__.
1980
1981 * Agrona 0.9.12 → 0.9.21:
1982
1983   * `0.9.13 <https://github.com/real-logic/agrona/releases/tag/0.9.13>`__.
1984   * `0.9.14 <https://github.com/real-logic/agrona/releases/tag/0.9.14>`__.
1985   * `0.9.15 <https://github.com/real-logic/agrona/releases/tag/0.9.15>`__.
1986   * `0.9.16 <https://github.com/real-logic/agrona/releases/tag/0.9.16>`__.
1987   * `0.9.17 <https://github.com/real-logic/agrona/releases/tag/0.9.17>`__.
1988   * `0.9.18 <https://github.com/real-logic/agrona/releases/tag/0.9.18>`__.
1989   * `0.9.19 <https://github.com/real-logic/agrona/releases/tag/0.9.19>`__.
1990   * `0.9.20 <https://github.com/real-logic/agrona/releases/tag/0.9.20>`__.
1991   * `0.9.21 <https://github.com/real-logic/agrona/releases/tag/0.9.21>`__.
1992
1993 * Akka 2.5.11 → 2.5.14:
1994
1995   * `2.5.12 <https://akka.io/blog/news/2018/04/13/akka-2.5.12-released>`__.
1996   * `2.5.13 <https://akka.io/blog/news/2018/06/08/akka-2.5.13-released>`__.
1997   * `2.5.14 <https://akka.io/blog/news/2018/07/13/akka-2.5.14-released>`__.
1998
1999 * ASM 5.1 → 6.2.1 (synchronised with Karaf).
2000
2001 * Bouncy Castle `1.59 → 1.60 <https://www.bouncycastle.org/releasenotes.html>`__.
2002
2003 * Checkstyle `8.4 → 8.12 <http://checkstyle.sourceforge.net/releasenotes.html#Release_8.12>`__.
2004
2005 * Commons Lang `3.7 → 3.8 <http://www.apache.org/dist/commons/lang/RELEASE-NOTES.txt>`__.
2006
2007 * Commons Text 1.1 → 1.4:
2008
2009   * `1.2 <https://commons.apache.org/proper/commons-text/release-notes/RELEASE-NOTES-1.2.txt>`__.
2010   * `1.3 <https://commons.apache.org/proper/commons-text/release-notes/RELEASE-NOTES-1.3.txt>`__.
2011   * `1.4 <https://commons.apache.org/proper/commons-text/release-notes/RELEASE-NOTES-1.4.txt>`__.
2012
2013 * Eclipse JDT annotations 2.1.150 → 2.2.0.
2014
2015 * EclipseLink Moxy JAXB `2.7.1 → 2.7.3 <https://www.eclipse.org/eclipselink/releases/2.7.php>`__.
2016
2017 * Enunciate core annotations
2018   `2.10.1 → 2.11.1 <https://github.com/stoicflame/enunciate/releases>`__.
2019
2020 * Felix Metatype 1.1.6 → 1.2.0 (synchronised with Karaf).
2021
2022 * Google Truth `0.40 → 0.42 <https://github.com/google/truth/releases>`__.
2023
2024 * Guava 23.6.1 → 25.1:
2025
2026   * `23.4 <https://github.com/google/guava/releases/tag/v23.4>`__.
2027   * `23.5 <https://github.com/google/guava/releases/tag/v23.5>`__.
2028   * `23.6 <https://github.com/google/guava/releases/tag/v23.6>`__.
2029   * `24.0 <https://github.com/google/guava/releases/tag/v24.0>`__.
2030   * `24.1 <https://github.com/google/guava/releases/tag/v24.1>`__.
2031   * `25.0 <https://github.com/google/guava/releases/tag/v25.0>`__.
2032   * `25.1 <https://github.com/google/guava/releases/tag/v25.1>`__.
2033
2034 * Immutables `2.5.6 → 2.7.1 <https://github.com/immutables/immutables/blob/master/README.md#changelog>`__.
2035
2036 * Jackson 2.8.9 → 2.9.6:
2037
2038   * `2.9 feature overview <https://medium.com/@cowtowncoder/jackson-2-9-features-b2a19029e9ff>`__.
2039   * `2.9 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9>`__.
2040   * `2.9.1 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.1>`__.
2041   * `2.9.2 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.2>`__.
2042   * `2.9.3 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.3>`__.
2043   * `2.9.4 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.4>`__.
2044   * `2.9.5 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.5>`__.
2045   * `2.9.6 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.6>`__.
2046
2047 * JaCoCo `0.8.1 → 0.8.2 <https://github.com/jacoco/jacoco/releases/tag/v0.8.2>`__.
2048
2049 * Javassist 3.22.0 → 3.23.1. This provides compatibility with Java 9 and later,
2050   and `fixes a file handle leak <https://github.com/jboss-javassist/javassist/issues/165>`__.
2051
2052 * Jettison 1.3.8 → 1.4.0.
2053
2054 * Jetty 9.3.21 → 9.4.11 (synchronised with Karaf):
2055
2056   * `9.4.0 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00097.html>`__.
2057   * `9.4.1 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00100.html>`__.
2058   * `9.4.2 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00101.html>`__.
2059   * `9.4.3 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00102.html>`__.
2060   * `9.4.4 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00105.html>`__.
2061   * `9.4.5 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00107.html>`__.
2062   * `9.4.6 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00109.html>`__.
2063   * `9.4.7 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00111.html>`__.
2064   * `9.4.8 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00114.html>`__.
2065   * `9.4.9 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00117.html>`__.
2066   * `9.4.10 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00119.html>`__.
2067   * `9.4.11 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00122.html>`__.
2068
2069 * Jolokia OSGi `1.5.0 → 1.6.0 <https://jolokia.org/changes-report.html#a1.6.0>`__.
2070
2071 * Karaf 4.1.5 → 4.2.1:
2072
2073   * `4.1.6 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12342748>`__.
2074   * `4.2.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12342945>`__.
2075
2076 * LMAX Disruptor 3.3.10 → 3.4.1:
2077
2078   * `3.4.0 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.4.0>`__.
2079   * `3.4.1 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.4.1>`__.
2080
2081 * META-INF services 1.7 → 1.8.
2082
2083 * Mockito 1.10.19 → 2.20.1; see
2084   `What’s new in Mockito 2 <https://github.com/mockito/mockito/wiki/What%27s-new-in-Mockito-2>`__
2085   for upgrade instructions and
2086   `the list of issues you might run into <https://asolntsev.github.io/en/2016/10/11/mockito-2.1/>`__.
2087
2088 * Netty 4.1.22 → 4.1.28:
2089
2090   * `4.1.17 <http://netty.io/news/2017/11/08/4-0-53-Final-4-1-17-Final.html>`__.
2091   * `4.1.18 <http://netty.io/news/2017/12/11/4-0-54-Final-4-1-18-Final.html>`__.
2092   * `4.1.19 <http://netty.io/news/2017/12/18/4-1-19-Final.html>`__.
2093   * `4.1.20 <http://netty.io/news/2018/01/22/4-0-55-Final-4-1-20-Final.html>`__.
2094   * `4.1.21 <http://netty.io/news/2018/02/05/4-0-56-Final-4-1-21-Final.html>`__.
2095   * `4.1.22 <http://netty.io/news/2018/02/21/4-1-22-Final.html>`__.
2096   * `4.1.23 <http://netty.io/news/2018/04/04/4-1-23-Final.html>`__.
2097   * `4.1.24 <http://netty.io/news/2018/04/19/4-1-24-Final.html>`__.
2098   * `4.1.25 <http://netty.io/news/2018/05/14/4-1-25-Final.html>`__.
2099   * `4.1.26 <http://netty.io/news/2018/07/10/4-1-26-Final.html>`__.
2100   * `4.1.27 <http://netty.io/news/2018/07/11/4-1-27-Final.html>`__.
2101   * `4.1.28 <http://netty.io/news/2018/07/27/4-1-28-Final.html>`__.
2102
2103 * Pax Exam 4.11.0 → 4.12.0.
2104
2105 * Pax URL 2.5.3 → 2.5.4, which only fixes
2106   `a potential NullPointerException <https://ops4j1.jira.com/browse/PAXURL-346>`__.
2107
2108 * PowerMock 1.6.4 → 1.7.4:
2109
2110   * `1.6.5 <https://github.com/powermock/powermock/releases/tag/powermock-1.6.5>`__.
2111   * `1.6.6 <https://github.com/powermock/powermock/releases/tag/powermock-1.6.6>`__.
2112   * `1.7.0 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.0>`__.
2113   * `1.7.1 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.1>`__.
2114   * `1.7.2 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.2>`__.
2115   * `1.7.3 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.3>`__.
2116   * `1.7.4 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.4>`__.
2117
2118 * Scala parser combinators 1.0.7 → 1.1.1:
2119
2120   * `1.1.0 <https://github.com/scala/scala-parser-combinators/releases/tag/v1.1.0>`__.
2121   * `1.1.1 <https://github.com/scala/scala-parser-combinators/releases/tag/v1.1.1>`__.
2122
2123 * SpotBugs `3.1.0 → 3.1.6 <https://github.com/spotbugs/spotbugs/blob/3.1.6/CHANGELOG.md>`__.
2124
2125 * Threeten Extra `1.3.2 → 1.4 <https://github.com/ThreeTen/threeten-extra/releases>`__.
2126
2127 * Typesafe SSL config 0.2.2 → 0.2.4:
2128
2129   * `0.2.3 <https://github.com/lightbend/ssl-config/releases/tag/v0.2.3>`__.
2130   * `0.2.4 <https://github.com/lightbend/ssl-config/releases/tag/v0.2.4>`__.
2131
2132 * Wagon HTTP
2133   `2.10 → 3.1.0 <https://lists.apache.org/thread.html/96024c54db7680697cb066e22a37b0ed5b4498386714a8a9ae1ec9cd@%3Cannounce.maven.apache.org%3E>`__.
2134
2135 * XMLUnit `1.6 → 2.6.2 <https://github.com/xmlunit/xmlunit/blob/master/RELEASE_NOTES.md>`__.
2136
2137 Upstream version additions
2138 ~~~~~~~~~~~~~~~~~~~~~~~~~~
2139
2140 The following upstream dependencies have been added to dependency management:
2141
2142 * Apache SSHD 2.0.0, with EdDSA and Netty support (EdDSA is provided by ``net.i2p.crypto:eddsa``).
2143
2144 * Blueprint annotations (``org.apache.aries.blueprint:blueprint-maven-plugin-annotation``).
2145
2146 * Log4J2.
2147
2148 * Pax Web 7.2.3 (synchronised with Karaf).
2149
2150 Upstream version removals
2151 ~~~~~~~~~~~~~~~~~~~~~~~~~
2152
2153 The following upstream dependencies have been removed from dependency management:
2154
2155 * Google Protobuf.
2156
2157 * Our repackaging of Jersey Servlet.
2158
2159 * JUnit’s ``junit-dep``, which has long been obsolete.
2160
2161 * LevelDB (which is still available as features).
2162
2163 * Pax CDI API — Blueprint annotations should be used instead.
2164
2165 Plugin version upgrades
2166 ~~~~~~~~~~~~~~~~~~~~~~~
2167
2168 The following plugins have been upgraded:
2169
2170 * Blueprint 1.4.0 → 1.10.0.
2171
2172 * Build helper 1.12 → 3.0.0.
2173
2174 * Bundle plugin 3.5.0 → 4.0.0.
2175
2176 * Checkstyle
2177   `2.17 → 3.0.0 <https://mail-archives.apache.org/mod_mbox/maven-announce/201801.mbox/%3Cop.zchs68akkdkhrr%40desktop-2khsk44.mshome.net%3E>`__.
2178
2179 * Duplicate finder
2180   `1.2.1 → 1.3.0 <https://github.com/basepom/duplicate-finder-maven-plugin/blob/master/CHANGES.md>`__.
2181
2182 * Git commit id `2.2.4 → 2.2.5 <https://github.com/ktoso/maven-git-commit-id-plugin/releases/tag/v2.2.5>`__.
2183
2184 * Jacoco Maven plugin `0.8.1 → 0.8.2 <https://github.com/jacoco/jacoco/releases/tag/v0.8.2>`__.
2185
2186 * Javadoc `3.0.0 → 3.0.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317529&version=12342283>`__.
2187
2188 * PMD 3.8 → 3.10.0:
2189
2190   * `3.10.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?version=12342689&styleName=Text&projectId=12317621>`__.
2191
2192 * Sevntu `1.29.0 → 1.32.0 <http://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.32.0>`__.
2193
2194 * SpotBugs 3.1.0-RC6 → 3.1.6 (see the SpotBugs changes above).
2195
2196 Version 3.1.3
2197 -------------
2198
2199 This version fixes the following issues:
2200
2201 * `ODLPARENT-156 <https://jira.opendaylight.org/browse/ODLPARENT-156>`_:
2202   ``xtend-maven-plugin``’s dependencies end up pulling in conflicting
2203   dependencies. ODL Parent now constrains part of its dependency tree to avoid
2204   this.
2205
2206 This version adds ``odl-jackson-2.8`` to ``odlparent-artifacts``.
2207
2208 Version 3.1.2
2209 -------------
2210
2211 This version fixes the following issues:
2212
2213 * `INFRAUTILS-41 <https://jira.opendaylight.org/browse/INFRAUTILS-41>`_:
2214   ``jre.properties`` includes ``com.sun.management`` so that it can be
2215   enabled if necessary. (This doesn’t add a dependency on
2216   ``com.sun.management``, it allows bundles to use it if it is present.)
2217
2218 * `ODLPARENT-136 <https://jira.opendaylight.org/browse/ODLPARENT-136>`_:
2219   ``SingleFeatureTest`` pulls in ``org.osgi.compendium``.
2220
2221 * `ODLPARENT-144 <https://jira.opendaylight.org/browse/ODLPARENT-144>`_:
2222   ``org.apache.karaf.scr.management`` is whitelisted so that it no longer
2223   affects ``SingleFeatureTest``.
2224
2225 * `ODLPARENT-146 <https://jira.opendaylight.org/browse/ODLPARENT-146>`_:
2226   null-related FindBugs checks which produce false-positives with Guava 23.6
2227   and later are disabled, so that this really is fully backwards-compatible
2228   with 3.0 and later.
2229
2230 * `ODLPARENT-148 <https://jira.opendaylight.org/browse/ODLPARENT-148>`_:
2231   ``SingleFeatureTest`` preserves ``target/SFT/karaf.log``.
2232
2233 This version includes the following improvements:
2234
2235 * ``custom.properties`` no longer includes OVSDB-specific configuration.
2236
2237 * The ``odl-jersey-1`` feature includes the Jersey client.
2238
2239 * Redundant bundle dependency declarations in ``SingleFeatureTest`` have been
2240   removed (these are declarations which are also present in our base Karaf
2241   distribution).
2242
2243 * Build errors involving invalid feature or bundle URLs now indicate which
2244   feature is at fault.
2245
2246 * Obsolete Log4J overrides have been removed from ``SingleFeatureTest``.
2247
2248 When building using JDK 9 or 10, the default settings have been changed as
2249 follows to avoid errors or extraneous warnings:
2250
2251 * SFT is disabled (it needs Karaf 4.2 or later);
2252
2253 * Javadocs are generated as HTML 4;
2254
2255 * SpotBugs is disabled on JDK 10 or later;
2256
2257 * FindBugs is disabled on JDK 9 or later.
2258
2259 The following third-party dependencies have been upgraded:
2260
2261 * `EclipseLink Moxy JAXB 2.6.2 → 2.7.1 <https://www.eclipse.org/eclipselink/releases/2.7.php>`_.
2262
2263 * `Google Truth 0.36 → 0.40 <https://github.com/google/truth/releases>`_.
2264
2265 * `Gson 2.8.2 → 2.8.5 <https://github.com/google/gson/blob/master/CHANGELOG.md>`_.
2266
2267 * `Guava 23.6 → 23.6.1 <https://github.com/google/guava/compare/v23.6...v23.6.1>`_.
2268   This addresses CVE-2018-10237 (that’s the only change in this release).
2269
2270 * `Jacoco Maven plugin 0.8.0 → 0.8.1 <https://github.com/jacoco/jacoco/releases/tag/v0.8.1>`_.
2271
2272 * JDT annotations 2.1.0 → 2.1.150.
2273
2274 * `Scala 2.12.5 → 2.12.6 <https://github.com/scala/scala/releases/tag/v2.12.6>`_.
2275
2276 * `Scala Parser Combinators 1.0.6 → 1.0.7 <https://github.com/scala/scala-parser-combinators/releases/tag/v1.0.7>`_.
2277
2278 * `Sevntu 1.24.2 → 1.29.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.29.0>`_.
2279
2280 * `Xtext and Xtend 2.13.0 → 2.14.0 <https://github.com/eclipse/xtext/blob/website-master/xtend-website/_posts/releasenotes/2018-05-23-version-2-14-0.md>`_.
2281
2282 The following Maven plugin has been upgraded:
2283
2284 * `Javadoc 3.0.0 → 3.0.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317529&version=12342283>`_.
2285
2286 Version 3.1.1
2287 -------------
2288
2289 This version fixes the following issues:
2290
2291 * `ODLPARENT-137 <https://jira.opendaylight.org/browse/ODLPARENT-137>`_:
2292   restore the OpenDaylight prompt.
2293
2294 * `ODLPARENT-146 <https://jira.opendaylight.org/browse/ODLPARENT-146>`_:
2295   Guava 23.6 switched from @Nullable to @NullableDecl, which causes false
2296   positives in FindBugs’ ``NP_NONNULL_PARAM_VIOLATION`` rule; we’re
2297   disabling the rule for now.
2298
2299 Version 3.1.0
2300 -------------
2301
2302 This version fixes the following issues:
2303
2304 * Mycila dependencies are now “compile” scoped rather than “test”; this allows
2305   child projects to use Guice with Mycila more easily.
2306
2307 * The duplicate finder now ignores ``web.xml`` and BluePrint XML files.
2308
2309 This version includes the following improvements:
2310
2311 * The ``-Pq`` profile skips Maven Modernizer, in preparation for its future
2312   integration (and its use in child projects).
2313
2314 * An OWASP profile, ``-Powasp`` is available for vulnerability checking.
2315
2316 * A new ``odl-jackson-2.8`` feature provides Jackson 2.8 to child projects.
2317
2318 The following third-party dependencies have been added to dependency management:
2319
2320 * `ThreeTen-Extra <http://www.threeten.org/threeten-extra/>`_
2321
2322 The following third-party dependencies have been upgraded:
2323
2324 * Aeron 1.2.5 → 1.7.0; release notes:
2325
2326   * `1.3.0 <https://github.com/real-logic/aeron/releases/tag/1.3.0>`_
2327   * `1.4.0 <https://github.com/real-logic/aeron/releases/tag/1.4.0>`_
2328   * `1.5.0 <https://github.com/real-logic/aeron/releases/tag/1.5.0>`_
2329   * `1.5.1 <https://github.com/real-logic/aeron/releases/tag/1.5.1>`_
2330   * `1.5.2 <https://github.com/real-logic/aeron/releases/tag/1.5.2>`_
2331   * `1.6.0 <https://github.com/real-logic/aeron/releases/tag/1.6.0>`_
2332   * `1.7.0 <https://github.com/real-logic/aeron/releases/tag/1.7.0>`_
2333
2334 * Agrona 0.9.5 → 0.9.12; release notes:
2335
2336   * `0.9.6 <https://github.com/real-logic/Agrona/releases/tag/0.9.6>`_
2337   * `0.9.7 <https://github.com/real-logic/Agrona/releases/tag/0.9.7>`_
2338   * `0.9.8 <https://github.com/real-logic/Agrona/releases/tag/0.9.8>`_
2339   * `0.9.9 <https://github.com/real-logic/Agrona/releases/tag/0.9.9>`_
2340   * `0.9.10 <https://github.com/real-logic/Agrona/releases/tag/0.9.10>`_
2341   * `0.9.11 <https://github.com/real-logic/Agrona/releases/tag/0.9.11>`_
2342   * `0.9.12 <https://github.com/real-logic/Agrona/releases/tag/0.9.12>`_
2343
2344 * Akka 2.5.5 → 2.5.11; release notes:
2345
2346   * `2.5.6 <https://akka.io/blog/news/2017/09/28/akka-2.5.6-released>`_
2347   * `2.5.7 <https://akka.io/blog/news/2017/11/17/akka-2.5.7-released>`_
2348   * `2.5.8 <https://akka.io/blog/news/2017/12/08/akka-2.5.8-released>`_
2349   * `2.5.9 <https://akka.io/blog/news/2018/01/11/akka-2.5.9-released-2.4.x-end-of-life>`_
2350   * `2.5.10 <https://akka.io/blog/news/2018/02/23/akka-2.5.10-released>`_
2351   * `2.5.11 <https://akka.io/blog/news/2018/02/28/akka-2.5.11-released>`_
2352
2353 * Commons Lang 3 `3.6 → 3.7 <http://www.apache.org/dist/commons/lang/RELEASE-NOTES.txt>`_
2354
2355 * Guava 23.3 → 23.6; release notes:
2356
2357   * `23.4 <https://github.com/google/guava/releases/tag/v23.4>`_
2358   * `23.5 <https://github.com/google/guava/releases/tag/v23.5>`_
2359   * `23.6 <https://github.com/google/guava/releases/tag/v23.6>`_
2360
2361 * H2 database `1.4.193 → 1.4.196 <http://www.h2database.com/html/changelog.html>`_
2362
2363 * Jacoco `0.7.9 → 0.8.0 <https://github.com/jacoco/jacoco/releases/tag/v0.8.0>`_
2364
2365 * Javassist `3.21.0 → 3.22.0 <https://github.com/jboss-javassist/javassist/compare/rel_3_21_0_ga...rel_3_22_0_ga>`_
2366
2367 * lmax-disruptor 3.3.7 → 3.3.10; release notes:
2368
2369   * `3.3.8 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.3.8>`_
2370   * `3.3.9 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.3.9>`_
2371   * `3.3.10 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.3.10>`_
2372
2373 * Netty 4.1.16 → 4.1.22; release notes:
2374
2375   * `4.1.17 <http://netty.io/news/2017/11/08/4-0-53-Final-4-1-17-Final.html>`_
2376   * `4.1.18 <http://netty.io/news/2017/12/11/4-0-54-Final-4-1-18-Final.html>`_
2377   * `4.1.19 <http://netty.io/news/2017/12/18/4-1-19-Final.html>`_
2378   * `4.1.20 <http://netty.io/news/2018/01/22/4-0-55-Final-4-1-20-Final.html>`_
2379   * `4.1.21 <http://netty.io/news/2018/02/05/4-0-56-Final-4-1-21-Final.html>`_
2380   * `4.1.22 <http://netty.io/news/2018/02/21/4-1-22-Final.html>`_
2381
2382 * Scala `2.12.4 → 2.12.5 <http://www.scala-lang.org/news/2.12.5>`_
2383
2384 * Typesafe Config `0.2.1 → 0.2.2 <https://github.com/typesafehub/config/blob/master/NEWS.md>`_
2385
2386 The following Maven plugins have been upgraded:
2387
2388 * FindBugs 3.0.4 → 3.0.5
2389
2390 * Git commit id 2.2.2 → 2.2.4; release notes:
2391
2392   * `2.2.3 <https://github.com/ktoso/maven-git-commit-id-plugin/releases/tag/v2.2.3>`_
2393   * `2.2.4 <https://github.com/ktoso/maven-git-commit-id-plugin/releases/tag/v2.2.4>`_
2394
2395 Version 3.0.3
2396 -------------
2397
2398 This version fixes the following issues:
2399
2400 * `ODLPARENT-136`_: ``features-test`` needs ``org.osgi.compendium``.
2401
2402 * Jackson dependencies are declared using ``jackson-bom`` to ensure all they
2403   remain consistent.
2404
2405 * ``find-duplicate-classpath-entries`` is run in the “verify” phase rather than
2406   the “validate” phase, which is too early.
2407
2408 * The version of Jetty we pull in is now aligned with that declared in Karaf,
2409   resolving a number of restart and dependency issues.
2410
2411 * Pulling in the ``wrap`` feature unconditionally is no longer necessary, so
2412   ``karaf4-parent`` no longer does so.
2413
2414 * ``metainf-services`` are declared with scope “provided” to avoid their being
2415   included in downstream features (it’s a build-time dependency only).
2416
2417 * ``leveldb-api`` is excluded from ``odl-akka-leveldb-0.7``, and ``jsr250-api``
2418   from ``enunciate-core-annotations``, to avoid duplicate having classes on the
2419   classpath.
2420
2421 * Since the ``ssh`` feature is excluded from generated features, our Karaf
2422   need to enable it at boot in all cases.
2423
2424 * ``bundle-test-lib`` is now a bundle.
2425
2426 * Since we use static SLF4J loggers, the ``SLF4J_LOGGER_SHOULD_BE_NON_STATIC``
2427   rule needs to be disabled in our FindBugs configuration (this allows
2428   downstream projects to enable ``findbugs-slf4j`` without having to deal with
2429   all the resulting false-positives).
2430
2431 * ``org.apache.karaf.scr.management`` is white-listed in SFT to avoid failures
2432   apparently related to that component (which we don’t care about).
2433
2434 .. _ODLPARENT-136: https://jira.opendaylight.org/browse/ODLPARENT-136
2435
2436 This version upgrades the following third-party dependencies:
2437
2438 * `Antlr 4.7 → 4.7.1`_
2439
2440 * `BouncyCastle 1.58 → 1.59`_
2441
2442 * Jersey 1.17 → 1.19.4 (additionally available as the ``odl-jersey-1`` feature)
2443
2444 * Jolokia 1.3.7 → 1.5.0
2445
2446 * Karaf 4.1.3 → 4.1.5; release notes:
2447
2448   * `Karaf 4.1.4`_
2449   * `Karaf 4.1.5`_
2450
2451 .. _Antlr 4.7 → 4.7.1: https://github.com/antlr/antlr4/releases/tag/4.7.1
2452 .. _BouncyCastle 1.58 → 1.59: https://www.bouncycastle.org/releasenotes.html
2453 .. _Karaf 4.1.4: https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12341702
2454 .. _Karaf 4.1.5: https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12342294
2455
2456 Version 3.0.2
2457 -------------
2458
2459 This version fixes the following issues:
2460
2461 * SingleFeatureTest uses the configured local Maven repository for Pax Exam.
2462
2463 * JavaDoc links are disabled for now to `speed up builds`_. A new
2464   ``javadoc-links`` profile enables the links.
2465
2466 * Conditional feature dependencies are processed, ensuring our
2467   `distribution is complete`_.
2468
2469 * Startup features are `adjusted for Karaf 4.1`_, avoiding unnecessary
2470   refreshes.
2471
2472 * The ``hiddenField`` Checkstyle check is disabled for abstract methods.
2473
2474 * The default logging configuration uses Log4J2, which is the new default in
2475   Karaf 4.1.
2476
2477 .. _speed up builds: https://jira.opendaylight.org/browse/ODLPARENT-121
2478 .. _distribution is complete: https://jira.opendaylight.org/browse/ODLPARENT-133
2479 .. _adjusted for Karaf 4.1: https://jira.opendaylight.org/browse/ODLPARENT-134
2480
2481 This version upgrades the following dependencies or plugins:
2482
2483 * ``maven-enforcer-plugin`` 1.4.1 → 3.0.0-M1
2484
2485 * ``maven-javadoc-plugin`` 3.0.0-M1 → 3.0.0
2486
2487 Version 3.0.1
2488 -------------
2489
2490 This version fixes the following issues:
2491
2492 * Karaf pulls in an invalid Hibernate feature repository, breaking downstream
2493   dependencies pulling in the “war” feature. ``populate-local-repo`` corrects
2494   the repository dependency.
2495
2496
2497 Version 3.0.0
2498 -------------
2499
2500 Compiler settings
2501 ~~~~~~~~~~~~~~~~~
2502
2503 Build now show compiler warnings and deprecation warnings. This doesn't affect
2504 the result or require any changes currently, it just makes the issues more
2505 visible.
2506
2507 New Checkstyle rules
2508 ~~~~~~~~~~~~~~~~~~~~
2509
2510 Checkstyle has been upgraded from 7.6 to 8.4 (see the
2511 `Checkstyle release notes`_ for details), and Sevntu from 1.21.0 to 1.24.2
2512 (note that the latter's group identifier changed from
2513 ``com.github.sevntu.checkstyle`` to ``com.github.sevntu-checkstyle``; you
2514 might need to update your IDE's configuration).
2515
2516 The following Checkstyle rules are enabled; this might require changes in
2517 projects which enforce Checkstyle validation:
2518
2519 * `AvoidHidingCauseExceptionCheck`_
2520 * `FinalClass`_: utility classes must be declared ``final``
2521 * `HiddenField`_: fields must not be shadowed
2522 * `HideUtilityClassConstructor`_: utility classes must hide their constructor
2523
2524 .. _Checkstyle release notes: http://checkstyle.sourceforge.net/releasenotes.html
2525
2526 .. _AvoidHidingCauseExceptionCheck: http://sevntu-checkstyle.github.io/sevntu.checkstyle/apidocs/com/github/sevntu/checkstyle/checks/coding/AvoidHidingCauseExceptionCheck.html
2527 .. _FinalClass: http://checkstyle.sourceforge.net/config_design.html#FinalClass
2528 .. _HiddenField: http://checkstyle.sourceforge.net/config_coding.html#HiddenField
2529 .. _HideUtilityClassConstructor: http://checkstyle.sourceforge.net/config_design.html#HideUtilityClassConstructor
2530
2531 Karaf
2532 ~~~~~
2533
2534 Karaf has been upgraded to 4.1.3. This should be transparent for dependent
2535 projects.
2536
2537 Karaf distributions
2538 ~~~~~~~~~~~~~~~~~~~
2539
2540 * When building a Karaf distribution using ``karaf4-parent``, projects can
2541   specify which archives to build: the ``karaf.archiveZip`` property will
2542   enable ZIP files if true, and ``karaf.archiveTarGz`` will enable
2543   gzip-compressed tarballs if true. By default both are enabled.
2544
2545 * Our Karaf distribution provides Bouncy Castle at startup. Auto-generated
2546   feature descriptors take this into account (they won't embed a Bouncy
2547   Castle dependency).
2548
2549 Feature removals
2550 ~~~~~~~~~~~~~~~~
2551
2552 * The ``odl-triemap-0.2`` feature wrapping
2553   ``com.github.romix:java-concurrent-hash-trie-map`` was rendered obsolete by
2554   YANG Tools' implementation and has been removed.
2555
2556 Feature additions
2557 ~~~~~~~~~~~~~~~~~
2558
2559 * ``odl-javassist-3`` provides Javassist in a feature.
2560
2561 * ``odl-jung-2.1`` provides `JUNG`_ in a feature.
2562
2563 .. _JUNG: http://jung.sourceforge.net/
2564
2565 Upstream version upgrades
2566 ~~~~~~~~~~~~~~~~~~~~~~~~~
2567
2568 The following upstream dependencies have been upgraded:
2569
2570 * Akka 2.4.18 → 2.5.4; release notes:
2571
2572   * `Akka 2.5.0`_
2573   * `Akka 2.5.1`_
2574   * `Akka 2.5.2`_
2575   * `Akka 2.5.3`_
2576   * `Akka 2.5.4`_
2577
2578 * `Awaitility 2 → 3`_
2579
2580 * `Bouncy Castle 1.57 → 1.58`_
2581
2582 * `Commons Codec 1.10 → 1.11`_
2583
2584 * `Commons File Upload 1.3.2 → 1.3.3`_
2585
2586 * `Commons IO 2.5 → 2.6`_
2587
2588 * Eclipse JDT annotations 2.0.0 → 2.1.0
2589
2590 * Felix Dependency Manager 4.3.0 → 4.4.1
2591 * Felix Dependency Manager Shell 4.0.4 → 4.0.6
2592 * Felix Metatype 1.1.2 → 1.1.6
2593
2594 * `Google Truth 0.28 → 0.36`_ (with the Java 8 extensions)
2595
2596 * `Gson 2.7 → 2.8.2`_
2597
2598 * Guava 22 → 23.3 along with the associated feature name change from
2599   ``odl-guava-22`` to ``odl-guava-23`` (dependent packages *must* change their
2600   dependency); release notes:
2601
2602   * `Guava 23`_
2603   * `Guava 23.1`_
2604   * `Guava 23.2`_
2605   * `Guava 23.3`_
2606
2607 * Immutables 2.4.2 → 2.5.6
2608
2609 * Jackson 2.3.2 → 2.8.9
2610
2611 * Jacoco 0.7.7 → 0.7.9; release notes:
2612
2613   * `Jacoco 0.7.8`_
2614   * `Jacoco 0.7.9`_
2615
2616 * Jacoco Listeners 2.4 → 3.8
2617
2618 * `Javassist 3.20.0 → 3.21.0`_
2619
2620 * `Jettison 1.3.7 → 1.3.8`_
2621
2622 * `Jolokia 1.3.6 → 1.3.7`_
2623
2624 * `JSONassert 1.3.0 → 1.5.0`_
2625
2626 * `logback 1.2.2 → 1.2.3`_
2627
2628 * `LMAX Disruptor 3.3.6 → 3.3.7`_
2629
2630 * Netty 4.1.8 → 4.1.16; release notes:
2631
2632   * `Netty 4.1.9`_
2633   * `Netty 4.1.10`_
2634   * `Netty 4.1.11`_
2635   * `Netty 4.1.12`_
2636   * `Netty 4.1.13`_
2637   * `Netty 4.1.14`_
2638   * `Netty 4.1.15`_
2639   * `Netty 4.1.16`_
2640
2641 * `Pax URL 2.5.2 → 2.5.3`_
2642
2643 * Scala 2.11.11 → 2.12.4; release notes:
2644
2645   * `Scala 2.12.0`_
2646   * `Scala 2.12.1`_
2647   * `Scala 2.12.2`_
2648   * `Scala 2.12.3`_
2649   * `Scala 2.12.4`_
2650
2651 * Servlet API 3.0.1 → 3.1.0
2652
2653 * `SLF4J 1.7.21 → 1.7.25`_
2654
2655 * `webcohesion enunciate 2.6.0 → 2.10.1`_
2656
2657 * `Xtend 2.12 → 2.13`_
2658
2659 .. _Akka 2.5.0: http://akka.io/blog/news/2017/04/13/akka-2.5.0-released
2660 .. _Akka 2.5.1: http://akka.io/blog/news/2017/05/02/akka-2.5.1-released
2661 .. _Akka 2.5.2: http://akka.io/blog/news/2017/05/24/akka-2.5.2-released
2662 .. _Akka 2.5.3: http://akka.io/blog/news/2017/06/19/akka-2.5.3-released
2663 .. _Akka 2.5.4: http://akka.io/blog/news/2017/08/10/akka-2.5.4-released
2664
2665 .. _Awaitility 2 → 3: https://github.com/awaitility/awaitility/wiki/ReleaseNotes30
2666
2667 .. _Bouncy Castle 1.57 → 1.58: https://www.bouncycastle.org/releasenotes.html
2668
2669 .. _Commons Codec 1.10 → 1.11: http://www.apache.org/dist/commons/codec/RELEASE-NOTES.txt
2670
2671 .. _Commons File Upload 1.3.2 → 1.3.3: http://www.apache.org/dist/commons/fileupload/RELEASE-NOTES.txt
2672
2673 .. _Commons IO 2.5 → 2.6: http://www.apache.org/dist/commons/io/RELEASE-NOTES.txt
2674
2675 .. _Google Truth 0.28 → 0.36: https://github.com/google/truth/releases
2676
2677 .. _Gson 2.7 → 2.8.2: https://github.com/google/gson/blob/master/CHANGELOG.md
2678
2679 .. _Guava 23: https://github.com/google/guava/wiki/Release23
2680 .. _Guava 23.1: https://github.com/google/guava/releases/tag/v23.1
2681 .. _Guava 23.2: https://github.com/google/guava/releases/tag/v23.2
2682 .. _Guava 23.3: https://github.com/google/guava/releases/tag/v23.3
2683
2684 .. _Jacoco 0.7.8: https://github.com/jacoco/jacoco/releases/tag/v0.7.8
2685 .. _Jacoco 0.7.9: https://github.com/jacoco/jacoco/releases/tag/v0.7.9
2686
2687 .. _Javassist 3.20.0 → 3.21.0: https://github.com/jboss-javassist/javassist/compare/rel_3_20_0_ga...rel_3_21_0_ga
2688
2689 .. _Jettison 1.3.7 → 1.3.8: https://github.com/jettison-json/jettison/compare/jettison-1.3.7...jettison-1.3.8
2690
2691 .. _Jolokia 1.3.6 → 1.3.7: https://github.com/rhuss/jolokia/releases/tag/v1.3.7
2692
2693 .. _JSONassert 1.3.0 → 1.5.0: https://github.com/skyscreamer/JSONassert/releases
2694
2695 .. _logback 1.2.2 → 1.2.3: https://logback.qos.ch/news.html
2696
2697 .. _LMAX Disruptor 3.3.6 → 3.3.7: https://github.com/LMAX-Exchange/disruptor/releases/tag/3.3.7
2698
2699 .. _Netty 4.1.9: http://netty.io/news/2017/03/10/4-0-45-Final-4-1-9-Final.html
2700 .. _Netty 4.1.10: http://netty.io/news/2017/04/30/4-0-46-Final-4-1-10-Final.html
2701 .. _Netty 4.1.11: http://netty.io/news/2017/05/12/4-0-47-Final-4-1-11-Final.html
2702 .. _Netty 4.1.12: http://netty.io/news/2017/06/09/4-0-48-Final-4-1-12-Final.html
2703 .. _Netty 4.1.13: http://netty.io/news/2017/07/06/4-0-49-Final-4-1-13-Final.html
2704 .. _Netty 4.1.14: http://netty.io/news/2017/08/03/4-0-50-Final-4-1-14-Final.html
2705 .. _Netty 4.1.15: http://netty.io/news/2017/08/25/4-0-51-Final-4-1-15-Final.html
2706 .. _Netty 4.1.16: http://netty.io/news/2017/09/25/4-0-52-Final-4-1-16-Final.html
2707
2708 .. _Pax URL 2.5.2 → 2.5.3: https://ops4j1.jira.com/browse/PAXURL-345?jql=project%20%3D%20PAXURL%20AND%20fixVersion%20%3D%202.5.3
2709
2710 .. _Scala 2.12.0: https://github.com/scala/scala/releases/tag/v2.12.0
2711 .. _Scala 2.12.1: https://github.com/scala/scala/releases/tag/v2.12.1
2712 .. _Scala 2.12.2: https://github.com/scala/scala/releases/tag/v2.12.2
2713 .. _Scala 2.12.3: https://github.com/scala/scala/releases/tag/v2.12.3
2714 .. _Scala 2.12.4: https://github.com/scala/scala/releases/tag/v2.12.4
2715
2716 .. _SLF4J 1.7.21 → 1.7.25: https://www.slf4j.org/news.html
2717
2718 .. _webcohesion enunciate 2.6.0 → 2.10.1: https://github.com/stoicflame/enunciate/releases
2719
2720 .. _Xtend 2.12 → 2.13: https://www.eclipse.org/xtend/releasenotes.html
2721
2722 Upstream version additions
2723 ~~~~~~~~~~~~~~~~~~~~~~~~~~
2724
2725 The following upstream dependencies have been added to dependency management:
2726
2727 * Commons Text, ``org.apache.commons:commons-text`` (this will allow downstreams
2728   to migrate from ``commons-lang3``\’s ``WordUtils``, which is deprecated)
2729
2730 Upstream version removals
2731 ~~~~~~~~~~~~~~~~~~~~~~~~~
2732
2733 The following upstream dependencies have been removed from dependency
2734 management (they are obsolete and unused):
2735
2736 * Chameleon MBeans
2737 * Eclipse Link
2738 * Equinox HTTP service bridge
2739 * ``equinoxSDK381`` artifacts
2740 * Coda Hale Metrics, which are mostly unused and should eventually be wrapped
2741   by InfraUtils
2742 * ``com.google.code.findbugs:jsr305`` (which *must not* be used; this is
2743   enforced — ``annotations`` should be used instead)
2744 * Felix File Install and Web Console
2745 * Gemini Web
2746 * Orbit
2747 * ``org.mockito:mockito-all`` (which *must not* be used; this is enforced —
2748   ``mockito-core`` should be used instead)
2749 * Spring Framework
2750 * ``txw2``
2751 * Xerces
2752 * ``xml-apis``
2753
2754 Plugin version upgrades
2755 ~~~~~~~~~~~~~~~~~~~~~~~
2756
2757 The following plugins have been upgraded:
2758
2759 * ``org.apache.servicemix.tooling:depends-maven-plugin`` 1.3.1 → 1.4.0
2760 * ``org.apache.felix:maven-bundle-plugin`` 2.4.0 → 3.3.0
2761 * ``maven-compiler-plugin`` 3.6.1 → 3.7.0
2762 * ``maven-dependency-plugin`` 3.0.1 → 3.0.2
2763 * ``maven-enforcer-plugin`` 1.4.1 → 3.0.0-M1
2764 * ``maven-failsafe-plugin`` 2.18.1 → 2.20.1
2765 * ``maven-javadoc-plugin`` 2.10.4 → 3.0.0-M1
2766 * ``maven-shade-plugin`` 2.4.3 → 3.1.0
2767
2768 New plugins
2769 ~~~~~~~~~~~
2770
2771 * The `Maven Find Duplicates`_ plugin can be enabled by setting the
2772   ``duplicate-finder.skip`` property to ``false``.
2773
2774 * The SpotBugs_ Maven plugin can now be used instead of the FindBugs plugin
2775   (both are available, so no change is required). To use SpotBugs, replace
2776   ``org.codehaus.mojo:findbugs-maven-plugin`` with
2777   ``com.github.spotbugs:spotbugs-maven-plugin``.
2778
2779 .. _Maven Find Duplicates: https://github.com/basepom/duplicate-finder-maven-plugin/
2780
2781 .. _SpotBugs: https://spotbugs.github.io/