docs/NEWS.rst

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