docs/NEWS.rst

   1 ========================
   2 ODL Parent release notes
   3 ========================
   4
   5 Version 6.0.1
   6 -------------
   7
   8 Version 6.0.0
   9 -------------
  10 This is a major upgrade from version 5, with breaking changes; projects will
  11 need to make changes to upgrade to this version.
  12
  13 Java 11 is required
  14 ~~~~~~~~~~~~~~~~~~~
  15 This release sets ``maven.compiler.release=11`` and enforces that the JDK used to build
  16 is Java 11+. As there may be issues with various maven plugins when faced with JDK9+
  17 constructs and JDK11+ classes, target release can be controlled on a per-artifact
  18 basis (i.e. target Java 10 with ``maven.compiler.release=10`` property).
  19
  20 This release has been validated with ``openjdk-11.0.4`` and is not supported on any lower
  21 version. As usual, we recommend using latest available JDK/JRE for Java 11 during development
  22 and deployment.
  23
  24 Checkstyle/SpotBugs/Modernizer run by default
  25 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  26 With this release code artifacts always run ``maven-checkstyle-plugin``, ``spotbugs-maven-plugin``
  27 and ``modernizer-maven-plugin``. Checkstyle and SpotBugs run in enforcing mode, i.e. will fail
  28 build if any violations are found. Modernizer is configured to report Java 8-compatible constructs
  29 and will not fail the build unless instructed to do so.
  30
  31 Behavior of each of these is controlled via a maven property on a per-artifact basis:
  32 * ``odlparent.checkstyle.enforce`` controls checkstyle enforcement: defaults to ``true``, but can be set to ``false``
  33 * ``odlparent.checkstyle.skip`` controls checkstyle invocation: defaults to ``false``, but can be set to ``true``
  34 * ``odlparent.spotbugs.enforce`` controls SpotBugs enforcement: defaults to ``true``, but can be set to ``false``
  35 * ``odlparent.spotbugs.skip`` controls SpotBugs invocation: defaults to ``false``, but can be set to ``true``
  36 * ``odlparent.modernizer.enforce`` controls modernizer enforcement: defaults to ``false``, but can be set to ``true``
  37 * ``odlparent.modernizer.skip`` controls modernizer invocation: defaults to ``false``, but can be set to ``true``
  38 * ``odlparent.modernizer.target`` controls modernizer Java version: defaults to ``1.8``, but can be set to ``1.11`` or similar
  39
  40 Bug fixes
  41 ~~~~~~~~~
  42
  43 * ``blueprint container`` had ``org.apache.aries.blueprint.preemptiveShutdown`` set to false
  44   to enable it to work with Config Subsystem. As that component is long gone, this property has
  45   been removed as part of `ODLPARENT-34 <https://jira.opendaylight.org/browse/ODLPARENT-34>`__.
  46   Furthermore, system properties related to Config Subsystem/NETCONF integration have been removed
  47   as well.
  48
  49 Upstream version removals
  50 ~~~~~~~~~~~~~~~~~~~~~~~~~
  51
  52 The following upstream dependencies have been removed from dependency management:
  53
  54 * com.google.code.findbugs/jsr305
  55
  56 Third-party dependencies
  57 ~~~~~~~~~~~~~~~~~~~~~~~~
  58
  59 The dependency on `xmlunit-assertj` and `modernizer-maven-annotations` has been added and the following
  60 dependencies have been upgraded:
  61
  62 * Akka 2.5.23 → 2.5.25, release notes:
  63   * `2.5.24 <https://akka.io/blog/news/2019/08/09/akka-2.5.24-released>`__
  64   * `2.5.25 <https://akka.io/blog/news/2019/08/20/akka-2.5.25-released>`__
  65
  66 * apache-sshd `2.2.0 → 2.3.0 <https://github.com/apache/mina-sshd/blob/master/docs/changes/2.3.0.md>`__
  67
  68 * Bouncy Castle `1.62 → 1.63 <https://www.bouncycastle.org/releasenotes.html>`__
  69
  70 * commons-beanutils `1.9.3 → 1.9.4 <https://www.apache.org/dist/commons/beanutils/RELEASE-NOTES.txt>`__
  71
  72 * commons-codec `1.12 → 1.13 <http://www.apache.org/dist/commons/codec/RELEASE-NOTES.txt>`__
  73
  74 * commons-text 1.6 → 1.8, release notes:
  75   * `1.7 <https://commons.apache.org/proper/commons-text/changes-report.html#a1.7>`__
  76   * `1.8 <https://commons.apache.org/proper/commons-text/changes-report.html#a1.8>`__
  77
  78 * Checkstyle 8.18 → 8.20, release notes:
  79   * `8.19 <https://checkstyle.org/releasenotes.html#Release_8.19>`__
  80   * `8.20 <https://checkstyle.org/releasenotes.html#Release_8.20>`__
  81
  82 * jackson-databind `2.9.9 → 2.9.9.3 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9#micro-patches>`__
  83
  84 * jaxb-api 2.2.8 → 2.3.0, aligning it with Karaf-provided version
  85
  86 * Netty 4.1.36 → 4.1.39, release notes:
  87   * `4.1.37 <https://netty.io/news/2019/06/28/4-1-37-Final.html>`__
  88   * `4.1.38 <https://netty.io/news/2019/07/24/4-1-38-Final.html>`__
  89   * `4.1.39 <https://netty.io/news/2019/08/13/4-1-39-Final.html>`__
  90
  91 * Sevntu 1.32.0 → 1.35.0, release notes:
  92   * `1.33.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.33.0>`__
  93   * `1.34.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.34.0>`__
  94   * `1.34.1 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.34.1>`__
  95   * `1.35.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.35.0>`__
  96
  97 * Scala 2.12.8 → 2.12.9, release notes:
  98   * `2.12.9 <https://github.com/scala/scala/releases/tag/v2.12.9>`__
  99   * `2.12.10 <https://github.com/scala/scala/releases/tag/v2.12.10>`__
 100
 101 * slf4j `1.7.25 → 1.7.28 <https://www.slf4j.org/news.html>`__
 102
 103 * triemap `1.0.5 → 1.0.6 <https://github.com/PantheonTechnologies/triemap/releases/tag/triemap-1.0.6>`__
 104
 105 * typesafe/ssl-config `0.3.7 → 0.3.8 <https://github.com/lightbend/ssl-config/compare/v0.3.7...v0.3.8>`__
 106
 107 * Xtend 1.17.1 → 1.19.0, release notes:
 108   * `1.18.0 <https://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2019/06/04/version-2-18-0>`__
 109   * `1.19.0 <https://www.eclipse.org/Xtext/releasenotes.html#/releasenotes/2019/09/03/version-2-19-0>`__
 110
 111 Plugin upgrades
 112 ~~~~~~~~~~~~~~~
 113
 114 * git-commit-id-plugin 2.2.6 → 3.0.1, release notes:
 115   * `3.0.0 <https://github.com/git-commit-id/maven-git-commit-id-plugin/releases/tag/v3.0.0>`__
 116   * `3.0.1 <https://github.com/git-commit-id/maven-git-commit-id-plugin/releases/tag/v3.0.1>`__
 117
 118 * maven-javadoc-plugin `3.1.0 → 3.1.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317529&version=12345060>`__
 119
 120 * pmd-maven-plugin `3.11.0 → 3.12.0 <https://blogs.apache.org/maven/entry/apache-maven-pmd-plugin-version1>`__
 121
 122 * spotbugs-maven-plugin 3.1.11  → 3.1.12.2, release notes:
 123   * `3.1.12 <https://github.com/spotbugs/spotbugs-maven-plugin/compare/spotbugs-maven-plugin-3.1.11...spotbugs-maven-plugin-3.1.12>`__
 124   * `3.1.12.1 <https://github.com/spotbugs/spotbugs-maven-plugin/releases/tag/spotbugs-maven-plugin-3.1.12.1>`__
 125   * `3.1.12.2 <https://github.com/spotbugs/spotbugs-maven-plugin/releases/tag/spotbugs-maven-plugin-3.1.12.2>`__
 126
 127 Version 5.0.1
 128 -------------
 129
 130 This is a bug-fix upgrade from version 5.0.0.
 131
 132 Third-party dependencies
 133 ~~~~~~~~~~~~~~~~~~~~~~~~
 134
 135 The following dependencies have been upgraded:
 136
 137 * Akka 2.5.21 → 2.5.23, release notes:
 138   * `2.5.22 <https://akka.io/blog/news/2019/04/03/akka-2.5.22-released>`__
 139   * `2.5.23 <https://akka.io/blog/news/2019/05/21/akka-2.5.23-released>`__
 140
 141 * asciidoctorj-diagram 1.5.12 → 1.5.16
 142
 143 * Bouncy Castle `1.61 → 1.62 <http://www.bouncycastle.org/releasenotes.html>`__
 144
 145 * commons-lang3 `3.8.1 → 3.9 <http://www.apache.org/dist/commons/lang/RELEASE-NOTES.txt>`__
 146
 147 * JaCoCo `0.8.3 → 0.8.4 <https://github.com/jacoco/jacoco/releases/tag/v0.8.4>`__
 148
 149 * Jackson `2.9.8 → 2.9.9 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.9>`__
 150
 151 * Jolokia 1.6.0 → 1.6.2, release notes:
 152   * `1.6.1 <https://jolokia.org/changes-report.html#a1.6.1>`__
 153   * `1.6.2 <https://jolokia.org/changes-report.html#a1.6.2>`__
 154
 155 * Mockito `2.25.0 → 2.25.1 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2251>`__
 156
 157 * Netty 4.1.34 → 4.1.36, release notes:
 158   * `4.1.35 <https://netty.io/news/2019/04/17/4-1-35-Final.html>`__
 159   * `4.1.36 <https://netty.io/news/2019/04/30/4-1-36-Final.html>`__
 160
 161 * PowerMock 2.0.0 → 2.0.2, release notes:
 162   * `2.0.1 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.1>`__
 163   * `2.0.2 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.2>`__
 164
 165 * Reactive Streams `1.0.1 → 1.0.2 <https://www.lightbend.com/blog/update-reactive-streams-102-released>`__
 166
 167 * scala-parser-combinators `1.1.1 → 1.1.2 <https://github.com/scala/scala-parser-combinators/releases/tag/v1.1.2>`__
 168
 169 * Sevntu `1.32.0 → 1.33.0 <http://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.33.0>`__
 170
 171 * Typesafe Config `1.3.2 → 1.3.3 <https://github.com/lightbend/config/releases/tag/v1.3.3>`__
 172
 173 * triemap `1.0.4 → 1.0.5 <https://github.com/PantheonTechnologies/triemap/releases/tag/triemap-1.0.5>`__
 174
 175 * XBean finder 4.12 → 4.14, release notes:
 176   * `4.13 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?version=12344253&projectId=12310312>`__
 177   * `4.14 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310312&version=12345220>`__
 178
 179 * xmlunit `2.6.2 → 2.6.3 <https://github.com/xmlunit/xmlunit/releases/tag/v2.6.3>`__
 180
 181 * Xtend `2.17.0 → 2.17.1 <https://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2019/04/03/version-2-17-1>`__
 182
 183 Plugin upgrades
 184 ~~~~~~~~~~~~~~~
 185
 186 * maven-archetype-plugin 3.0.1 → 3.1.1, release notes:
 187   * `3.1.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317122&version=12340346>`__
 188   * `3.1.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317122&version=12345450>`__
 189
 190 * maven-bundle-plugin `4.1.0 → 4.2.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310100&version=12345047>`__
 191
 192 * maven-checkstyle-plugin `3.1.0 → 3.1.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317223&version=12342397>`__
 193
 194 * maven-compiler-plugin `3.8.0 → 3.8.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317225&version=12343484>`__
 195
 196 * 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/>`__
 197
 198 * maven-jar-plugin `3.1.1 → 3.1.2 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317526&version=12344629>`__
 199
 200 * maven-plugin-plugin `3.5.2 → 3.6.0 <https://blogs.apache.org/maven/entry/apache-maven-plugin-tools-version1>`__
 201
 202 * maven-source-plugin `3.0.1 → 3.1.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317924&version=12336941>`__
 203
 204 * maven-surefire-plugin 2.22.1 → 2.22.2
 205
 206 New plugins
 207 ~~~~~~~~~~~
 208
 209 * ``modernizer-maven-plugin`` declared, allowing downstreams to more easily activate it,
 210   and so detect code which should be updated to more modern equivalent.
 211
 212 New features
 213 ~~~~~~~~~~~~
 214
 215 * ``odl-caffeine-2`` provides a pre-packaged feature for the Caffeine caching framework,
 216   along with the Guava compabitility layer.
 217
 218 Version 5.0.0
 219 -------------
 220
 221 This is a major upgrade from version 4, with breaking changes; projects will
 222 need to make changes to upgrade to this version.
 223
 224 The most significant change is `ODLPARENT-198 <https://jira.opendaylight.org/browse/ODLPARENT-198>`__,
 225 which removes JSR305 from default dependencies and does not present it at class path by default.
 226
 227 Deleted artifacts
 228 ~~~~~~~~~~~~~~~~~
 229
 230 ``findbugs`` has been removed, as its only purpose was to provide FindBugs
 231 rule definitions. Equivalent definitions are available in ``spotbugs``.
 232
 233 Bug fixes
 234 ~~~~~~~~~
 235
 236 * ``blueprint-maven-plugin`` used to scan the entire classpath, resulting in potential conflicts
 237   across projects. Scanning is now limited to ``${project.groupId}``, limiting conflict domain
 238   to single project. See `ODLPARENT-109 <https://jira.opendaylight.org/browse/ODLPARENT-109>`__.
 239
 240 * ``bundle-maven-plugin`` configuration ignored generated ServiceLoader service entries,
 241   which has now been fixed. See `ODLPARENT-197 <https://jira.opendaylight.org/browse/ODLPARENT-197>`__.
 242
 243 * Bundle tests are now enabled by default. See `ODLPARENT-158 <https://jira.opendaylight.org/browse/ODLPARENT-158>`__
 244   and `ODLPARENT-80 <https://jira.opendaylight.org/browse/ODLPARENT-80>`__ for details.
 245
 246 * Karaf log file rollover was not explictly set up, leading to inability to easily override
 247   the defaults. See `ODLPARENT-153 <https://jira.opendaylight.org/browse/ODLPARENT-153>`__ for details.
 248
 249 * Karaf log file used to use default maximum 16MiB file size, this has now been increased to 64MiB.
 250   See `ODLPARENT-154 <https://jira.opendaylight.org/browse/ODLPARENT-154>`__.
 251
 252 * ``features-test`` excluded opendaylight-karaf-empty's transitive dependencies, leading
 253   to the need to re-declare them in single-feature-parent. This re-declaration was forgotten
 254   in for ``bcpkix-framework-ext`` and ``bcprov-framework-ext`` bundles, which lead to them
 255   not being present in the local repository. See `ODLPARENT-130 <https://jira.opendaylight.org/browse/ODLPARENT-130>`__.
 256
 257 Upstream version removals
 258 ~~~~~~~~~~~~~~~~~~~~~~~~~
 259
 260 The following upstream dependencies have been removed from dependency management:
 261
 262 * cassandra-driver-core
 263
 264 * org.codehaus.enunciate/enunciate-core-annotations
 265
 266 * org.jboss.resteasy/jaxrs-api
 267
 268 * org.json/json
 269
 270 * org.osgi/org.osgi.compendium
 271
 272 Removed features
 273 ~~~~~~~~~~~~~~~~
 274
 275 * odl-jersey-1
 276
 277 * ``features-akka`` feature repository has been integrated into ``features-odlparent``
 278
 279 Third-party dependencies
 280 ~~~~~~~~~~~~~~~~~~~~~~~~
 281
 282 The following dependencies have been upgraded:
 283
 284 * apache-sshd `2.0.0 → 2.2.0 <https://github.com/apache/mina-sshd/compare/sshd-2.0.0...sshd-2.2.0>`__
 285
 286 * Aeron 1.12.0 → 1.15.3, release notes:
 287   * `1.13.0 <https://github.com/real-logic/aeron/releases/tag/1.13.0>`__
 288   * `1.14.0 <https://github.com/real-logic/aeron/releases/tag/1.14.0>`__
 289   * `1.15.0 <https://github.com/real-logic/aeron/releases/tag/1.15.0>`__
 290   * `1.15.1 <https://github.com/real-logic/aeron/releases/tag/1.15.1>`__
 291   * `1.15.2 <https://github.com/real-logic/aeron/releases/tag/1.15.2>`__
 292   * `1.15.3 <https://github.com/real-logic/aeron/releases/tag/1.15.3>`__
 293
 294 * Agrona 0.9.27 → 0.9.33, release notes:
 295   * `0.9.28 <https://github.com/real-logic/agrona/releases/tag/0.9.28>`__
 296   * `0.9.29 <https://github.com/real-logic/agrona/releases/tag/0.9.29>`__
 297   * `0.9.30 <https://github.com/real-logic/agrona/releases/tag/0.9.30>`__
 298   * `0.9.31 <https://github.com/real-logic/agrona/releases/tag/0.9.31>`__
 299   * `0.9.32 <https://github.com/real-logic/agrona/releases/tag/0.9.32>`__
 300   * `0.9.33 <https://github.com/real-logic/agrona/releases/tag/0.9.33>`__
 301
 302 * Akka 2.5.19 → 2.5.21, release notes:
 303   * `2.5.20 <https://akka.io/blog/news/2019/01/29/akka-2.5.20-released>`__
 304   * `2.5.21 <https://akka.io/blog/news/2019/02/13/akka-2.5.21-released>`__
 305
 306 * antl4r `4.7.1 → 4.7.2 <https://github.com/antlr/antlr4/releases/tag/4.7.2>`__
 307
 308 * asciidoctorj-diagram 1.5.11 → 1.5.12
 309
 310 * Bouncy Castle `1.60 → 1.61 <http://www.bouncycastle.org/releasenotes.html>`__
 311
 312 * checkstyle 8.16 → 8.18, release notes:
 313   * `8.17 <http://checkstyle.sourceforge.net/releasenotes.html#Release_8.17>`__
 314   * `8.18 <http://checkstyle.sourceforge.net/releasenotes.html#Release_8.18>`__
 315
 316 * commons-codec `1.11 → 1.12 <http://www.apache.org/dist/commons/codec/RELEASE-NOTES.txt>`__
 317
 318 * Google Error Prone 2.3.2 → 2.3.3
 319
 320 * Google Guava 25.1 → 27.1, release notes:
 321   * `26.0 <https://github.com/google/guava/releases/tag/v26.0>`__
 322   * `27.0 <https://github.com/google/guava/releases/tag/v27.0>`__
 323   * `27.0.1 <https://github.com/google/guava/releases/tag/v27.0.1>`__
 324   * `27.1 <https://github.com/google/guava/releases/tag/v27.1>`__
 325
 326 * Google Truth `0.42 → 0.43 <https://github.com/google/truth/releases/tag/release_0_43>`__
 327
 328 * h2 database `1.4.196 → 1.4.199 <http://www.h2database.com/html/changelog.html>`__
 329
 330 * Immutables `2.7.3 → 2.7.5 <https://github.com/immutables/immutables/#changelog>`__
 331
 332 * Javassist `3.24.0-GA → 3.24.1-GA <https://github.com/jboss-javassist/javassist/releases/tag/rel_3_24_1_ga>`__
 333
 334 * log4j2 `2.11.1 → 2.11.2 <https://github.com/apache/logging-log4j2/blob/log4j-2.11.2/RELEASE-NOTES.md>`__
 335
 336 * Mockito 2.23.4 → 2.25.0, release notes:
 337   * `2.24.0 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2240>`__
 338   * `2.25.0 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2250>`__
 339
 340 * Netty 4.1.32 → 4.1.34, release notes:
 341   * `4.1.32 <https://netty.io/news/2018/11/29/4-1-32-Final.html>`__
 342   * `4.1.33 <https://netty.io/news/2019/01/21/4-1-33-Final.html>`__
 343   * `4.1.34 <https://netty.io/news/2019/03/08/4-1-34-Final.html>`__
 344
 345 * OSGi 5.0.0 → 6.0.0
 346
 347 * Powermockito 1.7.4 → 2.0.0, release notes:
 348   * `2.0.0-beta.5 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.0-beta.5>`__
 349   * `2.0.0-RC.1 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.0-RC.1>`__
 350   * `2.0.0 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.0>`__
 351
 352 * SpotBugs `3.1.9 → 3.1.12 <https://github.com/spotbugs/spotbugs/blob/3.1.12/CHANGELOG.md>`__
 353
 354 * ThreeTen `1.4.0 → 1.5.0 <https://www.threeten.org/threeten-extra/changes-report.html#a1.5.0>`__
 355
 356 * Xtend `2.16.0 → 2.17.0 <http://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2019/03/05/version-2-17-0>`__
 357
 358 Plugin removals
 359 ~~~~~~~~~~~~~~~
 360
 361 * gmaven-plugin
 362
 363 * maven-findbugs-plugin
 364
 365 Plugin upgrades
 366 ~~~~~~~~~~~~~~~
 367
 368 * jacoco-maven-plugin `0.8.2 → 0.8.3 <https://github.com/jacoco/jacoco/releases/tag/v0.8.3>`__
 369
 370 * 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>`__
 371
 372 * 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>`__
 373
 374 * spotbugs-maven-plugin 3.1.8 → 3.1.11
 375
 376 Version 4.0.9
 377 -------------
 378
 379 This is a bug-fix upgrade from version 4.0.8.
 380
 381 Bug fixes
 382 ~~~~~~~~~
 383
 384 * ``karaf-plugin`` invocation in ``karaf4-parent`` caused previously
 385   patched features to be overwritten with their stock versions, referencing
 386   bundles which were not populated in the local repository. (See
 387   `ODLPARENT-194 <https://jira.opendaylight.org/browse/ODLPARENT-194>`__.)
 388
 389 * ``karaf-plugin`` version in ``karaf4-parent`` is now provided through
 390   plugin management so downstreams can override it without needing
 391   to repeat its configuration.
 392
 393 * ``karaf-plugin`` no longer reads features twice when running discovery,
 394   speeding up the process a bit.
 395
 396 * Recent versions of the SpotBugs Maven plugin use SLF4J 1.8 beta 2, which
 397   can’t use the 1.7.25 implementation we provide; we therefore provide an
 398   implementation of 1.8 beta 2 when SpotBugs is used. (See
 399   `ODLPARENT-184 <https://jira.opendaylight.org/browse/ODLPARENT-184>`__.)
 400
 401 New features
 402 ~~~~~~~~~~~~
 403
 404 * ``odl-woodstox`` wraps the Woodstox StAX implementation which is imposed on
 405   us by Karaf.
 406
 407 Version 4.0.8
 408 -------------
 409
 410 This is a bug-fix and minor upstream bump upgrade from version 4.0.7.
 411
 412 Bug fixes
 413 ~~~~~~~~~
 414
 415 * ``bcprov-ext-jdk15on`` is a superset of ``bcprov-jdk15on``, so there’s no
 416   need to ship both; we now only ship the former. In addition, we install the
 417   Bouncy Castle JARs in ``lib/boot`` so that they continue to be available on
 418   the boot classpath (JDK 9 removes the extension mechanism which was used
 419   previously), and provide the corresponding bundles from the boot classpath
 420   instead of using separate JARs in the system repository. (See
 421   `ODLPARENT-183 <https://jira.opendaylight.org/browse/ODLPARENT-183>`__ and
 422   `ODLPARENT-185 <https://jira.opendaylight.org/browse/ODLPARENT-185>`__.)
 423
 424 * A dependency check has been added to ensure that we don’t run into the
 425   TrieMap dependency bug in 4.0.6 again.
 426
 427 * Dependencies pulled in by features are now checked for convergence, and
 428   ``karaf-plugin`` warns when it finds diverging dependencies (the same
 429   artifact with two different versions). Upstream-provided features are
 430   patched to avoid the following divergences (and upgrade some dependencies in
 431   the process):
 432
 433   * Aries utilities 1.1.0/1.1.3 (upgraded to 1.1.3).
 434   * Commons Beanutils 1.8.3/1.9.3 (upgraded to 1.9.3).
 435   * Commons Codec 1.8/1.10 (upgraded to 1.11).
 436   * ``javax.mail`` 1.4.4/1.4.7 (upgraded to 1.4.7).
 437
 438   (See `ODLPARENT-189 <https://jira.opendaylight.org/browse/ODLPARENT-189>`__.)
 439
 440 New features
 441 ~~~~~~~~~~~~
 442
 443 * ``odl-dropwizard-metrics`` provides Dropwizard Metrics (which are also
 444   available in dependency management).
 445
 446 * ``enunciate-maven-plugin`` is added as the replacement for
 447   ``maven-enunciate-plugin``.
 448
 449 Third-party dependencies
 450 ~~~~~~~~~~~~~~~~~~~~~~~~
 451
 452 The following dependencies are no longer provided by the JVM, starting with
 453 version 11, but we make them available via dependency management for projects
 454 which need them:
 455
 456 * ``javax.annotation-api``.
 457
 458 * JAXB (``jaxb-core``, ``jaxb-impl``).
 459
 460 The following dependencies have been upgraded:
 461
 462 * Checkstyle `8.15 → 8.16 <https://checkstyle.org/releasenotes.html#Release_8.16>`__.
 463
 464 * Dependency Check `4.0.0 → 4.0.2 <https://github.com/jeremylong/DependencyCheck/blob/master/RELEASE_NOTES.md>`__.
 465
 466 * ``git-commit-id`` `2.2.5 → 2.2.6 <https://github.com/ktoso/maven-git-commit-id-plugin/releases>`__.
 467
 468 * Immutables 2.7.1 → 2.7.3:
 469
 470   * `2.7.2 <https://github.com/immutables/immutables#272-2018-11-05>`__.
 471   * `2.7.3 <https://github.com/immutables/immutables#273-2018-11-10>`__.
 472
 473   (2.7.4 breaks our Javadocs.)
 474
 475 * Jackson `2.9.7 → 2.9.8 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.8>`__.
 476
 477 Version 4.0.7
 478 -------------
 479
 480 This is a bug-fix release, correcting the ``triemap`` import declaration.
 481
 482 Version 4.0.6
 483 -------------
 484
 485 This is a bug-fix and minor upstream packaging upgrade from version 4.0.5.
 486
 487 Bug fixes
 488 ~~~~~~~~~
 489
 490 Single-feature-test was broken with JDK 9 and later and Karaf 4.2.2; this
 491 release adds the additional JVM configuration needed.
 492
 493 Third-party dependencies
 494 ~~~~~~~~~~~~~~~~~~~~~~~~
 495
 496 This release adds the ``triemap`` BOM to dependency management.
 497
 498 Version 4.0.5
 499 -------------
 500
 501 This is a bug-fix release: the Karaf Maven plugin, in version 4.2.2, is
 502 `broken <https://issues.apache.org/jira/browse/KARAF-6057>`__ in some cases we
 503 need in OpenDaylight; we revert to 4.2.1 in ``karaf4-parent`` to avoid this.
 504
 505 Version 4.0.4
 506 -------------
 507
 508 This is a bug-fix release, reverting the change made in 4.0.3 to handle
 509 building with either ``zip`` or ``tar.gz`` Karaf archives (which breaks
 510 builds in our infrastructure, without the empty Karaf archive).
 511
 512 Version 4.0.3
 513 -------------
 514
 515 This is a bug-fix and minor upstream bump upgrade from version 4.0.2.
 516
 517 Bug fixes
 518 ~~~~~~~~~
 519
 520 * Our FindBugs configuration for JDK 9 and later caused the plugin to run
 521   everywhere; instead, this version defines the ``findbugs.skip`` property to
 522   disable the plugin in modules where it would be used otherwise.
 523
 524 * The PowerMock declarations in dependency management missed
 525   ``powermock-api-mockito2``, which is necessary for modules using PowerMock
 526   with Mockito 2.
 527
 528 * The “quick” profile (``-Pq``) now skips SpotBugs.
 529
 530 * JSR-305 annotations are now optional, which fixes a number of issues when
 531   building with newer JDKs.
 532
 533 * We provide JAXB with JDK 11 and later (where it is no longer provided by the
 534   base platform).
 535
 536 * ``odlparent-artifacts`` has been updated to accurately represent the
 537   artifacts provided.
 538
 539 * ``javax.activation`` is now excluded from generated features (it’s provided
 540   on Karaf’s boot classpath).
 541
 542 * When the build is configured to build Karaf distributions in ``tar.gz``
 543   archives, but not ``zip`` archives, ``features-test`` used to fail; it will
 544   now used whichever is available
 545   (`ODLPARENT-174 <https://jira.opendaylight.org/browse/ODLPARENT-174>`__).
 546
 547 * Explicit GCs are disabled by default, so that calls to ``System.gc()`` are
 548   ignored
 549   (`ODLPARENT-175 <https://jira.opendaylight.org/browse/ODLPARENT-175>`__).
 550
 551 * Null checks are disabled in SpotBugs because of bad interactions with newer
 552   annotations and the bytecode produces by JDK 11 and later for
 553   ``try``-with-resources.
 554
 555 * Akka Persistence expects LevelDB 0.10, so we now pull in that version
 556   instead of 0.7.
 557
 558 Dependency convergence
 559 ~~~~~~~~~~~~~~~~~~~~~~
 560
 561 A number of dependencies have been added or constrained so that projects using
 562 this parent can enforce dependency convergence:
 563
 564 * Karaf’s ``framework`` feature is used as an import POM, so that we converge
 565   by default on the versions used in Karaf.
 566
 567 * The following dependencies have been added to dependency management:
 568
 569   * ``commons-beanutils``
 570   * the Checker Framework
 571   * Error Prone annotations
 572   * ``javax.activation``
 573   * ``xml-apis``
 574
 575 New features
 576 ~~~~~~~~~~~~
 577
 578 The following Karaf features have been added:
 579
 580 * ``odl-antlr4`` (providing ``antlr4-runtime``);
 581
 582 * ``odl-gson`` (providing ``gson``);
 583
 584 * ``odl-jersey-2`` (providing Jersey client, server, and container servlet,
 585   along with the necessary feature dependencies);
 586
 587 * ``odl-servlet-api`` (providing ``javax.servlet-api``);
 588
 589 * ``odl-stax2-api`` (providing ``stax2-api``);
 590
 591 * ``odl-ws-rs-api`` (providing ``javax.ws.rs-api``);
 592
 593 A new ``sonar-jacoco-aggregate`` profile can be used to produce Sonar reports
 594 with aggregated JaCoCo reports. Additionally, Sonar builds (run with
 595 ``-Dsonar``) are detected and run with a number of irrelevant plugins disabled.
 596
 597 Upstream version upgrades
 598 ~~~~~~~~~~~~~~~~~~~~~~~~~
 599
 600 * Akka 2.5.14 → 2.5.19 (and related ``ssl-config``, Aeron and Agrona upgrades):
 601
 602   * `2.5.15 <https://akka.io/blog/news/2018/08/24/akka-2.5.15-released>`__.
 603   * `2.5.16 <https://akka.io/blog/news/2018/08/29/akka-2.5.16-security-fix-released>`__.
 604   * `2.5.17 <https://akka.io/blog/news/2018/09/27/akka-2.5.17-released>`__.
 605   * `2.5.18 <https://akka.io/blog/news/2018/10/07/akka-2.5.18-released>`__.
 606   * `2.5.19 <https://akka.io/blog/news/2018/12/07/akka-2.5.19-released>`__.
 607
 608 * Commons Text `1.4 → 1.6 <http://www.apache.org/dist/commons/text/RELEASE-NOTES.txt>`__.
 609
 610 * Eclipse JDT annotations 2.2.0 → 2.2.100.
 611
 612 * Javassist 3.23.1 → 3.24.0.
 613
 614 * Karaf 4.2.1 → 4.2.2, with related upgrades.
 615
 616 * LMAX Disruptor `3.4.1 → 3.4.2 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.4.2>`__.
 617
 618 * Mockito `2.20.1 → 2.23.4 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md>`__.
 619
 620 * Netty 4.1.29 → 4.1.31:
 621
 622   * `4.1.30 <https://netty.io/news/2018/09/28/4-1-30-Final.html>`__.
 623   * `4.1.31 <https://netty.io/news/2018/10/30/4-1-31-Final.html>`__.
 624
 625 * Pax Exam 4.12.0 → 4.13.1.
 626
 627 * Scala 2.12.6 → 2.12.8:
 628
 629   * `2.12.7 <https://github.com/scala/scala/releases/tag/v2.12.7>`__.
 630   * `2.12.8 <https://github.com/scala/scala/releases/tag/v2.12.8>`__.
 631
 632 * Wagon HTTP 3.1.0 → 3.2.0.
 633
 634 * Xtend `2.14.0 → 2.16.0 <https://www.eclipse.org/xtend/releasenotes.html>`__.
 635
 636 Plugin version upgrades
 637 ~~~~~~~~~~~~~~~~~~~~~~~
 638
 639 * Asciidoctor `1.5.6 → 1.5.7.1 <https://github.com/asciidoctor/asciidoctor-maven-plugin/releases>`__
 640   (with related AsciidoctorJ upgrades).
 641
 642 * Bundle 4.0.0 → 4.1.0.
 643
 644 * Checkstyle `8.12 → 8.15 <https://checkstyle.org/releasenotes.html#Release_8.13>`__.
 645
 646 * DependencyCheck `3.3.2 → 4.0.0 <https://github.com/jeremylong/DependencyCheck/blob/master/RELEASE_NOTES.md>`__.
 647
 648 * Failsafe / Surefire `2.22.0 → 2.22.1 <https://blogs.apache.org/maven/entry/apache-maven-surefire-plugin-version1>`__.
 649
 650 * Help 3.1.0 → 3.1.1.
 651
 652 * JAR 3.1.0 → 3.1.1.
 653
 654 * PMD `3.10.0 → 3.11.0 <https://blogs.apache.org/maven/entry/apache-maven-pmd-plugin-3>`__.
 655
 656 * Remote Resources `1.5 → 1.6.0 <https://blogs.apache.org/maven/entry/apache-maven-remote-resources-plugin>`__.
 657
 658 * Shade
 659   `3.2.0 → 3.2.1 <https://blog.soebes.de/blog/2018/11/12/apache-maven-shade-plugin-version-3-dot-2-1-released/>`__.
 660
 661 * SpotBugs `3.1.6 → 3.1.9 <https://github.com/spotbugs/spotbugs/blob/release-3.1/CHANGELOG.md>`__.
 662
 663 * XBean finder 4.9 → 4.12.
 664
 665 * XTend 2.14.0 → 2.16.0.
 666
 667 Version 4.0.2
 668 -------------
 669
 670 This is a bug-fix and minor upstream bump upgrade from version 4.0.1.
 671
 672 Bug fixes
 673 ~~~~~~~~~
 674
 675 Previous releases overrode Karaf’s ``jre.properties``; this is no longer
 676 necessary, and was causing failures with Java 9 and later (our version of
 677 ``jre.properties`` didn’t have the appropriate settings for anything after
 678 Java 8). This release drops that override. See
 679 `ODLPARENT-168 <https://jira.opendaylight.org/browse/ODLPARENT-168>`__ for
 680 details.
 681
 682 Upstream version upgrades
 683 ~~~~~~~~~~~~~~~~~~~~~~~~~
 684
 685 * Commons Lang `3.8 → 3.8.1 <http://www.apache.org/dist/commons/lang/RELEASE-NOTES.txt>`__.
 686
 687 * Jackson `2.9.6 → 2.9.7 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.7>`__.
 688
 689 * Netty `4.1.28 → 4.1.29 <http://netty.io/news/2018/08/24/4-1-29-Final.html>`__.
 690
 691 Plugin version upgrades
 692 ~~~~~~~~~~~~~~~~~~~~~~~
 693
 694 * 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>`__.
 695
 696 * Javadoc `3.0.0 → 3.0.1 <https://blogs.apache.org/maven/entry/apache-maven-javadoc-plugin-version>`__.
 697
 698 * Jersey `2.22.2 → 2.25.1 <https://jersey.github.io/release-notes/2.25.html>`__,
 699   along with Glassfish JSON 1.0.4 → 1.1.2.
 700
 701 * Plugin 3.5 → 3.5.2:
 702
 703   * `3.5.1 <https://blog.soebes.de/blog/2018/01/22/apache-maven-plugin-tools-version-3-dot-5-1-released/>`__.
 704   * `3.5.2 <https://blog.soebes.de/blog/2018/05/26/apache-mave-plugin-tools-version-3-dot-5-2-released/>`__.
 705
 706 * Resources `3.0.1 → 3.1.0 <https://blogs.apache.org/maven/entry/apache-maven-resources-plugin-version>`__.
 707
 708 Version 4.0.1
 709 -------------
 710
 711 This is a bug-fix and minor upstream bump upgrade from version 4.0.0.
 712
 713 Bug fixes
 714 ~~~~~~~~~
 715
 716 The JaCoCo execution profile was incorrect, breaking Sonar; the report is now
 717 written correctly, so that Sonar can find it.
 718
 719 The Blueprint Maven plugin fails when it encounters Java 9 classes; this is
 720 fixed by forcefully upgrading its dependency on xbean-finder. See
 721 `ODLPARENT-167 <https://jira.opendaylight.org/browse/ODLPARENT-167>`__ for
 722 details.
 723
 724 Upstream version upgrades
 725 ~~~~~~~~~~~~~~~~~~~~~~~~~
 726
 727 * SpotBugs `3.1.6 → 3.1.7 <https://github.com/spotbugs/spotbugs/blob/release-3.1/CHANGELOG.md>`__.
 728
 729 Upstream version additions
 730 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 731
 732 * Mockito Inline is added alongside Mockito Core, to ensure that the versions
 733   are kept in sync.
 734
 735 Plugin version upgrades
 736 ~~~~~~~~~~~~~~~~~~~~~~~
 737
 738 * 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/>`__.
 739
 740 * 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/>`__.
 741
 742 * Dependency 3.0.2 → 3.1.1:
 743
 744   * `3.1.0 <https://blog.soebes.de/blog/2018/04/06/apache-maven-dependency-plugin-version-3-dot-1-0-released/>`__.
 745   * `3.1.1 <https://blog.soebes.de/blog/2018/05/24/apache-maven-dependency-plugin-version-3-dot-1-1-released/>`__.
 746
 747 * Dependency Check `3.3.1 → 3.3.2 <https://github.com/jeremylong/DependencyCheck/blob/master/RELEASE_NOTES.md>`__.
 748
 749 * 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>`__.
 750
 751 * Failsafe 2.20.1 → 2.22:
 752
 753   * `2.21 <https://blog.soebes.de/blog/2018/03/06/apache-maven-surefire-plugin-version-2-dot-21-released/>`__.
 754   * `2.22 <https://blog.soebes.de/blog/2018/06/16/apache-maven-surefire-plugin-version-2-dot-22-released/>`__.
 755
 756 * Help 2.2 → 3.1.0:
 757
 758   * `3.0.0 <https://blog.soebes.de/blog/2018/03/18/apache-maven-help-plugin-version-3-dot-0-0-released/>`__.
 759   * `3.0.1 <https://blog.soebes.de/blog/2018/03/28/apache-maven-help-plugin-version-3-dot-0-1-released/>`__.
 760   * `3.1.0 <https://blog.soebes.de/blog/2018/06/09/apache-maven-help-plugin-version-3-dot-1-0-released/>`__.
 761
 762 * Invoker 2.0.0 → 3.1.0:
 763
 764   * `3.0.0 <https://blog.soebes.de/blog/2017/05/24/apache-maven-invoker-plugin-version-3-dot-0-0-released/>`__.
 765   * `3.1.0 <https://blog.soebes.de/blog/2018/05/31/apache-maven-invoker-plugin-version-3-dot-1-0-released/>`__.
 766
 767 * 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/>`__.
 768
 769 * 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/>`__.
 770
 771 * 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/>`__.
 772
 773 * 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/>`__.
 774
 775 * Site `3.7 → 3.7.1 <https://blog.soebes.de/blog/2018/04/29/apache-maven-site-plugin-version-3-dot-7-1-released/>`__.
 776
 777 * Surefire 2.18.1 → 2.22.0:
 778
 779   * `2.19 <https://blog.soebes.de/blog/2015/10/19/apache-maven-surefire-plugin-version-2-dot-19-released/>`__.
 780   * `2.19.1 <https://blog.soebes.de/blog/2016/01/03/apache-maven-surefire-plugin-version-2-dot-19-dot-1-released/>`__.
 781   * `2.20 <https://blog.soebes.de/blog/2017/04/12/apache-maven-surefire-plugin-version-2-dot-20-released/>`__.
 782   * `2.21 <https://blog.soebes.de/blog/2018/03/06/apache-maven-surefire-plugin-version-2-dot-21-released/>`__.
 783   * `2.22 <https://blog.soebes.de/blog/2018/06/16/apache-maven-surefire-plugin-version-2-dot-22-released/>`__.
 784
 785
 786 Version 4.0.0
 787 -------------
 788
 789 This is a major upgrade from version 3, with breaking changes; projects will
 790 need to make changes to upgrade to this version.
 791
 792 `This Wiki page <https://wiki.opendaylight.org/view/Neon_platform_upgrade>`__
 793 has detailed step-by-step migration instructions.
 794
 795 ODL Parent 4 requires Maven 3.5.3 or later; this is needed in particular to
 796 enable SpotBugs support with current versions of the SpotBugs plugin.
 797
 798 Known issues
 799 ~~~~~~~~~~~~
 800
 801 This release’s SpotBugs support doesn’t handle Guava 25.1 correctly, resulting
 802 in false-positives regarding null handling; see
 803 `ODLPARENT-161 <https://jira.opendaylight.org/browse/ODLPARENT-161>`__ for
 804 details. Until this is fixed, the corresponding warnings are disabled, which
 805 matches our existing FindBugs configuration (which suffers from the a variant
 806 of this, with the same consequences).
 807
 808 We are planning on upgrading Akka during the 4.x cycle, even if it results in
 809 a technically breaking upgrade. This is currently blocked on an OSGi bug in
 810 Akka; see `Akka issue 25579 <https://github.com/akka/akka/issues/25579>`__ for
 811 details.
 812
 813 Blueprint and OSGi service handling
 814 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 815
 816 Previous releases used an OpenDaylight-specific directory for Blueprint XML
 817 files, ``org/opendaylight/blueprint``. It turned out this wasn’t useful, so
 818 version 4 uses the default directory, ``OSGI-INF/blueprint``.
 819
 820 The Maven bundle plugin is now configured to omit the ``Import-Service`` and
 821 ``Export-Service`` headers, since they are deprecated, unnecessary in
 822 OpenDaylight, and liable to cause issues.
 823
 824 With previous releases of OpenDaylight, projects were encouraged to use Pax
 825 CDI API annotations to describe their Blueprint beans, services and injections;
 826 with version 4, Blueprint annotations should be used instead:
 827
 828 * modules should depend on
 829   ``org.apache.aries.blueprint:blueprint-maven-plugin-annotation``, with the
 830   ``<optional>true</optional>`` flag, instead of
 831   ``org.ops4j.pax.cdi:pax-cdi-api``;
 832
 833 * ``@OsgiServiceProvider`` on bean definitions is replaced by ``@Service``;
 834
 835 * ``@OsgiService`` at injection points is replaced by ``@Reference``;
 836
 837 * ``@OsgiService`` on bean definitions, while technically wrong, can be seen in
 838   the OpenDaylight codebase; this is replaced by ``@Service``;
 839
 840 * service lists can be injected using ``@ReferenceList``.
 841
 842 See `this Gerrit patch <https://git.opendaylight.org/gerrit/75699>`__ for an
 843 example.
 844
 845 Compiler settings
 846 ~~~~~~~~~~~~~~~~~
 847
 848 Builds now warn about unchecked type uses (such as raw types where generics
 849 are available).
 850
 851 JUnit and Mockito are always available as test dependencies and no longer need
 852 to be declared in POMs.
 853
 854 New build profiles
 855 ~~~~~~~~~~~~~~~~~~
 856
 857 An OWASP profile is now available to run OWASP’s dependency checker; this will
 858 check all third-party dependencies against the NVD vulnerability database. To
 859 enable this, run Maven with ``-Powasp``.
 860
 861 Build profile changes
 862 ~~~~~~~~~~~~~~~~~~~~~
 863
 864 ``-Pq`` now skips Modernizer.
 865
 866 New features
 867 ~~~~~~~~~~~~
 868
 869 ``odl-akka-leveldb-0.10`` wraps LevelDB 0.10 for Akka.
 870
 871 ``odl-apache-commons-codec`` wraps Apache Commons Codec.
 872
 873 ``odl-apache-commons-lang3`` wraps Apache Commons Lang 3.
 874
 875 ``odl-apache-commons-net`` wraps Apache Commons Net.
 876
 877 ``odl-apache-commons-text`` wraps Apache Commons Text.
 878
 879 ``odl-apache-sshd`` wraps Apache SSHD.
 880
 881 ``odl-guava`` provides the default ODL version of Guava; it should be used
 882 instead of ``odl-guava-23`` or the new ``odl-guava-25``.
 883
 884 ``odl-jackson-2.9`` wraps Jackson 2.9.
 885
 886 New FindBugs and SpotBugs settings
 887 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 888
 889 FindBugs and SpotBugs are configured with
 890 `the SLF4J extension <http://kengotoda.github.io/findbugs-slf4j/>`__ (version
 891 1.4.0 for FindBugs, 1.4.1 for SpotBugs). This will flag misused SLF4J calls, in
 892 particular message templates which don’t match the arguments, and invalid
 893 placeholders (*e.g.* ``%s`` instead of ``{}``).
 894
 895 Deleted artifacts
 896 ~~~~~~~~~~~~~~~~~
 897
 898 ``aggregator-parent`` was unusable outside ``odlparent`` and has been removed.
 899 Instead, the ``maven.deploy.skip`` and ``maven.install.skip`` properties are
 900 available to disable deploying and installing artifacts.
 901
 902 Upstream version upgrades
 903 ~~~~~~~~~~~~~~~~~~~~~~~~~
 904
 905 This version upgrades the following third-party dependencies:
 906
 907 * Aeron 1.7.0 → 1.9.3:
 908
 909   * `1.8.0 <https://github.com/real-logic/aeron/releases/tag/1.8.0>`__.
 910   * `1.8.1 <https://github.com/real-logic/aeron/releases/tag/1.8.1>`__.
 911   * `1.8.2 <https://github.com/real-logic/aeron/releases/tag/1.8.2>`__.
 912   * `1.9.0 <https://github.com/real-logic/aeron/releases/tag/1.9.0>`__.
 913   * `1.9.1 <https://github.com/real-logic/aeron/releases/tag/1.9.1>`__.
 914   * `1.9.2 <https://github.com/real-logic/aeron/releases/tag/1.9.2>`__.
 915   * `1.9.3 <https://github.com/real-logic/aeron/releases/tag/1.9.3>`__.
 916
 917 * Agrona 0.9.12 → 0.9.21:
 918
 919   * `0.9.13 <https://github.com/real-logic/agrona/releases/tag/0.9.13>`__.
 920   * `0.9.14 <https://github.com/real-logic/agrona/releases/tag/0.9.14>`__.
 921   * `0.9.15 <https://github.com/real-logic/agrona/releases/tag/0.9.15>`__.
 922   * `0.9.16 <https://github.com/real-logic/agrona/releases/tag/0.9.16>`__.
 923   * `0.9.17 <https://github.com/real-logic/agrona/releases/tag/0.9.17>`__.
 924   * `0.9.18 <https://github.com/real-logic/agrona/releases/tag/0.9.18>`__.
 925   * `0.9.19 <https://github.com/real-logic/agrona/releases/tag/0.9.19>`__.
 926   * `0.9.20 <https://github.com/real-logic/agrona/releases/tag/0.9.20>`__.
 927   * `0.9.21 <https://github.com/real-logic/agrona/releases/tag/0.9.21>`__.
 928
 929 * Akka 2.5.11 → 2.5.14:
 930
 931   * `2.5.12 <https://akka.io/blog/news/2018/04/13/akka-2.5.12-released>`__.
 932   * `2.5.13 <https://akka.io/blog/news/2018/06/08/akka-2.5.13-released>`__.
 933   * `2.5.14 <https://akka.io/blog/news/2018/07/13/akka-2.5.14-released>`__.
 934
 935 * ASM 5.1 → 6.2.1 (synchronised with Karaf).
 936
 937 * Bouncy Castle `1.59 → 1.60 <https://www.bouncycastle.org/releasenotes.html>`__.
 938
 939 * Checkstyle `8.4 → 8.12 <http://checkstyle.sourceforge.net/releasenotes.html#Release_8.12>`__.
 940
 941 * Commons Lang `3.7 → 3.8 <http://www.apache.org/dist/commons/lang/RELEASE-NOTES.txt>`__.
 942
 943 * Commons Text 1.1 → 1.4:
 944
 945   * `1.2 <https://commons.apache.org/proper/commons-text/release-notes/RELEASE-NOTES-1.2.txt>`__.
 946   * `1.3 <https://commons.apache.org/proper/commons-text/release-notes/RELEASE-NOTES-1.3.txt>`__.
 947   * `1.4 <https://commons.apache.org/proper/commons-text/release-notes/RELEASE-NOTES-1.4.txt>`__.
 948
 949 * Eclipse JDT annotations 2.1.150 → 2.2.0.
 950
 951 * EclipseLink Moxy JAXB `2.7.1 → 2.7.3 <https://www.eclipse.org/eclipselink/releases/2.7.php>`__.
 952
 953 * Enunciate core annotations
 954   `2.10.1 → 2.11.1 <https://github.com/stoicflame/enunciate/releases>`__.
 955
 956 * Felix Metatype 1.1.6 → 1.2.0 (synchronised with Karaf).
 957
 958 * Google Truth `0.40 → 0.42 <https://github.com/google/truth/releases>`__.
 959
 960 * Guava 23.6.1 → 25.1:
 961
 962   * `23.4 <https://github.com/google/guava/releases/tag/v23.4>`__.
 963   * `23.5 <https://github.com/google/guava/releases/tag/v23.5>`__.
 964   * `23.6 <https://github.com/google/guava/releases/tag/v23.6>`__.
 965   * `24.0 <https://github.com/google/guava/releases/tag/v24.0>`__.
 966   * `24.1 <https://github.com/google/guava/releases/tag/v24.1>`__.
 967   * `25.0 <https://github.com/google/guava/releases/tag/v25.0>`__.
 968   * `25.1 <https://github.com/google/guava/releases/tag/v25.1>`__.
 969
 970 * Immutables `2.5.6 → 2.7.1 <https://github.com/immutables/immutables/blob/master/README.md#changelog>`__.
 971
 972 * Jackson 2.8.9 → 2.9.6:
 973
 974   * `2.9 feature overview <https://medium.com/@cowtowncoder/jackson-2-9-features-b2a19029e9ff>`__.
 975   * `2.9 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9>`__.
 976   * `2.9.1 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.1>`__.
 977   * `2.9.2 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.2>`__.
 978   * `2.9.3 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.3>`__.
 979   * `2.9.4 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.4>`__.
 980   * `2.9.5 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.5>`__.
 981   * `2.9.6 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.6>`__.
 982
 983 * JaCoCo `0.8.1 → 0.8.2 <https://github.com/jacoco/jacoco/releases/tag/v0.8.2>`__.
 984
 985 * Javassist 3.22.0 → 3.23.1. This provides compatibility with Java 9 and later,
 986   and `fixes a file handle leak <https://github.com/jboss-javassist/javassist/issues/165>`__.
 987
 988 * Jettison 1.3.8 → 1.4.0.
 989
 990 * Jetty 9.3.21 → 9.4.11 (synchronised with Karaf):
 991
 992   * `9.4.0 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00097.html>`__.
 993   * `9.4.1 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00100.html>`__.
 994   * `9.4.2 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00101.html>`__.
 995   * `9.4.3 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00102.html>`__.
 996   * `9.4.4 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00105.html>`__.
 997   * `9.4.5 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00107.html>`__.
 998   * `9.4.6 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00109.html>`__.
 999   * `9.4.7 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00111.html>`__.
1000   * `9.4.8 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00114.html>`__.
1001   * `9.4.9 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00117.html>`__.
1002   * `9.4.10 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00119.html>`__.
1003   * `9.4.11 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00122.html>`__.
1004
1005 * Jolokia OSGi `1.5.0 → 1.6.0 <https://jolokia.org/changes-report.html#a1.6.0>`__.
1006
1007 * Karaf 4.1.5 → 4.2.1:
1008
1009   * `4.1.6 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12342748>`__.
1010   * `4.2.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12342945>`__.
1011
1012 * LMAX Disruptor 3.3.10 → 3.4.1:
1013
1014   * `3.4.0 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.4.0>`__.
1015   * `3.4.1 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.4.1>`__.
1016
1017 * META-INF services 1.7 → 1.8.
1018
1019 * Mockito 1.10.19 → 2.20.1; see
1020   `What’s new in Mockito 2 <https://github.com/mockito/mockito/wiki/What%27s-new-in-Mockito-2>`__
1021   for upgrade instructions and
1022   `the list of issues you might run into <https://asolntsev.github.io/en/2016/10/11/mockito-2.1/>`__.
1023
1024 * Netty 4.1.22 → 4.1.28:
1025
1026   * `4.1.17 <http://netty.io/news/2017/11/08/4-0-53-Final-4-1-17-Final.html>`__.
1027   * `4.1.18 <http://netty.io/news/2017/12/11/4-0-54-Final-4-1-18-Final.html>`__.
1028   * `4.1.19 <http://netty.io/news/2017/12/18/4-1-19-Final.html>`__.
1029   * `4.1.20 <http://netty.io/news/2018/01/22/4-0-55-Final-4-1-20-Final.html>`__.
1030   * `4.1.21 <http://netty.io/news/2018/02/05/4-0-56-Final-4-1-21-Final.html>`__.
1031   * `4.1.22 <http://netty.io/news/2018/02/21/4-1-22-Final.html>`__.
1032   * `4.1.23 <http://netty.io/news/2018/04/04/4-1-23-Final.html>`__.
1033   * `4.1.24 <http://netty.io/news/2018/04/19/4-1-24-Final.html>`__.
1034   * `4.1.25 <http://netty.io/news/2018/05/14/4-1-25-Final.html>`__.
1035   * `4.1.26 <http://netty.io/news/2018/07/10/4-1-26-Final.html>`__.
1036   * `4.1.27 <http://netty.io/news/2018/07/11/4-1-27-Final.html>`__.
1037   * `4.1.28 <http://netty.io/news/2018/07/27/4-1-28-Final.html>`__.
1038
1039 * Pax Exam 4.11.0 → 4.12.0.
1040
1041 * Pax URL 2.5.3 → 2.5.4, which only fixes
1042   `a potential NullPointerException <https://ops4j1.jira.com/browse/PAXURL-346>`__.
1043
1044 * PowerMock 1.6.4 → 1.7.4:
1045
1046   * `1.6.5 <https://github.com/powermock/powermock/releases/tag/powermock-1.6.5>`__.
1047   * `1.6.6 <https://github.com/powermock/powermock/releases/tag/powermock-1.6.6>`__.
1048   * `1.7.0 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.0>`__.
1049   * `1.7.1 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.1>`__.
1050   * `1.7.2 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.2>`__.
1051   * `1.7.3 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.3>`__.
1052   * `1.7.4 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.4>`__.
1053
1054 * Scala parser combinators 1.0.7 → 1.1.1:
1055
1056   * `1.1.0 <https://github.com/scala/scala-parser-combinators/releases/tag/v1.1.0>`__.
1057   * `1.1.1 <https://github.com/scala/scala-parser-combinators/releases/tag/v1.1.1>`__.
1058
1059 * SpotBugs `3.1.0 → 3.1.6 <https://github.com/spotbugs/spotbugs/blob/3.1.6/CHANGELOG.md>`__.
1060
1061 * Threeten Extra `1.3.2 → 1.4 <https://github.com/ThreeTen/threeten-extra/releases>`__.
1062
1063 * Typesafe SSL config 0.2.2 → 0.2.4:
1064
1065   * `0.2.3 <https://github.com/lightbend/ssl-config/releases/tag/v0.2.3>`__.
1066   * `0.2.4 <https://github.com/lightbend/ssl-config/releases/tag/v0.2.4>`__.
1067
1068 * Wagon HTTP
1069   `2.10 → 3.1.0 <https://lists.apache.org/thread.html/96024c54db7680697cb066e22a37b0ed5b4498386714a8a9ae1ec9cd@%3Cannounce.maven.apache.org%3E>`__.
1070
1071 * XMLUnit `1.6 → 2.6.2 <https://github.com/xmlunit/xmlunit/blob/master/RELEASE_NOTES.md>`__.
1072
1073 Upstream version additions
1074 ~~~~~~~~~~~~~~~~~~~~~~~~~~
1075
1076 The following upstream dependencies have been added to dependency management:
1077
1078 * Apache SSHD 2.0.0, with EdDSA and Netty support (EdDSA is provided by ``net.i2p.crypto:eddsa``).
1079
1080 * Blueprint annotations (``org.apache.aries.blueprint:blueprint-maven-plugin-annotation``).
1081
1082 * Log4J2.
1083
1084 * Pax Web 7.2.3 (synchronised with Karaf).
1085
1086 Upstream version removals
1087 ~~~~~~~~~~~~~~~~~~~~~~~~~
1088
1089 The following upstream dependencies have been removed from dependency management:
1090
1091 * Google Protobuf.
1092
1093 * Our repackaging of Jersey Servlet.
1094
1095 * JUnit’s ``junit-dep``, which has long been obsolete.
1096
1097 * LevelDB (which is still available as features).
1098
1099 * Pax CDI API — Blueprint annotations should be used instead.
1100
1101 Plugin version upgrades
1102 ~~~~~~~~~~~~~~~~~~~~~~~
1103
1104 The following plugins have been upgraded:
1105
1106 * Blueprint 1.4.0 → 1.10.0.
1107
1108 * Build helper 1.12 → 3.0.0.
1109
1110 * Bundle plugin 3.5.0 → 4.0.0.
1111
1112 * Checkstyle
1113   `2.17 → 3.0.0 <https://mail-archives.apache.org/mod_mbox/maven-announce/201801.mbox/%3Cop.zchs68akkdkhrr%40desktop-2khsk44.mshome.net%3E>`__.
1114
1115 * Duplicate finder
1116   `1.2.1 → 1.3.0 <https://github.com/basepom/duplicate-finder-maven-plugin/blob/master/CHANGES.md>`__.
1117
1118 * Git commit id `2.2.4 → 2.2.5 <https://github.com/ktoso/maven-git-commit-id-plugin/releases/tag/v2.2.5>`__.
1119
1120 * Jacoco Maven plugin `0.8.1 → 0.8.2 <https://github.com/jacoco/jacoco/releases/tag/v0.8.2>`__.
1121
1122 * Javadoc `3.0.0 → 3.0.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317529&version=12342283>`__.
1123
1124 * PMD 3.8 → 3.10.0:
1125
1126   * `3.10.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?version=12342689&styleName=Text&projectId=12317621>`__.
1127
1128 * Sevntu `1.29.0 → 1.32.0 <http://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.32.0>`__.
1129
1130 * SpotBugs 3.1.0-RC6 → 3.1.6 (see the SpotBugs changes above).
1131
1132 Version 3.1.3
1133 -------------
1134
1135 This version fixes the following issues:
1136
1137 * `ODLPARENT-156 <https://jira.opendaylight.org/browse/ODLPARENT-156>`_:
1138   ``xtend-maven-plugin``’s dependencies end up pulling in conflicting
1139   dependencies. ODL Parent now constrains part of its dependency tree to avoid
1140   this.
1141
1142 This version adds ``odl-jackson-2.8`` to ``odlparent-artifacts``.
1143
1144 Version 3.1.2
1145 -------------
1146
1147 This version fixes the following issues:
1148
1149 * `INFRAUTILS-41 <https://jira.opendaylight.org/browse/INFRAUTILS-41>`_:
1150   ``jre.properties`` includes ``com.sun.management`` so that it can be
1151   enabled if necessary. (This doesn’t add a dependency on
1152   ``com.sun.management``, it allows bundles to use it if it is present.)
1153
1154 * `ODLPARENT-136 <https://jira.opendaylight.org/browse/ODLPARENT-136>`_:
1155   ``SingleFeatureTest`` pulls in ``org.osgi.compendium``.
1156
1157 * `ODLPARENT-144 <https://jira.opendaylight.org/browse/ODLPARENT-144>`_:
1158   ``org.apache.karaf.scr.management`` is whitelisted so that it no longer
1159   affects ``SingleFeatureTest``.
1160
1161 * `ODLPARENT-146 <https://jira.opendaylight.org/browse/ODLPARENT-146>`_:
1162   null-related FindBugs checks which produce false-positives with Guava 23.6
1163   and later are disabled, so that this really is fully backwards-compatible
1164   with 3.0 and later.
1165
1166 * `ODLPARENT-148 <https://jira.opendaylight.org/browse/ODLPARENT-148>`_:
1167   ``SingleFeatureTest`` preserves ``target/SFT/karaf.log``.
1168
1169 This version includes the following improvements:
1170
1171 * ``custom.properties`` no longer includes OVSDB-specific configuration.
1172
1173 * The ``odl-jersey-1`` feature includes the Jersey client.
1174
1175 * Redundant bundle dependency declarations in ``SingleFeatureTest`` have been
1176   removed (these are declarations which are also present in our base Karaf
1177   distribution).
1178
1179 * Build errors involving invalid feature or bundle URLs now indicate which
1180   feature is at fault.
1181
1182 * Obsolete Log4J overrides have been removed from ``SingleFeatureTest``.
1183
1184 When building using JDK 9 or 10, the default settings have been changed as
1185 follows to avoid errors or extraneous warnings:
1186
1187 * SFT is disabled (it needs Karaf 4.2 or later);
1188
1189 * Javadocs are generated as HTML 4;
1190
1191 * SpotBugs is disabled on JDK 10 or later;
1192
1193 * FindBugs is disabled on JDK 9 or later.
1194
1195 The following third-party dependencies have been upgraded:
1196
1197 * `EclipseLink Moxy JAXB 2.6.2 → 2.7.1 <https://www.eclipse.org/eclipselink/releases/2.7.php>`_.
1198
1199 * `Google Truth 0.36 → 0.40 <https://github.com/google/truth/releases>`_.
1200
1201 * `Gson 2.8.2 → 2.8.5 <https://github.com/google/gson/blob/master/CHANGELOG.md>`_.
1202
1203 * `Guava 23.6 → 23.6.1 <https://github.com/google/guava/compare/v23.6...v23.6.1>`_.
1204   This addresses CVE-2018-10237 (that’s the only change in this release).
1205
1206 * `Jacoco Maven plugin 0.8.0 → 0.8.1 <https://github.com/jacoco/jacoco/releases/tag/v0.8.1>`_.
1207
1208 * JDT annotations 2.1.0 → 2.1.150.
1209
1210 * `Scala 2.12.5 → 2.12.6 <https://github.com/scala/scala/releases/tag/v2.12.6>`_.
1211
1212 * `Scala Parser Combinators 1.0.6 → 1.0.7 <https://github.com/scala/scala-parser-combinators/releases/tag/v1.0.7>`_.
1213
1214 * `Sevntu 1.24.2 → 1.29.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.29.0>`_.
1215
1216 * `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>`_.
1217
1218 The following Maven plugin has been upgraded:
1219
1220 * `Javadoc 3.0.0 → 3.0.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317529&version=12342283>`_.
1221
1222 Version 3.1.1
1223 -------------
1224
1225 This version fixes the following issues:
1226
1227 * `ODLPARENT-137 <https://jira.opendaylight.org/browse/ODLPARENT-137>`_:
1228   restore the OpenDaylight prompt.
1229
1230 * `ODLPARENT-146 <https://jira.opendaylight.org/browse/ODLPARENT-146>`_:
1231   Guava 23.6 switched from @Nullable to @NullableDecl, which causes false
1232   positives in FindBugs’ ``NP_NONNULL_PARAM_VIOLATION`` rule; we’re
1233   disabling the rule for now.
1234
1235 Version 3.1.0
1236 -------------
1237
1238 This version fixes the following issues:
1239
1240 * Mycila dependencies are now “compile” scoped rather than “test”; this allows
1241   child projects to use Guice with Mycila more easily.
1242
1243 * The duplicate finder now ignores ``web.xml`` and BluePrint XML files.
1244
1245 This version includes the following improvements:
1246
1247 * The ``-Pq`` profile skips Maven Modernizer, in preparation for its future
1248   integration (and its use in child projects).
1249
1250 * An OWASP profile, ``-Powasp`` is available for vulnerability checking.
1251
1252 * A new ``odl-jackson-2.8`` feature provides Jackson 2.8 to child projects.
1253
1254 The following third-party dependencies have been added to dependency management:
1255
1256 * `ThreeTen-Extra <http://www.threeten.org/threeten-extra/>`_
1257
1258 The following third-party dependencies have been upgraded:
1259
1260 * Aeron 1.2.5 → 1.7.0; release notes:
1261
1262   * `1.3.0 <https://github.com/real-logic/aeron/releases/tag/1.3.0>`_
1263   * `1.4.0 <https://github.com/real-logic/aeron/releases/tag/1.4.0>`_
1264   * `1.5.0 <https://github.com/real-logic/aeron/releases/tag/1.5.0>`_
1265   * `1.5.1 <https://github.com/real-logic/aeron/releases/tag/1.5.1>`_
1266   * `1.5.2 <https://github.com/real-logic/aeron/releases/tag/1.5.2>`_
1267   * `1.6.0 <https://github.com/real-logic/aeron/releases/tag/1.6.0>`_
1268   * `1.7.0 <https://github.com/real-logic/aeron/releases/tag/1.7.0>`_
1269
1270 * Agrona 0.9.5 → 0.9.12; release notes:
1271
1272   * `0.9.6 <https://github.com/real-logic/Agrona/releases/tag/0.9.6>`_
1273   * `0.9.7 <https://github.com/real-logic/Agrona/releases/tag/0.9.7>`_
1274   * `0.9.8 <https://github.com/real-logic/Agrona/releases/tag/0.9.8>`_
1275   * `0.9.9 <https://github.com/real-logic/Agrona/releases/tag/0.9.9>`_
1276   * `0.9.10 <https://github.com/real-logic/Agrona/releases/tag/0.9.10>`_
1277   * `0.9.11 <https://github.com/real-logic/Agrona/releases/tag/0.9.11>`_
1278   * `0.9.12 <https://github.com/real-logic/Agrona/releases/tag/0.9.12>`_
1279
1280 * Akka 2.5.5 → 2.5.11; release notes:
1281
1282   * `2.5.6 <https://akka.io/blog/news/2017/09/28/akka-2.5.6-released>`_
1283   * `2.5.7 <https://akka.io/blog/news/2017/11/17/akka-2.5.7-released>`_
1284   * `2.5.8 <https://akka.io/blog/news/2017/12/08/akka-2.5.8-released>`_
1285   * `2.5.9 <https://akka.io/blog/news/2018/01/11/akka-2.5.9-released-2.4.x-end-of-life>`_
1286   * `2.5.10 <https://akka.io/blog/news/2018/02/23/akka-2.5.10-released>`_
1287   * `2.5.11 <https://akka.io/blog/news/2018/02/28/akka-2.5.11-released>`_
1288
1289 * Commons Lang 3 `3.6 → 3.7 <http://www.apache.org/dist/commons/lang/RELEASE-NOTES.txt>`_
1290
1291 * Guava 23.3 → 23.6; release notes:
1292
1293   * `23.4 <https://github.com/google/guava/releases/tag/v23.4>`_
1294   * `23.5 <https://github.com/google/guava/releases/tag/v23.5>`_
1295   * `23.6 <https://github.com/google/guava/releases/tag/v23.6>`_
1296
1297 * H2 database `1.4.193 → 1.4.196 <http://www.h2database.com/html/changelog.html>`_
1298
1299 * Jacoco `0.7.9 → 0.8.0 <https://github.com/jacoco/jacoco/releases/tag/v0.8.0>`_
1300
1301 * Javassist `3.21.0 → 3.22.0 <https://github.com/jboss-javassist/javassist/compare/rel_3_21_0_ga...rel_3_22_0_ga>`_
1302
1303 * lmax-disruptor 3.3.7 → 3.3.10; release notes:
1304
1305   * `3.3.8 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.3.8>`_
1306   * `3.3.9 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.3.9>`_
1307   * `3.3.10 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.3.10>`_
1308
1309 * Netty 4.1.16 → 4.1.22; release notes:
1310
1311   * `4.1.17 <http://netty.io/news/2017/11/08/4-0-53-Final-4-1-17-Final.html>`_
1312   * `4.1.18 <http://netty.io/news/2017/12/11/4-0-54-Final-4-1-18-Final.html>`_
1313   * `4.1.19 <http://netty.io/news/2017/12/18/4-1-19-Final.html>`_
1314   * `4.1.20 <http://netty.io/news/2018/01/22/4-0-55-Final-4-1-20-Final.html>`_
1315   * `4.1.21 <http://netty.io/news/2018/02/05/4-0-56-Final-4-1-21-Final.html>`_
1316   * `4.1.22 <http://netty.io/news/2018/02/21/4-1-22-Final.html>`_
1317
1318 * Scala `2.12.4 → 2.12.5 <http://www.scala-lang.org/news/2.12.5>`_
1319
1320 * Typesafe Config `0.2.1 → 0.2.2 <https://github.com/typesafehub/config/blob/master/NEWS.md>`_
1321
1322 The following Maven plugins have been upgraded:
1323
1324 * FindBugs 3.0.4 → 3.0.5
1325
1326 * Git commit id 2.2.2 → 2.2.4; release notes:
1327
1328   * `2.2.3 <https://github.com/ktoso/maven-git-commit-id-plugin/releases/tag/v2.2.3>`_
1329   * `2.2.4 <https://github.com/ktoso/maven-git-commit-id-plugin/releases/tag/v2.2.4>`_
1330
1331 Version 3.0.3
1332 -------------
1333
1334 This version fixes the following issues:
1335
1336 * `ODLPARENT-136`_: ``features-test`` needs ``org.osgi.compendium``.
1337
1338 * Jackson dependencies are declared using ``jackson-bom`` to ensure all they
1339   remain consistent.
1340
1341 * ``find-duplicate-classpath-entries`` is run in the “verify” phase rather than
1342   the “validate” phase, which is too early.
1343
1344 * The version of Jetty we pull in is now aligned with that declared in Karaf,
1345   resolving a number of restart and dependency issues.
1346
1347 * Pulling in the ``wrap`` feature unconditionally is no longer necessary, so
1348   ``karaf4-parent`` no longer does so.
1349
1350 * ``metainf-services`` are declared with scope “provided” to avoid their being
1351   included in downstream features (it’s a build-time dependency only).
1352
1353 * ``leveldb-api`` is excluded from ``odl-akka-leveldb-0.7``, and ``jsr250-api``
1354   from ``enunciate-core-annotations``, to avoid duplicate having classes on the
1355   classpath.
1356
1357 * Since the ``ssh`` feature is excluded from generated features, our Karaf
1358   need to enable it at boot in all cases.
1359
1360 * ``bundle-test-lib`` is now a bundle.
1361
1362 * Since we use static SLF4J loggers, the ``SLF4J_LOGGER_SHOULD_BE_NON_STATIC``
1363   rule needs to be disabled in our FindBugs configuration (this allows
1364   downstream projects to enable ``findbugs-slf4j`` without having to deal with
1365   all the resulting false-positives).
1366
1367 * ``org.apache.karaf.scr.management`` is white-listed in SFT to avoid failures
1368   apparently related to that component (which we don’t care about).
1369
1370 .. _ODLPARENT-136: https://jira.opendaylight.org/browse/ODLPARENT-136
1371
1372 This version upgrades the following third-party dependencies:
1373
1374 * `Antlr 4.7 → 4.7.1`_
1375
1376 * `BouncyCastle 1.58 → 1.59`_
1377
1378 * Jersey 1.17 → 1.19.4 (additionally available as the ``odl-jersey-1`` feature)
1379
1380 * Jolokia 1.3.7 → 1.5.0
1381
1382 * Karaf 4.1.3 → 4.1.5; release notes:
1383
1384   * `Karaf 4.1.4`_
1385   * `Karaf 4.1.5`_
1386
1387 .. _Antlr 4.7 → 4.7.1: https://github.com/antlr/antlr4/releases/tag/4.7.1
1388 .. _BouncyCastle 1.58 → 1.59: https://www.bouncycastle.org/releasenotes.html
1389 .. _Karaf 4.1.4: https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12341702
1390 .. _Karaf 4.1.5: https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12342294
1391
1392 Version 3.0.2
1393 -------------
1394
1395 This version fixes the following issues:
1396
1397 * SingleFeatureTest uses the configured local Maven repository for Pax Exam.
1398
1399 * JavaDoc links are disabled for now to `speed up builds`_. A new
1400   ``javadoc-links`` profile enables the links.
1401
1402 * Conditional feature dependencies are processed, ensuring our
1403   `distribution is complete`_.
1404
1405 * Startup features are `adjusted for Karaf 4.1`_, avoiding unnecessary
1406   refreshes.
1407
1408 * The ``hiddenField`` Checkstyle check is disabled for abstract methods.
1409
1410 * The default logging configuration uses Log4J2, which is the new default in
1411   Karaf 4.1.
1412
1413 .. _speed up builds: https://jira.opendaylight.org/browse/ODLPARENT-121
1414 .. _distribution is complete: https://jira.opendaylight.org/browse/ODLPARENT-133
1415 .. _adjusted for Karaf 4.1: https://jira.opendaylight.org/browse/ODLPARENT-134
1416
1417 This version upgrades the following dependencies or plugins:
1418
1419 * ``maven-enforcer-plugin`` 1.4.1 → 3.0.0-M1
1420
1421 * ``maven-javadoc-plugin`` 3.0.0-M1 → 3.0.0
1422
1423 Version 3.0.1
1424 -------------
1425
1426 This version fixes the following issues:
1427
1428 * Karaf pulls in an invalid Hibernate feature repository, breaking downstream
1429   dependencies pulling in the “war” feature. ``populate-local-repo`` corrects
1430   the repository dependency.
1431
1432
1433 Version 3.0.0
1434 -------------
1435
1436 Compiler settings
1437 ~~~~~~~~~~~~~~~~~
1438
1439 Build now show compiler warnings and deprecation warnings. This doesn't affect
1440 the result or require any changes currently, it just makes the issues more
1441 visible.
1442
1443 New Checkstyle rules
1444 ~~~~~~~~~~~~~~~~~~~~
1445
1446 Checkstyle has been upgraded from 7.6 to 8.4 (see the
1447 `Checkstyle release notes`_ for details), and Sevntu from 1.21.0 to 1.24.2
1448 (note that the latter's group identifier changed from
1449 ``com.github.sevntu.checkstyle`` to ``com.github.sevntu-checkstyle``; you
1450 might need to update your IDE's configuration).
1451
1452 The following Checkstyle rules are enabled; this might require changes in
1453 projects which enforce Checkstyle validation:
1454
1455 * `AvoidHidingCauseExceptionCheck`_
1456 * `FinalClass`_: utility classes must be declared ``final``
1457 * `HiddenField`_: fields must not be shadowed
1458 * `HideUtilityClassConstructor`_: utility classes must hide their constructor
1459
1460 .. _Checkstyle release notes: http://checkstyle.sourceforge.net/releasenotes.html
1461
1462 .. _AvoidHidingCauseExceptionCheck: http://sevntu-checkstyle.github.io/sevntu.checkstyle/apidocs/com/github/sevntu/checkstyle/checks/coding/AvoidHidingCauseExceptionCheck.html
1463 .. _FinalClass: http://checkstyle.sourceforge.net/config_design.html#FinalClass
1464 .. _HiddenField: http://checkstyle.sourceforge.net/config_coding.html#HiddenField
1465 .. _HideUtilityClassConstructor: http://checkstyle.sourceforge.net/config_design.html#HideUtilityClassConstructor
1466
1467 Karaf
1468 ~~~~~
1469
1470 Karaf has been upgraded to 4.1.3. This should be transparent for dependent
1471 projects.
1472
1473 Karaf distributions
1474 ~~~~~~~~~~~~~~~~~~~
1475
1476 * When building a Karaf distribution using ``karaf4-parent``, projects can
1477   specify which archives to build: the ``karaf.archiveZip`` property will
1478   enable ZIP files if true, and ``karaf.archiveTarGz`` will enable
1479   gzip-compressed tarballs if true. By default both are enabled.
1480
1481 * Our Karaf distribution provides Bouncy Castle at startup. Auto-generated
1482   feature descriptors take this into account (they won't embed a Bouncy
1483   Castle dependency).
1484
1485 Feature removals
1486 ~~~~~~~~~~~~~~~~
1487
1488 * The ``odl-triemap-0.2`` feature wrapping
1489   ``com.github.romix:java-concurrent-hash-trie-map`` was rendered obsolete by
1490   YANG Tools' implementation and has been removed.
1491
1492 Feature additions
1493 ~~~~~~~~~~~~~~~~~
1494
1495 * ``odl-javassist-3`` provides Javassist in a feature.
1496
1497 * ``odl-jung-2.1`` provides `JUNG`_ in a feature.
1498
1499 .. _JUNG: http://jung.sourceforge.net/
1500
1501 Upstream version upgrades
1502 ~~~~~~~~~~~~~~~~~~~~~~~~~
1503
1504 The following upstream dependencies have been upgraded:
1505
1506 * Akka 2.4.18 → 2.5.4; release notes:
1507
1508   * `Akka 2.5.0`_
1509   * `Akka 2.5.1`_
1510   * `Akka 2.5.2`_
1511   * `Akka 2.5.3`_
1512   * `Akka 2.5.4`_
1513
1514 * `Awaitility 2 → 3`_
1515
1516 * `Bouncy Castle 1.57 → 1.58`_
1517
1518 * `Commons Codec 1.10 → 1.11`_
1519
1520 * `Commons File Upload 1.3.2 → 1.3.3`_
1521
1522 * `Commons IO 2.5 → 2.6`_
1523
1524 * Eclipse JDT annotations 2.0.0 → 2.1.0
1525
1526 * Felix Dependency Manager 4.3.0 → 4.4.1
1527 * Felix Dependency Manager Shell 4.0.4 → 4.0.6
1528 * Felix Metatype 1.1.2 → 1.1.6
1529
1530 * `Google Truth 0.28 → 0.36`_ (with the Java 8 extensions)
1531
1532 * `Gson 2.7 → 2.8.2`_
1533
1534 * Guava 22 → 23.3 along with the associated feature name change from
1535   ``odl-guava-22`` to ``odl-guava-23`` (dependent packages *must* change their
1536   dependency); release notes:
1537
1538   * `Guava 23`_
1539   * `Guava 23.1`_
1540   * `Guava 23.2`_
1541   * `Guava 23.3`_
1542
1543 * Immutables 2.4.2 → 2.5.6
1544
1545 * Jackson 2.3.2 → 2.8.9
1546
1547 * Jacoco 0.7.7 → 0.7.9; release notes:
1548
1549   * `Jacoco 0.7.8`_
1550   * `Jacoco 0.7.9`_
1551
1552 * Jacoco Listeners 2.4 → 3.8
1553
1554 * `Javassist 3.20.0 → 3.21.0`_
1555
1556 * `Jettison 1.3.7 → 1.3.8`_
1557
1558 * `Jolokia 1.3.6 → 1.3.7`_
1559
1560 * `JSONassert 1.3.0 → 1.5.0`_
1561
1562 * `logback 1.2.2 → 1.2.3`_
1563
1564 * `LMAX Disruptor 3.3.6 → 3.3.7`_
1565
1566 * Netty 4.1.8 → 4.1.16; release notes:
1567
1568   * `Netty 4.1.9`_
1569   * `Netty 4.1.10`_
1570   * `Netty 4.1.11`_
1571   * `Netty 4.1.12`_
1572   * `Netty 4.1.13`_
1573   * `Netty 4.1.14`_
1574   * `Netty 4.1.15`_
1575   * `Netty 4.1.16`_
1576
1577 * `Pax URL 2.5.2 → 2.5.3`_
1578
1579 * Scala 2.11.11 → 2.12.4; release notes:
1580
1581   * `Scala 2.12.0`_
1582   * `Scala 2.12.1`_
1583   * `Scala 2.12.2`_
1584   * `Scala 2.12.3`_
1585   * `Scala 2.12.4`_
1586
1587 * Servlet API 3.0.1 → 3.1.0
1588
1589 * `SLF4J 1.7.21 → 1.7.25`_
1590
1591 * `webcohesion enunciate 2.6.0 → 2.10.1`_
1592
1593 * `Xtend 2.12 → 2.13`_
1594
1595 .. _Akka 2.5.0: http://akka.io/blog/news/2017/04/13/akka-2.5.0-released
1596 .. _Akka 2.5.1: http://akka.io/blog/news/2017/05/02/akka-2.5.1-released
1597 .. _Akka 2.5.2: http://akka.io/blog/news/2017/05/24/akka-2.5.2-released
1598 .. _Akka 2.5.3: http://akka.io/blog/news/2017/06/19/akka-2.5.3-released
1599 .. _Akka 2.5.4: http://akka.io/blog/news/2017/08/10/akka-2.5.4-released
1600
1601 .. _Awaitility 2 → 3: https://github.com/awaitility/awaitility/wiki/ReleaseNotes30
1602
1603 .. _Bouncy Castle 1.57 → 1.58: https://www.bouncycastle.org/releasenotes.html
1604
1605 .. _Commons Codec 1.10 → 1.11: http://www.apache.org/dist/commons/codec/RELEASE-NOTES.txt
1606
1607 .. _Commons File Upload 1.3.2 → 1.3.3: http://www.apache.org/dist/commons/fileupload/RELEASE-NOTES.txt
1608
1609 .. _Commons IO 2.5 → 2.6: http://www.apache.org/dist/commons/io/RELEASE-NOTES.txt
1610
1611 .. _Google Truth 0.28 → 0.36: https://github.com/google/truth/releases
1612
1613 .. _Gson 2.7 → 2.8.2: https://github.com/google/gson/blob/master/CHANGELOG.md
1614
1615 .. _Guava 23: https://github.com/google/guava/wiki/Release23
1616 .. _Guava 23.1: https://github.com/google/guava/releases/tag/v23.1
1617 .. _Guava 23.2: https://github.com/google/guava/releases/tag/v23.2
1618 .. _Guava 23.3: https://github.com/google/guava/releases/tag/v23.3
1619
1620 .. _Jacoco 0.7.8: https://github.com/jacoco/jacoco/releases/tag/v0.7.8
1621 .. _Jacoco 0.7.9: https://github.com/jacoco/jacoco/releases/tag/v0.7.9
1622
1623 .. _Javassist 3.20.0 → 3.21.0: https://github.com/jboss-javassist/javassist/compare/rel_3_20_0_ga...rel_3_21_0_ga
1624
1625 .. _Jettison 1.3.7 → 1.3.8: https://github.com/jettison-json/jettison/compare/jettison-1.3.7...jettison-1.3.8
1626
1627 .. _Jolokia 1.3.6 → 1.3.7: https://github.com/rhuss/jolokia/releases/tag/v1.3.7
1628
1629 .. _JSONassert 1.3.0 → 1.5.0: https://github.com/skyscreamer/JSONassert/releases
1630
1631 .. _logback 1.2.2 → 1.2.3: https://logback.qos.ch/news.html
1632
1633 .. _LMAX Disruptor 3.3.6 → 3.3.7: https://github.com/LMAX-Exchange/disruptor/releases/tag/3.3.7
1634
1635 .. _Netty 4.1.9: http://netty.io/news/2017/03/10/4-0-45-Final-4-1-9-Final.html
1636 .. _Netty 4.1.10: http://netty.io/news/2017/04/30/4-0-46-Final-4-1-10-Final.html
1637 .. _Netty 4.1.11: http://netty.io/news/2017/05/12/4-0-47-Final-4-1-11-Final.html
1638 .. _Netty 4.1.12: http://netty.io/news/2017/06/09/4-0-48-Final-4-1-12-Final.html
1639 .. _Netty 4.1.13: http://netty.io/news/2017/07/06/4-0-49-Final-4-1-13-Final.html
1640 .. _Netty 4.1.14: http://netty.io/news/2017/08/03/4-0-50-Final-4-1-14-Final.html
1641 .. _Netty 4.1.15: http://netty.io/news/2017/08/25/4-0-51-Final-4-1-15-Final.html
1642 .. _Netty 4.1.16: http://netty.io/news/2017/09/25/4-0-52-Final-4-1-16-Final.html
1643
1644 .. _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
1645
1646 .. _Scala 2.12.0: https://github.com/scala/scala/releases/tag/v2.12.0
1647 .. _Scala 2.12.1: https://github.com/scala/scala/releases/tag/v2.12.1
1648 .. _Scala 2.12.2: https://github.com/scala/scala/releases/tag/v2.12.2
1649 .. _Scala 2.12.3: https://github.com/scala/scala/releases/tag/v2.12.3
1650 .. _Scala 2.12.4: https://github.com/scala/scala/releases/tag/v2.12.4
1651
1652 .. _SLF4J 1.7.21 → 1.7.25: https://www.slf4j.org/news.html
1653
1654 .. _webcohesion enunciate 2.6.0 → 2.10.1: https://github.com/stoicflame/enunciate/releases
1655
1656 .. _Xtend 2.12 → 2.13: https://www.eclipse.org/xtend/releasenotes.html
1657
1658 Upstream version additions
1659 ~~~~~~~~~~~~~~~~~~~~~~~~~~
1660
1661 The following upstream dependencies have been added to dependency management:
1662
1663 * Commons Text, ``org.apache.commons:commons-text`` (this will allow downstreams
1664   to migrate from ``commons-lang3``\’s ``WordUtils``, which is deprecated)
1665
1666 Upstream version removals
1667 ~~~~~~~~~~~~~~~~~~~~~~~~~
1668
1669 The following upstream dependencies have been removed from dependency
1670 management (they are obsolete and unused):
1671
1672 * Chameleon MBeans
1673 * Eclipse Link
1674 * Equinox HTTP service bridge
1675 * ``equinoxSDK381`` artifacts
1676 * Coda Hale Metrics, which are mostly unused and should eventually be wrapped
1677   by InfraUtils
1678 * ``com.google.code.findbugs:jsr305`` (which *must not* be used; this is
1679   enforced — ``annotations`` should be used instead)
1680 * Felix File Install and Web Console
1681 * Gemini Web
1682 * Orbit
1683 * ``org.mockito:mockito-all`` (which *must not* be used; this is enforced —
1684   ``mockito-core`` should be used instead)
1685 * Spring Framework
1686 * ``txw2``
1687 * Xerces
1688 * ``xml-apis``
1689
1690 Plugin version upgrades
1691 ~~~~~~~~~~~~~~~~~~~~~~~
1692
1693 The following plugins have been upgraded:
1694
1695 * ``org.apache.servicemix.tooling:depends-maven-plugin`` 1.3.1 → 1.4.0
1696 * ``org.apache.felix:maven-bundle-plugin`` 2.4.0 → 3.3.0
1697 * ``maven-compiler-plugin`` 3.6.1 → 3.7.0
1698 * ``maven-dependency-plugin`` 3.0.1 → 3.0.2
1699 * ``maven-enforcer-plugin`` 1.4.1 → 3.0.0-M1
1700 * ``maven-failsafe-plugin`` 2.18.1 → 2.20.1
1701 * ``maven-javadoc-plugin`` 2.10.4 → 3.0.0-M1
1702 * ``maven-shade-plugin`` 2.4.3 → 3.1.0
1703
1704 New plugins
1705 ~~~~~~~~~~~
1706
1707 * The `Maven Find Duplicates`_ plugin can be enabled by setting the
1708   ``duplicate-finder.skip`` property to ``false``.
1709
1710 * The SpotBugs_ Maven plugin can now be used instead of the FindBugs plugin
1711   (both are available, so no change is required). To use SpotBugs, replace
1712   ``org.codehaus.mojo:findbugs-maven-plugin`` with
1713   ``com.github.spotbugs:spotbugs-maven-plugin``.
1714
1715 .. _Maven Find Duplicates: https://github.com/basepom/duplicate-finder-maven-plugin/
1716
1717 .. _SpotBugs: https://spotbugs.github.io/